mandrel 1.94.0 → 2.1.0

package/.agents/schemas/lifecycle/epic.complete.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.complete.schema.json",
-  "title": "epic.complete",
-  "description": "Terminal event for a successful Epic run, emitted by Cleaner once the temp archive + branch reap complete. NotifyDispatcher subscribes to this event to fan the completion out to the curated webhook channel; the agent::done label flip is driven by the post-merge close path.",
-  "type": "object",
-  "required": ["epicId", "prUrl"],
-  "properties": {
-    "epicId": { "type": "integer", "minimum": 1 },
-    "prUrl": { "type": "string", "format": "uri", "minLength": 1 }
-  },
-  "additionalProperties": false
-}

package/.agents/schemas/lifecycle/epic.finalize.end.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.finalize.end.schema.json",
-  "title": "epic.finalize.end",
-  "description": "Emitted by Finalizer after the PR is opened (or short-circuited by gh pr list --head idempotency check).",
-  "type": "object",
-  "required": ["epicId", "prUrl"],
-  "properties": {
-    "epicId": { "type": "integer", "minimum": 1 },
-    "prUrl": { "type": "string", "format": "uri", "minLength": 1 }
-  },
-  "additionalProperties": false
-}

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/slice.end.schema.json

@@ -1,21 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://github.com/dsj1984/mandrel/blob/main/.agents/schemas/lifecycle/slice.end.schema.json",
-  "title": "slice.end",
-  "description": "Appended to the Epic ledger by the single-delivery executor (deliver-epic-single.md, M4-B) when a Delivery-Slicing slice finishes — the single-delivery analogue of story.dispatch.end. A `done` outcome is what the slice-map checkpoint flips `slices[id].status` to before the walk advances; resume skips `done` slices because the epic/<id> branch already carries the work. Introduced INERT in Epic #4475 M4-A; the executor that emits it lands in M4-B.",
-  "type": "object",
-  "required": ["event", "epicId", "sliceId", "outcome", "timestamp"],
-  "properties": {
-    "event": { "type": "string", "const": "slice.end" },
-    "epicId": { "type": "integer", "minimum": 1 },
-    "sliceId": { "type": "string", "minLength": 1 },
-    "sliceIndex": { "type": "integer", "minimum": 0 },
-    "outcome": {
-      "type": "string",
-      "enum": ["done", "blocked", "failed", "skipped"]
-    },
-    "durationMs": { "type": "integer", "minimum": 0 },
-    "timestamp": { "type": "string", "format": "date-time" }
-  },
-  "additionalProperties": false
-}

package/.agents/schemas/lifecycle/slice.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/slice.heartbeat.schema.json",
-  "title": "slice.heartbeat",
-  "description": "Emitted from inside a slice's implementation loop in the single-delivery executor (deliver-epic-single.md, M4-B). Single-delivery collapses the whole Epic into one long guarded session, so the idle watchdog cannot lean on per-Story story.heartbeat to tell a live session from a dead one — slice.heartbeat is that forward-progress signal for the single session. The single-delivery analogue of story.heartbeat; carries phase info only (a spec-only plan has no child tickets). The optional operator field records the handle holding the assignee-as-lease claim on the Epic. Introduced INERT in Epic #4475 M4-A; the executor that emits it lands in M4-B.",
-  "type": "object",
-  "required": ["event", "epicId", "sliceId", "phase", "timestamp"],
-  "properties": {
-    "event": { "type": "string", "const": "slice.heartbeat" },
-    "epicId": { "type": "integer", "minimum": 1 },
-    "sliceId": { "type": "string", "minLength": 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/lifecycle/slice.start.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/slice.start.schema.json",
-  "title": "slice.start",
-  "description": "Emitted by the single-delivery executor (deliver-epic-single.md, M4-B) as it begins implementing one Delivery-Slicing slice inside the single guarded session on epic/<id>. The single-delivery analogue of story.dispatch.start (one per Story per attempt): a slice is the leaf work unit of a spec-only plan that authored no Story tickets, so the ledger carries the slice id + position instead of a storyId. Introduced INERT in Epic #4475 M4-A alongside the slice-map checkpoint; the executor that emits it lands in M4-B.",
-  "type": "object",
-  "required": ["event", "epicId", "sliceId", "timestamp"],
-  "properties": {
-    "event": { "type": "string", "const": "slice.start" },
-    "epicId": { "type": "integer", "minimum": 1 },
-    "sliceId": { "type": "string", "minLength": 1 },
-    "sliceIndex": { "type": "integer", "minimum": 0 },
-    "title": { "type": "string" },
-    "timestamp": { "type": "string", "format": "date-time" }
-  },
-  "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,66 +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)."
-    },
-    "deliveryShape": {
-      "type": "string",
-      "enum": ["fan-out", "single"],
-      "description": "Planner-judged delivery shape for the Epic (Epic #4474 PR4, design §2 mode matrix). 'fan-out' persists a Story tree (the default when the field is absent — existing verdicts stay valid); 'single' is the spec-only single-delivery mode: no tickets are authored, the ticket validator + DAG are skipped, and plan-persist applies the delivery::single routing marker instead of a Story tree. The marker is inert until #4475 lands the deliver-side reader."
-    },
-    "deliveryShapeRationale": {
-      "type": "string",
-      "minLength": 1,
-      "description": "Concrete justification for the declared deliveryShape, grounded in the Delivery Slicing table (slice count / chain shape). Required whenever deliveryShape is present; surfaced as the routingReasons of the single-mode plan summary."
-    }
-  },
-  "dependentRequired": {
-    "deliveryShape": ["deliveryShapeRationale"]
-  },
-  "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."
-    }
-  }
-}