@mmerterden/multi-agent-pipeline 20.29.0 → 20.33.0

package/pipeline/schemas/run-evidence.schema.json

@@ -0,0 +1,29 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/mmerterden/multi-agent-pipeline/pipeline/schemas/run-evidence.schema.json",
+  "title": "Run screenshot",
+  "description": "What GET /v1/runs/{id}/evidence/{name} returns (`run-results.mjs <id> --evidence <name>`): one screenshot from the run's .pipeline/evidence directory, base64. name is a bare png or jpg file name; one that resolves outside the directory is not found.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["contractVersion", "taskId", "name", "mime", "data"],
+  "properties": {
+    "contractVersion": {
+      "type": "string",
+      "pattern": "^1\\.[0-9]+\\.[0-9]+$",
+      "x-sensitivity": "none"
+    },
+    "taskId": {
+      "type": "string"
+    },
+    "name": {
+      "type": "string"
+    },
+    "mime": {
+      "enum": ["image/png", "image/jpeg"]
+    },
+    "data": {
+      "type": "string",
+      "contentEncoding": "base64"
+    }
+  }
+}

package/pipeline/schemas/run-results.schema.json

@@ -0,0 +1,218 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/mmerterden/multi-agent-pipeline/pipeline/schemas/run-results.schema.json",
+  "title": "Run results",
+  "description": "What GET /v1/runs/{id}/results returns (`run-results.mjs <id> --json`): what a run produced, read from its own files. diff from agent-state diffRisk or .review-diff.txt; findings from triage-output.json or agent-state review; tests from the test-summary gate and uiTest; evidence the screenshot names under .pipeline/evidence; analysis the documents an analysis run wrote. A part with no source is null. Text is scrubbed and redacted; paths are reduced to file names.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["contractVersion", "taskId", "diff", "findings", "tests", "evidence", "analysis"],
+  "properties": {
+    "contractVersion": {
+      "type": "string",
+      "pattern": "^1\\.[0-9]+\\.[0-9]+$",
+      "x-sensitivity": "none"
+    },
+    "taskId": {
+      "type": "string"
+    },
+    "diff": {
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["files", "added", "removed", "maxScore", "signals", "changed", "source"],
+          "properties": {
+            "files": {
+              "type": "integer"
+            },
+            "added": {
+              "type": ["integer", "null"]
+            },
+            "removed": {
+              "type": ["integer", "null"]
+            },
+            "maxScore": {
+              "type": ["number", "null"]
+            },
+            "signals": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "changed": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "source": {
+              "type": "string"
+            }
+          }
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "findings": {
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["approved", "items", "total", "source"],
+          "properties": {
+            "approved": {
+              "type": ["boolean", "null"]
+            },
+            "items": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "additionalProperties": false,
+                "required": ["severity", "file", "line", "issue", "fix", "reviewer", "verdict"],
+                "properties": {
+                  "severity": {
+                    "type": "string"
+                  },
+                  "file": {
+                    "type": ["string", "null"]
+                  },
+                  "line": {
+                    "type": ["integer", "null"]
+                  },
+                  "issue": {
+                    "type": "string"
+                  },
+                  "fix": {
+                    "type": ["string", "null"]
+                  },
+                  "reviewer": {
+                    "type": ["string", "null"]
+                  },
+                  "verdict": {
+                    "type": "string"
+                  }
+                }
+              }
+            },
+            "total": {
+              "type": "integer"
+            },
+            "source": {
+              "type": "string"
+            }
+          }
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "tests": {
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["status", "passed", "failed", "skipped", "uiTest", "source"],
+          "properties": {
+            "status": {
+              "type": ["string", "null"]
+            },
+            "passed": {
+              "type": ["integer", "null"]
+            },
+            "failed": {
+              "type": ["integer", "null"]
+            },
+            "skipped": {
+              "type": ["integer", "null"]
+            },
+            "uiTest": {
+              "oneOf": [
+                {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "required": ["ran", "status", "notRunReason"],
+                  "properties": {
+                    "ran": {
+                      "type": "boolean"
+                    },
+                    "status": {
+                      "type": ["string", "null"]
+                    },
+                    "notRunReason": {
+                      "type": ["string", "null"]
+                    }
+                  }
+                },
+                {
+                  "type": "null"
+                }
+              ]
+            },
+            "source": {
+              "type": "string"
+            }
+          }
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "evidence": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["name", "phase"],
+        "properties": {
+          "name": {
+            "type": "string"
+          },
+          "phase": {
+            "enum": ["before", "after", null]
+          }
+        }
+      }
+    },
+    "analysis": {
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["documents", "confluencePages", "jiraIssueKey"],
+          "properties": {
+            "documents": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "additionalProperties": false,
+                "required": ["name", "text"],
+                "properties": {
+                  "name": {
+                    "type": "string"
+                  },
+                  "text": {
+                    "type": ["string", "null"]
+                  }
+                }
+              }
+            },
+            "confluencePages": {
+              "type": "integer"
+            },
+            "jiraIssueKey": {
+              "type": ["string", "null"]
+            }
+          }
+        },
+        {
+          "type": "null"
+        }
+      ]
+    }
+  }
+}

package/pipeline/schemas/runs-index.schema.json

@@ -17,11 +17,17 @@
       "x-sensitivity": "local",
       "description": "Absent under --redact."
     },
-    "count": { "type": "integer", "minimum": 0, "x-sensitivity": "none" },
+    "count": {
+      "type": "integer",
+      "minimum": 0,
+      "x-sensitivity": "none"
+    },
     "runs": {
       "type": "array",
       "x-sensitivity": "none",
-      "items": { "$ref": "#/$defs/run" }
+      "items": {
+        "$ref": "#/$defs/run"
+      }
     }
   },
   "$defs": {
@@ -49,36 +55,82 @@
         "unlockedWrites"
       ],
       "properties": {
-        "taskId": { "type": "string", "x-sensitivity": "none" },
-        "project": { "type": ["string", "null"], "x-sensitivity": "none" },
-        "dir": { "type": "string", "x-sensitivity": "local", "description": "The run directory." },
-        "layout": { "enum": ["nested", "flat"], "x-sensitivity": "none" },
+        "taskId": {
+          "type": "string",
+          "x-sensitivity": "none"
+        },
+        "project": {
+          "type": ["string", "null"],
+          "x-sensitivity": "none"
+        },
+        "dir": {
+          "type": "string",
+          "x-sensitivity": "local",
+          "description": "The run directory."
+        },
+        "layout": {
+          "enum": ["nested", "flat"],
+          "x-sensitivity": "none"
+        },
         "duplicateOf": {
           "type": ["string", "null"],
           "x-sensitivity": "local",
           "description": "The other layout's directory for the same task id, when both exist."
         },
-        "salvaged": { "type": "boolean", "x-sensitivity": "none" },
-        "kind": { "enum": ["pipeline", "tracker-only", "empty"], "x-sensitivity": "none" },
-        "stateReadable": { "type": "boolean", "x-sensitivity": "none" },
-        "status": { "type": ["string", "null"], "x-sensitivity": "none" },
-        "currentPhase": { "type": ["integer", "null"], "x-sensitivity": "none" },
-        "branch": { "type": ["string", "null"], "x-sensitivity": "none" },
-        "baseBranch": { "type": ["string", "null"], "x-sensitivity": "none" },
-        "startedAt": { "type": ["string", "null"], "x-sensitivity": "none" },
-        "worktreePath": { "type": ["string", "null"], "x-sensitivity": "local" },
+        "salvaged": {
+          "type": "boolean",
+          "x-sensitivity": "none"
+        },
+        "kind": {
+          "enum": ["pipeline", "tracker-only", "empty"],
+          "x-sensitivity": "none"
+        },
+        "stateReadable": {
+          "type": "boolean",
+          "x-sensitivity": "none"
+        },
+        "status": {
+          "type": ["string", "null"],
+          "x-sensitivity": "none"
+        },
+        "currentPhase": {
+          "type": ["integer", "null"],
+          "x-sensitivity": "none"
+        },
+        "branch": {
+          "type": ["string", "null"],
+          "x-sensitivity": "none"
+        },
+        "baseBranch": {
+          "type": ["string", "null"],
+          "x-sensitivity": "none"
+        },
+        "startedAt": {
+          "type": ["string", "null"],
+          "x-sensitivity": "none"
+        },
+        "worktreePath": {
+          "type": ["string", "null"],
+          "x-sensitivity": "local"
+        },
         "prUrl": {
           "type": ["string", "null"],
           "x-sensitivity": "local",
           "description": "Carries the host, so it stays on this machine."
         },
-        "autopilot": { "type": "boolean", "x-sensitivity": "none" },
+        "autopilot": {
+          "type": "boolean",
+          "x-sensitivity": "none"
+        },
         "schemaVersion": {
           "type": ["string", "null"],
           "x-sensitivity": "none",
           "description": "The run's agent-state schemaVersion. Always a string; a number in a hand-edited state is printed as its string."
         },
-        "rev": { "type": ["integer", "null"], "x-sensitivity": "none" },
+        "rev": {
+          "type": ["integer", "null"],
+          "x-sensitivity": "none"
+        },
         "sessionId": {
           "type": ["string", "null"],
           "x-sensitivity": "none",
@@ -92,26 +144,60 @@
         "pendingQuestion": {
           "x-sensitivity": "none",
           "description": "The question the run stopped on, present only with waitingFor question. Answer it with one of options[].id through `answer-question.mjs` or POST /v1/runs/{id}/answer. text and labels are scrubbed under --redact. Added in 1.1.0.",
-          "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/question" }]
+          "oneOf": [
+            {
+              "type": "null"
+            },
+            {
+              "$ref": "#/$defs/question"
+            }
+          ]
+        },
+        "group": {
+          "enum": ["waiting", "stopped", "question", "unknown"],
+          "x-sensitivity": "none"
         },
-        "group": { "enum": ["waiting", "stopped", "question", "unknown"], "x-sensitivity": "none" },
         "phases": {
           "type": "array",
           "x-sensitivity": "none",
-          "items": { "$ref": "#/$defs/phase" }
+          "items": {
+            "$ref": "#/$defs/phase"
+          }
         },
         "tokens": {
           "type": "object",
           "required": ["in", "out", "cached"],
           "x-sensitivity": "none",
           "properties": {
-            "in": { "type": "integer", "minimum": 0 },
-            "out": { "type": "integer", "minimum": 0 },
-            "cached": { "type": "integer", "minimum": 0 }
+            "in": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "out": {
+              "type": "integer",
+              "minimum": 0
+            },
+            "cached": {
+              "type": "integer",
+              "minimum": 0
+            }
           }
         },
-        "estUsd": { "type": "number", "minimum": 0, "x-sensitivity": "none" },
-        "unlockedWrites": { "type": "integer", "minimum": 0, "x-sensitivity": "none" },
+        "estUsd": {
+          "type": "number",
+          "minimum": 0,
+          "x-sensitivity": "none"
+        },
+        "unlockedWrites": {
+          "type": "integer",
+          "minimum": 0,
+          "x-sensitivity": "none"
+        },
+        "mode": {
+          "type": ["string", "null"],
+          "x-sensitivity": "none",
+          "description": "agent-state.json mode as the run recorded it (analysis, test-gen, review...), so a reader can name the command; null when none was recorded."
+        },
         "runType": {
           "enum": ["analysis", "development", "autopilot"],
           "x-sensitivity": "none",
@@ -141,8 +227,85 @@
           "x-sensitivity": "none",
           "description": "The first in_progress task of the phase in progress, or null. Scrubbed under --redact. Added in 1.2.0.",
           "properties": {
-            "subject": { "type": "string" },
-            "activeForm": { "type": ["string", "null"] }
+            "subject": {
+              "type": "string"
+            },
+            "activeForm": {
+              "type": ["string", "null"]
+            }
+          }
+        },
+        "source": {
+          "type": ["object", "null"],
+          "additionalProperties": false,
+          "required": ["kind", "jira", "issue"],
+          "x-sensitivity": "none",
+          "description": "Where the work came from: a Jira key, a GitHub issue (owner/repo#N) or free text; a GitHub issue that got a Jira has both. Null when the run recorded neither. Added in 1.3.0.",
+          "properties": {
+            "kind": {
+              "enum": ["jira", "github", "text"]
+            },
+            "jira": {
+              "type": ["string", "null"],
+              "pattern": "^[A-Z][A-Z0-9_]{0,30}-[0-9]{1,9}$"
+            },
+            "issue": {
+              "type": ["string", "null"],
+              "pattern": "^[A-Za-z0-9_.-]{1,100}/[A-Za-z0-9_.-]{1,100}#[0-9]{1,9}$"
+            }
+          }
+        },
+        "prNumber": {
+          "type": ["integer", "null"],
+          "minimum": 1,
+          "x-sensitivity": "none",
+          "description": "The pull request's number, from the state or its URL; the URL itself is prUrl (local). Added in 1.3.0."
+        },
+        "channels": {
+          "type": "array",
+          "maxItems": 5,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["channel", "status"],
+            "properties": {
+              "channel": {
+                "enum": ["pr", "jira", "confluence", "wiki", "issue"]
+              },
+              "status": {
+                "enum": ["posted", "skipped", "failed"]
+              }
+            }
+          },
+          "x-sensitivity": "none",
+          "description": "Where Phase 5 sent the report, per adapter (state.channelResults); empty before then. Added in 1.3.0."
+        },
+        "channelUrls": {
+          "type": "object",
+          "additionalProperties": false,
+          "x-sensitivity": "local",
+          "description": "The address each adapter posted to, https only; dropped from a redacted answer. Added in 1.3.0.",
+          "properties": {
+            "pr": {
+              "type": "string",
+              "pattern": "^https://"
+            },
+            "jira": {
+              "type": "string",
+              "pattern": "^https://"
+            },
+            "confluence": {
+              "type": "string",
+              "pattern": "^https://"
+            },
+            "wiki": {
+              "type": "string",
+              "pattern": "^https://"
+            },
+            "issue": {
+              "type": "string",
+              "pattern": "^https://"
+            }
           }
         }
       }
@@ -152,10 +315,22 @@
       "additionalProperties": false,
       "required": ["id", "stepId", "text", "kind", "options"],
       "properties": {
-        "id": { "type": "string", "x-sensitivity": "none" },
-        "stepId": { "type": "string", "x-sensitivity": "none" },
-        "text": { "type": "string", "x-sensitivity": "none" },
-        "kind": { "enum": ["single-select", "multi-select"], "x-sensitivity": "none" },
+        "id": {
+          "type": "string",
+          "x-sensitivity": "none"
+        },
+        "stepId": {
+          "type": "string",
+          "x-sensitivity": "none"
+        },
+        "text": {
+          "type": "string",
+          "x-sensitivity": "none"
+        },
+        "kind": {
+          "enum": ["single-select", "multi-select"],
+          "x-sensitivity": "none"
+        },
         "options": {
           "type": "array",
           "x-sensitivity": "none",
@@ -164,8 +339,12 @@
             "additionalProperties": false,
             "required": ["id", "label"],
             "properties": {
-              "id": { "type": "string" },
-              "label": { "type": "string" }
+              "id": {
+                "type": "string"
+              },
+              "label": {
+                "type": "string"
+              }
             }
           }
         }
@@ -185,12 +364,30 @@
         "subList"
       ],
       "properties": {
-        "id": { "type": "string", "x-sensitivity": "none" },
-        "name": { "type": "string", "x-sensitivity": "none" },
-        "status": { "type": "string", "x-sensitivity": "none" },
-        "model": { "type": ["string", "null"], "x-sensitivity": "none" },
-        "startedAt": { "type": ["string", "null"], "x-sensitivity": "none" },
-        "completedAt": { "type": ["string", "null"], "x-sensitivity": "none" },
+        "id": {
+          "type": "string",
+          "x-sensitivity": "none"
+        },
+        "name": {
+          "type": "string",
+          "x-sensitivity": "none"
+        },
+        "status": {
+          "type": "string",
+          "x-sensitivity": "none"
+        },
+        "model": {
+          "type": ["string", "null"],
+          "x-sensitivity": "none"
+        },
+        "startedAt": {
+          "type": ["string", "null"],
+          "x-sensitivity": "none"
+        },
+        "completedAt": {
+          "type": ["string", "null"],
+          "x-sensitivity": "none"
+        },
         "now": {
           "type": ["string", "null"],
           "x-sensitivity": "none",
@@ -210,9 +407,15 @@
             "additionalProperties": false,
             "required": ["id", "name", "status"],
             "properties": {
-              "id": { "type": "string" },
-              "name": { "type": "string" },
-              "status": { "type": "string" }
+              "id": {
+                "type": "string"
+              },
+              "name": {
+                "type": "string"
+              },
+              "status": {
+                "type": "string"
+              }
             }
           }
         },
@@ -232,10 +435,18 @@
             "additionalProperties": false,
             "required": ["id", "subject", "activeForm", "status"],
             "properties": {
-              "id": { "type": "string" },
-              "subject": { "type": "string" },
-              "activeForm": { "type": ["string", "null"] },
-              "status": { "enum": ["pending", "in_progress", "completed"] }
+              "id": {
+                "type": "string"
+              },
+              "subject": {
+                "type": "string"
+              },
+              "activeForm": {
+                "type": ["string", "null"]
+              },
+              "status": {
+                "enum": ["pending", "in_progress", "completed"]
+              }
             }
           }
         }