@mmerterden/multi-agent-pipeline 8.6.0

package/pipeline/lib/issue-fetcher.sh

@@ -0,0 +1,333 @@
+#!/bin/bash
+#
+# issue-fetcher.sh
+# Resolve any user input (Jira ID, Jira URL, GitHub URL, gh #N, repo#N, free-text)
+# into a normalized issue descriptor — and emit a maturity score so the picker
+# can warn/block on incomplete issues.
+#
+# Output JSON schema:
+#   {
+#     "kind":       "jira" | "github" | "freetext",
+#     "key":        "PROJ-1" | "316" | null,
+#     "title":      "...",
+#     "type":       "Bug" | "Task" | "Story" | "Issue",
+#     "status":     "...",
+#     "description":"...",                          // raw body (truncated to 4000 chars)
+#     "url":        "https://...",
+#     "host":       "jira.example.com" | "github.com",
+#     "owner":      "org" (gh) | null,
+#     "repo":       "name" (gh) | null,
+#     "branchHint": "feature/PROJ-1" | "bugfix/...",
+#     "maturity": {
+#        "score":     0..100,
+#        "blockers":  ["status_closed", "description_empty"],
+#        "warnings":  ["short_description", "no_repro_steps"],
+#        "summary":   "Description boş — pipeline başlatılamaz." (human-readable, tr|en)
+#     }
+#   }
+#
+# Required env:
+#   ACCOUNT_JIRA_TOKEN_KEY    keychain service name (optional)
+#   ACCOUNT_JIRA_HOST         e.g. jira.example.com    (optional)
+#   ACCOUNT_GH_TOKEN_KEY      keychain service name (optional)
+#   ACCOUNT_DEFAULT_OWNER     fallback GitHub owner (optional)
+#   ACCOUNT_DEFAULT_REPO      fallback GitHub repo  (optional)
+#   PROMPT_LANG               tr|en — controls maturity.summary language (default: tr)
+
+set -eu
+
+INPUT="${1:-}"
+[ -z "$INPUT" ] && { echo '{"error":"input required"}'; exit 1; }
+
+JIRA_TOKEN_KEY="${ACCOUNT_JIRA_TOKEN_KEY:-}"
+JIRA_HOST="${ACCOUNT_JIRA_HOST:-}"
+DEFAULT_OWNER="${ACCOUNT_DEFAULT_OWNER:-}"
+DEFAULT_REPO="${ACCOUNT_DEFAULT_REPO:-}"
+PROMPT_LANG="${PROMPT_LANG:-tr}"
+
+# --- Detect input kind --------------------------------------------------------
+detect_kind() {
+  local in="$1"
+  case "$in" in
+    *atlassian.net/browse/*|*jira*/browse/*|http*://*/browse/*) echo "jira-url" ;;
+    *github.com/*/issues/*) echo "gh-url" ;;
+    [A-Z]*-[0-9]*) echo "jira-id" ;;
+    *\#[0-9]*) echo "gh-short" ;;
+    [0-9]*) echo "gh-num" ;;
+    *) echo "freetext" ;;
+  esac
+}
+
+KIND=$(detect_kind "$INPUT")
+
+# --- Helpers ------------------------------------------------------------------
+slugify() {
+  printf '%s' "$1" \
+    | tr '[:upper:]' '[:lower:]' \
+    | sed -E 's/[^a-z0-9]+/-/g; s/^-+|-+$//g' \
+    | cut -c1-50
+}
+
+infer_type_from_label() {
+  case "$(printf '%s' "$1" | tr '[:upper:]' '[:lower:]')" in
+    *bug*|*defect*|*hotfix*) echo "Bug" ;;
+    *) echo "Task" ;;
+  esac
+}
+
+branch_for() {
+  local key="$1" type="$2" title="$3"
+  local prefix="feature"
+  [ "$type" = "Bug" ] && prefix="bugfix"
+  if [ -n "$key" ]; then
+    printf '%s/%s' "$prefix" "$key"
+  else
+    printf '%s/%s' "$prefix" "$(slugify "$title")"
+  fi
+}
+
+# --- Provider fetchers (return raw JSON or empty) -----------------------------
+fetch_jira() {
+  local key="$1"
+  if [ -z "$JIRA_HOST" ] || [ -z "$JIRA_TOKEN_KEY" ]; then
+    echo "ERR: ACCOUNT_JIRA_HOST and ACCOUNT_JIRA_TOKEN_KEY must be set" >&2
+    return 1
+  fi
+  local token
+  token=$("$HOME/.claude/lib/credential-store.sh" get "$JIRA_TOKEN_KEY" 2>/dev/null || true)
+  if [ -z "$token" ]; then
+    echo "ERR: Jira token not found in credential store ($JIRA_TOKEN_KEY)" >&2
+    return 1
+  fi
+  curl -sf -H "Authorization: Bearer $token" \
+    "https://$JIRA_HOST/rest/api/2/issue/$key?fields=summary,status,issuetype,description,priority,resolution,fixVersions" \
+    || { echo "ERR: Jira fetch failed for $key" >&2; return 1; }
+}
+
+fetch_github() {
+  local owner="$1" repo="$2" num="$3"
+  if ! command -v gh >/dev/null 2>&1; then
+    echo "ERR: gh CLI not found" >&2
+    return 1
+  fi
+  gh issue view "$num" --repo "$owner/$repo" \
+    --json number,title,labels,state,url,body 2>/dev/null \
+    || { echo "ERR: GitHub fetch failed for $owner/$repo#$num" >&2; return 1; }
+}
+
+# Maturity scoring lives inline inside emit_descriptor (single python invocation,
+# avoids double-pass marshalling). The labels and rules below mirror the picker's
+# expectation; see `descriptor.maturity` in the output schema.
+
+# Build the descriptor JSON, then attach maturity. Pythonized so escaping stays sane.
+emit_descriptor() {
+  python3 - "$PROMPT_LANG" "$@" <<'PY'
+import json, sys, re
+
+lang = sys.argv[1]
+fields = dict(arg.split("=",1) for arg in sys.argv[2:])
+
+# Truncate description to keep payload reasonable.
+desc = fields.get("description","") or ""
+if len(desc) > 4000:
+    desc = desc[:4000] + "…"
+
+priority = fields.get("priority","").strip()
+resolution = fields.get("resolution","").strip()
+fix_versions = [v for v in (fields.get("fixVersions","").split(",")) if v.strip()]
+
+# Priority weight (used by picker for sorting)
+priority_weights = {
+    "blocker": 100, "highest": 95, "critical": 90, "p0": 100, "p1": 90,
+    "high": 80, "p2": 80,
+    "medium": 50, "normal": 50, "p3": 50,
+    "low": 30, "p4": 30,
+    "lowest": 10, "trivial": 10, "minor": 20, "p5": 10,
+}
+priority_weight = priority_weights.get(priority.lower(), 0)
+
+descriptor = {
+    "kind":        fields.get("kind"),
+    "key":         fields.get("key") or None,
+    "title":       fields.get("title") or None,
+    "type":        fields.get("type") or "Task",
+    "status":      fields.get("status") or "Unknown",
+    "priority":    priority or None,
+    "priorityWeight": priority_weight,
+    "resolution":  resolution or None,
+    "fixVersions": fix_versions,
+    "description": desc,
+    "host":        fields.get("host") or None,
+    "url":         fields.get("url") or None,
+    "owner":       fields.get("owner") or None,
+    "repo":        fields.get("repo") or None,
+    "branchHint":  fields.get("branchHint") or None,
+}
+extra = {}
+if fields.get("needsRepoPicker"):
+    extra["needsRepoPicker"] = True
+descriptor.update(extra)
+
+# Compute maturity inline (avoid second python invocation).
+title = (descriptor.get("title") or "").strip()
+status = (descriptor.get("status") or "").lower()
+itype = (descriptor.get("type") or "").lower()
+
+blockers, warnings = [], []
+closed = {"done","closed","cancelled","canceled","resolved"}
+if status in closed:
+    blockers.append("status_closed")
+# Jira "resolution" field: if set (Fixed, Won't Do, Done...), issue was already resolved.
+if resolution:
+    blockers.append("already_resolved")
+if not desc.strip():
+    blockers.append("description_empty")
+elif len(desc.strip()) < 80:
+    warnings.append("short_description")
+if len(title) < 10:
+    warnings.append("short_title")
+if "bug" in itype or "defect" in itype:
+    if desc and not re.search(r"(steps to reproduce|reproduce|repro|adımlar|adimlar|nasıl|how to reproduce)", desc, re.I):
+        warnings.append("no_repro_steps")
+if any(w in itype for w in ("story","task","feature","sub-task")):
+    if desc and len(desc) >= 80 and not re.search(r"(acceptance criteria|kabul kriter|definition of done|\bAC[: ]|\bDoD\b)", desc, re.I):
+        warnings.append("no_acceptance_criteria")
+
+score = max(0, min(100, 100 - 40*len(blockers) - 10*len(warnings)))
+
+labels_tr = {
+    "status_closed":         "Issue kapalı veya iptal edilmiş",
+    "already_resolved":      "Issue zaten resolved/merged ({})".format(resolution or "—"),
+    "description_empty":     "Açıklama boş",
+    "short_description":     "Açıklama çok kısa (<80 karakter)",
+    "short_title":           "Başlık çok kısa (<10 karakter)",
+    "no_repro_steps":        "Bug için repro adımları yok",
+    "no_acceptance_criteria":"Kabul kriteri / AC görünmüyor",
+}
+labels_en = {
+    "status_closed":         "Issue is closed/cancelled",
+    "already_resolved":      "Issue already resolved/merged ({})".format(resolution or "—"),
+    "description_empty":     "Description is empty",
+    "short_description":     "Description too short (<80 chars)",
+    "short_title":           "Title too short (<10 chars)",
+    "no_repro_steps":        "Bug missing reproduction steps",
+    "no_acceptance_criteria":"No acceptance criteria detected",
+}
+labels = labels_tr if lang == "tr" else labels_en
+lines = []
+for c in blockers:
+    lines.append(("⛔ " if lang == "tr" else "BLOCK ") + labels.get(c, c))
+for c in warnings:
+    lines.append(("⚠ " if lang == "tr" else "WARN  ") + labels.get(c, c))
+summary = "\n".join(lines) if lines else (
+    "Issue olgun, devam edilebilir." if lang == "tr" else "Issue mature; ready to proceed."
+)
+
+descriptor["maturity"] = {
+    "score":    score,
+    "blockers": blockers,
+    "warnings": warnings,
+    "summary":  summary,
+}
+
+# For freetext, no description fetched — score the title instead.
+if descriptor.get("kind") == "freetext":
+    # No real issue, no maturity to assess. Mark as N/A.
+    descriptor["maturity"] = {
+        "score":    None,
+        "blockers": [],
+        "warnings": [],
+        "summary":  "Free-text input — maturity check skipped." if lang == "en"
+                    else "Free-text girdi — maturity kontrolü atlandı.",
+    }
+
+print(json.dumps(descriptor, ensure_ascii=False))
+PY
+}
+
+# --- Dispatch -----------------------------------------------------------------
+case "$KIND" in
+  jira-id)
+    KEY="$INPUT"
+    raw=$(fetch_jira "$KEY") || raw=""
+    if [ -n "$raw" ]; then
+      title=$(printf '%s' "$raw" | python3 -c 'import json,sys; d=json.load(sys.stdin); print(d["fields"]["summary"])')
+      itype=$(printf '%s' "$raw" | python3 -c 'import json,sys; d=json.load(sys.stdin); print(d["fields"]["issuetype"]["name"])')
+      status=$(printf '%s' "$raw" | python3 -c 'import json,sys; d=json.load(sys.stdin); print(d["fields"]["status"]["name"])')
+      description=$(printf '%s' "$raw" | python3 -c 'import json,sys; d=json.load(sys.stdin); print(d["fields"].get("description") or "")')
+      priority=$(printf '%s' "$raw" | python3 -c 'import json,sys; d=json.load(sys.stdin); p=d["fields"].get("priority") or {}; print(p.get("name") or "")')
+      resolution=$(printf '%s' "$raw" | python3 -c 'import json,sys; d=json.load(sys.stdin); r=d["fields"].get("resolution") or {}; print(r.get("name") if r else "")')
+      fixversions=$(printf '%s' "$raw" | python3 -c 'import json,sys; d=json.load(sys.stdin); fv=d["fields"].get("fixVersions") or []; print(",".join(v.get("name","") for v in fv))')
+    else
+      title="(unfetched)"; itype="Task"; status="Unknown"; description=""
+      priority=""; resolution=""; fixversions=""
+    fi
+    branch=$(branch_for "$KEY" "$itype" "$title")
+    emit_descriptor \
+      "kind=jira" "key=$KEY" "title=$title" "type=$itype" "status=$status" \
+      "description=$description" "host=$JIRA_HOST" \
+      "url=https://$JIRA_HOST/browse/$KEY" "branchHint=$branch" \
+      "priority=$priority" "resolution=$resolution" "fixVersions=$fixversions"
+    ;;
+
+  jira-url)
+    HOST=$(printf '%s' "$INPUT" | sed -E 's#https?://##; s#/.*##')
+    KEY=$(printf '%s' "$INPUT" | sed -E 's#.*/browse/##; s#[/?].*##')
+    ACCOUNT_JIRA_HOST="$HOST" JIRA_HOST="$HOST" exec "$0" "$KEY"
+    ;;
+
+  gh-url)
+    OWNER=$(printf '%s' "$INPUT" | sed -E 's#https?://github.com/##; s#/.*##')
+    REPO=$(printf '%s' "$INPUT" | sed -E 's#https?://github.com/[^/]+/##; s#/.*##')
+    NUM=$(printf '%s' "$INPUT" | sed -E 's#.*/issues/##; s#[/?].*##')
+    raw=$(fetch_github "$OWNER" "$REPO" "$NUM") || raw=""
+    if [ -n "$raw" ]; then
+      title=$(printf '%s' "$raw" | python3 -c 'import json,sys; d=json.load(sys.stdin); print(d["title"])')
+      labels=$(printf '%s' "$raw" | python3 -c 'import json,sys; d=json.load(sys.stdin); print(",".join(l["name"] for l in d.get("labels",[])))')
+      status=$(printf '%s' "$raw" | python3 -c 'import json,sys; d=json.load(sys.stdin); print(d.get("state","open"))')
+      description=$(printf '%s' "$raw" | python3 -c 'import json,sys; d=json.load(sys.stdin); print(d.get("body") or "")')
+    else
+      title="(unfetched)"; labels=""; status="open"; description=""
+    fi
+    itype=$(infer_type_from_label "$labels")
+    branch=$(branch_for "${REPO}-${NUM}" "$itype" "$title")
+    emit_descriptor \
+      "kind=github" "key=$NUM" "title=$title" "type=$itype" "status=$status" \
+      "description=$description" "host=github.com" \
+      "url=https://github.com/$OWNER/$REPO/issues/$NUM" \
+      "owner=$OWNER" "repo=$REPO" "branchHint=$branch"
+    ;;
+
+  gh-short)
+    REPO=$(printf '%s' "$INPUT" | sed -E 's/#.*//')
+    NUM=$(printf '%s' "$INPUT" | sed -E 's/.*#//')
+    OWNER="${DEFAULT_OWNER:-}"
+    if [ -z "$OWNER" ]; then
+      echo '{"error":"ACCOUNT_DEFAULT_OWNER not set; cannot resolve repo#N"}'
+      exit 2
+    fi
+    exec "$0" "https://github.com/$OWNER/$REPO/issues/$NUM"
+    ;;
+
+  gh-num)
+    NUM="${INPUT#\#}"
+    OWNER="${DEFAULT_OWNER:-}"
+    REPO="${DEFAULT_REPO:-}"
+    if [ -z "$OWNER" ] || [ -z "$REPO" ]; then
+      emit_descriptor \
+        "kind=github" "key=$NUM" "title=" "type=Task" "status=unresolved" \
+        "description=" "host=github.com" \
+        "needsRepoPicker=1"
+      exit 0
+    fi
+    exec "$0" "https://github.com/$OWNER/$REPO/issues/$NUM"
+    ;;
+
+  freetext)
+    title="$INPUT"
+    branch=$(branch_for "" "Task" "$title")
+    emit_descriptor \
+      "kind=freetext" "key=" "title=$title" "type=Task" "status=new" \
+      "description=" "branchHint=$branch"
+    ;;
+esac

package/pipeline/lib/multi-repo-pipeline.sh

@@ -0,0 +1,252 @@
+#!/bin/bash
+#
+# multi-repo-pipeline.sh
+# Orchestrates worktree checkout, branch creation, commit, and PR
+# across one primary repo plus optional dev-context repos.
+#
+# Subcommands:
+#   prepare      <state.json>   create worktrees + branches for all repos
+#   bridge       <state.json>   emit agent-state.json v2.1.0 (projects[]) for Phase 0 consumption
+#   commit       <state.json>   create commit per repo (uses staged changes in each)
+#   push         <state.json>   push branches to origin per repo
+#   pr           <state.json>   create PR per repo with cross-links
+#   teardown     <state.json>   remove worktrees (preserves logs)
+#
+# Picker state.json schema (input):
+#   {
+#     "taskId":"PROJ-1-20260427",
+#     "branch":"feature/PROJ-1",
+#     "baseBranch":"develop",
+#     "issueRef":{"kind":"jira","key":"PROJ-1","title":"...", ...},
+#     "primary":   {"name":"my-ios-app","cloneUrl":"...","provider":"github"},
+#     "extras":   [{"name":"common","cloneUrl":"...","provider":"github"}, ...],
+#     "worktreeRoot":".worktrees/PROJ-1-20260427",
+#     "commitType":"feat",
+#     "identity":{"name":"...","email":"..."}
+#   }
+#
+# `bridge` writes agent-state.json v2.1.0 with projects[] populated — Phase 0
+# consumes this and skips its own picker steps.
+
+set -eu
+
+CMD="${1:-}"
+STATE="${2:-}"
+[ -z "$CMD" ] || [ -z "$STATE" ] && {
+  echo "usage: $0 <prepare|commit|push|pr|teardown> <state.json>" >&2
+  exit 1
+}
+[ ! -f "$STATE" ] && { echo "ERR: state file not found: $STATE" >&2; exit 2; }
+
+jq_get() {
+  python3 -c "
+import json,sys
+d=json.load(open('$STATE'))
+keys='''$1'''.split('.')
+for k in keys:
+    if k.endswith(']'):
+        name,idx=k[:-1].split('[')
+        d=d[name][int(idx)]
+    else:
+        d=d[k]
+print(d)
+" 2>/dev/null
+}
+
+list_repos_jq() {
+  python3 -c "
+import json,sys
+d=json.load(open('$STATE'))
+repos=[d['primary']] + d.get('extras',[])
+for r in repos:
+    print(r['name']+'\t'+r['cloneUrl']+'\t'+r.get('provider','git'))
+"
+}
+
+WORKTREE_ROOT=$(python3 -c "import json; d=json.load(open('$STATE')); print(d['worktreeRoot'])")
+BRANCH=$(python3 -c "import json; d=json.load(open('$STATE')); print(d['branch'])")
+TASK_ID=$(python3 -c "import json; d=json.load(open('$STATE')); print(d['taskId'])")
+COMMIT_TYPE=$(python3 -c "import json; d=json.load(open('$STATE')); print(d.get('commitType','feat'))")
+ISSUE_KEY=$(python3 -c "import json; d=json.load(open('$STATE')); print(d['issueRef'].get('key') or '')")
+ISSUE_TITLE=$(python3 -c "import json; d=json.load(open('$STATE')); print(d['issueRef'].get('title') or '')")
+
+cmd_prepare() {
+  mkdir -p "$WORKTREE_ROOT"
+  list_repos_jq | while IFS=$'\t' read -r name url provider; do
+    local target="$WORKTREE_ROOT/$name"
+    if [ -d "$target/.git" ]; then
+      echo "[$name] worktree already present at $target"
+    else
+      echo "[$name] cloning into $target"
+      git clone --quiet "$url" "$target" || { echo "ERR: clone failed for $name" >&2; return 3; }
+    fi
+    cd "$target"
+    if git rev-parse --verify "$BRANCH" >/dev/null 2>&1; then
+      echo "[$name] branch $BRANCH already exists, checking out"
+      git checkout --quiet "$BRANCH"
+    else
+      git checkout --quiet -b "$BRANCH"
+    fi
+    cd - >/dev/null
+  done
+}
+
+cmd_commit() {
+  list_repos_jq | while IFS=$'\t' read -r name url provider; do
+    local target="$WORKTREE_ROOT/$name"
+    [ ! -d "$target" ] && continue
+    cd "$target"
+    # Use status --porcelain so untracked files count as "changes" too —
+    # dev sessions usually add brand-new files alongside edits, and `git diff`
+    # alone misses them.
+    if [ -z "$(git status --porcelain 2>/dev/null)" ]; then
+      echo "[$name] no changes, skipping commit"
+      cd - >/dev/null
+      continue
+    fi
+    git add -A
+    local subject="$COMMIT_TYPE($name): $ISSUE_TITLE"
+    [ -n "$ISSUE_KEY" ] && subject="$subject [$ISSUE_KEY]"
+    # Trim subject to 72 chars
+    subject=$(printf '%s' "$subject" | cut -c1-72)
+    git commit --quiet -m "$subject" || true
+    cd - >/dev/null
+    echo "[$name] committed: $subject"
+  done
+}
+
+cmd_push() {
+  list_repos_jq | while IFS=$'\t' read -r name url provider; do
+    local target="$WORKTREE_ROOT/$name"
+    [ ! -d "$target" ] && continue
+    cd "$target"
+    git push --quiet -u origin "$BRANCH" || echo "[$name] push failed"
+    cd - >/dev/null
+    echo "[$name] pushed $BRANCH"
+  done
+}
+
+cmd_pr() {
+  # Open PR for extras first, then primary with cross-links.
+  local primary_name primary_owner_repo
+  primary_name=$(python3 -c "import json; d=json.load(open('$STATE')); print(d['primary']['name'])")
+  local cross_links=""
+  list_repos_jq | while IFS=$'\t' read -r name url provider; do
+    if [ "$name" = "$primary_name" ]; then continue; fi
+    local target="$WORKTREE_ROOT/$name"
+    [ ! -d "$target" ] && continue
+    cd "$target"
+    if [ "$provider" = "github" ] && command -v gh >/dev/null 2>&1; then
+      local body="Ref: $ISSUE_KEY
+Part of multi-repo task $TASK_ID."
+      gh pr create --title "$COMMIT_TYPE($name): $ISSUE_TITLE" --body "$body" --fill 2>/dev/null \
+        | tee -a "$WORKTREE_ROOT/_prs.log" || echo "[$name] gh pr create failed"
+    else
+      echo "[$name] PR creation skipped (provider=$provider)"
+    fi
+    cd - >/dev/null
+  done
+  # Now primary
+  local target="$WORKTREE_ROOT/$primary_name"
+  cd "$target"
+  local extras_links=""
+  if [ -f "$WORKTREE_ROOT/_prs.log" ]; then
+    extras_links=$(grep -Eo 'https://github.com/[^ ]+/pull/[0-9]+' "$WORKTREE_ROOT/_prs.log" | sed 's/^/Related: /')
+  fi
+  local body="Ref: $ISSUE_KEY
+$extras_links"
+  if command -v gh >/dev/null 2>&1; then
+    gh pr create --title "$COMMIT_TYPE($primary_name): $ISSUE_TITLE" --body "$body" --fill 2>/dev/null \
+      || echo "[$primary_name] gh pr create failed"
+  fi
+  cd - >/dev/null
+}
+
+cmd_teardown() {
+  if [ -d "$WORKTREE_ROOT" ]; then
+    echo "[teardown] removing $WORKTREE_ROOT (logs preserved at ~/.claude/logs/multi-agent/$TASK_ID/)"
+    rm -rf "$WORKTREE_ROOT"
+  fi
+}
+
+# Emit agent-state.json v2.1.0 from picker state.json so Phase 0 can consume it directly.
+# Logs path: $HOME/.claude/logs/multi-agent/{primary.name}/{taskId}/agent-state.json
+cmd_bridge() {
+  python3 - "$STATE" <<'PY'
+import json, os, sys, time
+state = json.load(open(sys.argv[1]))
+
+primary = state["primary"]
+extras  = state.get("extras", [])
+all_repos = [primary] + extras
+worktree_root = os.path.expanduser(state["worktreeRoot"])
+identity = state.get("identity", {"name": "", "email": ""})
+
+def repo_entry(r, is_primary=False):
+    return {
+        "project":      r["name"],
+        "projectRoot":  os.path.join(worktree_root, r["name"]),
+        "worktreePath": os.path.join(worktree_root, r["name"]),
+        "branch":       state["branch"],
+        "baseBranch":   state.get("baseBranch", "develop"),
+        "remoteType":   r.get("provider", "github"),
+        "platform":     r.get("provider", "github"),
+        "identity":     identity,
+        "commit":       None,
+        "pr":           None,
+        "pushAttempts": 0,
+        "buildStatus":  "pending",
+    }
+
+issue = state.get("issueRef", {})
+gh_issue = None
+if issue.get("kind") == "github" and issue.get("owner") and issue.get("repo") and issue.get("key"):
+    try:
+        gh_issue = {
+            "owner":  issue["owner"],
+            "repo":   issue["repo"],
+            "number": int(issue["key"]),
+        }
+    except (ValueError, TypeError):
+        gh_issue = None
+
+agent_state = {
+    "schemaVersion": "2.1.0",
+    "taskId":        state["taskId"],
+    "shortId":       state.get("shortId", 1),
+    "jiraId":        issue.get("key") if issue.get("kind") == "jira" else None,
+    "githubIssue":   gh_issue,
+    "project":       primary["name"],
+    "projectRoot":   os.path.join(worktree_root, primary["name"]),
+    "worktreePath":  os.path.join(worktree_root, primary["name"]),
+    "branch":        state["branch"],
+    "baseBranch":    state.get("baseBranch", "develop"),
+    "remoteType":    primary.get("provider", "github"),
+    "currentPhase":  0,
+    "status":        "in_progress",
+    "startedAt":     time.strftime("%Y-%m-%dT%H:%M:%SZ", time.gmtime()),
+    "phases":        {},
+    "identity":      identity,
+    "projects":      [repo_entry(r, i == 0) for i, r in enumerate(all_repos)],
+}
+
+logs_dir = os.path.expanduser(os.path.join("~/.claude/logs/multi-agent", primary["name"], state["taskId"]))
+os.makedirs(logs_dir, exist_ok=True)
+out_path = os.path.join(logs_dir, "agent-state.json")
+tmp_path = out_path + ".tmp"
+with open(tmp_path, "w") as f:
+    json.dump(agent_state, f, indent=2, ensure_ascii=False)
+os.replace(tmp_path, out_path)
+print(out_path)
+PY
+}
+
+case "$CMD" in
+  prepare)  cmd_prepare ;;
+  bridge)   cmd_bridge ;;
+  commit)   cmd_commit ;;
+  push)     cmd_push ;;
+  pr)       cmd_pr ;;
+  teardown) cmd_teardown ;;
+  *) echo "ERR: unknown subcommand $CMD" >&2; exit 1 ;;
+esac