PDCA Watch — Live Tick Dashboard

> v2.1.11 Sprint β FR-β4. Wraps lib/dashboard/watch.js over CC's > /loop (v2.1.71+). Read-only — only consumes state files; never > writes. Falls back to a single render when /loop is unsupported > (E-β4-01).

Arguments

| Argument | Description | Example | |----------|-------------|---------| | (none) | Auto-resolve active feature from pdca-status.primaryFeature | /pdca-watch | | <feature> | Watch a specific feature by name | /pdca-watch bkit-v2111-integrated-enhancement |

Behavior

Resolution

1. If <feature> is provided, use it verbatim.
2. Else read .bkit/state/pdca-status.json → primaryFeature, then

activeFeatures[0] as fallback.

1. If still no feature → render "No active PDCA feature. Start one

with /pdca pm <feature>" and exit.

Tick (every 30s via /loop)

For each tick, lib/dashboard/watch.js#renderTick produces a panel with:

Watch  <feature> — tick N (HH:MM:SS)
─────────────────────────────────────────────────────────────
Phase: <phase>     Match: <%>    Iter: <n / 5>
Tokens: <in> in / <out> out · samples <N>
Est cost: $<USD>
─────────────────────────────────────────────────────────────

Data sources:

• Phase / matchRate / iterationCount: pdca-status.features[<feature>]
• Token totals: last 50 lines of token-ledger.ndjson
• Cost: Sonnet-class flat estimate ($3/Mtok in, $15/Mtok out)

Termination

• Ctrl-C from user
• Feature phase === 'completed' or phase === 'archived'
• After max 60 ticks (≈30 min) — caller restarts if more time needed

CC /loop Support

| CC Version | Behavior | |------------|----------| | ≥ 2.1.71 | Native /loop 30s ticker | | < 2.1.71 | E-β4-01: single render + warning, no loop | | Unknown | Same as < 2.1.71 (fail-safe) |

The check is performed via watch.checkLoopSupport({ ccVersion }) — caller passes the resolved CC version from lib/infra/cc-version-checker.

Security

• Pure read on .bkit/state/pdca-status.json and .bkit/runtime/token-ledger.ndjson.
• Tail bounded to MAX_TAIL_LINES = 200 regardless of caller input —

defends against pathological NDJSON growth.

• No subprocess spawning, no network.
• PII redaction on the ledger is owned by the writer (Token Accountant);

watch only reads what's already redacted.

Module Dependencies

| Module | Function | Usage | |--------|----------|-------| | lib/dashboard/watch.js | resolveFeature() | Auto-detect when no arg | | lib/dashboard/watch.js | renderTick() | One frame per tick | | lib/dashboard/watch.js | tailLedger() | NDJSON tail (≤200) | | lib/dashboard/watch.js | checkLoopSupport() | CC version gate | | lib/infra/cc-version-checker.js | getCurrent() | Version source |

Examples

bash
# Auto-detect active feature
/pdca-watch

# Watch a specific feature
/pdca-watch bkit-v2111-integrated-enhancement

Related

• /pdca status — single snapshot (no loop)
• /control trust — trust score informs auto-escalation
• /pdca-fast-track — Daniel-mode auto-approve checkpoints

ARGUMENTS: