audit-wg-pi-compaction-continuation-seams

Metadata

Status	done
Agent identity	`02e879681e52e0a384106169be043416c4d946e850ab26b2269c57681b52a6e7`
Created	2026-08-05T20:52:42.385721234+00:00
Started	2026-08-06T05:24:26.224657198+00:00
Completed	2026-08-06T05:59:16.337158090+00:00
Tags	`pi`, `compaction`, `watchdog`, `research`

Description

Objective

Audit the current WG implementation to locate the correct authority and delivery seam for a post-compaction kick. Trace the real task-worker path from generated wrapper -> pi --mode json -> embedded @worksgood/pi extension -> raw stream observer -> PiWatchdog -> lifecycle/convergence/finalization.

Pay special attention to whether compaction_start/end, queue updates, summarization retries, agent_end, and agent_settled are projected today; whether returned ActionKinds are consumed or discarded; whether the stock continuation prompt is appended as a non-context custom entry versus actually delivered to Pi; and how terminal/wait receipts and process/continuation epochs suppress further work. Compare plugin-level, wrapper-level, RPC/JSON harness-level, and WG watchdog-level placement.

Write docs/research/wg-pi-compaction-continuation-seams.md with a sequence diagram, current gaps, security/idempotency constraints, and recommended ownership. Do not implement the fix.

Validation

Every claim cites current file/function/line evidence.
Demonstrate whether the existing watchdog currently causes a real Pi turn after threshold compaction or only records state/session markers.
Identify the exact current-process/session/route/attempt proof available at each candidate seam.
Explain how a fix composes with first-terminal-wins, finite continuation budget, wrapper exit, and convergence without creating a new attempt or retry domain.
git diff --check passes and the report names the minimal production/test files likely to change.

## Objective
Audit the current WG implementation to locate the correct authority and delivery seam for a post-compaction kick. Trace the real task-worker path from generated wrapper -> `pi --mode json` -> embedded `@worksgood/pi` extension -> raw stream observer -> `PiWatchdog` -> lifecycle/convergence/finalization.

Pay special attention to whether `compaction_start/end`, queue updates, summarization retries, `agent_end`, and `agent_settled` are projected today; whether returned `ActionKind`s are consumed or discarded; whether the stock continuation prompt is appended as a non-context custom entry versus actually delivered to Pi; and how terminal/wait receipts and process/continuation epochs suppress further work. Compare plugin-level, wrapper-level, RPC/JSON harness-level, and WG watchdog-level placement.

Write `docs/research/wg-pi-compaction-continuation-seams.md` with a sequence diagram, current gaps, security/idempotency constraints, and recommended ownership. Do not implement the fix.

## Validation
- [ ] Every claim cites current file/function/line evidence.
- [ ] Demonstrate whether the existing watchdog currently causes a real Pi turn after threshold compaction or only records state/session markers.
- [ ] Identify the exact current-process/session/route/attempt proof available at each candidate seam.
- [ ] Explain how a fix composes with first-terminal-wins, finite continuation budget, wrapper exit, and convergence without creating a new attempt or retry domain.
- [ ] `git diff --check` passes and the report names the minimal production/test files likely to change.

Depends on

(none)

Required by

done design-wg-pi-compaction-kick

✉ Messages 2 messages (2 unread)

#1user2026-08-05T20:53:17.121579118+00:00delivered

Initial audit lead: src/pi_watchdog/mod.rs ingest_native_value currently maps turn/message/tool/agent_settled but not compaction_start/end, queue_update, or current summarization_retry_* event names. src/commands/pi_stream_bridge.rs observe_live calls ingest_native_line but ignores returned ActionKind. PiWatchdog::emit_completion_prompt appends a custom session marker; no production consumer of ActionKind::LaunchSameSession/AppendCompletionPrompt was found by rg. Verify rather than assume.

#2audit-wg-pi-compaction-continuation-seams2026-08-06T05:38:00.056624889+00:00read

Completed the requested verification: report confirms missing event projection, discarded ActionKinds, non-context marker-only behavior, and recommends watchdog authority plus plugin delivery. Artifact committed as d8c9f6dc.

Log

2026-08-05T20:52:42.330899241+00:00 Task paused
2026-08-05T20:52:42.761698080+00:00 Task published
2026-08-06T05:24:23.304310163+00:00 Operator repair: removed failed quality-pass dependency after reviewing the gate artifact/log. The gate confirmed the batch satisfied all requested quality criteria but could not complete because task-scoped worker capability forbade cross-task wg show/edit. Failure remains visible on .quality-pass-pi-compaction-recovery.
2026-08-06T05:24:23.765633453+00:00 Operator repair: assignment action successfully selected Careful Programmer before its wrapper failed on missing completion candidate; removed the failed plumbing edge without hiding the failure.
2026-08-06T05:24:26.552235157+00:00 Spawned by coordinator --executor pi --model openai-codex:gpt-5.6-sol --isolation required-worktree
2026-08-06T05:24:53.684901791+00:00 Starting audit: tracing wrapper, Pi extension, stream bridge, watchdog actions, and lifecycle/finalization evidence. CLI inbox service is currently returning no response; will retry.
2026-08-06T05:30:49.024633851+00:00 Verified core gaps: current Pi JSON observer ignores compaction/queue/summarization event names; production callers discard watchdog ActionKind vectors; emitted 'prompt' is only a non-context custom marker (prompt text absent), and no in-process delivery occurs. Now tracing lifecycle/finalization proofs and drafting recommendations.
2026-08-06T05:37:11.957865256+00:00 Validated report against all task criteria: 98 repository file/line citations resolve within current files; current-marker-vs-real-turn demonstration, seam proof matrix, terminal/wait/budget/exit/convergence composition, sequence diagram, and minimal change list are present. git diff --check passes.
2026-08-06T05:37:42.357501095+00:00 Committed: d8c9f6dc — pushed to remote
2026-08-06T05:38:23.340893557+00:00 Final validation: working tree clean; git diff --check passes; docs-only audit requires no cargo build/test; pushed commit d8c9f6dc.
2026-08-06T05:40:49.336467898+00:00 Selected immutable completion candidate; prior review receipts invalidated
2026-08-06T05:41:19.665143256+00:00 Manifest b3:68cf6d67d089137216ebb2e09e9d48e2f47308843b99e5eb2a6a9d4ae31ce090 review outcome: FlipRejected
2026-08-06T05:44:35.383496064+00:00 Selected immutable completion candidate; prior review receipts invalidated
2026-08-06T05:44:58.657982433+00:00 Manifest b3:c21c565d41172bc385540cefee5420900528ed5bf1d73a0bdce394c046e50199 review outcome: FlipRejected
2026-08-06T05:46:57.752544868+00:00 Selected immutable completion candidate; prior review receipts invalidated
2026-08-06T05:47:19.101935484+00:00 Manifest b3:58d5d39cdc11142e61928a13512c182e54f4f9d3e12c9c286d113f8e484d71fb review outcome: FlipRejected
2026-08-06T05:49:28.194361374+00:00 Selected immutable completion candidate; prior review receipts invalidated
2026-08-06T05:49:58.453960112+00:00 Manifest b3:28003445a957a805782b2b3ebb518dd7d379abd688e6b62cb095ced2ad3a2549 review outcome: FlipRejected
2026-08-06T05:52:12.896280750+00:00 Selected immutable completion candidate; prior review receipts invalidated
2026-08-06T05:52:44.616015870+00:00 Manifest b3:6b05bcac58ff25bb208c9f1d93d59afe34c099dd43f19f5adb3ecfe7a5e0958b review outcome: FlipRejected
2026-08-06T05:55:12.304390026+00:00 Selected immutable completion candidate; prior review receipts invalidated
2026-08-06T05:56:15.367395340+00:00 Manifest b3:274818a0d1ef90042e7f479ed564545f405d0f75fc8a6c020c3b4630c64f9385 review outcome: Accepted
2026-08-06T05:56:34.577429877+00:00 Completion candidate accepted after exact semantic source evidence: commit 64e5e2c9, 102 bounded citations, immutable numbered source excerpts/blob OIDs, host API excerpts/digests, and exhaustive negative searches.
2026-08-06T05:58:06.634191738+00:00 Reviewed manifest b3:274818a0d1ef90042e7f479ed564545f405d0f75fc8a6c020c3b4630c64f9385 published to integration ref
2026-08-06T05:59:16.337158090+00:00 Done derived from exact reviewed manifest b3:274818a0d1ef90042e7f479ed564545f405d0f75fc8a6c020c3b4630c64f9385 and contract publication