docs: 로컬 merge 게이트 실행 안내에 workflow의 CI env를 적는다
문제 README의 로컬 merge 게이트 반복문과 매뉴얼 01, 생성 명령 출력은 CI=true와 CI 빌드 식별값 없이 돌리는 법만 적는다. 그렇게 통과해도 workflow(CI=true)에서 떨어지는 결함 두 건(1103/11-07, 11-08)이 이 차이로 숨었다. 고른 방법 - README 반복문 아래에 workflow와 같은 env 블록(CI=true, VITE_COMMIT_SHA, VITE_BUILD_ID, RELEASE_ID, CI_RUNNER_IMAGE digest)과 깨끗한 clone에서 돌리라는 말을 더한다. 테스트가 만드는 로컬 빌드는 이 값과 무관하게 로컬 빌드로 돈다는 것도 적는다. - 매뉴얼 01 "merge 전에 돌릴 것"과 생성 명령 Next 2번이 그 블록을 가리킨다. 검증 - verify:documentation PASS_SCOPED, tests/unit/create-feature.test.ts 43건. Refs: docs/reviews/2026-11-03-maturity-review/README.md 13절 11-08
This commit is contained in:
@@ -337,6 +337,18 @@ for gate in 001 002 003 004 005 006 007 008 009 010 011 012 013 020; do
|
|||||||
corepack pnpm ci:gate -- "FE-GATE-$gate" || break
|
corepack pnpm ci:gate -- "FE-GATE-$gate" || break
|
||||||
done
|
done
|
||||||
```
|
```
|
||||||
|
|
||||||
|
To run them as the workflow does, give the workflow's environment first.
|
||||||
|
`CI=true` makes the runner and the release build require the CI build
|
||||||
|
identity; builds a test makes of a copy (fixture builds, the visual goldens'
|
||||||
|
build, the dev servers of the browser tests) run as local builds whatever this
|
||||||
|
says (`localBuildEnvironment` in `scripts/lib/build-environment.ts`). Run it in
|
||||||
|
a clean clone: `ci:gate` stops a gate at its first failing command.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
export CI=true VITE_COMMIT_SHA="$(git rev-parse HEAD)" VITE_BUILD_ID=local-ci-1 \
|
||||||
|
RELEASE_ID=local-ci-1 CI_RUNNER_IMAGE="local/runner@sha256:$(printf 'a%.0s' $(seq 64))"
|
||||||
|
```
|
||||||
Machine-readable evidence is written below `artifacts/`; generated evidence is
|
Machine-readable evidence is written below `artifacts/`; generated evidence is
|
||||||
ignored by Git while `.gitkeep` files preserve the taxonomy.
|
ignored by Git while `.gitkeep` files preserve the taxonomy.
|
||||||
|
|
||||||
|
|||||||
@@ -667,3 +667,4 @@ corepack pnpm test:sample-removal -- --feature=invoice-feature
|
|||||||
- 생성 명령의 드릴(`test:feature-scaffold`)도 merge 단계 명령으로 이 검사를 돈다.
|
- 생성 명령의 드릴(`test:feature-scaffold`)도 merge 단계 명령으로 이 검사를 돈다.
|
||||||
- 참조 기능이 설치돼 있으면 초기 JS 기록(config/scale/feature-shape-ceilings.json)도 기능과 함께 바뀐다. test:unit이 빌드와 대조한다. 생성 명령 출력 `Next:` 3번의 명령으로 다시 쓰고 같은 커밋에 넣는다. 기능 제거 드릴(`test:sample-removal -- --feature=<id>`)은 지운 뒤 기록을 다시 쓰고 검사한다.
|
- 참조 기능이 설치돼 있으면 초기 JS 기록(config/scale/feature-shape-ceilings.json)도 기능과 함께 바뀐다. test:unit이 빌드와 대조한다. 생성 명령 출력 `Next:` 3번의 명령으로 다시 쓰고 같은 커밋에 넣는다. 기능 제거 드릴(`test:sample-removal -- --feature=<id>`)은 지운 뒤 기록을 다시 쓰고 검사한다.
|
||||||
- 로컬에서 FE-GATE-013을 돌리려면 `VITE_COMMIT_SHA=$(git rev-parse HEAD)`를 준다. 없으면 release candidate가 `source.revision`을 거절한다. 실패한 게이트의 로그는 `artifacts/quality/gates/FE-GATE-<NNN>.txt`에 있다.
|
- 로컬에서 FE-GATE-013을 돌리려면 `VITE_COMMIT_SHA=$(git rev-parse HEAD)`를 준다. 없으면 release candidate가 `source.revision`을 거절한다. 실패한 게이트의 로그는 `artifacts/quality/gates/FE-GATE-<NNN>.txt`에 있다.
|
||||||
|
- workflow와 같은 조건으로 돌리려면 README 로컬 merge 게이트 반복문 아래의 env 블록대로 `CI=true`와 CI 빌드 식별값(`VITE_COMMIT_SHA`, `VITE_BUILD_ID`, `RELEASE_ID`, `CI_RUNNER_IMAGE` digest)을 주고 깨끗한 clone에서 돌린다. 이 값 없이 통과해도 CI에서 떨어질 수 있다(1103/11-07, 11-08).
|
||||||
|
|||||||
@@ -1749,7 +1749,7 @@ function report(plan: FeaturePlan): string {
|
|||||||
.join(", ")} (FE-GATE-028). The merge gates check only their format.`,
|
.join(", ")} (FE-GATE-028). The merge gates check only their format.`,
|
||||||
" 2. Run the merge gates: corepack pnpm ci:gate -- FE-GATE-<NNN> for each gate of the merge stage in config/ci/gates.json (README lists the loop). test:feature-scaffold runs them on a generated feature except the browser gates FE-GATE-008/009 and test:system.",
|
" 2. Run the merge gates: corepack pnpm ci:gate -- FE-GATE-<NNN> for each gate of the merge stage in config/ci/gates.json (README lists the loop). test:feature-scaffold runs them on a generated feature except the browser gates FE-GATE-008/009 and test:system.",
|
||||||
` The feature's own tests: node scripts/run-vitest.ts run tests/features/${plan.id} (test:coverage runs them in CI)`,
|
` The feature's own tests: node scripts/run-vitest.ts run tests/features/${plan.id} (test:coverage runs them in CI)`,
|
||||||
" A failing gate's log is artifacts/quality/gates/FE-GATE-<NNN>.txt. Locally FE-GATE-013 needs VITE_COMMIT_SHA=$(git rev-parse HEAD).",
|
" A failing gate's log is artifacts/quality/gates/FE-GATE-<NNN>.txt. Locally FE-GATE-013 needs VITE_COMMIT_SHA=$(git rev-parse HEAD); to run them as CI does, set CI=true and the CI build identity (README).",
|
||||||
" 3. The initial JavaScript changes. While config/scale/feature-shape-ceilings.json exists (the sample is installed), rewrite it with node scripts/scale/measure-feature-shape-growth.ts --initial-baseline --write and commit it with the feature; test:unit compares it with a build. corepack pnpm check:bundle checks the budget.",
|
" 3. The initial JavaScript changes. While config/scale/feature-shape-ceilings.json exists (the sample is installed), rewrite it with node scripts/scale/measure-feature-shape-growth.ts --initial-baseline --write and commit it with the feature; test:unit compares it with a build. corepack pnpm check:bundle checks the budget.",
|
||||||
" public/release-manifest.json (the dev server's manifest) now names the feature's contract package; commit it with the feature.",
|
" public/release-manifest.json (the dev server's manifest) now names the feature's contract package; commit it with the feature.",
|
||||||
" The registry baseline does not change: new routes, operations, schemas and invalidation topics are additive.",
|
" The registry baseline does not change: new routes, operations, schemas and invalidation topics are additive.",
|
||||||
|
|||||||
Reference in New Issue
Block a user