2.2.6 릴리스 실행 기록

{
  "schema": "release-metadata/v1",
  "version": "v2.2.6",
  "status": "superseded",
  "releaseScopes": [
    "contracts-package",
    "docs"
  ],
  "extraRepoRefs": [
    "coupler-admin-web",
    "coupler-mobile-app"
  ],
  "versionMapping": {
    "docs": {
      "tag": null,
      "commit": null
    },
    "coupler-api": {
      "tag": null,
      "commit": "64ffd739d2d1eb43a2f55100ce1831b81ec6da9c"
    },
    "coupler-admin-web": {
      "tag": null,
      "commit": "96034847c7f567209c533fce17bd61e96dca8700"
    },
    "coupler-mobile-app": {
      "store": null,
      "releaseTag": null,
      "commit": "161bd00869c0775a30b4175b803e95638cd246f5",
      "nextPush": null
    }
  },
  "scopeResults": {
    "contracts-package": {
      "status": "released",
      "summary": "Release Contracts workflow가 매칭 일정 ErrorData 계약을 포함한 contracts package 0.1.2를 발행했다.",
      "evidence": {
        "publishedPackage": "@coupler-developer/coupler-api-contracts@0.1.2",
        "workflow": "Release Contracts run 29028333006 success, publish job 86154024364 success, completed 2026-07-09T15:10:00Z",
        "sourceRef": "64ffd739d2d1eb43a2f55100ce1831b81ec6da9c"
      }
    },
    "docs": {
      "status": "superseded",
      "summary": "0.1.2 소비자 정렬 준비 범위는 후속 v2.2.7 운영 릴리즈가 0.1.5 기준으로 대체한다.",
      "supersededBy": "v2.2.7",
      "incompleteReason": "Admin/Mobile 0.1.2 소비자 bump가 독립 릴리즈로 완료되기 전에 0.1.5 정렬과 운영 배포 범위가 후속 릴리즈로 확장됐다.",
      "tagStatus": "not_created",
      "evidence": {}
    }
  },
  "apiContractCutover": null
}

문서 역할

• 역할: 시나리오
• 문서 종류: flow
• 충돌 시 우선 문서: policy/release-process.md, contracts package 기준은 policy/api-client-contract-package-policy.md
• 기준 성격: as-is

목적

• v2.2.6 docs 릴리스 기록에 @coupler-developer/coupler-api-contracts@0.1.2 발행 기준점을 고정한다.
• API contracts package 발행과 Admin/Mobile 소비자 dependency bump 준비 상태를 한 문서에서 추적한다.
• 이번 기록은 package 소비자 정렬까지의 준비 기록이며, 운영 API/Admin 배포 또는 Mobile Store/NextPush cutover와 분리한다.

범위

• 대상: docs, coupler-api, coupler-admin-web, coupler-mobile-app
• 포함 범위: contracts package 0.1.2 publish 증빙, API source ref 고정, Admin/Mobile consumer dependency bump PR 준비, docs Release 기록
• 제외 범위: 운영 RDS 변경, coupler-api 운영 배포, coupler-admin-web 운영 배포, Mobile Store/NextPush 배포, API contract runtime cutover

상위 규범 문서

• 배포/릴리즈 프로세스
• API 클라이언트 계약 패키지 정책
• API 계약 변경 모바일 릴리즈 플로우
• 테스트/CI 전략

릴리스 상태

• 목표 버전: v2.2.6
• 전체 상태: superseded
• 완료 범위: coupler-api Release Contracts workflow run 29028333006 success, GitHub Packages @coupler-developer/coupler-api-contracts@0.1.2 발행 확인, Admin/Mobile consumer bump local dependency update
• 대기 범위: N/A (v2.2.7이 contracts 0.1.5 정렬과 운영 배포 범위를 대체)
• docs 기록 버전: v2.2.6 (통합 릴리스 기록 번호)
• coupler-api source ref: 64ffd739d2d1eb43a2f55100ce1831b81ec6da9c
• contracts package: @coupler-developer/coupler-api-contracts@0.1.2
• coupler-admin-web consumer branch: chore/김민식/api-contracts-0-1-2
• coupler-mobile-app consumer branch: chore/김민식/api-contracts-0-1-2

버전 매핑

• docs: 태그 N/A, 커밋 N/A
• coupler-api: 태그 N/A, 커밋 64ffd739d2d1eb43a2f55100ce1831b81ec6da9c
• coupler-admin-web: 태그 N/A, 커밋 96034847c7f567209c533fce17bd61e96dca8700
• coupler-mobile-app: Store N/A, 릴리스 태그 N/A, 커밋 161bd00869c0775a30b4175b803e95638cd246f5, NextPush N/A

릴리스 결과

• coupler-api main 64ffd739d2d1eb43a2f55100ce1831b81ec6da9c 기준 Release Contracts workflow가 contracts package 0.1.2를 발행했다.
• GitHub Packages에서 @coupler-developer/coupler-api-contracts@0.1.2 version, tarball, integrity를 확인했다.
• coupler-admin-web consumer branch는 @coupler-developer/coupler-api-contracts dependency를 0.1.1에서 0.1.2로 올리고 lockfile을 갱신한다.
• coupler-mobile-app consumer branch는 @coupler-developer/coupler-api-contracts dependency를 0.1.1에서 0.1.2로 올리고 lockfile을 갱신한다.
• 이번 기록은 package publish와 consumer dependency 정렬 준비 범위다. Runtime API/Admin 배포와 Mobile Store/NextPush cutover는 수행하지 않는다.

메인 흐름

1. coupler-api PR #102 merge 후 origin/main이 64ffd739d2d1eb43a2f55100ce1831b81ec6da9c로 전진한 것을 확인했다.
2. Release Contracts workflow run 29028333006이 main source ref 64ffd739d2d1eb43a2f55100ce1831b81ec6da9c에서 성공한 것을 확인했다.
3. GitHub Packages에서 @coupler-developer/coupler-api-contracts@0.1.2가 발행된 것을 확인했다.
4. coupler-admin-web branch chore/김민식/api-contracts-0-1-2에서 package dependency와 lockfile을 0.1.2로 갱신했다.
5. coupler-mobile-app branch chore/김민식/api-contracts-0-1-2에서 package dependency와 lockfile을 0.1.2로 갱신했다.
6. docs v2.2.6 릴리스 기록을 생성해 package publish evidence와 consumer bump 준비 상태를 고정한다.

검증 근거

• coupler-api
  • source ref: 64ffd739d2d1eb43a2f55100ce1831b81ec6da9c
  • Release Contracts workflow: run 29028333006, publish job 86154024364, completed 2026-07-09T15:10:00Z
  • published package: @coupler-developer/coupler-api-contracts@0.1.2
  • package tarball: https://npm.pkg.github.com/download/@coupler-developer/coupler-api-contracts/0.1.2/2d05b0520864b5fa4f8085fb679d37c25be89985
  • package integrity: sha512-vzTQSf21ZZce6ktfOKXHcSqCpRYeNDVq27WIhFrOARXkZ6HXCSnckqEXd8de/gnm3vec52VxJ4BCstF+P0TCXw==
• coupler-admin-web
  • branch: chore/김민식/api-contracts-0-1-2
  • base ref: 96034847c7f567209c533fce17bd61e96dca8700
  • 변경 파일: package.json, yarn.lock
  • dependency pin: @coupler-developer/coupler-api-contracts@0.1.2
  • lockfile tarball: https://npm.pkg.github.com/download/@coupler-developer/coupler-api-contracts/0.1.2/2d05b0520864b5fa4f8085fb679d37c25be89985
  • lockfile integrity: sha512-vzTQSf21ZZce6ktfOKXHcSqCpRYeNDVq27WIhFrOARXkZ6HXCSnckqEXd8de/gnm3vec52VxJ4BCstF+P0TCXw==
• coupler-mobile-app
  • branch: chore/김민식/api-contracts-0-1-2
  • base ref: 161bd00869c0775a30b4175b803e95638cd246f5
  • 변경 파일: package.json, yarn.lock
  • dependency pin: @coupler-developer/coupler-api-contracts@0.1.2
  • lockfile tarball: https://npm.pkg.github.com/download/@coupler-developer/coupler-api-contracts/0.1.2/2d05b0520864b5fa4f8085fb679d37c25be89985
  • lockfile integrity: sha512-vzTQSf21ZZce6ktfOKXHcSqCpRYeNDVq27WIhFrOARXkZ6HXCSnckqEXd8de/gnm3vec52VxJ4BCstF+P0TCXw==
• docs
  • 기록 상태: contracts package 0.1.2 publish와 consumer bump 준비 상태를 in_progress로 문서화
  • scopeResults: contracts-package released, docs in_progress

롤백 기준

• Contracts package 0.1.2는 이미 발행된 package artifact이므로 삭제/재발행으로 되돌리지 않는다.
• Consumer bump PR merge 전 문제가 확인되면 Admin/Mobile branch의 dependency pin을 0.1.1로 되돌리고 lockfile을 다시 생성한다.
• Consumer bump PR merge 후 문제가 확인되면 각 소비자 repo에서 revert PR을 만들어 @coupler-developer/coupler-api-contracts@0.1.1 lockfile 상태로 복구한다.
• 운영 API/Admin 배포와 Mobile Store/NextPush는 이번 릴리스 범위가 아니므로 rollback 대상이 아니다.
• API contract runtime cutover가 필요한 변경이 추가되면 별도 릴리스 기록에서 apiContractCutover evidence를 채우고 N+1/legacy traffic block 기준을 다시 검증한다.

후속 작업

• docs v2.2.6 PR을 merge해 Release 기록을 main에 반영한다.
• coupler-admin-web consumer bump PR을 merge한다.
• coupler-mobile-app consumer bump PR을 merge한다.
• consumer PR merge 후 운영 배포 또는 Mobile release cutover가 필요해지면 별도 release record로 분리한다.

관련 문서

• API 클라이언트 계약 패키지 정책
• API 계약 변경 모바일 릴리즈 플로우
• 배포/릴리즈 프로세스
• 2.2.5 릴리스 실행 기록