From c0ddc0328e8652558858189c6ed9270cfd13c3b2 Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Thu, 12 Nov 2026 22:46:05 +0900 Subject: [PATCH 1/5] =?UTF-8?q?fix(hooks):=20=EC=82=B4=EC=95=84=20?= =?UTF-8?q?=EC=9E=88=EB=8A=94=20=EC=A7=80=EC=B9=A8=20=EB=AC=B8=EC=84=9C=20?= =?UTF-8?q?=ED=8E=B8=EC=A7=91=EB=8F=84=20desktop=20=ED=99=95=EC=9D=B8?= =?UTF-8?q?=EC=9D=84=20=EC=95=8C=EB=A6=B0=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 편집 훅 N5는 CLAUDE.md, src/**/AGENTS.md·CLAUDE.md, .claude/ 아래 문서를 노트북 검사(check-work-docs.py)로 끝나는 파일로 센다. 그러나 desktop 게이트 verify:documentation도 그 문서들을 읽는다(경로·명령· script·FE-GATE ID). 그래서 지침 문서만 고친 턴은 desktop 실행 없이 끝나고, 루트 AGENTS.md와 experts.md도 노트북 검사만 안내한다. 고른 방법: LAPTOP_ONLY에서 문서(.md)를 빼고 .claude/의 문서 밖 파일 (설정·훅 상태)만 남긴다. AGENTS.md 검증 줄과 experts.md 경로표에 desktop verify:documentation을 더한다. 버린 대안: 훅은 두고 문서만 고치기(턴 끝 알림이 계속 빠진다). 위험·한계: 지침 문서만 고친 턴도 이제 desktop 실행 전까지 한 번 막힌다. 막지는 않고 이유를 알린다(N5 동작 그대로). 검증: python3 -m unittest discover -s scripts/tests 72개 통과(노트북). 새 시험 test_living_instruction_documents_need_the_desktop은 고치기 전 코드에서 다섯 경로 모두 실패했다. Refs: 1112/08-04 --- AGENTS.md | 2 +- docs/work/experts.md | 2 +- scripts/hooks/README.md | 2 +- scripts/hooks/hooks.py | 10 +++++----- scripts/tests/test_hooks.py | 13 ++++++++++--- 5 files changed, 18 insertions(+), 11 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 37898d01..259583ac 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -26,7 +26,7 @@ - 진입점은 `scripts/verify.sh <단계>`다. 단계는 `config/ci/gates.json`의 stage id(`merge` 등), 게이트 하나는 `scripts/verify.sh gate FE-GATE-005`(안에서 `corepack pnpm ci:gate FE-GATE-005`). pnpm 단계는 desktop으로 옮겨 돈다. - "merge 가능"은 merge 단계 게이트 전부를 `CI=true`로 돌려 통과한 것이다. 골라 돌린 결과로 말하지 않는다. desktop의 FE-GATE-013은 `docs/work/reference/gates.md` 3절 문구로 적는다. -- 문서·지침을 고쳤으면 `scripts/verify.sh docs`(노트북). +- 문서·지침을 고쳤으면 `scripts/verify.sh docs`(노트북)와 desktop `scripts/verify.sh script verify:documentation`. ## 일하는 방식 diff --git a/docs/work/experts.md b/docs/work/experts.md index bc527746..9d824462 100644 --- a/docs/work/experts.md +++ b/docs/work/experts.md @@ -67,7 +67,7 @@ | `src/adapters/{auth,http,storage}/**`, `src/presentation/security/**`, `config/security/**`, `config/hosting/security-headers.json`, `index.html`, `docs/security/**`, `recipes/session-owners/**` | fe-security | HTTP 실패 분류·재전송 → fe-react | | `package.json`, `pnpm-lock.yaml` | fe-security + fe-performance | 시험 도구만 바뀜 → fe-testing | | `config/ci/**`, `.gitea/**`, `scripts/**` | 지식 스킬 없음. `.claude/rules/gates-and-budgets.md`와 `desktop-gates` | 그 게이트가 지키는 분야의 렌즈 | -| `docs/**/*.md`, `**/AGENTS.md`, `.claude/**/*.md` | 지식 스킬 없음. `.claude/rules/docs.md`, `scripts/verify.sh docs` | 문서가 설명하는 동작 → 그 분야 렌즈 | +| `docs/**/*.md`, `**/AGENTS.md`, `.claude/**/*.md` | 지식 스킬 없음. `.claude/rules/docs.md`, `scripts/verify.sh docs`와 desktop `verify:documentation` | 문서가 설명하는 동작 → 그 분야 렌즈 | ## 4. 넘김 지도 diff --git a/scripts/hooks/README.md b/scripts/hooks/README.md index 511c3edf..88257474 100644 --- a/scripts/hooks/README.md +++ b/scripts/hooks/README.md @@ -26,7 +26,7 @@ Bash 직후 ──> post-bash ──> desktop에서 pnpm·게이트를 돌 | N5 | Stop | 이 세션에서 desktop만 확인할 수 있는 파일(아래 밖의 모든 파일)을 고친 뒤 desktop 실행이 없으면 턴을 한 번 막고 이유를 준다 | `decision: block`, 다음 편집 전까지 한 번 | - N5가 "desktop 실행"으로 치는 것: `ssh …`로 pnpm·`ci:gate`·`verify.sh`·vitest·playwright·`node scripts/…`를 돌린 명령, 또는 `scripts/verify.sh`를 `docs`·`hooks` 밖 단계로(`--on here` 없이) 돌린 명령. -- N5가 세지 않는 파일(노트북에서 확인되는 것): `.claude/`, `scripts/hooks/`, `scripts/tests/`, `scripts/check-work-docs.py`, `docs/ledger/`, `CLAUDE.md`, `src/**/AGENTS.md`·`CLAUDE.md`. 이것들은 `scripts/verify.sh docs`·`hooks`가 노트북에서 본다. +- N5가 세지 않는 파일(노트북에서 확인되는 것): `.claude/`의 문서 밖 파일(설정·훅 상태), `scripts/hooks/`, `scripts/tests/`, `scripts/check-work-docs.py`, `docs/ledger/`. 이것들은 `scripts/verify.sh docs`·`hooks`가 노트북에서 본다. `CLAUDE.md`, `src/**/AGENTS.md`·`CLAUDE.md`, `.claude/**/*.md`는 desktop `verify:documentation`도 보므로 센다. - N5가 기억하는 것은 `.claude/hook-state/.json`이다(git이 무시한다). - 권한 쪽 차단: `.claude/settings.json`의 `permissions.deny`가 실제 `.env`·`.env.local`·`.env.*.local`·`.env.` 읽기·쓰기를 막는다. `.env.example`은 막지 않는다. diff --git a/scripts/hooks/hooks.py b/scripts/hooks/hooks.py index 2d1b8e48..65987781 100755 --- a/scripts/hooks/hooks.py +++ b/scripts/hooks/hooks.py @@ -70,16 +70,16 @@ DOC_CHECK = ("scripts/check-work-docs.py",) DOC_TIMEOUT = 20 # --- N5: an edit that only the desktop can check, until a desktop run -------------------------------------- -# Laptop-checkable on their own: the hooks and their tests, the work-manual checker, the ledger, Claude -# settings, CLAUDE.md and the folder rule books under src/ (scripts/check-work-docs.py checks them). Everything else is checked by gates that need pnpm. +# Laptop-checkable on their own: the hooks and their tests, the work-manual checker, the ledger and the +# Claude settings outside its documents. Everything else is checked by gates that need pnpm, documents +# included: verify:documentation reads CLAUDE.md, the folder rule books under src/ and .claude/**/*.md +# too (1112/08-04). LAPTOP_ONLY = ( - re.compile(r"^\.claude/"), + re.compile(r"^\.claude/(?!.*\.md$)"), re.compile(r"^scripts/hooks/"), re.compile(r"^scripts/tests/"), re.compile(r"^scripts/check-work-docs\.py$"), re.compile(r"^docs/ledger/"), - re.compile(r"^CLAUDE\.md$"), - re.compile(r"^src/(?:.+/)?(?:AGENTS|CLAUDE)\.md$"), ) DESKTOP_HOST = re.compile(r"desktop") DESKTOP_WORK = re.compile(r"\b(?:pnpm|ci:gate|verify\.sh|vitest|playwright)\b|\bnode\s+scripts/") diff --git a/scripts/tests/test_hooks.py b/scripts/tests/test_hooks.py index d3df0c4b..2517e5d6 100644 --- a/scripts/tests/test_hooks.py +++ b/scripts/tests/test_hooks.py @@ -244,13 +244,20 @@ class TurnEndNudgeTest(RepositoryTestCase): self.assertIsNotNone(self.stop()) def test_files_the_laptop_checks_do_not_need_the_desktop(self) -> None: - for path in (".claude/rules/x.md", "scripts/hooks/hooks.py", "scripts/tests/test_x.py", "CLAUDE.md", - "docs/ledger/estimates.jsonl", "scripts/check-work-docs.py", "src/adapters/AGENTS.md", - "src/features/CLAUDE.md"): + for path in (".claude/settings.json", "scripts/hooks/hooks.py", "scripts/tests/test_x.py", + "docs/ledger/estimates.jsonl", "scripts/check-work-docs.py"): self.repo.write(path, "x\n") run_event("post-edit", self.repo.payload(path)) self.assertIsNone(self.stop()) + def test_living_instruction_documents_need_the_desktop(self) -> None: + # 1112/08-04. verify:documentation, a desktop gate, checks these documents too. + for path in (".claude/rules/x.md", ".claude/skills/fe-x/SKILL.md", "CLAUDE.md", + "src/adapters/AGENTS.md", "src/features/CLAUDE.md"): + with self.subTest(path=path): + self.edit(path, "x\n") + self.assertIsNotNone(self.stop()) + def test_a_new_edit_after_the_reminder_reminds_again(self) -> None: self.edit("src/domain/order.ts", "export const a = 4;\n") self.stop() From 06ffafa25ee04f3bb5f552e33311be9180c18f58 Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Thu, 12 Nov 2026 22:46:25 +0900 Subject: [PATCH 2/5] =?UTF-8?q?docs:=20=EC=82=B4=EC=95=84=20=EC=9E=88?= =?UTF-8?q?=EB=8A=94=20=EB=AC=B8=EC=84=9C=EC=9D=98=20=EB=82=A1=EC=9D=80=20?= =?UTF-8?q?=EB=AC=B8=EC=9E=A5=EC=9D=84=20=EC=A7=80=EA=B8=88=20=EC=BD=94?= =?UTF-8?q?=EB=93=9C=EC=99=80=20=EC=A0=95=EB=B3=B8=EC=97=90=20=EB=A7=9E?= =?UTF-8?q?=EC=B6=98=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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 --- .claude/rules/gates-and-budgets.md | 4 +- .claude/rules/tests.md | 2 +- CLAUDE.md | 2 +- README.md | 9 ++- config/repository-layout.json | 2 +- .../backend-api-and-server-state-contract.md | 8 +- .../capability-consumer-experience.md | 2 +- docs/architecture/layers.md | 8 +- docs/architecture/optional-adapter-recipes.md | 80 +++++++++++++++++-- docs/architecture/starter-experience.md | 5 +- docs/architecture/static-delivery.md | 10 +-- ...nts-web-push-and-bounded-polling-design.md | 2 +- docs/manual/01-add-a-feature.md | 4 +- docs/manual/03-outside-feature-folder.md | 2 +- docs/manual/README.md | 2 +- docs/manual/reference/create-feature.md | 7 +- docs/operations/ci-quality-gates.md | 28 ++----- docs/operations/performance-evidence.md | 2 +- docs/operations/release-cache-rollback.md | 4 +- docs/reviews/adapters/INVENTORY.md | 4 +- docs/security/browser-boundary.md | 2 +- docs/security/supply-chain.md | 9 ++- docs/work/README.md | 2 +- docs/work/improve.md | 2 +- docs/work/operate.md | 2 +- docs/work/reference/gates.md | 7 +- docs/work/reference/structure.md | 4 +- .../polling/bounded-poll-coordinator.ts | 3 +- src/contracts/AGENTS.md | 4 +- 29 files changed, 142 insertions(+), 80 deletions(-) diff --git a/.claude/rules/gates-and-budgets.md b/.claude/rules/gates-and-budgets.md index 0e2d6018..3873e9e1 100644 --- a/.claude/rules/gates-and-budgets.md +++ b/.claude/rules/gates-and-budgets.md @@ -19,5 +19,5 @@ paths: - 기준선 기록(초기 JS, 기능 모양)은 손으로 고치지 않는다. 측정 스크립트를 `--initial-baseline --write`로 돌린 결과를 같은 변경에 넣는다. - workflow는 생성기로 만든다. `.gitea/workflows/`만 손으로 고치지 않는다(`check:ci`가 대조한다). - 새 검사에는 통과 fixture와 거절 fixture를 함께 둔다. 실패 메시지는 넘은 항목·잰 값·고칠 파일을 말한다. 사전 점검은 본 단계와 같은 방법으로 한 번 실행해 본다. -- 바꾼 뒤 desktop에서 `scripts/verify.sh merge`. stage·게이트 목록이 바뀌어도 `scripts/verify.sh`는 계약 파일에서 읽어 따라간다. -- 편집 훅(N6)이 이 파일들의 편집을 알린다. 알림은 막지 않는다. 의도한 변경이면 커밋 본문에 이유와 결정 출처를 적는다. +- 바꾼 뒤 desktop에서 `scripts/verify.sh merge`. 검사 script나 그 fixture를 바꿨으면 `scripts/verify.sh gate FE-GATE-029`도 돌린다(검사기 자기 시험은 main 단계다). stage·게이트 목록이 바뀌어도 `scripts/verify.sh`는 계약 파일에서 읽어 따라간다. +- 편집 훅(N6)이 예산·기준선·ungated 목록·시험 설정·스냅숏의 편집을 알린다(목록은 `scripts/hooks/README.md`). 이 규칙의 다른 파일(`config/ci/gates.json`, workflow, 검사 script)은 알리지 않는다. 알림은 막지 않는다. 의도한 변경이면 커밋 본문에 이유와 결정 출처를 적는다. diff --git a/.claude/rules/tests.md b/.claude/rules/tests.md index 70cea1e7..59c27678 100644 --- a/.claude/rules/tests.md +++ b/.claude/rules/tests.md @@ -22,4 +22,4 @@ paths: ## 돌리는 법 -- 노트북에서는 돌리지 않는다. 한 파일도 desktop에서: `scripts/verify.sh script test:unit`, 또는 `ssh desktop`으로 `node scripts/run-vitest.ts run `(이 runner가 생성물을 먼저 만든다. `pnpm exec vitest run `은 import 오류로 실패한다). +- 노트북에서는 돌리지 않는다. 한 파일도 desktop에서 `scripts/verify.sh exec -- node scripts/run-vitest.ts run `로 돌린다(이 runner가 생성물을 먼저 만든다. `pnpm exec vitest run `은 import 오류로 실패한다). 실행 위치의 정본은 `docs/work/operate.md` 4.1절이다. diff --git a/CLAUDE.md b/CLAUDE.md index 89674dd6..54d85926 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -7,5 +7,5 @@ `claude plugin marketplace add https://git.learn.hyeonworks.com/donghyeon.kang/claude-harness.git --scope project` `claude plugin install harness@claude-harness --scope project` - 경로별 규칙은 `.claude/rules/`, 스킬은 `.claude/skills/`, 서브에이전트(읽기 전용)는 `.claude/agents/`다. -- 분야 지식은 `fe-*` 스킬 9개(`paths`가 걸려 그 분야 파일을 만질 때 목록에 뜬다)이고, 분야 판정은 서브에이전트 `reviewer`에 그 스킬을 렌즈로 준다. 여러 분야면 플러그인 `lead`. 명단은 `docs/work/experts.md`다. +- 분야 지식은 `fe-*` 스킬(`paths`가 걸려 그 분야 파일을 만질 때 목록에 뜬다)이고, 분야 판정은 서브에이전트 `reviewer`에 그 스킬을 렌즈로 준다. 여러 분야면 플러그인 `lead`. 명단은 `docs/work/experts.md`다. - 리뷰 기준은 `docs/work/reference/review-criteria.md`, 절차는 `docs/work/improve.md` 4.1절이다. 세션 규칙은 `docs/work/delegate.md` 4.3절이다. 보고 칸은 `docs/work/README.md` 6절, 말투와 길이는 소유자 전역 설정을 따른다. diff --git a/README.md b/README.md index 28124130..beb1d70b 100644 --- a/README.md +++ b/README.md @@ -218,7 +218,7 @@ export CI=true VITE_COMMIT_SHA="$(git rev-parse HEAD)" VITE_BUILD_ID=local-ci-1 ``` - 기계가 읽는 증거는 `artifacts/` 아래에 쓴다. 생성된 증거는 git이 무시하고, `.gitkeep` 파일이 폴더 구조를 지킨다. -- 한 checkout에서는 게이트를 하나씩 돌린다. 게이트와 증거 검사가 고정된 `dist/`·`artifacts/` 경로를 읽는다. Playwright 실행 둘은 각자 `TEST_RUN_ID`를 주면 한 checkout을 같이 쓸 수 있다. 그 빌드·결과·보고서는 `.tmp/runs//` 아래로 간다. 시험 서버는 늘 빈 포트를 고른다. 변수 목록은 설계서 `docs/design/2026-07-26-frontend-platform-testing-strategy-design.md` 13.6절에 있다. +- 한 checkout에서는 게이트를 하나씩 돌린다. 게이트와 증거 검사가 고정된 `dist/`·`artifacts/` 경로를 읽는다. Playwright 실행 둘은 각자 `TEST_RUN_ID`를 주면 한 checkout을 같이 쓸 수 있다. 그 빌드·결과·보고서는 `.tmp/runs//` 아래로 간다. 시험 서버는 늘 빈 포트를 고른다. 변수 목록의 정본은 `scripts/lib/run-isolation.ts`(`TEST_RUN_ID_VARIABLE`, `TEST_PORT_VARIABLES`)다. 외부 증거가 필요한 게이트: @@ -274,11 +274,12 @@ git merge --no-ff template/ # shared history git merge-recursive -- HEAD template/ # no shared history ``` -- 동기화한 기준점은 프로젝트가 적어 두는 곳에 둔다: `.template-origin`, 또는 자기 잠금 파일(tech-log는 `template.lock.json`의 `sourceRevision`). 범위를 다 받으면 그 끝으로 옮긴다. +- 동기화한 기준점은 받은 범위의 끝 커밋(템플릿 커밋 해시) 하나다. 프로젝트가 적어 두는 곳에 둔다: `.template-origin`, 또는 자기 잠금 파일(tech-log는 `template.lock.json`의 `sourceRevision`). 범위를 다 받고 아래 게이트가 통과하면 그 끝으로 옮긴다. +- 충돌을 풀 때 어느 파일이 제품 몫인지는 [매뉴얼 03 문서](docs/manual/03-outside-feature-folder.md)의 C절(조건이 맞을 때만 사람이 고친다)과 D절(고치지 않는다)이 정본이다. D절의 파일은 템플릿 쪽을 받는다. - 파일이 너무 옮겨졌거나 갈라져서 깨끗하게 고를 수 없으면 diff로 읽고 손으로 적용한다: `git diff ^ -- `. -- 받은 뒤 「검증」 절의 로컬 merge 게이트를 돌리고, **[계약]** 행이 말하는 백엔드·배포 변경을 하고, 태그까지 따라잡았으면 `.template-origin`을 고친다. 받은 수정은 `git revert`로 되돌린다. +- 받은 뒤 「검증」 절의 로컬 merge 게이트를 돌리고, **[계약]** 행이 말하는 백엔드·배포 변경을 하고, 위 기준점을 받은 범위의 끝으로 옮긴다. 받은 수정은 `git revert`로 되돌린다. -결함: 바꾸지 않은 `.template-origin` 커밋 checkout에서 재현되면 템플릿 결함이다. 그 커밋과 재현 방법을 템플릿 repo에 알린다. 템플릿 관리자가 분류하고 CHANGELOG 항목과 함께 수정을 낸다. 프로젝트의 변경이 있어야 재현되는 문제는 프로젝트의 몫이고, 템플릿 수정을 자기 사본에 적용하는 것도 프로젝트의 일이다. +결함: 바꾸지 않은 `.template-origin` 커밋 checkout에서 재현되면 템플릿 결함이다. 템플릿이 주는 선택 기능(opt-in recipe·adapter, `create:feature`가 만든 기능)을 문서대로 켜거나 더한 것만 다르고 재현되는 것도 템플릿 결함이다. 그 커밋, 켠 선택 기능, 재현 방법을 템플릿 repo에 알린다. 템플릿 관리자가 분류하고 CHANGELOG 항목과 함께 수정을 낸다. 프로젝트의 변경이 있어야 재현되는 문제는 프로젝트의 몫이고, 템플릿 수정을 자기 사본에 적용하는 것도 프로젝트의 일이다. ## 규칙과 기여 diff --git a/config/repository-layout.json b/config/repository-layout.json index 5f0f8b35..38523efa 100644 --- a/config/repository-layout.json +++ b/config/repository-layout.json @@ -12,7 +12,7 @@ "sets": { "fixture-copy": "제거·생성 drill과 사본 시험이 복사하는 것(scripts/lib/removal-fixture.ts)", "fixture-documents": "기능을 더하거나 지우는 drill이 문서까지 맞는지 보려고 더 복사하는 문서(scripts/lib/removal-fixture.ts)", - "secret-scan": "비밀값 검사와 공급망 목록의 범위. config/security/secret-scan-policy.json의 trackedRoots가 이 집합과 같아야 한다", + "secret-scan": "비밀값 검사가 꼭 있어야 한다고 보는 루트. config/security/secret-scan-policy.json의 trackedRoots가 이 집합과 같아야 한다. 검사와 공급망 목록 자체는 추적되는 파일 전부와 dist, artifacts/release를 본다(scripts/lib/repository-file-inventory.ts)", "history-free": "이력 문서를 읽으면 안 되는 코드(tests/unit/deletable-history-documents.test.ts)", "scale-source": "규모 증거에서 '지금 코드'를 정하는 입력(scripts/verify-extreme-scale.ts)", "vite-build": "vite build가 읽는 입력(scripts/lib/vite-build-inputs.ts)", diff --git a/docs/architecture/backend-api-and-server-state-contract.md b/docs/architecture/backend-api-and-server-state-contract.md index 86dd5aeb..3caa2c65 100644 --- a/docs/architecture/backend-api-and-server-state-contract.md +++ b/docs/architecture/backend-api-and-server-state-contract.md @@ -1,11 +1,11 @@ # Backend API와 Server State handoff contract -> **정본 안내 (non-authoritative for runtime capability decisions)** +> **정본 안내** > > Runtime Config/boot, Fetch HTTP client, Router, Query/Mutation, realtime 공통 경계, Web Worker, -> Service Worker, offline command와 Background Sync의 구현 결정은 -> [프론트엔드 런타임 Capability 저장소 정합형 구현 결정 폐쇄 상세 설계](../design/2026-07-30-frontend-runtime-capability-repository-aligned-implementation-closed-deep-design.md)가 정본이다. -> 본 문서의 해당 서술이 정본과 충돌하면 정본을 따른다. +> Service Worker, offline command와 Background Sync의 지금 구현은 +> [프론트엔드 애플리케이션 기반](frontend-application-foundation.md)과 `src/bootstrap/`이 정본이다. +> 설계 배경(기록)은 [프론트엔드 런타임 Capability 저장소 정합형 구현 결정 폐쇄 상세 설계](../design/2026-07-30-frontend-runtime-capability-repository-aligned-implementation-closed-deep-design.md)다(1112/02-06). - 상태: frontend handoff 설계는 승인됨, backend 구현·증거는 대기 중. 단 4.1·6·6.1절(Envelope 읽기, effect 판정, 쓰기 전 거절 표)은 지금 실행 규칙이다(`COMPOSED`, `src/adapters/http/backend-envelope.ts`) diff --git a/docs/architecture/capability-consumer-experience.md b/docs/architecture/capability-consumer-experience.md index 1d5f65ff..88c10350 100644 --- a/docs/architecture/capability-consumer-experience.md +++ b/docs/architecture/capability-consumer-experience.md @@ -20,7 +20,7 @@ feature가 소유한 경계 코드와 application 코드는 다음 네 파일이 - `adapters/-http-gateway.ts` - `adapters/create--feature-input.ts` -이 문서는 이 파일들의 줄 수를 적어 두지 않는다. 손으로 적은 줄 수가 코드와 어긋난 적이 있다(리뷰 14-07). +이 문서는 이 파일들의 줄 수를 적어 두지 않는다. 손으로 적은 줄 수가 코드와 어긋난 적이 있다(리뷰 0925/14-07). 생성한 feature에서 이 네 파일에 `wc -l`을 돌려 잰다. 중요한 경계 지표는 단순 합계가 아니다. 이 파일들이 플랫폼에 대해 무엇을 알아야 하는지다. diff --git a/docs/architecture/layers.md b/docs/architecture/layers.md index 6a1e3778..f93d60ca 100644 --- a/docs/architecture/layers.md +++ b/docs/architecture/layers.md @@ -103,7 +103,7 @@ adapter가 presentation까지 들어온다. 행이 규칙을 맞게 설명하는지는 보지 않는다. 모든 예외는 규칙 자체(`.dependency-cruiser.json`)에 적는다. 예외 경로는 -`pathNot`에, 이유·owner·다시 볼 조건은 `comment`에 적는다(리뷰 12-07). +`pathNot`에, 이유·owner·다시 볼 조건은 `comment`에 적는다(리뷰 0925/12-07). kernel 말고 예외는 다음과 같다: - 지금 설치된 registry를 읽는 범용 presentation 모듈 @@ -144,7 +144,7 @@ kernel 말고 예외는 다음과 같다: 경계다. 규칙의 도착점 정규식은 이 두 서브배럴만 배럴로 인정한다. 다른 그룹의 2단계 `index.ts`(예: `http/internals/index.ts`)는 공개 배럴이 아니고, 그룹 바깥에서 -import하면 실패한다(리뷰 12-07, `dependency-graph/barrel` fixture). +import하면 실패한다(리뷰 0925/12-07, `dependency-graph/barrel` fixture). `service-worker/index.ts`는 `tsconfig.service-worker.json`의 `exclude`에 들어 있다. 그 설정이 그룹 폴더를 통째로 WebWorker lib로 컴파일하면서 페이지 @@ -165,7 +165,7 @@ output 경계를 구현한다. `check:architecture`는 TypeScript를 이해하는 아래 그래프를 출력한다. 규칙은 `.dependency-cruiser.json`에서 읽지만 dependency-cruiser를 돌리지는 않는다. dependency-cruiser는 TypeScript 7을 파싱하지 못해 모듈을 하나도 검사하지 -못했다(리뷰 12-05): +못했다(리뷰 0925/12-05): ```json { @@ -186,7 +186,7 @@ dependency-cruiser는 TypeScript 7을 파싱하지 못해 모듈을 하나도 그래프는 TypeScript와 TSX를 읽는다. static, dynamic, type, CommonJS, JSDoc import 참조를 모두 포함한다. `import.meta.glob`은 파싱 실패로 처리한다. 모듈 이름을 적지 않고 모듈을 불러오므로 어떤 간선 규칙도 그 모듈을 볼 수 -없기 때문이다(리뷰 12-06). 그래프는 `.dependency-cruiser.json`의 경로 규칙을 +없기 때문이다(리뷰 0925/12-06). 그래프는 `.dependency-cruiser.json`의 경로 규칙을 적용한다. 로컬 소스 import에는 TypeScript 확장자를 명시하도록 요구한다. 다음 중 하나라도 있으면 통과시키지 않고 실패한다(fail closed): JavaScript 계열 소스·specifier, 지원하지 않는 규칙 모양, 해석되지 않은 import, 파싱 실패, diff --git a/docs/architecture/optional-adapter-recipes.md b/docs/architecture/optional-adapter-recipes.md index 98803fbd..19e66d3b 100644 --- a/docs/architecture/optional-adapter-recipes.md +++ b/docs/architecture/optional-adapter-recipes.md @@ -201,7 +201,7 @@ Web Push를 함께 설치하지 않는다. 9. runtime config schema, 의존성 inventory/승인, SBOM, bundle budget, browser support와 runbook을 갱신한다. 운영 CSP(`config/hosting/security-headers.json`)도 여기서 넓힌다. 기본 CSP는 - 아래 기능을 막는다(리뷰 13-08). + 아래 기능을 막는다(리뷰 0925/13-08). - 다른 origin의 realtime: `connect-src`에 `wss://`을 더한다. `https:`는 `wss:`를 허용하지 않는다(CSP3 scheme 비교). - 파일 preview(`src/adapters/browser-files/object-url-lease.ts`의 object URL): @@ -229,14 +229,80 @@ Web Push를 함께 설치하지 않는다. 복구한다. - Web Push permission은 user action에서만 요청하고 subscription endpoint/key와 payload를 storage, URL, telemetry나 application state에 노출하지 않는다. -- detailed status, target contract와 구현 work package는 - [Realtime events, Web Push, and bounded polling](../design/2026-07-30-realtime-events-web-push-and-bounded-polling-design.md)을 - 따른다. 현재 concrete runtime과 product selection은 없다. +- 설계 배경(기록)은 + [Realtime events, Web Push, and bounded polling](../design/2026-07-30-realtime-events-web-push-and-bounded-polling-design.md)이다. + 현재 concrete runtime과 product selection은 없다. - 짝 백엔드 템플릿의 실시간 출구(STOMP-over-SockJS, NDJSON)와 이 repo의 SSE· `realtime.v1` WebSocket 어댑터는 그대로 연결되지 않는다. 지금 두 템플릿만으로 - 되는 경로는 bounded polling이다. 대응표와 push를 고를 때의 세 길은 설계 문서 - [0.1절](../design/2026-07-30-realtime-events-web-push-and-bounded-polling-design.md#01-짝-백엔드-템플릿과의-대응-110304-02)에 - 있다(1103/04-02). + 되는 경로는 bounded polling이다. 대응표와 push를 고를 때의 세 길은 아래 + 「짝 백엔드 실시간 출구와의 대응」이다(1103/04-02). +- bounded polling의 `execute`가 실행기 결과를 poll attempt 결과로 바꾸는 표는 아래 + 「poll attempt 결과 대응」이다(1106/04-02). + +#### 짝 백엔드 실시간 출구와의 대응 + +2026-11-08에 설계서가 기록(`docs/design/`)으로 옮겨진 뒤에도 지금 규칙인 표라 여기로 옮겼다(1112/09-02). + +결론: 짝 백엔드(`clean-architecture-backend-template`)의 실시간 출구와 이 +repo의 SSE·WebSocket 어댑터는 **지금 그대로 연결되는 조합이 없다.** 지금 두 +템플릿만으로 되는 경로는 bounded polling 하나다. push가 필요하면 한쪽에 새 코드를 +써야 하고, 어느 쪽을 쓸지는 제품이 정한다. + +```text +프론트 SSE 어댑터 → Accept: text/event-stream, REALTIME_EVENT_V1 envelope +프론트 WS 어댑터 → subprotocol 정확히 "realtime.v1", REALTIME_EVENT_V1 envelope +짝 백엔드 STOMP 채널 → SockJS /ws, /topic 구독 1개, Map 투영, 재전송 없음 +짝 백엔드 스트리밍 → NDJSON, JSON text sequence(RFC 7464). SSE writer는 없다 +``` + +| 프론트 transport | 짝 백엔드 출구 | 지금 연결되나 | 이유 | +| --- | --- | --- | --- | +| SSE (`fetch-sse-connection.ts`) | 없음 | 아니오 | 백엔드에 SSE writer가 없다(`StreamMediaType.SSE`는 OpenAPI 생성기만 쓴다). 아키텍처 테스트가 MVC `SseEmitter`를 금지한다(`ForbiddenApiArchitectureTest` `NO_SSE_EMITTER`, 백엔드 결정 D3). 스트리밍 writer는 NDJSON·JSON text sequence뿐이다(`clean-architecture-backend-template/src/adapter/inbound/web-advanced/README.md`) | +| WebSocket (`websocket-connection.ts`) | STOMP-over-SockJS 채널 | 아니오 | 프론트는 협상된 subprotocol이 정확히 `realtime.v1`이어야 연다(`websocket-protocol.ts`). 백엔드에는 subprotocol 협상 코드가 없다. STOMP frame은 `REALTIME_EVENT_V1` envelope(streamEpoch, sequence, eventId, scopeBinding)이 아니다 | +| WebSocket | raw WebSocket 라이브러리 API(`servlet/`) | 아니오(새 코드 필요) | 서비스 어댑터가 handler를 직접 조립한다. `realtime.v1` 협상과 envelope을 구현한 예시는 없다 | +| bounded polling (`bounded-poll-coordinator.ts`) | REST GET + Envelope | **예** | V3 실행기가 짝 백엔드 Envelope을 읽는다. poll 전용 operation의 `retryBudget`을 0으로 둔다(설계서 9.2절) | + +push가 필요할 때 고를 길(제품 결정, 리뷰 1103/04-02 결정의 근거): + +1. **백엔드에 `realtime.v1` WebSocket handler를 쓴다.** 프론트 어댑터를 그대로 + 쓰고 `CURSOR` 복구까지 갈 수 있다. 백엔드에 sequence·replay 저장소(outbox)가 + 필요하다. SSE는 백엔드 결정 D3을 먼저 바꿔야 하므로 이 표에서는 WebSocket을 + 먼저 적는다. +2. **프론트에 STOMP transport를 쓴다.** 백엔드는 그대로다. STOMP frame에는 + sequence·epoch가 없어 stream coordinator의 gap·cursor 기능을 못 쓴다. frame을 + query 무효화 hint로만 쓰고 데이터는 snapshot(REST GET)으로 다시 읽는다 + (`INVALIDATION_HINT` + `SNAPSHOT_ONLY`). simple broker는 재전송이 없으므로 + 연결이 끊긴 동안의 변경은 재연결 뒤 snapshot으로만 회복한다. +3. **push 없이 bounded polling만 쓴다.** 두 repo 모두 새 코드가 없다. freshness는 + poll 주기(최소 5초)로 정해진다. + +다시 볼 때: 백엔드에 `realtime.v1` handler나 SSE writer가 생기거나, 프론트에 STOMP +transport가 생기면 이 표를 고친다. 백엔드 쪽 정본은 +`clean-architecture-backend-template/src/adapter/inbound/websocket/README.md`다. + +#### poll attempt 결과 대응 + +`execute`는 실행기 결과를 아래 표대로 poll attempt 결과로 바꾼다(1106/04-02). +poll이 재시도하는 kind는 `retryable: true`인 `CONNECT_TIMEOUT`·`RATE_LIMITED`· +`PROVIDER_UNAVAILABLE`뿐이고, `retryAfterMs`는 뒤 둘만 읽는다. + +| V3 결과 `kind` | poll attempt 결과 | +| --- | --- | +| `SUCCESS` | `ok: true`, `kind: "VALUE"`, `value`, terminal 판정에 쓸 `state`. 결과에 본문 크기가 없으므로 `responseBytes`는 `0`을 둔다. 본문 상한은 실행기가 `frontend.responseByteLimit`으로 지킨다(넘으면 `CONTRACT_VIOLATION`). 그래서 poll descriptor의 `responseByteLimit`을 lease `maxResponseBytes` 이하로 둔다 | +| `PROBLEM` | `metadata.status`가 5xx·`408`·`425`이면 `PROVIDER_UNAVAILABLE`, `retryable: true`, `retryAfterMs`는 `metadata.retryAfterMs`. 그 밖의 status는 다시 보내도 같은 답이라 `PROTOCOL_MISMATCH`, `retryable: false`. 설계서 9.4절의 reset 계약이 있는 `409`·`410`만 `CURSOR_EXPIRED`, `retryable: false` | +| `UNAUTHENTICATED` | `AUTH_REQUIRED`, `retryable: false`. lease가 끝나고, session owner가 회복한 뒤 새 lease를 연다(설계서 9.3절) | +| `FORBIDDEN` | `FORBIDDEN`, `retryable: false` | +| `RATE_LIMITED` | `RATE_LIMITED`, `retryable: true`, `retryAfterMs`는 결과의 `retryAfterMs` | +| `CONTRACT_VIOLATION` | `metadata.status`가 5xx·`408`·`425`이면 쓸 수 있는 problem 본문 없이 온 서버 장애라 `PROBLEM`의 장애 행과 같다. 그 밖(입력 거절 `INPUT_INVALID`, 응답 schema·크기 위반)은 `PROTOCOL_MISMATCH`, `retryable: false` | +| `TRANSPORT_FAILURE` | `failure.kind`가 `TIMEOUT`이면 `CONNECT_TIMEOUT`, `retryable: true`. `ABORTED_BY_CALLER`면 `ABORTED`, `ABORTED_BY_SCOPE`면 `SCOPE_FENCED`, 둘 다 `retryable: false`. 나머지(`NETWORK_FAILURE` 등)는 `PROVIDER_UNAVAILABLE`, `retryable: true`. 실행기가 끝낸 transport 실패의 `failure.retryable`은 모두 `false`라 옮기지 않는다 | +| `CANCELLED` | `ABORTED`, `retryable: false` | +| `AUTH_INTEGRATION_FAILURE` | `reason`이 `CREDENTIAL_OWNER_UNAVAILABLE`이면 `PROVIDER_UNAVAILABLE`, `retryable: true`. 그 밖은 구성 결함이라 `PROTOCOL_MISMATCH`, `retryable: false`. 어느 쪽도 로그아웃 경로로 보내지 않는다 | + +실패 결과의 `operation`은 모두 `"POLL"`이다. `retryAfterMs`는 값이 있을 때만 +칸을 둔다. 값이 `undefined`인 칸은 모양이 틀린 결과라 lease가 `PROTOCOL_MISMATCH`로 +끝난다. lease 상태 검사가 결과 해석보다 먼저라, 그사이 hidden·offline·scope +변경·close가 있었으면 표와 상관없이 그 kind로 끝난다. 이 표를 따르는 조합 예는 +`tests/unit/realtime/bounded-poll-coordinator.test.ts`의 `pollAttemptResult`다. - realtime 레지스트리(`createRealtimePolicyRegistry`)가 받는 세 바인딩의 출처 (1103/04-06). 기능 모듈에는 codec·mapper를 낼 칸이 없으므로 조합 코드가 모은다. - `apiOperations`: `loadInstalledFeatureRuntimeRegistries().apiOperations` diff --git a/docs/architecture/starter-experience.md b/docs/architecture/starter-experience.md index a0de081b..5bbed5a5 100644 --- a/docs/architecture/starter-experience.md +++ b/docs/architecture/starter-experience.md @@ -80,8 +80,9 @@ TypeScript로 쓴 owner는 `ExternalSessionOwner`에 맞춰 더는 컴파일되 ## 스타터 확장 새 플랫폼 작업은 따로 노는 라우트 규칙이나 데이터 로딩 규칙을 하나 더 만들지 않는다. -대신 [라우팅, 페이지 템플릿, 재사용 패턴](../design/2026-07-26-routing-pages-and-patterns-design.md)과 -[TypeScript, 상태, 데이터 흐름 목표](../design/2026-07-26-typescript-state-and-data-flow-design.md)를 따른다. +대신 지금 규칙인 [기능 매뉴얼의 패턴 표](../manual/reference/patterns.md)와 [계층 규칙](layers.md)을 따른다. +설계 배경(기록)은 [라우팅, 페이지 템플릿, 재사용 패턴](../design/2026-07-26-routing-pages-and-patterns-design.md)과 +[TypeScript, 상태, 데이터 흐름 목표](../design/2026-07-26-typescript-state-and-data-flow-design.md)다. ### 스타터 화면 바꾸기 diff --git a/docs/architecture/static-delivery.md b/docs/architecture/static-delivery.md index 74ed06e8..9431c129 100644 --- a/docs/architecture/static-delivery.md +++ b/docs/architecture/static-delivery.md @@ -1,11 +1,11 @@ # 정적 자산과 runtime 설정 전달 -> **정본 안내 (runtime capability 결정의 정본이 아니다)** +> **정본 안내** > > Runtime Config/boot, Fetch HTTP client, Router, Query/Mutation, realtime 공통 경계, Web Worker, -> Service Worker, offline command와 Background Sync의 구현 결정은 -> [프론트엔드 런타임 Capability 저장소 정합형 구현 결정 폐쇄 상세 설계](../design/2026-07-30-frontend-runtime-capability-repository-aligned-implementation-closed-deep-design.md)가 정본이다. -> 본 문서의 해당 서술이 정본과 충돌하면 정본을 따른다. +> Service Worker, offline command와 Background Sync의 지금 구현은 +> [프론트엔드 애플리케이션 기반](frontend-application-foundation.md)과 `src/bootstrap/`이 정본이다. +> 설계 배경(기록)은 [프론트엔드 런타임 Capability 저장소 정합형 구현 결정 폐쇄 상세 설계](../design/2026-07-30-frontend-runtime-capability-repository-aligned-implementation-closed-deep-design.md)다(1112/02-06). 이 Mermaid 그림은 repo 안에서 구현을 옮겨 그린 투영(projection)이다. @@ -34,7 +34,7 @@ smoke 단계는 프로젝트의 provider adapter가 맡는다. 그 adapter가 `p `production_gate` 사이의 `deployment` job을 채운다. adapter가 promotion된 release를 배포하고 나면, FE-GATE-019가 실제 응답 header를 검사하고 host가 그 release를 서빙하는지 확인한다. 그 자리가 비어 있는 동안 FE-GATE-019는 -`UNVERIFIED`다(리뷰 13-05, 1101/13-01, +`UNVERIFIED`다(리뷰 0925/13-05, 1101/13-01, [`release-cache-rollback.md`](../operations/release-cache-rollback.md)). rollback은 이전 불변 release의 HTML·asset·config·API·manifest 묶음이 서로 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 40f7401a..6ed3ba21 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 @@ -4,7 +4,7 @@ - 상태: 확인 안 함 - 작성일: 2026-07-30 - 요약: SSE·WebSocket·Web Push·제한된 Polling을 도입할 때의 선택 기준, 포트 경계, 이벤트 계약, 재연결·복구와 승격 조건을 정한 설계다. -- 현재 정본: `src/adapters/realtime/`, `src/adapters/web-push/` +- 현재 정본: `src/adapters/realtime/`, `src/adapters/web-push/`, `docs/architecture/optional-adapter-recipes.md` 「짝 백엔드 실시간 출구와의 대응」·「poll attempt 결과 대응」(0.1절과 9.2절의 표) # Realtime events, Web Push, and bounded polling diff --git a/docs/manual/01-add-a-feature.md b/docs/manual/01-add-a-feature.md index d298aeb7..6426b46a 100644 --- a/docs/manual/01-add-a-feature.md +++ b/docs/manual/01-add-a-feature.md @@ -429,7 +429,7 @@ projectRequest: (input) => Object.freeze({ - `context-routes.ts`: context가 적재하는 라우트 목록. 생성된 판은 계약의 라우트를 그대로 옮긴다. - `presentation/-routes.ts`: 링크용 URL 함수. route ID를 받아 `buildRouteUrl`(`src/presentation/routes/route-codecs.ts`)로 경로를 채운다. - 문구 `route..title`, `route..navigation` (ko-KR, en-US). 화면의 문서 제목과 메뉴 이름은 이 문구다. - - 계약 `routes`의 `title`·`navigationLabel`은 화면이 읽지 않는다. FE-REG-ROUTE 기준선 행과 lab 측정(`scripts/test-performance.ts`, 플랫폼 라우트만)이 읽는다. 생성 명령은 문구와 같은 값을 넣는다. 값을 바꾸면 `check:registries`가 behavior-change로 기록한다. + - 계약 `routes`의 `title`·`navigationLabel`은 화면이 읽지 않는다. FE-REG-ROUTE 기준선 행과 lab 측정이 읽는다: 공개 기능 라우트 중 `navigationLabel`이 있는 첫 라우트를 재고(`scripts/lib/lab-performance.ts` `labFeatureRoute`), 그 링크와 제목을 그 값으로 찾는다(`scripts/test-performance.ts`). 생성 명령은 문구와 같은 값을 넣는다. 값을 바꾸면 `check:registries`가 behavior-change로 기록한다. - 기능 폴더 밖: `docs/accessibility/route-reviews/.md`(pending 기록). 생성 명령이 만든다. ① **정할 것** @@ -814,4 +814,4 @@ corepack pnpm test:sample-removal -- --feature=invoice-feature - 브라우저 테스트(`playwright test`)를 한 checkout에서 둘 이상 동시에 돌릴 때는 실행마다 다른 `TEST_RUN_ID`를 준다. 예: `TEST_RUN_ID=a corepack pnpm exec playwright test`. 그 실행의 빌드·결과·report는 `.tmp/runs//` 아래에 생긴다. - 서버 포트는 run ID가 없어도 빈 포트를 고른다. 같은 기계의 두 worktree도 부딪히지 않는다. 고정하려면 `TEST_E2E_PORT` 같은 포트 변수를 준다. - `ci:gate`에는 `TEST_RUN_ID`를 주지 않는다. 주면 증거가 기본 경로에 생기지 않아 게이트가 `command-generated evidence was not freshly produced`로 실패한다. - - 변수 표와 한계는 [테스트 전략 13.6절](../design/2026-07-26-frontend-platform-testing-strategy-design.md)에 있다(1105/12-04). + - 변수 목록의 정본은 `scripts/lib/run-isolation.ts`(`TEST_RUN_ID_VARIABLE`, `TEST_PORT_VARIABLES`)다. 설계 배경(기록)은 [테스트 전략 13.6절](../design/2026-07-26-frontend-platform-testing-strategy-design.md)이다(1105/12-04). diff --git a/docs/manual/03-outside-feature-folder.md b/docs/manual/03-outside-feature-folder.md index c1f82f7d..16e92bd7 100644 --- a/docs/manual/03-outside-feature-folder.md +++ b/docs/manual/03-outside-feature-folder.md @@ -122,7 +122,7 @@ release admission refused for staging: - `label`은 `browser-files` 같은 소문자 kebab-case 토큰으로 쓴다. 다른 형식이면 조립이 `TypeError`로 멈춘다. - `close`가 던지면 scope가 `FAILED`에 머물고 모든 서버 요청이 `SCOPE_FENCED`로 막힌다. 진단 `cache.operation.failed`에 `reason: PARTICIPANT_FAILED`와 `scope_participant: