@mmerterden/multi-agent-pipeline 8.6.0

package/pipeline/scripts/render-agent-log-cost.sh

@@ -0,0 +1,149 @@
+#!/usr/bin/env bash
+# render-agent-log-cost.sh — v8.3.0
+#
+# Renders the agent-log.md "Cost Breakdown" section: one row per phase
+# with model, tokens in/out, and estimated USD. Reads phase-tracker.json
+# (task-local) and cost-table.json (per-model prices).
+#
+# This is the agent-log counterpart to render-cost-summary.sh (which
+# targets PR/Jira channel bodies). The agent-log version is rendered
+# unconditionally on every Phase 7 run; the channels version is opt-in
+# via prefs.global.reportContent.costSummary.
+#
+# Usage:
+#   render-agent-log-cost.sh <task-id> [--otel-spans <path>]
+#
+# Exit codes:
+#   0 — section rendered (empty section still prints with placeholder row)
+#   2 — tracker JSON missing AND spans file missing (caller should skip section)
+
+set -euo pipefail
+
+TASK_ID="${1:?usage: render-agent-log-cost.sh <task-id> [--otel-spans <path>]}"
+shift || true
+
+SPANS_FILE=""
+while [ $# -gt 0 ]; do
+  case "$1" in
+    --otel-spans) SPANS_FILE="${2:-}"; shift 2 ;;
+    *) shift ;;
+  esac
+done
+
+ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
+COST_TABLE="$ROOT/pipeline/scripts/cost-table.json"
+
+command -v jq >/dev/null 2>&1 || { echo "render-agent-log-cost: jq required" >&2; exit 2; }
+
+tracker_file=""
+task_id_bare="${TASK_ID##*-}"
+for candidate in \
+  "$PWD/.worktrees/$TASK_ID/phase-tracker.json" \
+  "$PWD/.worktrees/$task_id_bare/phase-tracker.json" \
+  "$PWD/.worktrees/task-$task_id_bare/phase-tracker.json" \
+  "$HOME/.claude/logs/multi-agent/$TASK_ID/tracker-state.json" \
+  "$HOME/.claude/logs/multi-agent/$task_id_bare/tracker-state.json"
+do
+  [ -f "$candidate" ] && { tracker_file="$candidate"; break; }
+done
+
+if [ -z "$tracker_file" ] && [ -z "$SPANS_FILE" ]; then
+  exit 2
+fi
+
+rows_json="[]"
+if [ -n "$tracker_file" ]; then
+  # Tracker JSON ships in two shapes:
+  #   array shape  — phase-tracker.sh writes phases:[{id, name, model, tokens_in, ...}]
+  #   object shape — older fixture / hand-built variant phases:{ "1": {...}, ... }
+  rows_json=$(jq '
+    if (.phases | type) == "array" then
+      [.phases[] | {
+        phase: .id,
+        phase_name: (.name // .id),
+        model: (.model // "—"),
+        tokens_in: (.tokens_in // 0),
+        tokens_out: (.tokens_out // 0)
+      }]
+    else
+      [(.phases // {} | to_entries[]) | {
+        phase: .key,
+        phase_name: (.value.name // .key),
+        model: (.value.model // "—"),
+        tokens_in: (.value.tokens_in // 0),
+        tokens_out: (.value.tokens_out // 0)
+      }]
+    end
+    | sort_by(.phase | tonumber? // 999)' "$tracker_file")
+fi
+
+if [ "$rows_json" = "[]" ] && [ -n "$SPANS_FILE" ] && [ -f "$SPANS_FILE" ]; then
+  rows_json=$(jq -s '
+    [ .[] | select(.name | startswith("phase.tokens")) ] |
+    group_by(.attributes.phase_id // .attributes.phase // "?") |
+    map({
+      phase: (.[0].attributes.phase_id // .[0].attributes.phase // "?"),
+      phase_name: (.[0].attributes.phase_name // (.[0].attributes.phase_id // "?")),
+      model: (.[0].attributes.model // "—"),
+      tokens_in: ([.[].attributes.tokens_in_delta // 0] | add),
+      tokens_out: ([.[].attributes.tokens_out_delta // 0] | add)
+    }) | sort_by(.phase | tonumber? // 999)
+  ' "$SPANS_FILE")
+fi
+
+joined=$(jq -n --argjson rows "$rows_json" --slurpfile prices "$COST_TABLE" '
+  $rows | map(
+    . as $r |
+    ($prices[0].prices[$r.model] // null) as $p |
+    . + {
+      usd: (
+        if $p == null then null
+        else ( ($r.tokens_in / 1000000) * $p.inPerMtok
+             + ($r.tokens_out / 1000000) * $p.outPerMtok )
+        end
+      )
+    }
+  )
+')
+
+totals=$(jq -n --argjson rows "$joined" '
+  {
+    tokens_in:  ($rows | map(.tokens_in)  | add // 0),
+    tokens_out: ($rows | map(.tokens_out) | add // 0),
+    usd:        ($rows | map(select(.usd != null) | .usd) | add),
+    any_missing_usd: ($rows | map(.usd == null) | any)
+  }
+')
+
+printf '## Cost Breakdown\n\n'
+printf '| Phase | Model | Tokens in | Tokens out | Est. USD |\n'
+printf '|-------|-------|-----------|------------|----------|\n'
+
+n_rows=$(jq 'length' <<< "$joined")
+if [ "$n_rows" = "0" ]; then
+  printf '| *(no token data captured for %s)* | — | — | — | — |\n' "$TASK_ID"
+  exit 0
+fi
+
+jq -r '.[] |
+  [
+    (.phase_name // .phase),
+    .model,
+    (.tokens_in  | tostring | (if (length > 3) then [splits("(?=(\\d{3})+$)")] | map(select(. != "")) | join(",") else . end)),
+    (.tokens_out | tostring | (if (length > 3) then [splits("(?=(\\d{3})+$)")] | map(select(. != "")) | join(",") else . end)),
+    (if .usd == null then "—" else "$" + ((.usd * 100 | floor) / 100 | tostring) end)
+  ] | "| " + join(" | ") + " |"
+' <<< "$joined"
+
+ti=$(jq -r '.tokens_in  | tostring | (if (length > 3) then [splits("(?=(\\d{3})+$)")] | map(select(. != "")) | join(",") else . end)' <<< "$totals")
+to=$(jq -r '.tokens_out | tostring | (if (length > 3) then [splits("(?=(\\d{3})+$)")] | map(select(. != "")) | join(",") else . end)' <<< "$totals")
+usd_total=$(jq -r 'if .usd == null then "—" else "$" + ((.usd * 100 | floor) / 100 | tostring) end' <<< "$totals")
+missing=$(jq -r '.any_missing_usd' <<< "$totals")
+
+printf '| **Total** |  | **%s** | **%s** | **%s** |\n' "$ti" "$to" "$usd_total"
+
+if [ "$missing" = "true" ]; then
+  printf '\n*USD unavailable for one or more rows — add model id to `pipeline/scripts/cost-table.json`.*\n'
+fi
+
+exit 0

package/pipeline/scripts/render-cost-summary.sh

@@ -0,0 +1,137 @@
+#!/usr/bin/env bash
+# render-cost-summary.sh — v6.1.J
+#
+# Reads phase-tracker state + cost-table.json, prints the "### Cost Summary"
+# markdown section to stdout. Consumed by /multi-agent:channels when
+# `reportContent.costSummary === true`.
+#
+# Usage: render-cost-summary.sh <task-id> [--otel-spans <path>]
+#
+# Exit codes:
+#   0 — table rendered (empty table still prints with header + "no data" row)
+#   2 — tracker JSON missing AND spans file missing (caller should skip section)
+
+set -euo pipefail
+
+TASK_ID="${1:?usage: render-cost-summary.sh <task-id> [--otel-spans <path>]}"
+shift || true
+
+SPANS_FILE=""
+while [ $# -gt 0 ]; do
+  case "$1" in
+    --otel-spans) SPANS_FILE="${2:-}"; shift 2 ;;
+    *) shift ;;
+  esac
+done
+
+ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
+COST_TABLE="$ROOT/pipeline/scripts/cost-table.json"
+
+command -v jq >/dev/null 2>&1 || { echo "render-cost-summary: jq required" >&2; exit 2; }
+
+# Tracker JSON location convention: .worktrees/<TASK>/phase-tracker.json
+# Accept both the full key (e.g. "{JIRA_KEY}-1234") and the numeric-only
+# variant — the Jira-prefix is project-specific, so strip anything before
+# the first dash when trying the fallback.
+tracker_file=""
+task_id_bare="${TASK_ID##*-}"
+for candidate in \
+  "$PWD/.worktrees/$TASK_ID/phase-tracker.json" \
+  "$PWD/.worktrees/$task_id_bare/phase-tracker.json" \
+  "$PWD/.worktrees/task-$task_id_bare/phase-tracker.json"
+do
+  [ -f "$candidate" ] && { tracker_file="$candidate"; break; }
+done
+
+if [ -z "$tracker_file" ] && [ -z "$SPANS_FILE" ]; then
+  exit 2
+fi
+
+# Build rows — prefer tracker JSON, fall back to spans aggregation
+rows_json="[]"
+if [ -n "$tracker_file" ]; then
+  rows_json=$(jq '[
+    (.phases // {} | to_entries[]) |
+    select(.value.tokens_in // 0 > 0 or .value.tokens_out // 0 > 0) |
+    {
+      phase: .key,
+      phase_name: (.value.name // .key),
+      model: (.value.model // "opus"),
+      tokens_in: (.value.tokens_in // 0),
+      tokens_out: (.value.tokens_out // 0)
+    }
+  ]' "$tracker_file")
+fi
+
+if [ "$rows_json" = "[]" ] && [ -n "$SPANS_FILE" ] && [ -f "$SPANS_FILE" ]; then
+  rows_json=$(jq -s '
+    [ .[] | select(.name | startswith("phase.tokens")) ] |
+    group_by(.attributes.phase_id // .attributes.phase // "?") |
+    map({
+      phase: (.[0].attributes.phase_id // .[0].attributes.phase // "?"),
+      phase_name: (.[0].attributes.phase_name // (.[0].attributes.phase_id // "?")),
+      model: (.[0].attributes.model // "opus"),
+      tokens_in: ([.[].attributes.tokens_in_delta // 0] | add),
+      tokens_out: ([.[].attributes.tokens_out_delta // 0] | add)
+    })
+  ' "$SPANS_FILE")
+fi
+
+# Compute USD per row using cost-table
+joined=$(jq -n --argjson rows "$rows_json" --slurpfile prices "$COST_TABLE" '
+  $rows | map(
+    . as $r |
+    ($prices[0].prices[$r.model] // null) as $p |
+    . + {
+      usd: (
+        if $p == null then null
+        else ( ($r.tokens_in / 1000000) * $p.inPerMtok
+             + ($r.tokens_out / 1000000) * $p.outPerMtok )
+        end
+      )
+    }
+  )
+')
+
+totals=$(jq -n --argjson rows "$joined" '
+  {
+    tokens_in:  ($rows | map(.tokens_in)  | add // 0),
+    tokens_out: ($rows | map(.tokens_out) | add // 0),
+    usd:        ($rows | map(select(.usd != null) | .usd) | add),
+    any_missing_usd: ($rows | map(.usd == null) | any)
+  }
+')
+
+# Render markdown
+printf '### Cost Summary\n'
+printf '| Phase | Model | Tokens in | Tokens out | Est. USD |\n'
+printf '|-------|-------|-----------|------------|----------|\n'
+
+n_rows=$(jq 'length' <<< "$joined")
+if [ "$n_rows" = "0" ]; then
+  printf '| *(no tracker data for %s)* | — | — | — | — |\n' "$TASK_ID"
+  exit 0
+fi
+
+jq -r '.[] |
+  [
+    (.phase_name // .phase),
+    .model,
+    (.tokens_in  | tostring | (if (length > 3) then [splits("(?=(\\d{3})+$)")] | map(select(. != "")) | join(",") else . end)),
+    (.tokens_out | tostring | (if (length > 3) then [splits("(?=(\\d{3})+$)")] | map(select(. != "")) | join(",") else . end)),
+    (if .usd == null then "—" else "$" + ((.usd * 100 | floor) / 100 | tostring) end)
+  ] | "| " + join(" | ") + " |"
+' <<< "$joined"
+
+ti=$(jq -r '.tokens_in  | tostring | (if (length > 3) then [splits("(?=(\\d{3})+$)")] | map(select(. != "")) | join(",") else . end)' <<< "$totals")
+to=$(jq -r '.tokens_out | tostring | (if (length > 3) then [splits("(?=(\\d{3})+$)")] | map(select(. != "")) | join(",") else . end)' <<< "$totals")
+usd_total=$(jq -r 'if .usd == null then "—" else "$" + ((.usd * 100 | floor) / 100 | tostring) end' <<< "$totals")
+missing=$(jq -r '.any_missing_usd' <<< "$totals")
+
+printf '| **Total** |  | **%s** | **%s** | **%s** |\n' "$ti" "$to" "$usd_total"
+
+if [ "$missing" = "true" ]; then
+  printf '\n*USD unavailable for one or more rows — add model to `pipeline/scripts/cost-table.json`.*\n'
+fi
+
+exit 0

package/pipeline/scripts/render-work-summary.sh

@@ -0,0 +1,195 @@
+#!/usr/bin/env bash
+# render-work-summary.sh — v7.1.0
+#
+# Reads agent-state.json + phase-tracker.json + git diff, emits a concise
+# "### Work Summary" markdown block for Phase 7 channels dispatch. Intended
+# as an executive-summary companion to the existing Normal Analysis /
+# Technical Details / Test Scenarios sections — gives Jira/Confluence
+# readers and PR reviewers a single-screen answer to "what actually
+# changed?" without parsing the full pipeline log.
+#
+# Usage:
+#   render-work-summary.sh <task-id> [--worktree <path>] [--branch <name>]
+#                                    [--base-branch <name>]
+#
+# Source of truth precedence:
+#   1. explicit flags (for tests / post-hoc invocation)
+#   2. agent-state.json in the worktree
+#   3. git status / git log on the worktree branch
+#
+# Output (stdout, always printable):
+#   ### Work Summary
+#   **Task**: <jiraId>  |  **Branch**: <branch>  |  **Base**: <base>  |  **PR**: #<N>
+#
+#   #### Scope delivered
+#   - ✅ T1 <title>
+#   - ✅ T2 <title>
+#   - ⏳ T3 <title> (deferred — rationale)
+#
+#   #### Changed files (<N> files · +<ADD> / -<DEL>)
+#   - `path/a.ext`  (+12 / -4)
+#   - `path/b.ext`  (+5 / -0)
+#
+#   #### Review outcome
+#   - <A> accepted · <D> deferred · <R> rejected · approved=<bool>
+#
+#   #### Phases
+#   - 0 Init ✅ · 1 Analysis ✅ · 2 Planning ✅ · 3 Dev ✅ · 4 Review ✅ · 5 Test ✅ · 6 Commit ✅ · 7 Report ▶
+#
+# Exit codes: 0 = rendered, 2 = missing state (caller should skip section).
+
+set -euo pipefail
+
+TASK_ID="${1:?usage: render-work-summary.sh <task-id>}"
+shift || true
+
+WORKTREE=""; BRANCH=""; BASE=""
+while [ $# -gt 0 ]; do
+  case "$1" in
+    --worktree)    WORKTREE="$2"; shift 2 ;;
+    --branch)      BRANCH="$2"; shift 2 ;;
+    --base-branch) BASE="$2"; shift 2 ;;
+    *) shift ;;
+  esac
+done
+
+command -v jq >/dev/null 2>&1 || { echo "render-work-summary: jq required" >&2; exit 2; }
+
+# Locate the worktree + state files
+if [ -z "$WORKTREE" ]; then
+  task_bare="${TASK_ID##*-}"
+  for candidate in \
+    "$PWD/.worktrees/$TASK_ID" \
+    "$PWD/.worktrees/$task_bare" \
+    "$PWD/.worktrees/task-$task_bare"
+  do
+    [ -d "$candidate" ] && { WORKTREE="$candidate"; break; }
+  done
+fi
+
+STATE_FILE=""
+TRACKER_FILE=""
+if [ -n "$WORKTREE" ]; then
+  [ -f "$WORKTREE/agent-state.json" ]   && STATE_FILE="$WORKTREE/agent-state.json"
+  [ -f "$WORKTREE/phase-tracker.json" ] && TRACKER_FILE="$WORKTREE/phase-tracker.json"
+fi
+
+if [ -z "$STATE_FILE" ] && [ -z "$TRACKER_FILE" ] && [ -z "$BRANCH" ]; then
+  # Not enough to render anything meaningful
+  exit 2
+fi
+
+# Extract fields (tolerate missing keys)
+state_jira=""
+state_branch=""
+state_base=""
+state_pr=""
+state_tasks="[]"
+state_triage="{}"
+if [ -n "$STATE_FILE" ]; then
+  state_jira=$(jq -r '.taskId // ""' "$STATE_FILE")
+  state_branch=$(jq -r '.branch // (.projects // [] | .[0].branch // "")' "$STATE_FILE")
+  state_base=$(jq -r '.baseBranch // (.projects // [] | .[0].baseBranch // "")' "$STATE_FILE")
+  state_pr=$(jq -r '.prNumber // .prUrl // ""' "$STATE_FILE")
+  state_tasks=$(jq -c '(.planTodos // []) + (.phases["2"].tasks // [])' "$STATE_FILE" 2>/dev/null || echo "[]")
+  state_triage=$(jq -c '.reviewConsensus // .phases["4"].triage // {}' "$STATE_FILE" 2>/dev/null || echo "{}")
+fi
+
+# Flag overrides
+[ -n "$BRANCH" ] && state_branch="$BRANCH"
+[ -n "$BASE" ]   && state_base="$BASE"
+[ -z "$state_jira" ] && state_jira="$TASK_ID"
+[ -z "$state_base" ] && state_base="main"
+
+# Phase tick marks
+phase_ticks=""
+if [ -n "$TRACKER_FILE" ]; then
+  phase_ticks=$(jq -r '
+    . as $root |
+    ["0 Init","1 Analysis","2 Planning","3 Dev","4 Review","5 Test","6 Commit","7 Report"] as $labels |
+    [range(0;8) | tostring] as $ids |
+    $ids
+    | map(. as $i |
+        ($labels[$i | tonumber]) as $label |
+        (($root.phases // {})[$i] // {}) as $p |
+        (if   $p.status == "completed"   then "✅"
+         elif $p.status == "in_progress" then "▶"
+         elif $p.status == "failed"      then "❌"
+         elif $p.status == "skipped"     then "⏭"
+         else                                  "·" end) as $mark |
+        "\($label) \($mark)")
+    | join(" · ")
+  ' "$TRACKER_FILE" 2>/dev/null || echo "")
+fi
+
+# Changed files + diffstat
+changed_block=""
+files_count=0
+total_add=0; total_del=0
+if [ -n "$WORKTREE" ] && [ -d "$WORKTREE/.git" -o -d "$WORKTREE" ]; then
+  if git -C "$WORKTREE" rev-parse HEAD >/dev/null 2>&1; then
+    diffstat=$(git -C "$WORKTREE" diff --numstat "$state_base"...HEAD 2>/dev/null || true)
+    if [ -n "$diffstat" ]; then
+      files_count=$(echo "$diffstat" | grep -c . || true)
+      total_add=$(echo "$diffstat" | awk '{ if ($1 ~ /^[0-9]+$/) s+=$1 } END { print s+0 }')
+      total_del=$(echo "$diffstat" | awk '{ if ($2 ~ /^[0-9]+$/) s+=$2 } END { print s+0 }')
+      changed_block=$(echo "$diffstat" | awk '{ printf "- `%s` (+%s / -%s)\n", $3, $1, $2 }' | head -20)
+      # If more than 20 files, note the truncation
+      extra=$((files_count - 20))
+      if [ "$extra" -gt 0 ]; then
+        changed_block="${changed_block}
+- _... +${extra} more files not shown_"
+      fi
+    fi
+  fi
+fi
+
+# Task list with ✅ / ⏳ marks — derived from triage if available
+tasks_block=""
+if [ "$(jq 'length' <<< "$state_tasks")" != "0" ]; then
+  tasks_block=$(jq -r '
+    .[] |
+    "- " +
+    (if (.status // "done") == "done" then "✅ " else "⏳ " end) +
+    (.id // "") +
+    (if (.id // "") != "" then " " else "" end) +
+    (.title // .subject // "(untitled)")
+  ' <<< "$state_tasks")
+fi
+
+# Review outcome
+accepted=$(jq -r '.accepted // [] | length' <<< "$state_triage" 2>/dev/null || echo 0)
+deferred=$(jq -r '.deferred // [] | length' <<< "$state_triage" 2>/dev/null || echo 0)
+rejected=$(jq -r '.rejected // [] | length' <<< "$state_triage" 2>/dev/null || echo 0)
+approved=$(jq -r '.approved // false' <<< "$state_triage" 2>/dev/null || echo false)
+
+# ─── Render ────────────────────────────────────────────────────────
+printf '### Work Summary\n'
+
+header="**Task**: \`$state_jira\`"
+[ -n "$state_branch" ] && header="$header  |  **Branch**: \`$state_branch\`"
+[ -n "$state_base" ]   && header="$header  |  **Base**: \`$state_base\`"
+if [ -n "$state_pr" ] && [ "$state_pr" != "null" ]; then
+  header="$header  |  **PR**: $state_pr"
+fi
+printf '%s\n\n' "$header"
+
+if [ -n "$tasks_block" ]; then
+  printf '#### Scope delivered\n%s\n\n' "$tasks_block"
+fi
+
+if [ "$files_count" -gt 0 ]; then
+  printf '#### Changed files (%d files · +%d / -%d)\n%s\n\n' \
+    "$files_count" "$total_add" "$total_del" "$changed_block"
+fi
+
+if [ "$accepted" != "0" ] || [ "$deferred" != "0" ] || [ "$rejected" != "0" ]; then
+  printf '#### Review outcome\n- %s accepted · %s deferred · %s rejected · approved=%s\n\n' \
+    "$accepted" "$deferred" "$rejected" "$approved"
+fi
+
+if [ -n "$phase_ticks" ]; then
+  printf '#### Phases\n- %s\n' "$phase_ticks"
+fi
+
+exit 0