@mmerterden/multi-agent-pipeline 20.30.0 → 20.33.0

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

@@ -301,19 +301,30 @@
       "required": ["contractVersion", "mode", "answered", "resolvedAt"],
       "description": "Present only when Phase 0 Step 0.1 applied a launch request (launch-request.mjs resolve). Records which pickers the request answered, so a reader can tell a pre-filled answer from one the user gave in the session. Absent on every run started without MA_LAUNCH_REQUEST.",
       "properties": {
-        "contractVersion": { "type": "string" },
-        "mode": { "enum": ["interactive", "autopilot", "background"] },
-        "kind": { "enum": ["analysis", "development"] },
+        "contractVersion": {
+          "type": "string"
+        },
+        "mode": {
+          "enum": ["interactive", "autopilot", "background"]
+        },
+        "kind": {
+          "enum": ["analysis", "development"]
+        },
         "input": {
           "type": "string",
           "description": "The request's input, kept so the runs index can title a run launched from free text."
         },
         "answered": {
           "type": "array",
-          "items": { "type": "string" },
+          "items": {
+            "type": "string"
+          },
           "description": "Question ids from run-questions.json."
         },
-        "resolvedAt": { "type": "string", "format": "date-time" }
+        "resolvedAt": {
+          "type": "string",
+          "format": "date-time"
+        }
       }
     },
     "pendingQuestion": {
@@ -338,7 +349,9 @@
           "maxLength": 2000,
           "description": "The question as the step would have asked it, in outputLanguage."
         },
-        "kind": { "enum": ["single-select", "multi-select"] },
+        "kind": {
+          "enum": ["single-select", "multi-select"]
+        },
         "options": {
           "type": "array",
           "minItems": 2,
@@ -347,12 +360,21 @@
             "additionalProperties": false,
             "required": ["id", "label"],
             "properties": {
-              "id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9+_-]*$" },
-              "label": { "type": "string", "minLength": 1 }
+              "id": {
+                "type": "string",
+                "pattern": "^[a-z0-9][a-z0-9+_-]*$"
+              },
+              "label": {
+                "type": "string",
+                "minLength": 1
+              }
             }
           }
         },
-        "askedAt": { "type": "string", "format": "date-time" }
+        "askedAt": {
+          "type": "string",
+          "format": "date-time"
+        }
       }
     },
     "research": {
@@ -366,10 +388,19 @@
           "minimum": 1,
           "description": "Passes applied to this run so far. The runner's own ceiling across runs of one item is autopilot config maxAskRounds, counted from attempted.jsonl."
         },
-        "kind": { "enum": ["maturity", "open-questions"] },
-        "decision": { "enum": ["proceed", "ask"] },
-        "reason": { "type": "string" },
-        "dir": { "type": "string", "minLength": 1 },
+        "kind": {
+          "enum": ["maturity", "open-questions"]
+        },
+        "decision": {
+          "enum": ["proceed", "ask"]
+        },
+        "reason": {
+          "type": "string"
+        },
+        "dir": {
+          "type": "string",
+          "minLength": 1
+        },
         "json": {
           "type": "string",
           "minLength": 1,
@@ -391,19 +422,47 @@
             "additionalProperties": false,
             "required": ["id", "category", "status"],
             "properties": {
-              "id": { "type": "string" },
-              "category": { "type": "string" },
-              "status": { "enum": ["closed", "candidate", "open"] },
-              "sources": { "type": "array", "items": { "type": "object" } }
+              "id": {
+                "type": "string"
+              },
+              "category": {
+                "type": "string"
+              },
+              "status": {
+                "enum": ["closed", "candidate", "open"]
+              },
+              "sources": {
+                "type": "array",
+                "items": {
+                  "type": "object"
+                }
+              }
             }
           }
         },
-        "closed": { "type": "array", "items": { "type": "string" } },
-        "candidates": { "type": "array", "items": { "type": "string" } },
-        "open": { "type": "array", "items": { "type": "string" } },
+        "closed": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "candidates": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "open": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
         "ignored": {
           "type": "array",
-          "items": { "type": "string" },
+          "items": {
+            "type": "string"
+          },
           "description": "Finding gap ids the run does not have."
         },
         "resolved": {
@@ -414,16 +473,34 @@
             "additionalProperties": false,
             "required": ["id", "question", "answer", "sources"],
             "properties": {
-              "id": { "type": "string" },
-              "question": { "type": "string" },
-              "answer": { "type": "string" },
-              "sources": { "type": "array", "items": { "type": "object" } }
+              "id": {
+                "type": "string"
+              },
+              "question": {
+                "type": "string"
+              },
+              "answer": {
+                "type": "string"
+              },
+              "sources": {
+                "type": "array",
+                "items": {
+                  "type": "object"
+                }
+              }
             }
           }
         },
-        "maturityBefore": { "type": ["object", "null"] },
-        "maturityAfter": { "type": ["object", "null"] },
-        "at": { "type": "string", "format": "date-time" }
+        "maturityBefore": {
+          "type": ["object", "null"]
+        },
+        "maturityAfter": {
+          "type": ["object", "null"]
+        },
+        "at": {
+          "type": "string",
+          "format": "date-time"
+        }
       }
     },
     "lastAnswer": {
@@ -432,10 +509,23 @@
       "required": ["questionId", "stepId", "optionIds", "answeredAt"],
       "description": "The answer answer-question.mjs recorded when it cleared pendingQuestion. The re-entered step reads it instead of asking again, then leaves it as a trace; the next answer overwrites it.",
       "properties": {
-        "questionId": { "type": "string" },
-        "stepId": { "type": "string" },
-        "optionIds": { "type": "array", "minItems": 1, "items": { "type": "string" } },
-        "answeredAt": { "type": "string", "format": "date-time" }
+        "questionId": {
+          "type": "string"
+        },
+        "stepId": {
+          "type": "string"
+        },
+        "optionIds": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "string"
+          }
+        },
+        "answeredAt": {
+          "type": "string",
+          "format": "date-time"
+        }
       }
     },
     "remoteType": {
@@ -459,7 +549,9 @@
     },
     "instructionFiles": {
       "type": "object",
-      "additionalProperties": { "type": "string" },
+      "additionalProperties": {
+        "type": "string"
+      },
       "description": "Instruction files steering an instruction-driven run, keyed by the step they replace (start, validate, dev, commit). Empty when instructionDriven is false."
     },
     "contextLinks": {
@@ -482,8 +574,12 @@
               "generic-doc"
             ]
           },
-          "url": { "type": ["string", "null"] },
-          "metadata": { "type": "object" }
+          "url": {
+            "type": ["string", "null"]
+          },
+          "metadata": {
+            "type": "object"
+          }
         }
       }
     },
@@ -570,23 +666,45 @@
         "type": "object",
         "required": ["remote", "slug"],
         "properties": {
-          "remote": { "type": "string" },
-          "slug": { "type": "string" },
-          "stack": { "type": "string" },
-          "branch": { "type": "string" },
-          "sha": { "type": "string" },
-          "stale": { "type": "boolean" },
-          "error": { "type": "string" },
+          "remote": {
+            "type": "string"
+          },
+          "slug": {
+            "type": "string"
+          },
+          "stack": {
+            "type": "string"
+          },
+          "branch": {
+            "type": "string"
+          },
+          "sha": {
+            "type": "string"
+          },
+          "stale": {
+            "type": "boolean"
+          },
+          "error": {
+            "type": "string"
+          },
           "keys": {
             "type": "array",
             "items": {
               "type": "object",
               "required": ["key", "status"],
               "properties": {
-                "key": { "type": "string" },
-                "status": { "enum": ["implemented", "not-yet-implemented", "diverges", "error"] },
-                "hits": { "type": "array" },
-                "note": { "type": "string" }
+                "key": {
+                  "type": "string"
+                },
+                "status": {
+                  "enum": ["implemented", "not-yet-implemented", "diverges", "error"]
+                },
+                "hits": {
+                  "type": "array"
+                },
+                "note": {
+                  "type": "string"
+                }
               }
             }
           }
@@ -698,22 +816,30 @@
             },
             "toolkits": {
               "type": "array",
-              "items": { "type": "object" },
+              "items": {
+                "type": "object"
+              },
               "description": "Kept toolkits with name, version, source and reason."
             },
             "excluded": {
               "type": "array",
-              "items": { "type": "object" },
+              "items": {
+                "type": "object"
+              },
               "description": "Inherited toolkits dropped for contradicting the detected stack, each with its reason."
             },
             "hints": {
               "type": "array",
-              "items": { "type": "object" },
+              "items": {
+                "type": "object"
+              },
               "description": "Detected stacks with no enabled toolkit, each with the /multi-agent:stack line to enable one."
             },
             "fallbacks": {
               "type": "array",
-              "items": { "type": "object" },
+              "items": {
+                "type": "object"
+              },
               "description": "Unattended and autopilot runs only: toolkits read read-only from a marketplace clone (with reportLine), or the recorded gap when no clone carries one."
             }
           }
@@ -822,7 +948,9 @@
         "openQuestions": {
           "type": "array",
           "description": "Section 20 rows Phase 1 Step 5 deferred. open-questions-gate.mjs parks a gated run on a non-empty list and passes on an empty one; absent means no analysis recorded any.",
-          "items": { "type": ["string", "object"] }
+          "items": {
+            "type": ["string", "object"]
+          }
         },
         "assumptions": {
           "type": "array",
@@ -832,9 +960,16 @@
             "additionalProperties": false,
             "required": ["question", "source", "assumedAt"],
             "properties": {
-              "question": { "type": "string" },
-              "source": { "type": "string" },
-              "assumedAt": { "type": "string", "format": "date-time" }
+              "question": {
+                "type": "string"
+              },
+              "source": {
+                "type": "string"
+              },
+              "assumedAt": {
+                "type": "string",
+                "format": "date-time"
+              }
             }
           }
         }
@@ -883,18 +1018,34 @@
       "additionalProperties": false,
       "description": "Outcome of `repo-profile.mjs ensure` at Phase 1: where the per-repo profile lives and how this run treated it. The profile itself stays at the path, outside the repo (multi-agent-refs/features/repo-profile.md).",
       "properties": {
-        "path": { "type": "string" },
-        "action": { "type": "string", "enum": ["loaded", "derived", "rederived"] },
-        "mode": { "type": "string", "enum": ["attended", "unattended"] },
+        "path": {
+          "type": "string"
+        },
+        "action": {
+          "type": "string",
+          "enum": ["loaded", "derived", "rederived"]
+        },
+        "mode": {
+          "type": "string",
+          "enum": ["attended", "unattended"]
+        },
         "confirmed": {
           "type": "boolean",
           "description": "The profile carried confirmedAt when the run used it."
         },
-        "staleReasons": { "type": "array", "items": { "type": "string" } },
+        "staleReasons": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
         "ignored": {
           "type": "array",
           "description": "Fields the run did not act on, with the confidence policy's reason.",
-          "items": { "type": "object", "additionalProperties": true }
+          "items": {
+            "type": "object",
+            "additionalProperties": true
+          }
         }
       }
     },
@@ -1263,12 +1414,25 @@
             "required": ["escalate", "fromTier", "toTier", "trigger", "reason"],
             "description": "Written by rework-escalation.mjs --state before the rework dispatch this review sent back: the rung it ran on and why, a refusal included (multi-agent-refs/features/rework-escalation.md).",
             "properties": {
-              "escalate": { "type": "boolean" },
-              "fromTier": { "type": "string" },
-              "toTier": { "type": "string" },
-              "trigger": { "enum": ["last-round", "still-present", null] },
-              "reason": { "type": "string" },
-              "at": { "type": "string", "format": "date-time" }
+              "escalate": {
+                "type": "boolean"
+              },
+              "fromTier": {
+                "type": "string"
+              },
+              "toTier": {
+                "type": "string"
+              },
+              "trigger": {
+                "enum": ["last-round", "still-present", null]
+              },
+              "reason": {
+                "type": "string"
+              },
+              "at": {
+                "type": "string",
+                "format": "date-time"
+              }
             }
           },
           "delta": {
@@ -1537,13 +1701,28 @@
       "additionalProperties": true,
       "description": "valven-rules delivery gate. Phase 2 Gate 6 sets splitRequired when a size or scope rule fails; Phase 4 Step 2.95 records the stacked PRs it opened.",
       "properties": {
-        "splitRequired": { "type": "boolean" },
+        "splitRequired": {
+          "type": "boolean"
+        },
         "split": {
           "type": "object",
           "properties": {
-            "sliceCount": { "type": "integer", "minimum": 1 },
-            "branches": { "type": "array", "items": { "type": "string" } },
-            "prs": { "type": "array", "items": { "type": "string" } }
+            "sliceCount": {
+              "type": "integer",
+              "minimum": 1
+            },
+            "branches": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "prs": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
           }
         }
       }
@@ -1881,7 +2060,10 @@
         "flowRuns": {
           "type": "array",
           "description": "Flow-runner run ids (the runId in <RUN_ROOT>/history.jsonl) of the UI scenario runs that verify this task. Channels renders their Xray Test Execution in the 'Test Koşumu (Xray)' block; empty means channels discovers candidate runs instead.",
-          "items": { "type": "string", "minLength": 1 }
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
         }
       }
     },
@@ -2025,8 +2207,12 @@
                 "type": "object",
                 "additionalProperties": true,
                 "properties": {
-                  "file": { "type": "string" },
-                  "jiraFilename": { "type": "string" },
+                  "file": {
+                    "type": "string"
+                  },
+                  "jiraFilename": {
+                    "type": "string"
+                  },
                   "url": {
                     "type": "string",
                     "description": "Jira attachment content URL, as jira-attach.sh printed it."
@@ -2037,8 +2223,12 @@
                 "type": "object",
                 "additionalProperties": true,
                 "properties": {
-                  "file": { "type": "string" },
-                  "jiraFilename": { "type": "string" },
+                  "file": {
+                    "type": "string"
+                  },
+                  "jiraFilename": {
+                    "type": "string"
+                  },
                   "url": {
                     "type": "string",
                     "description": "Jira attachment content URL, as jira-attach.sh printed it."
@@ -2110,12 +2300,28 @@
       "required": ["round", "digest", "verdict", "at"],
       "description": "The one plan-critique round of this run (refs/features/plan-critic.md), written by plan-critique-gate.mjs and by nothing else while the quality gates are active. digest is the sha256 of the judged critique with its replies; a later invocation with a different digest is refused as a second round. advisory is what Phase 1 carries into the plan and Phase 4 into the PR summary.",
       "properties": {
-        "round": { "type": "integer", "const": 1 },
-        "path": { "type": "string" },
-        "digest": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
-        "objectionsDigest": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
-        "verdict": { "enum": ["pass", "fail"] },
-        "objections": { "type": "integer", "minimum": 0 },
+        "round": {
+          "type": "integer",
+          "const": 1
+        },
+        "path": {
+          "type": "string"
+        },
+        "digest": {
+          "type": "string",
+          "pattern": "^[0-9a-f]{64}$"
+        },
+        "objectionsDigest": {
+          "type": "string",
+          "pattern": "^[0-9a-f]{64}$"
+        },
+        "verdict": {
+          "enum": ["pass", "fail"]
+        },
+        "objections": {
+          "type": "integer",
+          "minimum": 0
+        },
         "blocking": {
           "type": "array",
           "items": {
@@ -2123,9 +2329,15 @@
             "additionalProperties": false,
             "required": ["objection", "rule", "reason"],
             "properties": {
-              "objection": { "type": "string" },
-              "rule": { "type": "string" },
-              "reason": { "type": "string" }
+              "objection": {
+                "type": "string"
+              },
+              "rule": {
+                "type": "string"
+              },
+              "reason": {
+                "type": "string"
+              }
             }
           }
         },
@@ -2136,17 +2348,34 @@
             "additionalProperties": false,
             "required": ["objection", "lens", "claim", "label", "reply"],
             "properties": {
-              "objection": { "type": "string" },
-              "lens": { "enum": ["scope", "feasibility", "security", "alternative"] },
-              "claim": { "type": "string" },
-              "label": { "enum": ["anchored", "inference"] },
-              "rule": { "type": "string" },
-              "ruleStatus": { "enum": ["binding", "proposed", "unknown", "unchecked"] },
-              "reply": { "enum": ["accept", "rebut", null] }
+              "objection": {
+                "type": "string"
+              },
+              "lens": {
+                "enum": ["scope", "feasibility", "security", "alternative"]
+              },
+              "claim": {
+                "type": "string"
+              },
+              "label": {
+                "enum": ["anchored", "inference"]
+              },
+              "rule": {
+                "type": "string"
+              },
+              "ruleStatus": {
+                "enum": ["binding", "proposed", "unknown", "unchecked"]
+              },
+              "reply": {
+                "enum": ["accept", "rebut", null]
+              }
             }
           }
         },
-        "at": { "type": "string", "format": "date-time" }
+        "at": {
+          "type": "string",
+          "format": "date-time"
+        }
       }
     },
     "publish": {
@@ -2155,12 +2384,25 @@
       "required": ["outcome", "at"],
       "description": "Written by the autopilot runner's publish step (autopilot-publish.mjs) when it pushed a verified branch to a host with no draft PR. The runner reports it as pushed-awaiting-pr. A GitHub publish writes `pr` instead; a refused one writes `verificationFailed` with a `publish/<gate>` gate.",
       "properties": {
-        "outcome": { "const": "pushed-awaiting-pr" },
-        "at": { "type": "string", "format": "date-time" },
-        "host": { "type": "string" },
-        "branch": { "type": "string" },
-        "base": { "type": "string" },
-        "sha": { "type": "string" }
+        "outcome": {
+          "const": "pushed-awaiting-pr"
+        },
+        "at": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "host": {
+          "type": "string"
+        },
+        "branch": {
+          "type": "string"
+        },
+        "base": {
+          "type": "string"
+        },
+        "sha": {
+          "type": "string"
+        }
       }
     },
     "jiraFamily": {
@@ -2168,19 +2410,46 @@
       "additionalProperties": false,
       "description": "The issue family of a run that started from a Jira story or sub-task (multi-agent-refs/features/jira-family.md), written by Phase 0 from scripts/jira-family.mjs resolve and read by the channels Jira adapter. writes[] is the outcome of lib/jira-family-write.sh apply.",
       "properties": {
-        "inputKey": { "type": ["string", "null"] },
-        "inputRole": { "enum": ["subtask", "story"] },
-        "storyKey": { "type": ["string", "null"] },
-        "devTaskKey": { "type": ["string", "null"] },
-        "devCandidates": { "type": "array", "items": { "type": "string" } },
-        "testTaskKey": { "type": ["string", "null"] },
-        "testCandidates": { "type": "array", "items": { "type": "string" } },
+        "inputKey": {
+          "type": ["string", "null"]
+        },
+        "inputRole": {
+          "enum": ["subtask", "story"]
+        },
+        "storyKey": {
+          "type": ["string", "null"]
+        },
+        "devTaskKey": {
+          "type": ["string", "null"]
+        },
+        "devCandidates": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "testTaskKey": {
+          "type": ["string", "null"]
+        },
+        "testCandidates": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
         "storyFormat": {
           "type": "object",
           "additionalProperties": false,
           "properties": {
-            "status": { "enum": ["conforms", "nonconforming", "empty", "unknown", "not-a-story"] },
-            "reasons": { "type": "array", "items": { "type": "string" } }
+            "status": {
+              "enum": ["conforms", "nonconforming", "empty", "unknown", "not-a-story"]
+            },
+            "reasons": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
           }
         },
         "writes": {
@@ -2190,10 +2459,18 @@
             "additionalProperties": false,
             "required": ["id", "issue", "status"],
             "properties": {
-              "id": { "enum": ["story", "dev", "test", "story-tests"] },
-              "issue": { "type": "string" },
-              "status": { "enum": ["written", "exists", "skipped", "failed", "dry-run"] },
-              "reason": { "type": "string" }
+              "id": {
+                "enum": ["story", "dev", "test", "story-tests"]
+              },
+              "issue": {
+                "type": "string"
+              },
+              "status": {
+                "enum": ["written", "exists", "skipped", "failed", "dry-run"]
+              },
+              "reason": {
+                "type": "string"
+              }
             }
           }
         }
@@ -2207,11 +2484,30 @@
         "additionalProperties": false,
         "required": ["what", "why", "costIfWrong", "at", "phase"],
         "properties": {
-          "what": { "type": "string", "minLength": 1, "maxLength": 200 },
-          "why": { "type": "string", "minLength": 1, "maxLength": 500 },
-          "costIfWrong": { "type": "string", "minLength": 1, "maxLength": 300 },
-          "at": { "type": "string", "format": "date-time" },
-          "phase": { "type": "integer", "minimum": 0, "maximum": 5 }
+          "what": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 200
+          },
+          "why": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 500
+          },
+          "costIfWrong": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 300
+          },
+          "at": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "phase": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 5
+          }
         }
       }
     },
@@ -2330,6 +2626,88 @@
       "type": ["object", "null"],
       "additionalProperties": true,
       "description": "Answers and progress of a /multi-agent:complaint-analysis run. Shape: complaint-analysis-spec.schema.json."
+    },
+    "channelResults": {
+      "type": ["object", "null"],
+      "additionalProperties": false,
+      "description": "What Phase 5's channels dispatch did, per adapter: posted, skipped or failed, and the address of what was posted. Written once the dispatch returns, so readers outside the session (the office, status) can show where the report went.",
+      "properties": {
+        "pr": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["status"],
+          "properties": {
+            "status": {
+              "enum": ["posted", "skipped", "failed"]
+            },
+            "url": {
+              "type": "string",
+              "format": "uri",
+              "pattern": "^https://"
+            }
+          }
+        },
+        "jira": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["status"],
+          "properties": {
+            "status": {
+              "enum": ["posted", "skipped", "failed"]
+            },
+            "url": {
+              "type": "string",
+              "format": "uri",
+              "pattern": "^https://"
+            }
+          }
+        },
+        "confluence": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["status"],
+          "properties": {
+            "status": {
+              "enum": ["posted", "skipped", "failed"]
+            },
+            "url": {
+              "type": "string",
+              "format": "uri",
+              "pattern": "^https://"
+            }
+          }
+        },
+        "wiki": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["status"],
+          "properties": {
+            "status": {
+              "enum": ["posted", "skipped", "failed"]
+            },
+            "url": {
+              "type": "string",
+              "format": "uri",
+              "pattern": "^https://"
+            }
+          }
+        },
+        "issue": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["status"],
+          "properties": {
+            "status": {
+              "enum": ["posted", "skipped", "failed"]
+            },
+            "url": {
+              "type": "string",
+              "format": "uri",
+              "pattern": "^https://"
+            }
+          }
+        }
+      }
     }
   }
 }