Files
clean-architecture-frontend…/docs/operations/adapter-remediation-ledger.md
T
DongHyeonka e9e98b8aa7 Merge branch 'main' into claude/fe-b-docs-korean-645f55
정리 3·4단계 PR #14와 CI 재편 PR #16(main 38c0dc7d)을 받는다. 충돌은 아홉
파일이다. 이 브랜치가 한국어로 다시 쓴 문서에 두 PR이 영어 판에서 바꾼
것을 한국어로 넣었다.
- a11y 기록 경로 `artifacts/tests/a11y-manual/` → `docs/accessibility/route-reviews/`:
  README, docs/README.md, manual-checklist, starter-experience,
  ci-quality-gates. 문서 검사의 `NOT_DOCUMENT`도 새 경로로 바꿨다(정해진 영어
  키 형식의 게이트 입력이라 문서로 보지 않는다)
- ci-quality-gates.md: merge 단계 job 셋, 지운 CI 계약 기준선, main 단계
  FE-GATE-029의 `check:ci:gating`
- adapter 재검토 원장: 합친 음성 fixture script
- README 프로젝트 구조: `schemas/`는 `config/schemas/`로, `artifacts/`는
  `.gitkeep`만 추적, 최상위 항목 등록부 `config/repository-layout.json`
- verify-documentation-readiness.ts: #14의 배치 규칙 검사(R6·R7)와 이 브랜치의
  문서 체계 검사를 둘 다 둔다. R7의 「현재 문서」는 #14의 폴더 목록(옛
  `docs/superpowers/` 포함) 대신 문서 검사의 `checkedForDrift`로 고른다
- deletable-history-documents 시험: #14의 등록부 기반 경로와 이 브랜치의
  검사기 예외를 같이 둔다
- CHANGELOG: 범위 문장과 표 행을 둘 다 둔다
- 루트 등록부에서 SPEC.md 항목을 뺀다(그 항목이 「문서 체계 작업이 이력 폴더로
  옮기고 이 항목을 뺀다」고 적었다)
- #14가 옛 `docs/testing/frontend-platform-testing-strategy.md`를 고친 것이
  이름 바뀜을 따라 기록(docs/design/…)에 들어와서, 기록은 옮길 때의 글로 되돌렸다
2026-11-12 04:53:06 +09:00

73 KiB
Raw Blame History

Adapter 수정 원장

docs/reviews/adapters/에서 확인된 모든 발견(finding)의 실행 상태를 적는 정본이다.

계획: 2026-08-13 adapter 수정 계획. docs/history/plans 아래의 작업 이력 계획이고, 복사한 프로젝트는 지워도 된다(README 「복사한 뒤 지워도 되는 것」). 기준 리비전: develop / 4dc033cf33a5b6173bbf960d5eb464a406dc4c92.

테스트 경로는 지금 위치로 적는다. 이 실행들 뒤에 테스트 파일 두 개가 옮겨졌다. ci-artifact-contract.test.ts는 tests/unit/에서 tests/system/ci-runner/로, provider-guardian-transaction.test.ts는 tests/unit/에서 tests/integration/로 옮겼다. 2026-09-18(5cc41467, ec7f20e2)에 테스트 파일 세 개를 나눴고, 세 번째 재검토의 행은 옮겨 간 테스트를 따른다. TR-02는 presigned-transfer-delivery.test.ts로, TR-03의 image probe는 image-cdn-browser-probe.test.ts로, TR-04는 resumable-upload-runtime-teardown.test.ts로 갔다(모두 tests/unit/ 안). 앞 절들의 실행 명령은 그 실행이 쓴 파일을 그대로 적는다.

격리 상태 (계획 Task 1, Step 1)

기준 리비전에서 돌린 검색:

rg -n "createBrowserOpfsRuntime|createBrowserFileRuntime|createPublicResponseCache|createBrowserRpcRuntime|createWebPush|createServiceWorker|createResumableUpload|createImageCdn" src recipes tests
rg -n "AVAILABLE_NOT_COMPOSED|DESIGNED_NOT_IMPLEMENTED|NOT_SELECTED" docs/architecture src/bootstrap

결과:

Capability 템플릿 기본 조립 여부 격리(containment) 조치
OPFS 바이트 저장소 (createBrowserOpfsRuntime) 조립하지 않는다. recipes/frontend-capabilities/*만 contract/fake 코드에서 "OPFS" backend 리터럴을 참조한다. 필요 없다. V1 writer를 받아들이지 않으므로 kill switch를 새로 만들지 않는다.
브라우저 파일 runtime src/bootstrap/**에서 조립하지 않는다. 없음.
공개 응답 캐시 조립하지 않는다. tests/unit/public-response-cache.test.ts만 이것을 만든다. 없음.
Browser RPC runtime 조립하지 않는다. AVAILABLE_NOT_COMPOSED. 없음.
Web Push 조립하지 않는다. NOT_SELECTED / AVAILABLE_NOT_COMPOSED. 없음.
재개 가능 업로드(resumable upload) / image CDN 조립하지 않는다. 테스트에서만 만든다. 없음.
Service Worker runtime host src/bootstrap/optional-runtime-host.ts → createServiceWorkerRuntimeHost로 조건부 조립한다. ResolvedRuntimeCapabilities가 켜고 끈다. 그대로 둔다. Task 14가 선택은 바꾸지 않고, 보고 값이 사실과 맞도록 고친다.
Realtime src/bootstrap/optional-runtime-host.ts:91이 realtime을 realtime: null로 두고 NOT_SELECTED로 유지한다. 없음.

이 저장소에는 템플릿 기본 말고 제품 전용 composition root가 없다. 그래서 막아야 할 OPFS V1 쓰기 허용 경로도 없다.

기준 게이트 (계획 Task 1, Step 3)

소스를 바꾸기 전에 기준 리비전에서 기록했다.

명령 종료 코드 결과
corepack pnpm check:types 0 app, node, test, recipes, web-worker, service-worker 프로젝트가 모두 통과한다.
corepack pnpm lint 0 --max-warnings=0로 경고 없음.
corepack pnpm check:architecture 0 모듈 286개, 의존 854개, import 해석 실패 없음. graph fixture 12개 PASS. TS-only 정책 PASS. 허용 PASS / 금지 9개 거부.
corepack pnpm test:unit 1 테스트 파일 110개 통과 / 1개 실패. 테스트 1496개 통과 / 19개 실패(전체 1515개), 150.92s.

test:unit 실패 원인

실패하는 파일은 tests/system/ci-runner/ci-artifact-contract.test.ts 하나다. 실패 19건은 모두 sandbox 실행 환경의 자식 프로세스, cgroup, 파일 시스템 권한 동작에서 나왔다. adapter 코드 탓이 아니다. 실행 로그에서 기록한 원인 원문:

Error: ENOENT: no such file or directory, open '/proc/1325422/task/1325422/children'
Error: provider output did not reach expected content: /tmp/ci-provider-upload-J9hxXD/provider-evidence/untrusted/vulnerability-report.json
Error: provider scope survived completion: ca-provider-vulnerability-1326812-f4869853ef09ea2c2c95cd01.scope
Error: EACCES: permission denied, open '/tmp/ci-captured-archive-OWTs7M/candidate.tar.gz'
Error: Test timed out in 10000ms.
AssertionError: expected 5714 to be less than 5000
AssertionError: expected [] to deeply equal ArrayContaining{…}

리뷰 색인에 이미 적힌 환경 메모와 같다. adapter 실패로 바꾸지 않고, 통과(green)로도 보지 않는다. 아래의 모든 adapter 작업은 adapter 중심 테스트 파일을 통과 상태로 유지해야 하고, 이 파일의 실패 수를 늘리면 안 된다.

발견 원장

Activation 열은 그 발견이 지금 템플릿 실행 경로에서 닿는지(활성화 여부)를 적는다. Rollout 상태는 NOT_STARTED에서 시작한다. 문서에 미구현으로 적힌 항목은 PROMOTION_BLOCKED에서 시작하고, DEFECT로 표시하지 않는다.

네트워크와 상태 (docs/reviews/adapters/01-network-and-state.md)

ID Activation 실패 테스트(red test) 명령 수정 커밋/PR Rollout 상태 Rollback 기준 증거
N-01 실행 중인 V3 경로 corepack pnpm exec vitest run tests/integration/http-execution-v3-observability.test.ts fix: restore V3 HTTP observability FIXED_NOT_RELEASED diagnostics/telemetry producer 게이트 회귀 실패 5/5 → 통과 5/5. check:diagnostics PASS(diagnostic 8개, telemetry producer 5개). check:types PASS. check:architecture PASS
N-02 실행 중인 V3 경로 corepack pnpm exec vitest run tests/integration/http-execution-v3-auth-profile.test.ts fix: enforce installed HTTP auth profiles FIXED_NOT_RELEASED profile 강제 뒤 인증 요청 4xx 급증 실패: 테스트 파일이 로드되지 않음(installRestAuthProfileRegistry 없음) → 통과 7/7. check:types PASS. check:architecture PASS. lint PASS. unit+integration+features 1560개 통과, 실패는 원래 있던 환경 탓 ci-artifact-contract 실패뿐
N-03 실행 중인 V3 경로 corepack pnpm exec vitest run tests/unit/http-execution-v3.test.ts -t "retry-time fence" fix: preserve command effect certainty across retries FIXED_NOT_RELEASED command effect 판정 회귀 실패: 시도 한 번을 보낸 뒤 NOT_STARTED와 함께 SCOPE_FENCED가 재현됨 → 통과 MAYBE_APPLIED. lattice 표 9/9. check:types PASS. lint PASS
N-04 실행 중인 조립의 정리(teardown) corepack pnpm exec vitest run tests/unit/telemetry.test.ts tests/unit/runtime-adapters.test.ts fix: terminate telemetry work on disposal FIXED_NOT_RELEASED teardown 변경 뒤 telemetry 전달 유실 실패 10개(lifecycle 5 + capacity 5) → 통과 34/34. check:diagnostics PASS. check:types PASS. check:architecture PASS. lint PASS
N-05 Rollout 차단 요인(sidecar 조립 안 됨) corepack pnpm exec vitest run tests/unit/conditional-validator-store.test.ts fix: harden bounded state sidecars FIXED_NOT_RELEASED 저장된 validator 키 비호환 실패: 충돌 사례(올바른 binding 두 개가 구분자로 이은 키 하나를 공유) → 통과. 키는 이제 크기가 제한되고 검증된 tuple이며 JSON.stringify로 인코딩한다
N-06 구 V2 rollback 경계(seam) V2 client 테스트 tests/integration/http-client.test.ts(2026-11-03에 V2 client와 함께 지웠다) fix: harden the legacy HTTP rollback path FIXED_NOT_RELEASED 구 keyed command 거부 급증 실패: 잘못된 키 사례 4개 → 통과. credential과 fetch 전에 거부한다(credential 호출 0회, fetch 0회)
N-07 구 V2 rollback 경계(seam) V2 client 테스트 tests/integration/http-client.test.ts와 tests/integration/auth-recovery.test.ts(2026-11-03에 V2 client와 함께 지웠다) fix: harden the legacy HTTP rollback path FIXED_NOT_RELEASED 구 credential timeout 회귀 실패: 끝나지 않는 owner → 통과. credential 대기가 기존 attempt controller와 경주(race)하므로 타이머를 더 만들지 않는다. 소유권은 fetch 0회로 REQUEST_TIMEOUT / REQUEST_ABORTED / AUTH_INTEGRATION_FAILURE에 대응한다
N-08 구 V2 rollback 경계(seam) V2 bounded JSON 테스트 tests/unit/bounded-json-compatibility.test.ts(2026-11-03에 V2 client와 함께 지웠다) fix: harden the legacy HTTP rollback path FIXED_NOT_RELEASED 구 JSON 실패 코드 drift 통과 7/7(예외를 던지는 cancel/releaseLock 포함). readBoundedJson은 이제 구 코드를 그대로 두고 bounded-body-reader에 맡긴다
N-09 실행 중인 cross-context host corepack pnpm exec vitest run tests/unit/cross-tab-invalidation.test.ts fix: harden bounded state sidecars FIXED_NOT_RELEASED cross-tab 무효화 유실 실패: 다른 영역의 pulse를 받아들임 → 통과 13/13. localStorage를 한 번만 잡고 StorageEvent.storageArea를 객체 동일성으로 비교한다. pulse 키는 CACHE_INVALIDATION_PULSE로 등록했다. check:registries PASS
N-10 Cursor runtime AVAILABLE_NOT_COMPOSED corepack pnpm exec vitest run tests/unit/cursor-pagination-runtime.test.ts fix: harden bounded state sidecars FIXED_NOT_RELEASED pagination abort 의미 변경 실패: 끝나지 않는 loader → 통과 PAGINATION_ABORTED, 늦게 온 page는 무시
N-11 실행 중인 조립 corepack pnpm exec vitest run tests/unit/telemetry.test.ts -t capacity fix: terminate telemetry work on disposal FIXED_NOT_RELEASED 올바른 조립에서 capacity 거부 실패: capacity 사례 5/5 → 통과. 상한은 VD-07 §7-4에 적었다

스토리지와 브라우저 파일 (docs/reviews/adapters/03-storage-and-browser-files.md)

ID Activation 실패 테스트 명령 수정 커밋/PR Rollout 상태 Rollback 기준 증거
STO-01 템플릿에서 OPFS 조립 안 됨. 제품 writer가 있으면 Critical corepack pnpm exec vitest run tests/unit/opfs-byte-store.test.ts tests/unit/opfs-worker-runtime.test.ts tests/unit/indexeddb-opfs-journal.test.ts fix: preserve OPFS recovery authority during cleanup FIXED_NOT_RELEASED OPFS reconcile 적체 또는 journal 증가 실패: 새 saga 사례 4개 → OPFS 테스트 파일 3개에서 통과 25/25. check:types PASS(web-worker 포함). check:browser-file-storage-boundaries PASS. lint PASS. test:unit 1511개 통과, 실패는 원래 있던 환경 탓 ci-artifact-contract 실패뿐
STO-02 브라우저 파일 runtime 조립 안 됨 corepack pnpm exec vitest run tests/unit/browser-file-download.test.ts fix: execute canonical browser download targets FIXED_NOT_RELEASED canonical target 때문에 다운로드 이동이 막힘 실패 2개(가공하지 않은 상대 href를 host에 넘김) → 통과 17/17
STO-03 공개 캐시 조립 안 됨 corepack pnpm exec vitest run tests/unit/public-response-cache.test.ts fix: make public cache staging repairable FIXED_NOT_RELEASED 기존 정책을 조립 단계에서 거부 실패: STO-03..05에 걸친 사례 4개 → 통과 21/21. check:types PASS. check:browser-file-storage-boundaries PASS. lint PASS
STO-04 공개 캐시 조립 안 됨 corepack pnpm exec vitest run tests/unit/public-response-cache.test.ts fix: make public cache staging repairable FIXED_NOT_RELEASED restage 반복 또는 대역폭 급증 —
STO-05 공개 캐시 조립 안 됨 corepack pnpm exec vitest run tests/unit/public-response-cache.test.ts fix: make public cache staging repairable FIXED_NOT_RELEASED 필요한 capability 없이 활성화 허용 —
STO-06 IndexedDB 유지보수 corepack pnpm exec vitest run tests/unit/indexeddb-maintenance.test.ts fix: bound migration commits and version the OPFS worker protocol FIXED_NOT_RELEASED migration checkpoint 멈춤 실패: commit 단계 deadline 사례 → 통과 13/13. 단조(monotonic) budget을 각 레코드의 첫 쓰기 전에 다시 확인한다. 이미 시작한 레코드는 원자적으로 끝낸다. clock이 실패하면 transaction을 중단한다
STO-07 OPFS worker 프로토콜 corepack pnpm exec vitest run tests/unit/opfs-worker-runtime.test.ts fix: bound migration commits and version the OPFS worker protocol FIXED_NOT_RELEASED page/worker INCOMPATIBLE 급증 OPFS 테스트 파일에서 통과 23/23. 모든 envelope가 OPFS_WORKER_PROTOCOL_VERSION = 2를 담고, 응답은 요청 kind를 그대로 돌려준다. 실패 모양은 엄격한 decoder로 읽는다. kind나 버전이 다르면 UNSUPPORTED로 닫는다. 닫힌 분류(closed taxonomy)에는 INCOMPATIBLE 코드가 없고, 새로 만들지도 않았다
STO-08 가설. 브라우저에서 동작 확인(characterization)이 필요 corepack pnpm exec playwright test --config playwright.capabilities.config.ts tests/browser-capabilities/browser-files.spec.ts 없음(소스 바꾸지 않음) UNVERIFIED 확인 전까지 해당 없음 chromium 2/2 PASS. webkit은 실행되지 않았다(libevent-2.1-7t64, libavif16 없음, 환경 문제). 기존 spec은 Window.showOpenFilePicker/showSaveFilePicker를 실행하지 않는다. 이 둘은 사용자 동작과 네이티브 대화상자가 필요하다. 그래서 receiver-binding 가설은 재현하지도 반박하지도 못했다. SystemPickerHost는 만들지 않았다. 계획은 확인하지 않은 가설을 결함으로 보고 구현하는 것을 금한다.
GAP-01 문서에 미구현으로 적힘(VD-15) promotion 증거(실패 테스트가 아님) — PROMOTION_BLOCKED 해당 없음 —
GAP-02 문서에 미구현으로 적힘(VD-15) promotion 증거(실패 테스트가 아님) — PROMOTION_BLOCKED 해당 없음 —
GAP-03 문서에 미구현으로 적힘(VD-15) promotion 증거(실패 테스트가 아님) — PROMOTION_BLOCKED 해당 없음 —

Realtime과 Browser RPC (docs/reviews/adapters/02-realtime-and-browser-rpc.md)

ID Activation 실패 테스트 명령 수정 커밋/PR Rollout 상태 Rollback 기준 증거
R-01 Browser RPC AVAILABLE_NOT_COMPOSED corepack pnpm exec vitest run tests/unit/browser-rpc/browser-rpc-runtime.test.ts fix: install bounded Browser RPC stream leases FIXED_NOT_RELEASED stream lease 교착 stream 정리에 시간 제한이 있다. generator는 협조하지 않는 iterator.return()을 더는 끝없이 기다리지 않는다
R-02 Realtime NOT_SELECTED corepack pnpm exec vitest run tests/unit/realtime/stream-coordinator.test.ts fix: retain realtime work through draining FIXED_NOT_RELEASED stream이 DRAINING에 멈춤 실패: 끝나지 않는 effect와 recovery → 통과 27/27. 작업이 남아 있는 동안 close()는 IDLE_TIMEOUT을 돌려주고, 실제로 끝난 뒤에만 성공을 돌려준다
R-03 Realtime NOT_SELECTED corepack pnpm exec vitest run tests/unit/realtime/live-poll-handoff-coordinator.test.ts fix: retain realtime work through draining FIXED_NOT_RELEASED retired writer 집합 증가 실패: overflow로 fail-close한 뒤 close() → 통과 11/11. retired writer를 기다리고, 실제로 멈춘 뒤에만 지운다
R-04 Browser RPC AVAILABLE_NOT_COMPOSED corepack pnpm exec vitest run tests/unit/browser-rpc/browser-rpc-contract.test.ts fix: install bounded Browser RPC stream leases FIXED_NOT_RELEASED binding 설치 거부 실패: 검증 뒤 변경, accessor, symbol 사례 → 통과 19/19. getter를 한 번도 부르지 않는다
R-05 WebSocket 프로토콜 codec corepack pnpm exec vitest run tests/unit/realtime/websocket-protocol.test.ts fix: install bounded Browser RPC stream leases FIXED_NOT_RELEASED frame 거부 회귀 실패: 너무 큰 frame이 encoder 사본을 할당함 → 통과 8/8. 바이트 수가 짝 없는 surrogate까지 포함해 TextEncoder와 같다
R-06 Browser RPC AVAILABLE_NOT_COMPOSED corepack pnpm exec vitest run tests/unit/browser-rpc/browser-rpc-runtime.test.ts fix: install bounded Browser RPC stream leases FIXED_NOT_RELEASED 닫힌 실패 분류 drift clock과 fence 읽기 결과를 닫힌 Result 분류로 정규화하고, 정리는 출구 하나에서 한다
R-07 Promotion 차단 요인 실제 transport 적합성 증거 — PROMOTION_BLOCKED 해당 없음 —

브라우저 전송 (docs/reviews/adapters/04-browser-transfer.md)

ID Activation 실패 테스트 명령 수정 커밋/PR Rollout 상태 Rollback 기준 증거
BT-PRE-01 Presigned AVAILABLE_NOT_COMPOSED corepack pnpm exec vitest run tests/unit/presigned-transfer.test.ts fix: lazy presigned download leases FIXED_NOT_RELEASED 다운로드 lease 누수 실패: lazy lease 사례 → 통과 29/29. open()은 네트워크 I/O를 하지 않고, close()는 여러 번 불러도 결과가 같다(idempotent)
BT-PRE-02 wire 계약 빈틈 corepack pnpm exec vitest run tests/unit/presigned-transfer.test.ts fix: complete presigned capability and upload transport contracts FIXED_NOT_RELEASED provider POLICY_REJECTED 급증 실패: protocol 없음/V0/V2 사례 → 통과. 요청은 늘 PRESIGNED_TRANSFER_V1을 선언하고, 맞지 않는 응답은 vault에 등록하기 전에 POLICY_REJECTED로 닫는다
BT-PRE-03 Presigned provider corepack pnpm exec vitest run tests/unit/presigned-transfer.test.ts fix: complete presigned capability and upload transport contracts FIXED_NOT_RELEASED timeout이 fetch를 끊지 못함 실패: 협조하지 않는 fetch → 통과. scope가 작업과 경주하고, 늦게 온 응답 body는 취소하며, 예외를 던지는 scheduler도 listener를 남기지 않는다
BT-PRE-04 Presigned vault corepack pnpm exec vitest run tests/unit/presigned-transfer.test.ts fix: complete presigned capability and upload transport contracts FIXED_NOT_RELEASED issuer/consumer 분리 깨짐 실패: issuer 경계 사례 6개 표 → 통과. vault가 method, href/origin/path 일치, credential, byte, digest, 만료 불변식을 직접 다시 확인한다
BT-PRE-05 Provider 경로 디코딩 corepack pnpm exec vitest run tests/unit/presigned-transfer.test.ts fix: complete presigned capability and upload transport contracts FIXED_NOT_RELEASED 정상 키 거부 실패: %2F, %5C, %252e%252e, 소문자 percent-hex, %00 → 통과. 각 segment는 한 번만 디코딩하고, canonical 대문자 encoder로 다시 인코딩했을 때 원래 값과 같아야 한다
BT-UP-01 Resumable transport corepack pnpm exec vitest run tests/unit/resumable-upload-fetch-transport.test.ts fix: harden resumable upload transport contracts FIXED_NOT_RELEASED signal facade 거부 isAbortSignal은 이제 removeEventListener를 요구하고, release 정리는 따로 격리했다
BT-UP-02 Resumable transport corepack pnpm exec vitest run tests/unit/resumable-upload-fetch-transport.test.ts fix: complete presigned capability and upload transport contracts FIXED_NOT_RELEASED clock 주입 깨짐 clock과 scheduler를 주입받아 snapshot한다. delta-seconds와 HTTP-date 둘 다 같은 시점에 잡은 now로 계산하고, clock이 뒤로 가면 0으로 맞춘다
BT-UP-03 Resumable checkpoint store corepack pnpm exec vitest run tests/unit/resumable-upload-checkpoint.test.ts fix: report unknown IndexedDB delete effects FIXED_NOT_RELEASED pending-delete registry 증가 실패: deadline에 막힌 사례 → 통과 PENDING/UNKNOWN. realm 범위 registry가 partition을 다시 만들지 못하게 막는다
BT-UP-04 Presigned part executor corepack pnpm exec vitest run tests/unit/resumable-upload-checkpoint.test.ts fix: harden resumable upload transport contracts FIXED_NOT_RELEASED 만료 검사 거부 유한하지 않거나 음수인 clock은 만료 검사를 건너뛰지 않고 UNAVAILABLE/RESUME을 돌려준다
BT-UP-05 리팩터링 corepack pnpm exec vitest run tests/unit/resumable-upload-runtime.test.ts — NOT_PERFORMED 동작 기록(characterization) drift 시도했다가 되돌렸다. 내부 owner 다섯 개는 기계적으로 뽑아냈다. 그러나 import 순환을 피하려면 RuntimeDependencies, ActiveResolution, ReconciliationResolution, FAILURE_CODES, RECOVERIES, reportProgress, observeTerminal과 바인딩 약 40개를 더 담은 공유 내부 모듈이 필요했다. 이 파일에서 검증한 정확성 작업을 위험에 빠뜨리지 않으려고, 반만 반영하지 않고 추출을 되돌렸다. 동작과 공개 facade는 그대로다. 파일은 여전히 2,239줄이다.
BT-UP-06 리팩터링 corepack pnpm exec vitest run tests/unit/resumable-upload-runtime.test.ts fix: drain resumable upload teardown FIXED_NOT_RELEASED drain 뒤에도 작업이 남음 실패: single-flight dispose 사례 → 통과 18/18. close()는 새 작업 받기를 닫고 같은 drain을 시작한다. dispose()는 active-operation registry를 중단하고, 실제로 끝나기를 기다린 뒤 checkpoint store를 닫는다
BT-UP-07 문서에 적힌 빈틈(Web Locks 매트릭스) promotion 증거 — PROMOTION_BLOCKED 해당 없음 —
BT-IMG-01 타입 계약 변경 corepack pnpm check:types:test fixture fix: complete presigned capability and upload transport contracts FIXED_NOT_RELEASED 호출부 컴파일 깨짐 resolve()는 이제 lifetime signal을 요구한다. tests/fixtures/typecheck/invalid-image-cdn-resolve-signal.ts(그때는 전용 script였고, 2026-11-08 check:types:fixtures로 합쳤다)는 설계대로 실패하고(오류 2개), 모든 호출부가 signal을 넘긴다
BT-IMG-02 Image probe corepack pnpm exec vitest run tests/unit/image-cdn-runtime.test.ts fix: parse Cache-Control with quote awareness FIXED_NOT_RELEASED Cache-Control 파싱 거부 실패: 짝 없는 따옴표 사례 → 통과 25/25
BT-IMG-03 리팩터링 corepack pnpm exec vitest run tests/unit/image-cdn-runtime.test.ts — NOT_PERFORMED 동작 기록(characterization) drift 하지 않았다. BT-UP-05와 같은 이유다. image-cdn-runtime.ts(1,340줄)의 순수 응집도 리팩터링이고, 이것으로 닫히는 발견이 없다. image-header-metadata.ts는 리뷰에 따라 일부러 그대로 뒀다.
BT-IMG-04 문서에 적힌 빈틈(descriptor provider) promotion 증거 — PROMOTION_BLOCKED 해당 없음 —
BT-X-01 공유 abort 메커니즘 corepack pnpm exec vitest run tests/unit/abortable-operation.test.ts fix: share abort and deadline mechanics FIXED_NOT_RELEASED 늦은 결과 보상 회귀 기준(golden) 테스트 8/8: 첫 terminal owner, idempotent close, 예외를 던지는 scheduler, 관찰된 늦은 rejection, 늦은 handle 보상

Service Worker와 Web Push (docs/reviews/adapters/05-service-worker-and-web-push.md)

ID Activation 실패 테스트 명령 수정 커밋/PR Rollout 상태 Rollback 기준 증거
SW-URL-01 capability를 고르면 조립됨 corepack pnpm exec vitest run tests/unit/service-worker-runtime.test.ts fix: make Service Worker cache and removal outcomes truthful FIXED_NOT_RELEASED 정적 asset 캐시 miss 비율 실패: generator가 만든 root 기준 상대 asset과 절대 Request URL 비교 → 통과. manifest URL은 등록 scope 기준으로 한 번만 정규화한다
SW-01 capability를 고르면 조립됨 corepack pnpm exec vitest run tests/unit/service-worker-runtime.test.ts fix: make Service Worker cache and removal outcomes truthful FIXED_NOT_RELEASED 낡은 응답 제공 실패: 이전 캐시 hit → 통과: 네트워크 fallback. 지금 release 캐시만 열고, 찾고, 지운다
SW-02 capability를 고르면 조립됨 corepack pnpm exec vitest run tests/unit/service-worker-runtime.test.ts fix: make Service Worker cache and removal outcomes truthful FIXED_NOT_RELEASED 남의 캐시 삭제 실패: prefix로 ca-static-v1-not-owned와 더 긴 접미사까지 지움 → 통과: 정확한 isOwnedStaticCacheName만
SW-03 capability를 고르면 조립됨 corepack pnpm exec vitest run tests/unit/service-worker-runtime.test.ts fix: make Service Worker cache and removal outcomes truthful FIXED_NOT_RELEASED 거짓 제거 성공 실패: unregister() === false를 UNREGISTERED로 보고 → 통과: FAILED
SW-04 capability를 고르면 조립됨 corepack pnpm exec vitest run tests/unit/service-worker-runtime.test.ts fix: make Service Worker cache and removal outcomes truthful FIXED_NOT_RELEASED 제거 결과 잘못 보고 실패: 제거 모드가 늘 DISABLED → 통과: 결과 매트릭스(ABSENT/UNREGISTERED/PURGED→DISABLED, OWNERSHIP_MISMATCH→INCOMPATIBLE, FAILED→FAILED)
SW-05 빌드 게이트 corepack pnpm exec vitest run tests/unit/service-worker-build-input.test.ts fix: make Service Worker cache and removal outcomes truthful FIXED_NOT_RELEASED 빌드 허용 거부 실패: 변조 사례 표(낡은 digest, 바이트 길이, cross-origin URL, dot segment, 확장자 불일치, 모르는 필드, 중복 URL) → 통과. 빌드 게이트는 공유 codec으로 디코딩하고 canonical digest를 다시 계산한다
SW-06 capability를 고르면 조립됨 corepack pnpm exec vitest run tests/unit/service-worker-runtime.test.ts fix: harden Service Worker activation and install lifecycle FIXED_NOT_RELEASED activation handshake 실패 실패: 남의 source drain, source 바꿔치기, 동시 activation 10개 → 통과 24/24. 응답은 잡아 둔 waiting worker나 controller와 source 객체 동일성으로 맞춘다. activation/reset은 single-flight다
SW-07 capability를 고르면 조립됨 corepack pnpm exec vitest run tests/unit/service-worker-runtime.test.ts fix: harden Service Worker activation and install lifecycle FIXED_NOT_RELEASED client 0개에서 activation 막힘 scope 안 client 집합이 비어 있으면 drain된 것으로 본다. clients.matchAll() 실패는 여전히 거부한다
SW-08 capability를 고르면 조립됨 corepack pnpm exec vitest run tests/unit/service-worker-runtime.test.ts fix: harden Service Worker activation and install lifecycle FIXED_NOT_RELEASED client별 실패가 전체로 번짐 client별 postMessage를 격리한다. skipWaiting()이 commit 지점이고, 실패하면 REJECTED다. accepted/reload 알림은 그 뒤에만 best effort로 보낸다
SW-09 capability를 고르면 조립됨 corepack pnpm exec vitest run tests/unit/service-worker-runtime.test.ts fix: harden Service Worker activation and install lifecycle FIXED_NOT_RELEASED 늦은 install 작업 관찰됨 실패: 늦은 fetch 사례 → 통과. fence된 worker는 새 후보 작업을 시작하지 않는다. 늦은 응답 body는 취소한다. digest 예외는 닫힌 결과로 대응한다. 버린 install이 끝나면 두 번째 exact-delete를 돌리되, 공개된 시간 한도를 늘리지 않는다
SW-10 프로토콜 V2 migration corepack pnpm exec vitest run tests/unit/service-worker-runtime.test.ts — DEFERRED_TO_MIGRATION V1/V2 불일치 fail-close 여기서 닫지 않았다. full-identity 프로토콜 V2는 expand → dual-read → old-writer drain → contract 순서의 배포이고, 여러 release에 걸친다. 선행 조건인 공유 manifest codec과 canonical digest는 SW-05와 함께 반영했다.
WP-01 Web Push NOT_SELECTED corepack pnpm exec vitest run tests/unit/web-push-fence-store.test.ts fix: bind Web Push mutations to exact authority FIXED_NOT_RELEASED CAS receipt 거부 실패: 낡은/건너뛴/아주 큰 revision receipt → 통과. write와 remove가 exact-next-revision validator 하나를 같이 쓴다
WP-02 Web Push NOT_SELECTED corepack pnpm exec vitest run tests/unit/web-push-fence-store.test.ts — DEFERRED_TO_MIGRATION RECONCILIATION_REQUIRED 적체 Task 16 버전 migration PR로 미뤘다. MUTATION_OUTCOME_UNKNOWN과 RECONCILIATION_REQUIRED lifecycle은 WP-03과 같은 wire/data migration의 일부다.
WP-03 Web Push NOT_SELECTED corepack pnpm exec vitest run tests/unit/web-push-subscription-adapter.test.ts — DEFERRED_TO_MIGRATION backend receipt 불일치 Task 16 버전 migration PR로 미뤘다. V2 receipt는 client rollout 전에 서버와 요청 모양을 협상해야 한다.
WP-04 Web Push NOT_SELECTED corepack pnpm exec vitest run tests/unit/web-push-subscription-adapter.test.ts — DEFERRED_TO_MIGRATION reconcile 반복 WP-03과 함께 미뤘다. expectedPreviousAssociationEpoch와 replacedAssociationEpoch는 V2 register 계약의 일부다.
WP-05 Web Push NOT_SELECTED corepack pnpm exec vitest run tests/unit/web-push-subscription-adapter.test.ts fix: bind Web Push mutations to exact authority FIXED_NOT_RELEASED 사전 abort 관찰 drift 미리 abort된 command는 늘 INSPECT가 아니라 요청된 작업을 기록한다
WP-06 Web Push NOT_SELECTED corepack pnpm exec vitest run tests/unit/web-push-worker-runtime.test.ts fix: bind Web Push mutations to exact authority FIXED_NOT_RELEASED 잘림을 degraded로 보고 client handoff와 알림 정리가 countBucket과 truncated를 보고한다. 끝나지 않은 정리는 { complete: false }를 돌려주고 DEGRADED다
WP-07 Web Push NOT_SELECTED corepack pnpm exec vitest run tests/unit/web-push-worker-runtime.test.ts fix: bind Web Push mutations to exact authority FIXED_NOT_RELEASED 늦은 네이티브 effect의 확실성 네이티브 알림 effect를 NOT_APPLIED → MAYBE_APPLIED → CONFIRMED로 추적하고, 증거로만 관찰한다

최종 증거 (계획 Task 18)

정확성 작업이 다 반영된 뒤 기록했다.

하위 시스템별 테스트 (새 프로세스)

테스트 종료 결과
tests/unit/browser-rpc + tests/unit/realtime 0 192개 통과
OPFS, IndexedDB, 공개 캐시, 다운로드 0 80개 통과
abortable-operation, presigned, 재개 가능 업로드, image CDN 0 104개 통과
Service Worker + Web Push 0 66개 통과

저장소 게이트

명령 종료 결과
corepack pnpm check:types 0 여섯 프로젝트 모두 통과
corepack pnpm lint 0 --max-warnings=0로 경고 없음
corepack pnpm check:architecture 0 모듈 288개, 의존 865개. fixture 12개 PASS. 허용 PASS / 금지 9개 거부
corepack pnpm check:diagnostics 0 diagnostic 8개와 telemetry producer 5개 PASS
corepack pnpm check:browser-file-storage-boundaries 0 PASS, 거부 34건
corepack pnpm check:realtime-boundaries 0 PASS
git diff --check 0 문제 없음
corepack pnpm test:component 0 126개 통과
corepack pnpm test:integration 0 52개 통과
참조 샘플 기능 시험(그 script는 2026-11-07 샘플과 함께 지웠다) 0 26개 통과
corepack pnpm test:recipes 0 17개 통과
corepack pnpm test:unit 1 테스트 1585개 통과 / 19개 실패. 19개는 원래 있던 그대로인 ci-artifact-contract sandbox 실패다
corepack pnpm check:registries 0 registry 11개 PASS
corepack pnpm verify:documentation 0 PASS_SCOPED
음성 fixture invalid-image-cdn-resolve-signal.ts 단독 tsc(그 script는 2026-11-08 check:types:fixtures로 합쳤다) 1 0이 아닌 것이 정상이다. resolve()가 이제 lifetime signal 없는 호출을 거부함을 보이는 음성 fixture다(BT-IMG-01).

test:all은 test:unit에서 멈춘다. 그래서 위의 나머지 테스트는 직접 돌렸다.

발견 64건 전체의 최종 처리

상태 수
FIXED_NOT_RELEASED 51
PROMOTION_BLOCKED(설계상 그대로) 6
DEFERRED_TO_MIGRATION (WP-02, WP-03, WP-04, SW-10) 4
NOT_PERFORMED(BT-UP-05, BT-IMG-03 응집도 리팩터링) 2
UNVERIFIED(STO-08 브라우저 가설) 1

NOT_STARTED로 남은 발견은 없다.

통과로 주장하지 않는 실패

게이트 상태 원인
tests/system/ci-runner/ci-artifact-contract.test.ts 19개 실패 기준 기록과 같다. sandbox의 자식 프로세스, cgroup, /tmp 권한 동작이고 adapter와 관계없다. 어떤 작업에서도 수가 바뀌지 않았다.
corepack pnpm test:browser-capabilities (webkit) 6개 실패 / 24개 통과 WebKit을 실행할 수 없다. libevent-2.1-7t64와 libavif16이 없다. Chromium은 통과한다. PASS가 아니라 UNVERIFIED다.
corepack pnpm test:browser-file-storage-removal exit 1 축소 제거 fixture(reduced-removal-fixture)는 CI 계약을 77/89/102로 줄이는데, scripts/contracts/ci-gates.ts:481은 정확히 81/93/105를 요구한다. 그 파일, CI 계약, scripts/lib/removal-fixture.ts는 기준 리비전 뒤로 바뀌지 않았다(src/, tests/, docs/ 밖에서 git diff --name-only 4dc033c..HEAD는 Service Worker 빌드 스크립트 두 개만 보여 준다). 그래서 원래 있던 실패이고, 이 작업이 만든 회귀가 아니다.
corepack pnpm test:realtime-removal exit 1 같은, 원래 있던 축소 fixture 숫자 문제다.
서버/provider 호환성 매트릭스(presigned V1, Web Push V1/V2, Service Worker V1/V2, OPFS V1/V2) 돌리지 않음 이 환경에는 provider도, 여러 release를 돌릴 인프라도 없다. UNVERIFIED.
staging rollback drill 돌리지 않음 staging 배포가 필요하다. UNVERIFIED.

일부러 하지 않은 작업

계획 작업 상태 이유
Task 17 추출(BT-UP-05, BT-IMG-03, OPFS/캐시/다운로드 분해) NOT PERFORMED 이것으로 닫히는 발견이 없는 순수 응집도 리팩터링이다. BT-UP-05는 시도했다. 내부 owner 다섯 개는 깔끔하게 뽑히지만, import 순환을 피하려면 타입·상수·helper 약 40개를 담은 공유 내부 모듈이 필요하다. 그래서 반만 반영하지 않고 되돌렸다. 이 묶음에서 동작이 바뀌는 유일한 항목인 BT-UP-06은 구현했다.
SW-10, OPFS 물리/프로토콜 V2 rollout, presigned와 Web Push receipt V2(WP-02, WP-03, WP-04) DEFERRED_TO_MIGRATION 이것들은 expand → dual-read/emit → old-writer drain → contract 순서의 배포다. 서버와 요청 모양 협상, 여러 release에 걸친 drain 기간이 필요하다. 저장소 안에서 할 선행 작업은 반영했다. 공유 Service Worker manifest codec과 canonical digest(SW-05), OPFS worker 프로토콜 버전과 엄격한 대응(STO-07), OPFS 물리 generation token(STO-01)이다.
Promotion 빈틈 GAP-01, GAP-02, GAP-03, R-07, BT-UP-07, BT-IMG-04 PROMOTION_BLOCKED 설계상 그대로다. availability 상태를 올리지 않았고, 기본 bootstrap에 선택 capability를 더하지 않았다.

재검토 후속 수정 (2026-08-14)

출처: docs/reviews/adapters/RE-REVIEW-2026-08-14.md. 3b481eb을 대상으로 낸 발견 38건(High 19 / Medium 17 / Low 2)이다.

GOV-02. 그 재검토는 이 원장의 앞 절이 실제로는 부분 수정인 행 여럿을 FIXED_NOT_RELEASED로 닫았다는 것을 찾았다. 아래 표는 반대 방향으로 쓴다. 새 적대적(adversarial) 테스트가 수정 전 소스에서 먼저 실패하고 반영된 소스에서 통과할 때만 그 행을 FIXED로 적는다.

두 번째 재검토의 발견 38건은 아래 범위에서 모두 FIXED다. 1차 작업이 26건을 닫았다. 2차 작업이 나머지 12건을 닫았는데, 이들은 국소 수정이 아니라 lifecycle이나 계약 변경이 필요했다. 그 뒤 세 번째 재검토가, 이렇게 닫은 것 가운데 20건이 테스트가 거친 경로에서만 성립한다는 것을 찾았다. 그 판정과 수정은 아래 세 번째 재검토 절에 적었다. 두 작업을 비교할 수 있도록 이 절은 쓴 그대로 둔다.

반영한 것

ID 심각도 처리 커밋 실패→통과 증거
LIVE-01 High FIXED f4bfdf0 tests/integration/http-execution-v3-live-authority.test.ts — 수정 전에는 UNAVAILABLE, 동기 throw, 비동기 rejection, 잘못된 모양의 결과가 각각 UNAUTHENTICATED로 닫혔다. 이제 넷 다 fetch 0회로 AUTH_INTEGRATION_FAILURE로 닫힌다.
LIVE-02 High FIXED f4bfdf0 tests/unit/contract-registry-immutability.test.ts — 수정 전에는 빌려 온 Map.prototype.clear가 설치된 profile registry를 비웠다.
LIVE-03 High FIXED f4bfdf0 같은 테스트 파일 — 조립된 HTTP registry를 비울 수 있었고, 조립 뒤 원본 정책을 바꾸면 totalDeadlineMs가 10000에서 999999로 바뀌었다.
LIVE-04 Medium FIXED f4bfdf0 같은 integration 테스트 파일 — 협조하지 않는 fetch와 reader가 port 결과를 열린 채로 붙잡았다. deadline 뒤에 끝난 body를 SUCCESS로 받아들였다.
LIVE-05 High FIXED f4bfdf0 같은 테스트 파일 — DEADLINE timeout이 api.request.failed를 내보내지 않았다.
LEG-01 High FIXED ca210d3 V2 client의 credential authority 테스트(2026-11-03에 V2 client와 함께 지웠다) — deadline 뒤에 답한 recovery가 onUnauthenticated를 한 번 불렀다. 이제는 0번 부르고, 채택된 no-session 결과만 알린다.
LEG-02 High FIXED ca210d3 같은 테스트 파일 — bearer profile이 Authorization 없이 요청을 보냈다.
OPT-NET-01 Medium FIXED ca210d3 tests/unit/legacy-and-optional-network-remediation.test.ts — signal이 살아 있는데 loader rejection이 PAGINATION_ABORTED가 됐다.
OPT-NET-02 Low FIXED ca210d3 같은 테스트 파일 — defineMutationIntent가 executor는 거부하는 제어 문자를 받아들였다.
STO-RR-01 High FIXED 6a8281a tests/unit/opfs-worker-runtime.test.ts — 엄격한 비재진입 lease manager 때문에 FINALIZE_PUT이 영원히 멈췄다. tests/unit/opfs-byte-store.test.ts는 실패한 finalization이 더는 단순 성공이 아님을 고정한다.
STO-RR-02 Medium FIXED 6a8281a 같은 테스트 파일 — 모든 실패가 kind CAPABILITIES로 답했다.
STO-RR-03 Medium FIXED 6a8281a 같은 테스트 파일 — {code:"EVIL"}이 호출자에게 닿았다. boolean이 아닌 retryable과 예외를 던지는 getter 때문에 RPC가 timeout까지 갔다.
STO-RR-04 Medium FIXED 6a8281a tests/unit/public-response-cache.test.ts — 일시적인 marker 읽기 실패가 활성 후보를 지웠다.
STO-RR-05 Medium FIXED 6a8281a 같은 테스트 파일 — repair fetch 하나가 실패하자 그 release의 정상 asset이 다 지워졌다.
RPC-RR-02 Medium FIXED bd90e0c tests/unit/browser-rpc/browser-rpc-remediation.test.ts — 예외를 던지는 fence와 예외를 던지는 clock.sleep이 Result 계약을 빠져나갔다.
RPC-RR-03 High FIXED bd90e0c 같은 테스트 파일 — 검증 중에 transport accessor가 실행됐고, 설치된 binding registry가 set/delete/clear를 드러냈다.
RPC-RR-04 Medium FIXED bd90e0c 같은 테스트 파일 — 남는 필드, 상속된 필드, symbol 키, 예외를 던지는 getter가 있는 transport 값이 통과했다.
SW-RR-01 High FIXED efc577d 읽기 deadline, reader 취소, fatal UTF-8 디코딩을 갖춘 크기 제한 marker reader가 response.text()를 대신한다.
SW-RR-02 Medium FIXED efc577d null인 event.source는 더는 activation이나 reset 완료 조건을 채우지 않는다.
SW-RR-03 Medium FIXED efc577d tests/unit/service-worker-web-push-remediation.test.ts와 check:adapter-inventory 게이트 — 이제 generator와 decoder가 export된 표 하나를 같이 쓴다.
SW-RR-04 Medium FIXED efc577d cache.match rejection을 miss로 닫아서 respondWith가 네트워크 fallback까지 간다.
WP-RR-01 Medium FIXED efc577d focus/openWindow가 NOT_APPLIED → MAYBE_APPLIED → CONFIRMED를 따르고, 늦은 effect는 정확히 한 번 관찰한다.
TR-RR-08 Medium FIXED 69cb7e3 tests/unit/resumable-upload-http-control-plane.test.ts — 예외를 던지는 getter가 TypeError로 createSession 밖으로 새어 나갔다. symbol 키와 열거되지 않는 남는 필드가 키 검사를 통과했다.
TR-RR-09 Medium FIXED fb5b449 tests/unit/image-cdn-runtime.test.ts — 테스트가 서로 모순인 private, no-store를 성공으로 고정했었다. 이제 기록된 fail-closed 매트릭스를 적용한다.
GOV-01 Low FIXED 이 커밋 scripts/check-adapter-inventory.ts가 docs/reviews/adapters/INVENTORY.md를 git ls-files src/adapters와 비교한다. 빠졌던 src/adapters/platform/abortable-operation.ts 행을 되살렸고, 합계는 119/119다.
GOV-02 Medium FIXED 이 커밋 이 절은 너무 일찍 닫은 행을, 증거가 연결된 처리 결과와 하지 않은 일을 명시한 목록으로 바꾼다.

2차 작업에서 반영한 것

1차 작업이 닿지 못한 발견 12건도 이제 같은 조건으로 닫았다. 이름을 밝힌 적대적 테스트가 수정 전 소스에서 실패하고, 반영된 소스에서 통과한다.

ID 심각도 커밋 실패→통과 증거
RPC-RR-01 High a7390e3 tests/unit/browser-rpc/browser-rpc-remediation.test.ts — openServerStream이 자기 data descriptor에서 디코딩한 lease(streamId, frames, cancel, waitClosed)를 돌려준다. 시간이 다 된 stream은 정확히 한 번 취소한다. 같은 작업의 두 번째 stream은 transport에 닿기 전에 CONFLICT / RPC_STREAM_DRAINING으로 거부한다. 새 stream 받기는 waitClosed()가 끝난 뒤에만 다시 연다.
RT-RR-01 High c0f53d1 tests/unit/realtime/stream-coordinator.test.ts — 수정 전에는 apply가 도는 중에 부른 close()가 성공을 보고했다. 이제 작업을 호출 시점에 등록하므로 IDLE_TIMEOUT과 DRAINING을 보고한다.
RT-RR-02 High c0f53d1 같은 테스트 파일 — 대기열의 event가 DRAINING 안에서 실행을 시작했고, 시간이 다 된 effect가 resume token을 그대로 남겼다. 이제 대기열의 event는 실행 시점에 CLOSED로 버리고, token은 freshness: UNKNOWN과 함께 폐기한다.
RT-RR-03 Medium c0f53d1 tests/unit/realtime/live-poll-handoff-coordinator.test.ts — 두 번째 close()가 캐시된 timeout을 끝없이 되풀이했다. 이제 진행 중인 close만 공유한다. fence된 writer는 남은 작업이 끝날 때까지 붙잡아 두고, 나중의 close는 결국 성공으로 수렴한다.
RT-RR-04 High c0f53d1 같은 테스트 파일 — checkpoint가 아직 도는데 close()가 작업이 멈췄다(quiescence)고 보고했다. 이제 checkpoint 작업도 physical-task registry에 들어간다.
TR-RR-05 High 46e067e tests/unit/abortable-operation.test.ts — terminal()은 owner가 없다고 하는데 rejection을 TERMINAL/CLOSED로 보고했다. 예외를 던지는 scheduler가 호출자 listener를 풀어 owner가 아예 없어졌고, 그래서 뒤이은 abort가 보이지 않았다. 이제 이 primitive는 REJECTED를 구분하고, terminal()과 일치하며, scheduler를 snapshot하고, 설치에 실패하면 원자적으로 닫고, 늦은 값을 정확히 한 번 보상한다. presigned 하위 시스템 둘이 다 이 primitive로 옮겨, 손으로 쓴 사본 두 개를 대신했다.
TR-RR-01 High 46e067e tests/unit/presigned-transfer.test.ts — close()가 abort 없이 내부 기록만 풀었고, consumer signal은 fetch가 시작된 뒤에야 합류했다. 둘 다 고쳤다. scheduler 실패 테스트는 이제 fail-closed를 고정한다.
TR-RR-02 High 46e067e upload scope를 digest 전에 만들고, digest는 호출자·deadline과 경주한다. vault claim과 네트워크 호출은 owner를 다시 확인한 뒤에 한다.
TR-RR-03 High 46e067e 같은 테스트 파일 — 등록 값은 버전이 붙은 exact union이다. 모르는/없는 protocol 버전, 평문 target, ambient credential과 cookie 헤더, 2xx가 아닌 기대 status, 남는 own 필드는 각각 issuer 경계에서 거부한다.
TR-RR-04 Medium 5a76f95 같은 테스트 파일 — presigned source를 성공, writer 실패, abort 어느 때도 닫지 않았다. 이제 holder가 세 경우 각각 가장 바깥 경계에서 정확히 한 번 닫는다.
TR-RR-06 High 5a76f95 tests/unit/resumable-upload-runtime.test.ts — 끝내 lock을 주지 않는 mutation lock 때문에 dispose()에 끝이 없었다. 이제 cleanupDeadlineMs로 제한하고, drain 결과를 돌려주며, drain이 증명되지 않으면 checkpoint store를 연 채로 runtime을 CLOSING에 둔다.
TR-RR-07 High 5a76f95 tests/unit/image-cdn-runtime.test.ts — abort 뒤에, 버린 verifier가 아직 도는데 새 검증을 받아들였다. 이제 원래 verifier가 끝날 때까지 자리를 붙잡아 둔다.

두 번째 재검토의 행 가운데 NOT_STARTED로 남은 것은 없다. 공유 abortable-operation primitive의 구조 게이트도 이제 켜져 있다. primitive를 실제로 import하는 production 코드가 생길 때까지 이 게이트를 미뤘다. 문서에 적혔지만 아직 고치지 않은 결함으로 CI를 실패시키는 게이트는 잘못된 것을 보고하기 때문이다.

모양이 바뀌어서 외부 구현자에게는 호환이 깨지는 계약:

계약 변경 이유
BrowserRpcTransport.openServerStream AsyncIterable 대신 BrowserRpcServerStreamLease를 돌려준다 RPC-RR-01에 취소와 닫힘 증거가 필요하다
AuthSessionPort.recover 선택 인자 CredentialOperationContext를 받는다 LEG-01. 한 release 동안은 선택이다
PresignedCapabilityRegistration protocol이 생긴다 TR-RR-03 버전 붙은 exact union
ResumableUploadRuntime.dispose BrowserDataResult<void>를 돌려준다 TR-RR-06 제한된 drain 결과
ResumableUploadRuntimePolicy cleanupDeadlineMs가 생긴다 TR-RR-06 teardown 한도
ImageCdnPresentationPort.resolve signal 필수 BT-IMG-01, 먼저 반영

이 작업 뒤 게이트

반영된 트리에서 돌렸다. 실제로 통과한 것만 통과로 적는다.

명령 종료 결과
corepack pnpm check:types 0 여섯 프로젝트 모두
corepack pnpm lint 0 --max-warnings=0로 경고 없음
corepack pnpm check:architecture 0 모듈 289개, 의존 868개. fixture 12개 PASS
corepack pnpm check:adapter-inventory 0 파일 119개, 공유 asset 확장자 7개, fixture 연결, primitive importer
corepack pnpm check:registries 0 registry 11개 PASS
corepack pnpm check:diagnostics 0 diagnostic 8개 / telemetry producer 5개
corepack pnpm check:browser-file-storage-boundaries 0 PASS, 거부 34건
corepack pnpm check:realtime-boundaries 0 PASS
corepack pnpm verify:documentation 0 PASS_SCOPED
git diff --check 0 문제 없음
tests/unit + tests/integration, 제외 없음 — 1643개 통과 / 1747개. 실패 104개는 아래 환경 탓 파일 네 개에서 나온다
corepack pnpm test:component 0 126개 통과
corepack pnpm test:recipes 0 17개 통과
참조 샘플 기능 시험(그 script는 2026-11-07 샘플과 함께 지웠다) 0 26개 통과

통과로 주장하지 않는 환경 실패

게이트 상태 원인
tests/unit/ci-workflow-generation.test.ts 82개 실패 / 325개 통과 변경 전 기준에서도 같다(git stash 비교). 이 파일이 띄우는 하위 프로세스 게이트는 이 sandbox에서 돌 수 없다.
tests/system/ci-runner/ci-artifact-contract.test.ts 실패 원래 있던 그대로의 sandbox, cgroup, /tmp 권한 동작이다.
tests/unit/security-followup.test.ts, tests/integration/provider-guardian-transaction.test.ts, tests/unit/risk-coverage.test.ts 전체 실행 부하에서 불안정(flaky) 과거 기준 결과다. 셋 다 새 프로세스에서 통과했다(함께 돌려 78개 통과).

현재 분류 갱신(2026-09-18): provider guardian transaction 테스트 파일은 tests/integration/provider-guardian-transaction.test.ts로 옮겼다. 이 파일은 자식 프로세스를 띄우고 파일 시스템/IPC/프로세스 lifecycle을 다룬다. 그래서 순수 unit 묶음에 넣지 않는다. READY/PUBLISHED 대기에는 전용 테스트 watchdog을 쓴다. 1초 scheduler 지연을 production 프로토콜 deadline으로 보지 않는다.

파괴적인 fixture 위험 — 고침

발견 38건 밖의 일이고, 그 발견을 위한 테스트를 돌리다가 찾았다.

네 곳이 저장소에 설치된 의존성을 쓰고 버릴 fixture에 연결할 때, <fixture>/node_modules에 디렉터리 symlink 하나를 썼다:

  • scripts/lib/removal-fixture.ts
  • scripts/check-supply-chain-provider-fixtures.ts
  • tests/integration/security-followup-archive.test.ts
  • tests/system/ci-runner/ci-artifact-contract.test.ts

그다음 각 fixture는 자기 안에서 pnpm을 돌린다. pnpm은 거기서 찾은 modules 디렉터리를 알아보지 못하고 지운다. CI=true이면 묻지도 않고 지운다. 이 삭제가 symlink를 따라가 실행 도중 저장소 자신의 node_modules를 지웠다. 테스트가 자기가 돌고 있는 workspace를 언인스톨한 셈이다. 전체 test:unit 실행이 보고한, 파일과 관계없이 줄줄이 이어진 실패가 여기서 나왔다. 이 작업 중에 두 번 일어났다.

scripts/lib/fixture-node-modules.ts가 네 곳을 다 대신한다. node_modules는 진짜 디렉터리이고, 그 안의 항목이 각각 symlink다. 그래서 재귀 삭제는 링크 하나를 타고 공유 트리로 들어가지 않고, fixture 자신의 링크만 끊는다. tests/unit/fixture-node-modules.test.ts는 pnpm이 하는 재귀 삭제를 그대로 해 보고 원본 트리가 살아남는지 확인한다. corepack pnpm check:adapter-inventory는 디렉터리 symlink 방식이 다시 들어오면 실패한다.

고친 뒤에는 전체 tests/unit + tests/integration 실행이 의존성을 그대로 둔다. 실패는 위의 환경 탓 파일 두 개와, 부하에서 불안정한 파일 두 개로 좁혀진다:

파일 실패 원인
tests/unit/ci-workflow-generation.test.ts 82 변경 전 기준에서도 같다(git stash 비교). 이 파일의 하위 프로세스 게이트는 이 sandbox에서 돌 수 없다.
tests/system/ci-runner/ci-artifact-contract.test.ts 19 원래 있던 그대로의 sandbox, cgroup, /tmp 권한 동작이다.
tests/unit/security-followup.test.ts 2 따로 돌리면 통과한다.
tests/integration/provider-guardian-transaction.test.ts 1 과거 기준: 따로 돌리면 통과했다. 지금은 프로세스 integration 테스트로 분류한다.

전체 1723개 중 1619개 통과다. 전에는 빼야 했던 세 파일 tests/unit/removal-fixture.test.ts, tests/unit/supply-chain.test.ts, tests/integration/security-followup-archive.test.ts도 이제 전체 실행에서 통과한다.

세 번째 재검토 (2026-08-14)

읽기만 하는 세 번째 재검토가 위의 38행 전체를 적대적이고, 협조하지 않고, 늦게 끝나고, 값이 바뀌는 입력으로 다시 시험했다. 18건은 고쳐졌다고 확인했다. 20건은 테스트가 거친 경로에서만 성립했다. 새 발견 3건과 거버넌스(governance) 결함 3건도 찾았다. 거의 모든 경우에 모양이 같았다. 값을 확인한 뒤 다시 읽었거나, wrapper가 끝난 것을 그 wrapper가 제한하던 실제 작업이 끝난 것으로 착각했다.

docs/operations/adapter-remediation-dispositions.json이 기계가 읽는 기록이다. corepack pnpm check:remediation-ledger는 그 파일을 이 문서와 맞대어 보고, 적힌 증거 경로가 다 있는지 확인한다. 아직 열린 행이 하나라도 있으면 일괄 종료를 선언하는 문장을 거부한다. GOV-03. 앞 절은 여섯 행이 재현 가능하게 부분 수정이었는데도 "All 38 are now FIXED"라고 적었다. 문장은 쓰기 쉽고, 리뷰어는 그 문장을 증거로 읽는다. 그래서 이제 그 주장을 사람이 쓰지 않고 기록에서 끌어낸다.

반영한 것

ID 이전 판정 처리 실패→통과 증거
NS-01 PARTIAL FIXED tests/integration/http-execution-v3-live-authority.test.ts — 예외를 던지는 kind getter가 인증 경계를 빠져나갔고, 인증 장애를 NETWORK_FAILURE로 보고했다. 이제 적대적인 credential 모양 9가지가 fetch 0회로 AUTH_INTEGRATION_FAILURE로 닫히고, 각 필드는 정확히 한 번만 읽는다.
NS-02 PARTIAL FIXED tests/unit/contract-registry-immutability.test.ts — 검증에는 10_000, 복사에는 999_999를 답한 정책이 두 번째 값으로 설치됐다. 이제 조립 단계가 먼저 snapshot하므로 상한을 넘는 값은 거부한다.
NS-03 PARTIAL FIXED tests/integration/http-execution-v3-live-authority.test.ts — NONE probe가 deadline 뒤에 body.locked === true를 남겼다. 이제 reader를 한 번 취소하고 lock을 푼다.
NS-04 PARTIAL FIXED tests/unit/opfs-byte-store.test.ts — 실패한 journal.complete가 여전히 SUCCEEDED telemetry와 함께 단순 성공을 돌려줬다. 이제 RECONCILE 실패를 돌려주고 그 journal 행을 COMMITTED로 두며, 끝나지 않은 삭제는 DEGRADED로 관찰한다.
NS-05 PARTIAL FIXED tests/unit/opfs-worker-runtime.test.ts — bootstrap 실패가 모든 요청에 kind CAPABILITIES로 답해서, gateway가 BLOCKED를 UNSUPPORTED로 바꿨다. 이제 kind 12가지가 다 자기 요청과의 대응(correlation)을 그대로 주고받는다.
NS-06 PARTIAL FIXED 같은 테스트 파일 — 예외를 던지는 requestId getter가 RPC timeout을 냈고, 상태를 가진 trap이 공개 promise를 영원히 pending으로 남겼다. 이제 대기 행을 풀기 전에 응답을 디코딩하고, 대응시킬 수 없는 응답이 오면 channel을 닫힌 쪽으로 실패시킨다.
NS-07 NEW FIXED tests/unit/cursor-pagination-runtime.test.ts — 생성 뒤에 maxPages를 올리자 검증된 상한이 1 page에서 3 page로 넓어졌다. 이제 상한과 협력 객체는 한 번만 잡는다.
NS-08 NEW FIXED tests/unit/public-response-cache.test.ts — 협조하지 않는 fetch가 mutation lock을 영원히 붙잡았고, abort 뒤에 끝난 digest가 여전히 asset과 activation marker를 썼다. 이제 terminal owner 하나가 staging 본문 전체를 맡는다.
RPC-01 PARTIAL FIXED tests/unit/browser-rpc/browser-rpc-remediation.test.ts — reject하거나, 예외를 던지거나, promise가 아닌 waitClosed()를 성공으로 흡수했고, 두 번째 실제 stream이 열렸다. 이제 계약 모양에 맞는 receipt가 fulfilled일 때만 등록을 정리한다.
RPC-02 PARTIAL FIXED 같은 테스트 파일 — 예외를 던지는 iterator return accessor가 선택된 timeout을 네이티브 TypeError로 바꿨고, export된 lease decoder가 적대적인 Symbol.asyncIterator에서 예외를 던졌다.
RPC-03 PARTIAL FIXED 같은 테스트 파일 — 검증 중에 registry accessor가 두 번 실행됐고, prototype이나 열거되지 않는 키 뒤에 필드를 숨긴 행이 설치됐다. 이제 모든 registry를 검증 전에 snapshot한다.
RPC-04 PARTIAL FIXED 같은 테스트 파일 — 자기 필드 {ok,message,encodedBytes}에 prototype의 injected가 더해진 값이 성공이었고, 빠진 message가 undefined로 느슨한 schema에 닿았다.
RT-01 PARTIAL FIXED tests/unit/realtime/stream-coordinator.test.ts — 자기 호출 안에서 close()에 다시 들어간 authority가, effect가 아직 pending인데 {ok:true}를 받았다. 이제 협력 객체를 부르기 전에 작업을 등록한다.
RT-02 NEW FIXED 같은 테스트 파일 — 예외를 던지는 scheduleTimeout이 도는 중인 apply와 겹치는 recovery를 시작했고, close()가 네이티브 TypeError로 reject했다. 이제 설치할 수 없는 deadline은 result 계약 안에서 fail-closed로 실패한다.
TR-01 PARTIAL FIXED tests/unit/presigned-transfer.test.ts — 상태를 가진 issuer가 금지 헤더 검사에는 허용된 헤더 집합을 보여 주고 Authorization을 저장할 수 있었다. 이제 등록 값과 그 안에 든 모든 것을 검증 전에 snapshot한다.
TR-02 PARTIAL FIXED tests/unit/presigned-transfer-delivery.test.ts — abort 뒤에 resolve된 source lease를 한 번도 닫지 않았다. 이제 holder의 close-once latch를 같이 쓰는 compensator가 정확히 한 번 닫는다.
TR-03 PARTIAL FIXED tests/unit/abortable-operation.test.ts, tests/unit/image-cdn-browser-probe.test.ts, tests/unit/resumable-upload-fetch-transport.test.ts — 결과가 코드에 박힌 microtask 4개 drain에 달려 있었고, 예외를 던지는 scheduler가 호출자 listener를 남긴 채 probe()/execute()를 네이티브 예외로 reject했다. 이제 primitive는 관찰 순서대로 한 번만 끝나고, 소비자 네 곳이 다 생성 시점에 묶은 timer snapshot과 함께 이 primitive를 쓴다.
TR-04 PARTIAL FIXED tests/unit/resumable-upload-runtime-teardown.test.ts — attempt deadline보다 오래 산 provider 때문에 dispose()가 drain이 끝난 runtime을 보고하고 checkpoint store를 닫았다. 이제 가공하지 않은 provider 작업은 따로 registry를 두고, 두 registry가 다 멈춰야 한다.
TR-05 PARTIAL FIXED tests/unit/resumable-upload-http-control-plane.test.ts — 상태를 가진 sessionId가 정규식을 통과한 뒤 ../../unsafe를 돌려줬다. 이제 decoder는 정확히 한 번 읽어 둔 자기 snapshot을 검증한다.
SW-01 PARTIAL FIXED tests/unit/service-worker-runtime.test.ts — 257바이트 상한과 비교하기 전에 1 MiB chunk 하나를 통째로 붙잡았고, 크기 초과가 선언돼도 body를 연 채로 두었으며, reader lock을 끝내 풀지 않았다.
SW-02 PARTIAL FIXED tests/unit/service-worker-web-push-remediation.test.ts — generator가 /assets/bad@name-abcdefgh.js를 내보냈고, decoder가 방금 만든 manifest를 거부했다. 이제 둘이 canonical 경로 판정 함수 하나를 같이 쓰고, generator가 자기 출력을 스스로 검증한다.
WP-01 PARTIAL FIXED tests/unit/web-push-worker-runtime.test.ts — 평범한 click을 두 번 셌고, 늦은 rejection이 MAYBE_APPLIED를 NOT_APPLIED로 낮췄으며, 늦은 관찰이 waitUntil 밖에서 돌았다.
GOV-03 OPEN FIXED scripts/check-remediation-ledger.ts — 처리 결과와 증거 경로를 기계가 읽을 수 있고, 열린 행이 하나라도 있으면 일괄 종료 문장을 막는다.
GOV-04 OPEN FIXED scripts/check-adapter-inventory.ts — 게이트가 importer 하나만 있어도 통과했다. 이제 이름을 밝힌 소비자 네 곳이 import를 공유 primitive로 해석해야 하고, 정확한 집합을 출력한다.
GOV-05 OPEN FIXED config/recipes/frontend-capability-recipes.json — 아래 budget 메모를 본다.

file-transfer 번들 budget

check:optional-recipes:source는 이전 기준에서도 실패했다(52,078 > 52,000 gzip 바이트). 그러니 이 작업 전에도 통과 상태가 아니었다. 먼저 중복된 abort·deadline 메커니즘을 합쳤다. Image probe와 Resumable fetch transport는 이제 자기 scope 대신 공유 abortable-operation primitive를 쓴다. decoder 네 개는 각자 descriptor를 훑지 않고 src/contracts/exact-snapshot.ts를 같이 쓴다. 남은 크기는 세 번째 재검토가 요구한 정확성 코드다. exact decoder, 늦은 값 compensator, physical-work registry가 그것이다. 그래서 실패를 통과인 척 끌고 가지 않고, budget을 측정값 53,810에 맞춰 54,600 gzip 바이트로 다시 정했다.

그 뒤 수정이 이어지면서 budget도 바뀌었다. 2026-11-03에 측정값 56,053에 맞춰 57,800 gzip 바이트로 정했다(측정값 + 3%, 100 B 단위로 올림). 규칙과 지금 값은 docs/architecture/optional-adapter-recipes.md에 있다.

다시 만든 증거 (이 커밋)

명령 종료 결과
corepack pnpm check:types 0 여섯 프로젝트 모두 통과
corepack pnpm check:architecture 0 모듈 290개, 의존 879개. fixture 12개 PASS. 허용 PASS / 금지 9개 거부
corepack pnpm check:adapter-inventory 0 파일 119개. 공유 확장자 7개. shared-abort importer 5개 나열
corepack pnpm check:optional-recipes:source 0 file-transfer 53,810 / 54,600 gzip 바이트
corepack pnpm exec vitest run tests/unit/browser-rpc tests/unit/realtime 0 파일 17개 / 234개 통과
abortable-operation, presigned, 재개 가능 업로드, image CDN 0 파일 7개 / 176개 통과
OPFS, journal, 공개 캐시, cursor 0 파일 5개 / 100개 통과
Service Worker + Web Push 0 파일 6개 / 79개 통과
corepack pnpm exec vitest run tests/integration 0 파일 11개 / 82개 통과

전체 tests/unit + tests/integration 실행은 1,845개 통과 / 1,864개이고, 파일 129개 중 128개가 통과했다. 실패 19건은 전부 tests/system/ci-runner/ci-artifact-contract.test.ts에서 나온다. 위에 이미 적은, 원래 있던 sandbox, cgroup, RLIMIT, /tmp 권한 동작이다. 이 작업 전에도 같은 파일이 똑같이 실패했다. 실패하는 adapter 테스트는 없다.

운영 계약 리뷰 (2026-08-15)

네 번째 리뷰는 adapter 층을 넘어 운영 계약을 봤다. feature 켜고 끄기, 환경 분리, 폴더 경계, 그리고 실제로 통과한 게이트가 무엇인지다. 실패하는 게이트 다섯과 구조 빈틈 셋을 찾았다. 아래 각 행은 증상이 아니라 결함을 적는다.

id 영역 처리 실제로 잘못된 것
OPS-01 release FIXED public/은 dist/로 그대로 복사된다. 그래서 production을 포함한 모든 빌드가 local runtime 문서를 함께 내보냈다. 이제 runtime 설정은 config/runtime/<profile>.json에서 온다.
OPS-02 release FIXED release 일관성 검사는 산출물끼리 맞는지만 증명했고, 그 산출물이 production에 맞는지는 증명하지 않았다. FE-GATE-027은 APP_ENV, 인증 모드, endpoint, 빌드 식별자가 선언된 RELEASE_TARGET과 맞지 않는 산출물을 거부하고, 선언되지 않은 target은 아예 거부한다.
OPS-03 runtime FIXED REQUEST_TIMEOUT_MS는 검증만 하고 V3 executor에 넘기지 않았다. 그래서 모든 작업이 자기 계약의 deadline으로 돌았다. 이제 이 값은 상한이다. 계약을 조일 수는 있지만 풀 수는 없다.
OPS-04 빌드 FIXED VITE_ROUTER_BASE_PATH는 router와 Service Worker scope는 정했지만 Vite의 asset base는 정하지 않았다. 그래서 하위 경로 배포가 root 기준 절대 경로 asset을 내보냈다. 이제 값 하나가 셋 모두에 들어간다.
OPS-05 provider FIXED bubblewrap 0.9.0은 --args 파일 안에서 option stream 뒤에 오는 것을 버린다. 그래서 sandbox 안 명령이 한 번도 실행되지 않았다. bwrap은 usage를 찍고 1로 끝났다. 이제 option은 그대로 숨기고, 명령은 진짜 argv로 넘긴다.
OPS-06 provider FIXED scope wrapper가 liveness pipe를 fs로 읽었다. supervisor가 끝내 닫지 않는 pipe에 대한 blocking read(2)다. process.exit이 그 thread를 join하다 교착에 빠져서, 끝난 provider를 timeout kill로 보고했다.
OPS-07 release FIXED mkdir/open mode를 주변 umask에 맡겼다. 그래서 강화된(hardened) runner가 자기가 들어갈 수 없는 디렉터리를 만들고, 다시 열 수 없는 파일을 tar에 넘겼다.
OPS-08 release FIXED promotion 정리가 고정한 descriptor로 이번 promotion의 파일 정확히 다섯 개를 지운 뒤에야 leaf가 바꿔치기된 것을 알아챘다. 그래서 절반만 빈 디렉터리가 남았고, 재시도는 그것을 끝난 디렉터리와 구별하지 못했다.
OPS-09 제거 가능성 FIXED 제거 fixture는 저장소가 아니었고 .gitignore도 없었다. 제거 스크립트마다 따로 복사 대상 목록을 들고 있었고, 그 목록들이 서로 어긋났다. 그래서 supply-chain 생성이 모든 fixture 안에서 실패했고, provider 테스트 전체를 함께 무너뜨렸다.
OPS-10 제거 가능성 FIXED platform integration 파일이 참조 feature의 route id를 단언했다. 그래서 그 feature를 지우면 이 파일이 지운 모듈을 import하는 상태로 남았다. 단언은 feature 자신의 테스트 트리로 옮겼다.
OPS-11 제거 가능성 FIXED 제거 fixture는 일부러 줄인 CI 계약으로 돈다. 정본 exact-count 테스트가 그 fixture에 전체 기준을 다시 들이대서, fixture가 증명하려고 존재하는 바로 그 축소 때문에 fixture를 실패시켰다.
OPS-12 브라우저 FIXED browser-capability spec 네 개가 강화된 envelope가 요구하는 protocol 필드 없이 capability 요청에 답했다. 그래서 모든 capability가 거부됐고, download와 part-upload 경로는 빈 기록을 두고 단언했다.
OPS-13 브라우저 FIXED 거부된 capability 문서가 recovery: NONE으로 답했다. 이는 설계 기록과도, 이미 REISSUE_CAPABILITY로 답하는 vault와도 어긋난다.
OPS-14 성능 FIXED Playwright는 accessible name을 부분 문자열로 맞춘다. 그래서 navigation 항목이 home page의 call to action 버튼과도 맞았다. 실행은 첫 측정 전에 strict-mode 위반으로 죽었고, 증거를 하나도 남기지 않았다.
OPS-15 시각(visual) FIXED platform overview 기준 이미지는 참조 route가 integration-defined에서 session-required로 바뀌기 전에 만든 것이었다. 그래서 그 page를 다루는 유일한 visual 게이트가 자기 기준이 낡아서 실패했다.
OPS-16 아키텍처 FIXED src/contracts가 공유 Result와 호환성 판정 함수를 쓰려고 src/application을 import했다. 어느 쪽도 공유 어휘의 owner가 아니었다. 둘 다 contracts로 내렸다.
OPS-17 아키텍처 FIXED 문서에 적힌 "어떤 adapter도 다른 구체 adapter에 의존하지 않는다" 규칙은 실행 가능한 형태가 없었다. 그리고 diagnostics가 telemetry에서 guard를 import했다. guard는 adapter kernel로 옮겼고, 이제 같은 디렉터리 역참조(backreference)로 규칙을 강제한다.
OPS-18 아키텍처 PARTIAL 범용 presentation이 아직 installed-feature registry를 읽는다. 규칙은 지금 그렇게 하는 모듈 집합을 정확히 고정한다. 새 의존 edge는 실패한다. 조립을 bootstrap으로 올리는 일은 하지 않았다.
OPS-19 문서 FIXED README와 수동 접근성 체크리스트는 둘 다 route 6개라고 했지만, 등록된 것은 10개였다. 그래서 화면 4개가 선언된 수동 리뷰 범위 밖에 있었다. 이제 verify:documentation이 route registry에서 목록을 끌어낸다.

제품 feature 선택 (2026-08-15, 2차 작업)

id 처리 바뀐 것
OPS-20 FIXED 빌드에 어떤 feature가 들어가는지를, 이제 리터럴을 퍼뜨린 registry 다섯 개가 아니라 선언된 manifest가 정한다. VITE_PRODUCT_FEATURES가 빌드 때 그 범위를 좁힌다. 새 registry가 이 값을 확인하지 않으면 테스트가 실패한다.
OPS-21 FIXED runtime 문서의 FEATURE_OVERRIDES는 다시 빌드하지 않고 설치된 feature를 서비스에서 뺀다. router는 navigation만 숨기지 않고 그 feature의 route를 거부한다. 그래서 주소를 직접 쳐서 들어온 deep link도 그 feature를 띄울 수 없다.
OPS-22 FIXED 두 입력 다 어휘부터 빼기만 할 수 있다. override enum에는 ENABLED가 없다. 소스 트리가 선언하지 않은 feature를 적은 빌드 시점 선택은 무시하지 않고 거부한다.
OPS-23 FIXED 실행에 실패한 sandbox가 이제 이유를 보고한다. supervisor는 바이트 상한을 지키려고만 자식 출력을 읽고 버렸다. 그래서 host 제약이 설명 없는 exit=1로만 드러났다. sandbox 도구가 직접 내는 줄은 남긴다. provider 출력은 여전히 버린다.

환경 변수는 번들을 줄이지 않는다. 코드도 그렇게 적는다. 정적 import는 값으로 되돌릴 수 없다. import graph가 설정 문자열에 따라 달라지게 하는 것은 §3.5가 막으려는 바로 그 일이다. 측정 결과 none은 출력을 58바이트 바꾼다. 물리적 제거는 FE-GATE-020이 맡는다.

이 작업 중에 발견한 host 제약

이 기계에서는 bwrap --unshare-net이 더는 동작하지 않는다:

$ printf '%s\0' --unshare-net --ro-bind /usr /usr ... | bwrap --args 3 -- /bin/true
bwrap: loopback: Failed RTM_NEWADDR: Operation not permitted
$ sysctl kernel.apparmor_restrict_unprivileged_userns
kernel.apparmor_restrict_unprivileged_userns = 1

이 재현에는 이 저장소의 코드가 하나도 없다. 같은 세션 앞부분에서는 똑같은 sandbox가 끝까지 돌았다. 그러니 제약은 도중에 켜졌다. 제약이 있는 동안 provider 테스트 108개 중 16개는 여기서 돌 수 없다. kernel이 허락하지 않는 sandbox가 필요하기 때문이다. 이 테스트는 통과로도, 제품 결함으로도 세지 않는다. namespace를 허락하는 host에서는 같은 파일이 107/108이었다.

이 작업 뒤에도 실패하는 것

applies effective aggregate cgroup limits without exposing command or credentials 테스트를 다시 썼다. 전에는 pid마다 ps를 한 번씩 돌려 살아 있는 프로세스 트리를 읽고, 실행 도중에 단언했다. 이 방식은 이제 몇백 밀리초 만에 끝나는 sandbox와의 경주에서 졌다. 지금은 /proc에서 5ms마다 트리를 기록하고, 실행이 끝난 뒤 그 기록으로 단언한다. 위의 host 제약도 이렇게 구조를 바꾸면서 드러났다. supervisor는 그동안 sandbox를 띄우는 데 실패하고 있었는데, 테스트가 관찰 단계에서 먼저 죽었던 것이다.

프로세스를 띄우고, archive를 만들고, 증거에 서명하는 테스트에는 순수 JS unit 테스트에 맞춘 기본값 10s 대신 30s budget을 줬다. 기본값은 올리지 않았다. 올리면 정말로 멈춘 테스트를 숨기게 된다.

이 작업 뒤 FE-GATE-020

fixture 전 후
참조 feature 첫 단언 전에 실패 1,612개 통과 / 1개 실패
선택 recipe 실패 39개 1,386개 통과 / 2개 실패
브라우저 파일 + 스토리지 실패 40개 1,006개 통과 / 3개 실패
realtime 도달 못 함 1,159개 통과 / 1개 실패

남은 실패는 하나하나가 위에서 말한 환경 제약 테스트 세 개 중 하나다.

Lab 성능 측정이 이제 증거를 낸다. 그 증거는 이 기계에서 named-interaction budget을 넘었음을 보여 준다(200ms 기준에 367–724ms). 이 지표는 lazy route 이동 전체를 재는데, budget은 INP 모양의 200ms다. 그래서 둘은 같은 것을 말하지 않는다. 이를 통과로 만들려고 budget을 바꾸지 않았다.

이 환경에서는 여전히 WebKit을 쓸 수 없다(libevent-2.1-7t64, libavif16이 설치되지 않았다). 그래서 browser-capability spec 14개와 WebKit E2E project는 여기서 확인하지 못했다. Chromium과 Firefox는 28/28, visual은 5/5다.

이 원장을 고치는 규칙

  • 행은 연결된 실패 테스트, 그 테스트의 통과 실행, 커밋 id가 있을 때만 NOT_STARTED에서 벗어난다.
  • PROMOTION_BLOCKED 행은 DEFECT가 되지 않는다. 승인된 제품 선택 변경과, 계획이 정한 browser/provider 증거가 있을 때 닫힌다.
  • 환경 탓 게이트 실패는 원문 그대로 옮기고, 절대 통과로 주장하지 않는다.