@mmerterden/multi-agent-pipeline 8.6.0

package/pipeline/scripts/smoke-phase-0-multi-repo.sh

@@ -0,0 +1,170 @@
+#!/usr/bin/env bash
+# smoke-phase-0-multi-repo.sh — asserts the v2.1.0+ multi-repo + identity-routing
+# + fetch-fail contract is fully documented in phase-0-init.md.
+#
+# This is a doc-shape smoke (Phase 0 is spec-driven; the executable behavior
+# lives in the orchestrator, not a single .sh). Failures here mean the spec
+# diverged from the schema or feedback memory.
+
+set -uo pipefail
+
+# Source-tree read (authoritative). Installed tree may lag behind.
+HERE="$(cd "$(dirname "$0")" && pwd)"
+ROOT="$(cd "$HERE/../.." && pwd)"
+PHASE0="$ROOT/pipeline/commands/multi-agent/refs/phases/phase-0-init.md"
+PREFS_SCHEMA="$ROOT/pipeline/schemas/prefs.schema.json"
+STATE_SCHEMA="$ROOT/pipeline/schemas/agent-state.schema.json"
+
+PASS=0
+FAIL=0
+pass() { PASS=$((PASS + 1)); echo "  ✓ $1"; }
+fail() { FAIL=$((FAIL + 1)); echo "  ✗ $1"; }
+
+if [ ! -f "$PHASE0" ]; then
+  fail "phase-0-init.md missing at $PHASE0"
+  echo "══ phase-0-multi-repo smoke: aborted ══"
+  exit 2
+fi
+
+# ──────────────────────────────────────────────────────────────────────────
+echo "→ 1. Multi-repo project-selection contract"
+grep -q "v2.1.0+ Multi-Repo Mode" "$PHASE0" \
+  && pass "Step 2 has 'v2.1.0+ Multi-Repo Mode' subsection" \
+  || fail "Step 2 missing v2.1.0+ multi-repo subsection"
+grep -q "state.projects\[\]" "$PHASE0" \
+  && pass "Step 2 references state.projects[] population" \
+  || fail "Step 2 missing state.projects[] reference"
+grep -q "recentGroups" "$PHASE0" \
+  && pass "Step 2 mentions recentGroups (LRU bump)" \
+  || fail "Step 2 missing recentGroups reference"
+grep -q "settings.multiRepoEnabled" "$PHASE0" \
+  && pass "Step 2 multi-repo gated by settings.multiRepoEnabled flag" \
+  || fail "Step 2 missing settings.multiRepoEnabled gate"
+
+# ──────────────────────────────────────────────────────────────────────────
+echo ""
+echo "→ 2. Branch TTL + collision detection"
+grep -q "branchTtlDays" "$PHASE0" \
+  && pass "TTL filter references settings.branchTtlDays" \
+  || fail "TTL filter not anchored to settings.branchTtlDays"
+grep -q "default 15" "$PHASE0" \
+  && pass "TTL default 15d documented" \
+  || fail "TTL default 15d not documented"
+grep -qE "Collision handling|Branch-collision" "$PHASE0" \
+  && pass "Collision handling section present" \
+  || fail "Collision handling section missing"
+# Post-10caff1: collision handling is automatic (`-v2`, `-v3` suffix), no prompt.
+grep -qE "append \`-v2\`|append -v2" "$PHASE0" \
+  && pass "Collision handling appends -v2/-v3 suffix automatically" \
+  || fail "Collision automatic-suffix rule missing"
+grep -qE "ls-remote --exit-code --heads" "$PHASE0" \
+  && pass "Remote collision probe uses ls-remote --exit-code" \
+  || fail "Remote collision probe missing ls-remote --exit-code"
+
+# ──────────────────────────────────────────────────────────────────────────
+echo ""
+echo "→ 3. Fetch-fail flow (4 options per feedback memory)"
+grep -q "Fetch-fail handling" "$PHASE0" \
+  && pass "Fetch-fail handling subsection present" \
+  || fail "Fetch-fail handling subsection missing"
+for opt in "Connect VPN" "Use cached origin" "Use local branch" "Abort"; do
+  grep -q "$opt" "$PHASE0" \
+    && pass "Fetch-fail option present: $opt" \
+    || fail "Fetch-fail option missing: $opt"
+done
+grep -q '"baseFetchStatus"' "$PHASE0" \
+  && pass "baseFetchStatus state field documented" \
+  || fail "baseFetchStatus state field missing"
+for v in "fresh" "cached-stale" "local-branch" "aborted"; do
+  grep -qE "\"$v\"" "$PHASE0" \
+    && pass "baseFetchStatus enum value: $v" \
+    || fail "baseFetchStatus enum value missing: $v"
+done
+
+# ──────────────────────────────────────────────────────────────────────────
+echo ""
+echo "→ 4. Branch-naming kebab rules + multi-repo shared name"
+grep -q "Kebab rules" "$PHASE0" \
+  && pass "Kebab rules block present" \
+  || fail "Kebab rules block missing"
+grep -q "shared across all repos" "$PHASE0" \
+  && pass "Multi-repo shared-name rule documented" \
+  || fail "Multi-repo shared-name rule missing"
+
+# ──────────────────────────────────────────────────────────────────────────
+echo ""
+echo "→ 5. Identity routing (Step 6 v2.1.0+)"
+grep -q "platformIdentityRouting" "$PHASE0" \
+  && pass "Step 6 references platformIdentityRouting" \
+  || fail "Step 6 missing platformIdentityRouting reference"
+# Post-10caff1: identity routing is ALWAYS on (no gate); previous
+# settings.identityRoutingEnabled is obsolete. Verify no stale gate remains.
+if grep -q "settings.identityRoutingEnabled" "$PHASE0"; then
+  fail "legacy settings.identityRoutingEnabled gate still present (should be removed)"
+else
+  pass "no legacy settings.identityRoutingEnabled gate"
+fi
+grep -q "longest-prefix wins\|Most-specific" "$PHASE0" \
+  && pass "Glob match semantics: longest-prefix / most-specific wins" \
+  || fail "Glob match semantics not documented"
+# Schema renamed gitIdentities → identities in v2.1.0. Step 6 must not use
+# the legacy name.
+if grep -q "gitIdentities" "$PHASE0"; then
+  fail "Step 6 still reading legacy gitIdentities path"
+else
+  pass "no legacy gitIdentities reference"
+fi
+grep -qE "per repo( independently)?" "$PHASE0" \
+  && pass "Multi-repo: identity routed per-repo" \
+  || fail "Multi-repo per-repo routing not stated"
+
+# ──────────────────────────────────────────────────────────────────────────
+echo ""
+echo "→ 6. Step 8 multi-repo worktree setup"
+grep -q "v2.1.0+ Multi-Repo Worktree Setup" "$PHASE0" \
+  && pass "Step 8 has multi-repo worktree subsection" \
+  || fail "Step 8 missing multi-repo worktree subsection"
+grep -q "serially per repo" "$PHASE0" \
+  && pass "Multi-repo worktrees created serially (not parallel)" \
+  || fail "Serial worktree creation rule missing"
+grep -q "roll back already-created worktrees" "$PHASE0" \
+  && pass "Atomicity: rollback on partial failure documented" \
+  || fail "Atomicity rollback rule missing"
+grep -q "worktree remove --force" "$PHASE0" \
+  && pass "Rollback uses git worktree remove --force" \
+  || fail "Rollback command not specified"
+
+# ──────────────────────────────────────────────────────────────────────────
+echo ""
+echo "→ 7. Recents update map (Step 0 v2.1.0+)"
+grep -q "v2.1.0+ Recents update map" "$PHASE0" \
+  && pass "Recents update map table present" \
+  || fail "Recents update map table missing"
+for path in recentProjects recentGroups recentBranches serviceStatus; do
+  grep -q "\`global\.$path" "$PHASE0" \
+    && pass "Recents map covers global.$path" \
+    || fail "Recents map missing global.$path"
+done
+
+# ──────────────────────────────────────────────────────────────────────────
+echo ""
+echo "→ 8. Schema cross-reference sanity"
+if [ -f "$STATE_SCHEMA" ]; then
+  if grep -q "projects" "$STATE_SCHEMA"; then
+    pass "agent-state.schema.json has projects field"
+  else
+    fail "agent-state.schema.json missing projects field"
+  fi
+fi
+if [ -f "$PREFS_SCHEMA" ]; then
+  for f in platformIdentityRouting recentGroups recentBranches serviceStatus settings; do
+    grep -q "\"$f\":" "$PREFS_SCHEMA" \
+      && pass "prefs schema declares $f" \
+      || fail "prefs schema missing $f"
+  done
+fi
+
+# ──────────────────────────────────────────────────────────────────────────
+echo ""
+echo "══ phase-0-multi-repo smoke: $PASS passed, $FAIL failed ══"
+[ "$FAIL" -eq 0 ]

package/pipeline/scripts/smoke-phase-6-multi.sh

@@ -0,0 +1,79 @@
+#!/usr/bin/env bash
+# smoke-phase-6-multi.sh — asserts Phase 6 multi-repo commit + per-repo PR
+# + cross-link contract is documented.
+
+set -uo pipefail
+
+PHASE6="$HOME/.claude/commands/multi-agent/refs/phases/phase-6-commit.md"
+
+PASS=0; FAIL=0
+pass() { PASS=$((PASS+1)); echo "  ✓ $1"; }
+fail() { FAIL=$((FAIL+1)); echo "  ✗ $1"; }
+
+if [ ! -f "$PHASE6" ]; then
+  fail "phase-6-commit.md missing"; echo "══ aborted ══"; exit 2
+fi
+
+echo "→ 1. v2.1.0+ Multi-Repo Mode subsection present"
+grep -q "v2.1.0+ Multi-Repo Mode" "$PHASE6" \
+  && pass "Phase 6 has v2.1.0+ Multi-Repo Mode subsection" \
+  || fail "Phase 6 missing v2.1.0+ Multi-Repo Mode subsection"
+
+echo "→ 2. Per-repo commit (shared subject + per-repo scope)"
+grep -q "shared subject" "$PHASE6" \
+  && pass "Shared subject across repos documented" \
+  || fail "Shared subject rule missing"
+grep -q "per-repo scope" "$PHASE6" \
+  && pass "Per-repo scope rule documented" \
+  || fail "Per-repo scope rule missing"
+grep -q "Part of multi-repo change" "$PHASE6" \
+  && pass "Body mentions sibling repos in commit message" \
+  || fail "Sibling repo mention missing from commit body"
+grep -q "state.projects\[i\].commit" "$PHASE6" \
+  && pass "Per-repo commit sha persisted to state" \
+  || fail "Per-repo commit sha persistence missing"
+
+echo "→ 3. Per-repo PR with sibling cross-links"
+grep -q "Sibling PRs (multi-repo task)" "$PHASE6" \
+  && pass "PR body has Sibling PRs section" \
+  || fail "PR body Sibling PRs section missing"
+grep -q "update_sibling_links" "$PHASE6" \
+  && pass "Idempotent sibling-link update documented" \
+  || fail "Sibling-link update missing"
+grep -q "version+1\|version +1" "$PHASE6" \
+  && pass "Bitbucket version-bump for PR update mentioned" \
+  || fail "Bitbucket PUT version-bump missing"
+grep -q "gh pr edit --body-file" "$PHASE6" \
+  && pass "GitHub gh pr edit for sibling-link update" \
+  || fail "GitHub PR update command missing"
+
+echo "→ 4. GitHub issue body — multi-repo PR list"
+grep -q "one row per repo" "$PHASE6" \
+  && pass "Issue body lists one row per repo" \
+  || fail "Issue body multi-repo expansion missing"
+grep -q '\*\*common:\*\*\|\*\*uicomponents:\*\*' "$PHASE6" \
+  && pass "Per-repo row format example present" \
+  || fail "Per-repo row example missing"
+
+echo "→ 5. recentGroups update on success"
+grep -q "recentGroups\` update on success" "$PHASE6" \
+  && pass "recentGroups update section present" \
+  || fail "recentGroups update section missing"
+grep -q "order-independent compare" "$PHASE6" \
+  && pass "Group dedup by order-independent compare" \
+  || fail "Order-independent compare rule missing"
+grep -q '"skipped"' "$PHASE6" \
+  && pass "Skipped repos excluded from LRU bump" \
+  || fail "LRU bump exclusion for skipped repos missing"
+
+echo "→ 6. Telemetry per-repo"
+grep -q "commit.created.*repo=\|push.attempted.*repo=" "$PHASE6" \
+  && pass "Per-repo commit/push telemetry documented" \
+  || fail "Per-repo telemetry missing"
+grep -q "multi_repo.completed" "$PHASE6" \
+  && pass "Aggregate multi_repo.completed metric present" \
+  || fail "multi_repo.completed metric missing"
+
+echo ""
+echo "══ phase-6-multi smoke: $PASS passed, $FAIL failed ══"
+[ "$FAIL" -eq 0 ]

package/pipeline/scripts/smoke-phase-banner.sh

@@ -0,0 +1,101 @@
+#!/usr/bin/env bash
+# smoke-phase-banner.sh — contract check for phase-banner.sh.
+#
+# Verifies:
+#   1. start/end/sub render with phase + name
+#   2. status enum on `end` is enforced (done|failed|skipped only)
+#   3. plain-text mode (no TTY, TERM=dumb) strips ANSI codes
+#   4. bad action / bad status → non-zero exit
+#   5. minimal args allowed (no name, no detail)
+
+set -uo pipefail
+
+HERE="$(cd "$(dirname "$0")" && pwd)"
+ROOT="$(cd "$HERE/../.." && pwd)"
+SCRIPT="$ROOT/pipeline/scripts/phase-banner.sh"
+
+PASS=0
+FAIL=0
+pass() { PASS=$((PASS+1)); echo "  ✓ $1"; }
+fail() { FAIL=$((FAIL+1)); echo "  ✗ $1"; }
+
+# Capture in plain-text mode (no TTY, TERM=dumb so colors are off).
+run_plain() {
+  TERM=dumb "$SCRIPT" "$@" 2>/tmp/banner-err
+}
+run_plain_status() {
+  local rc=0
+  TERM=dumb "$SCRIPT" "$@" >/dev/null 2>/tmp/banner-err || rc=$?
+  echo "$rc"
+}
+
+echo "→ 1. start renders phase + name"
+OUT=$(run_plain start 4 "Review" "demo")
+echo "$OUT" | grep -q "Phase 4: Review" && pass "start banner contains phase + name" || fail "start banner missing phase or name"
+echo "$OUT" | grep -q "demo" && pass "start banner contains detail" || fail "missing detail"
+
+echo ""
+echo "→ 2. end renders phase + status glyph"
+OUT_DONE=$(run_plain end 4 done "Review")
+echo "$OUT_DONE" | grep -q "✓ done" && pass "end done shows ✓" || fail "missing ✓ on done"
+OUT_FAIL=$(run_plain end 3 failed "Dev")
+echo "$OUT_FAIL" | grep -q "✗ failed" && pass "end failed shows ✗" || fail "missing ✗ on failed"
+OUT_SKIP=$(run_plain end 5 skipped "Test")
+echo "$OUT_SKIP" | grep -q "↷ skipped" && pass "end skipped shows ↷" || fail "missing ↷ on skipped"
+
+echo ""
+echo "→ 3. sub renders Sub <phase>.<sub>"
+OUT_SUB=$(run_plain sub 4 2 "Triage" "validating")
+echo "$OUT_SUB" | grep -q "Sub 4.2 Triage" && pass "sub line correct" || fail "sub line wrong: $OUT_SUB"
+
+echo ""
+echo "→ 4. plain-text mode strips ANSI"
+if echo "$OUT" | grep -q $'\033\['; then
+  fail "ANSI escape codes leaked into TERM=dumb output"
+else
+  pass "no ANSI escapes when TERM=dumb"
+fi
+
+echo ""
+echo "→ 5. bad status → exit 64"
+RC=$(run_plain_status end 4 unknownstatus "name")
+[ "$RC" = "64" ] && pass "bad status rejected (exit 64)" || fail "bad status didn't fail (rc=$RC)"
+
+echo ""
+echo "→ 6. bad action → exit 64"
+RC=$(run_plain_status flapdoodle 4)
+[ "$RC" = "64" ] && pass "bad action rejected (exit 64)" || fail "bad action didn't fail (rc=$RC)"
+
+echo ""
+echo "→ 7. missing args → exit 64"
+RC=$(run_plain_status start)
+[ "$RC" = "64" ] && pass "missing args rejected (exit 64)" || fail "missing args didn't fail (rc=$RC)"
+
+echo ""
+echo "→ 8. minimal args (no name, no detail) work"
+RC=$(run_plain_status start 0)
+[ "$RC" = "0" ] && pass "minimal start works (just phase)" || fail "minimal start failed (rc=$RC)"
+
+echo ""
+echo "→ 9. label action prints canonical EN name"
+OUT_LBL=$(TERM=dumb "$SCRIPT" label 4)
+[ "$OUT_LBL" = "Review" ] && pass "label 4 en → Review" || fail "label 4 en unexpected: '$OUT_LBL'"
+
+echo ""
+echo "→ 10. PHASE_LANG=tr resolves TR label"
+OUT_TR=$(TERM=dumb PHASE_LANG=tr "$SCRIPT" label 4)
+[ "$OUT_TR" = "İnceleme" ] && pass "label 4 tr → İnceleme" || fail "label 4 tr unexpected: '$OUT_TR'"
+
+echo ""
+echo "→ 11. auto sentinel resolves from table (en)"
+OUT_AUTO=$(run_plain start 3 auto)
+echo "$OUT_AUTO" | grep -q "Phase 3: Dev" && pass "auto en → Phase 3: Dev" || fail "auto en unexpected: $OUT_AUTO"
+
+echo ""
+echo "→ 12. auto sentinel + PHASE_LANG=tr → Faz N: <tr-label>"
+OUT_AUTO_TR=$(TERM=dumb PHASE_LANG=tr "$SCRIPT" start 3 auto)
+echo "$OUT_AUTO_TR" | grep -q "Faz 3: Geliştirme" && pass "auto tr → Faz 3: Geliştirme" || fail "auto tr unexpected: $OUT_AUTO_TR"
+
+echo ""
+echo "══ phase-banner smoke: $PASS passed, $FAIL failed ══"
+[ "$FAIL" -eq 0 ]

package/pipeline/scripts/smoke-phase-tracker.sh

@@ -0,0 +1,255 @@
+#!/usr/bin/env bash
+# smoke-phase-tracker.sh — contract check for phase-tracker.sh.
+#
+# Verifies state file shape, status transitions, sub-phase add/update,
+# enum enforcement, render output structure, and that the .tracker-current
+# pointer redirects subsequent invocations.
+
+set -uo pipefail
+
+HERE="$(cd "$(dirname "$0")" && pwd)"
+ROOT="$(cd "$HERE/../.." && pwd)"
+SCRIPT="$ROOT/pipeline/scripts/phase-tracker.sh"
+
+# Use a sandbox HOME so init writes into a temp tree, not the real one.
+SANDBOX_HOME="$(mktemp -d -t multi-agent-tracker-XXXX)"
+trap 'rm -rf "$SANDBOX_HOME"' EXIT
+export HOME="$SANDBOX_HOME"
+
+PASS=0
+FAIL=0
+pass() { PASS=$((PASS+1)); echo "  ✓ $1"; }
+fail() { FAIL=$((FAIL+1)); echo "  ✗ $1"; }
+
+need() { command -v "$1" >/dev/null 2>&1 || { echo "error: $1 is required" >&2; exit 127; }; }
+need jq
+
+run_plain() {
+  TERM=dumb "$SCRIPT" "$@" 2>/tmp/tracker-err
+}
+run_plain_status() {
+  local rc=0
+  TERM=dumb "$SCRIPT" "$@" >/dev/null 2>/tmp/tracker-err || rc=$?
+  echo "$rc"
+}
+
+STATE_FILE="$SANDBOX_HOME/.claude/logs/multi-agent/TASK-1/tracker-state.json"
+
+echo "→ 1. init creates state file with empty phases"
+run_plain init TASK-1 >/dev/null
+[ -f "$STATE_FILE" ] && pass "state file created at expected path" || fail "state file not at $STATE_FILE"
+PHASES=$(jq '.phases | length' "$STATE_FILE")
+[ "$PHASES" = "0" ] && pass "starts with empty phases array" || fail "expected 0 phases, got $PHASES"
+TASK_ID=$(jq -r '.task_id' "$STATE_FILE")
+[ "$TASK_ID" = "TASK-1" ] && pass "task_id persisted" || fail "task_id wrong: $TASK_ID"
+
+echo ""
+echo "→ 2. .tracker-current pointer is written"
+POINTER="$SANDBOX_HOME/.claude/logs/multi-agent/.tracker-current"
+[ -f "$POINTER" ] && pass "pointer file exists" || fail "pointer not created"
+[ "$(cat "$POINTER")" = "$STATE_FILE" ] && pass "pointer points at correct state file" || fail "pointer wrong"
+
+echo ""
+echo "→ 3. add appends pending phases"
+run_plain add 0 "Init" >/dev/null
+run_plain add 1 "Analysis" >/dev/null
+run_plain add 2 "Planning" >/dev/null
+PHASES=$(jq '.phases | length' "$STATE_FILE")
+[ "$PHASES" = "3" ] && pass "3 phases registered" || fail "expected 3, got $PHASES"
+P0_STATUS=$(jq -r '.phases[0].status' "$STATE_FILE")
+[ "$P0_STATUS" = "pending" ] && pass "new phase defaults to pending" || fail "expected pending, got $P0_STATUS"
+
+echo ""
+echo "→ 4. update transitions status"
+run_plain update 0 in_progress >/dev/null
+[ "$(jq -r '.phases[0].status' "$STATE_FILE")" = "in_progress" ] && pass "pending → in_progress" || fail "transition failed"
+run_plain update 0 completed >/dev/null
+[ "$(jq -r '.phases[0].status' "$STATE_FILE")" = "completed" ] && pass "in_progress → completed" || fail "transition failed"
+
+echo ""
+echo "→ 5. status enum enforcement"
+RC=$(run_plain_status update 0 nonsense)
+[ "$RC" = "64" ] && pass "bogus status rejected (exit 64)" || fail "bogus status accepted (rc=$RC)"
+
+echo ""
+echo "→ 6. sub adds and updates a sub-phase"
+run_plain sub 1 1 "Stack detection" completed >/dev/null
+run_plain sub 1 2 "Codebase scan" in_progress >/dev/null
+SUBS=$(jq '.phases[1].subs | length' "$STATE_FILE")
+[ "$SUBS" = "2" ] && pass "two subs added under phase 1" || fail "expected 2 subs, got $SUBS"
+S2_STATUS=$(jq -r '.phases[1].subs[1].status' "$STATE_FILE")
+[ "$S2_STATUS" = "in_progress" ] && pass "sub 1.2 is in_progress" || fail "wrong status: $S2_STATUS"
+# Update existing sub (same id, change status)
+run_plain sub 1 2 "Codebase scan" completed >/dev/null
+S2_STATUS=$(jq -r '.phases[1].subs[1].status' "$STATE_FILE")
+[ "$S2_STATUS" = "completed" ] && pass "existing sub updated in place (no duplicate)" || fail "in-place update failed"
+SUBS=$(jq '.phases[1].subs | length' "$STATE_FILE")
+[ "$SUBS" = "2" ] && pass "still 2 subs (no duplication)" || fail "duplicate created (got $SUBS)"
+
+echo ""
+echo "→ 7. render output contains the title and box borders"
+OUT=$(run_plain render)
+echo "$OUT" | grep -q "Pipeline: TASK-1" && pass "render shows task title" || fail "title missing"
+echo "$OUT" | grep -q '╭─' && pass "top border present" || fail "top border missing"
+echo "$OUT" | grep -q '╰──' && pass "bottom border present" || fail "bottom border missing"
+
+echo ""
+echo "→ 8. plain mode strips ANSI"
+if echo "$OUT" | grep -q $'\033\['; then
+  fail "ANSI escapes leaked into TERM=dumb output"
+else
+  pass "no ANSI under TERM=dumb"
+fi
+
+echo ""
+echo "→ 9. unknown action → exit 64"
+RC=$(run_plain_status flarfle)
+[ "$RC" = "64" ] && pass "unknown action rejected" || fail "unknown action got rc=$RC"
+
+echo ""
+echo "→ 10. update stamps started_at on first in_progress (v5.4.0)"
+run_plain init BAR-1 >/dev/null
+run_plain add 0 "Init" >/dev/null
+run_plain update 0 in_progress >/dev/null
+STATE_B1="$HOME/.claude/logs/multi-agent/BAR-1/tracker-state.json"
+STARTED=$(jq -r '.phases[0].started_at // ""' "$STATE_B1")
+[ -n "$STARTED" ] && pass "started_at stamped: $STARTED" || fail "started_at not stamped"
+
+echo ""
+echo "→ 11. update stamps completed_at on terminal status (completed/failed/skipped)"
+run_plain update 0 completed >/dev/null
+COMPLETED=$(jq -r '.phases[0].completed_at // ""' "$STATE_B1")
+[ -n "$COMPLETED" ] && pass "completed status stamps completed_at" || fail "completed did not stamp"
+
+run_plain add 1 "FailPhase" >/dev/null
+run_plain update 1 in_progress >/dev/null
+run_plain update 1 failed >/dev/null
+[ "$(jq -r '.phases[1].completed_at // ""' "$STATE_B1")" != "" ] && pass "failed stamps completed_at" || fail "failed did not stamp"
+
+run_plain add 2 "SkipPhase" >/dev/null
+run_plain update 2 skipped >/dev/null
+[ "$(jq -r '.phases[2].completed_at // ""' "$STATE_B1")" != "" ] && pass "skipped stamps completed_at" || fail "skipped did not stamp"
+
+echo ""
+echo "→ 12. started_at idempotent on repeat in_progress (v5.4.0)"
+run_plain init BAR-2 >/dev/null
+run_plain add 0 "X" >/dev/null
+run_plain update 0 in_progress >/dev/null
+STATE_B2="$HOME/.claude/logs/multi-agent/BAR-2/tracker-state.json"
+FIRST_TS=$(jq -r '.phases[0].started_at' "$STATE_B2")
+sleep 1
+run_plain update 0 in_progress >/dev/null
+SECOND_TS=$(jq -r '.phases[0].started_at' "$STATE_B2")
+[ "$FIRST_TS" = "$SECOND_TS" ] && pass "started_at preserved on repeat update" || fail "started_at changed: $FIRST_TS → $SECOND_TS"
+
+echo ""
+echo "→ 13. render draws 16-char progress bar + elapsed labels (v5.4.0)"
+run_plain init BAR-3 >/dev/null
+for p in 0:Init 1:Dev 2:Commit; do
+  run_plain add "${p%%:*}" "${p#*:}" >/dev/null
+done
+STATE_B3="$HOME/.claude/logs/multi-agent/BAR-3/tracker-state.json"
+NOW_S=$(date +%s)
+mk_ts() { date -u -r "$1" +"%Y-%m-%dT%H:%M:%SZ" 2>/dev/null || date -u -d "@$1" +"%Y-%m-%dT%H:%M:%SZ"; }
+jq \
+  --arg s0 "$(mk_ts $((NOW_S - 300)))" --arg e0 "$(mk_ts $((NOW_S - 295)))" \
+  --arg s1 "$(mk_ts $((NOW_S - 280)))" --arg e1 "$(mk_ts $((NOW_S - 120)))" \
+  --arg s2 "$(mk_ts $((NOW_S - 60)))"  --arg e2 "$(mk_ts $((NOW_S - 58)))" \
+  '.phases |= map(
+    if .id=="0" then .status="completed"|.started_at=$s0|.completed_at=$e0
+    elif .id=="1" then .status="completed"|.started_at=$s1|.completed_at=$e1
+    elif .id=="2" then .status="completed"|.started_at=$s2|.completed_at=$e2
+    else . end)' "$STATE_B3" > "$STATE_B3.new" && mv "$STATE_B3.new" "$STATE_B3"
+OUT_BAR=$(run_plain render)
+echo "$OUT_BAR" | grep -q "5s" && pass "elapsed formatted as '5s'" || fail "'5s' missing in render"
+echo "$OUT_BAR" | grep -qE "2m 40s|160s" && pass "elapsed formatted as '2m 40s' (160s)" || fail "2m-range elapsed missing"
+# v8.1.0: progress bar removed; elapsed label is the only timing visualization.
+
+echo ""
+echo "→ 14. graceful fallback on old state without timestamps (v5.4.0)"
+mkdir -p "$HOME/.claude/logs/multi-agent/OLD-SCHEMA"
+cat > "$HOME/.claude/logs/multi-agent/OLD-SCHEMA/tracker-state.json" <<'JSON'
+{"task_id":"OLD-SCHEMA","started_at":"","phases":[
+  {"id":"0","name":"Init","status":"completed","subs":[]},
+  {"id":"1","name":"Dev","status":"in_progress","subs":[]}
+]}
+JSON
+echo "$HOME/.claude/logs/multi-agent/OLD-SCHEMA/tracker-state.json" > "$HOME/.claude/logs/multi-agent/.tracker-current"
+OUT_OLD=$(TERM=dumb "$SCRIPT" render 2>&1)
+OLD_RC=$?
+[ "$OLD_RC" -eq 0 ] && pass "render exits 0 on old-schema state" || fail "render exit=$OLD_RC on old state"
+echo "$OUT_OLD" | grep -q "Phase 0" && pass "renders Phase 0 from old state" || fail "Phase 0 missing"
+# v8.1.0: progress bar removed entirely; old-schema state should still render text.
+
+echo ""
+echo "→ 15. tokens action accumulates per phase (v5.5.0)"
+run_plain init TOK-1 >/dev/null
+run_plain add 0 "Init" >/dev/null
+run_plain tokens 0 100 50 >/dev/null
+run_plain tokens 0 200 75 >/dev/null
+STATE_T1="$HOME/.claude/logs/multi-agent/TOK-1/tracker-state.json"
+TIN=$(jq -r '.phases[0].tokens_in // 0' "$STATE_T1")
+TOUT=$(jq -r '.phases[0].tokens_out // 0' "$STATE_T1")
+[ "$TIN" = "300" ] && pass "tokens_in accumulated (100+200=300)" || fail "tokens_in=$TIN expected 300"
+[ "$TOUT" = "125" ] && pass "tokens_out accumulated (50+75=125)" || fail "tokens_out=$TOUT expected 125"
+
+echo ""
+echo "→ 16. tokens validates non-negative integers (v5.5.0)"
+RC=$(run_plain_status tokens 0 foo 10)
+[ "$RC" = "64" ] && pass "non-integer rejected (exit 64)" || fail "non-integer got rc=$RC"
+RC=$(run_plain_status tokens 0 -5 10)
+[ "$RC" = "64" ] && pass "negative rejected (exit 64)" || fail "negative got rc=$RC"
+
+echo ""
+echo "→ 17. render shows token label per phase + total footer (v5.5.0)"
+run_plain init TOK-2 >/dev/null
+run_plain add 0 "Init" >/dev/null
+run_plain add 1 "Dev" >/dev/null
+run_plain tokens 0 180 50 >/dev/null       # 230 → "230"
+run_plain tokens 1 14500 4200 >/dev/null    # 18700 → "18.7k"
+OUT_TOK=$(run_plain render)
+echo "$OUT_TOK" | grep -qE "230 tok" && pass "raw count '230 tok' rendered" || fail "'230 tok' missing"
+echo "$OUT_TOK" | grep -qE "18\.7k tok" && pass "k-formatted '18.7k tok' rendered" || fail "'18.7k tok' missing"
+echo "$OUT_TOK" | grep -qE "Total.*18\.9k tok" && pass "Total footer '18.9k tok' rendered" || fail "Total footer missing (expected 18.9k)"
+
+echo ""
+echo "→ 18. pending phases without tokens render no label (v5.5.0)"
+run_plain init TOK-3 >/dev/null
+run_plain add 0 "Empty" >/dev/null
+OUT_NOP=$(run_plain render)
+# Should NOT contain " tok" string since no tokens recorded
+if echo "$OUT_NOP" | grep -qE "tok"; then
+  fail "phase without tokens should not show 'tok' label"
+else
+  pass "phase without tokens: no 'tok' label"
+fi
+# No "Total" footer when total is 0
+if echo "$OUT_NOP" | grep -q "Total"; then
+  fail "no-token tracker should not show Total footer"
+else
+  pass "no-token tracker: no Total footer"
+fi
+
+echo ""
+echo "→ 19. tokens action re-renders live (v5.6.0)"
+run_plain init TOK-LIVE >/dev/null
+run_plain add 0 "Init" >/dev/null
+run_plain update 0 in_progress >/dev/null
+# Without TRACKER_QUIET the tokens call MUST emit a render to stdout
+LIVE_OUT=$(run_plain tokens 0 500 250)
+echo "$LIVE_OUT" | grep -qE "750 tok" && pass "tokens action re-renders with new total (750 tok)" || fail "tokens did not re-render (out: $LIVE_OUT)"
+# With TRACKER_QUIET=1 the tokens call must NOT emit a render
+QUIET_OUT=$(TRACKER_QUIET=1 run_plain tokens 0 100 50)
+if [ -n "$QUIET_OUT" ]; then
+  fail "TRACKER_QUIET=1 should suppress render (got: $QUIET_OUT)"
+else
+  pass "TRACKER_QUIET=1 suppresses re-render"
+fi
+# State still updated under TRACKER_QUIET (accumulation must still happen)
+STATE_LIVE="$HOME/.claude/logs/multi-agent/TOK-LIVE/tracker-state.json"
+TIN_LIVE=$(jq -r '.phases[0].tokens_in // 0' "$STATE_LIVE")
+[ "$TIN_LIVE" = "600" ] && pass "TRACKER_QUIET still accumulates state (500+100=600)" || fail "quiet mode broke accumulation (got $TIN_LIVE)"
+
+echo ""
+echo "══ phase-tracker smoke: $PASS passed, $FAIL failed ══"
+[ "$FAIL" -eq 0 ]