@mmerterden/multi-agent-pipeline 20.30.0 → 20.33.0

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/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
     }

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/prs.schema.json

@@ -22,6 +22,11 @@
           "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"
           },

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