fix(realtime): live-poll handoff 마감 실패를 13.1의 kind로 보고한다 (04-02)
문제: 1196b86은 stream coordinator의 마감 실패만 13.1 어휘로 바꿨다. live↔Poll handoff coordinator는 아직 네 마감을 모두 `IDLE_TIMEOUT`으로 보고한다. 설계 13.1에서 `IDLE_TIMEOUT`은 전송 idle(heartbeat/byte deadline → close + bounded reconnect)이다. 그래서 관측에서 "서버가 조용함"과 "우리 effect·checkpoint가 멈춤"을 kind로 나눌 수 없다. - switchToPoll quiescence 마감: IDLE_TIMEOUT/RECOVER - activateProbe quiescence 마감: IDLE_TIMEOUT/RECOVER - checkpoint 마감: IDLE_TIMEOUT/RECOVER - close drain 마감: IDLE_TIMEOUT/CLOSE 고른 방법: 결정 (a)를 1196b86과 같은 방식으로 적용한다. kind만 바꾸고 operation, retryable(전과 같이 true), fail-close 동작은 그대로 둔다. - quiescence 마감 → APPLY_FAILED/RECOVER. 기다리는 것은 이전 writer의 apply effect tail이다. stream coordinator의 effect 마감과 같은 kind다. APPLY_FAILED의 기본 retryable은 false라 true를 명시했다. 두 곳의 같은 분기를 `quiescenceFailure` 하나로 합쳤다. - checkpoint 마감 → PROVIDER_UNAVAILABLE/RECOVER. checkpoint authority가 throw할 때와 같은 kind다. - close drain 마감 → PROVIDER_UNAVAILABLE/CLOSE. stream·reconnect coordinator의 drain 상한과 같다. 이전부터 timer 실패도 같은 값이라 두 분기를 하나로 합쳤다. - 13.1 표: IDLE_TIMEOUT 행에서 handoff를 빼고 "내부 task 마감에는 쓰지 않는다"로 적었다. APPLY_FAILED·PROVIDER_UNAVAILABLE 행에 handoff 마감과 retryable 값, 뒤 동작을 적었다. 남은 IDLE_TIMEOUT 생성 지점은 SSE·WS의 RECEIVE·SUBSCRIBE(전송 idle)뿐이다. 버린 대안: - retryable도 kind 기본값으로(quiescence가 false가 됨): 결정 범위는 어휘다. 재시도 판단 변경은 따로 정한다. - close 마감에 CLOSED: 1196b86과 같은 이유로 버렸다. 아직 writer가 settle하지 않았는데 "닫힘"으로 읽힌다. 위험·한계: - 배럴로 공개된 handoff coordinator 결과의 kind가 바뀐다. IDLE_TIMEOUT을 보던 조합 코드는 APPLY_FAILED·PROVIDER_UNAVAILABLE을 봐야 한다. repo 안에 소비자는 없다(AVAILABLE_NOT_COMPOSED). - handoff에는 observer가 없어 관측 reason은 바뀌는 것이 없다. - 같은 APPLY_FAILED라도 stream coordinator는 retryable:false, handoff는 true다. 13.1 표에 둘 다 적었다. - realtime 레시피 gzip 40,902 → 40,878 B(한도 42,200). 검증: - RED: 기대값을 먼저 바꾸고 activateProbe quiescence 마감 테스트를 새로 넣은 뒤 live-poll-handoff-coordinator.test.ts 실행 → 7 failed | 9 passed. 7건 모두 received kind IDLE_TIMEOUT(close 4건, switchToPoll quiescence, activateProbe quiescence, checkpoint). - GREEN: `node scripts/run-vitest.ts run tests/unit/realtime` 14 files, 231 passed. - tsc app·test·recipes 통과, 바꾼 두 파일 eslint 통과, `check-optional-recipes`(source) PASS, `verify-documentation-readiness` PASS_SCOPED, `check-adapter-inventory` PASS. - 미실행: `check:architecture`(pnpm 필요). Refs: docs/reviews/2026-11-01-maturity-review/README.md 14.1 04-02, 14.4
This commit is contained in:
@@ -266,7 +266,7 @@ describe("live/poll authoritative writer handoff", () => {
|
||||
harness.clock.advance(100);
|
||||
await expect(closing).resolves.toMatchObject({
|
||||
ok: false,
|
||||
error: { kind: "IDLE_TIMEOUT", operation: "CLOSE" },
|
||||
error: { kind: "PROVIDER_UNAVAILABLE", operation: "CLOSE", retryable: true },
|
||||
});
|
||||
|
||||
release?.(realtimeSuccess(undefined));
|
||||
@@ -356,9 +356,11 @@ describe("live/poll authoritative writer handoff", () => {
|
||||
expect(harness.clock.sleepers).toHaveLength(1);
|
||||
harness.clock.advance(100);
|
||||
|
||||
// 1101/04-02. The prior writer's effect stalled (design 13.1), not the
|
||||
// transport's IDLE_TIMEOUT.
|
||||
await expect(transition).resolves.toMatchObject({
|
||||
ok: false,
|
||||
error: { kind: "IDLE_TIMEOUT", operation: "RECOVER" },
|
||||
error: { kind: "APPLY_FAILED", operation: "RECOVER", retryable: true },
|
||||
});
|
||||
expect(harness.recover).not.toHaveBeenCalled();
|
||||
expect(harness.coordinator.inspect()).toMatchObject({
|
||||
@@ -367,6 +369,32 @@ describe("live/poll authoritative writer handoff", () => {
|
||||
});
|
||||
});
|
||||
|
||||
it("fails a probe activation closed when poll cannot quiesce before the bound", async () => {
|
||||
const harness = createHarness({
|
||||
initial: "POLL",
|
||||
apply: vi.fn(async ({ writer }) =>
|
||||
writer === "POLL"
|
||||
? await new Promise<RealtimeResult<void>>(() => {})
|
||||
: realtimeSuccess(undefined),
|
||||
),
|
||||
});
|
||||
void harness.coordinator.currentWriter()!.write("hung-poll", 4);
|
||||
const live = expectProbe(harness.coordinator.beginLiveProbe());
|
||||
await flush();
|
||||
|
||||
const activation = live.activate();
|
||||
await flush();
|
||||
expect(harness.clock.sleepers).toHaveLength(1);
|
||||
harness.clock.advance(100);
|
||||
|
||||
await expect(activation).resolves.toMatchObject({
|
||||
ok: false,
|
||||
error: { kind: "APPLY_FAILED", operation: "RECOVER", retryable: true },
|
||||
});
|
||||
expect(harness.recover).not.toHaveBeenCalled();
|
||||
expect(harness.coordinator.inspect().state).toBe("CLOSED");
|
||||
});
|
||||
|
||||
it("keeps poll authoritative while probing, then recovers and drains live values serially", async () => {
|
||||
const firstLive = deferred<RealtimeResult<void>>();
|
||||
const order: string[] = [];
|
||||
@@ -550,9 +578,10 @@ describe("live/poll authoritative writer handoff", () => {
|
||||
expect(harness.clock.sleepers).toHaveLength(1);
|
||||
harness.clock.advance(100);
|
||||
|
||||
// 1101/04-02. The checkpoint authority did not answer in time.
|
||||
await expect(transition).resolves.toMatchObject({
|
||||
ok: false,
|
||||
error: { kind: "IDLE_TIMEOUT", operation: "RECOVER" },
|
||||
error: { kind: "PROVIDER_UNAVAILABLE", operation: "RECOVER", retryable: true },
|
||||
});
|
||||
expect(checkpointIsCurrent?.()).toBe(false);
|
||||
expect(harness.coordinator.inspect().state).toBe("CLOSED");
|
||||
@@ -579,7 +608,7 @@ describe("live/poll authoritative writer handoff", () => {
|
||||
harness.clock.advance(100);
|
||||
await expect(closing).resolves.toMatchObject({
|
||||
ok: false,
|
||||
error: { kind: "IDLE_TIMEOUT", operation: "CLOSE" },
|
||||
error: { kind: "PROVIDER_UNAVAILABLE", operation: "CLOSE", retryable: true },
|
||||
});
|
||||
// RT-RR-03. A second close re-runs rather than replaying a cached verdict.
|
||||
// The writer is still hung, so it still reports a timeout.
|
||||
@@ -588,7 +617,7 @@ describe("live/poll authoritative writer handoff", () => {
|
||||
harness.clock.advance(100);
|
||||
await expect(second).resolves.toMatchObject({
|
||||
ok: false,
|
||||
error: { kind: "IDLE_TIMEOUT", operation: "CLOSE" },
|
||||
error: { kind: "PROVIDER_UNAVAILABLE", operation: "CLOSE", retryable: true },
|
||||
});
|
||||
});
|
||||
|
||||
@@ -616,7 +645,7 @@ describe("live/poll authoritative writer handoff", () => {
|
||||
harness.clock.advance(100);
|
||||
await expect(first).resolves.toMatchObject({
|
||||
ok: false,
|
||||
error: { kind: "IDLE_TIMEOUT", operation: "CLOSE" },
|
||||
error: { kind: "PROVIDER_UNAVAILABLE", operation: "CLOSE", retryable: true },
|
||||
});
|
||||
|
||||
// The writer finishes after the first close gave up.
|
||||
@@ -654,7 +683,7 @@ describe("live/poll authoritative writer handoff", () => {
|
||||
harness.clock.advance(100);
|
||||
await expect(closing).resolves.toMatchObject({
|
||||
ok: false,
|
||||
error: { kind: "IDLE_TIMEOUT", operation: "CLOSE" },
|
||||
error: { kind: "PROVIDER_UNAVAILABLE", operation: "CLOSE", retryable: true },
|
||||
});
|
||||
|
||||
harness.clock.advance(100);
|
||||
|
||||
Reference in New Issue
Block a user