@mmerterden/multi-agent-pipeline 20.2.1 → 20.3.1

package/pipeline/schemas/run-questions.json

@@ -0,0 +1,392 @@
+{
+  "contractVersion": "1.0.0",
+  "description": "The Phase 0 questions of a /multi-agent run, as data. A client can render them before launch and hand the answers over in a launch request (launch-request.schema.json); Phase 0 then pre-fills the matching pickers instead of asking. Order is the order Phase 0 reaches them. `source` names a command that enumerates the options as redacted JSON; null means no such command ships yet and `sourceNote` says what exists instead. Labels are English fallbacks - the pipeline renders its own pickers in outputLanguage. Shape: run-questions.schema.json.",
+  "questions": [
+    {
+      "id": "update",
+      "kind": "single-select",
+      "asked-at": "phase-0 step 0.6",
+      "answerable": true,
+      "options": [
+        {
+          "id": "update",
+          "label": "Update now"
+        },
+        {
+          "id": "continue",
+          "label": "Continue without updating"
+        }
+      ],
+      "default": "update",
+      "skippable-when": [
+        "no newer release is available",
+        "prefs.global.updateCheck.autoUpdate is true (the default), which updates without asking"
+      ],
+      "source": null
+    },
+    {
+      "id": "account",
+      "kind": "single-select",
+      "asked-at": "phase-0 account picker (_account-picker.md)",
+      "answerable": true,
+      "answer": {
+        "pattern": "^[A-Za-z0-9][A-Za-z0-9_.-]*$",
+        "description": "the account id",
+        "example": "work"
+      },
+      "skippable-when": [
+        "exactly one account is configured",
+        "free-text input whose repos are all local-only"
+      ],
+      "source": null,
+      "sourceNote": "lib/account-resolver.sh lists the accounts, but its JSON carries hosts and credential key names; a redacted enumerator is not shipped yet"
+    },
+    {
+      "id": "intent",
+      "kind": "single-select",
+      "asked-at": "phase-0 step 1 intent guard",
+      "answerable": true,
+      "options": [
+        {
+          "id": "answer-here",
+          "label": "Answer here"
+        },
+        {
+          "id": "treat-as-task",
+          "label": "Treat as a task"
+        }
+      ],
+      "default": "answer-here",
+      "skippable-when": [
+        "the input is not free text",
+        "the intent classifier reads the input as a task",
+        "prefs.global.intentGuard.enabled is false"
+      ],
+      "source": null
+    },
+    {
+      "id": "create-jira",
+      "kind": "single-select",
+      "asked-at": "phase-0 step 1 free-text",
+      "answerable": true,
+      "options": [
+        {
+          "id": "create",
+          "label": "Create"
+        },
+        {
+          "id": "skip",
+          "label": "Skip"
+        }
+      ],
+      "default": "skip",
+      "skippable-when": ["the input is not free text"],
+      "source": null
+    },
+    {
+      "id": "repo",
+      "kind": "single-select",
+      "asked-at": "phase-0 step 2",
+      "answerable": true,
+      "answer": {
+        "pattern": "^[A-Za-z0-9._-]+(/[A-Za-z0-9._-]+)?$",
+        "description": "a repo name as the picker lists it",
+        "example": "example-app"
+      },
+      "stateField": "project",
+      "skippable-when": ["the input names the repo (issue URL, repo#N)"],
+      "source": null,
+      "sourceNote": "lib/repo-cache.sh lists repos per provider and prints local paths for local ones; a redacted enumerator is not shipped yet"
+    },
+    {
+      "id": "issue",
+      "kind": "single-select",
+      "asked-at": "`jira` / `issue` input, the aggregate issue picker (commands/multi-agent/jira, commands/multi-agent/issue step 3)",
+      "answerable": true,
+      "answer": {
+        "pattern": "^([A-Z][A-Z0-9]*-[0-9]+|[A-Za-z0-9._-]+/[A-Za-z0-9._-]+#[0-9]+)$",
+        "description": "a Jira key or owner/repo#N, as issues.mjs prints it",
+        "example": "PROJ-123"
+      },
+      "skippable-when": ["the input names the item (Jira key, issue URL, repo#N)"],
+      "source": "scripts/issues.mjs --json --redact"
+    },
+    {
+      "id": "save-group",
+      "kind": "single-select",
+      "asked-at": "phase-0 step 2 multi-repo",
+      "answerable": true,
+      "options": [
+        {
+          "id": "save",
+          "label": "Save"
+        },
+        {
+          "id": "skip",
+          "label": "Skip"
+        }
+      ],
+      "default": "skip",
+      "skippable-when": [
+        "fewer than two repos are selected",
+        "the selection is already a saved group"
+      ],
+      "source": null
+    },
+    {
+      "id": "test-policy",
+      "kind": "single-select",
+      "asked-at": "phase-0 step 2 test policy",
+      "answerable": true,
+      "options": [
+        {
+          "id": "tdd",
+          "label": "TDD"
+        },
+        {
+          "id": "tests-after",
+          "label": "Tests after"
+        },
+        {
+          "id": "none",
+          "label": "No tests"
+        }
+      ],
+      "default": "tdd",
+      "skippable-when": ["prefs.projects[<slug>].testPolicy is recorded"],
+      "source": null
+    },
+    {
+      "id": "dev-context",
+      "kind": "multi-select",
+      "asked-at": "phase-0 step 2b (_dev-context.md)",
+      "answerable": true,
+      "answer": {
+        "pattern": "^[A-Za-z0-9._-]+(/[A-Za-z0-9._-]+)?$",
+        "description": "repo names; an empty list means the primary repo only",
+        "example": "example-lib"
+      },
+      "stateField": "siblings",
+      "source": null,
+      "sourceNote": "lib/submodule-detector.sh lists candidates, but its JSON carries remote URLs; a redacted enumerator is not shipped yet"
+    },
+    {
+      "id": "base-branch",
+      "kind": "single-select",
+      "asked-at": "phase-0 step 3",
+      "answerable": true,
+      "answer": {
+        "pattern": "^[A-Za-z0-9._/-]+$",
+        "description": "a branch name, with or without origin/",
+        "example": "origin/develop"
+      },
+      "stateField": "baseBranch",
+      "skippable-when": ["a branch was given with the input"],
+      "source": null,
+      "sourceNote": "the candidates are `git branch -r` filtered at Step 3; no standalone enumerator ships"
+    },
+    {
+      "id": "base-fetch-failure",
+      "kind": "single-select",
+      "asked-at": "phase-0 step 3 fetch-fail handling",
+      "answerable": true,
+      "options": [
+        {
+          "id": "retry",
+          "label": "Connect VPN and retry"
+        },
+        {
+          "id": "cached",
+          "label": "Use cached origin ref"
+        },
+        {
+          "id": "local-branch",
+          "label": "Use local branch as base"
+        },
+        {
+          "id": "abort",
+          "label": "Abort"
+        }
+      ],
+      "default": "retry",
+      "stateField": "baseFetchStatus",
+      "skippable-when": ["git fetch succeeds"],
+      "source": null
+    },
+    {
+      "id": "maturity",
+      "kind": "single-select",
+      "asked-at": "phase-0 maturity step (features/maturity-followup.md)",
+      "answerable": true,
+      "options": [
+        {
+          "id": "fix",
+          "label": "Open the item and fix it"
+        },
+        {
+          "id": "continue",
+          "label": "Continue without it"
+        },
+        {
+          "id": "abort",
+          "label": "Abort"
+        }
+      ],
+      "default": "fix",
+      "skippable-when": ["the maturity check reports no blockers"],
+      "source": null
+    },
+    {
+      "id": "maturity-warning",
+      "kind": "single-select",
+      "asked-at": "phase-0 maturity step, warnings only",
+      "answerable": true,
+      "options": [
+        {
+          "id": "continue",
+          "label": "Continue"
+        },
+        {
+          "id": "abort",
+          "label": "Abort"
+        }
+      ],
+      "default": "continue",
+      "skippable-when": ["the maturity check reports no warnings"],
+      "source": null
+    },
+    {
+      "id": "parent-description",
+      "kind": "single-select",
+      "asked-at": "phase-0 maturity step, empty description with a parent or sibling candidate",
+      "answerable": true,
+      "options": [
+        {
+          "id": "use-parent",
+          "label": "Use parent's description"
+        },
+        {
+          "id": "halt",
+          "label": "No, halt"
+        }
+      ],
+      "default": "use-parent",
+      "skippable-when": ["the item has its own description"],
+      "source": null
+    },
+    {
+      "id": "workspace",
+      "kind": "single-select",
+      "asked-at": "phase-0 step 5b",
+      "answerable": true,
+      "options": [
+        {
+          "id": "worktree",
+          "label": "Worktree"
+        },
+        {
+          "id": "local",
+          "label": "Local"
+        }
+      ],
+      "default": "worktree",
+      "stateField": "localMode",
+      "disabled-when": [
+        {
+          "mode": "autopilot",
+          "option": "local"
+        },
+        {
+          "workingTree": "dirty",
+          "option": "local"
+        }
+      ],
+      "source": null
+    },
+    {
+      "id": "identity",
+      "kind": "single-select",
+      "asked-at": "phase-0 step 6a",
+      "answerable": false,
+      "skippable-when": [
+        "a platformIdentityRouting rule matches",
+        "the project has a last identity",
+        "exactly one identity is configured"
+      ],
+      "source": null,
+      "sourceNote": "an identity carries a name and an email; no redacted enumerator ships, so a request cannot choose one"
+    },
+    {
+      "id": "task-type",
+      "kind": "single-select",
+      "asked-at": "phase-0 step 7 fallback",
+      "answerable": true,
+      "options": [
+        {
+          "id": "component",
+          "label": "Component"
+        },
+        {
+          "id": "bugfix",
+          "label": "Bugfix"
+        },
+        {
+          "id": "feature",
+          "label": "Feature"
+        },
+        {
+          "id": "refactor",
+          "label": "Refactor"
+        },
+        {
+          "id": "chore",
+          "label": "Chore"
+        }
+      ],
+      "default": "feature",
+      "stateField": "taskType",
+      "skippable-when": ["a Step 7 rule classifies the task"],
+      "source": null
+    },
+    {
+      "id": "test-depth",
+      "kind": "single-select",
+      "asked-at": "phase-0 step 7.7",
+      "answerable": true,
+      "options": [
+        {
+          "id": "unit",
+          "label": "Unit tests only"
+        },
+        {
+          "id": "unit+ui",
+          "label": "Unit + UI tests, recorded"
+        },
+        {
+          "id": "unit+mcp",
+          "label": "Unit + MCP flow recording"
+        }
+      ],
+      "default": "unit",
+      "stateField": "testDepth",
+      "skippable-when": [
+        "visualEvidence.enabled is false",
+        "only the unit option is open on this machine"
+      ],
+      "source": null,
+      "sourceNote": "which options are open is measured by probe-evidence-capability.sh at run time; a closed option in a request falls back to the question"
+    },
+    {
+      "id": "clarification",
+      "kind": "dynamic",
+      "asked-at": "phase-0 step 8",
+      "answerable": false,
+      "skippable-when": [
+        "prefs.global.clarifyAmbiguous.enabled is false (the default)",
+        "the clarifier scores the task clear enough"
+      ],
+      "source": null,
+      "sourceNote": "the questions are written by the task-clarifier agent for this task, so no request can know them in advance"
+    }
+  ]
+}

package/pipeline/schemas/run-questions.schema.json

@@ -0,0 +1,118 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/mmerterden/multi-agent-pipeline/pipeline/schemas/run-questions.schema.json",
+  "title": "Run questions",
+  "description": "Shape of run-questions.json: the Phase 0 pickers of a /multi-agent run as data. Every field is x-sensitivity none - the file ships with the package and describes questions, never a machine's answers.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["contractVersion", "questions"],
+  "properties": {
+    "contractVersion": {
+      "type": "string",
+      "pattern": "^1\\.[0-9]+\\.[0-9]+$",
+      "x-sensitivity": "none"
+    },
+    "description": { "type": "string", "x-sensitivity": "none" },
+    "questions": {
+      "type": "array",
+      "minItems": 1,
+      "x-sensitivity": "none",
+      "items": { "$ref": "#/$defs/question" }
+    }
+  },
+  "$defs": {
+    "question": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "kind", "asked-at", "answerable", "source"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9-]*$",
+          "x-sensitivity": "none",
+          "description": "The key a launch request answers under."
+        },
+        "kind": {
+          "enum": ["single-select", "multi-select", "dynamic"],
+          "x-sensitivity": "none",
+          "description": "dynamic: the questions themselves are produced during the run and cannot be answered in advance."
+        },
+        "asked-at": {
+          "type": "string",
+          "x-sensitivity": "none",
+          "description": "Where in phase-0-init.md (or the file it names) the picker lives."
+        },
+        "answerable": {
+          "type": "boolean",
+          "x-sensitivity": "none",
+          "description": "Whether a launch request may pre-fill it. false: the run always asks."
+        },
+        "options": {
+          "type": "array",
+          "minItems": 2,
+          "x-sensitivity": "none",
+          "description": "Static options. An answer is one option id. Absent when the options are enumerated at run time; then `answer` constrains the value.",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["id", "label"],
+            "properties": {
+              "id": { "type": "string", "minLength": 1 },
+              "label": { "type": "string", "minLength": 1 }
+            }
+          }
+        },
+        "answer": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["pattern"],
+          "x-sensitivity": "none",
+          "description": "For options enumerated at run time: every answered value must match `pattern`. Phase 0 still checks the value is one of the options it enumerated, and asks when it is not.",
+          "properties": {
+            "pattern": { "type": "string" },
+            "description": { "type": "string" },
+            "example": { "type": "string", "description": "A neutral value the pattern admits." }
+          }
+        },
+        "default": {
+          "type": "string",
+          "x-sensitivity": "none",
+          "description": "The option id the picker marks recommended."
+        },
+        "stateField": {
+          "type": "string",
+          "x-sensitivity": "none",
+          "description": "The agent-state.json field the answer ends up in."
+        },
+        "skippable-when": {
+          "type": "array",
+          "items": { "type": "string" },
+          "x-sensitivity": "none",
+          "description": "Conditions under which Phase 0 resolves the step without asking."
+        },
+        "disabled-when": {
+          "type": "array",
+          "x-sensitivity": "none",
+          "description": "An option that may not be chosen under a condition. A launch request choosing it is rejected, not downgraded.",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["option"],
+            "minProperties": 2,
+            "properties": {
+              "option": { "type": "string" },
+              "mode": { "enum": ["interactive", "autopilot"] },
+              "workingTree": { "enum": ["dirty"] }
+            }
+          }
+        },
+        "source": {
+          "type": ["string", "null"],
+          "x-sensitivity": "none",
+          "description": "A command that prints the options as redacted JSON. null when none ships."
+        },
+        "sourceNote": { "type": "string", "x-sensitivity": "none" }
+      }
+    }
+  }
+}