Files
clean-architecture-frontend…/docs/operations/adapter-remediation-ledger.md
T
DongHyeonkaandClaude Opus 5 250531aa43 fix: stop test fixtures from deleting the repository's dependencies
Four fixtures linked the installed dependencies into a throwaway root with a
single directory symlink at <fixture>/node_modules, then ran pnpm inside that
root. pnpm does not recognise the modules directory it finds there and purges
it; with CI=true it does so without a prompt. The purge followed the symlink and
deleted the repository's own node_modules mid-run, so a test suite uninstalled
the workspace it was running in. That is what produced the cascading,
file-unrelated failures a full test:unit run reported, and it happened twice
while running the suites for the adapter re-review.

scripts/lib/fixture-node-modules.ts replaces all four sites: node_modules is a
real directory whose entries are individual symlinks, so a recursive delete
unlinks the fixture's own links instead of walking through one link into the
shared tree. Resolution is unchanged.

tests/unit/fixture-node-modules.test.ts performs the exact recursive delete pnpm
performs and asserts the source tree survives, and check:adapter-inventory now
fails on any reintroduction of the directory-symlink form — verified by putting
the old line back and watching the gate reject it.

A full tests/unit + tests/integration run now leaves the dependencies intact.
removal-fixture, supply-chain and security-followup-archive, the three suites
that had to be excluded before, pass in that run.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-14 16:08:32 +09:00

44 KiB

Adapter Remediation Ledger

Source of truth for the execution state of every confirmed finding in docs/reviews/adapters/.

Plan: 2026-08-13 adapter remediation. Baseline revision: develop / 4dc033cf33a5b6173bbf960d5eb464a406dc4c92.

Containment state (plan Task 1, Step 1)

Scan performed on the baseline revision:

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

Result:

Capability Template default composition Containment action
OPFS byte store (createBrowserOpfsRuntime) Not composed. Only recipes/frontend-capabilities/* reference the "OPFS" backend literal in contract/fake code. None required. No V1 writer is admitted, so no kill switch is invented.
Browser files runtime Not composed in src/bootstrap/**. None.
Public response cache Not composed; only tests/unit/public-response-cache.test.ts constructs it. None.
Browser RPC runtime Not composed; AVAILABLE_NOT_COMPOSED. None.
Web Push Not composed; NOT_SELECTED / AVAILABLE_NOT_COMPOSED. None.
Resumable upload / image CDN Not composed; test-only construction. None.
Service Worker runtime host Composed conditionally through src/bootstrap/optional-runtime-host.tscreateServiceWorkerRuntimeHost, gated by ResolvedRuntimeCapabilities. Stays as-is. Task 14 fixes truthfulness without changing selection.
Realtime src/bootstrap/optional-runtime-host.ts:91 keeps realtime NOT_SELECTED with realtime: null. None.

No product-specific composition root outside the template default exists in this repository, so there is no OPFS V1 write admission to close.

Baseline gates (plan Task 1, Step 3)

Captured on the baseline revision before any source change.

Command Exit code Result
corepack pnpm check:types 0 app, node, test, recipes, web-worker, service-worker projects all pass.
corepack pnpm lint 0 --max-warnings=0 clean.
corepack pnpm check:architecture 0 286 modules, 854 dependencies, all imports resolved; 12 graph fixtures PASS; TS-only policy PASS; allowed PASS / 9 forbidden rejected.
corepack pnpm test:unit 1 110 passed / 1 failed test files; 1496 passed / 19 failed tests (1515 total), 150.92s.

test:unit failure attribution

The single failing file is tests/unit/ci-artifact-contract.test.ts. All 19 failures come from child-process, cgroup, and filesystem-permission behavior of the sandboxed execution environment, not from adapter code. Verbatim causes recorded from the run log:

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{…}

This matches the environment note already recorded in the review index. It is not converted to an adapter failure and it is not treated as green. Every adapter task below must keep the adapter-focused suites green and must not increase this file's failure count.

Finding ledger

Activation records whether the finding is reachable on the current template execution path. Rollout state starts at NOT_STARTED; documented-unimplemented items start at PROMOTION_BLOCKED and are never labelled DEFECT.

Network and state (docs/reviews/adapters/01-network-and-state.md)

ID Activation Red test command Fix commit/PR Rollout state Rollback trigger Evidence
N-01 Live V3 path corepack pnpm exec vitest run tests/integration/http-execution-v3-observability.test.ts fix: restore V3 HTTP observability FIXED_NOT_RELEASED diagnostics/telemetry producer gate regression Red 5/5 failed → green 5/5; check:diagnostics PASS (8 diagnostics, 5 telemetry producers); check:types PASS; check:architecture PASS
N-02 Live V3 path corepack pnpm exec vitest run tests/integration/http-execution-v3-auth-profile.test.ts fix: enforce installed HTTP auth profiles FIXED_NOT_RELEASED authenticated request 4xx spike after profile enforcement Red suite failed to load (installRestAuthProfileRegistry absent) → green 7/7; check:types PASS; check:architecture PASS; lint PASS; unit+integration+features 1560 passed with only the pre-existing environmental ci-artifact-contract failures
N-03 Live V3 path 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 verdict regression Red reproduced SCOPE_FENCED with NOT_STARTED after one dispatched attempt → green MAYBE_APPLIED; lattice table 9/9; check:types PASS; lint PASS
N-04 Live composition 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 telemetry delivery loss after teardown change Red 10 failed (5 lifecycle + 5 capacity) → green 34/34; check:diagnostics PASS; check:types PASS; check:architecture PASS; lint PASS
N-05 Rollout blocker (sidecar not composed) corepack pnpm exec vitest run tests/unit/conditional-validator-store.test.ts fix: harden bounded state sidecars FIXED_NOT_RELEASED persisted validator key incompatibility Red collision case (two valid bindings sharing one delimiter-joined key) → green; key is now a bounded validated tuple encoded with JSON.stringify
N-06 Legacy V2 rollback seam corepack pnpm exec vitest run tests/integration/http-client.test.ts fix: harden the legacy HTTP rollback path FIXED_NOT_RELEASED legacy keyed command rejection spike Red 4 invalid-key cases → green; rejection happens before credentials and fetch (0 credential calls, 0 fetches)
N-07 Legacy V2 rollback seam corepack pnpm exec vitest run tests/integration/http-client.test.ts tests/integration/auth-recovery.test.ts fix: harden the legacy HTTP rollback path FIXED_NOT_RELEASED legacy credential timeout regression Red never-settling owner → green; credential wait races the existing attempt controller so no extra timer is added; ownership maps to REQUEST_TIMEOUT / REQUEST_ABORTED / AUTH_INTEGRATION_FAILURE with zero fetches
N-08 Legacy V2 rollback seam corepack pnpm exec vitest run tests/unit/bounded-json-compatibility.test.ts fix: harden the legacy HTTP rollback path FIXED_NOT_RELEASED legacy JSON failure-code drift Green 7/7 including throwing cancel/releaseLock; readBoundedJson now delegates to bounded-body-reader with the legacy codes preserved
N-09 Live 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 invalidation drop Red foreign-area pulse accepted → green 13/13; localStorage captured once and StorageEvent.storageArea compared by object identity; pulse key registered as 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 semantics change Red never-settling loader → green PAGINATION_ABORTED with the late page ignored
N-11 Live composition corepack pnpm exec vitest run tests/unit/telemetry.test.ts -t capacity fix: terminate telemetry work on disposal FIXED_NOT_RELEASED capacity rejection on valid composition Red 5/5 capacity cases → green; ceilings documented in VD-07 §7-4

Storage and browser files (docs/reviews/adapters/03-storage-and-browser-files.md)

ID Activation Red test command Fix commit/PR Rollout state Rollback trigger Evidence
STO-01 OPFS not composed in template; Critical for any product writer 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 backlog or journal growth Red 4 new saga cases → green 25/25 across the three OPFS suites; check:types PASS (incl. web-worker); check:browser-file-storage-boundaries PASS; lint PASS; test:unit 1511 passed with only the pre-existing environmental ci-artifact-contract failures
STO-02 Browser file runtime not composed corepack pnpm exec vitest run tests/unit/browser-file-download.test.ts fix: execute canonical browser download targets FIXED_NOT_RELEASED download navigation blocked by canonical target Red 2 failed (raw relative href handed to host) → green 17/17
STO-03 Public cache not composed corepack pnpm exec vitest run tests/unit/public-response-cache.test.ts fix: make public cache staging repairable FIXED_NOT_RELEASED composition rejection of an existing policy Red 4 cases across STO-03..05 → green 21/21; check:types PASS; check:browser-file-storage-boundaries PASS; lint PASS
STO-04 Public cache not composed corepack pnpm exec vitest run tests/unit/public-response-cache.test.ts fix: make public cache staging repairable FIXED_NOT_RELEASED restage loop or bandwidth spike
STO-05 Public cache not composed corepack pnpm exec vitest run tests/unit/public-response-cache.test.ts fix: make public cache staging repairable FIXED_NOT_RELEASED activation permitted without required capability
STO-06 IndexedDB maintenance 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 stall Red commit-phase deadline case → green 13/13; the monotonic budget is re-checked before each record's first write, a started record still finishes atomically, and a clock failure aborts the transaction
STO-07 OPFS worker protocol 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 spike Green 23/23 across the OPFS suites; every envelope carries OPFS_WORKER_PROTOCOL_VERSION = 2 and the response echoes its request kind, with a strict failure-shape decoder. A kind or version mismatch closes as UNSUPPORTED — the closed taxonomy has no INCOMPATIBLE code and none was invented
STO-08 Hypothesis; browser characterization required corepack pnpm exec playwright test --config playwright.capabilities.config.ts tests/browser-capabilities/browser-files.spec.ts none (source unchanged) UNVERIFIED n/a until characterized chromium 2/2 PASS; webkit could not launch (libevent-2.1-7t64, libavif16 missing — environmental). The existing spec does not exercise Window.showOpenFilePicker/showSaveFilePicker, which need a user gesture and a native dialog, so the receiver-binding hypothesis is neither reproduced nor refuted. No SystemPickerHost was introduced: the plan forbids implementing an uncharacterized hypothesis as a defect.
GAP-01 Documented unimplemented (VD-15) promotion evidence, not a red test PROMOTION_BLOCKED n/a
GAP-02 Documented unimplemented (VD-15) promotion evidence, not a red test PROMOTION_BLOCKED n/a
GAP-03 Documented unimplemented (VD-15) promotion evidence, not a red test PROMOTION_BLOCKED n/a

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

ID Activation Red test command Fix commit/PR Rollout state Rollback trigger Evidence
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 deadlock Stream cleanup is bounded; the generator no longer waits indefinitely on a non-cooperative 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 stuck in DRAINING Red never-settling effect and recovery → green 27/27; close() returns IDLE_TIMEOUT while a task is retained and success only after actual settlement
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 set growth Red overflow fail-close then close() → green 11/11; retired writers are waited on and only removed once actually quiesced
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 install rejection Red post-validation mutation, accessor and symbol cases → green 19/19; getters are never invoked
R-05 WebSocket protocol codec corepack pnpm exec vitest run tests/unit/realtime/websocket-protocol.test.ts fix: install bounded Browser RPC stream leases FIXED_NOT_RELEASED frame rejection regression Red oversize frame allocated an encoder copy → green 8/8; byte counts match TextEncoder including lone surrogates
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 closed-failure taxonomy drift Clock and fence reads are canonicalised into the closed Result taxonomy with single-exit cleanup
R-07 Promotion blocker concrete transport conformance evidence PROMOTION_BLOCKED n/a

Browser transfer (docs/reviews/adapters/04-browser-transfer.md)

ID Activation Red test command Fix commit/PR Rollout state Rollback trigger Evidence
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 download lease leak Red lazy-lease cases → green 29/29; open() performs no network I/O and close() is idempotent
BT-PRE-02 Wire contract gap 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 spike Red missing/V0/V2 protocol cases → green; request always declares PRESIGNED_TRANSFER_V1 and a mismatched response is closed as POLICY_REJECTED before vault registration
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 not bounding fetch Red non-cooperative fetch → green; the scope races the task, the late response body is cancelled, and a throwing scheduler leaks no 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 split break Red 6-case issuer-seam table → green; the vault re-checks method, href/origin/path agreement, credentials, byte, digest and expiry invariants itself
BT-PRE-05 Provider path decoding corepack pnpm exec vitest run tests/unit/presigned-transfer.test.ts fix: complete presigned capability and upload transport contracts FIXED_NOT_RELEASED legitimate key rejection Red %2F, %5C, %252e%252e, lowercase percent-hex and %00 → green; each segment is decoded once and must round-trip through the canonical uppercase 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 rejection isAbortSignal now requires removeEventListener and release cleanup is isolated
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 injection break Clock and scheduler are injected and snapshotted; delta-seconds and HTTP-date both resolve against the same captured now, with clock rollback clamped to 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 growth Red blocked-deadline case → green PENDING/UNKNOWN; a realm-scoped registry blocks recreating the 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 expiry check rejection Non-finite and negative clocks return UNAVAILABLE/RESUME instead of bypassing expiry
BT-UP-05 Refactor corepack pnpm exec vitest run tests/unit/resumable-upload-runtime.test.ts NOT_PERFORMED characterization drift Attempted and reverted. The five internal owners were extracted mechanically, but they require a shared-internals module for RuntimeDependencies, ActiveResolution, ReconciliationResolution, FAILURE_CODES, RECOVERIES, reportProgress, observeTerminal and ~40 further bindings to avoid an import cycle. Rather than risk the verified correctness work in this file, the extraction was reverted rather than half-landed. Behaviour and the public facade are unchanged; the file is still 2,239 lines.
BT-UP-06 Refactor corepack pnpm exec vitest run tests/unit/resumable-upload-runtime.test.ts fix: drain resumable upload teardown FIXED_NOT_RELEASED drain not quiescent Red single-flight dispose case → green 18/18; close() closes admission and starts the same drain, dispose() aborts the active-operation registry and awaits real settlement before closing the checkpoint store
BT-UP-07 Documented gap (Web Locks matrix) promotion evidence PROMOTION_BLOCKED n/a
BT-IMG-01 Type-contract change corepack pnpm check:types:test fixture fix: complete presigned capability and upload transport contracts FIXED_NOT_RELEASED caller compile break resolve() now requires the lifetime signal; tests/fixtures/typecheck/invalid-image-cdn-resolve-signal.ts + check:types:fixture:image-resolve-signal fail as designed (2 errors), and all callers pass a 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 parse rejection Red unmatched-quote cases → green 25/25
BT-IMG-03 Refactor corepack pnpm exec vitest run tests/unit/image-cdn-runtime.test.ts NOT_PERFORMED characterization drift Not performed. Same reasoning as BT-UP-05: a pure cohesion refactor of image-cdn-runtime.ts (1,340 lines) with no finding closure. image-header-metadata.ts is deliberately left intact per the review.
BT-IMG-04 Documented gap (descriptor provider) promotion evidence PROMOTION_BLOCKED n/a
BT-X-01 Shared abort mechanics corepack pnpm exec vitest run tests/unit/abortable-operation.test.ts fix: share abort and deadline mechanics FIXED_NOT_RELEASED late-result compensation regression Golden suite 8/8: first terminal owner, idempotent close, throwing scheduler, observed late rejection, late-handle compensation

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

ID Activation Red test command Fix commit/PR Rollout state Rollback trigger Evidence
SW-URL-01 Composed when capability selected corepack pnpm exec vitest run tests/unit/service-worker-runtime.test.ts fix: make Service Worker cache and removal outcomes truthful FIXED_NOT_RELEASED static asset cache miss rate Red generator-shaped root-relative asset vs absolute Request URL → green; manifest URLs canonicalized once against the registration scope
SW-01 Composed when capability selected corepack pnpm exec vitest run tests/unit/service-worker-runtime.test.ts fix: make Service Worker cache and removal outcomes truthful FIXED_NOT_RELEASED stale response served Red previous-cache hit → green network fallback; only the current release cache is opened, matched and deleted from
SW-02 Composed when capability selected corepack pnpm exec vitest run tests/unit/service-worker-runtime.test.ts fix: make Service Worker cache and removal outcomes truthful FIXED_NOT_RELEASED foreign cache deletion Red prefix deletion of ca-static-v1-not-owned and longer suffixes → green exact isOwnedStaticCacheName only
SW-03 Composed when capability selected corepack pnpm exec vitest run tests/unit/service-worker-runtime.test.ts fix: make Service Worker cache and removal outcomes truthful FIXED_NOT_RELEASED false removal success Red unregister() === false reported as UNREGISTERED → green FAILED
SW-04 Composed when capability selected corepack pnpm exec vitest run tests/unit/service-worker-runtime.test.ts fix: make Service Worker cache and removal outcomes truthful FIXED_NOT_RELEASED removal outcome misreport Red removal modes always DISABLED → green outcome matrix (ABSENT/UNREGISTERED/PURGED→DISABLED, OWNERSHIP_MISMATCH→INCOMPATIBLE, FAILED→FAILED)
SW-05 Build gate 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 build admission rejection Red tamper table (stale digest, byte length, cross-origin URL, dot segment, extension mismatch, unknown field, duplicate URL) → green; build gate decodes through the shared codec and recomputes the canonical digest
SW-06 Composed when capability selected 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 failure Red foreign-source drain, source swap and 10 concurrent activations → green 24/24; replies correlate by source object identity against the captured waiting worker or controller, and activation/reset are single-flight
SW-07 Composed when capability selected corepack pnpm exec vitest run tests/unit/service-worker-runtime.test.ts fix: harden Service Worker activation and install lifecycle FIXED_NOT_RELEASED activation blocked with zero clients An empty in-scope client set is vacuously drained; clients.matchAll() failure still rejects
SW-08 Composed when capability selected corepack pnpm exec vitest run tests/unit/service-worker-runtime.test.ts fix: harden Service Worker activation and install lifecycle FIXED_NOT_RELEASED per-client failure escalation Per-client postMessage isolation; skipWaiting() is the commit point and its failure is REJECTED, with accepted/reload notifications sent only afterwards as best effort
SW-09 Composed when capability selected corepack pnpm exec vitest run tests/unit/service-worker-runtime.test.ts fix: harden Service Worker activation and install lifecycle FIXED_NOT_RELEASED late install work observed Red late-fetch case → green; a fenced worker starts no new candidate work, late response bodies are cancelled, digest throws map to a closed outcome, and a second exact-delete runs once the abandoned install settles without extending the public bound
SW-10 Protocol V2 migration corepack pnpm exec vitest run tests/unit/service-worker-runtime.test.ts DEFERRED_TO_MIGRATION V1/V2 mismatch fail-close Not closed here. Full-identity protocol V2 is an expand → dual-read → old-writer drain → contract deployment that spans releases; the prerequisite shared manifest codec and canonical digest landed with 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 rejection Red stale/skipped/huge revision receipts → green; write and remove share one 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 backlog Deferred to the Task 16 versioned-migration PR: MUTATION_OUTCOME_UNKNOWN and the RECONCILIATION_REQUIRED lifecycle are part of the same wire/data migration as WP-03.
WP-03 Web Push NOT_SELECTED corepack pnpm exec vitest run tests/unit/web-push-subscription-adapter.test.ts DEFERRED_TO_MIGRATION backend receipt mismatch Deferred to the Task 16 versioned-migration PR: the V2 receipt requires server request-shape negotiation before a 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 loop Deferred with WP-03: expectedPreviousAssociationEpoch and replacedAssociationEpoch are part of the V2 register contract.
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 pre-abort observation drift A pre-aborted command records the requested operation instead of always 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 truncation reported degraded Client handoff and notification cleanup report countBucket and truncated; an incomplete cleanup returns { complete: false } and is 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 late native effect certainty Native notification effect is tracked as NOT_APPLIED → MAYBE_APPLIED → CONFIRMED and observed as evidence only

Final evidence (plan Task 18)

Captured after every correctness task landed.

Focused subsystem suites (fresh processes)

Suite Exit Result
tests/unit/browser-rpc + tests/unit/realtime 0 192 passed
OPFS, IndexedDB, public cache, download 0 80 passed
abortable-operation, presigned, resumable, image CDN 0 104 passed
Service Worker + Web Push 0 66 passed

Repository gates

Command Exit Result
corepack pnpm check:types 0 all six projects pass
corepack pnpm lint 0 --max-warnings=0 clean
corepack pnpm check:architecture 0 288 modules, 865 dependencies; 12 fixtures PASS; allowed PASS / 9 forbidden rejected
corepack pnpm check:diagnostics 0 8 diagnostics and 5 telemetry producers PASS
corepack pnpm check:browser-file-storage-boundaries 0 PASS, 34 rejections
corepack pnpm check:realtime-boundaries 0 PASS
git diff --check 0 clean
corepack pnpm test:component 0 126 passed
corepack pnpm test:integration 0 52 passed
corepack pnpm test:reference-feature 0 26 passed
corepack pnpm test:recipes 0 17 passed
corepack pnpm test:unit 1 1585 passed / 19 failed tests; the 19 are the unchanged pre-existing ci-artifact-contract sandbox failures
corepack pnpm check:registries 0 11 registries PASS
corepack pnpm verify:documentation 0 PASS_SCOPED
corepack pnpm check:types:fixture:image-resolve-signal 1 Expected non-zero. Negative fixture proving resolve() now rejects a call without a lifetime signal (BT-IMG-01).

test:all stops at test:unit, so the later suites above were run directly.

Final disposition of all 64 findings

State Count
FIXED_NOT_RELEASED 51
PROMOTION_BLOCKED (unchanged by design) 6
DEFERRED_TO_MIGRATION (WP-02, WP-03, WP-04, SW-10) 4
NOT_PERFORMED (BT-UP-05, BT-IMG-03 cohesion refactors) 2
UNVERIFIED (STO-08 browser hypothesis) 1

No finding remains NOT_STARTED.

Failures that are NOT claimed as green

Gate Status Attribution
tests/unit/ci-artifact-contract.test.ts 19 failed Identical to the baseline capture. Sandbox child-process, cgroup and /tmp permission behavior; unrelated to adapters. Count did not change across any task.
corepack pnpm test:browser-capabilities (webkit) 6 failed / 24 passed WebKit cannot launch: missing libevent-2.1-7t64 and libavif16. Chromium passes. UNVERIFIED, not PASS.
corepack pnpm test:browser-file-storage-removal exit 1 The reduced-removal-fixture prunes the CI contract to 77/89/102 while scripts/contracts/ci-gates.ts:481 demands exactly 81/93/105. That file, the CI contract and scripts/lib/removal-fixture.ts are unchanged since the baseline revision (git diff --name-only 4dc033c..HEAD outside src/, tests/ and docs/ lists only the two Service Worker build scripts), so this is pre-existing, not a regression from this work.
corepack pnpm test:realtime-removal exit 1 Same pre-existing reduced-fixture arithmetic.
Server/provider compatibility matrices (presigned V1, Web Push V1/V2, Service Worker V1/V2, OPFS V1/V2) not run No provider or multi-release infrastructure in this environment. UNVERIFIED.
Staging rollback drill not run Requires a staging deployment. UNVERIFIED.

Work deliberately not performed

Plan task Status Reason
Task 17 extraction (BT-UP-05, BT-IMG-03, OPFS/cache/download decomposition) NOT PERFORMED Pure cohesion refactor with no finding closure. BT-UP-05 was attempted: the five internal owners extract cleanly, but they need a shared-internals module for ~40 types, constants and helpers to avoid an import cycle, so the attempt was reverted rather than half-landed. BT-UP-06, the one item in this group with behavioural content, was implemented.
SW-10, OPFS physical/protocol V2 rollout, presigned and Web Push receipt V2 (WP-02, WP-03, WP-04) DEFERRED_TO_MIGRATION These are expand → dual-read/emit → old-writer drain → contract deployments requiring server request-shape negotiation and multi-release drain windows. The prerequisite in-repo pieces landed: the shared Service Worker manifest codec and canonical digest (SW-05), the OPFS worker protocol version and strict correlation (STO-07), and the OPFS physical generation token (STO-01).
Promotion gaps GAP-01, GAP-02, GAP-03, R-07, BT-UP-07, BT-IMG-04 PROMOTION_BLOCKED Unchanged by design. No availability state was raised and no optional capability was added to the default bootstrap.

Re-review remediation (2026-08-14)

Source: docs/reviews/adapters/RE-REVIEW-2026-08-14.md, 38 findings (High 19 / Medium 17 / Low 2) raised against 3b481eb.

GOV-02. That re-review found the previous section of this ledger closed a number of rows as FIXED_NOT_RELEASED that were in fact partial. The table below is written the other way round: a row is FIXED only where a new adversarial test failed first on the pre-fix source and passes on the landed one, and everything else says plainly that it was not done.

Landed

ID Severity Disposition Commit Red-then-green evidence
LIVE-01 High FIXED f4bfdf0 tests/integration/http-execution-v3-live-authority.test.ts — UNAVAILABLE, sync throw, async rejection and a malformed outcome each closed as UNAUTHENTICATED before the fix; all four now close as AUTH_INTEGRATION_FAILURE with zero fetches.
LIVE-02 High FIXED f4bfdf0 tests/unit/contract-registry-immutability.test.ts — a borrowed Map.prototype.clear emptied the installed profile registry before the fix.
LIVE-03 High FIXED f4bfdf0 Same suite — the composed HTTP registry was clearable and a post-composition mutation of a source policy changed totalDeadlineMs from 10000 to 999999.
LIVE-04 Medium FIXED f4bfdf0 Same integration suite — a non-cooperative fetch and reader held the port result open; a body that finished after the deadline was admitted as SUCCESS.
LIVE-05 High FIXED f4bfdf0 Same suite — a DEADLINE timeout emitted no api.request.failed.
LEG-01 High FIXED ca210d3 tests/integration/legacy-http-credential-authority.test.ts — a recovery that answered after the deadline called onUnauthenticated once; it now calls it zero times, and only an adopted no-session result notifies.
LEG-02 High FIXED ca210d3 Same suite — a bearer profile dispatched with no Authorization at all.
OPT-NET-01 Medium FIXED ca210d3 tests/unit/legacy-and-optional-network-remediation.test.ts — a loader rejection with a live signal became PAGINATION_ABORTED.
OPT-NET-02 Low FIXED ca210d3 Same suite — defineMutationIntent accepted control characters the executor rejected.
STO-RR-01 High FIXED 6a8281a tests/unit/opfs-worker-runtime.test.ts — a strict non-reentrant lease manager made FINALIZE_PUT hang forever; tests/unit/opfs-byte-store.test.ts pins that a failed finalization is no longer a plain success.
STO-RR-02 Medium FIXED 6a8281a Same suite — every failure answered with kind CAPABILITIES.
STO-RR-03 Medium FIXED 6a8281a Same suite — {code:"EVIL"} reached the caller; a non-boolean retryable and a throwing getter left the RPC to time out.
STO-RR-04 Medium FIXED 6a8281a tests/unit/public-response-cache.test.ts — a transient marker read failure deleted the active candidate.
STO-RR-05 Medium FIXED 6a8281a Same suite — one failed repair fetch destroyed every healthy asset in the release.
RPC-RR-02 Medium FIXED bd90e0c tests/unit/browser-rpc/browser-rpc-remediation.test.ts — a throwing fence and a throwing clock.sleep escaped the Result contract.
RPC-RR-03 High FIXED bd90e0c Same suite — a transport accessor ran during validation, and the installed binding registries exposed set/delete/clear.
RPC-RR-04 Medium FIXED bd90e0c Same suite — extra, inherited, symbol-keyed and throwing-getter transport values passed.
SW-RR-01 High FIXED efc577d Bounded marker reader with a read deadline, reader cancel and fatal UTF-8 decode replaces response.text().
SW-RR-02 Medium FIXED efc577d A null event.source no longer satisfies activation or reset completion.
SW-RR-03 Medium FIXED efc577d tests/unit/service-worker-web-push-remediation.test.ts plus the check:adapter-inventory gate — generator and decoder now share one exported table.
SW-RR-04 Medium FIXED efc577d cache.match rejection is closed as a miss so respondWith reaches its network fallback.
WP-RR-01 Medium FIXED efc577d focus/openWindow carry NOT_APPLIED → MAYBE_APPLIED → CONFIRMED and a late effect is observed exactly once.
TR-RR-08 Medium FIXED 69cb7e3 tests/unit/resumable-upload-http-control-plane.test.ts — a throwing getter escaped as TypeError out of createSession; symbol and non-enumerable extras passed the key check.
TR-RR-09 Medium FIXED fb5b449 tests/unit/image-cdn-runtime.test.ts — the suite pinned the contradictory private, no-store as success; the recorded fail-closed matrix now applies.
GOV-01 Low FIXED this commit scripts/check-adapter-inventory.ts diffs docs/reviews/adapters/INVENTORY.md against git ls-files src/adapters. The missing src/adapters/platform/abortable-operation.ts row is restored and the total is 119/119.
GOV-02 Medium FIXED this commit This section replaces the over-closed rows with evidence-linked dispositions and an explicit not-done list.

Not done in this pass

These are recorded as NOT_STARTED, not as partial credit. Each needs a lifecycle change larger than a contained edit, and none of them is in the default composition today.

ID Severity Why it is still open
RPC-RR-01 High Requires changing BrowserRpcTransport.openServerStream from a bare AsyncIterable to a lease with cancel(reason), waitClosed() and a physical identity, plus an active-lease registry and a DRAINING admission fence in the runtime. That is a transport contract migration, not an internal fix.
RT-RR-01 High stream-coordinator must register a physical task at the moment it calls an external effect, not only after a timeout, and close must drain every registered task.
RT-RR-02 High Queued events must re-check lifecycle and generation at execution time, and a non-cooperative timeout must discard the resume token and record recoveryRequired.
RT-RR-03 Medium live-poll-handoff-coordinator caches the first close timeout forever; only an in-flight close promise may be shared, and the writer tail must be pruned in finally.
RT-RR-04 High Handoff checkpoint work must live in the same physical-task registry as writer and recovery work.
TR-RR-01 High Presigned download close must compose the outer signal, the consumer stream signal and the deadline into one ownership signal before fetch, and cancel the reader lease explicitly.
TR-RR-02 High Upload digest computation must happen inside the operation abort scope and race the caller and deadline terminals.
TR-RR-03 High The capability vault registration contract must become a versioned exact union validated at registration time.
TR-RR-04 Medium Download delivery must preserve the closeable subtype through projection and call close() exactly once in the outermost finally.
TR-RR-05 High The shared abortable-operation primitive needs VALUE / REJECTED / TERMINAL results, a bound scheduler snapshot and atomic install-failure cleanup, and all four consumers must migrate onto it. It still has zero production importers, so the structural gate for that is deliberately not added yet — adding it now would fail CI for a defect that is documented rather than fixed.
TR-RR-06 High dispose() must bound its drain with a cleanup deadline from policy and track abort operations from the moment they are admitted.
TR-RR-07 High The image verification semaphore must hold its slot until the raw verifier settles or is confirmed cancelled, not until the wrapper returns.

None of RPC-RR-01, RT-RR-01..04 or TR-RR-01..07 may be treated as closed, and no capability they cover may be promoted, until each has its own red-then-green evidence in this table.

Gates after this pass

Run on the landed tree. Only what actually passed is claimed as passing.

Command Exit Result
corepack pnpm check:types 0 all six projects
corepack pnpm lint 0 --max-warnings=0 clean
corepack pnpm check:architecture 0 289 modules, 868 dependencies; 12 fixtures PASS
corepack pnpm check:adapter-inventory 0 119 files, 7 shared asset extensions
corepack pnpm check:registries 0 11 registries PASS
corepack pnpm check:diagnostics 0 8 diagnostics / 5 telemetry producers
corepack pnpm check:browser-file-storage-boundaries 0 PASS, 34 rejections
corepack pnpm check:realtime-boundaries 0 PASS
corepack pnpm verify:documentation 0 PASS_SCOPED
git diff --check 0 clean
tests/unit (excluding the four below) + tests/integration 0 see the exclusion table

Environmental failures, not claimed as green

Gate Status Attribution
tests/unit/ci-workflow-generation.test.ts 82 failed / 325 passed Identical on the pre-change baseline (git stash comparison). The subprocess gates it spawns cannot run in this sandbox.
tests/unit/ci-artifact-contract.test.ts fails Unchanged pre-existing sandbox, cgroup and /tmp permission behaviour.
tests/unit/security-followup.test.ts, tests/unit/provider-guardian-transaction.test.ts flaky under full-suite load Both pass in a fresh process (49 passed). They spawn and reap process groups, so their timing assertions are load sensitive.

Destructive fixture hazard — fixed

Outside the 38 findings, and found while running the suites for them.

Four sites linked the repository's installed dependencies into a throwaway fixture with a single directory symlink at <fixture>/node_modules:

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

Each fixture then runs pnpm inside itself. pnpm does not recognise the modules directory it finds there and purges it; with CI=true it does so without a prompt. The purge followed the symlink and deleted the repository's own node_modules mid-run — a test suite uninstalling the workspace it was running in. That is what produced the cascading, file-unrelated failures a full test:unit run reported, and it happened twice during this work.

scripts/lib/fixture-node-modules.ts replaces all four: node_modules is a real directory whose entries are individual symlinks, so a recursive delete unlinks the fixture's own links instead of walking through one link into the shared tree. tests/unit/fixture-node-modules.test.ts performs the exact recursive delete pnpm performs and asserts the source tree survives, and corepack pnpm check:adapter-inventory fails on any reintroduction of the directory-symlink form.

After the fix a full tests/unit + tests/integration run leaves the dependencies intact and its failures are confined to the two environmental files above plus the two flaky-under-load ones:

File Failed Attribution
tests/unit/ci-workflow-generation.test.ts 82 Identical on the pre-change baseline (git stash comparison). Its subprocess gates cannot run in this sandbox.
tests/unit/ci-artifact-contract.test.ts 19 Unchanged pre-existing sandbox, cgroup and /tmp permission behaviour.
tests/unit/security-followup.test.ts 2 Passes in isolation.
tests/unit/provider-guardian-transaction.test.ts 1 Passes in isolation.

1619 passed / 1723 total, and tests/unit/removal-fixture.test.ts, tests/unit/supply-chain.test.ts and tests/integration/security-followup-archive.test.ts — the three that had to be excluded before — now pass in the full run.

Rules for updating this ledger

  • A row moves out of NOT_STARTED only with a linked red test, its green run, and the commit id.
  • PROMOTION_BLOCKED rows never become DEFECT; they close through an authorized product selection change with the browser/provider evidence named in the plan.
  • Environmental gate failures are copied verbatim and are never claimed as green.