From 13350875c67de46f7daf7ad7c34c2b8182f70b30 Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Tue, 3 Nov 2026 20:08:56 +0900 Subject: [PATCH] =?UTF-8?q?fix(docs):=20=EC=A0=95=EB=B9=84=20=EC=9B=90?= =?UTF-8?q?=EC=9E=A5=20TR-02~04=20=EC=A6=9D=EA=B1=B0=EB=A5=BC=20=ED=85=8C?= =?UTF-8?q?=EC=8A=A4=ED=8A=B8=EA=B0=80=20=EC=98=AE=EA=B2=A8=20=EA=B0=84=20?= =?UTF-8?q?=ED=8C=8C=EC=9D=BC=EB=A1=9C=20=EB=B0=94=EA=BE=BC=EB=8B=A4=20(11?= =?UTF-8?q?01/14.3)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 문제: `check:remediation-ledger`가 3건 실패한다. TR-02: tests/unit/presigned-transfer.test.ts does not mention TR-02 TR-03: tests/unit/image-cdn-runtime.test.ts does not mention X-AUDIT-01 or X-AUDIT-02 TR-04: tests/unit/resumable-upload-runtime.test.ts does not mention TR-04 원인은 ID 표시가 지워진 것이 아니다. 2026-09-18 테스트 분할(`5cc41467`, `ec7f20e2`)이 세 테스트를 표시째 다른 파일로 옮겼고, 원장과 dispositions JSON은 옛 파일을 가리킨 채 남았다. 지금 위치: TR-02 → tests/unit/presigned-transfer-delivery.test.ts:220 TR-03 이미지 probe → tests/unit/image-cdn-browser-probe.test.ts:579 (X-AUDIT-02) TR-04 → tests/unit/resumable-upload-runtime-teardown.test.ts:80 분할 전 파일(`5cc41467^`)에 같은 주석과 테스트가 있었음을 확인했다. 고른 방법: 원장 행이 테스트가 실제로 있는 파일을 가리키게 한다. `docs/operations/adapter-remediation-dispositions.json`의 evidence 3곳과 `docs/operations/adapter-remediation-ledger.md`의 같은 행 3개를 고치고, 머리말의 "옮긴 suite" 메모에 이번 분할을 더했다. 앞 절의 실행 명령은 그 실행이 쓴 파일 그대로 둔다(그 시점 기록). 버린 대안: 옛 파일에 TR-02·TR-04·X-AUDIT ID를 적기. 그 파일에는 해당 테스트가 없어서, 검사기가 막으려는 "관계없는 suite를 가리켜 증거처럼 보이기"를 그대로 만든다. 검사기와 markers 규칙은 바꾸지 않았다. 위험·한계: 테스트를 다시 쪼개거나 옮기면 같은 식으로 깨진다. 이 검사는 게이트 밖이라 그때도 아무도 모른다. `config/ci/ungated-scripts.json`의 이 검사 사유("Later fixes removed those markers … reports stale claims")는 이제 사실과 다르지만 이 커밋 범위 밖이라 고치지 않았다. 검증: - RED(`ec7435c`): `node scripts/check-remediation-ledger.ts` 3건 실패, exit 1 - GREEN: "25 dispositions joined …; 0 open; evidence paths verified", exit 0 - 증거 suite 5개 77건 통과(`node scripts/run-vitest.ts run` 해당 파일) - `verify-documentation-readiness.ts` PASS_SCOPED, `check-ci-contract.ts` PASS, `check-adapter-inventory.ts` PASS, `tests/unit/ungated-scripts.test.ts` 10건 통과 --- .../adapter-remediation-dispositions.json | 6 +++--- docs/operations/adapter-remediation-ledger.md | 13 +++++++++---- 2 files changed, 12 insertions(+), 7 deletions(-) diff --git a/docs/operations/adapter-remediation-dispositions.json b/docs/operations/adapter-remediation-dispositions.json index d0e9edca..3c8140f9 100644 --- a/docs/operations/adapter-remediation-dispositions.json +++ b/docs/operations/adapter-remediation-dispositions.json @@ -113,7 +113,7 @@ "previous": "PARTIAL", "disposition": "FIXED", "summary": "A source lease that arrives after the delivery ended is closed exactly once by a compensator.", - "evidence": ["tests/unit/presigned-transfer.test.ts"] + "evidence": ["tests/unit/presigned-transfer-delivery.test.ts"] }, { "id": "TR-03", @@ -123,7 +123,7 @@ "markers": ["X-AUDIT-01", "X-AUDIT-02"], "evidence": [ "tests/unit/abortable-operation.test.ts", - "tests/unit/image-cdn-runtime.test.ts", + "tests/unit/image-cdn-browser-probe.test.ts", "tests/unit/resumable-upload-fetch-transport.test.ts" ] }, @@ -132,7 +132,7 @@ "previous": "PARTIAL", "disposition": "FIXED", "summary": "Teardown proves quiescence of the raw provider registry, not only of the wrappers that bound it.", - "evidence": ["tests/unit/resumable-upload-runtime.test.ts"] + "evidence": ["tests/unit/resumable-upload-runtime-teardown.test.ts"] }, { "id": "TR-05", diff --git a/docs/operations/adapter-remediation-ledger.md b/docs/operations/adapter-remediation-ledger.md index 5a958f5f..6628a54c 100644 --- a/docs/operations/adapter-remediation-ledger.md +++ b/docs/operations/adapter-remediation-ledger.md @@ -10,7 +10,12 @@ > Test paths are given at their current location. Two suites moved after > these runs: `ci-artifact-contract.test.ts` from `tests/unit/` to > `tests/system/ci-runner/`, and `provider-guardian-transaction.test.ts` from -> `tests/unit/` to `tests/integration/`. +> `tests/unit/` to `tests/integration/`. Three suites were split on +> 2026-09-18 (`5cc41467`, `ec7f20e2`) and the third re-review rows follow the +> tests that moved: TR-02 to `presigned-transfer-delivery.test.ts`, TR-03's +> image probe to `image-cdn-browser-probe.test.ts`, TR-04 to +> `resumable-upload-runtime-teardown.test.ts` (all in `tests/unit/`). The run +> commands in the earlier sections keep the file each run used. ## Containment state (plan Task 1, Step 1) @@ -431,9 +436,9 @@ than authored. | RT-01 | `PARTIAL` | `FIXED` | `tests/unit/realtime/stream-coordinator.test.ts` — an authority that re-entered `close()` from inside its own invocation got `{ok:true}` while its effect was pending; the task is registered before the collaborator is called. | | RT-02 | `NEW` | `FIXED` | Same suite — a throwing `scheduleTimeout` started a recovery that overlapped the running apply and made `close()` reject with a native `TypeError`; an uninstallable deadline now fails closed inside the result contract. | | TR-01 | `PARTIAL` | `FIXED` | `tests/unit/presigned-transfer.test.ts` — a stateful issuer could show an allowed header set to the forbidden-header check and store `Authorization`; the registration and everything nested in it is snapshotted before validation. | -| TR-02 | `PARTIAL` | `FIXED` | Same suite — a source lease that resolved after an abort was never closed; a compensator sharing the holder's close-once latch closes it exactly once. | -| TR-03 | `PARTIAL` | `FIXED` | `tests/unit/abortable-operation.test.ts`, `tests/unit/image-cdn-runtime.test.ts`, `tests/unit/resumable-upload-fetch-transport.test.ts` — the outcome depended on a hard-coded four-microtask drain, and a throwing scheduler rejected `probe()`/`execute()` natively while leaking a caller listener. The primitive now settles once by observation order, and all four consumers use it with construction-time bound timer snapshots. | -| TR-04 | `PARTIAL` | `FIXED` | `tests/unit/resumable-upload-runtime.test.ts` — a provider outliving its attempt deadline let `dispose()` report a drained runtime and close the checkpoint store; raw provider work is now its own registry and both must be quiescent. | +| TR-02 | `PARTIAL` | `FIXED` | `tests/unit/presigned-transfer-delivery.test.ts` — a source lease that resolved after an abort was never closed; a compensator sharing the holder's close-once latch closes it exactly once. | +| 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` — the outcome depended on a hard-coded four-microtask drain, and a throwing scheduler rejected `probe()`/`execute()` natively while leaking a caller listener. The primitive now settles once by observation order, and all four consumers use it with construction-time bound timer snapshots. | +| TR-04 | `PARTIAL` | `FIXED` | `tests/unit/resumable-upload-runtime-teardown.test.ts` — a provider outliving its attempt deadline let `dispose()` report a drained runtime and close the checkpoint store; raw provider work is now its own registry and both must be quiescent. | | TR-05 | `PARTIAL` | `FIXED` | `tests/unit/resumable-upload-http-control-plane.test.ts` — a stateful `sessionId` passed the regex and returned `../../unsafe`; the decoder validates an owned snapshot read exactly once. | | SW-01 | `PARTIAL` | `FIXED` | `tests/unit/service-worker-runtime.test.ts` — a single 1 MiB chunk was retained before the 257-byte ceiling was compared, a declared oversize left the body open and the reader lock was never released. | | SW-02 | `PARTIAL` | `FIXED` | `tests/unit/service-worker-web-push-remediation.test.ts` — the generator emitted `/assets/bad@name-abcdefgh.js` and the decoder then refused the manifest it had just produced; both share one canonical path predicate and the generator self-validates its output. |