From 98b968224180f68f04880fe8d2ca81f11882eb40 Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Sun, 1 Nov 2026 22:11:06 +0900 Subject: [PATCH] =?UTF-8?q?chore(scripts):=20=EC=93=B0=EC=A7=80=20?= =?UTF-8?q?=EC=95=8A=EB=8A=94=20npm=20script=204=EA=B0=9C=EB=A5=BC=20?= =?UTF-8?q?=EC=A7=80=EC=9A=B0=EA=B3=A0=20scan:=EB=8F=84=20=EA=B2=8C?= =?UTF-8?q?=EC=9D=B4=ED=8A=B8=20=EA=B2=80=EC=82=AC=ED=95=9C=EB=8B=A4=20(12?= =?UTF-8?q?-05)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 문제 package.json에 어디서도 부르지 않는 script 4개가 있다. - scan:security:fixture: FE-GATE-013은 이것 대신 check:security:fixtures를 돈다. supply-chain.test.ts는 "게이트에 없어야 한다"고 단언하는데 script는 남아 있다. 게이트 밖 script 검사는 check|verify|test|drill|review만 봐서 scan:을 놓쳤다. - build:profile: 이름과 달리 generate-runtime-config.ts만 돈다. - generate:contract-set: 참조 0건. - build:app-only: vite build와 매니페스트만 만든다. build-frontend.ts의 계약 세트·런타임 설정·Service Worker 단계가 빠진 dist가 나온다. 참조는 product-index-entrypoints 테스트의 진입점 목록 하나다. 참조 확인(새 기준 298201f, docs/reviews 제외): package.json 정의와 위 두 테스트 말고는 config/ci/gates.json, 생성 workflow, scripts, docs 어디에도 없다. 아래 세 script가 부르던 파일(generate-runtime-config.ts, generate-contract-set.ts, generate-build-manifest.ts)은 build-frontend.ts가 그대로 부른다. 고른 방법 - 네 script를 지우고 진입점 목록에서 build:app-only를 뺀다. - VERIFICATION_SCRIPT에 scan을 더한다. 게이트가 닿지 않는 scan:* script는 ungated-scripts.json 항목 없이는 check:ci에서 실패한다. 지금 남은 scan:security는 build:release-candidate를 거쳐 게이트가 닿는다. - docs/operations/ci-quality-gates.md의 접두어 목록에 scan:*을 더한다. 버린 대안 - build:app-only를 build:vite-only로 이름만 바꾸기: 남길 사용처를 찾지 못했다. - 접두어 대신 "게이트 밖 모든 script는 예외 목록에": dev·storybook· update:*까지 목록에 올라가 목록이 커진다(리뷰 대안 비교와 같다). - check:feature-index 정리(리뷰 개선 (4)): 지우기와 이유 문구 고치기 중 하나를 고르는 일이라 이번에 하지 않았다. 위험·한계 - 개인 습관으로 이 script를 쓰던 사람은 build-frontend.ts나 node scripts/...를 직접 불러야 한다. - 게이트 명령은 바뀌지 않아 CI 계약 기준선은 그대로다. 검증 - RED: 새 테스트 "rejects a scan script that no gate reaches"가 실패 (expected [ …(2) ] to deep equally contain '…: scan:orphan'). 정규식만 넓히면 저장소 검사 "reaches every verification script …"가 scan:security:fixture 한 건으로 실패. - GREEN: ungated-scripts·product-index-entrypoints·supply-chain· ci-workflow-generation 4파일 457/457 통과. check:ci의 세 단계를 pnpm 없이 직접 실행: generate-artifact-schemas --check PASS, check-ci-contract.ts PASS(27 gates), generate-ci-workflow --check PASS. tsc(tsconfig.node, tsconfig.test), 바꾼 파일 eslint 통과. Refs: docs/reviews/2026-11-01-maturity-review/12-guardrails-ci.md 12-05 --- docs/operations/ci-quality-gates.md | 2 +- package.json | 4 ---- scripts/lib/ungated-scripts.ts | 2 +- tests/unit/product-index-entrypoints.test.ts | 1 - tests/unit/ungated-scripts.test.ts | 14 ++++++++++++++ 5 files changed, 16 insertions(+), 7 deletions(-) diff --git a/docs/operations/ci-quality-gates.md b/docs/operations/ci-quality-gates.md index 24b9231a..1634e3af 100644 --- a/docs/operations/ci-quality-gates.md +++ b/docs/operations/ci-quality-gates.md @@ -40,7 +40,7 @@ Playwright 설정의 `testDir`를 모아 비교한다(`scripts/lib/ungated-tests 한다. 게이트가 이미 돌리는 파일을 이 목록에 남겨 두면 실패한다. package script도 같은 방식으로 확인한다(`scripts/lib/ungated-scripts.ts`). -`check:*`·`verify:*`·`test:*`·`drill:*`·`review:*` 스크립트는 게이트 명령에서 +`check:*`·`verify:*`·`test:*`·`drill:*`·`review:*`·`scan:*` 스크립트는 게이트 명령에서 package script 그래프로 닿거나, 게이트가 이미 돌리는 Vitest 경로만 다시 돌려야 한다. 둘 다 아니면 `config/ci/ungated-scripts.json`에 이유와 함께 적는다. 게이트가 닿는 스크립트를 이 목록에 남겨 두면 실패한다. 두 목록에 남은 항목과 이유는 각 diff --git a/package.json b/package.json index 91ee6cd2..4ee15624 100644 --- a/package.json +++ b/package.json @@ -11,7 +11,6 @@ "scripts": { "dev": "node scripts/generate-product-feature-index.ts && vite", "build": "node scripts/generate-product-feature-index.ts && node scripts/build-frontend.ts", - "build:profile": "node scripts/generate-runtime-config.ts", "build:release-candidate": "node scripts/generate-product-feature-index.ts && corepack pnpm build && corepack pnpm generate:supply-chain && corepack pnpm scan:security && corepack pnpm verify:release && node scripts/verify-supply-chain-artifacts.ts && node scripts/create-release-candidate.ts", "preview": "vite preview", "lint": "eslint src scripts tests recipes .storybook vite.config.ts vitest.config.ts playwright*.config.ts --max-warnings=0", @@ -93,7 +92,6 @@ "check:supply-chain:provider-fixtures": "node scripts/generate-product-feature-index.ts && node scripts/check-supply-chain-provider-fixtures.ts", "verify:reproducible-build": "node scripts/generate-product-feature-index.ts && node scripts/verify-reproducible-build.ts", "scan:security": "node scripts/security-scan.ts", - "scan:security:fixture": "node scripts/security-scan.ts --policy tests/fixtures/security/secret-detection/forbidden-policy.json --artifact artifacts/security/scan-fixture.sarif", "check:security:fixtures": "node scripts/check-security-fixtures.ts", "check:browser-security": "node scripts/check-browser-security.ts", "check:browser-file-storage-boundaries": "node scripts/check-browser-file-storage-boundaries.ts", @@ -122,8 +120,6 @@ "check:ci": "corepack pnpm check:artifact-schemas && node scripts/check-ci-contract.ts && corepack pnpm check:ci-workflow", "update:ci-contract-baseline": "node scripts/update-ci-contract-baseline.ts", "verify:documentation": "node scripts/generate-product-feature-index.ts && node scripts/verify-documentation-readiness.ts", - "build:app-only": "node scripts/generate-product-feature-index.ts && vite build && node scripts/generate-build-manifest.ts", - "generate:contract-set": "node scripts/generate-product-feature-index.ts && node scripts/generate-contract-set.ts", "check:types:web-worker": "tsc --project tsconfig.web-worker.json", "check:types:service-worker": "tsc --project tsconfig.service-worker.json", "check:types:fixture:http-operation-input": "tsc -p tests/fixtures/typecheck/tsconfig.http-operation-input.json", diff --git a/scripts/lib/ungated-scripts.ts b/scripts/lib/ungated-scripts.ts index b774ee8b..a1ee238c 100644 --- a/scripts/lib/ungated-scripts.ts +++ b/scripts/lib/ungated-scripts.ts @@ -12,7 +12,7 @@ import { reachablePackageScripts } from "./package-script-graph.ts"; */ export const UNGATED_SCRIPTS_PATH = "config/ci/ungated-scripts.json"; -const VERIFICATION_SCRIPT = /^(?:check|verify|test|drill|review):/u; +const VERIFICATION_SCRIPT = /^(?:check|verify|test|drill|review|scan):/u; const ungatedScriptsSchema = z .object({ diff --git a/tests/unit/product-index-entrypoints.test.ts b/tests/unit/product-index-entrypoints.test.ts index 85d7b97c..dea64a61 100644 --- a/tests/unit/product-index-entrypoints.test.ts +++ b/tests/unit/product-index-entrypoints.test.ts @@ -9,7 +9,6 @@ const GENERATE = "node scripts/generate-product-feature-index.ts && "; // Entry points the import walk below cannot see (tsc, vite, storybook). const NON_NODE_ENTRY_SCRIPTS = [ "dev", - "build:app-only", "storybook", "build:storybook", "check:types:app", diff --git a/tests/unit/ungated-scripts.test.ts b/tests/unit/ungated-scripts.test.ts index ea917d96..2ac5cfef 100644 --- a/tests/unit/ungated-scripts.test.ts +++ b/tests/unit/ungated-scripts.test.ts @@ -71,6 +71,20 @@ describe("ungated verification scripts", () => { ]); }); + // 12-05: scan:security:fixture stayed in package.json after FE-GATE-013 + // replaced it with check:security:fixtures, because scan: was not a + // verification family. + it("rejects a scan script that no gate reaches", () => { + expect( + ungatedScriptFailures({ + ...fixture, + scripts: { ...fixture.scripts, "scan:orphan": "node scripts/scan.ts" }, + }), + ).toContainEqual( + `verification script is not reached by any CI gate command and is not in ${UNGATED_SCRIPTS_PATH}: scan:orphan`, + ); + }); + it("counts a Vitest subset as gated only when a gate runs every path", () => { const failures = ungatedScriptFailures(fixture); expect(failures.join("\n")).not.toContain("check:subset");