@mmerterden/multi-agent-pipeline 14.2.2 → 15.1.0

package/pipeline/schemas/complaint-analysis-spec.schema.json

@@ -0,0 +1,216 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/{owner}/multi-agent-pipeline/pipeline/schemas/complaint-analysis-spec.schema.json",
+  "version": "1.0.0",
+  "title": "Multi-Agent Pipeline - /multi-agent:complaint-analysis run state",
+  "description": "Contract for state.complaintSpec, the run state of the customer-complaint triage command. Complaints arrive redacted (parse-complaints.sh strips PII before anything lands here), each one carries its Graylog evidence status, repo evidence rows, and a triage verdict: client / bff (our responsibility, root-cause analysis) or core (routing recommendation only) or insufficient-evidence.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["runName", "language", "repos", "complaints"],
+  "properties": {
+    "runName": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Run name supplied by the user or defaulted to complaints-<YYYYMMDD>."
+    },
+    "phase": {
+      "type": "string",
+      "enum": [
+        "intake",
+        "fetching_graylog",
+        "correlating_repos",
+        "triaging",
+        "drafting",
+        "awaiting_output_decision",
+        "dispatching",
+        "reporting",
+        "done"
+      ],
+      "description": "Resume marker. Set after each phase boundary."
+    },
+    "language": {
+      "type": "string",
+      "enum": ["tr", "en"],
+      "description": "Report body language, resolved from prefs.global.outputLanguage."
+    },
+    "account": {
+      "type": ["string", "null"],
+      "description": "Account id resolved by the account picker; null for local-only flows."
+    },
+    "repos": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["name", "layer"],
+        "properties": {
+          "name": { "type": "string", "minLength": 1 },
+          "layer": {
+            "type": "string",
+            "enum": ["ios", "android", "web", "mobile-bff", "web-bff", "other"],
+            "description": "User-confirmed layer tag (Phase 0 Step 3b). core is NOT a layer here - it is the residual verdict, not a repo."
+          },
+          "localPath": { "type": ["string", "null"] },
+          "provider": { "type": ["string", "null"] }
+        }
+      },
+      "description": "Repos selected in the multi-select picker, each tagged with the layer it implements."
+    },
+    "input": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["sources", "complaintCount", "redacted"],
+      "properties": {
+        "sources": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["type"],
+            "properties": {
+              "type": { "type": "string", "enum": ["file", "paste", "jira", "confluence"] },
+              "ref": {
+                "type": ["string", "null"],
+                "description": "File path, Jira issue key, or Confluence URL. null for paste."
+              },
+              "format": {
+                "type": ["string", "null"],
+                "enum": ["csv", "xlsx", "txt", "json", "text", null]
+              }
+            }
+          }
+        },
+        "complaintCount": { "type": "integer", "minimum": 0 },
+        "redacted": {
+          "type": "boolean",
+          "description": "Must be true for any run that dispatches output; only --no-redact debug runs of parse-complaints.sh produce false."
+        }
+      }
+    },
+    "complaints": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "textRedacted"],
+        "properties": {
+          "id": { "type": "string", "pattern": "^C-[0-9]{2,}$" },
+          "textRedacted": { "type": "string", "minLength": 1 },
+          "trxId": { "type": ["string", "null"] },
+          "convId": { "type": ["string", "null"] },
+          "date": { "type": ["string", "null"] },
+          "platformHint": { "type": ["string", "null"] },
+          "skipGraylog": {
+            "type": "boolean",
+            "default": false,
+            "description": "True when the user explicitly marked the complaint skip-graylog at the Phase 0 Step 5 id-confirmation loop."
+          },
+          "graylog": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["status"],
+            "properties": {
+              "status": { "type": "string", "enum": ["pending", "ok", "degraded", "skipped"] },
+              "totalResults": { "type": "integer", "minimum": 0 },
+              "degradeReason": { "type": ["string", "null"] }
+            }
+          },
+          "repoEvidence": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["repo", "layer", "file", "signal", "matchKind"],
+              "properties": {
+                "repo": { "type": "string" },
+                "layer": {
+                  "type": "string",
+                  "enum": ["ios", "android", "web", "mobile-bff", "web-bff", "other"]
+                },
+                "file": { "type": "string" },
+                "line": { "type": ["integer", "null"] },
+                "signal": {
+                  "type": "string",
+                  "description": "The Graylog-derived signal that matched: endpoint path, error code, exception name, message template, or source service name."
+                },
+                "matchKind": { "type": "string", "enum": ["direct", "partial"] }
+              }
+            }
+          },
+          "verdict": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["category", "confidence", "rationale"],
+            "properties": {
+              "category": {
+                "type": "string",
+                "enum": ["client", "bff", "core", "insufficient-evidence"]
+              },
+              "layer": {
+                "type": ["string", "null"],
+                "enum": ["ios", "android", "web", "mobile-bff", "web-bff", null],
+                "description": "Set for client/bff verdicts; null for core and insufficient-evidence."
+              },
+              "confidence": { "type": "string", "enum": ["high", "medium", "low"] },
+              "rationale": { "type": "string", "minLength": 1 }
+            }
+          },
+          "handoff": {
+            "type": ["object", "null"],
+            "additionalProperties": false,
+            "description": "Present only for client/bff verdicts: development handoff grounded in the existing architecture (repoEvidence files as reference).",
+            "properties": {
+              "fixPlan": {
+                "type": "array",
+                "items": { "type": "string" },
+                "description": "2-5 numbered steps, each referencing a cited file:line or component, reuse-first."
+              },
+              "devPrompt": {
+                "type": ["string", "null"],
+                "description": "English prompt block ready for /multi-agent:dev or a Jira description; includes the [C-NN] id."
+              }
+            }
+          },
+          "routing": {
+            "type": ["object", "null"],
+            "additionalProperties": false,
+            "description": "Present only for core verdicts: the routing recommendation to the backend core team. Never contains fix analysis.",
+            "properties": {
+              "suspectedService": {
+                "type": ["string", "null"],
+                "description": "Graylog message source field of the failing upstream service."
+              },
+              "endpoint": { "type": ["string", "null"] },
+              "errorCode": { "type": ["string", "null"] },
+              "evidenceExcerpt": {
+                "type": ["string", "null"],
+                "description": "Short redacted English excerpt from the Graylog message."
+              },
+              "suggestedQueue": {
+                "type": ["string", "null"],
+                "description": "Optional team/queue label from prefs.projects[*].routing.coreTeamLabel; null when unset."
+              },
+              "confidence": { "type": ["string", "null"], "enum": ["high", "medium", "low", null] }
+            }
+          }
+        }
+      }
+    },
+    "outputs": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "draftDir": { "type": ["string", "null"] },
+        "files": { "type": "array", "items": { "type": "string" } },
+        "destinations": {
+          "type": "array",
+          "items": { "type": "string", "enum": ["local", "confluence", "jira"] }
+        },
+        "confluencePageUrl": { "type": ["string", "null"] },
+        "jiraIssueKey": { "type": ["string", "null"] }
+      }
+    }
+  }
+}

package/pipeline/schemas/migrations/prefs-2.5.0-to-2.6.0.mjs

@@ -0,0 +1,46 @@
+/**
+ * prefs-2.5.0-to-2.6.0.mjs  -  preference schema upgrade 2.5.0 -> 2.6.0
+ *
+ * v15.0.0 renamed the pipeline-tail command a second time: /multi-agent:finish
+ * (pre-2.5.0) became :ship (2.5.0) and is now :resume-local, because the command
+ * continues locally-done work through review/commit/report - it opens the PR but
+ * merges nothing, so "ship" oversold it. One preference key follows:
+ *
+ *   - global.resumeLocal.autoFix  (default FALSE)
+ *       Carried across from global.ship.autoFix (itself carried from
+ *       global.finish.autoFix): a user who opted into auto-fix did so
+ *       deliberately, so the value survives every hop of the rename chain.
+ *
+ * Idempotent: safe on already-2.6.0 input. Non-destructive: an existing explicit
+ * value is preserved; the legacy `ship`/`finish` blocks are removed because they
+ * are no longer declared properties and would fail a closed `global`.
+ *
+ * @param {object} data  -  parsed JSON content of the preferences file
+ * @returns {object}     -  same data with schemaVersion = "2.6.0"
+ */
+export default function migrate(data) {
+  const out = JSON.parse(JSON.stringify(data));
+
+  out.schemaVersion = "2.6.0";
+
+  if (!out.global) out.global = {};
+
+  if (typeof out.global.resumeLocal !== "object" || out.global.resumeLocal === null) {
+    out.global.resumeLocal = {};
+  }
+  if (typeof out.global.resumeLocal.autoFix !== "boolean") {
+    const legacy =
+      typeof out.global.ship?.autoFix === "boolean"
+        ? out.global.ship.autoFix
+        : out.global.finish?.autoFix;
+    out.global.resumeLocal.autoFix = typeof legacy === "boolean" ? legacy : false;
+  }
+  for (const key of ["ship", "finish"]) {
+    if (out.global[key] && typeof out.global[key] === "object") {
+      delete out.global[key].autoFix;
+      if (Object.keys(out.global[key]).length === 0) delete out.global[key];
+    }
+  }
+
+  return out;
+}