@mmerterden/multi-agent-pipeline 20.29.0 → 20.33.0

package/pipeline/schemas/phases.schema.json

@@ -7,16 +7,38 @@
   "additionalProperties": false,
   "required": ["contractVersion", "phaseSchema", "phases", "totalMaxTokens", "modes", "thresholds"],
   "properties": {
-    "$schema": { "type": "string" },
-    "$id": { "type": "string" },
-    "description": { "type": "string" },
-    "contractVersion": { "type": "string", "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$" },
-    "phaseSchema": { "type": "integer", "minimum": 1 },
-    "phaseSchemaNote": { "type": "string" },
+    "$schema": {
+      "type": "string"
+    },
+    "$id": {
+      "type": "string"
+    },
+    "description": {
+      "type": "string"
+    },
+    "contractVersion": {
+      "type": "string",
+      "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$"
+    },
+    "phaseSchema": {
+      "type": "integer",
+      "minimum": 1
+    },
+    "phaseSchemaNote": {
+      "type": "string"
+    },
     "legacyPhaseNames": {
       "type": "object",
-      "properties": { "note": { "type": "string" } },
-      "patternProperties": { "^[0-9]+$": { "type": "string" } },
+      "properties": {
+        "note": {
+          "type": "string"
+        }
+      },
+      "patternProperties": {
+        "^[0-9]+$": {
+          "type": "string"
+        }
+      },
       "additionalProperties": false
     },
     "phases": {
@@ -27,15 +49,36 @@
         "additionalProperties": false,
         "required": ["id", "name", "doc", "maxTokens"],
         "properties": {
-          "id": { "type": "integer", "minimum": 0 },
-          "name": { "type": "string", "minLength": 1 },
-          "doc": { "type": "string", "pattern": "^phase-[0-9]+-[a-z-]+\\.md$" },
-          "maxTokens": { "type": "integer", "minimum": 1 },
-          "was": { "type": "array", "items": { "type": "integer", "minimum": 0 } }
+          "id": {
+            "type": "integer",
+            "minimum": 0
+          },
+          "name": {
+            "type": "string",
+            "minLength": 1
+          },
+          "doc": {
+            "type": "string",
+            "pattern": "^phase-[0-9]+-[a-z-]+\\.md$"
+          },
+          "maxTokens": {
+            "type": "integer",
+            "minimum": 1
+          },
+          "was": {
+            "type": "array",
+            "items": {
+              "type": "integer",
+              "minimum": 0
+            }
+          }
         }
       }
     },
-    "totalMaxTokens": { "type": "integer", "minimum": 1 },
+    "totalMaxTokens": {
+      "type": "integer",
+      "minimum": 1
+    },
     "modes": {
       "type": "object",
       "minProperties": 1,
@@ -47,13 +90,29 @@
           "phases": {
             "type": "array",
             "minItems": 1,
-            "items": { "type": "integer", "minimum": 0 },
+            "items": {
+              "type": "integer",
+              "minimum": 0
+            },
             "uniqueItems": true
           },
-          "autopilot": { "type": "boolean" },
+          "autopilot": {
+            "type": "boolean"
+          },
           "commits": {
             "type": "boolean",
             "description": "false when the mode delivers no commit in its Phase 4; lib/run-completion.mjs then asks for no commit evidence before status complete. Absent means the mode commits."
+          },
+          "names": {
+            "type": "object",
+            "additionalProperties": false,
+            "patternProperties": {
+              "^[0-9]$": {
+                "type": "string",
+                "pattern": "^[A-Z][A-Za-z]{1,20}$"
+              }
+            },
+            "description": "The mode's own phase names by id, where they differ from the canonical ones (the analysis pipeline's Intake .. Report). Absent means the canonical names."
           }
         }
       }
@@ -63,9 +122,17 @@
       "additionalProperties": false,
       "required": ["waitingFromPhase", "mcpAllowedThroughPhase"],
       "properties": {
-        "waitingFromPhase": { "type": "integer", "minimum": 0 },
-        "mcpAllowedThroughPhase": { "type": "integer", "minimum": 0 },
-        "note": { "type": "string" }
+        "waitingFromPhase": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "mcpAllowedThroughPhase": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "note": {
+          "type": "string"
+        }
       }
     }
   }

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.",

package/pipeline/schemas/prs.schema.json

@@ -0,0 +1,78 @@
+{
+  "$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"]
+          },
+          "account": {
+            "type": ["string", "null"],
+            "x-sensitivity": "local",
+            "description": "The GitHub login the pull request was listed under, when gh is logged in to more than one account (personal and corporate). Null for 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/prune-logs-request.schema.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/mmerterden/multi-agent-pipeline/pipeline/schemas/prune-logs-request.schema.json",
+  "title": "Prune logs request",
+  "description": "The body of POST /v1/prune-logs. Step 1 names the age in days (7, 30 or 90); step 2 sends only the confirmToken step 1 returned.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["contractVersion"],
+  "properties": {
+    "contractVersion": {
+      "type": "string",
+      "pattern": "^1\\.[0-9]+\\.[0-9]+$",
+      "x-sensitivity": "none"
+    },
+    "olderThanDays": {
+      "enum": [7, 30, 90],
+      "x-sensitivity": "none"
+    },
+    "confirmToken": {
+      "type": "string",
+      "pattern": "^[A-Za-z0-9_-]{16,128}$",
+      "x-sensitivity": "none",
+      "description": "The confirmToken the preview returned. Single use, bound to the route."
+    }
+  }
+}

package/pipeline/schemas/prune-logs.schema.json

@@ -0,0 +1,52 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/mmerterden/multi-agent-pipeline/pipeline/schemas/prune-logs.schema.json",
+  "title": "Prune old run logs",
+  "description": "What POST /v1/prune-logs returns. The preview (body {olderThanDays}) is prune-logs.sh's dry run for that age with a confirm token; the confirmation (body {confirmToken}) runs it again with the same age and --yes. The audit trail, the metrics corpus and task counters are never removed, and a folder written in the last minutes is spared.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["contractVersion", "olderThanDays", "applied", "count", "freedMb", "folders"],
+  "properties": {
+    "contractVersion": {
+      "type": "string",
+      "pattern": "^1\\.[0-9]+\\.[0-9]+$",
+      "x-sensitivity": "none"
+    },
+    "olderThanDays": {
+      "enum": [7, 30, 90],
+      "x-sensitivity": "none"
+    },
+    "applied": {
+      "type": "boolean",
+      "x-sensitivity": "none"
+    },
+    "count": {
+      "type": "integer",
+      "minimum": 0,
+      "x-sensitivity": "none"
+    },
+    "freedMb": {
+      "type": "number",
+      "minimum": 0,
+      "x-sensitivity": "none"
+    },
+    "folders": {
+      "type": "array",
+      "maxItems": 200,
+      "items": {
+        "type": "string"
+      },
+      "x-sensitivity": "local",
+      "description": "project/task folders, at most 200 listed."
+    },
+    "confirmToken": {
+      "type": "string",
+      "x-sensitivity": "local"
+    },
+    "expiresAt": {
+      "type": "string",
+      "format": "date-time",
+      "x-sensitivity": "none"
+    }
+  }
+}

package/pipeline/schemas/repo-change.schema.json

@@ -0,0 +1,54 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/mmerterden/multi-agent-pipeline/pipeline/schemas/repo-change.schema.json",
+  "title": "Repository registration change",
+  "description": "What POST /v1/repos and DELETE /v1/repos/{id} return. Without a token: preview (the repository's name) with confirmToken and expiresAt. With it: registered or removed, by name. Paths never leave the server here.",
+  "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"],
+      "properties": {
+        "name": {
+          "type": "string"
+        }
+      }
+    },
+    "confirmToken": {
+      "type": "string",
+      "pattern": "^[A-Za-z0-9_-]{16,128}$"
+    },
+    "expiresAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "registered": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name"],
+      "properties": {
+        "name": {
+          "type": "string"
+        }
+      }
+    },
+    "removed": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name"],
+      "properties": {
+        "name": {
+          "type": "string"
+        }
+      }
+    }
+  }
+}

package/pipeline/schemas/repo-request.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/repo-request.schema.json",
+  "title": "Repository registration request",
+  "description": "The body of POST /v1/repos. The first request names suggestion (an id from GET /v1/repos?all=1) or path (an absolute path to a git checkout); the second sends only confirmToken.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["contractVersion"],
+  "properties": {
+    "contractVersion": {
+      "type": "string",
+      "pattern": "^1\\.[0-9]+\\.[0-9]+$",
+      "x-sensitivity": "none"
+    },
+    "suggestion": {
+      "type": "string",
+      "pattern": "^[0-9a-f]{16}$"
+    },
+    "path": {
+      "type": "string",
+      "maxLength": 4096,
+      "x-sensitivity": "local"
+    },
+    "confirmToken": {
+      "type": "string",
+      "pattern": "^[A-Za-z0-9_-]{16,128}$"
+    }
+  }
+}

package/pipeline/schemas/repos.schema.json

@@ -2,7 +2,7 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://github.com/mmerterden/multi-agent-pipeline/pipeline/schemas/repos.schema.json",
   "title": "Launch repositories",
-  "description": "What GET /v1/repos returns and `launch-request.mjs repos` prints: the repositories POST /v1/launch?repo= accepts, by real path. source autopilot is a configured autopilot repo (config.json repos[], named by nameWithOwner); registered is one added with `launch-request.mjs register-repo` (launch-repos.json, named by its directory). path is dropped under redact.",
+  "description": "What GET /v1/repos returns and `launch-request.mjs repos` prints: the repositories POST /v1/launch?repo= accepts, by real path. source autopilot is a configured autopilot repo (config.json repos[], named by nameWithOwner); registered is one added with `launch-request.mjs register-repo` (launch-repos.json, named by its directory). path is dropped under redact. With --all (?all=1): suggested lists checkouts earlier runs worked in that launch does not accept yet, and missing lists registered entries that are no longer a directory; each carries an id that POST /v1/repos and DELETE /v1/repos/{id} take.",
   "type": "object",
   "additionalProperties": false,
   "required": ["contractVersion", "repos"],
@@ -34,6 +34,54 @@
           }
         }
       }
+    },
+    "suggested": {
+      "type": "array",
+      "x-sensitivity": "none",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "name"],
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^[0-9a-f]{16}$",
+            "x-sensitivity": "none"
+          },
+          "path": {
+            "type": "string",
+            "x-sensitivity": "local"
+          },
+          "name": {
+            "type": "string",
+            "x-sensitivity": "none"
+          }
+        }
+      }
+    },
+    "missing": {
+      "type": "array",
+      "x-sensitivity": "none",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "name"],
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^[0-9a-f]{16}$",
+            "x-sensitivity": "none"
+          },
+          "path": {
+            "type": "string",
+            "x-sensitivity": "local"
+          },
+          "name": {
+            "type": "string",
+            "x-sensitivity": "none"
+          }
+        }
+      }
     }
   }
 }

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"]
+          }
+        }
+      }
+    }
+  }
+}