@mmerterden/multi-agent-pipeline 20.30.0 → 20.33.0

package/pipeline/schemas/contract-error.schema.json

@@ -62,7 +62,18 @@
         "busy",
         "review-incomplete",
         "host-not-allowed",
-        "internal"
+        "internal",
+        "unknown-job",
+        "command-not-installed",
+        "invalid-repo",
+        "invalid-args",
+        "room-busy",
+        "sandbox-unavailable",
+        "launch-failed",
+        "guard-missing",
+        "name-taken",
+        "already-registered",
+        "not-registered"
       ],
       "x-sensitivity": "none"
     },

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

@@ -0,0 +1,72 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/mmerterden/multi-agent-pipeline/pipeline/schemas/job-change.schema.json",
+  "title": "Office job start",
+  "description": "What POST /v1/jobs returns. Without a token: preview (the job, the role that does it, team or solo, the repository by name, the exact prompt the session receives and what it writes outside the machine) with confirmToken and expiresAt. With it: started, the session the server began.",
+  "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": ["jobId", "role", "team", "repo", "prompt", "writes"],
+      "properties": {
+        "jobId": {
+          "type": "string"
+        },
+        "role": {
+          "type": "string"
+        },
+        "team": {
+          "type": "boolean"
+        },
+        "repo": {
+          "type": "string"
+        },
+        "prompt": {
+          "type": "string"
+        },
+        "writes": {
+          "enum": ["none", "branch", "branch-pr", "pr-comments", "issue-comment"]
+        }
+      }
+    },
+    "confirmToken": {
+      "type": "string",
+      "pattern": "^[A-Za-z0-9_-]{16,128}$"
+    },
+    "expiresAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "started": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["sessionId", "jobId", "role", "team", "repo"],
+      "properties": {
+        "sessionId": {
+          "type": "string",
+          "pattern": "^[0-9a-f-]{36}$"
+        },
+        "jobId": {
+          "type": "string"
+        },
+        "role": {
+          "type": "string"
+        },
+        "team": {
+          "type": "boolean"
+        },
+        "repo": {
+          "type": "string"
+        }
+      }
+    }
+  }
+}

package/pipeline/schemas/job-request.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/job-request.schema.json",
+  "title": "Office job request",
+  "description": "The body of POST /v1/jobs. The first request names jobId (from GET /v1/jobs), repo (a name from GET /v1/repos or its path) and args (by parameter name), plus answers for a pipeline run; the second sends only confirmToken.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["contractVersion"],
+  "properties": {
+    "contractVersion": {
+      "type": "string",
+      "pattern": "^1\\.[0-9]+\\.[0-9]+$",
+      "x-sensitivity": "none"
+    },
+    "jobId": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9-]{1,40}$"
+    },
+    "repo": {
+      "type": "string",
+      "maxLength": 4096
+    },
+    "args": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "string",
+        "maxLength": 4000
+      }
+    },
+    "answers": {
+      "type": "object"
+    },
+    "confirmToken": {
+      "type": "string",
+      "pattern": "^[A-Za-z0-9_-]{16,128}$"
+    }
+  }
+}

package/pipeline/schemas/launch.json

@@ -41,7 +41,7 @@
             "MULTI_AGENT_UNATTENDED": "1",
             "MULTI_AGENT_SESSION_ID": "{sessionId}",
             "MCP_TOOLKIT_URL_POLICY": "strict",
-            "MCP_TOOLKIT_INDEX_DENY": "~/.ssh,~/.aws,~/.gnupg,~/Library/Keychains",
+            "MCP_TOOLKIT_INDEX_DENY": "~/.ssh,~/.aws,~/.gnupg,~/Library/Keychains,~/.claude/logs/multi-agent/contract-server,~/.claude/logs/multi-agent/office",
             "LOGS_ROOT": "{runLogsRoot}",
             "MA_LAUNCH_REQUEST": "{requestFile}"
           }
@@ -64,7 +64,7 @@
             "MULTI_AGENT_UNATTENDED": "1",
             "MULTI_AGENT_SESSION_ID": "{sessionId}",
             "MCP_TOOLKIT_URL_POLICY": "strict",
-            "MCP_TOOLKIT_INDEX_DENY": "~/.ssh,~/.aws,~/.gnupg,~/Library/Keychains",
+            "MCP_TOOLKIT_INDEX_DENY": "~/.ssh,~/.aws,~/.gnupg,~/Library/Keychains,~/.claude/logs/multi-agent/contract-server,~/.claude/logs/multi-agent/office",
             "LOGS_ROOT": "{runLogsRoot}",
             "MA_LAUNCH_REQUEST": "{requestFile}"
           }
@@ -84,7 +84,7 @@
             "MULTI_AGENT_UNATTENDED": "1",
             "MULTI_AGENT_SESSION_ID": "{sessionId}",
             "MCP_TOOLKIT_URL_POLICY": "strict",
-            "MCP_TOOLKIT_INDEX_DENY": "~/.ssh,~/.aws,~/.gnupg,~/Library/Keychains",
+            "MCP_TOOLKIT_INDEX_DENY": "~/.ssh,~/.aws,~/.gnupg,~/Library/Keychains,~/.claude/logs/multi-agent/contract-server,~/.claude/logs/multi-agent/office",
             "LOGS_ROOT": "{runLogsRoot}",
             "MA_LAUNCH_REQUEST": "{requestFile}"
           }
@@ -105,7 +105,7 @@
           "MULTI_AGENT_UNATTENDED": "1",
           "MULTI_AGENT_SESSION_ID": "{sessionId}",
           "MCP_TOOLKIT_URL_POLICY": "strict",
-          "MCP_TOOLKIT_INDEX_DENY": "~/.ssh,~/.aws,~/.gnupg,~/Library/Keychains",
+          "MCP_TOOLKIT_INDEX_DENY": "~/.ssh,~/.aws,~/.gnupg,~/Library/Keychains,~/.claude/logs/multi-agent/contract-server,~/.claude/logs/multi-agent/office",
           "LOGS_ROOT": "{runLogsRoot}"
         }
       }

package/pipeline/schemas/office-credentials.schema.json

@@ -0,0 +1,71 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/mmerterden/multi-agent-pipeline/pipeline/schemas/office-credentials.schema.json",
+  "title": "Key cabinet",
+  "description": "What GET /v1/credentials returns and `office-credentials.mjs --json` prints: for each credential the pipeline knows by logical name, whether the store holds it and, with probe, whether its service accepted it. Never a value: lib/credential-inventory.sh reads each through the store with stdout discarded. Renewal stays in the terminal (/multi-agent:setup).",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["contractVersion", "generatedAt", "probed", "available", "credentials"],
+  "properties": {
+    "contractVersion": {
+      "type": "string",
+      "pattern": "^1\\.[0-9]+\\.[0-9]+$",
+      "x-sensitivity": "none"
+    },
+    "generatedAt": {
+      "type": "string",
+      "format": "date-time",
+      "x-sensitivity": "none"
+    },
+    "probed": {
+      "type": "boolean",
+      "x-sensitivity": "none"
+    },
+    "available": {
+      "type": "boolean",
+      "x-sensitivity": "none",
+      "description": "False when the inventory could not run on this host."
+    },
+    "credentials": {
+      "type": "array",
+      "x-sensitivity": "local",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["logical", "state", "reachability", "capability"],
+        "properties": {
+          "logical": {
+            "type": "string",
+            "pattern": "^[a-z][a-z0-9_]{0,60}$"
+          },
+          "state": {
+            "enum": ["present", "mapped-but-missing", "unmapped"]
+          },
+          "reachability": {
+            "enum": [
+              "not-probed",
+              "reachable",
+              "auth-rejected",
+              "unreachable",
+              "no-host-configured",
+              "well-formed",
+              "not-probeable",
+              "malformed",
+              "no-credential",
+              "probe-error",
+              "server-error",
+              "tier-1-ready",
+              "tier-2-ready",
+              "tier-1-no-grant",
+              "unknown"
+            ]
+          },
+          "capability": {
+            "type": ["string", "null"],
+            "maxLength": 160
+          }
+        }
+      }
+    }
+  }
+}

package/pipeline/schemas/office-jobs.json

@@ -0,0 +1,253 @@
+{
+  "$schema": "./office-jobs.schema.json",
+  "contractVersion": "1.0.0",
+  "description": "The jobs a person can hand to someone in the office. A solo job is one command one agent does at a desk; a team job is a pipeline run that meets in a room. Each parameter has a kind that job-launch.mjs checks before anything starts, so no job takes free text, and `writes` names what the job changes outside this machine, shown in the confirmation. Commands not listed here stay terminal commands.",
+  "jobs": [
+    {
+      "id": "pipeline",
+      "command": "multi-agent",
+      "role": "Orchestrator",
+      "team": true,
+      "launch": "development",
+      "params": [
+        {
+          "name": "input",
+          "kind": "work-item",
+          "required": true
+        }
+      ],
+      "writes": "branch-pr"
+    },
+    {
+      "id": "autopilot-run",
+      "command": "multi-agent",
+      "role": "Orchestrator",
+      "team": true,
+      "launch": "autopilot",
+      "params": [
+        {
+          "name": "input",
+          "kind": "work-item",
+          "required": true
+        }
+      ],
+      "writes": "branch-pr"
+    },
+    {
+      "id": "analysis",
+      "command": "analysis",
+      "role": "Planner",
+      "team": true,
+      "launch": "analysis",
+      "params": [
+        {
+          "name": "input",
+          "kind": "work-item",
+          "required": true
+        }
+      ],
+      "writes": "none"
+    },
+    {
+      "id": "review",
+      "command": "review",
+      "role": "Reviewer",
+      "team": false,
+      "params": [
+        {
+          "name": "target",
+          "kind": "pull-request",
+          "required": true
+        }
+      ],
+      "writes": "none"
+    },
+    {
+      "id": "security-review",
+      "command": "security-review",
+      "role": "Security Auditor",
+      "team": false,
+      "params": [
+        {
+          "name": "target",
+          "kind": "branch",
+          "required": false
+        }
+      ],
+      "writes": "none"
+    },
+    {
+      "id": "diff-explain",
+      "command": "diff-explain",
+      "role": "Reviewer",
+      "team": false,
+      "params": [
+        {
+          "name": "task",
+          "kind": "run-id",
+          "required": true
+        }
+      ],
+      "writes": "none"
+    },
+    {
+      "id": "review-jira",
+      "command": "review-jira",
+      "role": "Clarifier",
+      "team": false,
+      "params": [
+        {
+          "name": "issue",
+          "kind": "jira-key",
+          "required": true
+        }
+      ],
+      "writes": "none"
+    },
+    {
+      "id": "review-issue",
+      "command": "review-issue",
+      "role": "Clarifier",
+      "team": false,
+      "params": [
+        {
+          "name": "issue",
+          "kind": "github-issue",
+          "required": true
+        }
+      ],
+      "writes": "none"
+    },
+    {
+      "id": "estimate",
+      "command": "estimate",
+      "role": "Planner",
+      "team": false,
+      "params": [
+        {
+          "name": "input",
+          "kind": "jira-key",
+          "required": true
+        }
+      ],
+      "writes": "none"
+    },
+    {
+      "id": "research",
+      "command": "research",
+      "role": "Explorer",
+      "team": false,
+      "params": [
+        {
+          "name": "item",
+          "kind": "jira-key",
+          "required": true
+        }
+      ],
+      "writes": "none"
+    },
+    {
+      "id": "postmortem",
+      "command": "postmortem",
+      "role": "Reader",
+      "team": false,
+      "params": [
+        {
+          "name": "target",
+          "kind": "run-id",
+          "required": true
+        }
+      ],
+      "writes": "none"
+    },
+    {
+      "id": "graph",
+      "command": "graph",
+      "role": "Explorer",
+      "team": false,
+      "params": [
+        {
+          "name": "action",
+          "kind": "enum",
+          "values": ["build", "refresh", "report", "status"],
+          "required": true
+        }
+      ],
+      "writes": "none"
+    },
+    {
+      "id": "ios-coding-standard",
+      "command": "ios-coding-standard",
+      "role": "iOS Architect",
+      "team": false,
+      "params": [
+        {
+          "name": "target",
+          "kind": "repo-path",
+          "required": true
+        }
+      ],
+      "writes": "none"
+    },
+    {
+      "id": "test-gen",
+      "command": "test-gen",
+      "role": "Test Gap Analyst",
+      "team": true,
+      "params": [],
+      "writes": "branch"
+    },
+    {
+      "id": "doctor",
+      "command": "doctor",
+      "role": "Sysadmin",
+      "team": false,
+      "params": [],
+      "writes": "none"
+    },
+    {
+      "id": "route-status",
+      "command": "route-status",
+      "role": "Sysadmin",
+      "team": false,
+      "params": [],
+      "writes": "none"
+    },
+    {
+      "id": "scan",
+      "command": "scan",
+      "role": "Librarian",
+      "team": false,
+      "params": [],
+      "writes": "none"
+    },
+    {
+      "id": "scenario-audit",
+      "command": "scenario-audit",
+      "role": "Test Gap Analyst",
+      "team": false,
+      "params": [
+        {
+          "name": "scenarios",
+          "kind": "repo-path",
+          "required": true
+        }
+      ],
+      "writes": "none"
+    },
+    {
+      "id": "review-analysis",
+      "command": "review-analysis",
+      "role": "Clarifier",
+      "team": false,
+      "params": [
+        {
+          "name": "target",
+          "kind": "jira-key",
+          "required": true
+        }
+      ],
+      "writes": "none"
+    }
+  ]
+}

package/pipeline/schemas/office-jobs.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/office-jobs.schema.json",
+  "title": "Office jobs",
+  "description": "The catalog of jobs the office can start (office-jobs.json), read by job-launch.mjs and served by GET /v1/jobs.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["contractVersion", "jobs"],
+  "properties": {
+    "$schema": { "type": "string" },
+    "contractVersion": {
+      "type": "string",
+      "pattern": "^1\\.[0-9]+\\.[0-9]+$",
+      "x-sensitivity": "none"
+    },
+    "description": { "type": "string" },
+    "jobs": {
+      "type": "array",
+      "x-sensitivity": "none",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "command", "role", "team", "params", "writes"],
+        "properties": {
+          "id": { "type": "string", "pattern": "^[a-z][a-z0-9-]{1,40}$" },
+          "command": { "type": "string", "pattern": "^[a-z][a-z0-9-]{1,40}$" },
+          "role": { "type": "string", "minLength": 1 },
+          "team": { "type": "boolean" },
+          "launch": { "enum": ["development", "analysis", "autopilot"] },
+          "available": { "type": "boolean" },
+          "reason": { "type": ["string", "null"] },
+          "params": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["name", "kind", "required"],
+              "properties": {
+                "name": { "type": "string", "pattern": "^[a-z][a-z0-9-]{0,30}$" },
+                "kind": {
+                  "enum": [
+                    "work-item",
+                    "pull-request",
+                    "branch",
+                    "run-id",
+                    "jira-key",
+                    "github-issue",
+                    "enum",
+                    "repo-path"
+                  ]
+                },
+                "values": { "type": "array", "items": { "type": "string" } },
+                "required": { "type": "boolean" }
+              }
+            }
+          },
+          "writes": { "enum": ["none", "branch", "branch-pr", "pr-comments", "issue-comment"] }
+        }
+      }
+    }
+  }
+}

package/pipeline/schemas/office-memory.schema.json

@@ -0,0 +1,105 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/mmerterden/multi-agent-pipeline/pipeline/schemas/office-memory.schema.json",
+  "title": "Institutional memory",
+  "description": "What GET /v1/memory returns and `office-memory.mjs --json` prints: per repository, the code graph's age and size and how many learnings, past review findings and session notes the learning loop holds, with the newest learnings redacted and cut short. An empty shelf is reported, never left out.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["contractVersion", "generatedAt", "shelves"],
+  "properties": {
+    "contractVersion": {
+      "type": "string",
+      "pattern": "^1\\.[0-9]+\\.[0-9]+$",
+      "x-sensitivity": "none"
+    },
+    "generatedAt": {
+      "type": "string",
+      "format": "date-time",
+      "x-sensitivity": "none"
+    },
+    "shelves": {
+      "type": "array",
+      "maxItems": 60,
+      "x-sensitivity": "local",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "repo",
+          "graph",
+          "learnings",
+          "findings",
+          "sessionNotes",
+          "recent",
+          "lastWrite"
+        ],
+        "properties": {
+          "repo": {
+            "type": "string"
+          },
+          "graph": {
+            "oneOf": [
+              {
+                "type": "null"
+              },
+              {
+                "type": "object",
+                "additionalProperties": false,
+                "required": ["builtAt", "ageDays", "sizeKb"],
+                "properties": {
+                  "builtAt": {
+                    "type": ["string", "null"]
+                  },
+                  "ageDays": {
+                    "type": "integer",
+                    "minimum": 0
+                  },
+                  "sizeKb": {
+                    "type": "integer",
+                    "minimum": 0
+                  }
+                }
+              }
+            ]
+          },
+          "learnings": {
+            "type": "integer",
+            "minimum": 0
+          },
+          "findings": {
+            "type": "integer",
+            "minimum": 0
+          },
+          "sessionNotes": {
+            "type": "integer",
+            "minimum": 0
+          },
+          "recent": {
+            "type": "array",
+            "maxItems": 5,
+            "items": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["kind", "statement", "at"],
+              "properties": {
+                "kind": {
+                  "type": ["string", "null"]
+                },
+                "statement": {
+                  "type": "string",
+                  "maxLength": 120
+                },
+                "at": {
+                  "type": ["string", "null"]
+                }
+              }
+            }
+          },
+          "lastWrite": {
+            "type": ["string", "null"]
+          }
+        }
+      }
+    }
+  }
+}