@mmerterden/multi-agent-pipeline 20.29.0 → 20.30.0

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

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

@@ -0,0 +1,82 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/mmerterden/multi-agent-pipeline/pipeline/schemas/stack-change.schema.json",
+  "title": "Stack change",
+  "description": "What POST /v1/stack returns (`stack-toggle.mjs set`). Step one: preview {stacks, changed, enabledPlugins, dropped} with confirmToken and expiresAt, nothing written. Step two: the written enabledPlugins, the keys that changed and written.",
+  "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": ["stacks", "changed", "enabledPlugins", "dropped"],
+      "properties": {
+        "stacks": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "changed": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "enabledPlugins": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "boolean"
+          }
+        },
+        "dropped": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "confirmToken": {
+      "type": "string",
+      "pattern": "^[A-Za-z0-9_-]{16,128}$"
+    },
+    "expiresAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "stacks": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "enabledPlugins": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "boolean"
+      }
+    },
+    "changed": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "dropped": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "written": {
+      "type": "boolean"
+    }
+  }
+}

package/pipeline/schemas/stack-request.schema.json

@@ -0,0 +1,33 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/mmerterden/multi-agent-pipeline/pipeline/schemas/stack-request.schema.json",
+  "title": "Stack change request",
+  "description": "The body of POST /v1/stack. The first request names repo (a name from GET /v1/repos or its path) and stacks (as /multi-agent:stack takes them, aliases allowed); the second sends only confirmToken.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["contractVersion"],
+  "properties": {
+    "contractVersion": {
+      "type": "string",
+      "pattern": "^1\\.[0-9]+\\.[0-9]+$",
+      "x-sensitivity": "none"
+    },
+    "repo": {
+      "type": "string",
+      "maxLength": 4096
+    },
+    "stacks": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 8,
+      "items": {
+        "type": "string",
+        "pattern": "^[a-z]{2,16}$"
+      }
+    },
+    "confirmToken": {
+      "type": "string",
+      "pattern": "^[A-Za-z0-9_-]{16,128}$"
+    }
+  }
+}

package/pipeline/schemas/stack.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/stack.schema.json",
+  "title": "Stack status",
+  "description": "What GET /v1/stack?repo= returns (`stack-toggle.mjs status --json`): the stacks a repository enables in .claude/settings.json and every marketplace plugin with its skills. manifestVerified is false when the marketplace manifest could not be read and the plugin list is the convention.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["contractVersion", "stacks", "knownStacks", "plugins", "manifestVerified"],
+  "properties": {
+    "contractVersion": {
+      "type": "string",
+      "pattern": "^1\\.[0-9]+\\.[0-9]+$",
+      "x-sensitivity": "none"
+    },
+    "stacks": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "knownStacks": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "plugins": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["name", "enabled", "alwaysOn", "stack", "skills"],
+        "properties": {
+          "name": {
+            "type": "string"
+          },
+          "enabled": {
+            "type": "boolean"
+          },
+          "alwaysOn": {
+            "type": "boolean"
+          },
+          "stack": {
+            "type": ["string", "null"]
+          },
+          "skills": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          }
+        }
+      }
+    },
+    "manifestVerified": {
+      "type": "boolean"
+    }
+  }
+}

package/pipeline/schemas/steer-request.schema.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/mmerterden/multi-agent-pipeline/pipeline/schemas/steer-request.schema.json",
+  "title": "Steer request",
+  "description": "The body of POST /v1/runs/{id}/steer. The first request carries text (verbatim, up to 4000 characters) and gets a preview and a confirm token bound to the run and that text; the second carries only confirmToken.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["contractVersion"],
+  "properties": {
+    "contractVersion": {
+      "type": "string",
+      "pattern": "^1\\.[0-9]+\\.[0-9]+$",
+      "x-sensitivity": "none"
+    },
+    "text": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 4000
+    },
+    "confirmToken": {
+      "type": "string",
+      "pattern": "^[A-Za-z0-9_-]{16,128}$"
+    }
+  }
+}

package/pipeline/schemas/steer.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/steer.schema.json",
+  "title": "Steer queued",
+  "description": "What POST /v1/runs/{id}/steer returns (`steer-run.mjs`). Step one: preview {text, status, currentPhase, replaces} with confirmToken and expiresAt, nothing written. Step two: the instruction is queued as the run's pendingSteer and applied at the entry to its next phase; replaced is the unconsumed instruction it replaced, or null.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["contractVersion", "taskId"],
+  "properties": {
+    "contractVersion": {
+      "type": "string",
+      "pattern": "^1\\.[0-9]+\\.[0-9]+$",
+      "x-sensitivity": "none"
+    },
+    "taskId": {
+      "type": "string"
+    },
+    "queuedAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "replaced": {
+      "type": ["string", "null"]
+    },
+    "status": {
+      "type": ["string", "null"]
+    },
+    "currentPhase": {
+      "type": ["integer", "null"]
+    },
+    "preview": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["text", "status", "currentPhase", "replaces"],
+      "properties": {
+        "text": {
+          "type": "string"
+        },
+        "status": {
+          "type": ["string", "null"]
+        },
+        "currentPhase": {
+          "type": ["integer", "null"]
+        },
+        "replaces": {
+          "type": ["string", "null"]
+        }
+      }
+    },
+    "confirmToken": {
+      "type": "string",
+      "pattern": "^[A-Za-z0-9_-]{16,128}$"
+    },
+    "expiresAt": {
+      "type": "string",
+      "format": "date-time"
+    }
+  }
+}