session-orchestrator 3.16.0

package/agents/schemas/analyst.schema.json

@@ -0,0 +1,46 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://session-orchestrator.dev/agents/analyst.schema.json",
+  "title": "analyst agent output",
+  "description": "Machine-readable summary returned by the analyst agent after a PRD-quality review. Mirrors the Output Format section of agents/analyst.md.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["verdict", "report_path", "finding_counts", "scope_drift_count", "criteria_reviewed"],
+  "properties": {
+    "verdict": {
+      "type": "string",
+      "enum": ["PROCEED", "PROCEED_WITH_FOLLOWUPS", "FIX_REQUIRED", "BLOCKED"],
+      "description": "Overall disposition: PROCEED = no blockers; PROCEED_WITH_FOLLOWUPS = minor items noted; FIX_REQUIRED = HIGH findings that must be addressed before wave execution; BLOCKED = cannot complete review."
+    },
+    "report_path": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Relative path to the human-readable audit file written to .orchestrator/audits/."
+    },
+    "finding_counts": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["high", "med", "low"],
+      "properties": {
+        "high": { "type": "integer", "minimum": 0 },
+        "med": { "type": "integer", "minimum": 0 },
+        "low": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "scope_drift_count": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Number of scope-drift items detected (brainstorm items missing from plan, or plan items with no brainstorm trace)."
+    },
+    "criteria_reviewed": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Total acceptance criteria examined."
+    },
+    "blockers": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Free-text blocker descriptions; empty array when verdict is not BLOCKED."
+    }
+  }
+}

package/agents/schemas/architect-reviewer.schema.json

@@ -0,0 +1,50 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://session-orchestrator.dev/agents/architect-reviewer.schema.json",
+  "title": "architect-reviewer agent output",
+  "description": "Machine-readable summary returned by the architect-reviewer agent after an inter-wave design audit. Mirrors the Output Format section of agents/architect-reviewer.md.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["verdict", "report_path", "finding_counts", "files_reviewed"],
+  "properties": {
+    "verdict": {
+      "type": "string",
+      "enum": ["PROCEED", "PROCEED_WITH_FOLLOWUPS", "FIX_REQUIRED", "BLOCKED"],
+      "description": "Overall disposition: PROCEED = no structural blockers; PROCEED_WITH_FOLLOWUPS = LOW/MEDIUM findings only; FIX_REQUIRED = HIGH finding that would compound across waves; BLOCKED = cannot complete review."
+    },
+    "report_path": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Relative path to the human-readable audit file written to .orchestrator/audits/."
+    },
+    "finding_counts": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["high", "med", "low"],
+      "properties": {
+        "high": { "type": "integer", "minimum": 0 },
+        "med": { "type": "integer", "minimum": 0 },
+        "low": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "files_reviewed": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Number of source files examined during the audit."
+    },
+    "adrs_checked": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Number of ADR files read during Phase 1 context research."
+    },
+    "language_md_checked": {
+      "type": "boolean",
+      "description": "Whether a LANGUAGE.md file was found and checked for vocabulary drift."
+    },
+    "blockers": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Free-text blocker descriptions; empty array when verdict is not BLOCKED."
+    }
+  }
+}

package/agents/schemas/code-implementer.schema.json

@@ -0,0 +1,61 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://session-orchestrator.dev/agents/code-implementer.schema.json",
+  "title": "code-implementer agent output",
+  "description": "Structured summary returned by the code-implementer agent after a task. Mirrors the Output Format section of agents/code-implementer.md.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["status", "task_id", "files_changed", "blockers"],
+  "properties": {
+    "status": {
+      "type": "string",
+      "enum": ["done", "partial", "blocked"],
+      "deprecated": true,
+      "description": "DEPRECATED (#472): emit `verdict` instead. Removed in v4.0. Mapping: done→PROCEED, partial→PROCEED_WITH_FOLLOWUPS, blocked→BLOCKED."
+    },
+    "verdict": {
+      "type": "string",
+      "enum": ["PROCEED", "PROCEED_WITH_FOLLOWUPS", "FIX_REQUIRED", "BLOCKED"],
+      "description": "Overall disposition (implementer mapping): PROCEED = task completed (status=done); PROCEED_WITH_FOLLOWUPS = partial completion (status=partial) with explicit blockers; FIX_REQUIRED = reserved for reviewers, not emitted by implementers; BLOCKED = could not proceed (status=blocked)."
+    },
+    "task_id": {
+      "type": "string",
+      "minLength": 1
+    },
+    "files_changed": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["path"],
+        "properties": {
+          "path": { "type": "string", "minLength": 1 },
+          "description": { "type": "string" }
+        }
+      }
+    },
+    "approach": {
+      "type": "string",
+      "description": "1-3 sentence narrative on WHY, not diff narration."
+    },
+    "verification": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "typecheck": {
+          "type": "string",
+          "description": "e.g. 'pass' or 'N errors'"
+        },
+        "pattern_alignment": {
+          "type": "string",
+          "description": "Existing-file pattern matched (e.g. 'matched src/lib/errors.ts')"
+        }
+      }
+    },
+    "blockers": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Free-text blocker descriptions; empty array when status=done."
+    }
+  }
+}

package/agents/schemas/db-specialist.schema.json

@@ -0,0 +1,80 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://session-orchestrator.dev/agents/db-specialist.schema.json",
+  "title": "db-specialist agent output",
+  "description": "Structured summary returned by the db-specialist agent after a schema/migration task. Mirrors the Output Format section of agents/db-specialist.md.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["status", "task_id", "files_changed", "blockers"],
+  "properties": {
+    "status": {
+      "type": "string",
+      "enum": ["done", "partial", "blocked"],
+      "deprecated": true,
+      "description": "DEPRECATED (#472): emit `verdict` instead. Removed in v4.0. Mapping: done→PROCEED, partial→PROCEED_WITH_FOLLOWUPS, blocked→BLOCKED."
+    },
+    "verdict": {
+      "type": "string",
+      "enum": ["PROCEED", "PROCEED_WITH_FOLLOWUPS", "FIX_REQUIRED", "BLOCKED"],
+      "description": "Overall disposition (implementer mapping): PROCEED = task completed (status=done); PROCEED_WITH_FOLLOWUPS = partial completion (status=partial) with explicit blockers; FIX_REQUIRED = reserved for reviewers, not emitted by implementers; BLOCKED = could not proceed (status=blocked)."
+    },
+    "task_id": {
+      "type": "string",
+      "minLength": 1
+    },
+    "files_changed": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Migration files and schema files modified."
+    },
+    "schema_delta": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "added": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Tables/columns/indexes/constraints added."
+        },
+        "modified": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Modifications with reversibility plan."
+        }
+      }
+    },
+    "indexes_added": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["target"],
+        "properties": {
+          "target": {
+            "type": "string",
+            "description": "table.column or table(col1, col2) form"
+          },
+          "rationale": { "type": "string" }
+        }
+      }
+    },
+    "verification": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "dry_run": {
+          "type": "string",
+          "description": "Migrator dry-run result: 'pass' or DDL output."
+        },
+        "fk_indexes": {
+          "type": "string",
+          "description": "e.g. 'all 4 covered'"
+        }
+      }
+    },
+    "blockers": {
+      "type": "array",
+      "items": { "type": "string" }
+    }
+  }
+}

package/agents/schemas/docs-writer.schema.json

@@ -0,0 +1,56 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://session-orchestrator.dev/agents/docs-writer.schema.json",
+  "title": "docs-writer agent output",
+  "description": "Machine-readable summary returned by the docs-writer agent after updating documentation. Derives from the Output Format section of agents/docs-writer.md.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["verdict", "status", "files_updated"],
+  "properties": {
+    "verdict": {
+      "type": "string",
+      "enum": ["PROCEED", "PROCEED_WITH_FOLLOWUPS", "FIX_REQUIRED", "BLOCKED"],
+      "description": "PROCEED = all targeted docs written with verified sources; PROCEED_WITH_FOLLOWUPS = REVIEW markers added but content complete; FIX_REQUIRED = required docs could not be written; BLOCKED = task could not proceed (no git diff, no session memory)."
+    },
+    "status": {
+      "type": "string",
+      "enum": ["done", "partial", "blocked"],
+      "description": "done = all targeted sections written; partial = REVIEW-marked sections present; blocked = could not source content."
+    },
+    "files_updated": {
+      "type": "array",
+      "description": "Documentation files written or modified.",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["path"],
+        "properties": {
+          "path": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Relative path to the documentation file."
+          },
+          "audience": {
+            "type": "string",
+            "enum": ["user", "dev", "vault"],
+            "description": "Target audience for this file."
+          },
+          "sections": {
+            "type": "array",
+            "items": { "type": "string" },
+            "description": "Section names or line ranges updated."
+          }
+        }
+      }
+    },
+    "review_markers_added": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Number of <!-- REVIEW: source needed --> markers added due to unsourced claims."
+    },
+    "notes": {
+      "type": "string",
+      "description": "Scope boundaries hit, audiences not addressed, or anything the next wave should know."
+    }
+  }
+}

package/agents/schemas/persona-panel-sidecar.schema.json

@@ -0,0 +1,245 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "persona-panel-sidecar",
+  "title": "persona-panel sidecar",
+  "description": "Sidecar JSON written by the persona-panel skill (issue #457 AC6). Captures invoked personas, per-persona structured outputs, and the consolidation/voting result. No $ref or $defs — single-instance AJV-loader pattern per CLAUDE.md.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "run_id",
+    "iso_timestamp",
+    "target",
+    "personas_invoked",
+    "outputs",
+    "consolidation"
+  ],
+  "properties": {
+    "schema_version": {
+      "type": "integer",
+      "const": 1,
+      "description": "Sidecar schema version. Bump only on breaking changes; additive evolution stays at 1."
+    },
+    "run_id": {
+      "type": "string",
+      "pattern": "^[a-z0-9-]{1,64}$",
+      "description": "Stable run identifier (lowercase alnum + hyphens), max 64 chars."
+    },
+    "iso_timestamp": {
+      "type": "string",
+      "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}-\\d{2}-\\d{2}(\\.\\d+)?Z?$",
+      "description": "Filename-safe timestamp: standard ISO 8601 with colons in the time component replaced by hyphens (e.g. 2026-05-19T08-22-49Z, NOT 2026-05-19T08:22:49Z). Do not Date.parse() directly — the colons-to-hyphens substitution makes it unparseable as standard ISO 8601. See W4 architect MED-2."
+    },
+    "target": {
+      "type": "string",
+      "maxLength": 4096,
+      "description": "What was reviewed — file path, PRD ID, MR URL, etc."
+    },
+    "mode": {
+      "type": "string",
+      "enum": ["voting-quorum", "hard-gate-threshold", "coordinator-summary"],
+      "description": "Consolidation strategy requested by the caller. Optional — defaults to whatever the skill chose."
+    },
+    "personas_invoked": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 20,
+      "description": "Roster of personas the panel actually dispatched, with cost/timing metadata.",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "name",
+          "version",
+          "model",
+          "prompt_hash",
+          "timestamp_start",
+          "timestamp_end"
+        ],
+        "properties": {
+          "name": {
+            "type": "string",
+            "pattern": "^[a-z0-9-]{1,64}$"
+          },
+          "version": {
+            "type": "string",
+            "minLength": 1
+          },
+          "model": {
+            "type": "string",
+            "maxLength": 128
+          },
+          "prompt_hash": {
+            "type": "string",
+            "pattern": "^[a-f0-9]{16}$",
+            "description": "First 16 hex chars of the SHA-256 of the persona prompt. Detects silent prompt drift."
+          },
+          "timestamp_start": {
+            "type": "string"
+          },
+          "timestamp_end": {
+            "type": "string"
+          },
+          "token_usage": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+              "input": { "type": "integer", "minimum": 0 },
+              "output": { "type": "integer", "minimum": 0 },
+              "cache_read": { "type": "integer", "minimum": 0 },
+              "cache_creation": { "type": "integer", "minimum": 0 }
+            }
+          }
+        }
+      }
+    },
+    "outputs": {
+      "type": "array",
+      "minItems": 1,
+      "description": "Per-persona structured verdicts. One entry per item in personas_invoked.",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["persona_name", "mode", "ok"],
+        "properties": {
+          "persona_name": {
+            "type": "string",
+            "pattern": "^[a-z0-9-]{1,64}$"
+          },
+          "mode": {
+            "type": "string",
+            "enum": [
+              "validated",
+              "parse-error",
+              "compile-error",
+              "validation-failed",
+              "dispatch-error",
+              "timeout"
+            ],
+            "description": "Outcome mode — `validated` means the persona returned schema-conforming output; the rest are failure discriminators."
+          },
+          "ok": {
+            "type": "boolean"
+          },
+          "verdict": {
+            "type": "string",
+            "enum": ["pass", "fail", "warn"]
+          },
+          "rationale": {
+            "type": "string",
+            "maxLength": 4096
+          },
+          "recommendations": {
+            "type": "array",
+            "maxItems": 50,
+            "items": {
+              "type": "string",
+              "maxLength": 1024
+            }
+          },
+          "errors": {
+            "type": "array",
+            "items": {
+              "type": "object"
+            }
+          },
+          "derived_sources": {
+            "type": "array",
+            "maxItems": 50,
+            "description": "Grounding-review v1 (#730 Epic H): sources this persona independently re-derived via Read/Grep/Glob when dispatched with groundingMode='re-derive', instead of trusting a source list already present in the target. Optional — absent when groundingMode='off' (default).",
+            "items": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["path"],
+              "properties": {
+                "path": {
+                  "type": "string",
+                  "maxLength": 4096
+                },
+                "supports_claim": {
+                  "type": "string",
+                  "maxLength": 1024
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "consolidation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["mode_used", "final_verdict"],
+      "description": "Aggregated panel decision.",
+      "properties": {
+        "mode_used": {
+          "type": "string",
+          "maxLength": 64
+        },
+        "final_verdict": {
+          "type": "string",
+          "enum": ["PROCEED", "PROCEED_WITH_FOLLOWUPS", "BLOCKED", "REQUIRES_COORDINATOR"]
+        },
+        "votes": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "pass": { "type": "integer", "minimum": 0 },
+            "fail": { "type": "integer", "minimum": 0 },
+            "warn": { "type": "integer", "minimum": 0 },
+            "error": { "type": "integer", "minimum": 0 },
+            "total": { "type": "integer", "minimum": 0 }
+          }
+        },
+        "threshold": {
+          "type": "string",
+          "maxLength": 64
+        },
+        "threshold_met": {
+          "type": "boolean"
+        },
+        "dissenting_personas": {
+          "type": "array",
+          "maxItems": 20,
+          "items": { "type": "string" }
+        },
+        "tie_break_applied": {
+          "type": "boolean"
+        },
+        "aggregator_warning": {
+          "type": "string",
+          "maxLength": 512
+        },
+        "notes": {
+          "type": "array",
+          "maxItems": 20,
+          "items": {
+            "type": "string",
+            "maxLength": 512
+          }
+        },
+        "grounding_diff": {
+          "type": "object",
+          "additionalProperties": false,
+          "description": "Grounding-review v1 (#730 Epic H): advisory diff between the target's claimed sources and what personas independently re-derived. Shape of scripts/lib/persona-panel/consolidator.mjs::diffGroundingSources() return value. Signal only — never influences final_verdict.",
+          "properties": {
+            "unconfirmed_author_sources": {
+              "type": "array",
+              "maxItems": 100,
+              "items": { "type": "string", "maxLength": 4096 }
+            },
+            "newly_derived": {
+              "type": "array",
+              "maxItems": 100,
+              "items": { "type": "string", "maxLength": 4096 }
+            },
+            "personas_reporting": {
+              "type": "integer",
+              "minimum": 0
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/agents/schemas/qa-strategist.schema.json

@@ -0,0 +1,46 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://session-orchestrator.dev/agents/qa-strategist.schema.json",
+  "title": "qa-strategist agent output",
+  "description": "Machine-readable summary returned by the qa-strategist agent after a test-coverage gap analysis. Mirrors the Output Format section of agents/qa-strategist.md.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["verdict", "report_path", "gap_counts", "source_files_reviewed", "test_files_reviewed"],
+  "properties": {
+    "verdict": {
+      "type": "string",
+      "enum": ["PROCEED", "PROCEED_WITH_FOLLOWUPS", "FIX_REQUIRED", "BLOCKED"],
+      "description": "Overall disposition: PROCEED = adequate coverage; PROCEED_WITH_FOLLOWUPS = LOW/MEDIUM gaps only; FIX_REQUIRED = HIGH coverage gap that risks production silent failure; BLOCKED = cannot complete analysis."
+    },
+    "report_path": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Relative path to the human-readable gap report written to .orchestrator/audits/."
+    },
+    "gap_counts": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["high", "med", "low"],
+      "properties": {
+        "high": { "type": "integer", "minimum": 0 },
+        "med": { "type": "integer", "minimum": 0 },
+        "low": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "source_files_reviewed": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Number of source files examined."
+    },
+    "test_files_reviewed": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Number of test files examined."
+    },
+    "blockers": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Free-text blocker descriptions; empty array when verdict is not BLOCKED."
+    }
+  }
+}

package/agents/schemas/security-reviewer.schema.json

@@ -0,0 +1,86 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://session-orchestrator.dev/agents/security-reviewer.schema.json",
+  "title": "security-reviewer agent output",
+  "description": "Machine-readable summary returned by the security-reviewer agent after a vulnerability assessment. Mirrors the Required Output Format section of agents/security-reviewer.md.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["verdict", "finding_counts", "files_reviewed", "phases"],
+  "properties": {
+    "verdict": {
+      "type": "string",
+      "enum": ["PROCEED", "PROCEED_WITH_FOLLOWUPS", "FIX_REQUIRED", "BLOCKED"],
+      "description": "Overall disposition: PROCEED = no HIGH/MEDIUM findings; PROCEED_WITH_FOLLOWUPS = LOW findings only; FIX_REQUIRED = HIGH or MEDIUM findings that must be remediated; BLOCKED = cannot complete review."
+    },
+    "finding_counts": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["high", "med", "low"],
+      "properties": {
+        "high": { "type": "integer", "minimum": 0 },
+        "med": { "type": "integer", "minimum": 0 },
+        "low": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "files_reviewed": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Number of files examined across all three phases."
+    },
+    "phases": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["context", "comparative", "assessment"],
+      "properties": {
+        "context": {
+          "type": "boolean",
+          "description": "Phase 1 (repository context research) completed."
+        },
+        "comparative": {
+          "type": "boolean",
+          "description": "Phase 2 (comparative analysis against existing patterns) completed."
+        },
+        "assessment": {
+          "type": "boolean",
+          "description": "Phase 3 (vulnerability assessment) completed."
+        }
+      }
+    },
+    "findings": {
+      "type": "array",
+      "description": "Individual findings with confidence >= 0.7. Empty when no findings.",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["severity", "category", "file", "confidence", "title"],
+        "properties": {
+          "severity": {
+            "type": "string",
+            "enum": ["HIGH", "MEDIUM", "LOW"]
+          },
+          "category": {
+            "type": "string",
+            "minLength": 1,
+            "description": "e.g. sql_injection, auth_bypass, hardcoded_secret, xss, ssrf, path_traversal"
+          },
+          "file": {
+            "type": "string",
+            "minLength": 1,
+            "description": "path/to/file.ts:line"
+          },
+          "confidence": {
+            "type": "number",
+            "minimum": 0.7,
+            "maximum": 1.0,
+            "description": "Numeric confidence 0.7–1.0 (below 0.7 must not be reported)."
+          },
+          "title": {
+            "type": "string",
+            "minLength": 1,
+            "description": "One-sentence finding title."
+          }
+        }
+      }
+    }
+  }
+}