정리 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/…)에 들어와서, 기록은 옮길 때의 글로 되돌렸다
491 lines
73 KiB
Markdown
491 lines
73 KiB
Markdown
# Adapter 수정 원장
|
||
|
||
> [`docs/reviews/adapters/`](../reviews/adapters/README.md)에서 확인된 모든 발견(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)
|
||
|
||
기준 리비전에서 돌린 검색:
|
||
|
||
```bash
|
||
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`](../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 증거가 있을 때 닫힌다.
|
||
- 환경 탓 게이트 실패는 원문 그대로 옮기고, 절대 통과로 주장하지 않는다.
|