docs(adr): VD-09·11·13을 채택(보완)으로 올리고 보완 절을 단다
문제: 세 결정 기록은 결정한 뒤 본문을 제자리에서 고쳤지만 본문에 날짜가 붙은 보완 메모가 없어, 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에서 돌린다.
This commit is contained in:
@@ -1,7 +1,7 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 상태: 채택(보완)
|
||||
- 작성일: 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개가 됐다.
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 상태: 채택(보완)
|
||||
- 작성일: 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 이유로 쓰지 않는다는 규칙을 넣었다.
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
|
||||
> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다.
|
||||
|
||||
- 상태: 채택
|
||||
- 상태: 채택(보완)
|
||||
- 작성일: 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`라고 가리키게 했다.
|
||||
|
||||
Reference in New Issue
Block a user