mandrel 2.37.0 → 2.38.0

package/.agents/scripts/lib/config/runners.js

@@ -23,7 +23,7 @@ export const DEFAULT_DECOMPOSER = Object.freeze({
  * the GitHub API with concurrent label writes, while still allowing a
  * small ready-set fan-out. Operators who want strictly sequential delivery
  * should set `delivery.deliverRunner.concurrencyCap: 1`. Raising the cap
- * reduces wall-clock time where dependencies allow. See `deliver.md` and
+ * reduces wall-clock time where dependencies allow. See `mandrel-deliver.md` and
  * `agentrc-reference.json` `delivery.deliverRunner.concurrencyCap`.
  *
  * Story #4545 removed the sibling `verifyConcurrencyCap`: the
@@ -46,7 +46,7 @@ const DEFAULT_DELIVER_RUNNER = Object.freeze({
 });
 
 /**
- * Default auto-fix loop ceilings for /deliver code-review. Operators
+ * Default auto-fix loop ceilings for /mandrel-deliver code-review. Operators
  * override via `delivery.codeReview.*` in `.agentrc.json` (Story #2611,
  * Epic #2586; `autoFixSeverity` default `'medium'` per Story #4399).
  */

package/.agents/scripts/lib/config/runtime.js

@@ -77,7 +77,7 @@ export function resolveWorkingPath({
 
 /**
  * One-shot environment-aware runtime resolution. Returns the trio of runtime
- * signals consumed across `/deliver`: whether worktree isolation is on
+ * signals consumed across `/mandrel-deliver`: whether worktree isolation is on
  * for this process, the session id for claim labels, and whether we're in a
  * Claude Code web session. Each signal also records its **source** so the
  * `story-init` startup log can name why the value is what it is.

package/.agents/scripts/lib/config/temp-paths.js

@@ -41,7 +41,7 @@
  * parent of `git rev-parse --git-common-dir`) rather than `process.cwd()`.
  * Without this, a story child that `cd`s into `.worktrees/story-<id>/` before
  * emitting a lifecycle record would append it to
- * `<worktree>/temp/run-N/lifecycle.ndjson`, while the `/deliver` host
+ * `<worktree>/temp/run-N/lifecycle.ndjson`, while the `/mandrel-deliver` host
  * (running from the main checkout) reads the main-checkout copy — so the
  * host never sees the child's records (the audit-#3513 bug class; its
  * original `story.heartbeat` instance is gone with that emitter, but the
@@ -372,7 +372,7 @@ function storyTerminalEnvelopeName(sid) {
  * `close-gates-<sid>.log`, and `deliver-recover.js` reads the pair together to
  * tell a finished close from a live one. Sharing `orchestrationLogDir` also
  * means it inherits main-checkout anchoring for free — the close runs inside
- * `.worktrees/story-<sid>/` while the `/deliver` host reads from the main
+ * `.worktrees/story-<sid>/` while the `/mandrel-deliver` host reads from the main
  * checkout, and an un-anchored path would put the envelope somewhere the
  * router never looks.
  *

package/.agents/scripts/lib/config-settings-schema-delivery.js

@@ -66,13 +66,13 @@ const DOCS_FRESHNESS_SCHEMA = {
  */
 const DELIVER_RUNNER_SCHEMA = {
   type: 'object',
-  description: 'Bounded-concurrency knob for the /deliver fan-out.',
+  description: 'Bounded-concurrency knob for the /mandrel-deliver fan-out.',
   properties: {
     concurrencyCap: {
       type: 'integer',
       minimum: 1,
       description:
-        'Maximum ready Stories dispatched by /deliver at once. Default 3. Moderate by design — keeps host-quota consumption predictable while allowing a small ready-set fan-out. Set 1 for strictly sequential delivery; raise further on hosts with adequate parallel-agent quota. See deliver.md for the sequencing model and throughput tradeoff.',
+        'Maximum ready Stories dispatched by /mandrel-deliver at once. Default 3. Moderate by design — keeps host-quota consumption predictable while allowing a small ready-set fan-out. Set 1 for strictly sequential delivery; raise further on hosts with adequate parallel-agent quota. See deliver.md for the sequencing model and throughput tradeoff.',
       // getRunners() resolves this from its own DEFAULT_DELIVER_RUNNER
       // constant, not from this annotation; the parity suite asserts the two
       // agree.
@@ -637,7 +637,7 @@ const TEMP_RETENTION_SCHEMA = {
 export const DELIVERY_SCHEMA = {
   type: 'object',
   description:
-    'Everything `/deliver` and `single-story-close` consume: execution timeouts, worktree isolation, runner concurrency, docs freshness, signals, quality gates, merge/CI watch, review ceremony, and the feedback loop.',
+    'Everything `/mandrel-deliver` and `single-story-close` consume: execution timeouts, worktree isolation, runner concurrency, docs freshness, signals, quality gates, merge/CI watch, review ceremony, and the feedback loop.',
   properties: {
     execution: EXECUTION_SCHEMA,
     docsFreshness: DOCS_FRESHNESS_SCHEMA,

package/.agents/scripts/lib/config-settings-schema-quality.js

@@ -223,7 +223,7 @@ export const QUALITY_SCHEMA = {
     navigability: {
       type: 'object',
       description:
-        "Navigability lens + journey-suite config (Epic #4131, F2/F3/F1/F4). Read by audit-suite/selector.js (route globs) and /deliver's per-Story ceremony (journey suite). Opt-in: absent or empty routeGlobs degrades to a silent no-op.",
+        "Navigability lens + journey-suite config (Epic #4131, F2/F3/F1/F4). Read by audit-suite/selector.js (route globs) and /mandrel-deliver's per-Story ceremony (journey suite). Opt-in: absent or empty routeGlobs degrades to a silent no-op.",
       properties: {
         routeGlobs: {
           type: 'array',
@@ -242,7 +242,7 @@ export const QUALITY_SCHEMA = {
         journeySuite: {
           type: 'string',
           description:
-            "Path or command for the per-persona journey suite /deliver's per-Story ceremony runs.",
+            "Path or command for the per-persona journey suite /mandrel-deliver's per-Story ceremony runs.",
         },
       },
       additionalProperties: false,
@@ -253,7 +253,7 @@ export const QUALITY_SCHEMA = {
 
 /**
  * `delivery.codeReview` — review-provider chain + bounded-retry knobs for
- * the /deliver code-review ceremony (Story-close and plan-run close).
+ * the /mandrel-deliver code-review ceremony (Story-close and plan-run close).
  *
  * `autoFixSeverity` (Story #4399) is the threshold that governs which
  * findings the host-LLM focused-fix routing remediates on-branch —
@@ -263,7 +263,7 @@ export const QUALITY_SCHEMA = {
 export const CODE_REVIEW_SCHEMA = {
   type: 'object',
   description:
-    'Review-provider chain plus bounded-retry knobs for the /deliver code-review ceremony.',
+    'Review-provider chain plus bounded-retry knobs for the /mandrel-deliver code-review ceremony.',
   properties: {
     // Story #2825 (Epic #2815) seeded the pluggable review backend
     // with `native`; Story #2830 added `codex` (the
@@ -353,7 +353,7 @@ export const CODE_REVIEW_SCHEMA = {
       type: 'integer',
       minimum: 0,
       description:
-        'Maximum auto-fix retry attempts per finding in /deliver Phase 5 (code-review). 0 disables auto-fix. Default 3.',
+        'Maximum auto-fix retry attempts per finding in /mandrel-deliver Phase 5 (code-review). 0 disables auto-fix. Default 3.',
       default: DEFAULT_CODE_REVIEW.maxFixAttempts,
     },
     maxFixScopeFiles: {
@@ -367,7 +367,7 @@ export const CODE_REVIEW_SCHEMA = {
       type: 'string',
       enum: ['high', 'medium'],
       description:
-        'Severity threshold for on-branch remediation in /deliver Phase 5 (code-review). `medium` (default) routes 🔴/🟠/🟡 findings into the host-LLM focused-fix routing (Mediums batched per lens: one commit per lens, a single validation + rescan at the end) while 🟢 suggestions still graduate to follow-up issues; `high` reproduces the pre-4399 Critical/High-only routing. Hard cutover — no back-compat flag.',
+        'Severity threshold for on-branch remediation in /mandrel-deliver Phase 5 (code-review). `medium` (default) routes 🔴/🟠/🟡 findings into the host-LLM focused-fix routing (Mediums batched per lens: one commit per lens, a single validation + rescan at the end) while 🟢 suggestions still graduate to follow-up issues; `high` reproduces the pre-4399 Critical/High-only routing. Hard cutover — no back-compat flag.',
       default: DEFAULT_CODE_REVIEW.autoFixSeverity,
     },
   },

package/.agents/scripts/lib/config-settings-schema.js

@@ -432,7 +432,7 @@ const GITHUB_SCHEMA = {
 };
 
 // ---------------------------------------------------------------------------
-// planning.* — inputs to /plan
+// planning.* — inputs to /mandrel-plan
 // ---------------------------------------------------------------------------
 
 // Story #4541: `planning.context.{maxBytes, summaryMode}` was retired. The
@@ -456,7 +456,7 @@ const GITHUB_SCHEMA = {
 const PLANNING_SCHEMA = {
   type: 'object',
   description:
-    'Inputs to `/plan`: risk escalation heuristics, ceremony-lite routing, and the cross-Story conflict-finding severity gates.',
+    'Inputs to `/mandrel-plan`: risk escalation heuristics, ceremony-lite routing, and the cross-Story conflict-finding severity gates.',
   properties: {
     riskHeuristics: {
       ...LIST_OR_EXTENDER_OF_STRINGS,
@@ -591,7 +591,7 @@ const PLANNING_SCHEMA = {
 };
 
 // ---------------------------------------------------------------------------
-// delivery.* — /deliver + story-deliver consume. The full block of
+// delivery.* — /mandrel-deliver + story-deliver consume. The full block of
 // per-key sub-schemas lives in `config-settings-schema-delivery.js` (refs
 // #3457); DELIVERY_SCHEMA is imported above and referenced unchanged below.
 // ---------------------------------------------------------------------------

package/.agents/scripts/lib/duplicate-search.js

@@ -1,7 +1,7 @@
 /**
  * duplicate-search.js — Cross-Story Duplicate Detection
  *
- * Used by `/plan` to surface open Stories whose scope overlaps with a
+ * Used by `/mandrel-plan` to surface open Stories whose scope overlaps with a
  * seed / seed-file / tickets corpus before new Stories are created.
  * Returns ranked candidates with an overlap score and URL so the host
  * LLM can pause for HITL confirmation.

package/.agents/scripts/lib/feedback-loop/prior-feedback-fetcher.js

@@ -1,6 +1,6 @@
 /**
  * prior-feedback-fetcher.js — gh-CLI-backed fetcher for open meta feedback
- * issues that feed the `/plan` Phase 0 planner context.
+ * issues that feed the `/mandrel-plan` Phase 0 planner context.
  *
  * Story #2554 / Epic #2547. Tech Spec #2550 specifies that the fetcher MUST
  * return open issues carrying the `meta::framework-gap` and
@@ -17,8 +17,8 @@
  * `recurringDefectClasses[]` array derived from the `friction::<class>`
  * labels the retro routed-proposals composer stamps onto the meta issues it
  * proposes. That closes the retro→planner loop: a recurring defect class
- * caught by review/deliver is filed as a `meta::*` + `friction::<class>`
- * issue, and the next `/plan` Phase 0 surfaces the class (with a recurrence
+ * caught by review/mandrel-deliver is filed as a `meta::*` + `friction::<class>`
+ * issue, and the next `/mandrel-plan` Phase 0 surfaces the class (with a recurrence
  * count across the open feedback issues) to the decompose-author guidance so
  * the planning floor ratchets up. The derivation is no-op-safe: issues with
  * no `friction::*` label contribute nothing and the array is empty.
@@ -297,7 +297,7 @@ export async function fetchPriorFeedback({
 
   // Story #4135 (Epic #4131, F11) — close the retro→planner loop: derive the
   // recurring defect classes from the `friction::<class>` labels carried by
-  // the deduped feedback issues, so the next /plan Phase 0 surfaces them to
+  // the deduped feedback issues, so the next /mandrel-plan Phase 0 surfaces them to
   // the decompose-author guidance. No-op-safe when no issue carries a
   // `friction::*` label (empty array, no behavioural change).
   envelope.recurringDefectClasses = extractRecurringDefectClasses([

package/.agents/scripts/lib/feedback-loop/retro-proposals-graduator.js

@@ -6,7 +6,7 @@
  * (`retro-proposals.js`) already split the Epic's source-tagged friction
  * into `framework` / `consumer` actionable items, each carrying a
  * pre-drafted `gh issue create` command stanza. Historically an operator
- * had to copy-paste those stanzas by hand, so `/plan` Phase 0's
+ * had to copy-paste those stanzas by hand, so `/mandrel-plan` Phase 0's
  * `recurringDefectClasses` stayed empty unless someone remembered to run
  * the commands. This module files them mechanically instead — the retro
  * body then lists the real filed issue numbers rather than paste-ready

package/.agents/scripts/lib/findings/classify-finding.js

@@ -51,7 +51,7 @@ export const FINDING_CLASSES = Object.freeze([
 /**
  * Class → label-set routing table. Each class maps to exactly one label set.
  * `tooling-dx` is the framework-gap path: it carries `meta::framework-gap` so
- * the `/plan` Phase 0 feedback fetcher surfaces it to the planner.
+ * the `/mandrel-plan` Phase 0 feedback fetcher surfaces it to the planner.
  */
 const CLASS_TO_LABELS = Object.freeze({
   'product-bug': [FOCUS_LABELS.PRODUCT],

package/.agents/scripts/lib/findings/promote-finding.js

@@ -5,8 +5,8 @@
  * tail of the exploratory-QA Triage path: once an operator has dispositioned a
  * session's ledger items (see `.agents/schemas/qa-ledger.schema.json` and
  * `lib/qa/qa-session.js`), the still-untriaged backlog is clustered and each
- * cluster is promoted to a follow-up ticket — a single Story (via `/plan`)
- * for a tight, one-deliverable cluster, or a multi-Story plan-seed (via `/plan --seed`) for
+ * cluster is promoted to a follow-up ticket — a single Story (via `/mandrel-plan`)
+ * for a tight, one-deliverable cluster, or a multi-Story plan-seed (via `/mandrel-plan --seed`) for
  * a broad cluster that spans multiple coverage surfaces. Each contributing
  * ledger item then has the resulting `routedTo` issue link written back onto it
  * so a resume run sees the item as filed rather than re-promoting it.
@@ -23,7 +23,7 @@
  * Pure orchestration: **no network I/O lives here.** Every GitHub side-effect
  * (issue search, ticket creation) flows through INJECTED PORTS so the unit test
  * runs with no network. Production wires the ports to the GitHub provider /
- * `/plan` / `/plan` surfaces; tests pass in-memory stubs.
+ * `/mandrel-plan` / `/mandrel-plan` surfaces; tests pass in-memory stubs.
  */
 
 import { fingerprintFinding, routeFinding } from './route-finding.js';
@@ -35,8 +35,8 @@ const TRIAGED_DISPOSITIONS = Object.freeze(['file', 'defer', 'dismiss']);
 /**
  * The two promotion targets a cluster routes to.
  *
- * `PLAN_SEED` promotes a broad cluster by seeding a multi-Story `/plan`
- * run (`/plan --seed`). Its persisted wire token is the legacy string
+ * `PLAN_SEED` promotes a broad cluster by seeding a multi-Story `/mandrel-plan`
+ * run (`/mandrel-plan --seed`). Its persisted wire token is the legacy string
  * `'epic'`: archived qa-ledger records (and the distributed
  * `qa-ledger.schema.json` `routedTo.kind` enum) still carry `'epic'`, so
  * the value is kept read-compatible while the write-side constant name is
@@ -49,8 +49,8 @@ export const PROMOTION_TARGETS = Object.freeze({
 
 /**
  * A cluster of more than this many distinct coverage surfaces is broad enough
- * to warrant a plan-seed (`/plan --seed`) rather than a single Story
- * (`/plan`). One or two surfaces is a tight, single-deliverable cluster.
+ * to warrant a plan-seed (`/mandrel-plan --seed`) rather than a single Story
+ * (`/mandrel-plan`). One or two surfaces is a tight, single-deliverable cluster.
  */
 const EPIC_COVERAGE_THRESHOLD = 2;
 
@@ -168,8 +168,8 @@ export function clusterLedgerItems(items) {
 /**
  * Decide a cluster's promotion target. A cluster that spans more than
  * {@link EPIC_COVERAGE_THRESHOLD} distinct coverage surfaces is broad enough to
- * warrant a plan-seed (`/plan --seed`); otherwise it is a single-deliverable
- * Story (`/plan`).
+ * warrant a plan-seed (`/mandrel-plan --seed`); otherwise it is a single-deliverable
+ * Story (`/mandrel-plan`).
  *
  * @param {{ coverages: string[] }} cluster
  * @returns {'story'|'epic'}
@@ -242,7 +242,7 @@ function routedToLink(issue, kind) {
  *      shared `routeFinding` against existing Issues (via the injected search
  *      port). This dedups against work already filed.
  *   2. On a `new` decision, open the follow-up ticket through the injected
- *      `createStory` (`/plan`) or `createPlanSeed` (`/plan --seed`) port,
+ *      `createStory` (`/mandrel-plan`) or `createPlanSeed` (`/mandrel-plan --seed`) port,
  *      chosen by {@link targetForCluster}. On any other decision, link back to
  *      the matched Issue rather than creating a duplicate.
  *   3. Stamp the resolved `routedTo` link onto every contributing ledger item
@@ -259,9 +259,9 @@ function routedToLink(issue, kind) {
  * @param {(finding: object) => Promise<Array<{ number: number, state: string, title?: string, body?: string }>>} [ports.searchCandidates]
  *   Optional semantic candidate search, forwarded to `routeFinding`.
  * @param {(cluster: object) => Promise<{ number: number, url?: string }>} ports.createStory
- *   Opens a single Story (`/plan`) for a tight cluster.
+ *   Opens a single Story (`/mandrel-plan`) for a tight cluster.
  * @param {(cluster: object) => Promise<{ number: number, url?: string }>} ports.createPlanSeed
- *   Opens a plan-seed (`/plan --seed`) run for a broad cluster.
+ *   Opens a plan-seed (`/mandrel-plan --seed`) run for a broad cluster.
  * @returns {Promise<{
  *   promotions: Array<{
  *     clusterKey: string,

package/.agents/scripts/lib/findings/route-finding.js

@@ -249,9 +249,9 @@ function parseAllFooterValues(text, pattern, isValid) {
  * Carry audit dedup provenance from a source document into a target body
  * (Story #4877).
  *
- * The audit sweep's Single-plan path emits a `/plan` seed whose MVP Scope
+ * The audit sweep's Single-plan path emits a `/mandrel-plan` seed whose MVP Scope
  * bullets already carry the `audit-fingerprints` / `audit-semantic-keys`
- * footers (Story #4626). Nothing then copied them into the Story `/plan`
+ * footers (Story #4626). Nothing then copied them into the Story `/mandrel-plan`
  * actually persisted, so the recommended path filed Stories that the next
  * sweep could not recognise and re-filed as new. It was left to the authoring
  * agent to notice HTML comments in a one-pager and hand-carry them — a