@mmerterden/multi-agent-pipeline 16.28.0 → 16.30.0

package/pipeline/schemas/agent-state.schema.json

@@ -76,6 +76,11 @@
       "type": "string",
       "description": "PR target branch (e.g. develop, main)."
     },
+    "baseBranchSource": {
+      "type": "string",
+      "enum": ["asked", "input", "remembered", "default"],
+      "description": "How baseBranch was decided. asked = the user answered the Step 3 picker; input = it arrived with the task reference; remembered = autopilot took the most recent entry in prefs.global.recentBranches still inside the TTL and still on the remote; default = autopilot fell back to the develop/release/main sort order. An autopilot run cannot be asked anything, so recording which rule fired is what keeps it readable afterwards."
+    },
     "remoteType": {
       "type": "string",
       "enum": ["github", "bitbucket"],
@@ -1117,6 +1122,71 @@
       "type": ["string", "null"],
       "description": "Directory the worktree's artefacts were salvaged into before removal (agent-state, phase-tracker, triage-output, .pipeline/, build+test logs, review diff). Phase 7 and :resume read from here when worktreePath is gone."
     },
+    "testDepth": {
+      "type": ["string", "null"],
+      "enum": ["unit", "unit+ui", "unit+mcp", null],
+      "description": "How far the run tests, answered at intake because Phase 5 is absent from four of the eight modes and a question asked where it cannot be reached is a question nobody answers. `unit+ui` runs the repo's own UI test and records the screen around it; `unit+mcp` drives the flow through the toolkit MCP instead. The options offered are built from evidenceCapability, never from the model's reading of the repo."
+    },
+    "testDepthSource": {
+      "type": ["string", "null"],
+      "enum": ["user", "autopilot", "default", "forced", null],
+      "description": "Who chose. `forced` means only one option was open, so nothing was asked - recorded rather than passed off as the user's answer."
+    },
+    "evidenceCapability": {
+      "type": ["object", "null"],
+      "additionalProperties": true,
+      "description": "What this machine and this repo can actually produce, measured by probe-evidence-capability.sh BEFORE the test-depth question. Every absent value carries its reason, so a closed option can say why instead of vanishing from the menu; a value that could not be measured is null with a reason, never false, because a probe that did not look and a probe that found nothing are different facts. Contract: multi-agent-refs/features/visual-evidence.md.",
+      "properties": {
+        "platform": { "type": "string", "enum": ["ios", "android", "web", "other"] },
+        "uiTestTarget": {
+          "type": ["string", "null"],
+          "description": "The single chosen target, empty while several candidates exist and no match picks one."
+        },
+        "uiTestTargets": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Every candidate. A real app has many: the reference iOS app has one XCUITest bundle among 477 files that merely sit under a *UITests path, and the reference Android app has eight instrumentation source sets."
+        },
+        "uiTestTargetReason": { "type": ["string", "null"] },
+        "matchingTests": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Tests that mention a changed file's name. A heuristic, and treated as one: an empty set falls to the next tier rather than concluding the screen is untested."
+        },
+        "matchingTestsReason": { "type": ["string", "null"] },
+        "device": { "type": ["string", "null"] },
+        "deviceReason": {
+          "type": ["string", "null"],
+          "description": "'no booted simulator, but one is available to boot' and 'no iOS simulator available on this machine' are different problems with different fixes, and the user can act on only one of them."
+        },
+        "recorder": { "type": ["boolean", "null"] },
+        "recorderReason": { "type": ["string", "null"] },
+        "mcp": { "type": ["boolean", "null"] },
+        "mcpReason": { "type": ["string", "null"] },
+        "tier1": {
+          "type": "string",
+          "enum": ["open", "closed", "unknown"],
+          "description": "Whether the depth menu may offer tier 1. `unknown` means the target was not probed (a --only device re-check), which is not the same as closed and must not be rendered as one."
+        },
+        "tier2": { "type": "string", "enum": ["open", "closed", "unknown"] }
+      }
+    },
+    "uiTest": {
+      "type": ["object", "null"],
+      "additionalProperties": true,
+      "description": "The UI test run that produced the tier 1 recording. Subject to the same default-FAIL rule as the build: a zero exit code alone is not a pass, the log is the evidence, and evidence-gate.mjs reads it.",
+      "properties": {
+        "ran": { "type": "boolean" },
+        "target": { "type": ["string", "null"] },
+        "selected": { "type": "array", "items": { "type": "string" } },
+        "status": { "type": ["string", "null"], "enum": ["passed", "failed", "not-run", null] },
+        "notRunReason": {
+          "type": ["string", "null"],
+          "description": "Why it did not run: no target, no matching test, no device. Each is a reason to fall to the next video tier, never a phase failure."
+        },
+        "logPath": { "type": ["string", "null"] }
+      }
+    },
     "visualEvidence": {
       "type": ["object", "null"],
       "additionalProperties": false,
@@ -1193,10 +1263,23 @@
           },
           "description": "Captured in Phase 3 after the build+test gate, because Phase 5 is dropped by every autopilot and --local entry."
         },
+        "host": {
+          "type": ["string", "null"],
+          "enum": ["jira", "github-public", "github-private", "none", null],
+          "description": "Where the artefacts are published, resolved in Phase 6. `jira` attaches both stills and video. `github-public` pushes the stills to the evidence branch and embeds them in the PR body. `github-private` pushes the same stills but the PR carries a blob permalink instead of an inline image, because GitHub's image proxy cannot fetch a private repo's raw URL and an embedded one renders broken for every reader. `none` publishes nothing and records the gap. Video is Jira-only by decision: without an attachment host there is nothing a recording can be attached to."
+        },
+        "hostReason": {
+          "type": ["string", "null"],
+          "description": "Why this host and not the one above it in the order. A host of `none` with no reason is the silence the Phase 6 blocker exists to catch."
+        },
         "videoTier": {
           "type": ["integer", "null"],
           "enum": [1, 2, 3, null],
-          "description": "1 = the repo's own UI test target drove the flow, 2 = MCP-driven flow, 3 = no runnable build."
+          "description": "1 = the repo's own UI test target drove the flow, 2 = MCP-driven flow, 3 = no recording. Resolved from the capability probe, then RE-CHECKED at capture time: a device booted at intake can be gone by Phase 3, and a tier recorded from a stale measurement is a promise the run cannot keep."
+        },
+        "videoTierReason": {
+          "type": ["string", "null"],
+          "description": "Which rule produced the tier, and the tier it came down from when it was downgraded at capture time, e.g. 'tier 1 -> 2: simulator no longer booted'."
         },
         "video": {
           "type": "object",