fix: 2026-11-05 리뷰를 기록하고 P1 3건을 고친다 #5

Merged
donghyeon.kang merged 7 commits from fix/maturity-review-2026-11-05 into main 2026-11-07 08:19:51 +00:00
Owner

무엇을, 왜

2026-11-05 4라운드 성숙도 리뷰 기록과, 그 리뷰가 찾은 새 P1 3건의 수정을 담는다. 나머지 발견(Medium·Low 45건과 지난 라운드에서 일부만 고친 22건)은 이 PR 위에 쌓는 다음 PR에서 고친다.

  • 리뷰 기록 (e85c836): docs/reviews/2026-11-05-maturity-review/. 기준은 8a44226(main 409d72e와 같은 트리)이다. 새 발견은 48건(High 0, Medium 11, Low 37 / P1 3, P2 15, P3 30)이다. 지난 라운드 88건(High 2, P1 12)에서 줄었다.
  • 1105/09-01 (397664e): 제품 확장 타입 검사 탐침이 복사본의 product-contracts·product-composition을 덮어써서, 기능에 제품 고유 기능을 준 다운스트림(tech-log, memento)은 FE-GATE-005가 항상 실패했다. 탐침이 덮어쓰지 않고 덧붙인다.
  • 1105/12-01 (9655958, 1105/11-02 합침): FE-GATE-013은 러너가 비특권 user·network namespace를 허용한다고 가정하는데, 어디에도 적혀 있지 않았다. 사전 점검은 PASS를 찍고 그 뒤 18건이 bwrap 오류로 실패했다.
    • 사전 점검이 bwrap --unshare-pid --unshare-ipc --unshare-uts --unshare-net을 실제로 만들어 본다. 실패하면 원인, sysctl 값, 고치는 법을 내고 멈춘다.
    • 요건을 config/ci/gates.json의 FE-GATE-013 hostRequirements(생성 workflow의 runs-on 위 주석으로 그려진다), docs/operations/ci-quality-gates.md(AppArmor profile 예시 포함), docs/security/supply-chain.md, docs/testing/taxonomy.md, README merge 게이트 절에 적었다.
  • 1105/13-01 (629c713): release job immutable_build가 FE-GATE-015·027의 게이트 로그를 올리지 않아, 실제 실행에서 release 실패 이유와 13-03 advisory 경고가 사라졌다. 로그·증거·dependency-advisories.json을 if: always()로 올린다. 후보 archive의 파일 집합은 그대로다.

고른 방법과 버린 대안

  • 09-01: 탐침은 복사본의 제품 파일을 typecheck-probe-product-*.ts로 옮겨 export *로 다시 내보내고, 그 위에 탐침의 키·행·capability만 더한다. "제품 capability를 기능에 주는 다운스트림"을 흉내 내는 케이스도 더했다.
    • 버린 대안 1: 제품 파일이 출하 상태가 아니면 탐침을 건너뛴다. 다운스트림 상태의 타입 경로 확인을 잃고, 건너뛰기로 검사를 약하게 만든다.
    • 버린 대안 2: 다운스트림 흉내를 제품 파일을 새로 쓰는 방식으로 만든다. 실제 다운스트림에서 돌리면 그 제품의 capability를 지워 같은 오류가 다시 난다.
  • 12-01: 사전 점검이 provider와 같은 namespace 옵션으로 bwrap에서 /bin/true를 한 번 띄운다. 옵션은 공유 상수(scripts/lib/provider-sandbox-namespaces.ts)로 옮겨, 점검과 provider 실행이 갈라지지 않게 했다. 값은 그대로다.
    • 버린 대안 1: namespace가 없으면 provider 테스트를 skip한다. 거짓 초록이다.
    • 버린 대안 2: FE-GATE-013을 release 단계로 옮긴다. PR마다 샌드박스 검사를 잃는다.
    • 버린 대안 3: runner label로 요건을 표현한다. runner label 체계가 아직 없어 workflow 주석으로 적었다.
  • 13-01: immutable_build 마지막에 always upload 단계를 두고, FE-GATE-015·027의 로그·증거와 advisory 기록만 올린다. 경로는 계약의 artifact 등록에서 계산한다.
    • 버린 대안 1: artifacts/ 전체를 올린다. 후보 증거가 두 이름으로 나가 어느 것이 승격 대상인지 흐려진다.
    • 버린 대안 2: ci:gate가 실패한 명령의 마지막 줄들을 콘솔에 쓴다. 모든 job에 걸리고 provider 출력의 비밀 노출과 로그 상한을 다시 따져야 한다.
  • PR 나누기: 이 PR은 P1만 담는다. 커밋 규칙 5.1절의 PR 크기 기준 때문이다. 나머지는 이 PR 위의 다음 PR로 보낸다.

위험과 영향

  • FE-GATE-013의 동작이 바뀐다. user namespace를 막는 호스트에서는 provider 테스트를 돌리지 않고 사전 점검에서 실패한다. 전에는 PASS를 찍은 뒤 18건이 원인 모를 오류로 실패했다. 이 저장소의 desktop 검증 호스트가 그런 호스트다(아래 "검증").
  • namespace를 허용하는 호스트에서 통과하는 경로는 단위 테스트의 가짜 bwrap으로만 확인했다. 실제 그런 호스트에서는 이 PR의 커밋으로 돌리지 않았다.
  • hostRequirements는 새 선택 칸이다. 기준선 gate-shape hash에는 넣지 않아 contract-baseline.json을 다시 기록하지 않았다. 이 칸이 나중에 바뀌어도 기준선 검사가 알리지 않는다. 다음 PR에서 hash에 넣을지 정한다.
  • 실제 Gitea runner의 release 단계(stage=release)는 돌리지 않았다. 13-01의 업로드는 계약과 workflow 생성 테스트로만 확인했다. checkout·install에서 실패하면 올릴 파일이 없어 이 upload 단계도 실패한다. job은 이미 실패한 뒤라 결과는 같다.
  • 09-01의 한계: 탐침은 제품 파일의 export 이름(composeProduct, composeProductSessionOwner, PRODUCT_*)에 기댄다. 템플릿이 그 이름을 import하므로 계약이다.
  • CHANGELOG: 409d72e → 이 브랜치의 새 미출시 절을 열었다(a793b83). PR #4로 들어간 이전 절의 머리에 main에 merge됐다고 적었다.
  • 계약 변경 없음. 공개 이름(adapter 배럴, 계약 타입)은 바뀌지 않았다.

검증

a793b83에서 merge 단계 게이트 14개를 corepack pnpm ci:gate FE-GATE-NNN으로 하나씩 돌렸다.

  • 어디서: desktop(12코어, 31 GB). 다른 세션과 공유하는 잠금 하나 안에서 checkout부터 복원까지 한 번에 돌렸다.
  • env: workflow와 같은 CI=true, VITE_COMMIT_SHA(40자리), VITE_BUILD_ID, RELEASE_ID, CI_RUNNER_IMAGE(형식만 맞춘 가짜 digest)
게이트 결과
FE-GATE-001~012, 020 모두 한 번에 통과. 008: e2e·capability·storybook·visual, 020: 1,186초
FE-GATE-013 사전 점검에서 실패(의도한 결과). "this host does not allow unprivileged user and network namespaces"와 sysctl 값, 고치는 법을 낸다

FE-GATE-013의 사전 점검 뒤 부분은 같은 env로 따로 돌렸다.

  • tests/system: 114건 중 96건 통과. 18건은 provider 샌드박스 테스트이고, 모두 bwrap이 loopback을 만들지 못한 실패(RTM_NEWADDR)다.
  • 나머지 명령 7개(verify:reproducible-build, build:release-candidate, verify:local-evidence, supply-chain fixture 둘, security fixture, check:browser-security)는 모두 통과했다.

수정 세션이 돌린 것(desktop): 발견마다 RED → GREEN, check:ci, check:types, lint, check:architecture, 관련 unit 476건, 백엔드 checkout이 옆에 없는 곳에서 verify:documentation(PASS_SCOPED), 문서·CHANGELOG 테스트 22건.

실행하지 않은 것:

  • 실제 Gitea runner(merge·release 단계)
  • user namespace를 허용하는 호스트에서 provider 샌드박스 테스트 18건

리뷰어가 볼 곳

  • tests/unit/product-extension-typecheck.test.ts — 탐침이 복사본에 파일을 덧붙이는 부분
  • scripts/check-system-test-prerequisites.ts — namespace 실제 생성과 실패 메시지
  • scripts/generate-ci-workflow.ts와 스냅샷 — immutable_build의 업로드 단계
  • scripts/contracts/ci-gates.ts — 새 칸 hostRequirements와 gate-shape hash에서 뺀 이유
  • 리뷰 기록은 docs/reviews/2026-11-05-maturity-review/README.md부터 읽는다. 영역 문서 16개는 근거다.

관련

  • docs/reviews/2026-11-05-maturity-review/README.md — 4라운드 리뷰, 발견 색인, 지난 라운드 96건의 ID별 재판정
  • 이전 PR: #4 (409d72e)
  • CHANGELOG.md 미출시 절(409d72e → 이 브랜치)
## 무엇을, 왜 2026-11-05 4라운드 성숙도 리뷰 기록과, 그 리뷰가 찾은 새 P1 3건의 수정을 담는다. 나머지 발견(Medium·Low 45건과 지난 라운드에서 일부만 고친 22건)은 이 PR 위에 쌓는 다음 PR에서 고친다. - **리뷰 기록** (`e85c836`): `docs/reviews/2026-11-05-maturity-review/`. 기준은 `8a44226`(main `409d72e`와 같은 트리)이다. 새 발견은 48건(High 0, Medium 11, Low 37 / P1 3, P2 15, P3 30)이다. 지난 라운드 88건(High 2, P1 12)에서 줄었다. - **1105/09-01** (`397664e`): 제품 확장 타입 검사 탐침이 복사본의 `product-contracts`·`product-composition`을 덮어써서, 기능에 제품 고유 기능을 준 다운스트림(tech-log, memento)은 FE-GATE-005가 항상 실패했다. 탐침이 덮어쓰지 않고 덧붙인다. - **1105/12-01** (`9655958`, 1105/11-02 합침): FE-GATE-013은 러너가 비특권 user·network namespace를 허용한다고 가정하는데, 어디에도 적혀 있지 않았다. 사전 점검은 PASS를 찍고 그 뒤 18건이 bwrap 오류로 실패했다. - 사전 점검이 `bwrap --unshare-pid --unshare-ipc --unshare-uts --unshare-net`을 실제로 만들어 본다. 실패하면 원인, sysctl 값, 고치는 법을 내고 멈춘다. - 요건을 `config/ci/gates.json`의 FE-GATE-013 `hostRequirements`(생성 workflow의 `runs-on` 위 주석으로 그려진다), `docs/operations/ci-quality-gates.md`(AppArmor profile 예시 포함), `docs/security/supply-chain.md`, `docs/testing/taxonomy.md`, README merge 게이트 절에 적었다. - **1105/13-01** (`629c713`): release job `immutable_build`가 FE-GATE-015·027의 게이트 로그를 올리지 않아, 실제 실행에서 release 실패 이유와 13-03 advisory 경고가 사라졌다. 로그·증거·`dependency-advisories.json`을 `if: always()`로 올린다. 후보 archive의 파일 집합은 그대로다. ## 고른 방법과 버린 대안 - **09-01:** 탐침은 복사본의 제품 파일을 `typecheck-probe-product-*.ts`로 옮겨 `export *`로 다시 내보내고, 그 위에 탐침의 키·행·capability만 더한다. "제품 capability를 기능에 주는 다운스트림"을 흉내 내는 케이스도 더했다. - 버린 대안 1: 제품 파일이 출하 상태가 아니면 탐침을 건너뛴다. 다운스트림 상태의 타입 경로 확인을 잃고, 건너뛰기로 검사를 약하게 만든다. - 버린 대안 2: 다운스트림 흉내를 제품 파일을 새로 쓰는 방식으로 만든다. 실제 다운스트림에서 돌리면 그 제품의 capability를 지워 같은 오류가 다시 난다. - **12-01:** 사전 점검이 provider와 같은 namespace 옵션으로 bwrap에서 `/bin/true`를 한 번 띄운다. 옵션은 공유 상수(`scripts/lib/provider-sandbox-namespaces.ts`)로 옮겨, 점검과 provider 실행이 갈라지지 않게 했다. 값은 그대로다. - 버린 대안 1: namespace가 없으면 provider 테스트를 skip한다. 거짓 초록이다. - 버린 대안 2: FE-GATE-013을 release 단계로 옮긴다. PR마다 샌드박스 검사를 잃는다. - 버린 대안 3: runner label로 요건을 표현한다. runner label 체계가 아직 없어 workflow 주석으로 적었다. - **13-01:** `immutable_build` 마지막에 `always` upload 단계를 두고, FE-GATE-015·027의 로그·증거와 advisory 기록만 올린다. 경로는 계약의 artifact 등록에서 계산한다. - 버린 대안 1: `artifacts/` 전체를 올린다. 후보 증거가 두 이름으로 나가 어느 것이 승격 대상인지 흐려진다. - 버린 대안 2: `ci:gate`가 실패한 명령의 마지막 줄들을 콘솔에 쓴다. 모든 job에 걸리고 provider 출력의 비밀 노출과 로그 상한을 다시 따져야 한다. - **PR 나누기:** 이 PR은 P1만 담는다. 커밋 규칙 5.1절의 PR 크기 기준 때문이다. 나머지는 이 PR 위의 다음 PR로 보낸다. ## 위험과 영향 - **FE-GATE-013의 동작이 바뀐다.** user namespace를 막는 호스트에서는 provider 테스트를 돌리지 않고 사전 점검에서 실패한다. 전에는 PASS를 찍은 뒤 18건이 원인 모를 오류로 실패했다. 이 저장소의 desktop 검증 호스트가 그런 호스트다(아래 "검증"). - **namespace를 허용하는 호스트에서 통과하는 경로**는 단위 테스트의 가짜 bwrap으로만 확인했다. 실제 그런 호스트에서는 이 PR의 커밋으로 돌리지 않았다. - **`hostRequirements`는 새 선택 칸이다.** 기준선 gate-shape hash에는 넣지 않아 `contract-baseline.json`을 다시 기록하지 않았다. 이 칸이 나중에 바뀌어도 기준선 검사가 알리지 않는다. 다음 PR에서 hash에 넣을지 정한다. - **실제 Gitea runner의 release 단계**(stage=release)는 돌리지 않았다. 13-01의 업로드는 계약과 workflow 생성 테스트로만 확인했다. checkout·install에서 실패하면 올릴 파일이 없어 이 upload 단계도 실패한다. job은 이미 실패한 뒤라 결과는 같다. - **09-01의 한계:** 탐침은 제품 파일의 export 이름(`composeProduct`, `composeProductSessionOwner`, `PRODUCT_*`)에 기댄다. 템플릿이 그 이름을 import하므로 계약이다. - **CHANGELOG:** `409d72e` → 이 브랜치의 새 미출시 절을 열었다(`a793b83`). PR #4로 들어간 이전 절의 머리에 main에 merge됐다고 적었다. - **계약 변경 없음.** 공개 이름(adapter 배럴, 계약 타입)은 바뀌지 않았다. ## 검증 `a793b83`에서 merge 단계 게이트 14개를 `corepack pnpm ci:gate FE-GATE-NNN`으로 하나씩 돌렸다. - 어디서: desktop(12코어, 31 GB). 다른 세션과 공유하는 잠금 하나 안에서 checkout부터 복원까지 한 번에 돌렸다. - env: workflow와 같은 `CI=true`, `VITE_COMMIT_SHA`(40자리), `VITE_BUILD_ID`, `RELEASE_ID`, `CI_RUNNER_IMAGE`(형식만 맞춘 가짜 digest) | 게이트 | 결과 | |---|---| | FE-GATE-001~012, 020 | 모두 한 번에 통과. 008: e2e·capability·storybook·visual, 020: 1,186초 | | FE-GATE-013 | 사전 점검에서 실패(의도한 결과). "this host does not allow unprivileged user and network namespaces"와 sysctl 값, 고치는 법을 낸다 | FE-GATE-013의 사전 점검 뒤 부분은 같은 env로 따로 돌렸다. - `tests/system`: 114건 중 96건 통과. 18건은 provider 샌드박스 테스트이고, 모두 bwrap이 loopback을 만들지 못한 실패(`RTM_NEWADDR`)다. - 나머지 명령 7개(`verify:reproducible-build`, `build:release-candidate`, `verify:local-evidence`, supply-chain fixture 둘, security fixture, `check:browser-security`)는 모두 통과했다. 수정 세션이 돌린 것(desktop): 발견마다 RED → GREEN, `check:ci`, `check:types`, `lint`, `check:architecture`, 관련 unit 476건, 백엔드 checkout이 옆에 없는 곳에서 `verify:documentation`(`PASS_SCOPED`), 문서·CHANGELOG 테스트 22건. **실행하지 않은 것:** - 실제 Gitea runner(merge·release 단계) - user namespace를 허용하는 호스트에서 provider 샌드박스 테스트 18건 ## 리뷰어가 볼 곳 - `tests/unit/product-extension-typecheck.test.ts` — 탐침이 복사본에 파일을 덧붙이는 부분 - `scripts/check-system-test-prerequisites.ts` — namespace 실제 생성과 실패 메시지 - `scripts/generate-ci-workflow.ts`와 스냅샷 — `immutable_build`의 업로드 단계 - `scripts/contracts/ci-gates.ts` — 새 칸 `hostRequirements`와 gate-shape hash에서 뺀 이유 - 리뷰 기록은 `docs/reviews/2026-11-05-maturity-review/README.md`부터 읽는다. 영역 문서 16개는 근거다. ## 관련 - `docs/reviews/2026-11-05-maturity-review/README.md` — 4라운드 리뷰, 발견 색인, 지난 라운드 96건의 ID별 재판정 - 이전 PR: #4 (`409d72e`) - `CHANGELOG.md` 미출시 절(`409d72e` → 이 브랜치)
donghyeon.kang added 7 commits 2026-11-05 13:53:49 +00:00
2026-11-03 리뷰의 조치가 main(409d72e)에 들어간 뒤 전체를 다시 봐야
한다. 지난 README 14.4절의 상태 판정("그 밖의 81건 고침")과, 조치가
검사를 약하게 했는지는 아무도 확인하지 않았다.

가이드 기준으로 16개 영역을 다시 리뷰했다. 기준은 8a44226(= main
409d72e 트리)이다. desktop에서 merge 단계 14개(workflow env)와
CLAUDE.md 게이트 목록을 직접 돌렸다. 실험은 게이트가 끝난 뒤 78항목을
한 묶음으로 하나씩 돌렸고, 항목마다 checkout을 기준 커밋으로 되돌렸다.
처음에는 영역마다 따로 실행했으나 공유 잠금에 30여 건이 줄을 서서
취소했다(README 11.4절).

결과: 새 발견 48건(High 0, Medium 11, Low 37 / P1 3, P2 15, P3 30).
P1은 09-01, 12-01, 13-01. 지난 96건은 고쳐짐 74, 일부 22이고,
14.4절이 고침이라 한 13건을 일부로 바로잡았다. merge 게이트는 13/14
통과, FE-GATE-013은 호스트 user namespace 제한으로 실패한다.

위험·한계: 실제 Gitea 러너와 짝 백엔드 연동은 확인하지 못했다(README
8절). 리뷰라 코드는 고치지 않았다. 영역 문서의 실행 기록 일부는
리뷰 세션 scratchpad 경로를 가리킨다.

검증: desktop에서 이 커밋으로 documentation-readiness,
deletable-history-documents, changelog-review-ids 테스트와
verify:documentation(옆 백엔드 checkout 없이)을 돌렸다.

Refs: docs/reviews/2026-11-05-maturity-review/README.md
문제
tests/unit/product-extension-typecheck.test.ts(1103/09-02 탐침)는 저장소
복사본의 src/contracts/product-contracts.ts와
src/bootstrap/product-composition.ts를 탐침 내용으로 통째로 바꿔 쓴다.
탐침의 composeProduct는 typecheckProbeSettings 하나만 돌려준다. 제품이
자기 capability를 product-composition.ts에서 만들고 자기 기능의 needs에
적으면, 복사본에서는 그 값이 사라져 app 프로그램이
src/bootstrap/runtime-adapters.ts에서 TS2741로 실패한다. memento와
tech-log 모두 제품 capability를 쓰므로, 동기화 직후 FE-GATE-005가 코드와
무관하게 실패한다(리뷰 실험 09-probe-downstream).

고른 방법
- 탐침은 복사본의 product-contracts.ts·product-composition.ts를 같은
  폴더의 typecheck-probe-product-contracts.ts·
  typecheck-probe-product-composition.ts로 옮긴다. 새 파일은 옮긴 모듈을
  export *로 다시 내보낸다. 그리고 런타임 설정 필드, env 행,
  composeProduct 결과와 그 capabilities를 펼친 뒤 탐침의 키·행·capability만
  더한다. 인증 프로필, credential provider, 선택 칸, session owner, 제품이
  더한 다른 export는 그대로 남는다.
- capability 타입은 저장소가 아니라 복사본의 product-capabilities.ts 끝에
  덧붙인다.
- 같은 함수로 "제품 capability를 기능에 주는 다운스트림"을 먼저 만들고 그
  위에 탐침을 올리는 케이스를 더했다(describe 1105/09-01). 다운스트림
  흉내도 덧붙이는 방식이라, 실제 다운스트림에서 이 테스트를 돌려도 그
  제품의 파일을 지우지 않는다. 이름은 예약 접두사
  typecheck-probe-downstream-*를 쓴다.
- 예약 이름 검사는 기능 폴더에 더해 context 폴더와 옮길 파일 이름도 본다.

버린 대안
- 제품 파일이 출하 상태가 아니면 탐침을 건너뛴다(리뷰의 (나)). 다운스트림
  상태의 타입 경로 확인을 잃고, 건너뛰기로 검사를 약하게 한다.
- 다운스트림 흉내를 제품 파일 전체를 새로 쓰는 방식으로 만든다. 실제
  다운스트림에서 이 테스트를 돌리면 그 제품의 capability를 지워 같은
  TS2741이 다시 난다.

위험·한계
- 제품 파일의 export 이름(composeProduct, composeProductSessionOwner,
  PRODUCT_*)에 기댄다. 템플릿이 그 이름을 import하므로 계약이다.
- credentialProviders와 인증 프로필은 Record라 빠져도 tsc가 모른다.
  펼쳐서 남기지만 테스트로 증명하지는 않는다.
- 탐침 context는 여전히 소유 앱을 template-app으로 고정한다. 앱 id를
  바꾼 제품에서는 생성기가 멈출 수 있다(리뷰 09-01의 남은 가정, 실행
  안 함). 이 커밋 범위 밖이다.
- 케이스가 하나 늘어 이 파일의 tsc 실행이 3회에서 6회가 된다. 케이스별
  제한 시간 120초는 그대로다.
- 결함이 테스트 파일 안의 탐침에 있어서, 표준 RED 구성(커밋의 테스트 +
  부모의 비테스트 파일)은 GREEN과 같다. RED는 커밋 위에 탐침을 부모처럼
  덮어쓰게 되돌리는 patch를 적용해 본다.

검증
- desktop batch에서 확인: node scripts/run-vitest.ts run
  tests/unit/product-extension-typecheck.test.ts, check:types, lint.
  RED patch를 적용하면 1105/09-01 케이스만 TS2741로 실패해야 한다.
- 이 노트북에서는 실행하지 않았다.

Refs: 1105/09-01
문제: FE-GATE-013의 provider sandbox는 bwrap을 --unshare-pid
--unshare-ipc --unshare-uts --unshare-net으로 띄운다. bwrap이 setuid가
아니므로 비특권 user namespace가 있어야 한다. 사전 점검
(scripts/check-system-test-prerequisites.ts)은 실행 파일·cgroup·systemd
bus만 보고 bwrap을 한 번도 실행하지 않는다. 그래서 이 제한이 있는 호스트
(Ubuntu 24.04, kernel.apparmor_restrict_unprivileged_userns=1)에서 PASS를
낸 뒤 provider 테스트 114건 중 18건이 "bwrap: loopback: Failed
RTM_NEWADDR: Operation not permitted" 또는 그 provider를 기다린 시간
초과로 실패한다. 이 조건은 runner 요구 목록, gate 정의, workflow 어디에도
없고 운영 원장의 일회성 메모에만 있다.

고른 방법:
- 사전 점검이 provider와 같은 namespace 옵션으로 bwrap에서 /bin/true를 한
  번 띄운다. 실패하면 "this host does not allow unprivileged user and
  network namespaces", bwrap stderr(최대 4줄), user namespace sysctl 값,
  고치는 방법 셋(AppArmor profile, sysctl, 다른 runner)을 적고 exit 1.
  기존 검사(실행 파일 3개, cgroup v2, systemd bus)는 그대로 둔다.
- 옵션 목록을 scripts/lib/provider-sandbox-namespaces.ts로 옮기고
  run-and-validate-provider.ts와 사전 점검이 같은 상수를 쓴다. 둘이
  갈라지면 점검이 다른 것을 시험하게 된다.
- 점검을 findSystemTestPrerequisiteFailures(host)로 내보내고 access·
  readFile·spawn을 주입받는다. CLI 동작(출력·exit 코드)은 같다.
- config/ci/gates.json의 FE-GATE-013에 hostRequirements 두 줄을 둔다.
  gate schema에 선택 필드를 더하고, generator가 그 gate를 도는 job의
  runs-on 바로 위에 "# FE-GATE-013 runner requirement: ..." 주석으로
  그린다. runner를 고르는 사람이 보는 자리다. 줄바꿈은 기존 nonEmpty
  규칙이 막으므로 주석 밖으로 나갈 수 없다. 이 필드는 gate의 명령·증거가
  아니라 runner 설명이라 기준선 gate shape 해시에는 넣지 않았다(기준선
  재기록 불필요).
- 요구 목록 세 곳(docs/operations/ci-quality-gates.md,
  docs/security/supply-chain.md, docs/testing/taxonomy.md)과 README merge
  게이트 절에 조건을 적었다. ci-quality-gates.md에 AppArmor profile 예시를
  두었다.

버린 대안:
- namespace가 없으면 provider 테스트를 skip: 거짓 초록이다.
- FE-GATE-013을 release 단계로 옮김: PR마다 sandbox 검사를 잃는다.
- probe를 systemd-run --user --scope 안에서 돌림: 리뷰 11-R10에서 scope
  안과 밖의 결과가 같았다. 직접 실행이 더 단순하다.
- workflow에 요구 사항을 runs-on label로 표현: runner label 체계가 아직
  없다. 주석이 지금 가능한 가장 작은 표시다.

위험·한계:
- probe는 bwrap에 --ro-bind / /만 준다. --size 같은 provider의 다른
  옵션 지원은 여기서 보지 않는다(기존과 같다). probe가 다른 이유로
  실패해도 namespace 문구가 나오지만 bwrap stderr를 같이 적는다.
- 호스트를 고칠지는 호스트 소유자가 정한다. 이 커밋은 조건을 적고 알리기만
  한다. 이 desktop에서 FE-GATE-013은 여전히 실패하고, 이제 첫 단계에서
  이유와 함께 실패한다.
- gate schema에 선택 필드 hostRequirements가 생겼다. 기존 gates.json과
  제품 overlay는 그대로 통과한다.

검증: desktop batch에서 확인
- node scripts/run-vitest.ts run tests/unit/system-test-prerequisites.test.ts tests/unit/ci-workflow-generation.test.ts
- corepack pnpm check:ci, check:types, lint, verify:documentation
- desktop에서 node scripts/check-system-test-prerequisites.ts가 exit 1과
  namespace 문구를 내는지, FE-GATE-013이 그 단계에서 멈추는지

Refs: 1105/12-01, 1105/11-02
문제: ci:gate는 명령 출력을 artifacts/quality/gates/FE-GATE-<NNN>.txt에만
쓰고 콘솔에는 PASS/FAIL 한 줄만 남긴다(scripts/run-ci-gate.ts). release
단계 job immutable_build는 후보 tar만, 그것도 성공했을 때만 올린다. 그래서
실제 run에서 FE-GATE-015·027이 왜 실패했는지와 FE-GATE-027이 쓰는
artifacts/security/dependency-advisories.json(1103/13-03의 신호)이 runner
작업 디렉터리와 함께 사라진다. 다른 gate job은 artifacts/를 if: always()로
올린다.

고른 방법:
- config/ci/gates.json의 immutable_build 마지막에 upload 단계를 더한다.
  transfer ID는 immutable-gate-evidence, 이름은
  immutable-gate-evidence-<run>-<attempt>, always: true. 대상은
  FE-GATE-015·027의 log와 evidence 산출물(gate 순서)과 advisory 기록 7개다.
  FE-GATE-015의 verification.json 등은 후보가 만들어지지 않으면 후보 안에도
  없으므로 같이 올린다.
- 계약(scripts/contracts/ci-gates.ts)이 이 단계를 고정한다. immutable_build의
  단계 목록에 upload 하나가 늘고, 이 upload가 always이고 마지막 단계이며
  경로가 "job이 도는 gate의 log·evidence 경로 + advisory 기록"과 같아야
  한다. 경로는 계약의 artifact 등록에서 계산하므로 log 경로가 바뀌면 함께
  따라온다. advisory 기록은 gate evidence가 아니라(막지 않는 신호) 경로를
  scripts/lib/dependency-advisories.ts의 상수로 옮기고 scan 스크립트도 그
  상수를 쓴다.
- 후보 archive의 member set, 후보 upload(always 없음), 하위 job의 download는
  그대로다. 생성 workflow를 generator 출력과 같게 손으로 고쳤다.

버린 대안:
- immutable_build도 artifacts/ 전체를 올림: 다른 job과 같지만 후보 증거가
  두 이름으로 나가 어느 것이 승격 대상인지 흐려진다. 필요한 파일만 고정했다.
- ci:gate가 실패한 명령의 마지막 N줄을 콘솔에 씀(리뷰 대안 c, d의 콘솔
  한 줄 포함): 모든 job에 걸리고 provider 출력의 비밀 노출과 로그 상한을
  다시 따져야 한다. 담당 지시 범위(업로드) 밖이라 이번에 하지 않았다.

위험·한계:
- checkout·install 단계에서 실패하면 올릴 파일이 없어 이 단계도
  if-no-files-found: error로 실패한다. job은 이미 실패한 뒤라 결과는 같다.
  merge·release job의 upload도 같은 동작이다.
- 실제 Gitea runner에서 stage=release를 돌려 산출물이 남는지는 확인하지
  못했다(runner 없음). 확인한 것은 계약·생성 workflow까지다.
- 콘솔에는 여전히 한 줄만 나온다. 사람이 산출물을 열어야 이유를 본다.

검증: desktop batch에서 확인
- node scripts/run-vitest.ts run tests/unit/ci-workflow-generation.test.ts
- corepack pnpm check:ci, check:types, lint, verify:documentation

Refs: 1105/13-01, 1103/13-03
CHANGELOG의 미출시 절은 `752a61f` → `fix/maturity-review-2026-11-03`
범위다. 그 범위는 main `409d72e`에 합쳐졌고, 2026-11-05 리뷰의 P1
조치 셋(1105/09-01, 12-01, 13-01)은 어느 절에도 없다. 다운스트림이
FE-GATE-013 러너 요구와 release job의 새 upload를 알 수 없다.

`409d72e` → `fix/maturity-review-2026-11-05` 범위의 새 미출시 절을
위에 두고 세 조치를 적었다. CI 러너 요구와 workflow upload가 바뀌므로
12-01·13-01은 [계약]이다. 기존 절은 지우지 않고 main에 합쳐졌다고만
머리에 적었다. 두 절을 하나로 합칠지는 남은 조치(PR B)의 CHANGELOG
정리에서 정한다.

위험·한계: 문서만 바꿨다.

검증: desktop batch에서 changelog-review-ids, documentation-readiness
테스트.

Refs: 1105/09-01, 1105/12-01, 1105/13-01
donghyeon.kang merged commit 8c376f1c29 into main 2026-11-07 08:19:51 +00:00
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: donghyeon.kang/clean-architecture-frontend-template#5