docs: 살아 있는 문서의 낡은 문장을 지금 코드와 정본에 맞춘다
2026-11-07~08의 정리(문서 이동, 참조 기능 삭제, CI 재편) 뒤 살아 있는 문서가 지금 코드와 다른 말을 한다. - 현재 계약 문서 둘과 스타터 문서가 기록(docs/design/)을 정본으로 가리킨다. 정본을 frontend-application-foundation.md·src/bootstrap/, 패턴 표·계층 규칙으로 바꾸고 설계서는 배경으로 둔다(1112/02-06). - 실시간 대응표 둘(짝 백엔드 출구, poll attempt 결과)이 기록에만 있었다. optional-adapter-recipes.md로 옮기고 코드 주석·매뉴얼 03·설계서 머리 블록이 옮긴 곳을 가리킨다(1112/09-02). - 실행 격리 변수 목록을 설계 기록이 아니라 scripts/lib/run-isolation.ts로 가리킨다(1112/08-17). - 계약 소유 절 이름(「판단 규칙」), pin 대조 시험의 게이트(005·007), drift 검사 범위(1112/02-07). INVENTORY 머리의 손 숫자와 지킬 수 없는 꼬리 문장(1112/02-08). - 검증 안내: 검사기를 바꾸면 FE-GATE-029, 문서면 desktop verify:documentation(1112/08-05, 08-04). FE-GATE-012는 merge 단계다 (08-16). N6이 알리는 파일을 좁혀 적는다(08-10). 한 파일 시험은 verify.sh exec(08-11). 문서 검사 범위의 손 사본을 정본 한 곳으로(08-07). - create:feature 참조의 Next: 3과 되돌리기(08-08), 손으로 옮긴 숫자 (08-19), 라운드 없는 리뷰 ID 17곳에 0925를 붙인다(08-15). - secret scan 범위 설명(1112/07-03), lab이 기능 라우트를 읽는 문장 (1103/16-06), README 동기화 기준점·제품 소유 파일·선택 기능 결함 몫 (0929/14-02, 14-03, 13-10), 커밋을 다시 지은 모든 통합의 해시 대조 (1106/14-02). 고른 방법: 문장을 코드에 맞춘다. 표는 옮기고 숫자는 정본을 가리킨다. 버린 대안: 기록 문서 본문 고치기(기록은 머리 블록만 고친다). 위험·한계: 문서 검사 범위 목록을 지운 ci-quality-gates.md는 이제 docs/README.md 5절과 gates.md 7절을 읽어야 한다. 매뉴얼 02 7절 업로드 예의 declare module 문제(1112/09-01)는 고치는 방향이 check:architecture 규칙과 부딪쳐 결정 대기로 남긴다. 검증: scripts/verify.sh docs(노트북) 통과. desktop verify:documentation과 FE-GATE-005(문서를 읽는 시험)는 PR 본문에 적는다. Refs: 1112/02-06, 1112/02-07, 1112/02-08, 1112/07-03, 1112/08-04, 1112/08-05, 1112/08-07, 1112/08-08, 1112/08-10, 1112/08-11, 1112/08-15, 1112/08-16, 1112/08-17, 1112/08-19, 1112/09-02, 1103/16-06, 0929/14-02, 0929/14-03, 0929/13-10, 1106/14-02
This commit is contained in:
@@ -9,7 +9,7 @@ production source map.
|
||||
뺀다. production 코드와 빌드된 asset은 이 기준선에서도 동작해야 한다.
|
||||
`tests/e2e/production-csp.spec.ts`(`test:e2e`의 일부, FE-GATE-008)는 이 header로
|
||||
빌드를 서빙한다. 그리고 `securitypolicyviolation` 이벤트나 console 오류가 나면
|
||||
실패한다(리뷰 13-08). zod는 첫 object schema에서 `Function("")`을 시험 삼아
|
||||
실패한다(리뷰 0925/13-08). zod는 첫 object schema에서 `Function("")`을 시험 삼아
|
||||
실행한다. 그러면 정책이 부트할 때마다 이것을 위반으로 보고한다.
|
||||
`src/contracts/zod.ts`는 `jitless`를 켜서 이 시험을 건너뛴다. schema를 만드는
|
||||
모든 모듈은 `z`를 그 파일에서 import한다. 그래서 bundler가 chunk를 어떤 순서로
|
||||
|
||||
@@ -21,8 +21,9 @@
|
||||
- 새 직접 production 의존성에 대한 독립 리뷰
|
||||
- CycloneDX 1.6 SBOM, 그리고 inventory와의 component·edge 일치
|
||||
- source·lock·SBOM·dist를 묶은 local provenance 문서(statement)
|
||||
- secret scan. 대상은 source, 선택해서 켜는(opt-in) recipe, script, 테스트,
|
||||
추적되는 config/schema, public 폴더, 빌드된 asset, 생성된 release metadata다
|
||||
- secret scan. 대상은 추적되는 파일 전부(`git ls-files`, 문서와 `.env.example` 포함)와
|
||||
빌드된 `dist`, 생성된 `artifacts/release`다(`scripts/lib/repository-file-inventory.ts`).
|
||||
정책의 `trackedRoots`는 대상을 좁히지 않는다. 비어 있으면 안 되는 루트 목록이다
|
||||
- 두 번 빌드해 비교하는 `SOURCE_DATE_EPOCH` 재현성 검사
|
||||
|
||||
기준 명령은 다음과 같다.
|
||||
@@ -41,7 +42,7 @@ corepack pnpm check:supply-chain:fixtures
|
||||
|
||||
## 무엇을 증명하고 무엇을 증명하지 않는가
|
||||
|
||||
리뷰 13-12. 산출물마다 증명 범위가 다르다. 아래 "증명하지 못하는 것"을 증명된
|
||||
리뷰 0925/13-12. 산출물마다 증명 범위가 다르다. 아래 "증명하지 못하는 것"을 증명된
|
||||
것으로 읽지 않는다.
|
||||
|
||||
| 산출물 | 증명하는 것 | 증명하지 못하는 것 |
|
||||
@@ -64,7 +65,7 @@ corepack pnpm check:supply-chain:fixtures
|
||||
|
||||
## 최소 구성과 전체 구성
|
||||
|
||||
리뷰 13-13. 승격 단계까지 쓰려면 이 문서 아래의 runner 조건(bwrap, prlimit,
|
||||
리뷰 0925/13-13. 승격 단계까지 쓰려면 이 문서 아래의 runner 조건(bwrap, prlimit,
|
||||
systemd-run, systemd user manager 254 이상, cgroup v2 위임)과 오프라인 데이터로
|
||||
Ed25519 서명 보고서를 내는 provider 두 개가 필요하다. 이 repo는 그 환경에서
|
||||
workflow 전체를 한 번도 돌리지 않았다. 그래서 두 구성을 나눠 적는다.
|
||||
|
||||
Reference in New Issue
Block a user