mandrel 2.0.0 → 2.2.0

package/lib/migrations/steps/2.1.0-retire-mi-drop-knobs.js

@@ -0,0 +1,100 @@
+// lib/migrations/steps/2.1.0-retire-mi-drop-knobs.js
+/**
+ * Story #4531 — the first real step in the migration registry.
+ *
+ * `delivery.quality.codingGuardrails.miDropMustRefactor` and
+ * `delivery.quality.autoRefresh.miDropCap` were schema-validated, defaulted,
+ * and seeded by `apply-quality-bootstrap.js` into a consumer's
+ * `.agentrc.json` — but never consumed by the gate they were named for
+ * (`maintainability.tolerance` is the knob actually in force; see the
+ * Story body for the full diagnosis). Both retired keys lived under
+ * sub-schemas with `additionalProperties: false`, so a consumer whose
+ * config still carries either key hits a hard AJV validation failure on
+ * upgrade, not a warning. This step strips them before that check runs.
+ */
+
+import nodeFs from 'node:fs';
+import path from 'node:path';
+
+const AGENTRC_FILENAME = '.agentrc.json';
+
+/**
+ * @param {unknown} ctx
+ * @returns {string}
+ */
+function resolveAgentrcPath(ctx) {
+  const projectRoot = ctx?.projectRoot ?? process.cwd();
+  return path.join(projectRoot, AGENTRC_FILENAME);
+}
+
+/**
+ * @param {unknown} ctx
+ * @param {typeof nodeFs} fsImpl
+ * @returns {object | null}
+ */
+function readAgentrcConfig(ctx, fsImpl) {
+  try {
+    const raw = fsImpl.readFileSync(resolveAgentrcPath(ctx), 'utf8');
+    return JSON.parse(raw);
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * @param {object | null} config
+ * @returns {boolean}
+ */
+function hasRetiredKey(config) {
+  const guardrails = config?.delivery?.quality?.codingGuardrails;
+  const autoRefresh = config?.delivery?.quality?.autoRefresh;
+  return (
+    (Boolean(guardrails) && Object.hasOwn(guardrails, 'miDropMustRefactor')) ||
+    (Boolean(autoRefresh) && Object.hasOwn(autoRefresh, 'miDropCap'))
+  );
+}
+
+export const retireMiDropKnobs = {
+  version: '2.1.0',
+  description:
+    'strip retired delivery.quality.codingGuardrails.miDropMustRefactor ' +
+    'and delivery.quality.autoRefresh.miDropCap from .agentrc.json',
+  /**
+   * @param {{ projectRoot?: string, fs?: typeof nodeFs }} [ctx]
+   * @returns {boolean}
+   */
+  detect(ctx) {
+    const fsImpl = ctx?.fs ?? nodeFs;
+    return hasRetiredKey(readAgentrcConfig(ctx, fsImpl));
+  },
+  /**
+   * @param {{ projectRoot?: string, fs?: typeof nodeFs }} [ctx]
+   * @returns {void}
+   */
+  apply(ctx) {
+    const fsImpl = ctx?.fs ?? nodeFs;
+    const config = readAgentrcConfig(ctx, fsImpl);
+    if (!config) return;
+
+    const guardrails = config.delivery?.quality?.codingGuardrails;
+    if (guardrails && Object.hasOwn(guardrails, 'miDropMustRefactor')) {
+      delete guardrails.miDropMustRefactor;
+      if (Object.keys(guardrails).length === 0) {
+        delete config.delivery.quality.codingGuardrails;
+      }
+    }
+
+    const autoRefresh = config.delivery?.quality?.autoRefresh;
+    if (autoRefresh && Object.hasOwn(autoRefresh, 'miDropCap')) {
+      delete autoRefresh.miDropCap;
+      if (Object.keys(autoRefresh).length === 0) {
+        delete config.delivery.quality.autoRefresh;
+      }
+    }
+
+    fsImpl.writeFileSync(
+      resolveAgentrcPath(ctx),
+      `${JSON.stringify(config, null, 2)}\n`,
+    );
+  },
+};

package/lib/migrations/steps/2.1.0-retire-verify-concurrency-cap.js

@@ -0,0 +1,101 @@
+// lib/migrations/steps/2.1.0-retire-verify-concurrency-cap.js
+/**
+ * Story #4545 — retire `delivery.deliverRunner.verifyConcurrencyCap`.
+ *
+ * The knob was schema-validated, defaulted to 4, resolved by `getRunners`,
+ * and documented as bounding "the per-wave verifyWaveResults loop" — a loop
+ * that does not exist anywhere in the tree. Its only reader was
+ * `analyze-execution.js`, which echoed the number into a perf report rather
+ * than bounding anything; that CLI is deleted in the same Story. Setting the
+ * knob to any value only ever changed a number printed in a report.
+ *
+ * `delivery.deliverRunner` declares `additionalProperties: false`, so a
+ * consumer whose config still carries the key hits a hard AJV validation
+ * failure on upgrade — every script that resolves config, not just the one
+ * that read it. This step strips it before that check runs.
+ *
+ * Unlike the 2.1.0 mi-drop step, this one also sweeps `.agentrc.local.json`:
+ * the resolver deep-merges the local override over `.agentrc.json` and
+ * validates the *merged* result, so a key left in the local file fails the
+ * same way a key in the committed file does.
+ */
+
+import nodeFs from 'node:fs';
+import path from 'node:path';
+
+const AGENTRC_FILENAMES = ['.agentrc.json', '.agentrc.local.json'];
+
+/**
+ * @param {unknown} ctx
+ * @param {string} filename
+ * @returns {string}
+ */
+function resolveAgentrcPath(ctx, filename) {
+  const projectRoot = ctx?.projectRoot ?? process.cwd();
+  return path.join(projectRoot, filename);
+}
+
+/**
+ * @param {unknown} ctx
+ * @param {string} filename
+ * @param {typeof nodeFs} fsImpl
+ * @returns {object | null}
+ */
+function readAgentrcConfig(ctx, filename, fsImpl) {
+  try {
+    const raw = fsImpl.readFileSync(resolveAgentrcPath(ctx, filename), 'utf8');
+    return JSON.parse(raw);
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * @param {object | null} config
+ * @returns {boolean}
+ */
+function hasRetiredKey(config) {
+  const deliverRunner = config?.delivery?.deliverRunner;
+  return (
+    Boolean(deliverRunner) &&
+    Object.hasOwn(deliverRunner, 'verifyConcurrencyCap')
+  );
+}
+
+export const retireVerifyConcurrencyCap = {
+  version: '2.1.0',
+  description:
+    'strip retired delivery.deliverRunner.verifyConcurrencyCap from ' +
+    '.agentrc.json and .agentrc.local.json',
+  /**
+   * @param {{ projectRoot?: string, fs?: typeof nodeFs }} [ctx]
+   * @returns {boolean}
+   */
+  detect(ctx) {
+    const fsImpl = ctx?.fs ?? nodeFs;
+    return AGENTRC_FILENAMES.some((filename) =>
+      hasRetiredKey(readAgentrcConfig(ctx, filename, fsImpl)),
+    );
+  },
+  /**
+   * @param {{ projectRoot?: string, fs?: typeof nodeFs }} [ctx]
+   * @returns {void}
+   */
+  apply(ctx) {
+    const fsImpl = ctx?.fs ?? nodeFs;
+    for (const filename of AGENTRC_FILENAMES) {
+      const config = readAgentrcConfig(ctx, filename, fsImpl);
+      if (!hasRetiredKey(config)) continue;
+
+      delete config.delivery.deliverRunner.verifyConcurrencyCap;
+      if (Object.keys(config.delivery.deliverRunner).length === 0) {
+        delete config.delivery.deliverRunner;
+      }
+
+      fsImpl.writeFileSync(
+        resolveAgentrcPath(ctx, filename),
+        `${JSON.stringify(config, null, 2)}\n`,
+      );
+    }
+  },
+};

package/lib/migrations/steps/2.2.0-retire-epic-ac-tags.js

@@ -0,0 +1,154 @@
+// lib/migrations/steps/2.2.0-retire-epic-ac-tags.js
+/**
+ * Story #4604 — strip the retired `@epic-<id>-ac-N` Gherkin AC tag namespace
+ * from consumer feature files.
+ *
+ * The v2 Epic removal deleted `acceptance-spec-reconciler.js`, the only
+ * consumer of the namespaced per-Epic AC tags, and the `/plan` authoring
+ * prompt no longer mandates them. Surviving tags in consumer `.feature`
+ * files are inert and violate the gherkin-standards tag taxonomy's
+ * no-ad-hoc-tags rule, so this step removes them: each `@epic-<digits>-ac-<digits>`
+ * token is deleted from tag lines, a tag line left with no tags is dropped
+ * entirely, and every other tag and line is preserved byte-for-byte. Files
+ * with no stale tags are never rewritten.
+ */
+
+import nodeFs from 'node:fs';
+import path from 'node:path';
+
+/**
+ * Mirror of `CANONICAL_FEATURE_ROOTS` in
+ * `.agents/scripts/lib/bdd-runner-detect.js`. Duplicated deliberately:
+ * `lib/` runs from the installed npm package inside a consumer project and
+ * must not import from the materialized `.agents/` payload.
+ */
+const CANONICAL_FEATURE_ROOTS = Object.freeze([
+  'tests/features',
+  'features',
+  'test/features',
+]);
+
+const EPIC_AC_TAG_RE = /@epic-\d+-ac-\d+/;
+
+/**
+ * A Gherkin tag line: optional indentation followed by one or more
+ * whitespace-separated `@tag` tokens and nothing else.
+ */
+const TAG_LINE_RE = /^(\s*)(@\S+(?:\s+@\S+)*)\s*$/;
+
+/**
+ * Recursively collect `.feature` file paths under `root`.
+ *
+ * @param {string} root
+ * @param {typeof nodeFs} fsImpl
+ * @returns {string[]}
+ */
+function collectFeatureFiles(root, fsImpl) {
+  /** @type {string[]} */
+  const found = [];
+  /** @type {string[]} */
+  const queue = [root];
+  while (queue.length > 0) {
+    const dir = queue.pop();
+    /** @type {import('node:fs').Dirent[]} */
+    let entries;
+    try {
+      entries = fsImpl.readdirSync(dir, { withFileTypes: true });
+    } catch {
+      continue;
+    }
+    for (const entry of entries) {
+      const full = path.join(dir, entry.name);
+      if (entry.isDirectory()) {
+        queue.push(full);
+      } else if (entry.isFile() && entry.name.endsWith('.feature')) {
+        found.push(full);
+      }
+    }
+  }
+  return found.sort();
+}
+
+/**
+ * @param {unknown} ctx
+ * @param {typeof nodeFs} fsImpl
+ * @returns {string[]} Absolute paths of every `.feature` file under the
+ *   canonical feature roots that exist in the consumer tree.
+ */
+function resolveFeatureFiles(ctx, fsImpl) {
+  const projectRoot = ctx?.projectRoot ?? process.cwd();
+  return CANONICAL_FEATURE_ROOTS.flatMap((root) =>
+    collectFeatureFiles(path.join(projectRoot, root), fsImpl),
+  );
+}
+
+/**
+ * Strip retired `@epic-<id>-ac-<n>` tokens from one file's content.
+ * Only tag lines are touched; a tag line whose every tag was retired is
+ * dropped. Returns the original string when nothing matched.
+ *
+ * @param {string} content
+ * @returns {string}
+ */
+function stripEpicAcTags(content) {
+  if (!EPIC_AC_TAG_RE.test(content)) return content;
+  const newline = content.includes('\r\n') ? '\r\n' : '\n';
+  const lines = content.split(newline);
+  /** @type {string[]} */
+  const out = [];
+  for (const line of lines) {
+    const match = line.match(TAG_LINE_RE);
+    if (!match || !EPIC_AC_TAG_RE.test(line)) {
+      out.push(line);
+      continue;
+    }
+    const [, indent, tagBlock] = match;
+    const kept = tagBlock
+      .split(/\s+/)
+      .filter((tag) => !EPIC_AC_TAG_RE.test(tag));
+    if (kept.length === 0) continue;
+    out.push(`${indent}${kept.join(' ')}`);
+  }
+  return out.join(newline);
+}
+
+export const retireEpicAcTags = {
+  version: '2.2.0',
+  description:
+    'strip retired @epic-<id>-ac-N Gherkin AC tags from feature files ' +
+    '(their reconciler consumer was deleted in the v2 Epic removal)',
+  /**
+   * @param {{ projectRoot?: string, fs?: typeof nodeFs }} [ctx]
+   * @returns {boolean}
+   */
+  detect(ctx) {
+    const fsImpl = ctx?.fs ?? nodeFs;
+    return resolveFeatureFiles(ctx, fsImpl).some((file) => {
+      try {
+        return EPIC_AC_TAG_RE.test(fsImpl.readFileSync(file, 'utf8'));
+      } catch {
+        return false;
+      }
+    });
+  },
+  /**
+   * @param {{ projectRoot?: string, fs?: typeof nodeFs }} [ctx]
+   * @returns {void}
+   */
+  apply(ctx) {
+    const fsImpl = ctx?.fs ?? nodeFs;
+    for (const file of resolveFeatureFiles(ctx, fsImpl)) {
+      /** @type {string} */
+      let content;
+      try {
+        content = fsImpl.readFileSync(file, 'utf8');
+      } catch {
+        continue;
+      }
+      const stripped = stripEpicAcTags(content);
+      if (stripped !== content) {
+        fsImpl.writeFileSync(file, stripped);
+      }
+    }
+  },
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mandrel",
-  "version": "2.0.0",
+  "version": "2.2.0",
   "description": "Claude Code-first opinionated workflow framework: instructions, skills, rules, and SDLC workflows that govern AI coding assistants.",
   "files": [
     ".agents/",
@@ -45,7 +45,7 @@
     "crap:update": "node .agents/scripts/update-crap-baseline.js",
     "duplication:check": "node .agents/scripts/check-baselines.js --gate duplication",
     "duplication:update": "node .agents/scripts/update-duplication-baseline.js",
-    "quality:preview": "node .agents/scripts/quality-preview.js --changed-since HEAD && node .agents/scripts/check-dead-exports.js",
+    "quality:preview": "node .agents/scripts/check-dead-exports.js && node .agents/scripts/quality-preview.js",
     "quality:watch": "node .agents/scripts/quality-watch.js",
     "sync:commands": "node bin/mandrel.js sync-commands",
     "sync:agents": "node .agents/scripts/sync-claude-agents.js",

package/.agents/schemas/epic-perf-report.schema.json

@@ -1,89 +0,0 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://github.com/dsj1984/mandrel/blob/main/.agents/schemas/epic-perf-report.schema.json",
-  "title": "EpicPerfReport",
-  "description": "Payload of the <!-- structured:epic-perf-report --> comment posted once per Epic at close, alongside the retro (Epic #1030; waveParallelism utilisation rows added under Epic #3019 / Story #3025).",
-  "type": "object",
-  "additionalProperties": false,
-  "required": [
-    "kind",
-    "epicId",
-    "generatedAt",
-    "signalCounts",
-    "waveParallelism",
-    "topHotspots",
-    "mostFrictionStories"
-  ],
-  "properties": {
-    "kind": { "type": "string", "const": "epic-perf-report" },
-    "epicId": { "type": "integer", "minimum": 1 },
-    "generatedAt": { "type": "string", "format": "date-time" },
-    "signalCounts": {
-      "type": "object",
-      "description": "Rolled-up signal counts by kind for the entire Epic.",
-      "additionalProperties": false,
-      "properties": {
-        "friction": { "type": "integer", "minimum": 0 },
-        "hotspot": { "type": "integer", "minimum": 0 },
-        "rework": { "type": "integer", "minimum": 0 },
-        "churn": { "type": "integer", "minimum": 0 },
-        "idle": { "type": "integer", "minimum": 0 },
-        "retry": { "type": "integer", "minimum": 0 }
-      }
-    },
-    "waveParallelism": {
-      "type": "array",
-      "description": "Per-wave parallelism utilisation. utilisation = summedStoryMs / (wallClockMs * min(storyCount, concurrencyCap)), clamped to [0,1] (Epic #3019 / Story #3025; effective-cap denominator Story #3850).",
-      "items": {
-        "type": "object",
-        "additionalProperties": false,
-        "required": [
-          "waveIndex",
-          "wallClockMs",
-          "summedStoryMs",
-          "utilisation",
-          "capBinding",
-          "verifyConcurrencyCap"
-        ],
-        "properties": {
-          "waveIndex": { "type": "integer", "minimum": 0 },
-          "storyCount": {
-            "type": "integer",
-            "minimum": 0,
-            "description": "Number of Stories in the wave (from wave-start.stories). Added Story #3850."
-          },
-          "wallClockMs": { "type": "integer", "minimum": 0 },
-          "summedStoryMs": { "type": "integer", "minimum": 0 },
-          "utilisation": { "type": "number", "minimum": 0, "maximum": 1 },
-          "capBinding": { "type": "boolean" },
-          "verifyConcurrencyCap": { "type": "integer", "minimum": 1 }
-        }
-      }
-    },
-    "topHotspots": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "additionalProperties": false,
-        "required": ["phase", "occurrences", "avgRatio"],
-        "properties": {
-          "phase": { "type": "string", "minLength": 1 },
-          "occurrences": { "type": "integer", "minimum": 0 },
-          "avgRatio": { "type": "number", "minimum": 0 }
-        }
-      }
-    },
-    "mostFrictionStories": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "additionalProperties": false,
-        "required": ["storyId", "frictionCount"],
-        "properties": {
-          "storyId": { "type": "integer", "minimum": 1 },
-          "frictionCount": { "type": "integer", "minimum": 0 }
-        }
-      }
-    }
-  }
-}

package/.agents/schemas/lifecycle/acceptance.reconcile.failed.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/acceptance.reconcile.failed.schema.json",
-  "title": "acceptance.reconcile.failed",
-  "description": "Emitted by AcceptanceReconciler when reconciliation fails. Routes to epic.blocked; no PR is created.",
-  "type": "object",
-  "required": ["baseRead", "reason"],
-  "properties": {
-    "baseRead": { "type": "boolean" },
-    "reason": { "type": "string", "minLength": 1 }
-  },
-  "additionalProperties": false
-}

package/.agents/schemas/lifecycle/acceptance.reconcile.ok.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/acceptance.reconcile.ok.schema.json",
-  "title": "acceptance.reconcile.ok",
-  "description": "Emitted by AcceptanceReconciler when reconciliation passes. Finalizer subscribes only to this event to gate the push and PR create.",
-  "type": "object",
-  "required": ["baseRead"],
-  "properties": {
-    "baseRead": { "type": "boolean" },
-    "reason": { "type": "string" }
-  },
-  "additionalProperties": false
-}

package/.agents/schemas/lifecycle/acceptance.reconcile.skipped.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/acceptance.reconcile.skipped.schema.json",
-  "title": "acceptance.reconcile.skipped",
-  "description": "Emitted by AcceptanceReconciler when reconciliation is skipped because the linked Acceptance Spec declares zero AC IDs ('empty-spec'). Story #2893 split the `acceptance::n-a` waiver path out to `acceptance.reconcile.waived` so the Finalizer can route waived Epics through to PR creation while empty-spec Epics still terminate without a PR. The reason field is required so the listener never silently no-ops.",
-  "type": "object",
-  "required": ["baseRead", "reason"],
-  "properties": {
-    "baseRead": { "type": "boolean" },
-    "reason": { "type": "string", "minLength": 1 }
-  },
-  "additionalProperties": false
-}

package/.agents/schemas/lifecycle/acceptance.reconcile.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/acceptance.reconcile.start.schema.json",
-  "title": "acceptance.reconcile.start",
-  "description": "Emitted by AcceptanceReconciler at the start of acceptance-spec reconciliation. Must precede pr.created in every healthy run (reconciliation ordering invariant).",
-  "type": "object",
-  "required": ["epicId"],
-  "properties": {
-    "epicId": { "type": "integer", "minimum": 1 }
-  },
-  "additionalProperties": false
-}

package/.agents/schemas/lifecycle/acceptance.reconcile.waived.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/acceptance.reconcile.waived.schema.json",
-  "title": "acceptance.reconcile.waived",
-  "description": "Emitted by AcceptanceReconciler when reconciliation is waived by the acceptance::n-a label. Distinct from acceptance.reconcile.skipped (which now means 'empty-spec' only) so the Finalizer can subscribe to .waived and route waived Epics through to PR creation while empty-spec Epics still terminate without a PR. The reason field is required and pinned to 'waiver'.",
-  "type": "object",
-  "required": ["baseRead", "reason"],
-  "properties": {
-    "baseRead": { "type": "boolean" },
-    "reason": { "type": "string", "const": "waiver" }
-  },
-  "additionalProperties": false
-}

package/.agents/schemas/lifecycle/epic.automerge.end.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.automerge.end.schema.json",
-  "title": "epic.automerge.end",
-  "description": "Emitted at the end of the automerge phase wrapper. merged=true means GitHub completed the squash; merged=false with a reason captures predicate-blocked or armed-but-pending outcomes.",
-  "type": "object",
-  "required": ["prUrl", "merged"],
-  "properties": {
-    "prUrl": { "type": "string", "format": "uri", "minLength": 1 },
-    "merged": { "type": "boolean" },
-    "reason": { "type": "string" },
-    "epicId": { "type": "integer", "minimum": 1 }
-  },
-  "additionalProperties": false
-}

package/.agents/schemas/lifecycle/epic.automerge.start.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.automerge.start.schema.json",
-  "title": "epic.automerge.start",
-  "description": "Emitted at the start of the automerge phase wrapper (Phase 8.5, via lifecycle-emit.js). AutomergePredicate subscribes to this event (Story #3901) and evaluates the structured-signal verdict; it carries no checkOutcomes because Phase 8 already polled CI to green. Distinct from epic.merge.ready (predicate outcome) and epic.merge.armed (arm outcome).",
-  "type": "object",
-  "required": ["prUrl"],
-  "properties": {
-    "prUrl": { "type": "string", "format": "uri", "minLength": 1 },
-    "epicId": { "type": "integer", "minimum": 1 }
-  },
-  "additionalProperties": false
-}

package/.agents/schemas/lifecycle/epic.blocked.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.blocked.schema.json",
-  "title": "epic.blocked",
-  "description": "Emitted by AcceptanceReconciler (on a failed acceptance reconciliation), MergeWatcher (on a merge-watch timeout), and — in headless runs (Story #4472) — AutomergePredicate (on a predicate refusal that would otherwise silently park) and AutomergeArmer (on a genuine arm failure) when the Epic transitions to agent::blocked. Subscribed by NotifyDispatcher, which fans the blocker out to the curated webhook channel. The reason field carries either a typed marker (timeout:<event>, merge-predicate:refused, merge-arm:failed, waiver, …) or a free-form summary; sourceStoryId scopes the blocker to a child Story when applicable.",
-  "type": "object",
-  "required": ["reason"],
-  "properties": {
-    "reason": { "type": "string", "minLength": 1 },
-    "sourceStoryId": { "type": "integer", "minimum": 1 }
-  },
-  "additionalProperties": false
-}

package/.agents/schemas/lifecycle/epic.cleanup.end.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.cleanup.end.schema.json",
-  "title": "epic.cleanup.end",
-  "description": "Emitted by Cleaner when branch cleanup and temp archive complete.",
-  "type": "object",
-  "required": ["epicId"],
-  "properties": {
-    "epicId": { "type": "integer", "minimum": 1 }
-  },
-  "additionalProperties": false
-}

package/.agents/schemas/lifecycle/epic.cleanup.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.cleanup.start.schema.json",
-  "title": "epic.cleanup.start",
-  "description": "Emitted by Cleaner at the start of branch cleanup + temp archive.",
-  "type": "object",
-  "required": ["epicId"],
-  "properties": {
-    "epicId": { "type": "integer", "minimum": 1 }
-  },
-  "additionalProperties": false
-}

package/.agents/schemas/lifecycle/epic.close.end.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.close.end.schema.json",
-  "title": "epic.close.end",
-  "description": "Emitted when the close-tail phase finishes; AcceptanceReconciler subscribes to this event to gate finalize.",
-  "type": "object",
-  "required": ["epicId"],
-  "properties": {
-    "epicId": { "type": "integer", "minimum": 1 }
-  },
-  "additionalProperties": false
-}

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
-}