mandrel 1.94.0 → 2.0.0

package/.agents/schemas/epic-spec.schema.json

@@ -1,153 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://github.com/dsj1984/mandrel/blob/main/.agents/schemas/epic-spec.schema.json",
-  "version": "4.0.0",
-  "title": "Epic Spec (declarative structural SSOT)",
-  "description": "Canonical structural specification for an Epic and its child Stories, consumed by the epic-spec-reconciler. Lives on disk as .agents/epics/<epic-id>.yaml. The reconciler diffs this spec against live GitHub state and applies structural mutations (Create/Update/Close/Relink) behind a dry-run default. Slugs are stable, GH-incarnation-independent identifiers used for intra-spec dependency edges (dependsOn) and the spec ↔ GH-issue mapping persisted in the sibling .agents/epics/<epic-id>.state.json. This schema describes the 2-tier structural shape only (Epic → Story with inline Story-level acceptance[]/verify[]); agent-execution state (agent::* labels) is intentionally not modelled — that surface belongs to the wave-runner, not the reconciler.",
-  "type": "object",
-  "additionalProperties": false,
-  "required": ["epic", "stories"],
-  "properties": {
-    "$schema": {
-      "type": "string",
-      "description": "Relative or absolute reference to this schema file. Allowed at the top level so YAML editors with $schema-aware autocomplete (e.g. the Red Hat YAML extension) can resolve the schema from the spec file itself."
-    },
-    "version": {
-      "type": "string",
-      "pattern": "^\\d+\\.\\d+\\.\\d+$",
-      "description": "Optional schema-shape identifier. Identification-only — readers MUST NOT branch behavior on this value. Bumped to 4.0.0 when the Feature tier was removed under the 2-tier collapse (Story #4041); 3.0.0 removed Task-level decomposition (Epic #3078)."
-    },
-    "epic": {
-      "$ref": "#/$defs/epic",
-      "description": "The Epic this spec describes. Carries the GH issue number, human title, and structural labels (type::epic plus any project-specific structural tags). Execution-state labels (agent::*) MUST NOT appear here."
-    },
-    "stories": {
-      "type": "array",
-      "description": "Ordered list of Stories under this Epic. Order is preserved for human readability but is not load-bearing — execution order is driven by stories[].wave + dependsOn, not by array position.",
-      "items": { "$ref": "#/$defs/story" }
-    },
-    "gates": {
-      "$ref": "#/$defs/gates",
-      "description": "Optional references to baseline + gate-config slugs resolved by the baseline subsystem. Carried in the spec so structural changes can be reviewed alongside the quality-gate config that will run against them."
-    }
-  },
-  "$defs": {
-    "slug": {
-      "type": "string",
-      "minLength": 1,
-      "pattern": "^[a-z0-9][a-z0-9-]*$",
-      "description": "Stable kebab-case identifier used for intra-spec dependency edges (dependsOn) and the spec ↔ GH-issue mapping. Slugs must be unique within the Epic's stories[] array. Slugs are not GH issue numbers — they survive Epic re-incarnations and ticket renumbering. Pattern: lowercase alphanumeric + hyphens, must start with [a-z0-9]."
-    },
-    "label": {
-      "type": "string",
-      "minLength": 1,
-      "description": "A GitHub label name. Structural labels only (e.g. type::epic, type::story, persona::*, area::*). Execution-state labels in the AGENT_LABELS allow-list (agent::*) MUST NOT appear in the spec — they are owned by the wave-runner and the reconciler refuses to write them."
-    },
-    "labels": {
-      "type": "array",
-      "description": "Structural labels attached to this entity. The reconciler enforces an allow-list (STRUCTURAL_LABELS) and rejects any plan that attempts to update AGENT_LABELS via the structural path.",
-      "items": { "$ref": "#/$defs/label" },
-      "uniqueItems": true
-    },
-    "epic": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["id", "title"],
-      "description": "Top-level Epic descriptor. Unlike Stories (which are slug-keyed and may not exist in GH yet), the Epic always has a real GH issue number — the spec lives at .agents/epics/<id>.yaml and that <id> is the same number used here.",
-      "properties": {
-        "id": {
-          "type": "integer",
-          "minimum": 1,
-          "description": "GitHub issue number for the Epic. Authoritative — the spec file's filename derives from this value (.agents/epics/<id>.yaml) and the sibling state file (<id>.state.json) is keyed against it."
-        },
-        "title": {
-          "type": "string",
-          "minLength": 1,
-          "description": "Human-readable Epic title. Reconciler updates the GH issue title to match this value on every apply (subject to mayUpdate gating)."
-        },
-        "body": {
-          "type": "string",
-          "description": "Optional Epic body. When present, the reconciler updates the GH issue body to match. When omitted, the GH issue body is left untouched (allowing operator-curated bodies to coexist with structural reconciliation). Multi-line markdown is fully supported. Thematic grouping of Stories — formerly the Feature tier's job — lives here (and in the Tech Spec) as prose."
-        },
-        "labels": {
-          "$ref": "#/$defs/labels",
-          "description": "Structural labels attached to the Epic (e.g. type::epic plus any project-specific structural tags). agent::* labels are forbidden — they are owned by the wave-runner."
-        }
-      }
-    },
-    "story": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["slug", "title", "wave"],
-      "description": "A Story is the unit of agent execution — exactly one Story branch (story-<id>) and exactly one Story sub-agent per Story per wave. Stories are direct children of the Epic (2-tier hierarchy, Story #4041). They declare their wave assignment and inter-Story dependencies via slug references; the wave-runner consumes these to schedule the parallel fan-out. Stories carry inline acceptance[] + verify[] arrays that the Story sub-agent treats as the Goal/Changes/Acceptance/Verify surface; there is no child-Task decomposition.",
-      "properties": {
-        "slug": {
-          "$ref": "#/$defs/slug",
-          "description": "Stable kebab-case identifier for this Story. Must be unique within the Epic's stories[] array, and is the value referenced by sibling Stories' dependsOn arrays."
-        },
-        "title": {
-          "type": "string",
-          "minLength": 1,
-          "description": "Human-readable Story title. Becomes the GH issue title."
-        },
-        "body": {
-          "type": "string",
-          "description": "Optional Story body. Written by the reconciler when present; left untouched when omitted. Used to carry Story-level acceptance criteria / context that the decomposer authored."
-        },
-        "wave": {
-          "type": "integer",
-          "minimum": 0,
-          "description": "Zero-indexed wave number. The wave-runner groups Stories with the same wave value into a single parallel batch and waits for every Story in wave N to close before dispatching wave N+1. Wave 0 typically contains Stories with no inbound dependsOn edges."
-        },
-        "dependsOn": {
-          "type": "array",
-          "description": "Slugs of Stories (within this Epic) that must close before this Story may dispatch. Slugs reference stories[].slug values — not GH issue numbers — so the spec survives GH re-incarnations. The reconciler resolves slugs to issue numbers via the sibling state file when writing GH-side `blocked by` references.",
-          "items": {
-            "$ref": "#/$defs/slug",
-            "description": "Slug of a sibling Story that must close before this Story may dispatch."
-          },
-          "uniqueItems": true
-        },
-        "labels": {
-          "$ref": "#/$defs/labels",
-          "description": "Structural labels attached to this Story (e.g. type::story, persona::*). agent::* labels are forbidden — they are owned by the wave-runner at dispatch time."
-        },
-        "acceptance": {
-          "type": "array",
-          "description": "Inline acceptance criteria for this Story. Each entry is a single user-visible acceptance statement that the Story-level agent must satisfy. Acts as the Story-level outcome contract that the Story sub-agent treats as the Goal/Changes/Acceptance/Verify surface.",
-          "items": {
-            "type": "string",
-            "minLength": 1,
-            "description": "A single acceptance criterion expressed as a user-visible outcome (e.g. 'A Story object containing inline acceptance[] validates against the schema')."
-          }
-        },
-        "verify": {
-          "type": "array",
-          "description": "Inline verification commands for this Story. Each entry is a shell-runnable command (typically a contract test invocation) that proves the corresponding acceptance[] entries hold.",
-          "items": {
-            "type": "string",
-            "minLength": 1,
-            "description": "A single verification command (e.g. 'node --test tests/scripts/epic-spec-schema.test.js')."
-          }
-        }
-      }
-    },
-    "gates": {
-      "type": "object",
-      "additionalProperties": false,
-      "description": "Optional references to baseline + gate-config slugs. Carried in the spec so structural changes can be reviewed alongside the quality-gate config that will run against them. Resolved to baseline-service inputs by the existing baseline subsystem; opaque to the reconciler itself.",
-      "properties": {
-        "baseline": {
-          "type": "string",
-          "minLength": 1,
-          "description": "Slug naming the baseline ratchet snapshot this Epic targets (e.g. ratchet-baseline-2026-05-12). The baseline subsystem resolves this to concrete lint/mi/crap baseline files at close-validation time."
-        },
-        "config": {
-          "type": "string",
-          "minLength": 1,
-          "description": "Slug naming the gate-config version this Epic uses (e.g. gate-config-v6). Allows different Epics to opt into different gate configurations during long-lived migrations."
-        }
-      }
-    }
-  }
-}

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