fix(opfs): 객체를 못 지운 purge가 완료와 chunk sweep을 보고하지 않는다 (0929/05-02)
문제: OPFS purge는 remove가 CONFLICT·NOT_FOUND면 그 객체를 건너뛴다.
chunk sweep 조건은 "남은 객체가 없다"가 아니라 !moreObjectsAvailable
&& !deadlineReached && !aborted라서, 다른 탭이 같은 객체를 덮어쓰는 동안
ACCOUNT_DELETION purge를 부르면 {removedObjects: 0,
moreObjectsAvailable: false, chunkSweep: "COMPLETED"}를 돌려준다. 객체와
chunk는 남아 있는데 보고는 완료로 읽힌다. port 주석은 sweep이 "once
every object is removed"라고 약속하고 runbook도 COMPLETED를 완료
조건으로 적는다.
고른 방법: 지난 리뷰의 첫 방향. 건너뛸 때 moreObjectsAvailable을 true로
두어 report가 미완료를 드러내고 sweep 조건이 sweep을 막게 한다
(chunkSweep 칸이 빠진다). port 계약은 바꾸지 않고 코드를 기존 주석에
맞춘다. 이 값을 뒤에서 false로 되돌리는 대입이 없다는 근거(다음
페이지로 넘어가는 대입은 그 페이지에 객체가 더 있을 때만 실행되고,
PRESSURE는 sweep하지 않는다)를 코드 주석에 적었다. port의
moreObjectsAvailable 주석과 runbook에 "다시 호출한다"를 더했다.
버린 대안:
- skippedObjects 칸을 report에 더하고 완료 조건을 "skippedObjects === 0
그리고 COMPLETED"로 고친다: port 추가와 문서 조건 변경이 필요하고
번들도 더 커진다. offline-indexeddb 예산 여유가 9 B뿐이다.
- 따로 skipped 플래그를 두고 끝에서 합친다: 같은 동작에 바이트가 더 든다.
위험·한계:
- offline-indexeddb 레시피 번들 36,891 -> 36,896 / 36,900 gzip B.
예산은 올리지 않았지만 여유가 4 B로 줄었다([0929] 05-04).
- 별도로 발견했고 고치지 않은 것: 여러 페이지에 걸친 purge는 마지막
페이지의 OR 대입이 앞 페이지에서 넘어올 때 넣은 true를 유지해, 다
지워도 moreObjectsAvailable true를 보고하고 sweep하지 않는다. 보수적
방향이라 다시 부르면 끝나지만 한 번에 끝나지 않는다. 코드로만
확인했고 실행하지 않았다. 동작 변경이라 범위 밖.
- 실제 브라우저(Playwright OPFS spec)에서는 돌리지 않았다.
검증:
- RED: opfs-worker-runtime "reports a purge that skipped a changing object
as unfinished"가 `- "moreObjectsAvailable": true`
`+ "moreObjectsAvailable": false`로 실패(removedObjects 0, 6번째 칸
chunkSweep 존재).
- GREEN: 같은 파일 64/64 통과. 두 번째 purge가 removedObjects 1,
chunkSweep COMPLETED, partition 파일 0개로 끝난다.
- 회귀: opfs-worker-runtime, opfs-byte-store, indexeddb-opfs-journal,
indexeddb-local-draft 4파일 104/104 통과. tsc app·test·web-worker·
recipes 통과, eslint 통과, verify-documentation-readiness PASS_SCOPED,
check-optional-recipes PASS.
Refs: docs/reviews/2026-09-29-maturity-review/05-adapters-storage-kernel.md
This commit is contained in:
@@ -433,7 +433,9 @@ VD-15 목표 runtime을 먼저 구현한다.
|
||||
journal이나 staging receipt가 참조하는 chunk는 이때도 지우지 않는다. report의
|
||||
`chunkSweep`이 `COMPLETED`여야 bytes가 지워진 것이다. `DEADLINE_REACHED`면 같은
|
||||
purge를 다시 호출하고, `STAGING_STATE_UNREADABLE`이면 읽을 수 없는 staging부터
|
||||
처리한다
|
||||
처리한다. 다른 탭이 바꾸고 있던 객체를 지우지 못하면 report는
|
||||
`moreObjectsAvailable: true`이고 `chunkSweep`이 없다. 이때도 같은 purge를 다시
|
||||
호출한다([0929] 05-02)
|
||||
- lock/worker 문제면 OPFS write off → approved capped fallback 또는 online-only
|
||||
- scope binding mismatch면 affected scope를 read-only로 격리하고 registry/
|
||||
composition을 forward fix; 다른 token path로 bytes를 이동하거나 추측 복구 금지
|
||||
|
||||
@@ -819,6 +819,11 @@ export function createOpfsByteStoreAdapter(
|
||||
});
|
||||
if (!removed.ok) {
|
||||
if (removed.error.code === "CONFLICT" || removed.error.code === "NOT_FOUND") {
|
||||
// [0929] 05-02. Another context changed this object, so it may
|
||||
// still be here: report more work and skip the chunk sweep. No
|
||||
// later assignment clears this — the page-advance one below only
|
||||
// runs when the page had more objects, and PRESSURE never sweeps.
|
||||
moreObjectsAvailable = true;
|
||||
continue;
|
||||
}
|
||||
return rebaseFailure(removed.error, "OBJECT_RECONCILE");
|
||||
|
||||
@@ -131,6 +131,11 @@ export type OpfsPolicyMaintenanceReport = Readonly<{
|
||||
inspectedObjects: number;
|
||||
removedObjects: number;
|
||||
releasedBytes: number;
|
||||
/**
|
||||
* Objects may remain. It is also `true` when another context changed an
|
||||
* object this run had to remove, which left that object in place
|
||||
* ([0929] 05-02).
|
||||
*/
|
||||
moreObjectsAvailable: boolean;
|
||||
deadlineReached: boolean;
|
||||
/**
|
||||
|
||||
@@ -2397,6 +2397,47 @@ describe("05-04 a LOGOUT or ACCOUNT_DELETION purge leaves no partition bytes beh
|
||||
bytes: [5],
|
||||
});
|
||||
});
|
||||
|
||||
// [0929] 05-02. Another tab overwrites the object the purge is removing, so
|
||||
// the purge's remove ends in CONFLICT. That purge is not finished and must
|
||||
// not claim a completed chunk sweep.
|
||||
it("reports a purge that skipped a changing object as unfinished", async () => {
|
||||
const { root, tab } = sharedRootTabs();
|
||||
const purger = tab("p", authority);
|
||||
const writer = tab("w", authority);
|
||||
expect(await putBytes(purger, "object_secret_1", [1, 2, 3])).toMatchObject({ ok: true });
|
||||
const stalled = stalledSource();
|
||||
const overwrite = writer.objects.put({
|
||||
objectId: "object_secret_1",
|
||||
expectedGeneration: 1,
|
||||
mediaType: "application/octet-stream",
|
||||
source: stalled.source,
|
||||
});
|
||||
await stalled.streaming;
|
||||
const purge = purger.maintenance.enforcePolicies({ reason: "ACCOUNT_DELETION" });
|
||||
await new Promise((resolve) => setTimeout(resolve, 20));
|
||||
stalled.release();
|
||||
|
||||
expect(await overwrite).toMatchObject({ ok: true });
|
||||
const first = await purge;
|
||||
expect(first).toMatchObject({
|
||||
ok: true,
|
||||
value: { inspectedObjects: 1, removedObjects: 0, moreObjectsAvailable: true },
|
||||
});
|
||||
expect(first.ok && first.value.chunkSweep).toBeUndefined();
|
||||
|
||||
expect(
|
||||
await purger.maintenance.enforcePolicies({ reason: "ACCOUNT_DELETION" }),
|
||||
).toMatchObject({
|
||||
ok: true,
|
||||
value: {
|
||||
removedObjects: 1,
|
||||
moreObjectsAvailable: false,
|
||||
chunkSweep: "COMPLETED",
|
||||
},
|
||||
});
|
||||
expect(filesUnder(root, scopeA)).toEqual([]);
|
||||
});
|
||||
});
|
||||
|
||||
describe("05-07 a put whose source stops lets go of the origin lock", () => {
|
||||
|
||||
Reference in New Issue
Block a user