@mmerterden/multi-agent-pipeline 10.9.0 → 10.12.0

package/pipeline/schemas/prefs.schema.json

@@ -179,6 +179,17 @@
             }
           }
         },
+        "tokenScripts": {
+          "type": "object",
+          "additionalProperties": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "default": {},
+          "description": "Maps service ids to user-owned token generation scripts (absolute paths, personal - never synced). Used by the Phase 0 token pre-flight: figma_mcp silent renewal reads the .figma-oauth.json next to tokenScripts.figma_mcp; the 'Regenerate now (script)' option runs the script itself."
+        },
         "platformIdentityRouting": {
           "type": "object",
           "description": "v2.1.0+. Maps repo URL glob patterns to identity names. Used in Phase 0 to auto-select git identity + PAT based on repo origin. Prevents corporate identity leaking into personal repos and vice versa.",

package/pipeline/scripts/fixtures/install-layout.tsv

@@ -1,16 +1,16 @@
 .claude/CLAUDE.md	1
 .claude/agents	8
-.claude/commands	89
-.claude/lib	23
+.claude/commands	92
+.claude/lib	24
 .claude/multi-agent-preferences.json	1
 .claude/rules	12
 .claude/schemas	23
-.claude/scripts	171
+.claude/scripts	174
 .claude/settings.json	1
 .claude/skills	560
 .copilot/agents	8
 .copilot/copilot-instructions.md	1
-.copilot/lib	23
+.copilot/lib	24
 .copilot/schemas	23
-.copilot/scripts	171
-.copilot/skills	596
+.copilot/scripts	174
+.copilot/skills	598

package/pipeline/scripts/phase-tracker.sh

@@ -14,12 +14,14 @@
 #
 # Commands:
 #   init   <task_id>                                  Reset tracker for this task
-#   add    <phase_id> "<name>"                        Register a phase (status=pending)
+#   add    <phase_id> "<name>"                        Register a phase (status=pending); idempotent - existing id is a no-op
 #   update <phase_id> <status>                        Change status + re-render
 #   sub    <phase_id> <sub_id> "<name>" [status]      Add or update a sub-phase
-#   tokens <phase_id> <in> <out>                      Add to phase's token totals (v5.5.0)
+#   tokens <phase_id> <in> <out> [cached]             Add to phase's token totals (in = fresh input, cache-exclusive)
 #   model  <phase_id> <model_name>                    Tag phase with the LLM that produced its tokens (v8.3.0)
 #   meta   <phase_id> <key> <value>                   Set phase context (account, repos, files, now, ...)
+#   now    <phase_id> "<text>"                        Set the phase's live current-action line (quiet, 60-char cap)
+#   cost   <phase_id>|total                           Print est. USD for one phase or the whole run ("-" when unpriceable)
 #   render                                            Print current snapshot, no change
 #
 # Status enum: pending | in_progress | completed | failed | skipped
@@ -57,8 +59,11 @@ usage:
   phase-tracker.sh add    <phase_id> "<name>"
   phase-tracker.sh update <phase_id> <pending|in_progress|completed|failed|skipped>
   phase-tracker.sh sub    <phase_id> <sub_id> "<name>" [status]
-  phase-tracker.sh tokens <phase_id> <in> <out>
+  phase-tracker.sh tokens <phase_id> <in> <out> [cached]
+  phase-tracker.sh model  <phase_id> <model_name>
   phase-tracker.sh meta   <phase_id> <key> <value>
+  phase-tracker.sh now    <phase_id> "<text>"
+  phase-tracker.sh cost   <phase_id>|total
   phase-tracker.sh render
 USAGE
   exit 64
@@ -239,6 +244,37 @@ format_elapsed() {
   fi
 }
 
+# Cost table ships next to this script in every install tree (repo,
+# ~/.claude/scripts, ~/.copilot/scripts). Pricing math matches
+# render-agent-log-cost.sh exactly: tokens_in is FRESH input (cache-exclusive,
+# per the disjoint token-count contract), tokens_cached is priced at the
+# discounted cacheReadPerMtok rate, floored to cents. A missing/unparseable
+# table never fails a caller - USD simply renders empty / "-".
+COST_TABLE="$(cd "$(dirname "$0")" && pwd)/cost-table.json"
+
+# Print est. USD ("0.21") for one phase index or, with "total", the sum across
+# priceable phases. Prints "-" when nothing is priceable. Never non-zero exit.
+phase_usd() {
+  local selector="$1"  # integer phase index into .phases[], or "total"
+  [ -f "$COST_TABLE" ] || { echo "-"; return 0; }
+  local state; state="$(load_state)"
+  echo "$state" | jq -r --slurpfile prices "$COST_TABLE" --arg sel "$selector" '
+    def usd_of(p): ($prices[0].prices[p.model // ""] // null) as $rate |
+      if $rate == null then null
+      else ( ((p.tokens_in // 0) / 1000000) * $rate.inPerMtok
+           + ((p.tokens_cached // 0) / 1000000) * ($rate.cacheReadPerMtok // $rate.inPerMtok)
+           + ((p.tokens_out // 0) / 1000000) * $rate.outPerMtok )
+      end;
+    def floor_cents(u): if u == null then null else ((u * 100) | floor) / 100 end;
+    if $sel == "total" then
+      ([.phases[] | usd_of(.) | select(. != null)] | if length == 0 then "-" else (add | floor_cents(.) | tostring) end)
+    else
+      (.phases[($sel | tonumber)] // null) as $p |
+      if $p == null then "-" else (usd_of($p) | floor_cents(.) | if . == null then "-" else tostring end) end
+    end
+  ' 2>/dev/null || echo "-"
+}
+
 # Read state, atomically write it back. Atomic = write to .tmp, rename.
 load_state() {
   if [ ! -f "$TRACKER_FILE" ]; then
@@ -272,10 +308,25 @@ render() {
   # consecutive tabs (tab is in the default whitespace IFS class), which
   # silently drops empty middle columns and shifts later fields.
   # Column order:  status, started_at, completed_at, id, name,
-  #                tokens_in, tokens_out, sub_count, meta_keys_csv
+  #                tokens_in, tokens_out, sub_count, meta_keys_csv, usd
+  # The usd column is computed in the same pass with the shared pricing math;
+  # a missing/unparseable cost table yields empty usd cells, never a failure.
+  local prices_json='{"prices":{}}'
+  if [ -f "$COST_TABLE" ]; then
+    prices_json=$(cat "$COST_TABLE" 2>/dev/null) || prices_json='{"prices":{}}'
+    echo "$prices_json" | jq empty 2>/dev/null || prices_json='{"prices":{}}'
+  fi
   local phase_data
-  phase_data=$(echo "$state" | jq -r '
-    .phases // [] | .[] | [
+  phase_data=$(echo "$state" | jq -r --argjson prices "$prices_json" '
+    def usd_of(p): ($prices.prices[p.model // ""] // null) as $rate |
+      if $rate == null then null
+      else ( ((p.tokens_in // 0) / 1000000) * $rate.inPerMtok
+           + ((p.tokens_cached // 0) / 1000000) * ($rate.cacheReadPerMtok // $rate.inPerMtok)
+           + ((p.tokens_out // 0) / 1000000) * $rate.outPerMtok )
+      end;
+    .phases // []
+    | sort_by(.id | (tonumber? // 9999))
+    | .[] | [
       (.status // ""),
       (.started_at // ""),
       (.completed_at // ""),
@@ -284,20 +335,21 @@ render() {
       ((.tokens_in // 0) | tostring),
       ((.tokens_out // 0) | tostring),
       ((.subs // []) | length | tostring),
-      ((.meta // {}) | keys_unsorted | join(","))
+      ((.meta // {}) | keys_unsorted | join(",")),
+      (usd_of(.) | if . == null then "" else (((. * 100) | floor) / 100 | tostring) end)
     ] | join("")
   ')
 
   local phase_count=0
   local -a row_status=() row_started=() row_completed=() row_id=() row_name=()
-  local -a row_tin=() row_tout=() row_subcount=() row_metakeys=()
+  local -a row_tin=() row_tout=() row_subcount=() row_metakeys=() row_usd=()
   if [ -n "$phase_data" ]; then
-    local _s _st _ed _id _nm _ti _to _sc _mk
-    while IFS=$'\x1f' read -r _s _st _ed _id _nm _ti _to _sc _mk; do
+    local _s _st _ed _id _nm _ti _to _sc _mk _us
+    while IFS=$'\x1f' read -r _s _st _ed _id _nm _ti _to _sc _mk _us; do
       row_status+=("$_s"); row_started+=("$_st"); row_completed+=("$_ed")
       row_id+=("$_id");    row_name+=("$_nm")
       row_tin+=("$_ti");   row_tout+=("$_to")
-      row_subcount+=("$_sc"); row_metakeys+=("$_mk")
+      row_subcount+=("$_sc"); row_metakeys+=("$_mk"); row_usd+=("$_us")
       phase_count=$((phase_count + 1))
     done <<< "$phase_data"
   fi
@@ -367,6 +419,16 @@ render() {
       local tok_label=""
       [ "$p_ttotal" -gt 0 ] && tok_label="$(format_tokens $p_ttotal) tok"
 
+      # Est. USD suffix - only when the phase has a priced model AND tokens.
+      # "0" (floored below one cent) still renders as ~$0.00 so a priced phase
+      # is visibly priced; an unpriceable phase shows no USD at all.
+      local p_usd="${row_usd[$i]}"
+      local usd_label=""
+      if [ -n "$p_usd" ] && [ "$p_ttotal" -gt 0 ]; then
+        usd_label=$(printf '~$%.2f' "$p_usd" 2>/dev/null) || usd_label=""
+      fi
+      [ -n "$usd_label" ] && [ -n "$tok_label" ] && tok_label="${tok_label} · ${usd_label}"
+
       local right_block=""
       if [ -n "$el_label" ] && [ -n "$tok_label" ]; then
         right_block=$(printf "%b%s%b ${C_DIM}·${C_RESET} %b%s%b" "$el_color" "$el_label" "$C_RESET" "$C_DIM" "$tok_label" "$C_RESET")
@@ -385,8 +447,8 @@ render() {
       # Same Unit Separator rationale as the phase batch above.
       if [ "$pstatus" = "in_progress" ] && [ -n "${row_metakeys[$i]}" ]; then
         local meta_data key val
-        meta_data=$(echo "$state" | jq -r --argjson idx "$i" '
-          .phases[$idx].meta // {} | to_entries[] | [.key, (.value | tostring)] | join("")
+        meta_data=$(echo "$state" | jq -r --arg pid "$pid" '
+          ([.phases[] | select(.id == $pid)][0].meta) // {} | to_entries[] | [.key, (.value | tostring)] | join("")
         ')
         while IFS=$'\x1f' read -r key val; do
           [ -z "$key" ] && continue
@@ -399,8 +461,8 @@ render() {
       local sub_count="${row_subcount[$i]}"
       if [ "$sub_count" != "0" ] && [ "$sub_count" -gt 0 ] 2>/dev/null; then
         local sub_data
-        sub_data=$(echo "$state" | jq -r --argjson idx "$i" '
-          .phases[$idx].subs // [] | .[] | [(.id // ""), (.name // ""), (.status // "")] | join("")
+        sub_data=$(echo "$state" | jq -r --arg pid "$pid" '
+          ([.phases[] | select(.id == $pid)][0].subs) // [] | .[] | [(.id // ""), (.name // ""), (.status // "")] | join("")
         ')
         local j=0
         local sid sname sstatus sg connector
@@ -417,14 +479,22 @@ render() {
     done
   fi
 
-  # Total-tokens footer (v5.5.0)  -  sum phases[].tokens_in + tokens_out.
-  local total_tokens
+  # Total footer  -  tokens + est. USD (priceable phases) + cached tokens.
+  local total_tokens total_cached
   total_tokens=$(echo "$state" | jq '[.phases[] | ((.tokens_in // 0) + (.tokens_out // 0))] | add // 0')
+  total_cached=$(echo "$state" | jq '[.phases[] | (.tokens_cached // 0)] | add // 0')
   if [ "$total_tokens" -gt 0 ]; then
-    local total_label
+    local total_label total_usd total_suffix=""
     total_label=$(format_tokens "$total_tokens")
+    total_usd=$(phase_usd total)
+    if [ -n "$total_usd" ] && [ "$total_usd" != "-" ]; then
+      total_suffix=$(printf ' · ~$%.2f' "$total_usd" 2>/dev/null) || total_suffix=""
+    fi
+    if [ "$total_cached" -gt 0 ] 2>/dev/null; then
+      total_suffix="${total_suffix}  ($(format_tokens "$total_cached") cached)"
+    fi
     printf "${C_BOLD}${C_BLUE}│${C_RESET}  ${C_DIM}%s${C_RESET}\n" "$(printf '%*s' 56 '' | tr ' ' '─')"
-    printf "${C_BOLD}${C_BLUE}│${C_RESET}  ${C_BOLD}Total${C_RESET}                         ${C_BOLD}${C_CYAN}%s tok${C_RESET}\n" "$total_label"
+    printf "${C_BOLD}${C_BLUE}│${C_RESET}  ${C_BOLD}Total${C_RESET}                         ${C_BOLD}${C_CYAN}%s tok%s${C_RESET}\n" "$total_label" "$total_suffix"
   fi
 
   printf "${C_BOLD}${C_BLUE}╰────────────────────────────────────────────────────────────╯${C_RESET}\n"
@@ -459,8 +529,14 @@ case "$ACTION" in
     [ "$#" -ge 2 ] || { echo "add needs <phase_id> <name>" >&2; exit 64; }
     PID="$1"; PNAME="$2"
     state=$(load_state)
-    new=$(echo "$state" | jq --arg id "$PID" --arg name "$PNAME" \
-      '.phases += [{"id":$id,"name":$name,"status":"pending","subs":[]}]')
+    # Idempotent: a phase id that already exists is a no-op (name, status, and
+    # token history are preserved). This is what lets continuation commands
+    # (/multi-agent:finish, resume) re-declare their phase set against a
+    # pre-existing tracker without duplicating or resetting tiles.
+    new=$(echo "$state" | jq --arg id "$PID" --arg name "$PNAME" '
+      if any(.phases[]?; .id == $id) then .
+      else .phases += [{"id":$id,"name":$name,"status":"pending","subs":[]}]
+      end')
     save_state "$new"
     render
     ;;
@@ -581,12 +657,48 @@ case "$ACTION" in
     fi
     ;;
 
+  now)
+    need_jq
+    [ "$#" -ge 2 ] || { echo "now needs <phase_id> <text>" >&2; exit 64; }
+    PID="$1"; TEXT="$2"
+    # Live current-action line for the active phase. Quiet by construction:
+    # progress lines are frequent, so `now` never renders - the card picks the
+    # value up at the next boundary render/update. Truncated to 60 chars.
+    if [ "${#TEXT}" -gt 60 ]; then
+      TEXT="${TEXT:0:59}…"
+    fi
+    state=$(load_state)
+    new=$(echo "$state" | jq --arg id "$PID" --arg v "$TEXT" '
+      .phases |= map(
+        if .id == $id then .meta = ((.meta // {}) + {"Now": $v}) else . end
+      )')
+    save_state "$new"
+    emit_otel_span "phase.now" "$PID" "$TEXT" "{}"
+    ;;
+
+  cost)
+    need_jq
+    [ "$#" -ge 1 ] || { echo "cost needs <phase_id>|total" >&2; exit 64; }
+    SEL="$1"
+    if [ "$SEL" = "total" ]; then
+      phase_usd total
+    else
+      # Resolve phase id -> array index (ids are strings like "3").
+      IDX=$(load_state | jq -r --arg id "$SEL" '[.phases[]?.id] | index($id) // "-"')
+      if [ "$IDX" = "-" ] || [ -z "$IDX" ]; then
+        echo "-"
+      else
+        phase_usd "$IDX"
+      fi
+    fi
+    ;;
+
   render)
     render
     ;;
 
   *)
-    echo "phase-tracker: unknown action '$ACTION' (use init|add|update|sub|tokens|model|meta|render)" >&2
+    echo "phase-tracker: unknown action '$ACTION' (use init|add|update|sub|tokens|model|meta|now|cost|render)" >&2
     exit 64
     ;;
 esac

package/pipeline/scripts/smoke-channels-approval-gate.sh

@@ -0,0 +1,60 @@
+#!/usr/bin/env bash
+# smoke-channels-approval-gate.sh  -  contract for the channels Step 6 body preview + approval gate.
+#
+# Verifies:
+#   1. channels.md has the Step 6 gate section with the four decision options.
+#   2. The two (and only two) bypass cases are documented: autopilot + --dry-run.
+#   3. Step 7 dispatch is gated on the Step 6 approval.
+#   4. Byte-identical post rule + re-approval-on-regeneration rule present.
+#   5. Phase 7 Step 1.5 (GitHub issue comment) references the same gate.
+#   6. Required rules include the approval-before-post bullet.
+
+set -euo pipefail
+
+HERE="$(cd "$(dirname "$0")" && pwd)"
+ROOT="$(cd "$HERE/../.." && pwd)"
+CHANNELS="$ROOT/pipeline/commands/multi-agent/channels.md"
+PHASE7="$ROOT/pipeline/commands/multi-agent/refs/phases/phase-7-report.md"
+
+PASS=0
+FAIL=0
+pass() { PASS=$((PASS+1)); echo "  ✓ $1"; }
+fail() { FAIL=$((FAIL+1)); echo "  ✗ $1"; }
+
+for f in "$CHANNELS" "$PHASE7"; do
+  [ -f "$f" ] || { echo "error: missing $f" >&2; exit 1; }
+done
+
+echo "→ 1. Step 6 gate section + decision options"
+grep -Fq "Step 6  -  Body preview + approval gate" "$CHANNELS" && pass "gate section present" || fail "gate section missing"
+for opt in "Approve & post" "Edit" "Skip channels" "Cancel"; do
+  grep -Fq "$opt" "$CHANNELS" && pass "option: $opt" || fail "option missing: $opt"
+done
+
+echo ""
+echo "→ 2. bypass cases are exactly autopilot + --dry-run"
+grep -Fq "Skipped in exactly two cases" "$CHANNELS" && pass "two-case rule stated" || fail "two-case rule missing"
+grep -Fq "MULTI_AGENT_AUTOPILOT=1" "$CHANNELS" && pass "autopilot bypass documented" || fail "autopilot bypass missing"
+grep -Eq 'dry-run.*(redundant|without posting)' "$CHANNELS" && pass "dry-run bypass documented" || fail "dry-run bypass missing"
+
+echo ""
+echo "→ 3. dispatch gated on approval"
+grep -Fq "NEVER starts before the Step 6 gate resolves" "$CHANNELS" && pass "Step 6 gated" || fail "Step 6 gate wiring missing"
+
+echo ""
+echo "→ 4. byte-identical + re-approval rules"
+grep -Fq "byte-identical to the approved preview" "$CHANNELS" && pass "byte-identical rule" || fail "byte-identical rule missing"
+grep -Fq "invalidates the approval" "$CHANNELS" && pass "re-approval on regeneration" || fail "re-approval rule missing"
+
+echo ""
+echo "→ 5. Phase 7 issue-comment path uses the same gate"
+grep -Fq "same preview + approval gate as channels Step 6" "$PHASE7" && pass "Phase 7 Step 1.5 gated" || fail "Phase 7 Step 1.5 gate reference missing"
+grep -Fq "Autopilot posts directly" "$PHASE7" && pass "Phase 7 autopilot bypass" || fail "Phase 7 autopilot bypass missing"
+
+echo ""
+echo "→ 6. required-rules bullet"
+grep -Fq "**Approval before post**" "$CHANNELS" && pass "required-rules bullet present" || fail "required-rules bullet missing"
+
+echo ""
+echo "══ channels-approval-gate smoke: $PASS passed, $FAIL failed ══"
+[ "$FAIL" -eq 0 ]

package/pipeline/scripts/smoke-generate-issue.sh

@@ -0,0 +1,114 @@
+#!/usr/bin/env bash
+# smoke-generate-issue.sh  -  contract for /multi-agent:generate-task + generate-bug.
+#
+# Verifies:
+#   1. All 5 files exist (2 commands, shared ref, 2 Copilot SKILL.md).
+#   2. Frontmatter keys present on both surfaces.
+#   3. Commands delegate to refs/generate-issue.md and declare their ISSUE_TYPE.
+#   4. Approval gate documented and marked unskippable in the ref.
+#   5. Convention mining + createmeta + Agile sprint endpoints present.
+#   6. UTF-8 verbatim POST path (--rawfile + --data-binary) present.
+#   7. Profile section vocab: Task (Goal/Scope/Acceptance), Bug (Steps/Expected/Actual/Environment).
+#   8. Registration: dispatcher rows, inventory lists, count consistency (37).
+#   9. Forbidden strings absent (em-dash, section sign, the M-word, unicode_escape).
+
+set -euo pipefail
+
+HERE="$(cd "$(dirname "$0")" && pwd)"
+ROOT="$(cd "$HERE/../.." && pwd)"
+CMD_TASK="$ROOT/pipeline/commands/multi-agent/generate-task.md"
+CMD_BUG="$ROOT/pipeline/commands/multi-agent/generate-bug.md"
+REF="$ROOT/pipeline/commands/multi-agent/refs/generate-issue.md"
+SKILL_TASK="$ROOT/pipeline/skills/shared/core/multi-agent-generate-task/SKILL.md"
+SKILL_BUG="$ROOT/pipeline/skills/shared/core/multi-agent-generate-bug/SKILL.md"
+DISPATCHER="$ROOT/pipeline/commands/multi-agent.md"
+CONTRACT="$ROOT/pipeline/commands/multi-agent/refs/cross-cli-contract.md"
+SYNC="$ROOT/pipeline/commands/multi-agent/sync.md"
+HELP="$ROOT/pipeline/commands/multi-agent/help.md"
+
+PASS=0
+FAIL=0
+pass() { PASS=$((PASS+1)); echo "  ✓ $1"; }
+fail() { FAIL=$((FAIL+1)); echo "  ✗ $1"; }
+
+echo "→ 1. files exist"
+for f in "$CMD_TASK" "$CMD_BUG" "$REF" "$SKILL_TASK" "$SKILL_BUG"; do
+  if [ -f "$f" ]; then pass "exists: ${f#$ROOT/}"; else fail "missing: ${f#$ROOT/}"; fi
+done
+[ "$FAIL" -eq 0 ] || { echo "══ generate-issue smoke: $PASS passed, $FAIL failed ══"; exit 1; }
+
+echo ""
+echo "→ 2. frontmatter keys"
+for f in "$CMD_TASK" "$CMD_BUG"; do
+  head -5 "$f" | grep -q '^description:' && pass "description: ${f##*/}" || fail "description missing: ${f##*/}"
+  head -5 "$f" | grep -q '^argument-hint:' && pass "argument-hint: ${f##*/}" || fail "argument-hint missing: ${f##*/}"
+done
+for f in "$SKILL_TASK" "$SKILL_BUG"; do
+  head -8 "$f" | grep -q '^name: multi-agent-generate-' && pass "name: ${f%/*}" || fail "name missing: $f"
+  head -8 "$f" | grep -q '^language: en' && pass "language en" || fail "language missing: $f"
+  head -8 "$f" | grep -q '^user-invocable: true' && pass "user-invocable" || fail "user-invocable missing: $f"
+done
+
+echo ""
+echo "→ 3. commands delegate to the shared ref with a profile"
+for f in "$CMD_TASK" "$CMD_BUG"; do
+  grep -Fq "refs/generate-issue.md" "$f" && pass "ref link: ${f##*/}" || fail "ref link missing: ${f##*/}"
+done
+grep -Fq '`ISSUE_TYPE` | `Task`' "$CMD_TASK" && pass "ISSUE_TYPE=Task declared" || fail "ISSUE_TYPE=Task missing"
+grep -Fq '`ISSUE_TYPE` | `Bug`' "$CMD_BUG" && pass "ISSUE_TYPE=Bug declared" || fail "ISSUE_TYPE=Bug missing"
+
+echo ""
+echo "→ 4. approval gate documented and unskippable"
+grep -Fq "Full preview + approval gate (never skipped)" "$REF" && pass "gate section present" || fail "gate section missing"
+for marker in "Approve" "Edit" "Cancel" "no bypass" "Nothing was created"; do
+  grep -Fqi "$marker" "$REF" && pass "gate marker: $marker" || fail "gate marker missing: $marker"
+done
+grep -Fq "no autopilot variant" "$REF" && pass "no-autopilot rule" || fail "no-autopilot rule missing"
+
+echo ""
+echo "→ 5. mining + createmeta + agile endpoints"
+for marker in "rest/api/2/search" "rest/api/2/issue/createmeta" "rest/agile/1.0/board" "sprint?state=active" 'sprint/${SPRINT_ID}/issue' "remotelink" "attachments"; do
+  grep -Fq "$marker" "$REF" && pass "endpoint marker: $marker" || fail "endpoint marker missing: $marker"
+done
+grep -Fq "gh-sprint" "$REF" && pass "generic sprint-field detection" || fail "generic sprint-field detection missing"
+
+echo ""
+echo "→ 6. UTF-8 verbatim POST path"
+grep -Fq -- "--rawfile" "$REF" && pass "--rawfile present" || fail "--rawfile missing"
+grep -Fq -- "--data-binary" "$REF" && pass "--data-binary present" || fail "--data-binary missing"
+grep -Fqi "humanizer" "$REF" && pass "humanizer pass referenced" || fail "humanizer missing"
+
+echo ""
+echo "→ 7. profile section vocabulary"
+for s in "Goal" "Scope" "Acceptance Criteria"; do
+  grep -Fq "$s" "$CMD_TASK" && pass "task section: $s" || fail "task section missing: $s"
+done
+for s in "Steps to Reproduce" "Expected Result" "Actual Result" "Environment"; do
+  grep -Fq "$s" "$CMD_BUG" && pass "bug section: $s" || fail "bug section missing: $s"
+done
+
+echo ""
+echo "→ 8. registration + count consistency (37)"
+grep -Fq '| `generate-task' "$DISPATCHER" && pass "dispatcher routing: generate-task" || fail "dispatcher routing missing: generate-task"
+grep -Fq '| `generate-bug' "$DISPATCHER" && pass "dispatcher routing: generate-bug" || fail "dispatcher routing missing: generate-bug"
+grep -Fq "generate-task.md" "$DISPATCHER" && pass "dispatcher loading row" || fail "dispatcher loading row missing"
+grep -Fq "## 1. Command Inventory (37 commands)" "$CONTRACT" && pass "contract count = 37" || fail "contract count wrong"
+grep -Eq '(^|[ ,])generate-bug, generate-task([ ,]|$)' "$CONTRACT" && pass "contract list has both" || fail "contract list missing entries"
+grep -Fq "**37 commands are synced**" "$SYNC" && pass "sync count = 37" || fail "sync count wrong"
+SYNC_SKILL="$ROOT/pipeline/skills/shared/core/multi-agent-sync/SKILL.md"
+grep -Fq "**37 commands are synced**" "$SYNC_SKILL" && pass "sync SKILL count = 37" || fail "sync SKILL count wrong (Copilot parity)"
+grep -Fq "generate-task" "$ROOT/pipeline/skills/shared/core/multi-agent-help/SKILL.md" && pass "help SKILL lists generators" || fail "help SKILL missing generators (Copilot parity)"
+grep -c "generate-task" "$HELP" | awk '{exit !($1>=2)}' && pass "help.md has EN + TR entries" || fail "help.md entries incomplete"
+
+echo ""
+echo "→ 9. forbidden strings absent"
+MWORD="MAN""DATORY"
+for f in "$CMD_TASK" "$CMD_BUG" "$REF" "$SKILL_TASK" "$SKILL_BUG"; do
+  if grep -q $'—\|§\|…' "$f"; then fail "forbidden unicode punctuation in ${f##*/}"; else pass "punctuation clean: ${f##*/}"; fi
+  if grep -q "$MWORD" "$f"; then fail "forbidden word in ${f##*/}"; else pass "vocabulary clean: ${f##*/}"; fi
+  if grep -q "unicode_escape" "$f" && ! grep -q "Never round-trip" "$f"; then fail "unicode_escape misuse in ${f##*/}"; else pass "encoding rule clean: ${f##*/}"; fi
+done
+
+echo ""
+echo "══ generate-issue smoke: $PASS passed, $FAIL failed ══"
+[ "$FAIL" -eq 0 ]

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

@@ -250,6 +250,75 @@ 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 "→ 20. now action: quiet, truncating current-action line"
+run_plain init NOW-1 >/dev/null
+run_plain add 3 "Dev" >/dev/null
+run_plain update 3 in_progress >/dev/null
+NOW_OUT=$(run_plain now 3 "editing TopBarView.swift")
+if [ -n "$NOW_OUT" ]; then
+  fail "now must not render (got: $NOW_OUT)"
+else
+  pass "now is quiet (no stdout)"
+fi
+STATE_NOW="$HOME/.claude/logs/multi-agent/NOW-1/tracker-state.json"
+NOW_VAL=$(jq -r '.phases[0].meta.Now' "$STATE_NOW")
+[ "$NOW_VAL" = "editing TopBarView.swift" ] && pass "now stored in meta.Now" || fail "meta.Now wrong: $NOW_VAL"
+run_plain now 3 "this is a deliberately very long current action description that exceeds sixty characters"
+NOW_LEN=$(jq -r '.phases[0].meta.Now | length' "$STATE_NOW")
+[ "$NOW_LEN" = "60" ] && pass "now truncates to 60 chars" || fail "expected 60 chars, got $NOW_LEN"
+RENDER_NOW=$(run_plain render)
+echo "$RENDER_NOW" | grep -q "Now:" && pass "render shows Now: line for active phase" || fail "render missing Now: line"
+
+echo ""
+echo "→ 21. add is idempotent (continuation contract)"
+run_plain tokens 3 1000 200 >/dev/null
+run_plain add 3 "DevRenamed" >/dev/null
+CNT=$(jq '.phases | length' "$STATE_NOW")
+[ "$CNT" = "1" ] && pass "duplicate add does not append" || fail "expected 1 phase, got $CNT"
+NAME3=$(jq -r '.phases[0].name' "$STATE_NOW")
+[ "$NAME3" = "Dev" ] && pass "duplicate add preserves original name" || fail "name overwritten: $NAME3"
+TIN3=$(jq -r '.phases[0].tokens_in' "$STATE_NOW")
+[ "$TIN3" = "1000" ] && pass "duplicate add preserves token history" || fail "tokens lost: $TIN3"
+
+echo ""
+echo "→ 22. cost action prices via cost-table.json"
+run_plain init COST-1 >/dev/null
+run_plain add 3 "Dev" >/dev/null
+run_plain update 3 in_progress >/dev/null
+TRACKER_QUIET=1 run_plain model 3 opus >/dev/null
+TRACKER_QUIET=1 run_plain tokens 3 100000 20000 >/dev/null
+# opus: 0.1*5 + 0.02*25 = 0.5 + 0.5 = 1.00
+COST3=$(run_plain cost 3)
+[ "$COST3" = "1" ] && pass "cost 3 = 1 (opus 100k in + 20k out)" || fail "expected 1, got $COST3"
+TRACKER_QUIET=1 run_plain tokens 3 0 0 50000 >/dev/null
+# + 50k cached * 0.5/M = 0.025 -> total 1.025 -> floored 1.02
+COST3C=$(run_plain cost 3)
+[ "$COST3C" = "1.02" ] && pass "cached tokens priced at cacheReadPerMtok (1.02)" || fail "expected 1.02, got $COST3C"
+COSTTOT=$(run_plain cost total)
+[ "$COSTTOT" = "1.02" ] && pass "cost total sums priceable phases" || fail "expected 1.02, got $COSTTOT"
+run_plain add 4 "Review" >/dev/null
+TRACKER_QUIET=1 run_plain tokens 4 5000 1000 >/dev/null
+COST4=$(run_plain cost 4)
+[ "$COST4" = "-" ] && pass "cost is '-' for a phase without a model" || fail "expected -, got $COST4"
+COSTBAD=$(run_plain cost 9)
+[ "$COSTBAD" = "-" ] && pass "cost is '-' for unknown phase id" || fail "expected -, got $COSTBAD"
+
+echo ""
+echo "→ 23. render shows per-tile USD and cached footer"
+RENDER_COST=$(run_plain render)
+echo "$RENDER_COST" | grep -q '~\$1.02' && pass "tile shows ~\$ estimate for priced phase" || fail "render missing tile USD"
+echo "$RENDER_COST" | grep -q "cached" && pass "footer shows cached tokens" || fail "render missing cached footer"
+echo "$RENDER_COST" | grep -qE "Total.*~\\\$" && pass "footer shows total USD" || fail "render missing total USD"
+
+echo ""
+echo "→ 24. render sorts phases by numeric id (continuation ordering)"
+run_plain init ORDER-1 >/dev/null
+for pp in "0:Init" "5:Test"; do run_plain add "${pp%%:*}" "${pp#*:}" >/dev/null; done
+for pp in "4:Review" "6:Commit"; do run_plain add "${pp%%:*}" "${pp#*:}" >/dev/null; done
+ORDER_OUT=$(run_plain render | grep -oE "Phase [0-9]+" | tr -d 'Phase ' | tr '\n' ',')
+[ "$ORDER_OUT" = "0,4,5,6," ] && pass "phases render sorted by id (0,4,5,6)" || fail "order wrong: $ORDER_OUT"
+
 echo ""
 echo "══ phase-tracker smoke: $PASS passed, $FAIL failed ══"
 [ "$FAIL" -eq 0 ]

package/pipeline/scripts/smoke-progress-contract.sh

@@ -113,6 +113,15 @@ if [ "$ADOPTED" -eq 0 ]; then
   warn "no phases have adopted yet  -  this is expected until WS-4/5/6 land"
 fi
 
+echo ""
+echo "→ Live mirror cross-link (tracker coupling)"
+if grep -q "Live mirror to the phase tracker" "$CONTRACT" \
+   && grep -q "phase-tracker.sh now" "$CONTRACT"; then
+  pass "contract cross-links the tracker mirror rule"
+else
+  fail "contract missing the live-mirror cross-link to tracker-contract.md"
+fi
+
 echo ""
 echo "══ progress-contract smoke: $PASS passed, $WARN warnings, $FAIL failed ══"
 [ "$FAIL" -eq 0 ]

package/pipeline/scripts/smoke-tasklist-ordering.sh

@@ -57,6 +57,7 @@ MODE_ENTRY_DOCS=(
   "pipeline/commands/multi-agent/dev-autopilot.md"
   "pipeline/commands/multi-agent/dev-local.md"
   "pipeline/commands/multi-agent/dev-local-autopilot.md"
+  "pipeline/commands/multi-agent/finish.md"
 )
 for rel in "${MODE_ENTRY_DOCS[@]}"; do
   abs="$ROOT/$rel"