Skip to content

Engineering archive

These notes describe work at the date shown. See the usage reference for current behavior.

PERF: origin outbox (final)

Date: 2026-09-10. Foundation HEAD: 9297256f5ee3584ab8772dd0cac54304af60843e.

Implementation: c6d0517fc3b72d62ce690dee07c73ee8cec8aba3. Docs/UI follow-up: ccad0f00c681aa7651416e7a95bff3ebed53eefa.

Canonical runtime contract: docs/superpowers/specs/2026-09-10-origin-outbox.md.

Goal

Land durable host origin delivery so publish=push does not hold the heavy execution slot. Agent TaskOutcome and OriginDelivery stay independent. This plan records the finished outbox increment on this branch; it is not a fleet rollout plan.

Runtime (this increment)

Per-turn intent + immutable delivery pin, one-time pre-policy pack and loose object-store baseline (mw-object-sync.json), then scoped producer fsync (core.fsync / core.fsyncMethod on the mirror and as Git -c). Durable locks/outbox-due/ registry; --watch recovers it once then pumps from the index. --wake spawns --watch in a new session and exits; --once is a non-spawning blocking pump (OUTBOX_BUSY if the lock is held). Closed status and dashboard project remote delivery without writing; close persists worker deliveries. No per-result history walk, no tip-only fsync, no ledger rewind of a newer target.

FLOW still owns PROTOCOL_VERSION 7 and mutation-route protocol fold-in. SCHED still owns host layout. This track does not bump either constant and does not add LeaseService::load_for_job / load_all.

Earlier PERF slices already on the same foundation (dashboard snapshot collection, combined status-logs) keep their in-repo specs (docs/superpowers/specs/2026-09-10-status-logs-wire.md). They are not re-specified here.

Verification (local fixtures only)

No live origin, credentials, global LaunchAgent install, user/global Git config, or fleet run.

Focused Rust (normal parallel; not --all-targets):

  • origin_outbox 31 passed
  • task_conversation 19 passed (read-only Closed delivery + close-learns-Pending)
  • task_turn 27 passed (Pending intent, Open/Done when origin is unreachable)
  • task_gc 20, task_materialization 17, git_transport 12, dashboard_tasks 19, agent_publication 10

UI (ui/package.json, no new packages): npm test 110 passed; npm run lint EXIT 0 with existing oxlint warnings; npm run build (tsc -b && vite build) EXIT 0. Task detail shows a DELIVERY fact; the task list does not.

cargo fmt --check and cargo clippy --lib / --test origin_outbox -D warnings were run on the implementation SHA. Combined --all-targets / full lib Clippy is integration’s gate. Unrelated tests/dashboard_service.rs manual_contains is not a passed gate of this track.

Out of scope

README and the shared pool-reliability roadmap are not updated here. No push, no main, no live worker or credential changes.