Speculative agentic wait queue — ETA-sized plan stacks, session columns, live insert when estimates break.
Architecture · Changelog · wait-hub · harness
Most agent wall-clock time is waiting on CI or other remote work. Agents can still plan ahead. plan-stack keeps that speculative plan as a fixed visual queue: phases stack top→start / bottom→end with cell height proportional to estimated wait. Subagents insert or replace phases; when an expectation breaks, dependents show a recalculating state, then new steps animate into the gap.
This is not wait-hub. wait-hub is the atomic wait/event bus. plan-stack owns multi-phase plans and the overview UI; it may bind a phase to a wait-hub id for completion. See ADR 0001.
Prerequisites: Node 20+.
git clone https://github.com/dev-centr/plan-stack.git "$env:code\github.com\dev-centr\plan-stack"
cd "$env:code\github.com\dev-centr\plan-stack"
node bin/plan-stackd.js --write-config --code-root $env:code
node bin/plan-stackd.js --serveIPC + UI: http://127.0.0.1:17358 (wait-hub uses 17357).
In another shell:
node bin/plan-stack.js seed
node bin/plan-stack.js overviewArtifacts (machine-local, not committed):
| Path | Role |
|---|---|
$CODE_ROOT/plan-stack.config.json |
Port, paths, wait-hub URL |
$CODE_ROOT/plan-stack.status.json |
Summary for trays / harness |
$CODE_ROOT/plan-stack.events.jsonl |
Append-only events |
$CODE_ROOT/plan-stack/plans/*.json |
Per-session plans |
node bin/plan-stack.js health
node bin/plan-stack.js upsert --harness devcentr-harness --session s1 --title "My session"
node bin/plan-stack.js complete <planId> <phaseId>Harness client id example: devcentr-harness.
| Layer | Meaning |
|---|---|
| Window | One harness |
| Column | One agent session (h-scroll) |
| Stack cell | One phase; height ∝ estimatedWaitMs |
Dock the same overview inside DevCentr harness as a cross-cutting panel (not a Linear/Grid/Tree peer). Teaching demo: HCI-Nerdz plan-stack.
- wait-hub — wait-for-completion bus
- harness — desk modes + plan-queue dock
- hive-watch — hive remotes status
- HCI-Nerdz plan-stack demo — interactive explainer
MIT — see LICENSE.
Dev-Centr — github.com/dev-centr