@mmerterden/multi-agent-pipeline 20.29.0 → 20.33.0

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

package/pipeline/schemas/office-settings-request.schema.json

@@ -0,0 +1,30 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/mmerterden/multi-agent-pipeline/pipeline/schemas/office-settings-request.schema.json",
+  "title": "Office settings request",
+  "description": "The body of POST /v1/settings. Step 1 names the setting and its new value; 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"
+    },
+    "setting": {
+      "enum": ["language", "model", "route"],
+      "x-sensitivity": "none"
+    },
+    "value": {
+      "enum": ["en", "tr", "on", "off"],
+      "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/office-settings.schema.json

@@ -0,0 +1,67 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/mmerterden/multi-agent-pipeline/pipeline/schemas/office-settings.schema.json",
+  "title": "Office settings",
+  "description": "What GET /v1/settings returns and POST /v1/settings returns after a change: the output language, the fable rung and model routing. A preview (the first POST) adds the change it would make and a confirmToken.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["contractVersion", "language", "model", "route"],
+  "properties": {
+    "contractVersion": {
+      "type": "string",
+      "pattern": "^1\\.[0-9]+\\.[0-9]+$",
+      "x-sensitivity": "none"
+    },
+    "language": {
+      "enum": ["en", "tr"],
+      "x-sensitivity": "none"
+    },
+    "model": {
+      "enum": ["on", "off"],
+      "x-sensitivity": "none",
+      "description": "Whether the fable rung is in play."
+    },
+    "route": {
+      "enum": ["on", "off"],
+      "x-sensitivity": "none",
+      "description": "Whether model routing is on."
+    },
+    "change": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["setting", "from", "to"],
+      "x-sensitivity": "none",
+      "properties": {
+        "setting": {
+          "enum": ["language", "model", "route"]
+        },
+        "from": {
+          "type": "string"
+        },
+        "to": {
+          "type": "string"
+        },
+        "freeChain": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["enabled", "allowTraining"],
+          "description": "Present when turning routing on brings back a saved free provider chain: the confirmation names it.",
+          "properties": {
+            "enabled": { "const": true },
+            "allowTraining": { "type": "boolean" }
+          }
+        }
+      }
+    },
+    "confirmToken": {
+      "type": "string",
+      "pattern": "^[A-Za-z0-9_-]{16,128}$",
+      "x-sensitivity": "none"
+    },
+    "expiresAt": {
+      "type": "string",
+      "format": "date-time",
+      "x-sensitivity": "none"
+    }
+  }
+}

package/pipeline/schemas/permissions.schema.json

@@ -0,0 +1,47 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/mmerterden/multi-agent-pipeline/pipeline/schemas/permissions.schema.json",
+  "title": "Pending permission prompts",
+  "description": "What GET /v1/permissions returns: the host permission prompts waiting on the user. available is false while the host records none where another process can read them; requests is then empty and reason says so. When available, each request names its session, the tool and a redacted summary.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["contractVersion", "available", "reason", "requests"],
+  "properties": {
+    "contractVersion": {
+      "type": "string",
+      "pattern": "^1\\.[0-9]+\\.[0-9]+$",
+      "x-sensitivity": "none"
+    },
+    "available": {
+      "type": "boolean"
+    },
+    "reason": {
+      "type": ["string", "null"]
+    },
+    "requests": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "sessionId", "tool", "summary", "at"],
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "sessionId": {
+            "type": "string"
+          },
+          "tool": {
+            "type": "string"
+          },
+          "summary": {
+            "type": "string"
+          },
+          "at": {
+            "type": "string"
+          }
+        }
+      }
+    }
+  }
+}

package/pipeline/schemas/phases.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://github.com/mmerterden/multi-agent-pipeline/pipeline/schemas/phases.json",
-  "description": "The phase contract, in one place: the phase ids and names, which phases each mode runs, the per-phase token ceilings and the phase numbers other code compares against. gen-mode-dispatch.mjs, render-work-summary.sh, the autopilot runner, runs-index.mjs, usage-report.mjs and gen-facts.mjs read it; smoke-phase-contract.sh holds every copy that cannot read it (the phase docs and prose counts, agent-state.schema.json, token-budget.json, phase-tracker.sh, phase-banner.sh, gc-abandoned.sh) to it. Adding or merging a phase means editing here. A mode with `commits: false` delivers no commit in its Phase 4 (analysis publishes a document), so lib/run-completion.mjs asks it for no commit evidence before `status: complete`; any other mode commits. Ceilings are measured against the current phase documents, never summed from earlier ones: smoke-token-budget.sh fails a ceiling more than 25% above the measurement.",
+  "description": "The phase contract, in one place: the phase ids and names, which phases each mode runs, the per-phase token ceilings and the phase numbers other code compares against. gen-mode-dispatch.mjs, render-work-summary.sh, the autopilot runner, runs-index.mjs, usage-report.mjs and gen-facts.mjs read it; smoke-phase-contract.sh holds every copy that cannot read it (the phase docs and prose counts, agent-state.schema.json, token-budget.json, phase-tracker.sh, phase-banner.sh, gc-abandoned.sh) to it. Adding or merging a phase means editing here. A mode with `names` runs the same six slots under its own step names (analysis gathers evidence and synthesises where development plans and builds), and its tracker and task widget show those names. A mode with `commits: false` delivers no commit in its Phase 4 (analysis publishes a document), so lib/run-completion.mjs asks it for no commit evidence before `status: complete`; any other mode commits. Ceilings are measured against the current phase documents, never summed from earlier ones: smoke-token-budget.sh fails a ceiling more than 25% above the measurement.",
   "contractVersion": "2.0.0",
   "phaseSchema": 2,
   "phaseSchemaNote": "The phase vocabulary generation. metrics.jsonl is append-only and v19.0.0 renumbered the phases, so every line written from v19.0.0 on carries this number and a line without the field is generation 1. Aggregators pick their name table from it; without it phase 3 means Dev in old rows and Review in new ones and no reader can tell them apart.",
@@ -71,7 +71,15 @@
       "autopilot": true
     },
     "analysis": {
-      "phases": [0, 1, 3, 4, 5],
+      "phases": [0, 1, 2, 3, 4, 5],
+      "names": {
+        "0": "Intake",
+        "1": "Evidence",
+        "2": "Synthesis",
+        "3": "Review",
+        "4": "Publish",
+        "5": "Report"
+      },
       "autopilot": false,
       "commits": false
     }