@mmerterden/multi-agent-pipeline 20.28.0 → 20.30.0

package/pipeline/schemas/prefs.schema.json

@@ -309,6 +309,25 @@
             "maxItems": 10
           }
         },
+        "office": {
+          "type": "object",
+          "description": "The office panel (/multi-agent:office-on). page overrides the installed panel page; toolkitVersion pins an @latest toolkit registration for the panel's tool calls; remote is read only to report that a separately installed remote layer is present, and no remote code ships with the pipeline.",
+          "additionalProperties": false,
+          "properties": {
+            "page": {
+              "type": "string",
+              "description": "Absolute path of an HTML page GET /office serves instead of the installed one."
+            },
+            "toolkitVersion": {
+              "type": "string",
+              "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+(-[0-9A-Za-z.-]+)?$"
+            },
+            "remote": {
+              "type": "object",
+              "description": "Configuration owned by a separately installed remote layer; the pipeline only checks that it exists."
+            }
+          }
+        },
         "routines": {
           "type": "array",
           "description": "v2.4.0+. User-defined routines saved via /multi-agent:save. Each entry indexes a local-only /multi-agent:<name> command dir under ~/.claude/commands/multi-agent/. Never synced (personal). Managed by routine-registry.mjs.",
@@ -1872,6 +1891,43 @@
             "enabled": false
           }
         },
+        "stopGuard": {
+          "type": "object",
+          "additionalProperties": false,
+          "description": "run-stop-guard.sh, the Claude Code Stop hook that holds the session driving a pipeline run from ending its turn mid-phase with no halt or wait recorded. Read first on every Stop; false lets every stop through. Removing the hook from settings.json works too, and install does not add it back.",
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "default": true,
+              "description": "true = the hook judges a stop as documented. false = it never blocks."
+            }
+          },
+          "default": {
+            "enabled": true
+          }
+        },
+        "readOnlyRepos": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 },
+          "default": [],
+          "description": "Absolute paths (a leading ~ is expanded) of checkouts kept as read-only references: agent-guard.sh refuses an Edit, Write or NotebookEdit whose target is inside one, and a git commit, push, merge, cherry-pick, revert, am, rebase or tag that runs in one (after any cd or git -C on the line). Attended and unattended alike. Empty means no repository is protected this way."
+        },
+        "attendedCommitGate": {
+          "type": "object",
+          "additionalProperties": false,
+          "description": "What pre-commit-check.sh does with an attended `git commit` inside a pipeline run whose gate ledger holds no passing build and test verdict (evidence-gate/build, evidence-gate/test) for HEAD. evidence-gate.mjs records both in an attended run, marked attended. Read by gate-ledger.mjs `evidence`; a commit outside a run, or in a mode that commits nothing, is never checked. Unattended commits are held to the full ledger regardless of this setting.",
+          "properties": {
+            "mode": {
+              "type": "string",
+              "enum": ["off", "warn", "block"],
+              "default": "warn",
+              "description": "warn = say so on stderr and let the commit through. block = refuse the commit (exit 2) until the evidence is recorded. off = no check."
+            }
+          },
+          "default": {
+            "mode": "warn"
+          }
+        },
         "mutationProbe": {
           "type": "object",
           "additionalProperties": false,

package/pipeline/schemas/prs.schema.json

@@ -0,0 +1,73 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/mmerterden/multi-agent-pipeline/pipeline/schemas/prs.schema.json",
+  "title": "Pull requests",
+  "description": "What GET /v1/prs returns (`work-items.mjs prs`): open pull requests where you are asked to review or are the author. sources says per host whether it was read; Bitbucket listing is not implemented and says so rather than showing an empty list. url is dropped under redact.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["contractVersion", "items", "sources"],
+  "properties": {
+    "contractVersion": {
+      "type": "string",
+      "pattern": "^1\\.[0-9]+\\.[0-9]+$",
+      "x-sensitivity": "none"
+    },
+    "items": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["source", "repo", "number", "title", "url", "author", "updatedAt", "role"],
+        "properties": {
+          "source": {
+            "enum": ["github", "bitbucket"]
+          },
+          "repo": {
+            "type": "string"
+          },
+          "number": {
+            "type": "integer"
+          },
+          "title": {
+            "type": "string"
+          },
+          "url": {
+            "type": ["string", "null"],
+            "x-sensitivity": "local"
+          },
+          "author": {
+            "type": ["string", "null"]
+          },
+          "updatedAt": {
+            "type": ["string", "null"]
+          },
+          "role": {
+            "enum": ["reviewer", "author"]
+          }
+        }
+      }
+    },
+    "sources": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["source", "ok", "count"],
+        "properties": {
+          "source": {
+            "type": "string"
+          },
+          "ok": {
+            "type": "boolean"
+          },
+          "count": {
+            "type": "integer"
+          },
+          "reason": {
+            "type": "string"
+          }
+        }
+      }
+    }
+  }
+}

package/pipeline/schemas/review-verdict-request.schema.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/mmerterden/multi-agent-pipeline/pipeline/schemas/review-verdict-request.schema.json",
+  "title": "Review verdict request",
+  "description": "The body of POST /v1/runs/{id}/review-verdict: empty for the preview, confirmToken to post. The verdict is never chosen by the request; it follows from the review's recorded findings.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["contractVersion"],
+  "properties": {
+    "contractVersion": {
+      "type": "string",
+      "pattern": "^1\\.[0-9]+\\.[0-9]+$",
+      "x-sensitivity": "none"
+    },
+    "confirmToken": {
+      "type": "string",
+      "pattern": "^[A-Za-z0-9_-]{16,128}$"
+    }
+  }
+}

package/pipeline/schemas/review-verdict.schema.json

@@ -0,0 +1,62 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/mmerterden/multi-agent-pipeline/pipeline/schemas/review-verdict.schema.json",
+  "title": "Review verdict",
+  "description": "What POST /v1/runs/{id}/review-verdict returns (`work-items.mjs verdict <id> [--post]`). Only a finished review whose every finding is triaged (accepted, rejected or deferred) is previewed (409 review-incomplete otherwise). The preview carries findingsDigest, the hash of the findings it was made from, and the decision lib/post-pr-review.sh would post (approve with no accepted blocking or important finding, else needs-work), a confirmToken bound to that decision and digest, and expiresAt; a confirmation after either changed is 409 confirm-mismatch; the confirmation runs post-pr-review.sh, which posts the comments and the verdict with the user's own credential, and says posted.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "contractVersion",
+    "taskId",
+    "provider",
+    "prNumber",
+    "decision",
+    "acceptedBlocking",
+    "acceptedImportant",
+    "findings",
+    "findingsDigest"
+  ],
+  "properties": {
+    "contractVersion": {
+      "type": "string",
+      "pattern": "^1\\.[0-9]+\\.[0-9]+$",
+      "x-sensitivity": "none"
+    },
+    "taskId": {
+      "type": "string"
+    },
+    "provider": {
+      "enum": ["github", "bitbucket-server", null]
+    },
+    "prNumber": {
+      "type": ["integer", "null"]
+    },
+    "decision": {
+      "enum": ["approve", "needs-work"]
+    },
+    "acceptedBlocking": {
+      "type": "integer"
+    },
+    "acceptedImportant": {
+      "type": "integer"
+    },
+    "findings": {
+      "type": "integer"
+    },
+    "posted": {
+      "type": "boolean"
+    },
+    "confirmToken": {
+      "type": "string",
+      "pattern": "^[A-Za-z0-9_-]{16,128}$"
+    },
+    "expiresAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "findingsDigest": {
+      "type": "string",
+      "pattern": "^[0-9a-f]{64}$"
+    }
+  }
+}

package/pipeline/schemas/routine-delete.schema.json

@@ -0,0 +1,59 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/mmerterden/multi-agent-pipeline/pipeline/schemas/routine-delete.schema.json",
+  "title": "Routine removal",
+  "description": "What DELETE /v1/routines/{name} returns. Without ?confirm: preview (the routine) with confirmToken and expiresAt. With it: removed, from `routine-registry.mjs remove`. A shipped command is never removed.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["contractVersion"],
+  "properties": {
+    "contractVersion": {
+      "type": "string",
+      "pattern": "^1\\.[0-9]+\\.[0-9]+$",
+      "x-sensitivity": "none"
+    },
+    "preview": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "description", "createdAt", "source"],
+      "properties": {
+        "name": {
+          "type": "string"
+        },
+        "description": {
+          "type": "string"
+        },
+        "createdAt": {
+          "type": ["string", "null"]
+        },
+        "source": {
+          "type": ["string", "null"]
+        }
+      }
+    },
+    "confirmToken": {
+      "type": "string",
+      "pattern": "^[A-Za-z0-9_-]{16,128}$"
+    },
+    "expiresAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "removed": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "removedDir", "removedEntry"],
+      "properties": {
+        "name": {
+          "type": "string"
+        },
+        "removedDir": {
+          "type": "boolean"
+        },
+        "removedEntry": {
+          "type": "boolean"
+        }
+      }
+    }
+  }
+}

package/pipeline/schemas/routines.schema.json

@@ -0,0 +1,38 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/mmerterden/multi-agent-pipeline/pipeline/schemas/routines.schema.json",
+  "title": "Routines",
+  "description": "What GET /v1/routines returns (`routine-registry.mjs list --json`): the routines saved with /multi-agent:save. Description and source are scrubbed.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["contractVersion", "routines"],
+  "properties": {
+    "contractVersion": {
+      "type": "string",
+      "pattern": "^1\\.[0-9]+\\.[0-9]+$",
+      "x-sensitivity": "none"
+    },
+    "routines": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["name", "description", "createdAt", "source"],
+        "properties": {
+          "name": {
+            "type": "string"
+          },
+          "description": {
+            "type": "string"
+          },
+          "createdAt": {
+            "type": ["string", "null"]
+          },
+          "source": {
+            "type": ["string", "null"]
+          }
+        }
+      }
+    }
+  }
+}

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

@@ -87,7 +87,7 @@
         "waitingFor": {
           "type": ["string", "null"],
           "x-sensitivity": "none",
-          "description": "The step a paused run re-enters (agent-state waitingFor): maturity, user-channels-choice or question. Added in 1.1.0."
+          "description": "The step a paused run re-enters (agent-state waitingFor): maturity, user-channels-choice, local-test, attended-reply or question; null or absent when the run is not waiting. Added in 1.1.0."
         },
         "pendingQuestion": {
           "x-sensitivity": "none",

package/pipeline/schemas/service-read.schema.json

@@ -0,0 +1,58 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/mmerterden/multi-agent-pipeline/pipeline/schemas/service-read.schema.json",
+  "title": "Service read",
+  "description": "What GET /v1/services/confluence, /crashlytics and /figma return (`service-read.mjs`): one Confluence page, one Crashlytics issue or one Figma frame render, through the pipeline's own clients. Text is redacted; a frame comes back as base64 PNG.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["contractVersion", "service"],
+  "properties": {
+    "contractVersion": {
+      "type": "string",
+      "pattern": "^1\\.[0-9]+\\.[0-9]+$",
+      "x-sensitivity": "none"
+    },
+    "service": {
+      "enum": ["confluence", "crashlytics", "figma"]
+    },
+    "pageId": {
+      "type": ["string", "null"]
+    },
+    "title": {
+      "type": "string"
+    },
+    "body": {
+      "type": "string"
+    },
+    "apiContracts": {
+      "type": "integer"
+    },
+    "type": {
+      "type": ["string", "null"]
+    },
+    "occurrences": {
+      "type": ["number", "null"]
+    },
+    "impactedUsers": {
+      "type": ["number", "null"]
+    },
+    "stackTrace": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "fileKey": {
+      "type": "string"
+    },
+    "nodeId": {
+      "type": "string"
+    },
+    "mime": {
+      "const": "image/png"
+    },
+    "data": {
+      "type": "string"
+    }
+  }
+}