@entelligentsia/forgecli 1.0.14 → 1.0.21

package/dist/extensions/forgecli/commands/review-plan.js

@@ -0,0 +1,200 @@
+// forge:review-plan — native kickoff handler (FORGE-S21-T10).
+//
+// Replaces the auto-generated stub previously installed by
+// registerAllForgeCommands (forge-commands.ts). Kickoff Shim archetype
+// (Pack-04 + Pack-06): single LLM handoff in current context, no fork.
+//
+// Note: The materialized workflow (review_plan.md) declares
+// `audience: subagent` — advisory only. Users may invoke this command
+// manually from the CLI; assertAudience never refuses subagent-audience
+// workflows. Orchestrator chains (run-task, run-sprint, fix-bug) still
+// dispatch via runForgeSubagent directly and do NOT route through this
+// handler.
+//
+// FORGE-S26-T11:
+//   - Pipeline step guard added (checks task state via store-cli; --force bypasses).
+//   - Revision loop context injected into kickoff: `### Review Loop Context` block
+//     with `Iteration: 1 of M` (user-invoked default) where M is read from config
+//     `maxReviewIterations` (default 3). Matches T07 workflow fallback spec.
+//
+// Iron Laws:
+//   IL1 — code only under forge-cli/src/extensions/forgecli/.
+//   IL4 — no JSON.stringify-into-subagent dispatch.
+//   IL6 — no shell-string interpolation; no spawn calls here.
+//   IL7 — every failure path emits ctx.ui.notify and returns; no silent
+//         continuation.
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { assertAudience } from "../audience-gate.js";
+import { discoverForgeConfig } from "../lib/forge-root.js";
+import { sendKickoff } from "../kickoff.js";
+// FORGE-S25-T16: extracted to lib modules (H-1, H-2). Re-exported here for
+// backward compatibility with existing test and consumer imports.
+import { extractPersonaNames } from "../lib/frontmatter-parser.js";
+import { parseGuardArgs, runPipelineGuard } from "../lib/pipeline-guard.js";
+import { loadPersona, PersonaSkillLoaderError } from "../parsers/persona-skill-loader.js";
+import { loadWorkflow, WorkflowLoaderError } from "../parsers/workflow-loader.js";
+export { extractPersonaNames };
+import { checkMaterialization } from "../lib/manifest-checker.js";
+export { checkMaterialization };
+export function parseReviewPlanArgs(rawArgs, cwd) {
+    const trimmed = (rawArgs ?? "").trim();
+    if (trimmed === "") {
+        return { mode: "empty", taskRef: "", sourceLabel: "(no input — supervisor infers task from store/context)" };
+    }
+    if (trimmed.startsWith("@")) {
+        const ref = trimmed.slice(1).trim();
+        const filePath = path.isAbsolute(ref) ? ref : path.resolve(cwd, ref);
+        const seed = fs.readFileSync(filePath, "utf8");
+        return { mode: "file", taskRef: seed, sourceLabel: `(seed from file: ${ref})` };
+    }
+    return { mode: "text", taskRef: trimmed, sourceLabel: "(seed from inline text)" };
+}
+export function composeKickoff(opts) {
+    const { workflowMd, personaIdentity, parsed, reviewLoopContext } = opts;
+    const sections = ["# /forge:review-plan", ""];
+    if (personaIdentity.trim().length > 0) {
+        sections.push(personaIdentity.trim(), "");
+    }
+    // Inject review loop context before workflow body (FORGE-S26-T11 / T07).
+    if (reviewLoopContext) {
+        sections.push(reviewLoopContext.trim(), "");
+    }
+    sections.push("## Dispatch", "", "Run the workflow below. Specifically:", "", "1. Read the plan at `engineering/sprints/<SPRINT_ID>/<TASK_ID>/PLAN.md` (the source of truth).", "2. Query the store for the task and its sprint/feature context via `forge_store_query` — do NOT raw-read `.forge/store/`.", "3. Follow the workflow Algorithm verbatim: review the plan for correctness, completeness, and risk.", "4. Write `PLAN_REVIEW.md` and `REVIEW-PLAN-SUMMARY.json` to the task directory using the `write` tool.", "5. Update task status by calling the `forge_store` MCP tool: `{command:'update-status', args:['task','<TASK_ID>','status','<new-status>']}`. Never raw-write `.forge/store/`. Do NOT bash-shell `forge store ...`.", "6. Honour Pack-06 Read/Write/Ask/Store discipline: writes go via the `forge_store` MCP tool; in-conversation clarifications use `forge_ask_user`.");
+    sections.push("", "---", "", "## Workflow", "", workflowMd.trim(), "", "---");
+    if (parsed.mode === "empty") {
+        sections.push("", "## Input", "", "(no seed — infer task from sprint context and store)");
+    }
+    else {
+        sections.push("", `## Input — ${parsed.sourceLabel}`, "", parsed.taskRef.trim());
+    }
+    return sections.join("\n");
+}
+// Iteration context builder (FORGE-S26-T11) ------------------------------------
+/**
+ * Build the `### Review Loop Context` block for user-invoked (non-orchestrated)
+ * review-plan calls. Matches the T07 graceful-fallback spec:
+ * "iteration 1 of M" where M is config.maxReviewIterations (default 3).
+ */
+export function buildReviewLoopContext(maxIterations) {
+    return [
+        "### Review Loop Context",
+        `- Iteration: 1 of ${maxIterations}`,
+        `- Is final iteration: ${maxIterations === 1 ? "true" : "false"}`,
+    ].join("\n");
+}
+/**
+ * Read maxReviewIterations from .forge/config.json. Returns default 3 on any
+ * error (missing file, missing field, non-integer value).
+ */
+export function readMaxReviewIterations(cwd) {
+    const configPath = path.join(cwd, ".forge", "config.json");
+    try {
+        const raw = fs.readFileSync(configPath, "utf8");
+        const cfg = JSON.parse(raw);
+        const v = cfg["maxReviewIterations"];
+        if (typeof v === "number" && Number.isInteger(v) && v >= 1)
+            return v;
+    }
+    catch {
+        // fail-open
+    }
+    return 3;
+}
+// Registration -------------------------------------------------------------
+const WORKFLOW_REL_PATH = path.join(".forge", "workflows", "review_plan.md");
+export function registerReviewPlan(pi, options = {}) {
+    pi.registerCommand("forge:review-plan", {
+        description: "Run the review-plan workflow for a Forge task. " +
+            "Usage: /forge:review-plan [@<file> | <free-form text>]. " +
+            "Note: this workflow is subagent-only; standalone invocations are refused. " +
+            "Orchestrator chains dispatch directly via runForgeSubagent.",
+        async handler(args, ctx) {
+            const cwd = options.cwd ?? process.cwd();
+            const workflowPath = path.join(cwd, WORKFLOW_REL_PATH);
+            // Pipeline step guard (FORGE-S26-T11): check task state before dispatching.
+            const guardParsed = parseGuardArgs(args);
+            if (!guardParsed.force) {
+                const forgeConfig = discoverForgeConfig(cwd);
+                if (forgeConfig) {
+                    const guard = runPipelineGuard("review-plan", guardParsed.taskIdHint, forgeConfig.forgeRoot, cwd);
+                    if (guard.blocked) {
+                        ctx.ui.notify(guard.message, "error");
+                        return;
+                    }
+                }
+            }
+            const effectiveArgs = guardParsed.cleanArgs;
+            let workflowMd;
+            let workflowAudience;
+            try {
+                const loaded = loadWorkflow(workflowPath);
+                workflowMd = loaded.rawMarkdown;
+                workflowAudience = loaded.audience;
+            }
+            catch (err) {
+                if (err instanceof WorkflowLoaderError) {
+                    if (err.code === "missing_file") {
+                        ctx.ui.notify(`× forge:review-plan — workflow not found at ${WORKFLOW_REL_PATH}; run /forge:init or /forge:rebuild first.`, "error");
+                    }
+                    else {
+                        ctx.ui.notify(`× forge:review-plan — workflow load failed (${err.code}): ${err.message}`, "error");
+                    }
+                    return;
+                }
+                const e = err;
+                ctx.ui.notify(`× forge:review-plan — failed to read workflow: ${e.message ?? "unknown"}`, "error");
+                return;
+            }
+            let parsed;
+            try {
+                parsed = parseReviewPlanArgs(effectiveArgs, cwd);
+            }
+            catch (err) {
+                const e = err;
+                ctx.ui.notify(`× forge:review-plan — failed to read seed: ${e.message ?? "unknown"}`, "error");
+                return;
+            }
+            // Build revision loop context block (FORGE-S26-T11 / T07): inject iteration
+            // 1 of M for user-invoked (non-orchestrated) calls. Orchestrator uses
+            // runForgeSubagent directly and injects its own context block.
+            const maxIter = readMaxReviewIterations(cwd);
+            const reviewLoopContext = buildReviewLoopContext(maxIter);
+            const check = checkMaterialization(workflowPath, workflowMd);
+            if (!check.ok) {
+                for (const marker of check.missing) {
+                    ctx.ui.notify(`× workflow regression: ${marker} not found in ${workflowPath}`, "error");
+                }
+                return;
+            }
+            const personas = extractPersonaNames(workflowMd);
+            let personaIdentity = "";
+            if (personas.length > 0) {
+                try {
+                    const persona = loadPersona(personas[0], { cwd });
+                    personaIdentity = persona.identity;
+                }
+                catch (err) {
+                    if (err instanceof PersonaSkillLoaderError) {
+                        ctx.ui.notify(`× forge:review-plan — persona '${personas[0]}' load failed (${err.code}): ${err.message}`, "error");
+                        return;
+                    }
+                    const e = err;
+                    ctx.ui.notify(`× forge:review-plan — persona load error: ${e.message ?? "unknown"}`, "error");
+                    return;
+                }
+            }
+            if (!assertAudience({ workflowName: "review_plan", audience: workflowAudience }, ctx)) {
+                return;
+            }
+            const kickoff = composeKickoff({
+                workflowMd,
+                personaIdentity,
+                parsed,
+                reviewLoopContext,
+            });
+            sendKickoff(pi, kickoff);
+        },
+    });
+}
+//# sourceMappingURL=review-plan.js.map

package/dist/extensions/forgecli/commands/review-plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-plan.js","sourceRoot":"","sources":["../../../../src/extensions/forgecli/commands/review-plan.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,EAAE;AACF,2DAA2D;AAC3D,uEAAuE;AACvE,uEAAuE;AACvE,EAAE;AACF,4DAA4D;AAC5D,sEAAsE;AACtE,wEAAwE;AACxE,uEAAuE;AACvE,uEAAuE;AACvE,WAAW;AACX,EAAE;AACF,iBAAiB;AACjB,qFAAqF;AACrF,mFAAmF;AACnF,kFAAkF;AAClF,6EAA6E;AAC7E,EAAE;AACF,aAAa;AACb,8DAA8D;AAC9D,oDAAoD;AACpD,8DAA8D;AAC9D,wEAAwE;AACxE,wBAAwB;AAExB,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAGlC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,2EAA2E;AAC3E,kEAAkE;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAC1F,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAElF,OAAO,EAAE,mBAAmB,EAAE,CAAC;AAE/B,OAAO,EAAE,oBAAoB,EAA6B,MAAM,4BAA4B,CAAC;AAE7F,OAAO,EAAE,oBAAoB,EAA6B,CAAC;AAY3D,MAAM,UAAU,mBAAmB,CAAC,OAAe,EAAE,GAAW;IAC/D,MAAM,OAAO,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACvC,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;QACpB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,wDAAwD,EAAE,CAAC;IAC9G,CAAC;IACD,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACrE,MAAM,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,oBAAoB,GAAG,GAAG,EAAE,CAAC;IACjF,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,yBAAyB,EAAE,CAAC;AACnF,CAAC;AAYD,MAAM,UAAU,cAAc,CAAC,IAAwB;IACtD,MAAM,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,EAAE,iBAAiB,EAAE,GAAG,IAAI,CAAC;IAExE,MAAM,QAAQ,GAAa,CAAC,sBAAsB,EAAE,EAAE,CAAC,CAAC;IACxD,IAAI,eAAe,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvC,QAAQ,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,yEAAyE;IACzE,IAAI,iBAAiB,EAAE,CAAC;QACvB,QAAQ,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,QAAQ,CAAC,IAAI,CACZ,aAAa,EACb,EAAE,EACF,uCAAuC,EACvC,EAAE,EACF,gGAAgG,EAChG,2HAA2H,EAC3H,qGAAqG,EACrG,wGAAwG,EACxG,oNAAoN,EACpN,mJAAmJ,CACnJ,CAAC;IAEF,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,UAAU,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;IAE9E,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,sDAAsD,CAAC,CAAC;IAC3F,CAAC;SAAM,CAAC;QACP,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,cAAc,MAAM,CAAC,WAAW,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAClF,CAAC;IAED,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED,iFAAiF;AAEjF;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,aAAqB;IAC3D,OAAO;QACN,yBAAyB;QACzB,qBAAqB,aAAa,EAAE;QACpC,yBAAyB,aAAa,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE;KACjE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,GAAW;IAClD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;IAC3D,IAAI,CAAC;QACJ,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAChD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA4B,CAAC;QACvD,MAAM,CAAC,GAAG,GAAG,CAAC,qBAAqB,CAAC,CAAC;QACrC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,CAAC,CAAC;IACtE,CAAC;IAAC,MAAM,CAAC;QACR,YAAY;IACb,CAAC;IACD,OAAO,CAAC,CAAC;AACV,CAAC;AAED,6EAA6E;AAE7E,MAAM,iBAAiB,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,gBAAgB,CAAC,CAAC;AAM7E,MAAM,UAAU,kBAAkB,CAAC,EAAgB,EAAE,UAAqC,EAAE;IAC3F,EAAE,CAAC,eAAe,CAAC,mBAAmB,EAAE;QACvC,WAAW,EACV,iDAAiD;YACjD,0DAA0D;YAC1D,4EAA4E;YAC5E,6DAA6D;QAC9D,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,GAA4B;YACvD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;YACzC,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,iBAAiB,CAAC,CAAC;YAEvD,4EAA4E;YAC5E,MAAM,WAAW,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;YACzC,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;gBACxB,MAAM,WAAW,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC;gBAC7C,IAAI,WAAW,EAAE,CAAC;oBACjB,MAAM,KAAK,GAAG,gBAAgB,CAAC,aAAa,EAAE,WAAW,CAAC,UAAU,EAAE,WAAW,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;oBAClG,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;wBACnB,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;wBACtC,OAAO;oBACR,CAAC;gBACF,CAAC;YACF,CAAC;YACD,MAAM,aAAa,GAAG,WAAW,CAAC,SAAS,CAAC;YAE5C,IAAI,UAAkB,CAAC;YACvB,IAAI,gBAAuE,CAAC;YAC5E,IAAI,CAAC;gBACJ,MAAM,MAAM,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;gBAC1C,UAAU,GAAG,MAAM,CAAC,WAAW,CAAC;gBAChC,gBAAgB,GAAG,MAAM,CAAC,QAAQ,CAAC;YACpC,CAAC;YAAC,OAAO,GAAY,EAAE,CAAC;gBACvB,IAAI,GAAG,YAAY,mBAAmB,EAAE,CAAC;oBACxC,IAAI,GAAG,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;wBACjC,GAAG,CAAC,EAAE,CAAC,MAAM,CACZ,+CAA+C,iBAAiB,4CAA4C,EAC5G,OAAO,CACP,CAAC;oBACH,CAAC;yBAAM,CAAC;wBACP,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,+CAA+C,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;oBACpG,CAAC;oBACD,OAAO;gBACR,CAAC;gBACD,MAAM,CAAC,GAAG,GAA2B,CAAC;gBACtC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,kDAAkD,CAAC,CAAC,OAAO,IAAI,SAAS,EAAE,EAAE,OAAO,CAAC,CAAC;gBACnG,OAAO;YACR,CAAC;YAED,IAAI,MAAkB,CAAC;YACvB,IAAI,CAAC;gBACJ,MAAM,GAAG,mBAAmB,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;YAClD,CAAC;YAAC,OAAO,GAAY,EAAE,CAAC;gBACvB,MAAM,CAAC,GAAG,GAA2B,CAAC;gBACtC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,8CAA8C,CAAC,CAAC,OAAO,IAAI,SAAS,EAAE,EAAE,OAAO,CAAC,CAAC;gBAC/F,OAAO;YACR,CAAC;YAED,4EAA4E;YAC5E,sEAAsE;YACtE,+DAA+D;YAC/D,MAAM,OAAO,GAAG,uBAAuB,CAAC,GAAG,CAAC,CAAC;YAC7C,MAAM,iBAAiB,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;YAE1D,MAAM,KAAK,GAAG,oBAAoB,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;YAC7D,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;gBACf,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;oBACpC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,0BAA0B,MAAM,iBAAiB,YAAY,EAAE,EAAE,OAAO,CAAC,CAAC;gBACzF,CAAC;gBACD,OAAO;YACR,CAAC;YAED,MAAM,QAAQ,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;YACjD,IAAI,eAAe,GAAG,EAAE,CAAC;YACzB,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACzB,IAAI,CAAC;oBACJ,MAAM,OAAO,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;oBAClD,eAAe,GAAG,OAAO,CAAC,QAAQ,CAAC;gBACpC,CAAC;gBAAC,OAAO,GAAY,EAAE,CAAC;oBACvB,IAAI,GAAG,YAAY,uBAAuB,EAAE,CAAC;wBAC5C,GAAG,CAAC,EAAE,CAAC,MAAM,CACZ,kCAAkC,QAAQ,CAAC,CAAC,CAAC,kBAAkB,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC,OAAO,EAAE,EAC1F,OAAO,CACP,CAAC;wBACF,OAAO;oBACR,CAAC;oBACD,MAAM,CAAC,GAAG,GAA2B,CAAC;oBACtC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,6CAA6C,CAAC,CAAC,OAAO,IAAI,SAAS,EAAE,EAAE,OAAO,CAAC,CAAC;oBAC9F,OAAO;gBACR,CAAC;YACF,CAAC;YAED,IAAI,CAAC,cAAc,CAAC,EAAE,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,gBAAgB,EAAE,EAAE,GAAG,CAAC,EAAE,CAAC;gBACvF,OAAO;YACR,CAAC;YAED,MAAM,OAAO,GAAG,cAAc,CAAC;gBAC9B,UAAU;gBACV,eAAe;gBACf,MAAM;gBACN,iBAAiB;aACjB,CAAC,CAAC;YAEH,WAAW,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QAC1B,CAAC;KACD,CAAC,CAAC;AACJ,CAAC"}

package/dist/extensions/forgecli/commands/sprint-intake.d.ts

@@ -0,0 +1,10 @@
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+interface ParsedArgs {
+    mode: "empty" | "file" | "text";
+    seed: string;
+    sourceLabel: string;
+}
+export declare function parseSprintIntakeArgs(rawArgs: string, cwd: string): ParsedArgs;
+export declare function composeKickoff(workflowMd: string, parsed: ParsedArgs): string;
+export declare function registerSprintIntake(pi: ExtensionAPI): void;
+export {};

package/dist/extensions/forgecli/commands/sprint-intake.js

@@ -0,0 +1,91 @@
+// forge:sprint-intake — LLM-driven kickoff handler (FORGE-BUG-031).
+//
+// Replaces the deterministic TUI flow shipped in FORGE-S19-T01. The native
+// handler is now a thin shim that:
+//   1. Parses argv: empty | "@<path>" (file ref) | free-form text
+//   2. Reads .forge/workflows/architect_sprint_intake.md
+//   3. Composes a kickoff message (workflow + seed input)
+//   4. Calls pi.sendUserMessage() to inject — LLM drives the interview using
+//      forge_store, forge_ask_user, write, read, forge_collate tools.
+//
+// No multi-turn TUI, no checkpoints, no scripted-answers env var. The LLM
+// owns the conversation; the handler returns once the kickoff is queued.
+//
+// Persona/skill loading: this handler does not read `.forge/personas/` or
+// `.forge/skills/` directly — the LLM dereferences those via the workflow
+// text. Any future need for typed persona/skill access in this handler MUST
+// go through `./loaders/persona-skill-loader.ts` (FORGE-S20-T02). The smoke
+// gate enforces this with a grep assertion.
+import * as fs from "node:fs";
+import * as path from "node:path";
+export function parseSprintIntakeArgs(rawArgs, cwd) {
+    const trimmed = (rawArgs ?? "").trim();
+    if (!trimmed) {
+        return { mode: "empty", seed: "", sourceLabel: "(no input — start interview)" };
+    }
+    if (trimmed.startsWith("@")) {
+        const ref = trimmed.slice(1).trim();
+        const filePath = path.isAbsolute(ref) ? ref : path.resolve(cwd, ref);
+        const seed = fs.readFileSync(filePath, "utf8");
+        return { mode: "file", seed, sourceLabel: `(seed from file: ${ref})` };
+    }
+    return { mode: "text", seed: trimmed, sourceLabel: "(seed from inline text)" };
+}
+// ── Kickoff composition ───────────────────────────────────────────────────
+export function composeKickoff(workflowMd, parsed) {
+    const seedSection = parsed.mode === "empty"
+        ? "\n## Input\n\n(no seed — begin interview now and elicit goals/scope/constraints conversationally)\n"
+        : `\n## Input — ${parsed.sourceLabel}\n\n${parsed.seed.trim()}\n`;
+    return [
+        "# /forge:new-sprint",
+        "",
+        "Run the sprint-intake workflow below. Drive the interview conversationally — read referenced personas/skills/templates as needed, ask clarifying questions one at a time, and write `engineering/sprints/<SPRINT_ID>/SPRINT_REQUIREMENTS.md` plus the corresponding store records when ready. For the canonical sprint record, call the `forge_store` MCP tool with `{command:'write', args:['sprint','<json>']}` — 2-positional, id INSIDE json. Call `forge_store_template` first to get the json shape. Do NOT bash-shell `forge store ...`.",
+        "",
+        "---",
+        "",
+        "## Workflow",
+        "",
+        workflowMd.trim(),
+        "",
+        "---",
+        seedSection,
+    ].join("\n");
+}
+// ── Registration ──────────────────────────────────────────────────────────
+const WORKFLOW_REL_PATH = path.join(".forge", "workflows", "architect_sprint_intake.md");
+export function registerSprintIntake(pi) {
+    pi.registerCommand("forge:new-sprint", {
+        description: "Start an LLM-driven sprint-intake interview. " +
+            "Usage: /forge:new-sprint [@<file> | <free-form text>]. " +
+            "Empty args start a conversational interview from scratch.",
+        async handler(args, ctx) {
+            const cwd = process.cwd();
+            const workflowPath = path.join(cwd, WORKFLOW_REL_PATH);
+            if (!fs.existsSync(workflowPath)) {
+                ctx.ui.notify(`forge:new-sprint — workflow not found at ${WORKFLOW_REL_PATH}; run /forge:init or /forge:rebuild first.`, "warning");
+                return;
+            }
+            let parsed;
+            try {
+                parsed = parseSprintIntakeArgs(args, cwd);
+            }
+            catch (err) {
+                const e = err;
+                ctx.ui.notify(`forge:new-sprint — failed to read seed: ${e.message ?? "unknown"}`, "error");
+                return;
+            }
+            let workflowMd;
+            try {
+                workflowMd = fs.readFileSync(workflowPath, "utf8");
+            }
+            catch (err) {
+                const e = err;
+                ctx.ui.notify(`forge:new-sprint — failed to read workflow: ${e.message ?? "unknown"}`, "error");
+                return;
+            }
+            const kickoff = composeKickoff(workflowMd, parsed);
+            pi.sendUserMessage(kickoff);
+        },
+    });
+}
+//# sourceMappingURL=sprint-intake.js.map

package/dist/extensions/forgecli/commands/sprint-intake.js.map

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

package/dist/extensions/forgecli/commands/sprint-plan.d.ts

@@ -0,0 +1,14 @@
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+interface ParsedArgs {
+    sprintId: string;
+    seedMode: "none" | "file" | "text";
+    seed: string;
+    sourceLabel: string;
+}
+export declare function parseSprintPlanArgs(rawArgs: string, cwd: string): ParsedArgs;
+export declare function composeKickoff(workflowMd: string, parsed: ParsedArgs, requirements: {
+    path: string;
+    content: string;
+} | null): string;
+export declare function registerSprintPlan(pi: ExtensionAPI): void;
+export {};

package/dist/extensions/forgecli/commands/sprint-plan.js

@@ -0,0 +1,122 @@
+// forge:sprint-plan — LLM-driven kickoff handler (FORGE-BUG-032).
+//
+// Replaces the deterministic JSON-mode subagent call shipped in FORGE-S19-T02.
+// The handler is now a thin shim that:
+//   1. Parses argv: <SPRINT_ID> [@<file> | free-form text]
+//   2. Reads SPRINT_REQUIREMENTS.md (or REQUIREMENTS.md alias) when present
+//   3. Reads .forge/workflows/architect_sprint_plan.md
+//   4. Composes a kickoff message (workflow + requirements + optional seed)
+//   5. Calls pi.sendUserMessage() — LLM drives task decomposition with
+//      forge_store write task per task, no rigid JSON contract.
+//
+// Persona/skill loading: this handler does not read `.forge/personas/` or
+// `.forge/skills/` directly — the LLM dereferences those via the workflow
+// text. Any future need for typed persona/skill access in this handler MUST
+// go through `./loaders/persona-skill-loader.ts` (FORGE-S20-T02). The smoke
+// gate enforces this with a grep assertion.
+import * as fs from "node:fs";
+import * as path from "node:path";
+export function parseSprintPlanArgs(rawArgs, cwd) {
+    const trimmed = (rawArgs ?? "").trim();
+    if (!trimmed) {
+        throw new Error("sprint ID required — usage: /forge:plan-sprint <SPRINT_ID> [@<file> | <text>]");
+    }
+    const [sprintId, ...rest] = trimmed.split(/\s+/);
+    const tail = rest.join(" ").trim();
+    if (!tail) {
+        return { sprintId, seedMode: "none", seed: "", sourceLabel: "" };
+    }
+    if (tail.startsWith("@")) {
+        const ref = tail.slice(1).trim();
+        const filePath = path.isAbsolute(ref) ? ref : path.resolve(cwd, ref);
+        const seed = fs.readFileSync(filePath, "utf8");
+        return { sprintId, seedMode: "file", seed, sourceLabel: `(seed from file: ${ref})` };
+    }
+    return { sprintId, seedMode: "text", seed: tail, sourceLabel: "(seed from inline text)" };
+}
+// ── Requirements lookup ───────────────────────────────────────────────────
+function resolveRequirements(cwd, sprintId) {
+    const sprintDir = path.join(cwd, "engineering", "sprints", sprintId);
+    for (const name of ["SPRINT_REQUIREMENTS.md", "REQUIREMENTS.md"]) {
+        const p = path.join(sprintDir, name);
+        try {
+            const content = fs.readFileSync(p, "utf8");
+            return { path: p, content };
+        }
+        catch {
+            /* try next */
+        }
+    }
+    return null;
+}
+// ── Kickoff composition ───────────────────────────────────────────────────
+export function composeKickoff(workflowMd, parsed, requirements) {
+    const sections = [
+        "# /forge:plan-sprint",
+        "",
+        `Decompose sprint ${parsed.sprintId} into tasks. Drive the planning conversationally per the workflow below — read referenced personas/skills, validate dependencies, and write each task by calling the \`forge_store\` MCP tool with \`{command:'write', args:['task','<json>']}\` (2-positional, id INSIDE json) once you and the user agree on the shape. Call \`forge_store_template\` first for the canonical task shape. Update the sprint record (same tool, args:['sprint','<json>']) with the final task ID list. Do not return a single bulk JSON array; commit tasks one at a time so the user can interject. Do NOT bash-shell \`forge store ...\`.`,
+        "",
+        "---",
+        "",
+        "## Workflow",
+        "",
+        workflowMd.trim(),
+        "",
+        "---",
+        "",
+        `## Sprint: ${parsed.sprintId}`,
+    ];
+    if (requirements) {
+        sections.push("", `Requirements file: \`${path.relative(process.cwd(), requirements.path)}\``);
+        sections.push("", "```markdown", requirements.content.trim(), "```");
+    }
+    else {
+        sections.push("", `(no requirements file found at engineering/sprints/${parsed.sprintId}/SPRINT_REQUIREMENTS.md or REQUIREMENTS.md — ask the user to confirm intent or run /forge:new-sprint first)`);
+    }
+    if (parsed.seedMode !== "none") {
+        sections.push("", `## Additional Input — ${parsed.sourceLabel}`, "", parsed.seed.trim());
+    }
+    return sections.join("\n");
+}
+// ── Registration ──────────────────────────────────────────────────────────
+const WORKFLOW_REL_PATH = path.join(".forge", "workflows", "architect_sprint_plan.md");
+export function registerSprintPlan(pi) {
+    pi.registerCommand("forge:plan-sprint", {
+        description: "Start an LLM-driven sprint task-decomposition session. " +
+            "Usage: /forge:plan-sprint <SPRINT_ID> [@<file> | <free-form text>]. " +
+            "Reads SPRINT_REQUIREMENTS.md (or REQUIREMENTS.md) from the sprint directory.",
+        async handler(args, ctx) {
+            const cwd = process.cwd();
+            let parsed;
+            try {
+                parsed = parseSprintPlanArgs(args, cwd);
+            }
+            catch (err) {
+                const e = err;
+                ctx.ui.notify(`× forge:plan-sprint — ${e.message ?? "argv parse failed"}`, "error");
+                return;
+            }
+            const workflowPath = path.join(cwd, WORKFLOW_REL_PATH);
+            if (!fs.existsSync(workflowPath)) {
+                ctx.ui.notify(`× forge:plan-sprint — workflow not found at ${WORKFLOW_REL_PATH}; run /forge:init or /forge:rebuild first.`, "error");
+                return;
+            }
+            let workflowMd;
+            try {
+                workflowMd = fs.readFileSync(workflowPath, "utf8");
+            }
+            catch (err) {
+                const e = err;
+                ctx.ui.notify(`× forge:plan-sprint — failed to read workflow: ${e.message ?? "unknown"}`, "error");
+                return;
+            }
+            const requirements = resolveRequirements(cwd, parsed.sprintId);
+            if (!requirements) {
+                ctx.ui.notify(`△ forge:plan-sprint — no SPRINT_REQUIREMENTS.md found at engineering/sprints/${parsed.sprintId}/. Continuing; LLM will ask you for context.`, "warning");
+            }
+            const kickoff = composeKickoff(workflowMd, parsed, requirements);
+            pi.sendUserMessage(kickoff);
+        },
+    });
+}
+//# sourceMappingURL=sprint-plan.js.map

package/dist/extensions/forgecli/commands/sprint-plan.js.map

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

package/dist/extensions/forgecli/commands/status-command.d.ts

@@ -0,0 +1,19 @@
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+export interface StatusResult {
+    lines: string[];
+    hasActiveSprint: boolean;
+}
+/**
+ * Read active sprint and its tasks from store-cli.
+ * Returns formatted text lines for display via ctx.ui.notify.
+ * Exported so orchestrators can call directly without going through sendUserMessage.
+ */
+export declare function runStatus(forgeRoot: string, cwd: string): Promise<StatusResult>;
+/**
+ * Register /forge:status (v0 native handler).
+ * forgeRoot is nullable — null means we're outside a Forge project.
+ */
+export declare function registerStatusCommand(pi: ExtensionAPI, opts: {
+    forgeRoot: string | null;
+}): void;
+export declare function readForgeRootFromConfig(cwd: string): string | null;

package/dist/extensions/forgecli/commands/status-command.js

@@ -0,0 +1,140 @@
+// status-command.ts — native v0 handler for /forge:status (FORGE-S23-T10)
+//
+// Replaces the delegateMarkdownCommand stub that previously lived in forge-commands.ts.
+// Reads the active sprint from store and lists tasks with their statuses.
+// No TUI — text-only widget via ctx.ui.notify.
+//
+// Archetype: Atomic (no LLM in loop — pack-04 §Atomic).
+// Iron Laws:
+//   IL1 — new code lives in forge-cli/ only
+//   IL6 — no shell-string interpolation (argv-array throughout)
+//   IL7 — silent continuation past failures is never acceptable
+import { execFile } from "node:child_process";
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { promisify } from "node:util";
+import { resolveToolDir } from "../store/store-resolver.js";
+const execFileAsync = promisify(execFile);
+/**
+ * Read active sprint and its tasks from store-cli.
+ * Returns formatted text lines for display via ctx.ui.notify.
+ * Exported so orchestrators can call directly without going through sendUserMessage.
+ */
+export async function runStatus(forgeRoot, cwd) {
+    const toolDir = resolveToolDir(forgeRoot);
+    const storeCliPath = path.join(toolDir, "store-cli.cjs");
+    // Step 1: list all sprints
+    let listResult;
+    try {
+        const out = await execFileAsync("node", [storeCliPath, "query", "--list-sprints"], {
+            cwd,
+            encoding: "utf8",
+            timeout: 10_000,
+        });
+        listResult = JSON.parse(out.stdout);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return {
+            lines: [`× forge:status — could not list sprints: ${msg}`],
+            hasActiveSprint: false,
+        };
+    }
+    // Step 2: filter active sprints, sort by ID descending (proxy for recency)
+    const activeSprints = (listResult.results ?? [])
+        .filter((s) => s.status === "active")
+        .sort((a, b) => b.id.localeCompare(a.id));
+    if (activeSprints.length === 0) {
+        return {
+            lines: [
+                "forge:status — No active sprint found.",
+                'Run /forge:init to initialise a project, or check your store with /forge:search "--list-sprints".',
+            ],
+            hasActiveSprint: false,
+        };
+    }
+    // Use the most recent active sprint
+    const sprint = activeSprints[0];
+    // Step 3: fetch tasks for this sprint
+    let sprintResult;
+    try {
+        const out = await execFileAsync("node", [storeCliPath, "query", "--sprint", sprint.id], {
+            cwd,
+            encoding: "utf8",
+            timeout: 10_000,
+        });
+        sprintResult = JSON.parse(out.stdout);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return {
+            lines: [`× forge:status — could not fetch tasks for sprint ${sprint.id}: ${msg}`],
+            hasActiveSprint: true,
+        };
+    }
+    const tasks = sprintResult.results ?? [];
+    // Step 4: format output
+    const lines = [
+        `Sprint: ${sprint.id}${sprint.title ? ` — ${sprint.title}` : ""}`,
+        `Tasks: ${tasks.length}`,
+        "",
+    ];
+    if (tasks.length === 0) {
+        lines.push("  (no tasks found)");
+    }
+    else {
+        for (const task of tasks) {
+            const status = task.status ?? "unknown";
+            const title = task.title ? ` — ${task.title.slice(0, 60)}` : "";
+            lines.push(`  ${task.id}  [${status}]${title}`);
+        }
+    }
+    if (activeSprints.length > 1) {
+        lines.push("");
+        lines.push(`  Note: ${activeSprints.length - 1} other active sprint(s) found. Showing most recent (${sprint.id}).`);
+    }
+    return { lines, hasActiveSprint: true };
+}
+// ── Register ─────────────────────────────────────────────────────────────────
+/**
+ * Register /forge:status (v0 native handler).
+ * forgeRoot is nullable — null means we're outside a Forge project.
+ */
+export function registerStatusCommand(pi, opts) {
+    pi.registerCommand("forge:status", {
+        description: "Sprint and task summary widget — lists active sprint and task statuses.",
+        async handler(_args, ctx) {
+            const cwd = process.cwd();
+            // Outside-project guard
+            if (!opts.forgeRoot) {
+                ctx.ui.notify("× forge:status — not inside a Forge project. Run /forge:init first.", "error");
+                return;
+            }
+            ctx.ui.setStatus?.("forge:status", "Loading sprint status…");
+            const result = await runStatus(opts.forgeRoot, cwd);
+            ctx.ui.setStatus?.("forge:status", undefined);
+            for (const line of result.lines) {
+                const severity = line.startsWith("×") ? "error" : "info";
+                ctx.ui.notify(line, severity);
+            }
+        },
+    });
+}
+// ── Outside-project config guard helper ──────────────────────────────────────
+// Not used above because forgeRoot is passed in at register time, but exported
+// for use in tests that need to verify the guard path.
+export function readForgeRootFromConfig(cwd) {
+    try {
+        const configPath = path.join(cwd, ".forge", "config.json");
+        const raw = fs.readFileSync(configPath, "utf8");
+        const cfg = JSON.parse(raw);
+        const paths = cfg.paths;
+        if (paths && typeof paths.forgeRoot === "string")
+            return paths.forgeRoot;
+    }
+    catch {
+        // fall through
+    }
+    return null;
+}
+//# sourceMappingURL=status-command.js.map

package/dist/extensions/forgecli/commands/status-command.js.map

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