@mmerterden/multi-agent-pipeline 20.2.1 → 20.3.0

package/pipeline/contract/fixtures/runs-awaiting-question.json

@@ -0,0 +1,70 @@
+{
+  "contractVersion": "1.1.0",
+  "logsRoot": "/Users/example/.claude/logs/multi-agent",
+  "count": 1,
+  "runs": [
+    {
+      "taskId": "PROJ-102",
+      "project": "example-app",
+      "dir": "/Users/example/.claude/logs/multi-agent/example-app/PROJ-102",
+      "layout": "nested",
+      "duplicateOf": null,
+      "salvaged": false,
+      "kind": "pipeline",
+      "stateReadable": true,
+      "status": "awaiting_input",
+      "currentPhase": 0,
+      "branch": null,
+      "baseBranch": null,
+      "startedAt": "2026-09-17T10:00:00Z",
+      "worktreePath": null,
+      "prUrl": null,
+      "autopilot": true,
+      "schemaVersion": "2.2.0",
+      "rev": 3,
+      "sessionId": "00000000-0000-4000-8000-000000000102",
+      "waitingFor": "question",
+      "pendingQuestion": {
+        "id": "maturity",
+        "stepId": "phase-0/maturity",
+        "text": "The item has no acceptance criteria. How should the run continue?",
+        "kind": "single-select",
+        "options": [
+          {
+            "id": "fix",
+            "label": "Open the item and fix it"
+          },
+          {
+            "id": "continue",
+            "label": "Continue without it"
+          },
+          {
+            "id": "abort",
+            "label": "Abort"
+          }
+        ]
+      },
+      "group": "waiting",
+      "phases": [
+        {
+          "id": "0",
+          "name": "Init",
+          "status": "in_progress",
+          "model": null,
+          "startedAt": null,
+          "completedAt": null,
+          "now": "waiting for an answer",
+          "subs": 0,
+          "subList": []
+        }
+      ],
+      "tokens": {
+        "in": 0,
+        "out": 0,
+        "cached": 0
+      },
+      "estUsd": 0,
+      "unlockedWrites": 0
+    }
+  ]
+}

package/pipeline/contract/fixtures/runs-empty.json

@@ -0,0 +1,6 @@
+{
+  "contractVersion": "1.1.0",
+  "logsRoot": "/Users/example/.claude/logs/multi-agent",
+  "count": 0,
+  "runs": []
+}

package/pipeline/contract/fixtures/runs-failed.json

@@ -0,0 +1,84 @@
+{
+  "contractVersion": "1.1.0",
+  "logsRoot": "/Users/example/.claude/logs/multi-agent",
+  "count": 1,
+  "runs": [
+    {
+      "taskId": "PROJ-103",
+      "project": "example-app",
+      "dir": "/Users/example/.claude/logs/multi-agent/example-app/PROJ-103",
+      "layout": "nested",
+      "duplicateOf": null,
+      "salvaged": false,
+      "kind": "pipeline",
+      "stateReadable": true,
+      "status": "failed",
+      "currentPhase": 3,
+      "branch": "bugfix/PROJ-103",
+      "baseBranch": "develop",
+      "startedAt": "2026-09-17T10:00:00Z",
+      "worktreePath": "/Users/example/example-app/.worktrees/PROJ-103",
+      "prUrl": null,
+      "autopilot": false,
+      "schemaVersion": "2.2.0",
+      "rev": 12,
+      "sessionId": null,
+      "waitingFor": null,
+      "pendingQuestion": null,
+      "group": "stopped",
+      "phases": [
+        {
+          "id": "0",
+          "name": "Init",
+          "status": "completed",
+          "model": "opus",
+          "startedAt": "2026-09-17T10:00:00Z",
+          "completedAt": "2026-09-17T10:05:00Z",
+          "now": null,
+          "subs": 0,
+          "subList": []
+        },
+        {
+          "id": "1",
+          "name": "Plan",
+          "status": "completed",
+          "model": "opus",
+          "startedAt": "2026-09-17T10:00:00Z",
+          "completedAt": "2026-09-17T10:05:00Z",
+          "now": null,
+          "subs": 0,
+          "subList": []
+        },
+        {
+          "id": "2",
+          "name": "Dev",
+          "status": "completed",
+          "model": "opus",
+          "startedAt": "2026-09-17T10:00:00Z",
+          "completedAt": "2026-09-17T10:05:00Z",
+          "now": null,
+          "subs": 0,
+          "subList": []
+        },
+        {
+          "id": "3",
+          "name": "Review",
+          "status": "failed",
+          "model": "fable",
+          "startedAt": "2026-09-17T10:20:00Z",
+          "completedAt": null,
+          "now": null,
+          "subs": 0,
+          "subList": []
+        }
+      ],
+      "tokens": {
+        "in": 3600,
+        "out": 1020,
+        "cached": 2700
+      },
+      "estUsd": 0.0449,
+      "unlockedWrites": 0
+    }
+  ]
+}

package/pipeline/contract/fixtures/runs-old-schema.json

@@ -0,0 +1,70 @@
+{
+  "contractVersion": "1.0.0",
+  "logsRoot": "/Users/example/.claude/logs/multi-agent",
+  "count": 1,
+  "runs": [
+    {
+      "taskId": "PROJ-105",
+      "project": "example-app",
+      "dir": "/Users/example/.claude/logs/multi-agent/example-app/PROJ-105",
+      "layout": "nested",
+      "duplicateOf": null,
+      "salvaged": false,
+      "kind": "pipeline",
+      "stateReadable": true,
+      "status": "paused",
+      "currentPhase": 2,
+      "branch": "feature/PROJ-105",
+      "baseBranch": null,
+      "startedAt": "2026-09-17T10:00:00Z",
+      "worktreePath": null,
+      "prUrl": null,
+      "autopilot": false,
+      "schemaVersion": "2.0.0",
+      "rev": null,
+      "group": "stopped",
+      "phases": [
+        {
+          "id": "0",
+          "name": "Init",
+          "status": "completed",
+          "model": "opus",
+          "startedAt": "2026-09-17T10:00:00Z",
+          "completedAt": "2026-09-17T10:05:00Z",
+          "now": null,
+          "subs": 0,
+          "subList": []
+        },
+        {
+          "id": "1",
+          "name": "Plan",
+          "status": "completed",
+          "model": "opus",
+          "startedAt": "2026-09-17T10:00:00Z",
+          "completedAt": "2026-09-17T10:05:00Z",
+          "now": null,
+          "subs": 0,
+          "subList": []
+        },
+        {
+          "id": "2",
+          "name": "Dev",
+          "status": "pending",
+          "model": null,
+          "startedAt": null,
+          "completedAt": null,
+          "now": null,
+          "subs": 0,
+          "subList": []
+        }
+      ],
+      "tokens": {
+        "in": 2400,
+        "out": 680,
+        "cached": 1800
+      },
+      "estUsd": 0.0299,
+      "unlockedWrites": 0
+    }
+  ]
+}

package/pipeline/contract/fixtures/runs-pr-opened-redacted.json

@@ -0,0 +1,101 @@
+{
+  "contractVersion": "1.1.0",
+  "count": 1,
+  "runs": [
+    {
+      "taskId": "PROJ-104",
+      "project": "example-app",
+      "layout": "nested",
+      "salvaged": false,
+      "kind": "pipeline",
+      "stateReadable": true,
+      "status": "awaiting_input",
+      "currentPhase": 5,
+      "branch": "feature/PROJ-104",
+      "baseBranch": "develop",
+      "startedAt": "2026-09-17T10:00:00Z",
+      "autopilot": false,
+      "schemaVersion": "2.2.0",
+      "rev": 21,
+      "sessionId": null,
+      "waitingFor": null,
+      "pendingQuestion": null,
+      "group": "waiting",
+      "phases": [
+        {
+          "id": "0",
+          "name": "Init",
+          "status": "completed",
+          "model": "opus",
+          "startedAt": "2026-09-17T10:00:00Z",
+          "completedAt": "2026-09-17T10:05:00Z",
+          "now": null,
+          "subs": 0,
+          "subList": []
+        },
+        {
+          "id": "1",
+          "name": "Plan",
+          "status": "completed",
+          "model": "opus",
+          "startedAt": "2026-09-17T10:00:00Z",
+          "completedAt": "2026-09-17T10:05:00Z",
+          "now": null,
+          "subs": 0,
+          "subList": []
+        },
+        {
+          "id": "2",
+          "name": "Dev",
+          "status": "completed",
+          "model": "opus",
+          "startedAt": "2026-09-17T10:00:00Z",
+          "completedAt": "2026-09-17T10:05:00Z",
+          "now": null,
+          "subs": 0,
+          "subList": []
+        },
+        {
+          "id": "3",
+          "name": "Review",
+          "status": "completed",
+          "model": "opus",
+          "startedAt": "2026-09-17T10:00:00Z",
+          "completedAt": "2026-09-17T10:05:00Z",
+          "now": null,
+          "subs": 0,
+          "subList": []
+        },
+        {
+          "id": "4",
+          "name": "Commit",
+          "status": "completed",
+          "model": "opus",
+          "startedAt": "2026-09-17T10:00:00Z",
+          "completedAt": "2026-09-17T10:05:00Z",
+          "now": null,
+          "subs": 0,
+          "subList": []
+        },
+        {
+          "id": "5",
+          "name": "Report",
+          "status": "completed",
+          "model": "opus",
+          "startedAt": "2026-09-17T10:00:00Z",
+          "completedAt": "2026-09-17T10:05:00Z",
+          "now": null,
+          "subs": 0,
+          "subList": []
+        }
+      ],
+      "tokens": {
+        "in": 7200,
+        "out": 2040,
+        "cached": 5400
+      },
+      "estUsd": 0.0897,
+      "unlockedWrites": 0
+    }
+  ]
+}

package/pipeline/contract/fixtures/runs-pr-opened.json

@@ -0,0 +1,106 @@
+{
+  "contractVersion": "1.1.0",
+  "logsRoot": "/Users/example/.claude/logs/multi-agent",
+  "count": 1,
+  "runs": [
+    {
+      "taskId": "PROJ-104",
+      "project": "example-app",
+      "dir": "/Users/example/.claude/logs/multi-agent/example-app/PROJ-104",
+      "layout": "nested",
+      "duplicateOf": null,
+      "salvaged": false,
+      "kind": "pipeline",
+      "stateReadable": true,
+      "status": "awaiting_input",
+      "currentPhase": 5,
+      "branch": "feature/PROJ-104",
+      "baseBranch": "develop",
+      "startedAt": "2026-09-17T10:00:00Z",
+      "worktreePath": "/Users/example/example-app/.worktrees/PROJ-104",
+      "prUrl": "https://github.com/example-org/example-app/pull/104",
+      "autopilot": false,
+      "schemaVersion": "2.2.0",
+      "rev": 21,
+      "sessionId": null,
+      "waitingFor": null,
+      "pendingQuestion": null,
+      "group": "waiting",
+      "phases": [
+        {
+          "id": "0",
+          "name": "Init",
+          "status": "completed",
+          "model": "opus",
+          "startedAt": "2026-09-17T10:00:00Z",
+          "completedAt": "2026-09-17T10:05:00Z",
+          "now": null,
+          "subs": 0,
+          "subList": []
+        },
+        {
+          "id": "1",
+          "name": "Plan",
+          "status": "completed",
+          "model": "opus",
+          "startedAt": "2026-09-17T10:00:00Z",
+          "completedAt": "2026-09-17T10:05:00Z",
+          "now": null,
+          "subs": 0,
+          "subList": []
+        },
+        {
+          "id": "2",
+          "name": "Dev",
+          "status": "completed",
+          "model": "opus",
+          "startedAt": "2026-09-17T10:00:00Z",
+          "completedAt": "2026-09-17T10:05:00Z",
+          "now": null,
+          "subs": 0,
+          "subList": []
+        },
+        {
+          "id": "3",
+          "name": "Review",
+          "status": "completed",
+          "model": "opus",
+          "startedAt": "2026-09-17T10:00:00Z",
+          "completedAt": "2026-09-17T10:05:00Z",
+          "now": null,
+          "subs": 0,
+          "subList": []
+        },
+        {
+          "id": "4",
+          "name": "Commit",
+          "status": "completed",
+          "model": "opus",
+          "startedAt": "2026-09-17T10:00:00Z",
+          "completedAt": "2026-09-17T10:05:00Z",
+          "now": null,
+          "subs": 0,
+          "subList": []
+        },
+        {
+          "id": "5",
+          "name": "Report",
+          "status": "completed",
+          "model": "opus",
+          "startedAt": "2026-09-17T10:00:00Z",
+          "completedAt": "2026-09-17T10:05:00Z",
+          "now": null,
+          "subs": 0,
+          "subList": []
+        }
+      ],
+      "tokens": {
+        "in": 7200,
+        "out": 2040,
+        "cached": 5400
+      },
+      "estUsd": 0.0897,
+      "unlockedWrites": 0
+    }
+  ]
+}

package/pipeline/contract/fixtures/runs-running.json

@@ -0,0 +1,84 @@
+{
+  "contractVersion": "1.1.0",
+  "logsRoot": "/Users/example/.claude/logs/multi-agent",
+  "count": 1,
+  "runs": [
+    {
+      "taskId": "PROJ-101",
+      "project": "example-app",
+      "dir": "/Users/example/.claude/logs/multi-agent/example-app/PROJ-101",
+      "layout": "nested",
+      "duplicateOf": null,
+      "salvaged": false,
+      "kind": "pipeline",
+      "stateReadable": true,
+      "status": "in_progress",
+      "currentPhase": 2,
+      "branch": "feature/PROJ-101",
+      "baseBranch": "develop",
+      "startedAt": "2026-09-17T10:00:00Z",
+      "worktreePath": "/Users/example/example-app/.worktrees/PROJ-101",
+      "prUrl": null,
+      "autopilot": true,
+      "schemaVersion": "2.2.0",
+      "rev": 7,
+      "sessionId": "00000000-0000-4000-8000-000000000101",
+      "waitingFor": null,
+      "pendingQuestion": null,
+      "group": "stopped",
+      "phases": [
+        {
+          "id": "0",
+          "name": "Init",
+          "status": "completed",
+          "model": "opus",
+          "startedAt": "2026-09-17T10:00:00Z",
+          "completedAt": "2026-09-17T10:05:00Z",
+          "now": null,
+          "subs": 0,
+          "subList": []
+        },
+        {
+          "id": "1",
+          "name": "Plan",
+          "status": "completed",
+          "model": "opus",
+          "startedAt": "2026-09-17T10:00:00Z",
+          "completedAt": "2026-09-17T10:05:00Z",
+          "now": null,
+          "subs": 0,
+          "subList": []
+        },
+        {
+          "id": "2",
+          "name": "Dev",
+          "status": "in_progress",
+          "model": "opus",
+          "startedAt": "2026-09-17T10:06:00Z",
+          "completedAt": null,
+          "now": "writing tests",
+          "subs": 2,
+          "subList": [
+            {
+              "id": "2.1",
+              "name": "failing test",
+              "status": "completed"
+            },
+            {
+              "id": "2.2",
+              "name": "implementation",
+              "status": "in_progress"
+            }
+          ]
+        }
+      ],
+      "tokens": {
+        "in": 2400,
+        "out": 680,
+        "cached": 1800
+      },
+      "estUsd": 0.0299,
+      "unlockedWrites": 0
+    }
+  ]
+}

package/pipeline/contract/fixtures/worktrees-empty.json

@@ -0,0 +1,4 @@
+{
+  "contractVersion": "1.0.0",
+  "worktrees": []
+}

package/pipeline/contract/frozen/toolbox.json

@@ -0,0 +1,107 @@
+{
+  "client": "macOS toolbox, MultiAgentFeature",
+  "description": "The fields the macOS toolbox decodes today, frozen. The toolbox uses Swift's synthesized Decodable, so a field written `T` must be present, non-null and of that type, and a field written `T?` may be absent or null but must be of that type when present. Removing a `T` field, or changing the type of either kind, breaks the toolbox on every machine at once. Adding fields is always safe: the decoder ignores keys it does not know. test/toolbox-compat.test.mjs runs each producer and holds its real output to this file.",
+  "types": "string | integer | number | boolean | array | object, suffixed ? when optional. number admits an integer; integer does not admit a fraction.",
+  "surfaces": {
+    "runs-index": {
+      "argv": ["node", "scripts/runs-index.mjs", "--json"],
+      "schema": "runs-index.schema.json",
+      "fields": {
+        "logsRoot": "string",
+        "count": "integer",
+        "runs": "array",
+        "runs[].taskId": "string",
+        "runs[].project": "string?",
+        "runs[].dir": "string",
+        "runs[].layout": "string",
+        "runs[].duplicateOf": "string?",
+        "runs[].salvaged": "boolean",
+        "runs[].kind": "string?",
+        "runs[].stateReadable": "boolean",
+        "runs[].status": "string?",
+        "runs[].currentPhase": "integer?",
+        "runs[].branch": "string?",
+        "runs[].baseBranch": "string?",
+        "runs[].startedAt": "string?",
+        "runs[].worktreePath": "string?",
+        "runs[].prUrl": "string?",
+        "runs[].autopilot": "boolean",
+        "runs[].schemaVersion": "string?",
+        "runs[].rev": "integer?",
+        "runs[].group": "string",
+        "runs[].phases": "array",
+        "runs[].phases[].id": "string",
+        "runs[].phases[].name": "string",
+        "runs[].phases[].status": "string",
+        "runs[].phases[].model": "string?",
+        "runs[].phases[].startedAt": "string?",
+        "runs[].phases[].completedAt": "string?",
+        "runs[].phases[].now": "string?",
+        "runs[].phases[].subs": "integer",
+        "runs[].tokens": "object",
+        "runs[].tokens.in": "integer",
+        "runs[].tokens.out": "integer",
+        "runs[].tokens.cached": "integer",
+        "runs[].estUsd": "number"
+      }
+    },
+    "doctor": {
+      "argv": ["node", "scripts/doctor.mjs", "--json"],
+      "fields": {
+        "exit": "integer",
+        "checks": "array",
+        "checks[].id": "string",
+        "checks[].severity": "string",
+        "checks[].problem": "string?",
+        "checks[].step": "string?",
+        "checks[].detail": "string?"
+      }
+    },
+    "autopilot-status": {
+      "argv": ["bash", "scripts/autopilot-status.sh", "--json"],
+      "fields": {
+        "on": "boolean",
+        "slots": "integer",
+        "running": "array",
+        "queued": "array",
+        "awaiting": "array",
+        "todayCount": "integer",
+        "todayUsd": "number",
+        "lastTickAt": "integer?",
+        "power": "string?",
+        "note": "string?",
+        "scanIntervalSeconds": "integer?",
+        "emptyReason": "string?",
+        "blockedReason": "string?",
+        "stopCommand": "string?",
+        "spendUsd": "number",
+        "ceilingUsd": "number",
+        "running[].id": "string",
+        "running[].repo": "string?",
+        "running[].source": "string?",
+        "running[].stack": "string?",
+        "running[].depth": "string?",
+        "running[].startedAt": "string?",
+        "running[].state": "string?",
+        "running[].url": "string?",
+        "queued[].id": "string",
+        "queued[].repo": "string?",
+        "queued[].source": "string?",
+        "awaiting[].id": "string",
+        "awaiting[].repo": "string?"
+      }
+    },
+    "credential-inventory": {
+      "argv": ["bash", "lib/credential-inventory.sh", "--json"],
+      "fields": {
+        "status": "string",
+        "probed": "boolean",
+        "credentials": "array",
+        "credentials[].logical": "string",
+        "credentials[].state": "string",
+        "credentials[].reachability": "string",
+        "credentials[].capability": "string?"
+      }
+    }
+  }
+}