From 75fad73a7daecd891118b2a7fba9a272ae480c81 Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Sun, 8 Nov 2026 17:13:33 +0900 Subject: [PATCH] =?UTF-8?q?docs(records):=20=EA=B8=B0=EB=A1=9D=C2=B7?= =?UTF-8?q?=EC=84=A4=EA=B3=84=EC=84=9C=C2=B7=EA=B2=B0=EC=A0=95=20=EA=B8=B0?= =?UTF-8?q?=EB=A1=9D=2067=EA=B0=9C=EC=97=90=20=ED=95=9C=EA=B5=AD=EC=96=B4?= =?UTF-8?q?=20=EB=A8=B8=EB=A6=AC=20=EB=B8=94=EB=A1=9D=EC=9D=84=20=EB=8B=A8?= =?UTF-8?q?=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 문제: 옮긴 기록은 지금 동작을 설명하는지, 상태가 무엇인지, 지금 정본이 어디인지 알 길이 없다. 설계서·계획서 27개와 docs/architecture 목표 설계 16개에는 상태 칸이 없고, VD는 「상태: Accepted」 같은 영어 값을 쓴다. 고른 방법: docs-system.md 4절 형식으로 맨 위에 머리 블록을 달고 본문은 한 글자도 고치지 않는다. 상태는 기계 변환이다. - 설계서: Accepted·확정·정본·설계 완료 → 채택, 상태 줄이 없으면 확인 안 함 (채택 4, 확인 안 함 21) - 계획서: 체크 상자가 모두 표시됐으면 끝남, 아니면 확인 안 함. SPEC.md는 같은 폴더 plan.md와 같은 근거(0.2.0으로 끝난 라운드)로 끝남 (끝남 5, 확인 안 함 14. 이미 블록이 있던 5개는 그대로) - 결정 기록: Accepted → 채택, 날짜가 붙은 뒤늦은 보완 메모가 본문에 있으면 채택(보완) (채택 14, 채택(보완) 9). 프론트 VD는 처음부터 한국어로 썼고 번역하지 않으므로 둘째 줄은 「원문이다」 문구다. - 작성일: 파일 이름 날짜 → 본문 날짜 줄(VD는 `결정일:`) → git 첫 추가일. 위험: VD-09·11·13은 git으로 보면 결정 뒤 본문이 그 자리에서 고쳐졌지만 본문에 날짜 표시가 없어 기계 규칙대로 채택으로 두었다. 보완으로 올릴지는 사람이 정한다. 「현재 정본」은 지금 있는 살아 있는 문서나 코드 경로만 쓴다. 검증: 블록과 그 뒤 빈 줄 하나를 빼면 72개 모두 `git show HEAD:`와 바이트가 같다. 뒤 커밋의 문서 검사 head 규칙으로 돌려 문제 0건. --- docs/adr/VD-01-typescript-lint-tooling.md | 9 +++++++++ docs/adr/VD-03-react-router-data-mode.md | 9 +++++++++ docs/adr/VD-04-native-form-facade.md | 9 +++++++++ docs/adr/VD-05-icon-and-headless-ui.md | 9 +++++++++ docs/adr/VD-06-intl-typed-message-catalog.md | 9 +++++++++ docs/adr/VD-07-diagnostics-and-telemetry-exporter.md | 9 +++++++++ docs/adr/VD-08-storybook-and-visual-evidence.md | 9 +++++++++ docs/adr/VD-09-supply-chain-evidence.md | 9 +++++++++ docs/adr/VD-10-optional-capability-recipes.md | 9 +++++++++ docs/adr/VD-11-browser-file-and-origin-storage.md | 9 +++++++++ docs/adr/VD-12-presigned-transfer-and-image-cdn.md | 9 +++++++++ docs/adr/VD-13-client-cache-scope-and-persistence.md | 9 +++++++++ .../VD-14-resumable-download-and-background-transfer.md | 9 +++++++++ docs/adr/VD-15-origin-storage-lifecycle-and-migration.md | 9 +++++++++ ...16-browser-transfer-composition-and-image-delivery.md | 9 +++++++++ .../VD-23-api-transport-selection-and-rest-execution.md | 9 +++++++++ docs/adr/VD-24-runtime-schema-and-boundary-mapper.md | 9 +++++++++ docs/adr/VD-25-server-state-cache-lifecycle.md | 9 +++++++++ docs/adr/VD-26-persisted-graphql-operation.md | 9 +++++++++ docs/adr/VD-27-grpc-web-unary-and-server-stream.md | 9 +++++++++ ...VD-28-realtime-events-web-push-and-bounded-polling.md | 9 +++++++++ .../VD-29-connect-web-and-browser-protobuf-runtime.md | 9 +++++++++ docs/adr/VD-30-protobuf-contract-and-rest-gateway.md | 9 +++++++++ docs/design/2026-07-26-design-system-platform-design.md | 9 +++++++++ ...6-07-26-frontend-platform-capability-review-design.md | 9 +++++++++ ...26-frontend-platform-implementation-roadmap-design.md | 9 +++++++++ ...26-07-26-frontend-platform-testing-strategy-design.md | 9 +++++++++ ...7-26-frontend-ports-adapters-and-boundaries-design.md | 9 +++++++++ .../2026-07-26-routing-pages-and-patterns-design.md | 9 +++++++++ .../2026-07-26-typescript-state-and-data-flow-design.md | 9 +++++++++ .../2026-07-27-browser-file-and-origin-storage-design.md | 9 +++++++++ ...api-contract-schema-mapper-and-server-state-design.md | 9 +++++++++ .../design/2026-07-28-client-cache-and-storage-design.md | 9 +++++++++ ...protobuf-browser-transport-and-rest-gateway-design.md | 9 +++++++++ ...07-28-server-file-capability-infrastructure-design.md | 9 +++++++++ ...0-browser-data-capability-completion-ledger-design.md | 9 +++++++++ ...pository-aligned-implementation-closed-deep-design.md | 9 +++++++++ ...2026-07-30-presigned-transfer-and-image-cdn-design.md | 9 +++++++++ ...ealtime-events-web-push-and-bounded-polling-design.md | 9 +++++++++ docs/design/2026-07-31-platform-overview-page-design.md | 9 +++++++++ .../2026-08-01-refactoring-review-remediation-design.md | 9 +++++++++ .../2026-08-01-runtime-integrity-refactor-design.md | 9 +++++++++ ...-platform-owned-frontend-assurance-delivery-design.md | 9 +++++++++ docs/design/2026-08-02-provider-raw-guardian-design.md | 9 +++++++++ .../2026-08-02-v8-coverage-counter-contract-design.md | 9 +++++++++ docs/design/2026-09-16-adapter-barrel-boundary-design.md | 9 +++++++++ .../2026-09-16-indexeddb-kernel-promotion-design.md | 9 +++++++++ ...6-09-20-memento-frontend-template-bootstrap-design.md | 9 +++++++++ .../plans/2026-07-31-platform-overview-completion.md | 9 +++++++++ .../plans/2026-08-01-http-worker-adapter-remediation.md | 9 +++++++++ .../plans/2026-08-01-quality-architecture-remediation.md | 9 +++++++++ docs/history/plans/2026-08-01-release-boot-integrity.md | 9 +++++++++ .../plans/2026-08-01-release-evidence-remediation.md | 9 +++++++++ .../plans/2026-08-01-runtime-correctness-remediation.md | 9 +++++++++ .../history/plans/2026-08-01-scope-owned-server-state.md | 9 +++++++++ .../plans/2026-08-02-cicd-frontend-assurance-delivery.md | 9 +++++++++ .../2026-08-02-counter-bearing-coverage-provenance.md | 9 +++++++++ .../2026-08-02-frontend-platform-consumer-migration.md | 9 +++++++++ .../plans/2026-08-02-promotion-security-review-fixes.md | 9 +++++++++ docs/history/plans/2026-08-02-provider-raw-guardian.md | 9 +++++++++ docs/history/plans/2026-08-02-security-finalizer.md | 9 +++++++++ .../2026-08-02-test-assurance-frontend-capabilities.md | 9 +++++++++ .../plans/2026-08-02-v8-coverage-counter-contract.md | 9 +++++++++ docs/history/plans/2026-08-13-adapter-remediation.md | 9 +++++++++ docs/history/plans/2026-09-16-adapter-barrel-boundary.md | 9 +++++++++ .../plans/2026-09-16-indexeddb-kernel-promotion.md | 9 +++++++++ docs/history/plans/2026-09-25-review-fix-round/SPEC.md | 9 +++++++++ 67 files changed, 603 insertions(+) diff --git a/docs/adr/VD-01-typescript-lint-tooling.md b/docs/adr/VD-01-typescript-lint-tooling.md index 0da66728..3f2b0c74 100644 --- a/docs/adr/VD-01-typescript-lint-tooling.md +++ b/docs/adr/VD-01-typescript-lint-tooling.md @@ -1,3 +1,12 @@ + +> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택(보완) +- 작성일: 2026-07-26 +- 요약: TypeScript 7과 ESLint 10으로 옮길 때 컴파일러와 운영 소스를 한꺼번에 바꾸지 않고 JS·TS 파일이 같은 품질 게이트를 통과하게 하는 도구 구성을 정한 결정이다. +- 현재 정본: `eslint.config.ts`, `tsconfig.json`, `scripts/check-architecture.ts` + + # VD-01: TypeScript 7과 ESLint 10의 점진적 전환 도구 - 상태: Accepted diff --git a/docs/adr/VD-03-react-router-data-mode.md b/docs/adr/VD-03-react-router-data-mode.md index a562a0f5..aff4251f 100644 --- a/docs/adr/VD-03-react-router-data-mode.md +++ b/docs/adr/VD-03-react-router-data-mode.md @@ -1,3 +1,12 @@ + +> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-07-26 +- 요약: 라우터를 React Router Data Mode로 바꾸고 실행 route는 registry에서 만들며 서버 상태는 계속 application input과 TanStack Query가 소유한다는 결정이다. +- 현재 정본: `src/presentation/routes/`, `src/contracts/routes.ts` + + # VD-03: React Router Data Mode와 서버 상태 소유권 - 상태: Accepted diff --git a/docs/adr/VD-04-native-form-facade.md b/docs/adr/VD-04-native-form-facade.md index a27fa86e..859500a4 100644 --- a/docs/adr/VD-04-native-form-facade.md +++ b/docs/adr/VD-04-native-form-facade.md @@ -1,3 +1,12 @@ + +> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택(보완) +- 작성일: 2026-07-26 +- 요약: 폼은 외부 폼 라이브러리 대신 native form 이벤트를 쓰는 local `useAppForm` facade로 처리하고 검증 오류·충돌·저장 실패를 구분해 보여 준다는 결정이다. +- 현재 정본: `src/presentation/forms/`, `src/presentation/templates/` + + # VD-04: Native form controller와 local facade - 상태: Accepted diff --git a/docs/adr/VD-05-icon-and-headless-ui.md b/docs/adr/VD-05-icon-and-headless-ui.md index 46dc2499..87e29630 100644 --- a/docs/adr/VD-05-icon-and-headless-ui.md +++ b/docs/adr/VD-05-icon-and-headless-ui.md @@ -1,3 +1,12 @@ + +> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택(보완) +- 작성일: 2026-07-26 +- 요약: 아이콘은 `lucide-react`를 한 파일 facade 뒤에 두고 의미 이름만 노출하며, 복합 control은 headless 라이브러리 없이 native 요소로 만든다는 결정이다. +- 현재 정본: `src/presentation/design-system/`, `docs/styling/design-tokens.md` + + # VD-05: Semantic icon facade와 native-first interaction - 상태: Accepted diff --git a/docs/adr/VD-06-intl-typed-message-catalog.md b/docs/adr/VD-06-intl-typed-message-catalog.md index 92d0c560..feb38178 100644 --- a/docs/adr/VD-06-intl-typed-message-catalog.md +++ b/docs/adr/VD-06-intl-typed-message-catalog.md @@ -1,3 +1,12 @@ + +> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택(보완) +- 작성일: 2026-07-26 +- 요약: 다국어 문구는 표준 Intl과 한국어 기준 typed local catalog로 처리하고 i18n 라이브러리는 기본으로 넣지 않는다는 결정이다. +- 현재 정본: `src/presentation/i18n/`, `scripts/check-i18n.ts` + + # VD-06: Intl과 typed local message catalog - 상태: Accepted diff --git a/docs/adr/VD-07-diagnostics-and-telemetry-exporter.md b/docs/adr/VD-07-diagnostics-and-telemetry-exporter.md index 8b09f220..50d84d5d 100644 --- a/docs/adr/VD-07-diagnostics-and-telemetry-exporter.md +++ b/docs/adr/VD-07-diagnostics-and-telemetry-exporter.md @@ -1,3 +1,12 @@ + +> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택(보완) +- 작성일: 2026-07-26 +- 요약: 운영 진단은 `DiagnosticsPort`, 의미 이벤트는 `TelemetryPort`로 나누고 닫힌 registry와 값 정책을 통과한 값만 보낸다는 결정이다. +- 현재 정본: `src/adapters/diagnostics/`, `src/adapters/telemetry/` + + # VD-07: Diagnostics와 telemetry exporter 경계 - 상태: Accepted diff --git a/docs/adr/VD-08-storybook-and-visual-evidence.md b/docs/adr/VD-08-storybook-and-visual-evidence.md index 4f8332bd..15c8f6e7 100644 --- a/docs/adr/VD-08-storybook-and-visual-evidence.md +++ b/docs/adr/VD-08-storybook-and-visual-evidence.md @@ -1,3 +1,12 @@ + +> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-07-26 +- 요약: Storybook은 개발용 정적 산출물로만 쓰고, 시각 회귀는 운영 build를 고정된 Chromium으로 찍은 스크린샷과 비교한다는 결정이다. +- 현재 정본: `.storybook/`, `docs/testing/taxonomy.md` + + # VD-08: 개발용 Storybook과 로컬 시각 회귀 증적 - 상태: Accepted diff --git a/docs/adr/VD-09-supply-chain-evidence.md b/docs/adr/VD-09-supply-chain-evidence.md index 128e118e..795b38d7 100644 --- a/docs/adr/VD-09-supply-chain-evidence.md +++ b/docs/adr/VD-09-supply-chain-evidence.md @@ -1,3 +1,12 @@ + +> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-07-26 +- 요약: lockfile 전체에서 의존성 목록·라이선스·SBOM·출처 증명을 만들고, 외부 취약점 보고와 서명된 증거가 없으면 승격(promotion)을 실패로 둔다는 결정이다. +- 현재 정본: `docs/security/supply-chain.md` + + # VD-09: 공급망 inventory, license, vulnerability, SBOM과 provenance - 상태: Accepted diff --git a/docs/adr/VD-10-optional-capability-recipes.md b/docs/adr/VD-10-optional-capability-recipes.md index 23faee37..3dd6adc0 100644 --- a/docs/adr/VD-10-optional-capability-recipes.md +++ b/docs/adr/VD-10-optional-capability-recipes.md @@ -1,3 +1,12 @@ + +> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택(보완) +- 작성일: 2026-07-26 +- 요약: realtime·offline·PWA 같은 선택 기능 12개를 recipe catalog로 두고, 실제 제품 요구가 생기기 전에는 설치하지 않는다는 결정이다. +- 현재 정본: `config/recipes/frontend-capability-recipes.json`, `docs/architecture/optional-adapter-recipes.md` + + # VD-10: 선택형 frontend capability recipe - 상태: Accepted 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 91e2c6f7..59ce1c29 100644 --- a/docs/adr/VD-11-browser-file-and-origin-storage.md +++ b/docs/adr/VD-11-browser-file-and-origin-storage.md @@ -1,3 +1,12 @@ + +> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 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` + + # VD-11: Browser file and origin-storage 경계 - 상태: Accepted — native reference runtime available, not composed diff --git a/docs/adr/VD-12-presigned-transfer-and-image-cdn.md b/docs/adr/VD-12-presigned-transfer-and-image-cdn.md index 51819e43..faf386be 100644 --- a/docs/adr/VD-12-presigned-transfer-and-image-cdn.md +++ b/docs/adr/VD-12-presigned-transfer-and-image-cdn.md @@ -1,3 +1,12 @@ + +> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-07-28 +- 요약: presigned 전송과 Image CDN에서 BFF 제어 경로와 저장소·CDN 데이터 경로를 나누고, 브라우저는 발급받은 정확한 capability만 쓴다는 결정이다. +- 현재 정본: `src/adapters/browser-transfer/`, `docs/operations/browser-transfer-recovery.md` + + # VD-12: Presigned transfer, resumable upload와 Image CDN 경계 - 상태: Accepted — reference runtime available, not composed 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 b7c79db4..81fa7731 100644 --- a/docs/adr/VD-13-client-cache-scope-and-persistence.md +++ b/docs/adr/VD-13-client-cache-scope-and-persistence.md @@ -1,3 +1,12 @@ + +> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-07-28 +- 요약: server state cache, Web Storage, IndexedDB 영속화, 탭 간 무효화를 한 추상으로 합치지 않고 scope와 영속화 경계를 따로 정한다는 결정이다. +- 현재 정본: `src/adapters/query-cache/`, `src/adapters/cross-context-invalidation/`, `src/contracts/storage-keys.ts` + + # VD-13: Client cache scope, persistence와 탭 간 일관성 경계 - 상태: Accepted — staged implementation required diff --git a/docs/adr/VD-14-resumable-download-and-background-transfer.md b/docs/adr/VD-14-resumable-download-and-background-transfer.md index 342c546f..12492591 100644 --- a/docs/adr/VD-14-resumable-download-and-background-transfer.md +++ b/docs/adr/VD-14-resumable-download-and-background-transfer.md @@ -1,3 +1,12 @@ + +> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-07-28 +- 요약: Range로 이어받는 다운로드와 백그라운드 다운로드를 일반 스트리밍 다운로드와 다른 capability로 두고, 재개 근거는 서버가 준 불변 세대와 강한 validator로 한다는 결정이다. +- 현재 정본: `config/recipes/frontend-capability-recipes.json`, `docs/operations/browser-transfer-recovery.md` + + # VD-14: Resumable download와 background download 경계 - 상태: Accepted — production design complete, implementation pending diff --git a/docs/adr/VD-15-origin-storage-lifecycle-and-migration.md b/docs/adr/VD-15-origin-storage-lifecycle-and-migration.md index 8439cbe3..a86d460e 100644 --- a/docs/adr/VD-15-origin-storage-lifecycle-and-migration.md +++ b/docs/adr/VD-15-origin-storage-lifecycle-and-migration.md @@ -1,3 +1,12 @@ + +> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-07-28 +- 요약: VD-11 reference runtime을 제품에 조립하기 전에 필요한 origin 저장소 수명 주기, migration, 선택형 파일 capability의 공통 계약을 정한 결정이다. +- 현재 정본: `src/adapters/storage/`, `src/adapters/platform/`, `docs/operations/browser-file-storage-recovery.md` + + # VD-15: Origin storage lifecycle, migration, and optional file capabilities - 상태: Accepted design — implementation pending diff --git a/docs/adr/VD-16-browser-transfer-composition-and-image-delivery.md b/docs/adr/VD-16-browser-transfer-composition-and-image-delivery.md index 1c72b4db..3e9b1acf 100644 --- a/docs/adr/VD-16-browser-transfer-composition-and-image-delivery.md +++ b/docs/adr/VD-16-browser-transfer-composition-and-image-delivery.md @@ -1,3 +1,12 @@ + +> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-07-28 +- 요약: 파일·전송·이미지 capability를 계정 범위의 단일 composition owner가 정해진 순서로 만들고 Image delivery를 그 위에 붙인다는 결정이다. +- 현재 정본: `src/adapters/browser-transfer/`, `config/recipes/frontend-capability-recipes.json` + + # VD-16: Browser transfer composition과 Image delivery - 상태: Accepted — design complete, implementation pending diff --git a/docs/adr/VD-23-api-transport-selection-and-rest-execution.md b/docs/adr/VD-23-api-transport-selection-and-rest-execution.md index d24ca9a7..0aa4ff06 100644 --- a/docs/adr/VD-23-api-transport-selection-and-rest-execution.md +++ b/docs/adr/VD-23-api-transport-selection-and-rest-execution.md @@ -1,3 +1,12 @@ + +> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택(보완) +- 작성일: 2026-07-28 +- 요약: API transport는 operation registry가 고르고 feature port는 protocol을 모르게 하며, REST 실행 경로를 정한 결정이다. +- 현재 정본: `src/adapters/http/`, `docs/architecture/backend-api-and-server-state-contract.md` + + # VD-23: API transport selection과 REST execution > **정본 안내 (non-authoritative for runtime capability decisions)** diff --git a/docs/adr/VD-24-runtime-schema-and-boundary-mapper.md b/docs/adr/VD-24-runtime-schema-and-boundary-mapper.md index b32324e7..158a8af8 100644 --- a/docs/adr/VD-24-runtime-schema-and-boundary-mapper.md +++ b/docs/adr/VD-24-runtime-schema-and-boundary-mapper.md @@ -1,3 +1,12 @@ + +> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택(보완) +- 작성일: 2026-07-28 +- 요약: 입력·명령·전송·응답 검증 경계를 나누고 runtime schema와 boundary mapper가 각 경계에서 할 일을 정한 결정이다. +- 현재 정본: `src/adapters/http/http-execution-v3.ts`, `src/contracts/boundary-mapper.ts` + + # VD-24: Runtime Schema와 boundary Mapper - 상태: Accepted — reference typed codec/mapper baseline은 2026-11-03에 지웠다(`12f3bb7`, `MAPPER_REGISTRY`·`RUNTIME_SCHEMA_CODECS` 삭제). 지금 schema는 V3 descriptor 검증기와 FE-REG-SCHEMA 행, mapping은 descriptor의 `mapSuccess`다. artifact governance pending diff --git a/docs/adr/VD-25-server-state-cache-lifecycle.md b/docs/adr/VD-25-server-state-cache-lifecycle.md index 7092b1fb..354fa588 100644 --- a/docs/adr/VD-25-server-state-cache-lifecycle.md +++ b/docs/adr/VD-25-server-state-cache-lifecycle.md @@ -1,3 +1,12 @@ + +> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-07-28 +- 요약: TanStack Query를 유일한 기본 server state owner로 두고 bound query, 입력 기반 mutation 조정, 세션 세대에 따른 cache 수명 주기를 정한 결정이다. +- 현재 정본: `src/presentation/adapters/query/`, `src/adapters/query-cache/`, `src/bootstrap/server-state-generation-store.ts` + + # VD-25: Server State Cache lifecycle - 상태: Accepted — reference bound-query/input-aware mutation baseline composed, lifecycle delta pending diff --git a/docs/adr/VD-26-persisted-graphql-operation.md b/docs/adr/VD-26-persisted-graphql-operation.md index 70d1f80c..da66878c 100644 --- a/docs/adr/VD-26-persisted-graphql-operation.md +++ b/docs/adr/VD-26-persisted-graphql-operation.md @@ -1,3 +1,12 @@ + +> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-07-28 +- 요약: 운영 GraphQL은 고정 endpoint와 persisted operation ID로만 보내고 임의 query 문자열은 허용하지 않는다는 결정이다. +- 현재 정본: `docs/architecture/backend-api-and-server-state-contract.md`, `docs/operations/api-contract-and-server-state-recovery.md` + + # VD-26: Persisted GraphQL operation - 상태: Accepted design — reference runtime implementation pending diff --git a/docs/adr/VD-27-grpc-web-unary-and-server-stream.md b/docs/adr/VD-27-grpc-web-unary-and-server-stream.md index 43283a5a..e6227daa 100644 --- a/docs/adr/VD-27-grpc-web-unary-and-server-stream.md +++ b/docs/adr/VD-27-grpc-web-unary-and-server-stream.md @@ -1,3 +1,12 @@ + +> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-07-28 +- 요약: gRPC-Web은 protocol profile을 섞지 않고 unary와 server stream만 지원하며 client·양방향 stream은 브라우저 한계로 보장하지 않는다는 결정이다. +- 현재 정본: `src/adapters/browser-rpc/`, `src/contracts/browser-rpc.ts` + + # VD-27: gRPC-Web unary와 server stream - 상태: Accepted design — common coordinator available, wire adapter pending diff --git a/docs/adr/VD-28-realtime-events-web-push-and-bounded-polling.md b/docs/adr/VD-28-realtime-events-web-push-and-bounded-polling.md index 45414d1b..ca7bb6fc 100644 --- a/docs/adr/VD-28-realtime-events-web-push-and-bounded-polling.md +++ b/docs/adr/VD-28-realtime-events-web-push-and-bounded-polling.md @@ -1,3 +1,12 @@ + +> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택(보완) +- 작성일: 2026-07-28 +- 요약: SSE·WebSocket·Web Push·제한된 Polling을 서로 다른 capability로 나누고 연결 복구와 자원 상한을 정한 결정이다. +- 현재 정본: `src/adapters/realtime/`, `src/adapters/web-push/`, `docs/architecture/optional-adapter-recipes.md` + + # VD-28: Realtime events, Web Push와 bounded polling - 상태: Accepted — reference runtime available, product implementation pending diff --git a/docs/adr/VD-29-connect-web-and-browser-protobuf-runtime.md b/docs/adr/VD-29-connect-web-and-browser-protobuf-runtime.md index 389a98aa..4a5e161d 100644 --- a/docs/adr/VD-29-connect-web-and-browser-protobuf-runtime.md +++ b/docs/adr/VD-29-connect-web-and-browser-protobuf-runtime.md @@ -1,3 +1,12 @@ + +> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-07-28 +- 요약: Connect-Web을 쓸 때 protocol, runtime, message encoding, framing을 따로 고르고 VD-27의 gRPC-Web 상태 기계와 섞지 않는다는 결정이다. +- 현재 정본: `src/adapters/browser-rpc/`, `src/contracts/browser-rpc.ts` + + # VD-29: Connect-Web과 browser Protobuf runtime - 상태: Accepted design — common coordinator available, wire adapter pending diff --git a/docs/adr/VD-30-protobuf-contract-and-rest-gateway.md b/docs/adr/VD-30-protobuf-contract-and-rest-gateway.md index 0452545d..18ecc730 100644 --- a/docs/adr/VD-30-protobuf-contract-and-rest-gateway.md +++ b/docs/adr/VD-30-protobuf-contract-and-rest-gateway.md @@ -1,3 +1,12 @@ + +> **결정 기록** 본문은 결정한 때의 원문이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-07-28 +- 요약: Protobuf schema와 codegen 관리 방식을 정하고, 기본 공개 adapter는 curated REST BFF로 두며 REST transcoding gateway와 섞지 않는다는 결정이다. +- 현재 정본: `docs/architecture/backend-api-and-server-state-contract.md`, `src/contracts/browser-rpc.ts` + + # VD-30: Protobuf contract와 REST transcoding gateway - 상태: Accepted design — schema/codegen과 provider runtime implementation pending diff --git a/docs/design/2026-07-26-design-system-platform-design.md b/docs/design/2026-07-26-design-system-platform-design.md index d6eedf68..5c4964b4 100644 --- a/docs/design/2026-07-26-design-system-platform-design.md +++ b/docs/design/2026-07-26-design-system-platform-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-07-26 +- 요약: 기능 화면을 만들기 전에 템플릿이 줄 디자인 시스템의 소유권, 계층, 기본 구성요소, 외부 라이브러리 경계와 검증 방법을 정한 설계다. +- 현재 정본: `src/presentation/design-system/`, `docs/styling/design-tokens.md` + + # 디자인 시스템 플랫폼 계약 이 문서는 도메인 기능을 추가하기 전에 프론트엔드 스켈레톤이 제공해야 하는 diff --git a/docs/design/2026-07-26-frontend-platform-capability-review-design.md b/docs/design/2026-07-26-frontend-platform-capability-review-design.md index 58b85584..e7d0f9aa 100644 --- a/docs/design/2026-07-26-frontend-platform-capability-review-design.md +++ b/docs/design/2026-07-26-frontend-platform-capability-review-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-07-26 +- 요약: 새 프론트 제품의 출발점이 갖춰야 할 공통 역량을 실제 호출 경로와 게이트 기준으로 다시 평가하고 RP-01~RP-12 결과를 누적한 검토다. +- 현재 정본: `docs/architecture/overview.md`, `config/recipes/frontend-capability-recipes.json` + + # 프론트엔드 플랫폼 역량 재검토 > **정본 안내 (non-authoritative for runtime capability decisions)** diff --git a/docs/design/2026-07-26-frontend-platform-implementation-roadmap-design.md b/docs/design/2026-07-26-frontend-platform-implementation-roadmap-design.md index 64d34b36..bd6e7fa2 100644 --- a/docs/design/2026-07-26-frontend-platform-implementation-roadmap-design.md +++ b/docs/design/2026-07-26-frontend-platform-implementation-roadmap-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-07-26 +- 요약: 선언된 프론트 계약을 실제 runtime과 자동 검증까지 잇는 P0·P1·P2 구현 순서와 브랜치 계획을 정한 설계다. +- 현재 정본: `docs/architecture/overview.md` + + # 프론트엔드 플랫폼 구현 로드맵 > **정본 안내 (non-authoritative for runtime capability decisions)** diff --git a/docs/design/2026-07-26-frontend-platform-testing-strategy-design.md b/docs/design/2026-07-26-frontend-platform-testing-strategy-design.md index 2bf3fb19..980c7cfc 100644 --- a/docs/design/2026-07-26-frontend-platform-testing-strategy-design.md +++ b/docs/design/2026-07-26-frontend-platform-testing-strategy-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-07-26 +- 요약: 프론트 플랫폼의 위험을 unit·contract·MSW·브라우저·시각 회귀 중 어느 테스트 계층에서 막을지 정한 테스트 전략이다. +- 현재 정본: `docs/testing/taxonomy.md` + + # 프론트엔드 플랫폼 테스트 전략 이 문서는 도메인 기능을 추가하기 전과 추가한 후에 프론트엔드 플랫폼의 위험을 diff --git a/docs/design/2026-07-26-frontend-ports-adapters-and-boundaries-design.md b/docs/design/2026-07-26-frontend-ports-adapters-and-boundaries-design.md index d923318f..7389ea70 100644 --- a/docs/design/2026-07-26-frontend-ports-adapters-and-boundaries-design.md +++ b/docs/design/2026-07-26-frontend-ports-adapters-and-boundaries-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-07-26 +- 요약: inbound·outbound 포트와 adapter의 방향, React·Router·Query·HTTP 같은 기술의 자리, 새 adapter와 feature를 더하는 순서를 정한 설계다. +- 현재 정본: `docs/architecture/layers.md`, `docs/architecture/frontend-application-foundation.md` + + # 프론트엔드 포트·어댑터와 경계 설계 > **정본 안내 (non-authoritative for runtime capability decisions)** diff --git a/docs/design/2026-07-26-routing-pages-and-patterns-design.md b/docs/design/2026-07-26-routing-pages-and-patterns-design.md index fdc9a828..876d0670 100644 --- a/docs/design/2026-07-26-routing-pages-and-patterns-design.md +++ b/docs/design/2026-07-26-routing-pages-and-patterns-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-07-26 +- 요약: typed route, 접근 guard, lazy chunk 복구, 이동할 때의 focus·취소 처리, 공통 page template과 재사용 패턴의 기준을 정한 설계다. +- 현재 정본: `src/presentation/routes/`, `src/presentation/templates/`, `docs/manual/reference/patterns.md` + + # 라우팅, 페이지 템플릿, 재사용 패턴 > **정본 안내 (non-authoritative for runtime capability decisions)** diff --git a/docs/design/2026-07-26-typescript-state-and-data-flow-design.md b/docs/design/2026-07-26-typescript-state-and-data-flow-design.md index d23b9046..2c69ecde 100644 --- a/docs/design/2026-07-26-typescript-state-and-data-flow-design.md +++ b/docs/design/2026-07-26-typescript-state-and-data-flow-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-07-26 +- 요약: TypeScript 전용 경계를 지키는 법과 local·URL·server·form·영속 상태를 둘 곳, HTTP·재시도·오류 책임을 나누는 법을 정한 설계다. +- 현재 정본: `docs/manual/reference/patterns.md`, `src/presentation/adapters/query/` + + # TypeScript, 상태 소유권, 데이터 흐름 > **정본 안내 (non-authoritative for runtime capability decisions)** diff --git a/docs/design/2026-07-27-browser-file-and-origin-storage-design.md b/docs/design/2026-07-27-browser-file-and-origin-storage-design.md index 35d6e403..7e01b43a 100644 --- a/docs/design/2026-07-27-browser-file-and-origin-storage-design.md +++ b/docs/design/2026-07-27-browser-file-and-origin-storage-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-07-27 +- 요약: File·Blob·파일 선택기·다운로드·IndexedDB·OPFS·Cache Storage를 운영에 넣을 때의 경계, 프로토콜, 실패·복구 정책과 승격 증거를 정한 설계다. +- 현재 정본: `src/adapters/browser-files/`, `src/adapters/storage/`, `docs/operations/browser-file-storage-recovery.md` + + # Browser file and origin-storage platform 이 문서는 File, Blob, 파일 선택기, 다운로드, IndexedDB, OPFS, Cache Storage를 diff --git a/docs/design/2026-07-28-api-contract-schema-mapper-and-server-state-design.md b/docs/design/2026-07-28-api-contract-schema-mapper-and-server-state-design.md index d69825d0..66ce81d1 100644 --- a/docs/design/2026-07-28-api-contract-schema-mapper-and-server-state-design.md +++ b/docs/design/2026-07-28-api-contract-schema-mapper-and-server-state-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-07-28 +- 요약: REST·GraphQL·Connect·gRPC-Web·Protobuf gateway에 걸친 API 계약, runtime schema, boundary mapper와 TanStack Query 기반 server state의 현재·목표 상태를 정한 설계다. +- 현재 정본: `docs/architecture/backend-api-and-server-state-contract.md`, `docs/operations/api-contract-and-server-state-recovery.md` + + # API contract, Schema, Mapper와 Server State platform > **정본 안내 (non-authoritative for runtime capability decisions)** diff --git a/docs/design/2026-07-28-client-cache-and-storage-design.md b/docs/design/2026-07-28-client-cache-and-storage-design.md index 3e712f83..b9e416a9 100644 --- a/docs/design/2026-07-28-client-cache-and-storage-design.md +++ b/docs/design/2026-07-28-client-cache-and-storage-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-07-28 +- 요약: TanStack Query memory cache, Local·Session Storage, IndexedDB 영속화 경계, 탭 간 무효화의 소유권과 프로토콜, 복구 방법을 정한 설계다. +- 현재 정본: `src/adapters/query-cache/`, `src/contracts/storage-keys.ts`, `docs/operations/client-cache-and-storage-recovery.md` + + # Client cache and browser storage platform > **정본 안내 (non-authoritative for runtime capability decisions)** diff --git a/docs/design/2026-07-28-protobuf-browser-transport-and-rest-gateway-design.md b/docs/design/2026-07-28-protobuf-browser-transport-and-rest-gateway-design.md index fac08360..0f3e1a72 100644 --- a/docs/design/2026-07-28-protobuf-browser-transport-and-rest-gateway-design.md +++ b/docs/design/2026-07-28-protobuf-browser-transport-and-rest-gateway-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-07-28 +- 요약: gRPC-Web·Connect-Web·Protobuf 계약과 codegen·REST gateway의 브라우저 쪽 설계로, provider 중립 Browser RPC V3 공통 runtime까지만 두고 vendor 선택은 미룬 설계다. +- 현재 정본: `src/adapters/browser-rpc/`, `src/contracts/browser-rpc.ts` + + # Protobuf browser transport와 REST Gateway - 상태: production design accepted, product/provider selection pending diff --git a/docs/design/2026-07-28-server-file-capability-infrastructure-design.md b/docs/design/2026-07-28-server-file-capability-infrastructure-design.md index d127ec6c..8ab578bc 100644 --- a/docs/design/2026-07-28-server-file-capability-infrastructure-design.md +++ b/docs/design/2026-07-28-server-file-capability-infrastructure-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-07-28 +- 요약: 프론트의 파일 capability에 맞춰 제품 backend가 만들 object storage·multipart·서명 capability 같은 서버 쪽 기반을 정한 인계 설계다. +- 현재 정본: `docs/manual/02-decision-tables.md`, `src/adapters/http/fileserver-upload.ts` + + # Server file capability infrastructure handoff - 상태: 설계 완료. 짝 백엔드 템플릿은 구현하지 않음(2026-09-25 제거) diff --git a/docs/design/2026-07-30-browser-data-capability-completion-ledger-design.md b/docs/design/2026-07-30-browser-data-capability-completion-ledger-design.md index 0f98fc89..ddca6da5 100644 --- a/docs/design/2026-07-30-browser-data-capability-completion-ledger-design.md +++ b/docs/design/2026-07-30-browser-data-capability-completion-ledger-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-07-30 +- 요약: 파일·저장소·cache·전송·Image CDN 같은 브라우저 데이터 capability의 현재·목표 상태와 남은 일, 승격 조건을 한곳에 모은 상태 대장이다. +- 현재 정본: `config/recipes/frontend-capability-recipes.json` + + # Browser data capability completion ledger ## 1. 목적 diff --git a/docs/design/2026-07-30-frontend-runtime-capability-repository-aligned-implementation-closed-deep-design.md b/docs/design/2026-07-30-frontend-runtime-capability-repository-aligned-implementation-closed-deep-design.md index 3a800848..1c06b1f3 100644 --- a/docs/design/2026-07-30-frontend-runtime-capability-repository-aligned-implementation-closed-deep-design.md +++ b/docs/design/2026-07-30-frontend-runtime-capability-repository-aligned-implementation-closed-deep-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 채택 +- 작성일: 2026-07-30 +- 요약: Runtime Config·boot, HTTP client, Router, Query·Mutation, realtime, Worker, Service Worker, offline command의 구현 결정을 닫은 상세 설계로, 다른 설계서가 런타임 결정의 정본으로 가리키던 문서다. +- 현재 정본: `docs/architecture/frontend-application-foundation.md`, `src/bootstrap/` + + # 프론트엔드 런타임 Capability 저장소 정합형 구현 결정 폐쇄 상세 설계 - 작성일: 2026-07-30 diff --git a/docs/design/2026-07-30-presigned-transfer-and-image-cdn-design.md b/docs/design/2026-07-30-presigned-transfer-and-image-cdn-design.md index 72bd1517..4cd573aa 100644 --- a/docs/design/2026-07-30-presigned-transfer-and-image-cdn-design.md +++ b/docs/design/2026-07-30-presigned-transfer-and-image-cdn-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-07-30 +- 요약: presigned URL, multipart·재개 업로드, 스트리밍 다운로드, Image CDN의 제어·데이터 경로 경계와 무결성·만료·복구 계약을 정한 설계다. +- 현재 정본: `src/adapters/browser-transfer/`, `docs/operations/browser-transfer-recovery.md`, `docs/manual/02-decision-tables.md` + + # Presigned transfer, resumable upload, streaming download and Image CDN 이 문서는 presigned URL, multipart/resumable upload, streaming download와 diff --git a/docs/design/2026-07-30-realtime-events-web-push-and-bounded-polling-design.md b/docs/design/2026-07-30-realtime-events-web-push-and-bounded-polling-design.md index 1a97ee72..40f7401a 100644 --- a/docs/design/2026-07-30-realtime-events-web-push-and-bounded-polling-design.md +++ b/docs/design/2026-07-30-realtime-events-web-push-and-bounded-polling-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-07-30 +- 요약: SSE·WebSocket·Web Push·제한된 Polling을 도입할 때의 선택 기준, 포트 경계, 이벤트 계약, 재연결·복구와 승격 조건을 정한 설계다. +- 현재 정본: `src/adapters/realtime/`, `src/adapters/web-push/` + + # Realtime events, Web Push, and bounded polling > **정본 안내 (non-authoritative for runtime capability decisions)** diff --git a/docs/design/2026-07-31-platform-overview-page-design.md b/docs/design/2026-07-31-platform-overview-page-design.md index 9a433031..714b1ca4 100644 --- a/docs/design/2026-07-31-platform-overview-page-design.md +++ b/docs/design/2026-07-31-platform-overview-page-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-07-31 +- 요약: 설치된 route·계약·런타임 능력을 레지스트리에서만 파생해 보여 주는 플랫폼 구성 화면(`/examples/platform`)을 더하는 설계다. +- 현재 정본: `src/presentation/examples/platform-overview-page.tsx` + + # 플랫폼 구성 화면 (`EXAMPLES_PLATFORM`) 설계 작성일: 2026-07-31 diff --git a/docs/design/2026-08-01-refactoring-review-remediation-design.md b/docs/design/2026-08-01-refactoring-review-remediation-design.md index 88fa312e..be094b4d 100644 --- a/docs/design/2026-08-01-refactoring-review-remediation-design.md +++ b/docs/design/2026-08-01-refactoring-review-remediation-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-08-01 +- 요약: 런타임 정합성 작업을 마무리하고 저장소 전체 리뷰에서 나온 query 무효화·mutation intent·release 증거·게이트 결함을 단계별로 고치는 수정 설계다. +- 현재 정본: `src/contracts/query-invalidation.ts`, `src/contracts/mutation-intent.ts`, `docs/security/supply-chain.md` + + # Refactoring Review Remediation Design ## Purpose diff --git a/docs/design/2026-08-01-runtime-integrity-refactor-design.md b/docs/design/2026-08-01-runtime-integrity-refactor-design.md index 855dbd1c..c6e37b10 100644 --- a/docs/design/2026-08-01-runtime-integrity-refactor-design.md +++ b/docs/design/2026-08-01-runtime-integrity-refactor-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-08-01 +- 요약: release 산출물과 boot 프로토콜에서 실패를 통과시키던 경로를 먼저 막고, 런타임 소유권을 드러낸 뒤 도구와 큰 adapter를 정리하는 단계별 리팩터링 설계다. +- 현재 정본: `scripts/contracts/release-artifacts.ts`, `src/bootstrap/` + + # Runtime Integrity Refactor Design ## Purpose diff --git a/docs/design/2026-08-02-platform-owned-frontend-assurance-delivery-design.md b/docs/design/2026-08-02-platform-owned-frontend-assurance-delivery-design.md index 0b24bc59..741f1af0 100644 --- a/docs/design/2026-08-02-platform-owned-frontend-assurance-delivery-design.md +++ b/docs/design/2026-08-02-platform-owned-frontend-assurance-delivery-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-08-02 +- 요약: 테스트 보증과 CI/CD 실행을 `test-assurance-platform`과 `cicd-platform`으로 옮기고 이 repo에는 제품 코드와 제품 테스트만 남기는 설계다. +- 현재 정본: `docs/operations/ci-quality-gates.md` + + # Platform-owned Frontend Assurance and Delivery Design ## Purpose diff --git a/docs/design/2026-08-02-provider-raw-guardian-design.md b/docs/design/2026-08-02-provider-raw-guardian-design.md index 1a578a7f..6641de90 100644 --- a/docs/design/2026-08-02-provider-raw-guardian-design.md +++ b/docs/design/2026-08-02-provider-raw-guardian-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-08-02 +- 요약: provider 증거 파일의 생성부터 봉인·게시까지를 guardian 프로세스 하나가 맡아, 중간에 죽어도 정본 증거가 남지 않고 바로 다시 시도할 수 있게 하는 설계다. +- 현재 정본: `scripts/lib/provider-raw-guardian.ts` + + # Provider Evidence Guardian Transaction Design ## Goal diff --git a/docs/design/2026-08-02-v8-coverage-counter-contract-design.md b/docs/design/2026-08-02-v8-coverage-counter-contract-design.md index 2f6e96ac..a91baa34 100644 --- a/docs/design/2026-08-02-v8-coverage-counter-contract-design.md +++ b/docs/design/2026-08-02-v8-coverage-counter-contract-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-08-02 +- 요약: risk-coverage 산출물 schema를 정책과 따로 version 3으로 올리고, 설치된 Vitest·V8이 내는 counter 유무 분류를 고정하는 계약 설계다. +- 현재 정본: `scripts/check-v8-coverage-counter-semantics.ts`, `scripts/check-risk-coverage.ts` + + # V8 Coverage Counter Contract Design ## Goal diff --git a/docs/design/2026-09-16-adapter-barrel-boundary-design.md b/docs/design/2026-09-16-adapter-barrel-boundary-design.md index 92ac7152..136705d5 100644 --- a/docs/design/2026-09-16-adapter-barrel-boundary-design.md +++ b/docs/design/2026-09-16-adapter-barrel-boundary-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-09-16 +- 요약: 어댑터 그룹의 `index.ts` 배럴을 실제 공개 경계로 만들고 그룹 밖은 배럴만 import하게 게이트로 강제하는 설계다. +- 현재 정본: `docs/architecture/layers.md`, `.dependency-cruiser.json` + + # 어댑터 배럴(`index.ts`)을 공개 경계로 승격 — 설계서 - 대상 레포: `/home/donghyeon/workspace/desktop-server-git/clean-architecture-frontend-template` diff --git a/docs/design/2026-09-16-indexeddb-kernel-promotion-design.md b/docs/design/2026-09-16-indexeddb-kernel-promotion-design.md index ffde8780..1fee1890 100644 --- a/docs/design/2026-09-16-indexeddb-kernel-promotion-design.md +++ b/docs/design/2026-09-16-indexeddb-kernel-promotion-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-09-16 +- 요약: 어댑터 4곳에 흩어진 IndexedDB 연결·트랜잭션 구현을 `src/adapters/platform/` 커널로 모으는 설계다. +- 현재 정본: `src/adapters/platform/indexeddb-connection.ts`, `src/adapters/platform/indexeddb-transaction.ts` + + # IndexedDB 커널 승격 — 구체 설계 > 대상 브랜치: `develop` (5434760) diff --git a/docs/design/2026-09-20-memento-frontend-template-bootstrap-design.md b/docs/design/2026-09-20-memento-frontend-template-bootstrap-design.md index 02bf5683..0b28c2a5 100644 --- a/docs/design/2026-09-20-memento-frontend-template-bootstrap-design.md +++ b/docs/design/2026-09-20-memento-frontend-template-bootstrap-design.md @@ -1,3 +1,12 @@ + +> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-09-20 +- 요약: `memento-frontend`를 이 템플릿에서 upstream 추적 방식으로 파생하는 절차와 그 전에 템플릿에서 고칠 것을 정한 설계다. +- 현재 정본: `README.md` + + # memento-frontend를 이 템플릿에서 파생시키기 — 설계서 - 작성일: 2026-09-20 diff --git a/docs/history/plans/2026-07-31-platform-overview-completion.md b/docs/history/plans/2026-07-31-platform-overview-completion.md index 88bd6438..8a6dea18 100644 --- a/docs/history/plans/2026-07-31-platform-overview-completion.md +++ b/docs/history/plans/2026-07-31-platform-overview-completion.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-07-31 +- 요약: 플랫폼 구성 화면이 정적 선택뿐 아니라 런타임 해석 결과까지 보여 주고 진입 경로와 브라우저 회귀 시험을 갖추게 하는 구현 계획이다. +- 현재 정본: `src/presentation/examples/platform-overview-page.tsx` + + # 플랫폼 구성 화면 완성 구현 계획 > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. diff --git a/docs/history/plans/2026-08-01-http-worker-adapter-remediation.md b/docs/history/plans/2026-08-01-http-worker-adapter-remediation.md index 95e9782f..0de6686b 100644 --- a/docs/history/plans/2026-08-01-http-worker-adapter-remediation.md +++ b/docs/history/plans/2026-08-01-http-worker-adapter-remediation.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-08-01 +- 요약: 중복된 HTTP 실행 경로를 없애고 Service Worker 활성화 상한과 신원 확인을 강화한 뒤 큰 브라우저 adapter를 나누는 구현 계획이다. +- 현재 정본: `src/adapters/http/`, `src/adapters/service-worker/` + + # HTTP Worker and Adapter Remediation Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. diff --git a/docs/history/plans/2026-08-01-quality-architecture-remediation.md b/docs/history/plans/2026-08-01-quality-architecture-remediation.md index 18254a9e..a68254d8 100644 --- a/docs/history/plans/2026-08-01-quality-architecture-remediation.md +++ b/docs/history/plans/2026-08-01-quality-architecture-remediation.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-08-01 +- 요약: coverage·시나리오·CI·아키텍처 게이트가 실제 운영 동작을 재고, 측정 대상이 비었거나 모자라면 실패하게 하는 구현 계획이다. +- 현재 정본: `docs/operations/ci-quality-gates.md`, `scripts/check-architecture.ts`, `scripts/check-risk-coverage.ts` + + # Quality and Architecture Remediation Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. diff --git a/docs/history/plans/2026-08-01-release-boot-integrity.md b/docs/history/plans/2026-08-01-release-boot-integrity.md index e9cf9d86..af4e42e8 100644 --- a/docs/history/plans/2026-08-01-release-boot-integrity.md +++ b/docs/history/plans/2026-08-01-release-boot-integrity.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-08-01 +- 요약: 생성한 Release Manifest V2 산출물을 검증할 수 있게 하고, 브라우저가 V1/V1 또는 V2/V2 boot 프로토콜 짝만 받게 하는 구현 계획이다. +- 현재 정본: `scripts/contracts/release-artifacts.ts`, `src/bootstrap/load-release-manifest.ts` + + # Release and Boot Integrity Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. diff --git a/docs/history/plans/2026-08-01-release-evidence-remediation.md b/docs/history/plans/2026-08-01-release-evidence-remediation.md index 98a6cec0..f53ce658 100644 --- a/docs/history/plans/2026-08-01-release-evidence-remediation.md +++ b/docs/history/plans/2026-08-01-release-evidence-remediation.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-08-01 +- 요약: 불변 release bundle 하나를 만들고, 모든 산출물·provider 보고·schema·digest가 그 바이트를 가리킬 때만 승격을 통과시키는 구현 계획이다. +- 현재 정본: `docs/security/supply-chain.md` + + # Release Evidence Remediation Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. diff --git a/docs/history/plans/2026-08-01-runtime-correctness-remediation.md b/docs/history/plans/2026-08-01-runtime-correctness-remediation.md index d96e7977..3743925d 100644 --- a/docs/history/plans/2026-08-01-runtime-correctness-remediation.md +++ b/docs/history/plans/2026-08-01-runtime-correctness-remediation.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-08-01 +- 요약: topic 무효화가 실제 bound query 전부에 닿게 하고, 논리적 mutation마다 고유한 intent와 결과를 반영한 낙관적 상태를 지키게 하는 구현 계획이다. +- 현재 정본: `src/contracts/query-keys.ts`, `src/contracts/mutation-intent.ts`, `src/presentation/adapters/query/` + + # Runtime Correctness Remediation Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. diff --git a/docs/history/plans/2026-08-01-scope-owned-server-state.md b/docs/history/plans/2026-08-01-scope-owned-server-state.md index f16edf26..ab5238b9 100644 --- a/docs/history/plans/2026-08-01-scope-owned-server-state.md +++ b/docs/history/plans/2026-08-01-scope-owned-server-state.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-08-01 +- 요약: 인증 scope가 바뀐 뒤 이전 계정의 query와 낙관적 상태가 화면에 남거나 다시 쓰이지 않게 하는 구현 계획이다. +- 현재 정본: `src/bootstrap/server-state-generation-store.ts`, `src/presentation/adapters/query/server-state-scope-provider.tsx` + + # Scope-Owned Server State Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. diff --git a/docs/history/plans/2026-08-02-cicd-frontend-assurance-delivery.md b/docs/history/plans/2026-08-02-cicd-frontend-assurance-delivery.md index efd318d6..12170385 100644 --- a/docs/history/plans/2026-08-02-cicd-frontend-assurance-delivery.md +++ b/docs/history/plans/2026-08-02-cicd-frontend-assurance-delivery.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-08-02 +- 요약: `cicd-platform`이 프론트 workflow 조정, 후보 생성, 공급망 증거, 불변 게시와 정확한 후보 승격을 혼자 맡게 하는 그 repo의 구현 계획이다. +- 현재 정본: `docs/operations/ci-quality-gates.md` + + # CI/CD Frontend Assurance and Delivery Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. diff --git a/docs/history/plans/2026-08-02-counter-bearing-coverage-provenance.md b/docs/history/plans/2026-08-02-counter-bearing-coverage-provenance.md index df2db1a9..3ecf5b4c 100644 --- a/docs/history/plans/2026-08-02-counter-bearing-coverage-provenance.md +++ b/docs/history/plans/2026-08-02-counter-bearing-coverage-provenance.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 끝남 +- 작성일: 2026-08-02 +- 요약: coverage 출처 이름과 정적 분류를 Vitest·V8이 실제로 내는 counter에 맞추는 구현 계획이다. +- 현재 정본: `scripts/check-risk-coverage.ts`, `config/testing/risk-coverage.json` + + # Counter-bearing Coverage Provenance Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. diff --git a/docs/history/plans/2026-08-02-frontend-platform-consumer-migration.md b/docs/history/plans/2026-08-02-frontend-platform-consumer-migration.md index 81454a1a..3458a560 100644 --- a/docs/history/plans/2026-08-02-frontend-platform-consumer-migration.md +++ b/docs/history/plans/2026-08-02-frontend-platform-consumer-migration.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-08-02 +- 요약: 이 템플릿을 `test-assurance-platform`과 `cicd-platform`의 얇은 소비자로 바꾸면서 제품 소스·테스트·fixture를 그대로 두는 이행 계획이다. +- 현재 정본: `docs/operations/ci-quality-gates.md`, `docs/testing/taxonomy.md` + + # Frontend Thin Platform Consumer Migration Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. Use `superpowers:using-git-worktrees` before editing. diff --git a/docs/history/plans/2026-08-02-promotion-security-review-fixes.md b/docs/history/plans/2026-08-02-promotion-security-review-fixes.md index 8f0ec7f1..07d6390b 100644 --- a/docs/history/plans/2026-08-02-promotion-security-review-fixes.md +++ b/docs/history/plans/2026-08-02-promotion-security-review-fixes.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-08-02 +- 요약: 보안 리뷰에서 나온 증거·수명 주기·staging·출력·신선도·workflow 결함을 닫고, 캡처한 후보 archive와 다섯 파일 bundle 검증기만 승격 근거로 삼게 하는 수정 계획이다. +- 현재 정본: `docs/security/supply-chain.md`, `scripts/lib/promotion-stager.ts` + + # Promotion Security Review Fixes Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. diff --git a/docs/history/plans/2026-08-02-provider-raw-guardian.md b/docs/history/plans/2026-08-02-provider-raw-guardian.md index 4abd8728..069e83ca 100644 --- a/docs/history/plans/2026-08-02-provider-raw-guardian.md +++ b/docs/history/plans/2026-08-02-provider-raw-guardian.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-08-02 +- 요약: guardian이 시작할 때 정리 권한을 spawn 전에 할당한 파일 신원에서만 얻게 하면서, 덮어쓰지 않는 게시와 즉시 재시도를 지키는 구현 계획이다. +- 현재 정본: `scripts/lib/provider-raw-guardian.ts` + + # Provider Evidence Guardian Transaction Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. diff --git a/docs/history/plans/2026-08-02-security-finalizer.md b/docs/history/plans/2026-08-02-security-finalizer.md index 076cd1c7..ece82436 100644 --- a/docs/history/plans/2026-08-02-security-finalizer.md +++ b/docs/history/plans/2026-08-02-security-finalizer.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-08-02 +- 요약: 캡처한 불변 후보를 무작위 비공개 staging 폴더 하나에 다섯 파일과 v3 검증 기록으로 마무리하는 구현 계획이다. +- 현재 정본: `scripts/lib/promotion-stager.ts`, `scripts/lib/stage-verified-promotion-cli.ts` + + # Security Finalizer Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. diff --git a/docs/history/plans/2026-08-02-test-assurance-frontend-capabilities.md b/docs/history/plans/2026-08-02-test-assurance-frontend-capabilities.md index ea616d22..b305ad35 100644 --- a/docs/history/plans/2026-08-02-test-assurance-frontend-capabilities.md +++ b/docs/history/plans/2026-08-02-test-assurance-frontend-capabilities.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-08-02 +- 요약: `test-assurance-platform`이 프론트 제품 suite의 선택·계획·실행·정규화·증거·판정을 모두 맡도록 넓히는 그 repo의 구현 계획이다. +- 현재 정본: `docs/testing/taxonomy.md` + + # Test Assurance Frontend Capability Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. diff --git a/docs/history/plans/2026-08-02-v8-coverage-counter-contract.md b/docs/history/plans/2026-08-02-v8-coverage-counter-contract.md index 0ceb9636..89c9c15a 100644 --- a/docs/history/plans/2026-08-02-v8-coverage-counter-contract.md +++ b/docs/history/plans/2026-08-02-v8-coverage-counter-contract.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 끝남 +- 작성일: 2026-08-02 +- 요약: risk-coverage 산출물 schema version 3을 내고, 설치된 Vitest·V8의 counter 분류를 격리된 자식 실행에서 계속 검증하게 하는 구현 계획이다. +- 현재 정본: `scripts/check-v8-coverage-counter-semantics.ts`, `scripts/check-risk-coverage.ts` + + # V8 Coverage Counter Contract Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. diff --git a/docs/history/plans/2026-08-13-adapter-remediation.md b/docs/history/plans/2026-08-13-adapter-remediation.md index 3b89dc8b..01d58003 100644 --- a/docs/history/plans/2026-08-13-adapter-remediation.md +++ b/docs/history/plans/2026-08-13-adapter-remediation.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 확인 안 함 +- 작성일: 2026-08-13 +- 요약: 확인된 adapter 정확성·수명 주기 결함을 모두 닫고 version 호환을 지킨 뒤에야 상태 기계 분리나 선택 capability 승격을 하는 수정 계획이다. +- 현재 정본: `docs/operations/adapter-remediation-ledger.md` + + # Adapter Correctness and Refactoring Remediation Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. diff --git a/docs/history/plans/2026-09-16-adapter-barrel-boundary.md b/docs/history/plans/2026-09-16-adapter-barrel-boundary.md index b9968a99..5c5ae835 100644 --- a/docs/history/plans/2026-09-16-adapter-barrel-boundary.md +++ b/docs/history/plans/2026-09-16-adapter-barrel-boundary.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 끝남 +- 작성일: 2026-09-16 +- 요약: 어댑터 16개 그룹 모두에 `index.ts` 공개 경계를 세우고 그룹 밖은 배럴만 import하게 게이트로 강제하는 구현 계획이다. +- 현재 정본: `docs/architecture/layers.md`, `.dependency-cruiser.json` + + # 어댑터 배럴 공개 경계 확립 Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. diff --git a/docs/history/plans/2026-09-16-indexeddb-kernel-promotion.md b/docs/history/plans/2026-09-16-indexeddb-kernel-promotion.md index dbdd7368..01dd7663 100644 --- a/docs/history/plans/2026-09-16-indexeddb-kernel-promotion.md +++ b/docs/history/plans/2026-09-16-indexeddb-kernel-promotion.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 끝남 +- 작성일: 2026-09-16 +- 요약: 어댑터 4곳의 IndexedDB 연결·트랜잭션 구현을 `src/adapters/platform/` 커널 두 파일로 모아 서로 다르던 동작을 하나로 맞추는 구현 계획이다. +- 현재 정본: `src/adapters/platform/indexeddb-connection.ts`, `src/adapters/platform/indexeddb-transaction.ts` + + # IndexedDB 커널 승격 Implementation Plan > **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. diff --git a/docs/history/plans/2026-09-25-review-fix-round/SPEC.md b/docs/history/plans/2026-09-25-review-fix-round/SPEC.md index 1ad37aaf..82347b3f 100644 --- a/docs/history/plans/2026-09-25-review-fix-round/SPEC.md +++ b/docs/history/plans/2026-09-25-review-fix-round/SPEC.md @@ -1,3 +1,12 @@ + +> **기록 · 계획서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. + +- 상태: 끝남 +- 작성일: 2026-09-25 +- 요약: 2026-09-25 성숙도 리뷰 발견 138건을 고칠 때의 공통 완료 기준, 방향이 갈린 항목의 결정, repo 밖 사용자 몫을 정한 명세이고, 라운드는 v0.2.0(2026-09-27)으로 끝났다. +- 현재 정본: 없음 — 끝난 라운드의 계획이다. 이 라운드가 바꾼 것은 `CHANGELOG.md` 0.2.0 절에 있다 + + # SPEC: 성숙도 리뷰(2026-09-25) 전 항목 반영 ## 목적