@entelligentsia/forgecli 0.20.3 → 1.0.2

package/dist/extensions/forgecli/forge-artifact-tool.js

@@ -1,153 +1,58 @@
-// forge-artifact-tool.ts — typed artifact read/write/list tool for subagent sessions.
+// forge-artifact-tool.ts — thin runCjs shim delegating to plugin artifact.cjs.
 //
-// Resolves phase artifact paths from (entityType, entityId, artifactName) tuples.
-// Validates JSON summary artifacts on write. Eliminates path derivation as a
-// failure mode for low-tier models.
+// All logic (artifact catalog, path resolution, summary JSON validation) lives
+// in forge/forge/tools/artifact.cjs as the canonical plugin-side implementation.
+// This module is a lightweight wrapper that dispatches read/write/list calls via
+// runCjs to the plugin tool, keeping forge-cli in sync automatically whenever
+// the plugin is updated.
 //
-// v0.19.1 (forge-cli#33): resolveEntityDir now reads the store record's `path`
-// field instead of constructing paths from the entity ID alone. Bug, sprint, and
-// task directories can include descriptive slugs (e.g.
-// engineering/bugs/BUG-001-sprint-runner-context-accumulation) that are not
-// derivable from the ID alone.
-import { execFileSync } from "node:child_process";
+// Content-passing strategy for write:
+//   - Inline (<64KB): content is passed as the 4th positional argv argument.
+//   - Large (>=64KB): content is written to a temp file and passed as @<path>.
+//     artifact.cjs recognises the @-prefix convention and reads from the file.
 import * as fs from "node:fs";
+import * as os from "node:os";
 import * as path from "node:path";
 import { Type } from "typebox";
-// ── Artifact catalog ────────────────────────────────────────────────────────
-const ARTIFACT_CATALOG = {
-    plan: { filename: "PLAN.md", type: "md" },
-    "plan-review": { filename: "PLAN_REVIEW.md", type: "md" },
-    progress: { filename: "PROGRESS.md", type: "md" },
-    "code-review": { filename: "CODE_REVIEW.md", type: "md" },
-    "validation-report": { filename: "VALIDATION_REPORT.md", type: "md" },
-    "architect-approval": { filename: "ARCHITECT_APPROVAL.md", type: "md" },
-    triage: { filename: "TRIAGE.md", type: "md" },
-    "bug-report": { filename: "BUG_REPORT.md", type: "md" },
-    index: { filename: "INDEX.md", type: "md" },
-    "cost-report": { filename: "COST_REPORT.md", type: "md" },
-    timesheet: { filename: "TIMESHEET.md", type: "md" },
-    "plan-summary": { filename: "PLAN-SUMMARY.json", type: "json" },
-    "review-plan-summary": { filename: "REVIEW-PLAN-SUMMARY.json", type: "json" },
-    "implementation-summary": { filename: "IMPLEMENTATION-SUMMARY.json", type: "json" },
-    "review-code-summary": { filename: "REVIEW-CODE-SUMMARY.json", type: "json" },
-    "review-impl-summary": { filename: "REVIEW-IMPL-SUMMARY.json", type: "json" },
-    "validation-summary": { filename: "VALIDATION-SUMMARY.json", type: "json" },
-    "approve-summary": { filename: "APPROVE-SUMMARY.json", type: "json" },
-    "commit-summary": { filename: "COMMIT-SUMMARY.json", type: "json" },
-    "triage-summary": { filename: "TRIAGE-SUMMARY.json", type: "json" },
-    "writeback-summary": { filename: "WRITEBACK-SUMMARY.json", type: "json" },
-    "collation-summary": { filename: "COLLATION-SUMMARY.json", type: "json" },
-};
-const ARTIFACT_NAMES = Object.keys(ARTIFACT_CATALOG).sort();
-// ── Summary JSON validation ─────────────────────────────────────────────────
-const SUMMARY_REQUIRED = ["objective", "key_changes", "verdict", "written_at"];
-function validateSummaryJson(content) {
-    let obj;
-    try {
-        obj = JSON.parse(content);
-    }
-    catch (e) {
-        return `Invalid JSON: ${e.message}`;
-    }
-    const missing = SUMMARY_REQUIRED.filter((f) => !(f in obj));
-    if (missing.length > 0)
-        return `Missing required fields: ${missing.join(", ")}`;
-    if (typeof obj.objective !== "string")
-        return `"objective" must be a string`;
-    if (!Array.isArray(obj.key_changes))
-        return `"key_changes" must be an array`;
-    if (typeof obj.verdict !== "string")
-        return `"verdict" must be a string`;
-    if (typeof obj.written_at !== "string")
-        return `"written_at" must be a string`;
-    return null;
-}
-// ── Entity path resolution ──────────────────────────────────────────────────
-/**
- * Test override for readStorePath — allows unit tests to inject a mock
- * without touching node:child_process. Reset to {} after each test.
- */
-export const _testOverrides = {};
-/** Read a store record via store-cli and return its `path` field, or null on failure. */
-function readStorePath(entity, entityId, toolDir, projectRoot) {
-    // Test injection: if a mock is set, use it directly.
-    if (_testOverrides.readStorePath) {
-        return _testOverrides.readStorePath(entity, entityId, toolDir, projectRoot);
-    }
-    const cliPath = path.join(toolDir, "store-cli.cjs");
-    try {
-        const result = execFileSync("node", [cliPath, "read", entity, entityId, "--json"], {
-            cwd: projectRoot,
-            encoding: "utf8",
-            timeout: 10_000,
-        });
-        const record = JSON.parse(result);
-        if (typeof record.path === "string" && record.path.length > 0) {
-            return record.path;
-        }
-    }
-    catch {
-        // Store unavailable or record not found — fall through to ID-only resolution.
-    }
-    return null;
-}
-/**
- * Resolve entity directory using the store record's `path` field when available,
- * falling back to ID-only construction for tasks (sprint dir derived from
- * sprint record path or sprint ID) and sprints/bugs (direct ID).
- *
- * forge-cli#33: the store record is the canonical source for entity directory
- * paths — slug-suffixed directories like `BUG-001-sprint-runner-context-accumulation`
- * cannot be derived from the entity ID alone.
- */
-function resolveEntityDir(entity, entityId, engineeringPath, toolDir, projectRoot) {
-    switch (entity) {
-        case "bug": {
-            // Read bug record's path field — canonical source for slug-suffixed dirs.
-            const storePath = readStorePath("bug", entityId, toolDir, projectRoot);
-            if (storePath)
-                return storePath;
-            // Fallback: ID-only construction.
-            return path.join(engineeringPath, "bugs", entityId);
-        }
-        case "sprint": {
-            const storePath = readStorePath("sprint", entityId, toolDir, projectRoot);
-            if (storePath)
-                return storePath;
-            return path.join(engineeringPath, "sprints", entityId);
-        }
-        case "task": {
-            // For tasks, the path includes the sprint directory (which may have
-            // a slug suffix). Read the task record's path field.
-            const storePath = readStorePath("task", entityId, toolDir, projectRoot);
-            if (storePath)
-                return storePath;
-            // Fallback: derive from sprint prefix. Try sprint record for slug.
-            const match = entityId.match(/^(.+-S\d+)-T\d+$/);
-            if (!match)
-                return null;
-            const sprintId = match[1];
-            const sprintPath = readStorePath("sprint", sprintId, toolDir, projectRoot);
-            if (sprintPath) {
-                return path.join(sprintPath, entityId);
-            }
-            // Last resort: ID-only construction.
-            return path.join(engineeringPath, "sprints", sprintId, entityId);
-        }
-        default:
-            return null;
-    }
-}
+import { runCjs as defaultRunCjs } from "./forge-tools.js";
+// ── Artifact name list (for parameter description only — logic lives in plugin) ──
+const ARTIFACT_NAMES = [
+    "plan",
+    "plan-review",
+    "progress",
+    "code-review",
+    "validation-report",
+    "architect-approval",
+    "triage",
+    "bug-report",
+    "index",
+    "cost-report",
+    "timesheet",
+    "plan-summary",
+    "review-plan-summary",
+    "implementation-summary",
+    "review-code-summary",
+    "review-impl-summary",
+    "validation-summary",
+    "approve-summary",
+    "commit-summary",
+    "triage-summary",
+    "writeback-summary",
+    "collation-summary",
+].sort();
+const ARTIFACT_NAME_LIST = ARTIFACT_NAMES.join(", ");
+const INLINE_CONTENT_LIMIT = 64 * 1024; // 64KB
 // ── Tool builder ────────────────────────────────────────────────────────────
-export function buildForgeArtifact(projectRoot, engineeringPath, toolDir) {
-    const artifactNameList = ARTIFACT_NAMES.join(", ");
+export function buildForgeArtifact(projectRoot, _engineeringPath, toolDir, _runCjsOverride) {
+    const toolPath = path.join(toolDir, "artifact.cjs");
+    const runCjs = _runCjsOverride ?? defaultRunCjs;
     return {
         name: "forge_artifact",
         label: "Forge Artifact",
         description: "Read, write, or list phase artifacts (PLAN.md, PROGRESS.md, *-SUMMARY.json, etc.) " +
             "for a task, bug, or sprint. Resolves paths automatically from entity ID — never " +
             "construct artifact paths manually.\n\n" +
-            `Known artifacts: ${artifactNameList}.\n\n` +
+            `Known artifacts: ${ARTIFACT_NAME_LIST}.\n\n` +
             "JSON summary artifacts are validated on write (objective, key_changes, verdict, written_at required). " +
             "Use 'list' to see which artifacts already exist for an entity.",
         promptSnippet: "Use forge_artifact to read/write phase outputs (PLAN.md, PROGRESS.md, *-SUMMARY.json). " +
@@ -163,82 +68,62 @@ export function buildForgeArtifact(projectRoot, engineeringPath, toolDir) {
                 description: "Entity ID (e.g. HELLO-S99-T02, HELLO-B01-shout-flag, HELLO-S99).",
             }),
             artifact: Type.Optional(Type.String({
-                description: `Artifact name (required for read/write). One of: ${artifactNameList}.`,
+                description: `Artifact name (required for read/write). One of: ${ARTIFACT_NAME_LIST}.`,
             })),
             content: Type.Optional(Type.String({
                 description: "Content to write (required for write command).",
             })),
         }),
-        async execute(_toolCallId, _params) {
+        async execute(_toolCallId, _params, signal) {
             const params = _params;
-            const entityDir = resolveEntityDir(params.entity, params.entityId, engineeringPath, toolDir, projectRoot);
-            if (!entityDir) {
-                return errResult(`Cannot resolve ${params.entity} directory for "${params.entityId}". ` +
-                    `Expected ID pattern: task=PREFIX-SNN-TNN, bug=PREFIX-BNN-slug, sprint=PREFIX-SNN.`);
-            }
-            const absDir = path.resolve(projectRoot, entityDir);
-            if (params.command === "list") {
-                if (!fs.existsSync(absDir)) {
-                    return okResult(`No artifacts found — directory does not exist: ${entityDir}/`);
+            let tmpFile = null;
+            try {
+                const argv = [params.command, params.entity, params.entityId];
+                if (params.command !== "list") {
+                    if (!params.artifact) {
+                        return errResult(`"artifact" is required for ${params.command}. Known: ${ARTIFACT_NAME_LIST}`);
+                    }
+                    argv.push(params.artifact);
                 }
-                const files = fs.readdirSync(absDir).filter((f) => f.endsWith(".md") || f.endsWith(".json"));
-                const known = [];
-                const other = [];
-                for (const f of files) {
-                    const catalogEntry = Object.entries(ARTIFACT_CATALOG).find(([, v]) => v.filename === f);
-                    if (catalogEntry) {
-                        known.push(`  ${catalogEntry[0]} → ${f}`);
+                if (params.command === "write") {
+                    if (!params.content) {
+                        return errResult(`"content" is required for write.`);
+                    }
+                    const bytes = Buffer.byteLength(params.content, "utf8");
+                    if (bytes >= INLINE_CONTENT_LIMIT) {
+                        // Write to a temp file and pass @<path>
+                        tmpFile = path.join(os.tmpdir(), `forge-artifact-${Date.now()}-${process.pid}.tmp`);
+                        fs.writeFileSync(tmpFile, params.content, "utf8");
+                        argv.push(`@${tmpFile}`);
                     }
                     else {
-                        other.push(`  (unlisted) ${f}`);
+                        argv.push(params.content);
                     }
                 }
-                const lines = [`Artifacts in ${entityDir}/:`];
-                if (known.length > 0)
-                    lines.push(...known);
-                if (other.length > 0)
-                    lines.push(...other);
-                if (known.length === 0 && other.length === 0)
-                    lines.push("  (empty)");
-                return okResult(lines.join("\n"));
-            }
-            if (!params.artifact) {
-                return errResult(`"artifact" is required for ${params.command}. Known: ${artifactNameList}`);
-            }
-            const catalogEntry = ARTIFACT_CATALOG[params.artifact];
-            if (!catalogEntry) {
-                const suggestions = ARTIFACT_NAMES.filter((n) => n.includes(params.artifact.toLowerCase()));
-                return errResult(`Unknown artifact "${params.artifact}". Known: ${artifactNameList}.` +
-                    (suggestions.length > 0 ? ` Did you mean: ${suggestions.join(", ")}?` : ""));
-            }
-            const filePath = path.join(absDir, catalogEntry.filename);
-            if (params.command === "read") {
-                if (!fs.existsSync(filePath)) {
-                    return errResult(`Artifact not found: ${path.join(entityDir, catalogEntry.filename)}`);
+                const { stdout, stderr } = await runCjs(toolPath, argv, signal, 10_000, projectRoot);
+                if (stderr && stderr.trim()) {
+                    return errResult(stderr.trim());
                 }
-                const content = fs.readFileSync(filePath, "utf8");
-                return okResult(content);
+                return okResult(stdout.trim() || "OK");
             }
-            if (params.command === "write") {
-                if (!params.content) {
-                    return errResult(`"content" is required for write.`);
-                }
-                if (catalogEntry.type === "json") {
-                    const validationError = validateSummaryJson(params.content);
-                    if (validationError) {
-                        return errResult(`Summary validation failed for ${catalogEntry.filename}: ${validationError}. ` +
-                            `Required fields: ${SUMMARY_REQUIRED.join(", ")}.`);
+            catch (err) {
+                const e = err;
+                return errResult(`forge_artifact failed: ${e.message ?? "unknown error"}`);
+            }
+            finally {
+                if (tmpFile) {
+                    try {
+                        fs.unlinkSync(tmpFile);
+                    }
+                    catch {
+                        /* best-effort cleanup */
                     }
                 }
-                fs.mkdirSync(absDir, { recursive: true });
-                fs.writeFileSync(filePath, params.content, "utf8");
-                return okResult(`Wrote ${Buffer.byteLength(params.content, "utf8")} bytes to ${path.join(entityDir, catalogEntry.filename)}`);
             }
-            return errResult(`Unknown command: ${params.command}`);
         },
     };
 }
-// ── Result helpers (same pattern as forge-tools.ts) ─────────────────────────
+// ── Result helpers ────────────────────────────────────────────────────────────
 function okResult(text) {
     return {
         content: [{ type: "text", text: text || "OK" }],

package/dist/extensions/forgecli/forge-artifact-tool.js.map

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

package/dist/extensions/forgecli/forge-commands.js

@@ -22,6 +22,8 @@ import * as fsSync from "node:fs";
 import { promises as fs } from "node:fs";
 import * as path from "node:path";
 import { fileURLToPath } from "node:url";
+// FORGE-S26-T11: registerCalibrate imported to power `forge:health --fix`
+import { registerCalibrate } from "./calibrate.js";
 import { runRefreshKbLinks } from "./refresh-kb-links.js";
 // Resolve the package root for bundle path resolution
 const _PKG_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..", "..", "..");
@@ -85,11 +87,49 @@ export function registerForgeCommands(pi, options) {
         return { systemPrompt: cachedTomoshibiPrompt };
     });
     // ── /forge:health ─────────────────────────────────────────────────────────
+    // FORGE-S26-T11: `--fix` flag detected here; dispatches to calibrate behavior.
+    // Without `--fix`, delegates to the plugin's health.md workflow (unchanged).
+    //
+    // Implementation note: we register a temporary "forge:calibrate-internal"
+    // handler backed by registerCalibrate so we can invoke its logic without
+    // re-routing through a second pi.registerCommand call. The calibrate handler
+    // is invoked via pi.registerCommand with a synthetic name; the outer health
+    // handler strips `--fix` and forwards remaining args to it.
+    //
+    // Simpler approach: registerCalibrate registers on "forge:calibrate" — since
+    // that name was redirected to a deprecation stub, we instead delegate directly
+    // by constructing a synthetic pi wrapper that only captures the "forge:calibrate"
+    // registration and calling it inline.
     pi.registerCommand("forge:health", {
-        description: "Assess the project's SDLC knowledge base — config, KB freshness, store integrity",
+        description: "Assess the project's SDLC knowledge base — config, KB freshness, store integrity. " +
+            "--fix: run drift detection + patch application (former /forge:calibrate behavior).",
         async handler(args, ctx) {
             if (!forgeRoot)
                 return outsideProjectNoOp("health", ctx);
+            const parts = (args ?? "").trim().split(/\s+/).filter(Boolean);
+            const hasFix = parts.includes("--fix");
+            if (hasFix) {
+                // --fix: delegate to calibrate behavior. Strip --fix from args,
+                // pass remainder (e.g. --path <dir>) to calibrate handler.
+                const calibrateArgs = parts.filter((p) => p !== "--fix").join(" ");
+                // Build a thin synthetic pi wrapper to capture the calibrate handler
+                let calibrateHandler;
+                const syntheticPi = {
+                    ...pi,
+                    registerCommand: (name, def) => {
+                        if (name === "forge:calibrate")
+                            calibrateHandler = def.handler;
+                    },
+                };
+                registerCalibrate(syntheticPi);
+                if (calibrateHandler) {
+                    await calibrateHandler(calibrateArgs, ctx);
+                }
+                else {
+                    ctx.ui.notify("× forge:health --fix — calibrate handler unavailable", "error");
+                }
+                return;
+            }
             await delegateMarkdownCommand(pi, forgeRoot, "health", args, ctx);
         },
     });
@@ -116,6 +156,10 @@ export function registerForgeCommands(pi, options) {
     // /forge:status — native v0 handler registered in index.ts via
     // registerStatusCommand (FORGE-S23-T10). Removed delegateMarkdownCommand
     // stub. forge:status stays in EXPLICITLY_REGISTERED_NAMES below.
+    // ── v1.0 removed command stubs (FORGE-S26-T10) ───────────────────────────
+    // Commands removed in v1.0 emit a deprecation error with migration guidance.
+    // Deprecated rename/removal redirects fully removed — old names are now
+    // unknown commands. See docs/migration/v0-to-v1.md for the mapping.
 }
 // ── Phase G: registerAllForgeCommands (FORGE-S17-T02) ─────────────────────
 // Enumerate every *.md under dist/forge-payload/.base-pack/commands/ at
@@ -162,11 +206,16 @@ const EXPLICITLY_REGISTERED_NAMES = new Set([
     "forge:status",
     "forge:update",
     "forge:refresh-kb-links",
-    "forge:enhance",
+    // v1.0 renames — new names registered in their respective handler files
+    "forge:new-sprint", // FORGE-S19-T01 → renamed from forge:sprint-intake (FORGE-S26-T10)
+    "forge:plan-sprint", // FORGE-S19-T02 → renamed from forge:sprint-plan (FORGE-S26-T10)
+    "forge:retro", // FORGE-S23-T06 → renamed from forge:retrospective (FORGE-S26-T10)
+    "forge:rebuild", // regenerate.ts → renamed from forge:regenerate (FORGE-S26-T10)
+    "forge:search", // FORGE-S23-T10 → renamed from forge:store-query (FORGE-S26-T10)
+    "forge:repair", // FORGE-S23-T11 → renamed from forge:store-repair (FORGE-S26-T10)
+    "forge:check-agent", // FORGE-S23-T11 → renamed from forge:quiz-agent (FORGE-S26-T10)
     "forge:plan", // FORGE-S20-T05: real handler registered in plan.ts
     "forge:implement", // FORGE-S20-T06: real handler registered in implement.ts
-    "forge:sprint-intake", // FORGE-S19-T01: real handler registered in sprint-intake.ts
-    "forge:sprint-plan", // FORGE-S19-T02: real handler registered in sprint-plan.ts
     "forge:read", // Real handler registered in index.ts
     "forge:run-task", // FORGE-S21-T02: real handler registered in run-task.ts
     "forge:run-sprint", // FORGE-S21-T03: real handler registered in run-sprint.ts
@@ -176,21 +225,12 @@ const EXPLICITLY_REGISTERED_NAMES = new Set([
     "forge:approve", // FORGE-S21-T10: real kickoff shim registered in approve.ts
     "forge:commit", // FORGE-S21-T10: real kickoff shim registered in commit.ts
     "forge:validate", // FORGE-S21-T10: real kickoff shim registered in validate.ts
-    "forge:collate", // FORGE-S21-T10: real kickoff shim registered in collate.ts
+    "forge:collate", // FORGE-S21-T10: internal kickoff shim registered in collate.ts (not user-facing in v1.0)
     "forge:threads", // Thread-switcher chip strip; registered in thread-switcher.ts
-    "forge:regenerate", // Native handler registered in regenerate.ts — re-materialize .forge/ from bundled payload
-    "forge:retrospective", // FORGE-S23-T06: real kickoff shim registered in retrospective.ts
-    "forge:calibrate", // FORGE-S23-T08: real orchestrator handler registered in calibrate.ts
-    "forge:materialize", // FORGE-S23-T09: Atomic handler registered in materialize.ts
-    "forge:migrate", // FORGE-S23-T09: Hybrid handler registered in migrate.ts
-    "forge:update-tools", // FORGE-S23-T10: Atomic handler registered in update-tools.ts
-    "forge:store-query", // FORGE-S23-T10: Atomic handler registered in store-query.ts
     "forge:add-task", // FORGE-S23-T11: Kickoff shim registered in add-task.ts
     "forge:add-pipeline", // FORGE-S23-T11: Kickoff shim registered in add-pipeline.ts
-    "forge:quiz-agent", // FORGE-S23-T11: Kickoff shim registered in quiz-agent.ts
     "forge:remove", // FORGE-S23-T11: Kickoff shim registered in remove-command.ts
     "forge:report-bug", // FORGE-S23-T11: Kickoff shim registered in report-bug.ts
-    "forge:store-repair", // FORGE-S23-T11: Kickoff shim registered in store-repair.ts
 ]);
 // Alias for backwards-compat with tests that reference REAL_HANDLERS directly.
 // Will be removed after all test references are updated.
@@ -261,10 +301,9 @@ export function registerAllForgeCommands(pi, options) {
             }
         },
     });
-    // /forge:enhance: real native kickoff handler is registered in index.ts via
-    // registerEnhance(pi) — FORGE-S20-T04. The previous sentinel-writing stub
-    // has been retired. EXPLICITLY_REGISTERED_NAMES still lists "forge:enhance"
-    // so the auto-stub loop above skips it.
+    // /forge:enhance: REMOVED in v1.0 (FORGE-S26-T10). Deprecation stub registered
+    // in registerForgeCommands. EXPLICITLY_REGISTERED_NAMES still lists "forge:enhance"
+    // so the auto-stub loop above skips it (the stub is handled separately).
     //
     // /forge:plan: real native kickoff handler is registered in index.ts via
     // registerPlan(pi) — FORGE-S20-T05. EXPLICITLY_REGISTERED_NAMES lists

package/dist/extensions/forgecli/forge-commands.js.map

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

package/dist/extensions/forgecli/forge-init/phase4-register.js

@@ -1,9 +1,8 @@
-// forge-init/phase4-register.ts — Phase 4 Register extraction (FORGE-S25-T24, B-5)
+// forge-init/phase4-register.ts — Phase 4 Register (FORGE-S25-T24, B-5)
 //
-// Encapsulates Steps 4-1 through 4-11 from the original forge-init.ts Phase 4 block.
-// Phase 4 is heterogeneous (11 deterministic FS/tool/git steps, no LLM dispatch) and
-// is too complex for the generic LlmPhaseDescriptor runner. It is extracted as a
-// standalone async function.
+// Encapsulates Steps 4-1 through 4-11 from the init pipeline.
+// Phase 4 is heterogeneous (11 deterministic FS/tool/git steps, no LLM dispatch)
+// and is extracted as a standalone async function.
 //
 // Key contract:
 //   - Returns `Phase4Result { kbPathFinal }` on success — caller reads kbPathFinal for
@@ -119,8 +118,8 @@ async function linkAgentInstructionFile(cwd, kbPath, projectName, ctx) {
         `| /forge:fix-bug | Triage, diagnose, and fix a bug |`,
         `| /forge:run-task | Full plan-implement-review-commit pipeline |`,
         `| /forge:run-sprint | Execute all tasks in a sprint |`,
-        `| /forge:sprint-plan | Decompose sprint requirements into tasks |`,
-        `| /forge:sprint-intake | Elicit and structure requirements for a new sprint |`,
+        `| /forge:plan-sprint | Decompose sprint requirements into tasks |`,
+        `| /forge:new-sprint | Elicit and structure requirements for a new sprint |`,
         ``,
         `---`,
         `_Generated by /forge:init. Run /forge:refresh-kb-links to update._`,