@entelligentsia/forgecli 0.11.2 → 0.15.0

package/dist/extensions/forgecli/lib/store-error-remediation.d.ts

@@ -0,0 +1,65 @@
+export interface RemediationResult {
+    /** One-line user-facing hint explaining the error and the fix. */
+    hint: string;
+    /** Optional copy-pasteable store-cli command. Empty string if N/A. */
+    command: string;
+}
+/**
+ * Infer the entity type from an entity name/ID string.
+ * Returns "task" as default if no match.
+ */
+export declare function inferEntityType(entity: string): string;
+/** Parsed breakdown of a validation error string. */
+interface ParsedError {
+    field: string;
+    errorKind: "enum" | "required" | "undeclared" | "type" | "pattern" | "datetime" | "length" | "other";
+    observed?: string;
+    enumValues?: string[];
+}
+/**
+ * Parse a single validation error line from validate.js / store-cli.
+ *
+ * Examples:
+ *   'status: value "verified" not in [reported, triaged, in-progress, fixed]'
+ *   'taskId: missing required field'
+ *   'xyz: undeclared field'
+ *   'sprintId: expected string, got number'
+ *   'title: value length 0 is below minLength 1'
+ *   'createdAt: value "today" is not a valid date-time'
+ *   'prefix: value "AB" does not match pattern ^[A-Z]+-[A-Z]$'
+ */
+export declare function parseValidationError(line: string): ParsedError;
+/**
+ * Given a single validation error line (from validate.js or store-cli),
+ * return a user-facing remediation hint and optional copy-pasteable command.
+ *
+ * @param errorLine  A single error line from validate.js / store-cli output.
+ * @param entityType  The entity type (task, sprint, bug, feature, event).
+ * @param entityId   The entity ID (e.g. "FORGE-S18-T02") — used for commands.
+ * @returns          RemediationResult with hint and command.
+ */
+export declare function remediateError(errorLine: string, entityType: string, entityId: string): RemediationResult;
+/**
+ * Parse a multi-line validation output (e.g. from store-cli validate or
+ * validate-store --dry-run) into individual error lines and return
+ * remediation for each.
+ *
+ * @param output    Raw multi-line output from validation tool.
+ * @param entityType Override entity type (inferred from output if not provided).
+ * @returns         Array of { errorLine, remediation } objects.
+ */
+export declare function remediateValidationOutput(output: string, entityType?: string): Array<{
+    errorLine: string;
+    remediation: RemediationResult;
+}>;
+/**
+ * Format a block message for a write-guard violation, appending remediation hints.
+ * Used by hook-dispatcher.ts for store-cli intercept blocks.
+ *
+ * @param rawReason  The raw reason string from validateStoreCLIPayload or checkWriteGuard.
+ * @param entityType  The entity type if known.
+ * @param entityId   The entity ID if known.
+ * @returns          Enhanced reason string with remediation hints appended.
+ */
+export declare function enhanceBlockMessage(rawReason: string, entityType?: string, entityId?: string): string;
+export {};

package/dist/extensions/forgecli/lib/store-error-remediation.js

@@ -0,0 +1,298 @@
+// Store-error remediation — forge-cli#24
+//
+// Shared remediation-hint surface for store validation errors.
+// Consumed by:
+//   - health-check.ts (per-error row in store-integrity output)
+//   - hooks/write-guard.ts (block-message body for schema violations)
+//   - hook-dispatcher.ts (store-cli intercept block messages)
+//   - store-validator.ts (structured result for hook callers)
+//
+// Error sources:
+//   1. validate.js (in-process via write-guard) — produces error strings like:
+//        "status: value "verified" not in [reported, triaged, in-progress, fixed]"
+//        "taskId: missing required field"
+//        "xyz: undeclared field"
+//   2. store-cli.cjs validate (subprocess via store-validator.ts) — same format,
+//      piped through stderr.
+//   3. validate-store.cjs --dry-run (subprocess via health-check.ts) — lines like:
+//        "ERROR  FORGE-S18-T02: status: value "verified" not in [reported, triaged, ...]"
+//        "WARN   FORGE-S18-T02: ..."
+//
+// This module parses those formats and returns a one-line user-facing hint
+// plus an optional copy-pasteable store-cli command.
+// ── Entity-type inference from entity name / ID ────────────────────────────────
+/** Map entity type to the corresponding schema's status enum values. */
+const STATUS_ENUMS = {
+    task: [
+        "draft", "planned", "plan-approved", "implementing", "implemented",
+        "review-approved", "approved", "committed", "plan-revision-required",
+        "code-revision-required", "blocked", "escalated", "abandoned",
+    ],
+    sprint: [
+        "planning", "active", "completed", "retrospective-done",
+        "partially-completed", "blocked", "abandoned",
+    ],
+    bug: ["reported", "triaged", "in-progress", "fixed"],
+    feature: ["proposed", "accepted", "in-progress", "delivered", "declined"],
+    event: [], // no status field
+};
+/** Known entity types that support write via store-cli. */
+const ENTITY_TYPES = new Set(["task", "sprint", "bug", "feature", "event"]);
+/**
+ * Infer the entity type from an entity name/ID string.
+ * Returns "task" as default if no match.
+ */
+export function inferEntityType(entity) {
+    const lower = entity.toLowerCase();
+    // Bug patterns: BUG-015, FORGE-BUG-015, bug-031
+    if (/\bbug/i.test(entity))
+        return "bug";
+    // Sprint patterns: S18 (standalone), sprint-01 — but NOT inside task IDs like FORGE-S18-T02
+    if (/^[A-Z]+-S\d+$/i.test(entity) || /\bsprint/i.test(entity))
+        return "sprint";
+    // Feature patterns: FORGE-F01
+    if (/\bf\d+\b/i.test(entity) || lower.includes("feat"))
+        return "feature";
+    // Event patterns
+    if (lower.includes("event"))
+        return "event";
+    // Task IDs: FORGE-S18-T02, PROJECT-T01
+    if (/\bt\d+\b/i.test(entity))
+        return "task";
+    // Default
+    return "task";
+}
+const STATUS_REMEDIATION = {
+    hint: "Set status to one of the legal values for this entity type.",
+    command: (entityType, entityId) => `node "$FORGE_ROOT/tools/store-cli.cjs" update-status ${entityType} ${entityId} status <legal-value>`,
+};
+const REQUIRED_FIELD_REMEDIATION = {
+    hint: "Add the missing field with a valid value. Use the template command to see the canonical shape.",
+    command: (entityType, _entityId) => `node "$FORGE_ROOT/tools/store-cli.cjs" template ${entityType}`,
+};
+const UNDECLARED_FIELD_REMEDIATION = {
+    hint: "Remove the undeclared field, or check the schema for the correct property name.",
+    command: (entityType, _entityId) => `node "$FORGE_ROOT/tools/store-cli.cjs" describe ${entityType}`,
+};
+const TYPE_MISMATCH_REMEDIATION = {
+    hint: "Use the correct type for this field. Use the describe command to see the expected type.",
+    command: (entityType, _entityId) => `node "$FORGE_ROOT/tools/store-cli.cjs" describe ${entityType}`,
+};
+const PATTERN_REMEDIATION = {
+    hint: "The value must match the expected pattern (e.g. a date-time or ID format).",
+    command: (entityType, _entityId) => `node "$FORGE_ROOT/tools/store-cli.cjs" describe ${entityType}`,
+};
+const DATE_TIME_REMEDIATION = {
+    hint: "Use an ISO 8601 date-time string (e.g. 2026-05-21T12:00:00Z).",
+    command: (entityType, _entityId) => `node "$FORGE_ROOT/tools/store-cli.cjs" describe ${entityType}`,
+};
+const LENGTH_REMEDIATION = {
+    hint: "Adjust the value length to satisfy the schema constraint.",
+    command: (entityType, _entityId) => `node "$FORGE_ROOT/tools/store-cli.cjs" describe ${entityType}`,
+};
+/**
+ * Parse a single validation error line from validate.js / store-cli.
+ *
+ * Examples:
+ *   'status: value "verified" not in [reported, triaged, in-progress, fixed]'
+ *   'taskId: missing required field'
+ *   'xyz: undeclared field'
+ *   'sprintId: expected string, got number'
+ *   'title: value length 0 is below minLength 1'
+ *   'createdAt: value "today" is not a valid date-time'
+ *   'prefix: value "AB" does not match pattern ^[A-Z]+-[A-Z]$'
+ */
+export function parseValidationError(line) {
+    // Enum violation: 'field: value "X" not in [a, b, c]'
+    const enumMatch = line.match(/^(\w+):\s+value\s+"([^"]+)"\s+not in \[([^\]]+)\]/);
+    if (enumMatch) {
+        return {
+            field: enumMatch[1],
+            errorKind: "enum",
+            observed: enumMatch[2],
+            enumValues: enumMatch[3].split(",").map((s) => s.trim()),
+        };
+    }
+    // Required field: 'field: missing required field'
+    if (/\bmissing required field\b/.test(line)) {
+        const fieldMatch = line.match(/^(\w+):/);
+        return { field: fieldMatch?.[1] ?? "unknown", errorKind: "required" };
+    }
+    // Undeclared field: 'xyz: undeclared field'
+    if (/\bundeclared field\b/.test(line)) {
+        const fieldMatch = line.match(/^(\w+):/);
+        return { field: fieldMatch?.[1] ?? "unknown", errorKind: "undeclared" };
+    }
+    // Type mismatch: 'field: expected string, got number'
+    const typeMatch = line.match(/^(\w+):\s+expected\s+\S+,?\s+got\s+\S+/);
+    if (typeMatch) {
+        return { field: typeMatch[1], errorKind: "type" };
+    }
+    // Date-time format: 'field: value "..." is not a valid date-time'
+    if (/\bis not a valid date-time\b/.test(line)) {
+        const fieldMatch = line.match(/^(\w+):/);
+        return { field: fieldMatch?.[1] ?? "unknown", errorKind: "datetime" };
+    }
+    // Pattern mismatch: 'field: value "..." does not match pattern ...'
+    if (/\bdoes not match pattern\b/.test(line)) {
+        const fieldMatch = line.match(/^(\w+):/);
+        return { field: fieldMatch?.[1] ?? "unknown", errorKind: "pattern" };
+    }
+    // Length violations
+    if (/\blength\b.*\b(exceeds|below)\b/.test(line) || /\b(exceeds|below)\b.*\blength\b/.test(line)) {
+        const fieldMatch = line.match(/^(\w+):/);
+        return { field: fieldMatch?.[1] ?? "unknown", errorKind: "length" };
+    }
+    // Generic: capture leading field name if present
+    const genericMatch = line.match(/^(\w+):/);
+    return { field: genericMatch?.[1] ?? "unknown", errorKind: "other" };
+}
+// ── Public API ──────────────────────────────────────────────────────────────────
+/**
+ * Given a single validation error line (from validate.js or store-cli),
+ * return a user-facing remediation hint and optional copy-pasteable command.
+ *
+ * @param errorLine  A single error line from validate.js / store-cli output.
+ * @param entityType  The entity type (task, sprint, bug, feature, event).
+ * @param entityId   The entity ID (e.g. "FORGE-S18-T02") — used for commands.
+ * @returns          RemediationResult with hint and command.
+ */
+export function remediateError(errorLine, entityType, entityId) {
+    const parsed = parseValidationError(errorLine);
+    switch (parsed.errorKind) {
+        case "enum": {
+            const legalValues = STATUS_ENUMS[entityType] ?? parsed.enumValues ?? [];
+            const isStatusField = parsed.field === "status" || parsed.field.toLowerCase().includes("status");
+            if (isStatusField && legalValues.length > 0) {
+                return {
+                    hint: `"${parsed.observed}" is not a legal ${entityType} status. Legal values: ${legalValues.join(", ")}.`,
+                    command: `node "$FORGE_ROOT/tools/store-cli.cjs" update-status ${entityType} ${entityId} status <${legalValues.join("|")}>`,
+                };
+            }
+            if (legalValues.length > 0) {
+                return {
+                    hint: `Invalid value for "${parsed.field}". Allowed: ${legalValues.join(", ")}.`,
+                    command: `node "$FORGE_ROOT/tools/store-cli.cjs" template ${entityType}`,
+                };
+            }
+            return {
+                hint: STATUS_REMEDIATION.hint,
+                command: STATUS_REMEDIATION.command(entityType, entityId),
+            };
+        }
+        case "required":
+            return {
+                hint: REQUIRED_FIELD_REMEDIATION.hint,
+                command: REQUIRED_FIELD_REMEDIATION.command(entityType, entityId),
+            };
+        case "undeclared":
+            return {
+                hint: UNDECLARED_FIELD_REMEDIATION.hint,
+                command: UNDECLARED_FIELD_REMEDIATION.command(entityType, entityId),
+            };
+        case "type":
+            return {
+                hint: TYPE_MISMATCH_REMEDIATION.hint,
+                command: TYPE_MISMATCH_REMEDIATION.command(entityType, entityId),
+            };
+        case "datetime":
+            return {
+                hint: DATE_TIME_REMEDIATION.hint,
+                command: DATE_TIME_REMEDIATION.command(entityType, entityId),
+            };
+        case "pattern":
+            return {
+                hint: PATTERN_REMEDIATION.hint,
+                command: PATTERN_REMEDIATION.command(entityType, entityId),
+            };
+        case "length":
+            return {
+                hint: LENGTH_REMEDIATION.hint,
+                command: LENGTH_REMEDIATION.command(entityType, entityId),
+            };
+        case "other":
+        default:
+            return {
+                hint: "Check the schema for the expected shape.",
+                command: `node "$FORGE_ROOT/tools/store-cli.cjs" template ${entityType}`,
+            };
+    }
+}
+/**
+ * Parse a multi-line validation output (e.g. from store-cli validate or
+ * validate-store --dry-run) into individual error lines and return
+ * remediation for each.
+ *
+ * @param output    Raw multi-line output from validation tool.
+ * @param entityType Override entity type (inferred from output if not provided).
+ * @returns         Array of { errorLine, remediation } objects.
+ */
+export function remediateValidationOutput(output, entityType) {
+    const lines = output
+        .split("\n")
+        .map((l) => l.trim())
+        .filter((l) => l.length > 0);
+    const results = [];
+    for (const line of lines) {
+        // Strip "ERROR" / "WARN" prefix from validate-store --dry-run output
+        const cleaned = line.replace(/^(ERROR|WARN)\s+/, "");
+        if (!cleaned)
+            continue;
+        // Extract entity ID from lines like "FORGE-S18-T02: status: ..."
+        const entityIdMatch = cleaned.match(/^([A-Z]+-S?\d+-T?\d+|[A-Z]+-BUG-\d+|[A-Z]+-F\d+):/);
+        const entityId = entityIdMatch?.[1] ?? "unknown";
+        // If entity type not overridden, try to infer
+        const inferredType = entityType ?? inferEntityType(entityId);
+        // Skip non-error lines (hint lines from validate.js, blank lines, etc.)
+        if (cleaned.startsWith("(") || cleaned.startsWith("hint:") || cleaned.startsWith("#")) {
+            continue;
+        }
+        // Skip lines that are just an entity name without an error field
+        // (the real error is on the same line after the entity prefix)
+        const errorPart = entityIdMatch ? cleaned.slice(entityIdMatch[0].length).trim() : cleaned;
+        if (!errorPart || errorPart.length < 3)
+            continue;
+        results.push({
+            errorLine: cleaned,
+            remediation: remediateError(errorPart, inferredType, entityId),
+        });
+    }
+    return results;
+}
+/**
+ * Format a block message for a write-guard violation, appending remediation hints.
+ * Used by hook-dispatcher.ts for store-cli intercept blocks.
+ *
+ * @param rawReason  The raw reason string from validateStoreCLIPayload or checkWriteGuard.
+ * @param entityType  The entity type if known.
+ * @param entityId   The entity ID if known.
+ * @returns          Enhanced reason string with remediation hints appended.
+ */
+export function enhanceBlockMessage(rawReason, entityType, entityId) {
+    // Parse the raw reason into lines and try to add remediation to each error line.
+    const lines = rawReason.split("\n");
+    const enhanced = [];
+    for (const line of lines) {
+        // Strip leading list markers and bullet points
+        const stripped = line.replace(/^\s*[-•]\s*/, "").trim();
+        // Check if this line contains a recognizable validation error pattern
+        const parsed = parseValidationError(stripped);
+        // Also match lines that contain validation error patterns not caught by parseValidationError
+        const hasKnownError = parsed.errorKind !== "other" || /\bmissing required\b|\bnot in \[|\bundeclared\b|\bexpected\b.*\bgot\b/.test(stripped);
+        if (hasKnownError) {
+            const type = entityType ?? "task";
+            const id = entityId ?? "unknown";
+            const remediation = remediateError(stripped, type, id);
+            enhanced.push(line);
+            enhanced.push(`  💡 ${remediation.hint}`);
+            if (remediation.command) {
+                enhanced.push(`  → ${remediation.command}`);
+            }
+        }
+        else {
+            enhanced.push(line);
+        }
+    }
+    return enhanced.join("\n");
+}
+//# sourceMappingURL=store-error-remediation.js.map

package/dist/extensions/forgecli/lib/store-error-remediation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-error-remediation.js","sourceRoot":"","sources":["../../../../src/extensions/forgecli/lib/store-error-remediation.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,EAAE;AACF,+DAA+D;AAC/D,eAAe;AACf,gEAAgE;AAChE,sEAAsE;AACtE,8DAA8D;AAC9D,8DAA8D;AAC9D,EAAE;AACF,iBAAiB;AACjB,+EAA+E;AAC/E,mFAAmF;AACnF,0CAA0C;AAC1C,iCAAiC;AACjC,iFAAiF;AACjF,6BAA6B;AAC7B,mFAAmF;AACnF,0FAA0F;AAC1F,qCAAqC;AACrC,EAAE;AACF,2EAA2E;AAC3E,qDAAqD;AAWrD,kFAAkF;AAElF,wEAAwE;AACxE,MAAM,YAAY,GAAsC;IACvD,IAAI,EAAE;QACL,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,cAAc,EAAE,aAAa;QAClE,iBAAiB,EAAE,UAAU,EAAE,WAAW,EAAE,wBAAwB;QACpE,wBAAwB,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW;KAC7D;IACD,MAAM,EAAE;QACP,UAAU,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB;QACvD,qBAAqB,EAAE,SAAS,EAAE,WAAW;KAC7C;IACD,GAAG,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,OAAO,CAAC;IACpD,OAAO,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,CAAC;IACzE,KAAK,EAAE,EAAE,EAAE,kBAAkB;CAC7B,CAAC;AAEF,2DAA2D;AAC3D,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;AAE5E;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc;IAC7C,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IAEnC,gDAAgD;IAChD,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IACxC,4FAA4F;IAC5F,IAAI,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC/E,8BAA8B;IAC9B,IAAI,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,SAAS,CAAC;IACzE,iBAAiB;IACjB,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IAC5C,uCAAuC;IACvC,IAAI,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC;IAC5C,UAAU;IACV,OAAO,MAAM,CAAC;AACf,CAAC;AASD,MAAM,kBAAkB,GAAqB;IAC5C,IAAI,EAAE,6DAA6D;IACnE,OAAO,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,EAAE,CACjC,wDAAwD,UAAU,IAAI,QAAQ,uBAAuB;CACtG,CAAC;AAEF,MAAM,0BAA0B,GAAqB;IACpD,IAAI,EAAE,gGAAgG;IACtG,OAAO,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,EAAE,CAClC,mDAAmD,UAAU,EAAE;CAChE,CAAC;AAEF,MAAM,4BAA4B,GAAqB;IACtD,IAAI,EAAE,iFAAiF;IACvF,OAAO,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,EAAE,CAClC,mDAAmD,UAAU,EAAE;CAChE,CAAC;AAEF,MAAM,yBAAyB,GAAqB;IACnD,IAAI,EAAE,yFAAyF;IAC/F,OAAO,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,EAAE,CAClC,mDAAmD,UAAU,EAAE;CAChE,CAAC;AAEF,MAAM,mBAAmB,GAAqB;IAC7C,IAAI,EAAE,4EAA4E;IAClF,OAAO,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,EAAE,CAClC,mDAAmD,UAAU,EAAE;CAChE,CAAC;AAEF,MAAM,qBAAqB,GAAqB;IAC/C,IAAI,EAAE,+DAA+D;IACrE,OAAO,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,EAAE,CAClC,mDAAmD,UAAU,EAAE;CAChE,CAAC;AAEF,MAAM,kBAAkB,GAAqB;IAC5C,IAAI,EAAE,2DAA2D;IACjE,OAAO,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,EAAE,CAClC,mDAAmD,UAAU,EAAE;CAChE,CAAC;AAYF;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAChD,sDAAsD;IACtD,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,mDAAmD,CAAC,CAAC;IAClF,IAAI,SAAS,EAAE,CAAC;QACf,OAAO;YACN,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC;YACnB,SAAS,EAAE,MAAM;YACjB,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC;YACtB,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACxD,CAAC;IACH,CAAC;IAED,kDAAkD;IAClD,IAAI,4BAA4B,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7C,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACzC,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC;IACvE,CAAC;IAED,4CAA4C;IAC5C,IAAI,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACvC,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACzC,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC;IACzE,CAAC;IAED,sDAAsD;IACtD,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;IACvE,IAAI,SAAS,EAAE,CAAC;QACf,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IACnD,CAAC;IAED,kEAAkE;IAClE,IAAI,8BAA8B,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/C,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACzC,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC;IACvE,CAAC;IAED,oEAAoE;IACpE,IAAI,4BAA4B,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7C,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACzC,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;IACtE,CAAC;IAED,oBAAoB;IACpB,IAAI,iCAAiC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,iCAAiC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAClG,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACzC,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;IACrE,CAAC;IAED,iDAAiD;IACjD,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC3C,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,IAAI,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;AACtE,CAAC;AAED,mFAAmF;AAEnF;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAC7B,SAAiB,EACjB,UAAkB,EAClB,QAAgB;IAEhB,MAAM,MAAM,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAC;IAE/C,QAAQ,MAAM,CAAC,SAAS,EAAE,CAAC;QAC1B,KAAK,MAAM,CAAC,CAAC,CAAC;YACb,MAAM,WAAW,GAAG,YAAY,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC;YACxE,MAAM,aAAa,GAAG,MAAM,CAAC,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACjG,IAAI,aAAa,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC7C,OAAO;oBACN,IAAI,EAAE,IAAI,MAAM,CAAC,QAAQ,oBAAoB,UAAU,0BAA0B,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;oBAC1G,OAAO,EAAE,wDAAwD,UAAU,IAAI,QAAQ,YAAY,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG;iBAC3H,CAAC;YACH,CAAC;YACD,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC5B,OAAO;oBACN,IAAI,EAAE,sBAAsB,MAAM,CAAC,KAAK,eAAe,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;oBAChF,OAAO,EAAE,mDAAmD,UAAU,EAAE;iBACxE,CAAC;YACH,CAAC;YACD,OAAO;gBACN,IAAI,EAAE,kBAAkB,CAAC,IAAI;gBAC7B,OAAO,EAAE,kBAAkB,CAAC,OAAO,CAAC,UAAU,EAAE,QAAQ,CAAC;aACzD,CAAC;QACH,CAAC;QACD,KAAK,UAAU;YACd,OAAO;gBACN,IAAI,EAAE,0BAA0B,CAAC,IAAI;gBACrC,OAAO,EAAE,0BAA0B,CAAC,OAAO,CAAC,UAAU,EAAE,QAAQ,CAAC;aACjE,CAAC;QACH,KAAK,YAAY;YAChB,OAAO;gBACN,IAAI,EAAE,4BAA4B,CAAC,IAAI;gBACvC,OAAO,EAAE,4BAA4B,CAAC,OAAO,CAAC,UAAU,EAAE,QAAQ,CAAC;aACnE,CAAC;QACH,KAAK,MAAM;YACV,OAAO;gBACN,IAAI,EAAE,yBAAyB,CAAC,IAAI;gBACpC,OAAO,EAAE,yBAAyB,CAAC,OAAO,CAAC,UAAU,EAAE,QAAQ,CAAC;aAChE,CAAC;QACH,KAAK,UAAU;YACd,OAAO;gBACN,IAAI,EAAE,qBAAqB,CAAC,IAAI;gBAChC,OAAO,EAAE,qBAAqB,CAAC,OAAO,CAAC,UAAU,EAAE,QAAQ,CAAC;aAC5D,CAAC;QACH,KAAK,SAAS;YACb,OAAO;gBACN,IAAI,EAAE,mBAAmB,CAAC,IAAI;gBAC9B,OAAO,EAAE,mBAAmB,CAAC,OAAO,CAAC,UAAU,EAAE,QAAQ,CAAC;aAC1D,CAAC;QACH,KAAK,QAAQ;YACZ,OAAO;gBACN,IAAI,EAAE,kBAAkB,CAAC,IAAI;gBAC7B,OAAO,EAAE,kBAAkB,CAAC,OAAO,CAAC,UAAU,EAAE,QAAQ,CAAC;aACzD,CAAC;QACH,KAAK,OAAO,CAAC;QACb;YACC,OAAO;gBACN,IAAI,EAAE,0CAA0C;gBAChD,OAAO,EAAE,mDAAmD,UAAU,EAAE;aACxE,CAAC;IACJ,CAAC;AACF,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,yBAAyB,CACxC,MAAc,EACd,UAAmB;IAEnB,MAAM,KAAK,GAAG,MAAM;SAClB,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAE9B,MAAM,OAAO,GAAiE,EAAE,CAAC;IAEjF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAC1B,qEAAqE;QACrE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC;QACrD,IAAI,CAAC,OAAO;YAAE,SAAS;QAEvB,iEAAiE;QACjE,MAAM,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACzF,MAAM,QAAQ,GAAG,aAAa,EAAE,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC;QAEjD,8CAA8C;QAC9C,MAAM,YAAY,GAAG,UAAU,IAAI,eAAe,CAAC,QAAQ,CAAC,CAAC;QAE7D,wEAAwE;QACxE,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACvF,SAAS;QACV,CAAC;QAED,iEAAiE;QACjE,+DAA+D;QAC/D,MAAM,SAAS,GAAG,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;QAC1F,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC;YAAE,SAAS;QAEjD,OAAO,CAAC,IAAI,CAAC;YACZ,SAAS,EAAE,OAAO;YAClB,WAAW,EAAE,cAAc,CAAC,SAAS,EAAE,YAAY,EAAE,QAAQ,CAAC;SAC9D,CAAC,CAAC;IACJ,CAAC;IAED,OAAO,OAAO,CAAC;AAChB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CAClC,SAAiB,EACjB,UAAmB,EACnB,QAAiB;IAEjB,iFAAiF;IACjF,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAC1B,+CAA+C;QAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACxD,sEAAsE;QACtE,MAAM,MAAM,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;QAC9C,6FAA6F;QAC7F,MAAM,aAAa,GAAG,MAAM,CAAC,SAAS,KAAK,OAAO,IAAI,uEAAuE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC7I,IAAI,aAAa,EAAE,CAAC;YACnB,MAAM,IAAI,GAAG,UAAU,IAAI,MAAM,CAAC;YAClC,MAAM,EAAE,GAAG,QAAQ,IAAI,SAAS,CAAC;YACjC,MAAM,WAAW,GAAG,cAAc,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;YACvD,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpB,QAAQ,CAAC,IAAI,CAAC,QAAQ,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;YAC1C,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;gBACzB,QAAQ,CAAC,IAAI,CAAC,OAAO,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC;YAC7C,CAAC;QACF,CAAC;aAAM,CAAC;YACP,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;IACF,CAAC;IAED,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC"}

package/dist/extensions/forgecli/regenerate.d.ts

@@ -1,2 +1,24 @@
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+export interface ModifiedFile {
+    category: string;
+    relativePath: string;
+    /** "modified" = manifest hash mismatch; "untracked" = no manifest entry (file exists but never recorded). */
+    state: "modified" | "untracked";
+}
+/**
+ * Enumerate files in .forge/{personas,skills,workflows,templates}/ and return
+ * those whose state diverges from the manifest baseline. Two divergence states
+ * are surfaced (both warrant a prompt before overwrite):
+ *
+ * - "modified": file content differs from the recorded manifest hash. Typically
+ *   caused by /forge:enhance Phase 2 applying edits in-place.
+ * - "untracked": file exists on disk but has NO manifest entry. Caused by a
+ *   prior regenerate that ran `clear-namespace` without re-recording. A fresh
+ *   /forge:init records hashes for every generated file, so "untracked" should
+ *   never appear in a clean install — its presence signals user content that's
+ *   been disconnected from the tracking system. See forge-cli#30.
+ *
+ * Pure function (no I/O beyond fs reads + manifest tool spawns).
+ */
+export declare function findModifiedStructuralFiles(cwd: string, toolsRoot: string): ModifiedFile[];
 export declare function registerRegenerate(pi: ExtensionAPI): void;

package/dist/extensions/forgecli/regenerate.js

@@ -12,10 +12,63 @@
 // Idempotent — re-running with no changes overwrites with identical bytes.
 //
 // See forge-cli companion to forge#83 / #85.
-import { spawn } from "node:child_process";
+import { spawn, spawnSync } from "node:child_process";
 import * as fs from "node:fs";
 import * as path from "node:path";
 import { getBundledPayloadRoot, getBundledToolsRoot } from "./forge-init.js";
+// ── Pre-write modification guard (forge-cli#26 / forge#106 / FORGE-BUG-037) ──
+//
+// `substitute-placeholders.cjs` blanket-overwrites every file in the four
+// structural-element categories. Before invoking it, enumerate each .forge/<cat>/
+// file and run `generation-manifest.cjs check`. Any file whose recorded hash
+// no longer matches its on-disk content is a manual modification — typically
+// applied by /forge:enhance Phase 2 — and would be silently destroyed.
+// Surface the list to the user and require explicit confirmation.
+const STRUCTURAL_CATEGORIES = ["personas", "skills", "workflows", "templates"];
+/**
+ * Enumerate files in .forge/{personas,skills,workflows,templates}/ and return
+ * those whose state diverges from the manifest baseline. Two divergence states
+ * are surfaced (both warrant a prompt before overwrite):
+ *
+ * - "modified": file content differs from the recorded manifest hash. Typically
+ *   caused by /forge:enhance Phase 2 applying edits in-place.
+ * - "untracked": file exists on disk but has NO manifest entry. Caused by a
+ *   prior regenerate that ran `clear-namespace` without re-recording. A fresh
+ *   /forge:init records hashes for every generated file, so "untracked" should
+ *   never appear in a clean install — its presence signals user content that's
+ *   been disconnected from the tracking system. See forge-cli#30.
+ *
+ * Pure function (no I/O beyond fs reads + manifest tool spawns).
+ */
+export function findModifiedStructuralFiles(cwd, toolsRoot) {
+    const manifestTool = path.join(toolsRoot, "generation-manifest.cjs");
+    if (!fs.existsSync(manifestTool))
+        return [];
+    const modified = [];
+    for (const category of STRUCTURAL_CATEGORIES) {
+        const dir = path.join(cwd, ".forge", category);
+        if (!fs.existsSync(dir))
+            continue;
+        const files = fs.readdirSync(dir).filter((f) => f.endsWith(".md"));
+        for (const f of files) {
+            const relPath = path.posix.join(".forge", category, f);
+            const result = spawnSync("node", [manifestTool, "check", relPath], {
+                cwd,
+                encoding: "utf8",
+                timeout: 5_000,
+            });
+            // generation-manifest check exit codes:
+            //   0 = pristine, 1 = modified, 2 = untracked, 3 = file missing
+            if (result.status === 1) {
+                modified.push({ category, relativePath: relPath, state: "modified" });
+            }
+            else if (result.status === 2) {
+                modified.push({ category, relativePath: relPath, state: "untracked" });
+            }
+        }
+    }
+    return modified;
+}
 async function runTool(toolPath, argv, cwd, ctx, label, timeoutMs = 60_000) {
     return await new Promise((resolve) => {
         const child = spawn("node", [toolPath, ...argv], { cwd, stdio: ["ignore", "pipe", "pipe"] });
@@ -55,7 +108,7 @@ export function registerRegenerate(pi) {
     pi.registerCommand("forge:regenerate", {
         description: "Re-materialize .forge/ and .claude/commands/ from the bundled forge-payload " +
             "(deterministic subset of the plugin's /forge:regenerate — runs substitute-placeholders.cjs).",
-        async handler(_args, ctx) {
+        async handler(args, ctx) {
             const cwd = process.cwd();
             const configPath = path.join(cwd, ".forge", "config.json");
             if (!fs.existsSync(configPath)) {
@@ -75,6 +128,42 @@ export function registerRegenerate(pi) {
                 ctx.ui.notify(`× forge:regenerate — base-pack missing at ${basePackDir}`, "error");
                 return;
             }
+            // Pre-write modification guard (forge-cli#26 / forge#106 / FORGE-BUG-037).
+            // Skip with --force (e.g. CI / dogfood reset). Otherwise, surface any
+            // manual modifications (typically applied by /forge:enhance Phase 2)
+            // and require explicit confirmation before overwriting them.
+            const force = (args ?? []).includes("--force");
+            if (!force) {
+                const divergent = findModifiedStructuralFiles(cwd, toolsRoot);
+                if (divergent.length > 0) {
+                    const modCount = divergent.filter((m) => m.state === "modified").length;
+                    const untCount = divergent.filter((m) => m.state === "untracked").length;
+                    const summary = [
+                        `${divergent.length} file(s) in .forge/ diverge from the manifest baseline:`,
+                        `  ${modCount} modified (hash mismatch — typical /forge:enhance Phase 2 edit)`,
+                        `  ${untCount} untracked (no manifest entry — usually means a prior regenerate cleared the namespace)`,
+                        "",
+                        "Divergent files:",
+                        ...divergent.map((m) => `  △ [${m.state}] ${m.relativePath}`),
+                        "",
+                        "Edits CAPTURED by /forge:enhance Phase 2 snapshots (.forge/archive/snap-N/)",
+                        "will be RESTORED automatically post-regenerate via `manage-versions replay`",
+                        "(forge#107 / Approach A — overlay semantics, later snapshots win).",
+                        "",
+                        "Edits NOT captured in any snapshot will be lost. To capture before regen, run",
+                        "/forge:enhance Phase 2 → approve edits → ensure `add-snapshot` was called.",
+                        "",
+                        "Answer 'yes' to proceed (snapshot-captured edits survive automatically).",
+                        "Answer 'no' to abort.",
+                        "Use --force to skip this prompt AND skip replay (pristine base-pack).",
+                    ].join("\n");
+                    const proceed = await ctx.ui.confirm(`Proceed with regenerate? (${divergent.length} divergent file(s): ${modCount} modified, ${untCount} untracked)`, summary);
+                    if (!proceed) {
+                        ctx.ui.notify(`〇 forge:regenerate cancelled — ${divergent.length} divergent file(s) preserved.`, "info");
+                        return;
+                    }
+                }
+            }
             ctx.ui.setStatus?.("forge:regenerate", "rebuilding init-context…");
             // 1. Rebuild init-context.json so substitute has fresh placeholders.
             if (fs.existsSync(buildInitContextTool)) {
@@ -111,7 +200,48 @@ export function registerRegenerate(pi) {
                 "--out",
                 cwd,
             ], cwd, ctx, "substitute-placeholders", 60_000);
-            // 3. Refresh schemas from bundled .schemas/. substitute-placeholders does
+            // 3a. Replay user enhancements (forge#107 / forge-cli#27 — Approach A layer 3).
+            //     After substitute-placeholders wrote fresh base-pack content over
+            //     .forge/{personas,skills,workflows,templates}/, restore any user-enhanced
+            //     files captured by /forge:enhance Phase 2 snapshots from .forge/archive/snap-N/.
+            //     Mirrors regenerate.md's per-category replay step. Pure additive — replay
+            //     is a no-op when no snapshots match. Skipped when --force is used (force
+            //     is "I want pristine base-pack content, no overlay").
+            const manageVersionsTool = path.join(toolsRoot, "manage-versions.cjs");
+            let replayTotal = 0;
+            if (ok && !force && fs.existsSync(manageVersionsTool)) {
+                ctx.ui.setStatus?.("forge:regenerate", "replaying user enhancements…");
+                const replayCategories = ["personas", "skills", "workflows", "templates"];
+                for (const category of replayCategories) {
+                    await new Promise((resolve) => {
+                        const child = spawn("node", [manageVersionsTool, "replay", "--target", category], {
+                            cwd,
+                            stdio: ["ignore", "pipe", "pipe"],
+                        });
+                        let stdoutBuf = "";
+                        child.stdout?.on("data", (d) => {
+                            stdoutBuf += d.toString();
+                        });
+                        child.on("close", (code) => {
+                            if (code === 0) {
+                                // Parse "restored — N file(s)" out of stdout to track total
+                                const m = stdoutBuf.match(/(\d+)\s+file\(s\)\s+restored/);
+                                if (m) {
+                                    replayTotal += parseInt(m[1], 10);
+                                }
+                            }
+                            // Non-zero exit (e.g. structure-versions.json missing on a
+                            // project that never ran /forge:enhance): treat as no-op.
+                            resolve();
+                        });
+                        child.on("error", () => resolve());
+                    });
+                }
+                if (replayTotal > 0) {
+                    ctx.ui.notify(`〇 replay: ${replayTotal} user enhancement(s) restored from snapshots`, "info");
+                }
+            }
+            // 3b. Refresh schemas from bundled .schemas/. substitute-placeholders does
             //    not touch .forge/schemas/, but a forge plugin version bump can ship
             //    schema changes (e.g. 0.43.13 added `provider` required + dropped
             //    `estimatedCostUSD`). Without this step, regenerated workflows assume

package/dist/extensions/forgecli/regenerate.js.map

@@ -1 +1 @@
-{"version":3,"file":"regenerate.js","sourceRoot":"","sources":["../../../src/extensions/forgecli/regenerate.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"regenerate.js","sourceRoot":"","sources":["../../../src/extensions/forgecli/regenerate.ts"],"names":[],"mappings":"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"}

package/dist/extensions/forgecli/run-sprint.js

@@ -26,6 +26,7 @@ import * as path from "node:path";
 import { fileURLToPath } from "node:url";
 import { spawnSync } from "node:child_process";
 import { assertAudience } from "./audience-gate.js";
+import { resolveToCanonicalId, resolveToolDir } from "./store-resolver.js";
 import { checkMaterialization } from "./plan.js";
 import { loadWorkflow } from "./loaders/workflow-loader.js";
 import { discoverForgeConfig } from "./forge-root.js";
@@ -233,7 +234,7 @@ export function registerRunSprint(pi, options = {}) {
             "Orchestrator archetype: delegates per-task execution to runTaskPipeline.",
         async handler(args, ctx) {
             const cwd = options.cwd ?? process.cwd();
-            const sprintId = args.trim();
+            let sprintId = args.trim();
             if (!sprintId) {
                 ctx.ui.notify("× forge:run-sprint — sprint ID required. Usage: /forge:run-sprint <SPRINT_ID>", "error");
                 return;
@@ -252,6 +253,20 @@ export function registerRunSprint(pi, options = {}) {
                 return;
             }
             const forgeRoot = forgeConfig.forgeRoot;
+            // ── Resolve sprint ID (prefix-normalize, suffix-match, NLP fallback) ──
+            // Handles unprefixed IDs like "S22" → "FORGE-S22".
+            // Issue #20: unprefixed entity IDs silently poisoned substitutions.
+            const toolDir = resolveToolDir(forgeRoot);
+            const resolvedSprintId = await resolveToCanonicalId(sprintId, toolDir, cwd, "sprint", { ctx, commandLabel: "forge:run-sprint" });
+            if (!resolvedSprintId) {
+                // Error already emitted by resolver
+                ctx.ui.setStatus?.(SPRINT_STATUS_KEY, undefined);
+                return;
+            }
+            // Replace raw arg with canonical ID for all subsequent operations.
+            sprintId = resolvedSprintId;
+            // Update status with canonical ID so the user sees the resolved form.
+            ctx.ui.setStatus?.(SPRINT_STATUS_KEY, `run-sprint ${sprintId}: ready`);
             const storeCli = path.join(forgeRoot, "tools", "store-cli.cjs");
             const preflightGate = path.join(forgeRoot, "tools", "preflight-gate.cjs");
             // ── Sprint resolution ────────────────────────────────────────────