From 8acf07c2f6f1e1b9549986f85bf4682a4c05b88b Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Thu, 12 Nov 2026 07:04:36 +0900 Subject: [PATCH] =?UTF-8?q?docs(adr):=20VD-09=C2=B711=C2=B713=EC=9D=84=20?= =?UTF-8?q?=EC=B1=84=ED=83=9D(=EB=B3=B4=EC=99=84)=EC=9C=BC=EB=A1=9C=20?= =?UTF-8?q?=EC=98=AC=EB=A6=AC=EA=B3=A0=20=EB=B3=B4=EC=99=84=20=EC=A0=88?= =?UTF-8?q?=EC=9D=84=20=EB=8B=A8=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 문제: 세 결정 기록은 결정한 뒤 본문을 제자리에서 고쳤지만 본문에 날짜가 붙은 보완 메모가 없어, 2026-11-08 머리 블록을 달 때 기계 규칙대로 「채택」이 됐다. 머리 블록은 본문이 결정한 때의 원문이라고 말하지만 실제로는 고친 뒤의 내용이다. 고른 방법: git 이력에서 결정 뒤 본문을 바꾼 커밋을 찾아 상태를 「채택(보완)」으로 올리고, 맨 아래 「보완」 절에 날짜·커밋·바뀐 절을 적는다(docs/README.md 2절). 본문은 고치지 않는다. 처음 커밋한 본문을 보는 git show 명령도 적는다. - VD-09: 2026-07-30 6c52cdb9(스크립트 경로 .mjs→.ts), 2026-08-02 92e5cace(결정 6~11번, 도식, 검증, Rollback) - VD-11: 2026-09-18 ec7f20e2(case 수 고정 문단을 규칙으로 바꿈) - VD-13: 2026-11-06 02a761f0(Web Storage key 이름을 정본 가리키기로) 6f6c48eb(2026-09-24)는 이력을 다시 시작한 커밋이라 세 본문 모두 그 앞 커밋과 내용이 같다. 그래서 보완에 넣지 않았다. 위험: 둘째 줄 「본문은 결정한 때의 원문이다」는 검사기가 고정한 문구라 그대로다. 보완 절의 첫 인용 블록이 실제 사정을 적는다. 검증: 각 커밋의 diff를 git diff <앞>:<경로> <뒤>:<경로>로 읽었다. 인용한 커밋 다섯 개가 모두 main의 조상이다. 문서 검사는 desktop에서 돌린다. --- docs/adr/VD-09-supply-chain-evidence.md | 9 ++++++++- docs/adr/VD-11-browser-file-and-origin-storage.md | 8 +++++++- docs/adr/VD-13-client-cache-scope-and-persistence.md | 8 +++++++- 3 files changed, 22 insertions(+), 3 deletions(-) diff --git a/docs/adr/VD-09-supply-chain-evidence.md b/docs/adr/VD-09-supply-chain-evidence.md index 795b38d7..3c5d03fd 100644 --- a/docs/adr/VD-09-supply-chain-evidence.md +++ b/docs/adr/VD-09-supply-chain-evidence.md @@ -1,7 +1,7 @@ > **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다. -- 상태: 채택 +- 상태: 채택(보완) - 작성일: 2026-07-26 - 요약: lockfile 전체에서 의존성 목록·라이선스·SBOM·출처 증명을 만들고, 외부 취약점 보고와 서명된 증거가 없으면 승격(promotion)을 실패로 둔다는 결정이다. - 현재 정본: `docs/security/supply-chain.md` @@ -120,3 +120,10 @@ attestation transparency/retention과 비밀 관리를 결정해야 한다. `FAIL_UNVERIFIED`로 돌아간다. local inventory, lock integrity, license, SBOM, secret, reproducibility와 actual diff gate는 유지한다. scanner 장애를 이유로 promotion을 PASS로 변경하지 않는다. + +## 보완 + +> 머리 블록은 2026-11-08에, 이 절은 2026-11-12에 더했다. 아래 고침은 기록 규칙(2026-11-08)이 생기기 전에 본문을 제자리에서 고친 것이다. 그래서 위 본문은 결정한 때의 원문이 아니라 마지막 고침 뒤의 내용이다. 처음 커밋한 본문은 `git show 8b4f875c:docs/architecture/decisions/VD-09-supply-chain-evidence.md`로 본다. + +- 2026-07-30 (`6c52cdb9`): 「실행 경계와 증적」 절의 generator·coherence·secret scan·reproducibility 스크립트 경로를 `.mjs`에서 `.ts`로 바꿨다. +- 2026-08-02 (`92e5cace`): 결정 6~11번, 「실행 경계와 증적」 도식, 「검증」 절, 「Rollback」 절을 고쳤다. 외부 provider 입력을 `immutable_build` archive 하나와 provider job 둘, Ed25519 서명 검증으로 바꿨고, 결정 항목이 10개에서 11개가 됐다. diff --git a/docs/adr/VD-11-browser-file-and-origin-storage.md b/docs/adr/VD-11-browser-file-and-origin-storage.md index 59ce1c29..a1c54bde 100644 --- a/docs/adr/VD-11-browser-file-and-origin-storage.md +++ b/docs/adr/VD-11-browser-file-and-origin-storage.md @@ -1,7 +1,7 @@ > **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다. -- 상태: 채택 +- 상태: 채택(보완) - 작성일: 2026-07-27 - 요약: File·Blob·파일 선택기·IndexedDB·OPFS·Cache Storage를 기존 `StoragePort`와 섞지 않는 별도 경계로 두고, reference runtime은 제품에 조립하지 않은 채 둔다는 결정이다. - 현재 정본: `src/adapters/browser-files/`, `src/adapters/storage/`, `config/recipes/frontend-capability-recipes.json` @@ -277,3 +277,9 @@ test, build와 optional catalog가 유지되는지 검증한다. schema downgrade, blanket `deleteDatabase()`, `caches.keys()` 전체 삭제와 사용자 filename 기반 OPFS 삭제는 rollback 수단으로 금지한다. + +## 보완 + +> 머리 블록은 2026-11-08에, 이 절은 2026-11-12에 더했다. 아래 고침은 기록 규칙(2026-11-08)이 생기기 전에 본문을 제자리에서 고친 것이다. 그래서 위 본문은 결정한 때의 원문이 아니라 마지막 고침 뒤의 내용이다. 처음 커밋한 본문은 `git show 6c52cdb9:docs/architecture/decisions/VD-11-browser-file-and-origin-storage.md`로 본다. + +- 2026-09-18 (`ec7f20e2`): 「계약과 증적」 절 끝의 문단 하나를 두 문단으로 바꿨다. engine마다 14개, 모두 42개라는 browser source suite case 수와 WebKit native library 부재 서술을 지우고, `verify:browser-capability-evidence`가 Chromium artifact에서 기준 testcase 묶음을 잡고 Firefox·WebKit이 같은 묶음을 실패 없이 돌렸는지 검사한다는 규칙과, engine별 capability 차이를 skip 이유로 쓰지 않는다는 규칙을 넣었다. diff --git a/docs/adr/VD-13-client-cache-scope-and-persistence.md b/docs/adr/VD-13-client-cache-scope-and-persistence.md index 81fa7731..e627a2d6 100644 --- a/docs/adr/VD-13-client-cache-scope-and-persistence.md +++ b/docs/adr/VD-13-client-cache-scope-and-persistence.md @@ -1,7 +1,7 @@ > **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다. -- 상태: 채택 +- 상태: 채택(보완) - 작성일: 2026-07-28 - 요약: server state cache, Web Storage, IndexedDB 영속화, 탭 간 무효화를 한 추상으로 합치지 않고 scope와 영속화 경계를 따로 정한다는 결정이다. - 현재 정본: `src/adapters/query-cache/`, `src/adapters/cross-context-invalidation/`, `src/contracts/storage-keys.ts` @@ -889,3 +889,9 @@ source, deterministic test, native evidence와 composition inventory로 증명 이 비용은 cache hit, durable restore, cross-tab hint와 server truth를 하나의 “cached” 상태로 잘못 합치지 않기 위한 의도적인 비용이다. + +## 보완 + +> 머리 블록은 2026-11-08에, 이 절은 2026-11-12에 더했다. 아래 고침은 기록 규칙(2026-11-08)이 생기기 전에 본문을 제자리에서 고친 것이다. 그래서 위 본문은 결정한 때의 원문이 아니라 마지막 고침 뒤의 내용이다. 처음 커밋한 본문은 `git show 6c52cdb9:docs/architecture/decisions/VD-13-client-cache-scope-and-persistence.md`로 본다. + +- 2026-11-06 (`02a761f0`): 2절 상태 표의 registered Web Storage 행과 7절 한도 표 아래 문단에서 `COLOR_SCHEME`·`CHUNK_RELOAD_GUARD` 두 key 이름을 지우고, 행 목록의 정본이 `src/contracts/storage-keys.ts`의 `STORAGE_REGISTRY`라고 가리키게 했다.