mandrel 2.0.0 → 2.2.0

package/.agents/schemas/lifecycle/epic.finalize.start.schema.json

@@ -1,12 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://github.com/dsj1984/mandrel/blob/main/.agents/schemas/lifecycle/epic.finalize.start.schema.json",
-  "title": "epic.finalize.start",
-  "description": "Emitted by Finalizer at the start of the finalize phase (fast-forward / hotspot / baseline / push / gh pr create).",
-  "type": "object",
-  "required": ["epicId"],
-  "properties": {
-    "epicId": { "type": "integer", "minimum": 1 }
-  },
-  "additionalProperties": false
-}

package/.agents/schemas/lifecycle/epic.merge.armed.schema.json

@@ -1,13 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://github.com/dsj1984/mandrel/blob/main/.agents/schemas/lifecycle/epic.merge.armed.schema.json",
-  "title": "epic.merge.armed",
-  "description": "Emitted by AutomergeArmer after gh pr merge --auto --squash --delete-branch succeeds. Must be preceded by epic.merge.ready from the same run (merge-gate ordering invariant).",
-  "type": "object",
-  "required": ["prUrl"],
-  "properties": {
-    "prUrl": { "type": "string", "format": "uri", "minLength": 1 },
-    "epicId": { "type": "integer", "minimum": 1 }
-  },
-  "additionalProperties": false
-}

package/.agents/schemas/lifecycle/epic.merge.blocked.schema.json

@@ -1,14 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://github.com/dsj1984/mandrel/blob/main/.agents/schemas/lifecycle/epic.merge.blocked.schema.json",
-  "title": "epic.merge.blocked",
-  "description": "Emitted by AutomergePredicate when the Epic is NOT safe to auto-merge. AutomergeArmer never sees this event; PR stays disarmed.",
-  "type": "object",
-  "required": ["prUrl", "reason"],
-  "properties": {
-    "prUrl": { "type": "string", "format": "uri", "minLength": 1 },
-    "reason": { "type": "string", "minLength": 1 },
-    "epicId": { "type": "integer", "minimum": 1 }
-  },
-  "additionalProperties": false
-}

package/.agents/schemas/lifecycle/epic.merge.confirmed.schema.json

@@ -1,17 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://github.com/dsj1984/mandrel/blob/main/.agents/schemas/lifecycle/epic.merge.confirmed.schema.json",
-  "title": "epic.merge.confirmed",
-  "description": "Emitted by MergeWatcher after gh pr view --json mergeCommit,mergedAt returns a non-null mergeCommit for the armed Epic PR. Strictly downstream of epic.merge.armed; carries the observed mergeCommit SHA, mergedAt timestamp, and the cumulative poll count (Story #2896, Epic #2880).",
-  "type": "object",
-  "required": ["epicId", "prUrl", "mergeCommitSha", "pollAttempts"],
-  "properties": {
-    "epicId": { "type": "integer", "minimum": 1 },
-    "prUrl": { "type": "string", "format": "uri", "minLength": 1 },
-    "prNumber": { "type": ["integer", "null"], "minimum": 1 },
-    "mergeCommitSha": { "type": "string", "minLength": 1 },
-    "mergedAt": { "type": ["string", "null"] },
-    "pollAttempts": { "type": "integer", "minimum": 1 }
-  },
-  "additionalProperties": false
-}

package/.agents/schemas/lifecycle/epic.merge.ready.schema.json

@@ -1,15 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://github.com/dsj1984/mandrel/blob/main/.agents/schemas/lifecycle/epic.merge.ready.schema.json",
-  "title": "epic.merge.ready",
-  "description": "Emitted SOLELY by AutomergePredicate (on epic.automerge.start in production, or epic.watch.end on the test-only Watcher path) once CI is confirmed green and the disqualification gate passes. The ONLY event AutomergeArmer subscribes to. Story #3367: the Finalizer no longer emits this event — emitting it from finalize cascaded epic.close.end synchronously into the auto-merge arm + branch reap, bypassing the predicate gate and deleting the epic branch before the PR merged.",
-  "type": "object",
-  "required": ["prUrl"],
-  "properties": {
-    "prUrl": { "type": "string", "format": "uri", "minLength": 1 },
-    "reason": { "type": "string" },
-    "epicId": { "type": "integer", "minimum": 1 },
-    "prNumber": { "type": "integer", "minimum": 1 }
-  },
-  "additionalProperties": false
-}

package/.agents/schemas/lifecycle/epic.plan.end.schema.json

@@ -1,18 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://github.com/dsj1984/mandrel/blob/main/.agents/schemas/lifecycle/epic.plan.end.schema.json",
-  "title": "epic.plan.end",
-  "description": "Emitted when the runner finishes building the wave DAG.",
-  "type": "object",
-  "required": ["waves"],
-  "properties": {
-    "waves": {
-      "type": "array",
-      "items": {
-        "type": "array",
-        "items": { "type": "integer", "minimum": 1 }
-      }
-    }
-  },
-  "additionalProperties": false
-}

package/.agents/schemas/lifecycle/epic.plan.start.schema.json

@@ -1,12 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://github.com/dsj1984/mandrel/blob/main/.agents/schemas/lifecycle/epic.plan.start.schema.json",
-  "title": "epic.plan.start",
-  "description": "Emitted when the runner begins planning waves for an Epic.",
-  "type": "object",
-  "required": ["epicId"],
-  "properties": {
-    "epicId": { "type": "integer", "minimum": 1 }
-  },
-  "additionalProperties": false
-}

package/.agents/schemas/lifecycle/epic.snapshot.end.schema.json

@@ -1,16 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://github.com/dsj1984/mandrel/blob/main/.agents/schemas/lifecycle/epic.snapshot.end.schema.json",
-  "title": "epic.snapshot.end",
-  "description": "Emitted when the snapshot phase finishes; carries enumerated story IDs the Epic owns.",
-  "type": "object",
-  "required": ["epicId", "storyIds"],
-  "properties": {
-    "epicId": { "type": "integer", "minimum": 1 },
-    "storyIds": {
-      "type": "array",
-      "items": { "type": "integer", "minimum": 1 }
-    }
-  },
-  "additionalProperties": false
-}

package/.agents/schemas/lifecycle/epic.snapshot.start.schema.json

@@ -1,12 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://github.com/dsj1984/mandrel/blob/main/.agents/schemas/lifecycle/epic.snapshot.start.schema.json",
-  "title": "epic.snapshot.start",
-  "description": "Emitted when the runner enters the snapshot phase for an Epic.",
-  "type": "object",
-  "required": ["epicId"],
-  "properties": {
-    "epicId": { "type": "integer", "minimum": 1 }
-  },
-  "additionalProperties": false
-}

package/.agents/schemas/lifecycle/epic.watch.end.schema.json

@@ -1,29 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://github.com/dsj1984/mandrel/blob/main/.agents/schemas/lifecycle/epic.watch.end.schema.json",
-  "title": "epic.watch.end",
-  "description": "Emitted by Watcher when required checks settle. checkOutcomes maps check-name → terminal state (success | failure | timed_out | skipped) or the slow-but-not-failed sentinel `still-running` (Story #4358: the poll cap fired with the check still pending after the resume budget was exhausted — distinct from a genuine `failure`). AutomergePredicate subscribes to this event (test-only Watcher path; the production Phase 8.5 boundary is epic.automerge.start).",
-  "type": "object",
-  "required": ["prUrl", "checkOutcomes"],
-  "properties": {
-    "prUrl": { "type": "string", "format": "uri", "minLength": 1 },
-    "checkOutcomes": {
-      "type": "object",
-      "additionalProperties": {
-        "type": "string",
-        "enum": [
-          "success",
-          "failure",
-          "neutral",
-          "cancelled",
-          "timed_out",
-          "still-running",
-          "action_required",
-          "stale",
-          "skipped"
-        ]
-      }
-    }
-  },
-  "additionalProperties": false
-}

package/.agents/schemas/lifecycle/epic.watch.start.schema.json

@@ -1,16 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://github.com/dsj1984/mandrel/blob/main/.agents/schemas/lifecycle/epic.watch.start.schema.json",
-  "title": "epic.watch.start",
-  "description": "Emitted by Watcher when required-check polling begins. Required-check names are resolved from GitHub at runtime via gh pr checks, not from .agentrc.json.",
-  "type": "object",
-  "required": ["prUrl", "requiredChecks"],
-  "properties": {
-    "prUrl": { "type": "string", "format": "uri", "minLength": 1 },
-    "requiredChecks": {
-      "type": "array",
-      "items": { "type": "string", "minLength": 1 }
-    }
-  },
-  "additionalProperties": false
-}

package/.agents/schemas/lifecycle/story.heartbeat.schema.json

@@ -1,20 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://github.com/dsj1984/mandrel/blob/main/.agents/schemas/lifecycle/story.heartbeat.schema.json",
-  "title": "story.heartbeat",
-  "description": "Emitted by story-phase.js inside a Story's implementation loop. Surfaces the in-progress Story as an inspectable ledger event so /deliver's host-loop reconciler can confirm a long Story is still making forward progress between dispatch and merge — distinct from story.dispatch.start (one per Story per attempt) and story.merged (one per Story per close). The 2-tier hierarchy has no child Task tickets, so the heartbeat carries phase info only. The optional operator field (Story #3480) records the handle holding the assignee-as-lease claim on the Story so the ticket-lease primitive can decide claim liveness from the most-recent heartbeat for a given owner.",
-  "type": "object",
-  "required": ["event", "storyId", "epicId", "phase", "timestamp"],
-  "properties": {
-    "event": { "type": "string", "const": "story.heartbeat" },
-    "storyId": { "type": "integer", "minimum": 1 },
-    "epicId": { "type": "integer", "minimum": 1 },
-    "phase": {
-      "type": "string",
-      "enum": ["init", "implementing", "closing", "blocked", "done"]
-    },
-    "timestamp": { "type": "string", "format": "date-time" },
-    "operator": { "type": "string", "minLength": 1 }
-  },
-  "additionalProperties": false
-}

package/.agents/schemas/risk-verdict.schema.json

@@ -1,53 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "risk-verdict",
-  "title": "Planning Risk Verdict",
-  "description": "Planner-authored risk judgment for an Epic, produced by the epic-plan-spec-author Skill as the fourth planning artifact (risk-verdict.json) alongside the PRD, Tech Spec, and Acceptance Spec (Epic #3865). plan-persist.js validates the verdict against this schema, derives the deterministic planningRisk envelope via deriveRiskEnvelope (lib/orchestration/planning-risk.js), and records the verdict as a risk-verdict structured comment plus the epic-plan-state checkpoint riskVerdict field. The model supplies the judgment input (axes); the harness owns the gate decision. A malformed verdict fails closed to the validation-error path — it is never silently coerced.",
-  "type": "object",
-  "required": ["axes", "summary"],
-  "properties": {
-    "axes": {
-      "type": "array",
-      "description": "Risk axes the planner judges to genuinely apply to the Epic. An empty array asserts no recognized risk axis applies (derives an all-low envelope). Every entry must use the fixed axis vocabulary mirrored from REQUIRED_AXES / NOT_APPLICABLE_AXES in lib/orchestration/planning-risk.js.",
-      "items": {
-        "type": "object",
-        "required": ["axis", "level", "rationale"],
-        "properties": {
-          "axis": {
-            "type": "string",
-            "enum": [
-              "visible-behavior",
-              "public-api",
-              "security",
-              "data-migration",
-              "billing",
-              "destructive-mutation",
-              "critical-workflow",
-              "docs-only",
-              "test-harness",
-              "internal-refactor"
-            ],
-            "description": "Risk axis identifier. The first seven force a required acceptance disposition when present (REQUIRED_AXES); the last three waive the acceptance spec when they are the only signals (NOT_APPLICABLE_AXES)."
-          },
-          "level": {
-            "type": "string",
-            "enum": ["low", "medium", "high"],
-            "description": "Planner-judged severity of this axis for the Epic's actual change, not keyword presence — e.g. a PRD sentence saying 'out of scope: billing' is not a billing change."
-          },
-          "rationale": {
-            "type": "string",
-            "minLength": 1,
-            "description": "Concrete, reviewer-readable justification grounded in the PRD / Tech Spec the planner just authored. Never an empty self-attestation."
-          }
-        },
-        "additionalProperties": false
-      }
-    },
-    "summary": {
-      "type": "string",
-      "minLength": 1,
-      "description": "One-paragraph overall risk narrative for the audit trail (the rationale the retired regex classifier could never produce)."
-    }
-  },
-  "additionalProperties": false
-}

package/.agents/schemas/story-perf-summary.schema.json

@@ -1,73 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://github.com/dsj1984/mandrel/blob/main/.agents/schemas/story-perf-summary.schema.json",
-  "title": "StoryPerfSummary",
-  "description": "Payload of the <!-- structured:story-perf-summary --> comment posted once per Story at close (Epic #1030). Replaces the per-Task friction comment fanout and the standalone phase-timings comment.",
-  "type": "object",
-  "additionalProperties": false,
-  "required": [
-    "kind",
-    "storyId",
-    "epicId",
-    "closedAt",
-    "frictionByCategory",
-    "phaseTimingsMs",
-    "topSlowPhasesVsBaseline",
-    "reworkScore",
-    "retryDensity"
-  ],
-  "properties": {
-    "kind": { "type": "string", "const": "story-perf-summary" },
-    "storyId": { "type": "integer", "minimum": 1 },
-    "epicId": { "type": "integer", "minimum": 1 },
-    "closedAt": { "type": "string", "format": "date-time" },
-    "frictionByCategory": {
-      "type": "object",
-      "description": "Counts of friction signals bucketed by category for this Story.",
-      "additionalProperties": { "type": "integer", "minimum": 0 }
-    },
-    "phaseTimingsMs": {
-      "type": "object",
-      "description": "Elapsed ms per phase, sourced from phase-timer.js in-process record.",
-      "additionalProperties": { "type": "integer", "minimum": 0 }
-    },
-    "topSlowPhasesVsBaseline": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "additionalProperties": false,
-        "required": ["phase", "elapsedMs", "baselineP95Ms", "ratio"],
-        "properties": {
-          "phase": { "type": "string", "minLength": 1 },
-          "elapsedMs": { "type": "integer", "minimum": 0 },
-          "baselineP95Ms": { "type": "integer", "minimum": 0 },
-          "ratio": { "type": "number", "minimum": 0 }
-        }
-      }
-    },
-    "reworkScore": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["filesEditedBeyondThreshold"],
-      "properties": {
-        "filesEditedBeyondThreshold": { "type": "integer", "minimum": 0 },
-        "topPath": { "type": ["string", "null"], "minLength": 1 },
-        "topPathEdits": { "type": ["integer", "null"], "minimum": 0 }
-      }
-    },
-    "retryDensity": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["retries", "uniqueCommands"],
-      "properties": {
-        "retries": { "type": "integer", "minimum": 0 },
-        "uniqueCommands": { "type": "integer", "minimum": 0 }
-      }
-    },
-    "ghSpawnCount": {
-      "type": "integer",
-      "minimum": 0,
-      "description": "Throw-away measurement field (Story #1795 / Epic #1788): the in-process `gh` spawn counter snapshot at end of close validation. Used to verify the ≥100 fewer-spawns acceptance criterion against the baseline recorded under `temp/epic-1788/`. Removed in a follow-up cleanup commit before the Story merges to the Epic branch."
-    }
-  }
-}