@entelligentsia/forgecli 0.15.0 → 0.19.0

package/dist/extensions/forgecli/forge-init/phase-descriptors.js

@@ -0,0 +1,350 @@
+// forge-init/phase-descriptors.ts — LlmPhaseDescriptor interface + runLlmPhase() runner
+// + per-phase descriptor objects (FORGE-S25-T24, B-5)
+//
+// Centralises the repeated "banner → [LLM dispatch → waitForIdle →] verify → [retry →]
+// [user confirm →] writeInitProgress → completeNotify" skeleton that was duplicated
+// across the Phase 1, 2, and 3 blocks in forge-init.ts.
+//
+// Design rules:
+//   - If `buildPrompt` returns a non-null string, the runner performs LLM dispatch via
+//     `sendToAgent` + `waitForIdle`. Phase 1 and 2 use this path.
+//   - If `buildPrompt` returns null, the runner skips LLM dispatch and invokes
+//     `runDeterministic` instead (Phase 3 path — pure tool calls, no agent).
+//   - `postVerify` is an optional async hook invoked after the failure-handling decision
+//     completes (i.e. after verify succeeds OR after user chooses partial-continue).
+//     Used by Phase 1 for KB folder prompt + marketplace advisory, by Phase 2 for
+//     project-context.json write and calibration baseline.
+//   - `hardFailOnVerifyError` (default false): when true, a failed verify causes an
+//     immediate `"abort"` return with no retry and no user confirm. Phase 3 uses this.
+//   - `preDispatchNotify` (optional): fired before LLM dispatch — used by Phase 1 to
+//     emit the "Running 5 discovery scans in parallel..." info notice.
+import * as path from "node:path";
+import * as fs from "node:fs";
+import { execFileAsync, runToolAdvisory } from "../lib/exec-helpers.js";
+import { writeInitProgress } from "../init-progress.js";
+import { buildProjectContext, computeCalibrationBaseline, validateProjectContext, writeProjectContext, } from "../init-context.js";
+import { verifyPhase1, verifyPhase2, verifyPhase3 } from "./verifiers.js";
+import { buildPhase1PromptText, buildPhase2PromptText } from "./prompts.js";
+// ── Generic runner ─────────────────────────────────────────────────────────
+/**
+ * Run a single init phase using its descriptor.
+ *
+ * Returns `"ok"` when the phase completes successfully (verify passed, or the
+ * user chose to continue with partial results).
+ *
+ * Returns `"abort"` when the phase should halt the entire init (verify failed
+ * in hard-fail mode, verify failed twice in non-interactive mode, or the user
+ * declined to continue).
+ */
+export async function runLlmPhase(desc, ctx, cwd, bundleRoot, toolsRoot, projectName, configCache, sendToAgent, waitForIdle, isNonInteractive) {
+    // 1. setStatus
+    ctx.ui.setStatus?.("forge:init", `Phase ${desc.label}`);
+    // 2. Banner
+    const bannersTool = path.join(toolsRoot, "banners.cjs");
+    if (fs.existsSync(bannersTool)) {
+        await execFileAsync("node", [bannersTool, "--phase", String(desc.phaseNum), "4", desc.bannerName, desc.bannerKey], { cwd, timeout: 5000 }).catch(() => {
+            /* non-fatal */
+        });
+    }
+    // 3. Optional pre-dispatch notification
+    if (desc.preDispatchNotify) {
+        ctx.ui.notify(desc.preDispatchNotify, "info");
+    }
+    // 4. LLM dispatch OR deterministic execution
+    const prompt = desc.buildPrompt(bundleRoot, cwd, projectName, configCache);
+    if (prompt !== null) {
+        // LLM path: send prompt + wait for agent
+        sendToAgent(prompt);
+        await waitForIdle();
+    }
+    else if (desc.runDeterministic) {
+        // Deterministic path: run tool calls directly
+        await desc.runDeterministic(cwd, bundleRoot, toolsRoot, configCache, ctx);
+    }
+    // 5. Verify
+    let result = desc.verify(cwd, configCache);
+    if (!result.ok && desc.hardFailOnVerifyError) {
+        // Hard-fail: no retry, no user confirm (Phase 3)
+        ctx.ui.notify(desc.nonInteractiveAbortMsg(result), "error");
+        return "abort";
+    }
+    // 6. Retry steer (LLM phases only)
+    if (!result.ok && prompt !== null) {
+        const retrySteer = desc.buildRetrySteer(result, bundleRoot, cwd);
+        if (retrySteer) {
+            ctx.ui.notify(`△ Phase ${desc.phaseNum} deliverable missing: ${result.missing.join(", ")} — retrying with corrective steer.`, "warning");
+            sendToAgent(retrySteer);
+            await waitForIdle();
+            result = desc.verify(cwd, configCache);
+        }
+    }
+    // 7. Handle persistent failure
+    if (!result.ok) {
+        if (isNonInteractive()) {
+            ctx.ui.notify(desc.nonInteractiveAbortMsg(result), "error");
+            return "abort";
+        }
+        const { title, body } = desc.interactiveAbortPrompt(result);
+        const proceed = await ctx.ui.confirm(title, body);
+        if (!proceed) {
+            ctx.ui.notify(desc.abortNotify, "error");
+            return "abort";
+        }
+        ctx.ui.notify(desc.partialContinueNotify, "warning");
+    }
+    // 8. Post-verify hook (called on success AND on partial-continue)
+    if (desc.postVerify) {
+        await desc.postVerify({ cwd, bundleRoot, toolsRoot, projectName, configCache, ctx, sendToAgent, isNonInteractive });
+    }
+    // 9. Write progress marker + completion notify
+    writeInitProgress(cwd, desc.phaseNum);
+    ctx.ui.notify(desc.completeNotify, "info");
+    return "ok";
+}
+// ── Phase descriptors ──────────────────────────────────────────────────────
+export const PHASE_1 = {
+    phaseNum: 1,
+    label: "1/4: Collect",
+    bannerName: "Collect",
+    bannerKey: "north",
+    preDispatchNotify: "Running 5 discovery scans in parallel...",
+    buildPrompt(bundleRoot, _cwd, projectName, _configCache) {
+        return buildPhase1PromptText(bundleRoot, projectName);
+    },
+    verify(cwd, _configCache) {
+        return verifyPhase1(cwd);
+    },
+    buildRetrySteer(result, _bundleRoot, _cwd) {
+        return (`Phase 1 verification failed. .forge/config.json is missing the following required fields: ${result.missing.join(", ")}.\n\n` +
+            `Write a complete .forge/config.json now using the \`write\` tool. Do NOT call subagents — analyze the project codebase yourself if needed. ` +
+            `Use the schema from the original Phase 1 prompt: version, project.{name,prefix}, stack, commands, and paths.{engineering,store,workflows,commands,templates} are all required.`);
+    },
+    nonInteractiveAbortMsg(result) {
+        return `× Phase 1 failed: ${result.missing.join(", ")}. Aborting init in non-interactive mode.`;
+    },
+    interactiveAbortPrompt(result) {
+        return {
+            title: "Phase 1 failed twice — continue with partial init?",
+            body: `.forge/config.json is still missing: ${result.missing.join(", ")}.\n\n` +
+                `Yes = continue (you'll need to /forge:regenerate later).\n` +
+                `No  = abort. Inspect the file manually and re-run /forge:init.`,
+        };
+    },
+    abortNotify: "× /forge:init aborted at Phase 1 verify.",
+    partialContinueNotify: "△ Continuing with partial Phase 1 — downstream phases may fail.",
+    completeNotify: "〇 Phase 1 complete.",
+    async postVerify({ cwd, toolsRoot, configCache, ctx, isNonInteractive }) {
+        // KB folder prompt (spec §7, F2) — G3: skipped in non-interactive mode (default: "engineering")
+        // Phrasing chosen so the default-Yes affirmative ("use engineering/") is the
+        // safe path. Pi's ctx.ui.confirm has no defaultValue option, so the question
+        // has to align with the highlighted default — earlier "does this conflict?"
+        // phrasing made the unsafe answer the default.
+        if (!isNonInteractive()) {
+            const kbDescription = `Forge will create a folder for architecture docs, sprints, bugs, and features.\n\n` +
+                `Use "engineering" as the folder name?  (Pick No only if your project already has an "engineering/" folder you don't want Forge to touch.)`;
+            const useDefault = await ctx.ui.confirm("Engineering folder name?", kbDescription);
+            if (!useDefault) {
+                const customName = await ctx.ui.input("Engineering folder name? Enter preferred folder name", "e.g. ai-docs, .forge-kb, docs/ai");
+                if (customName && customName.trim()) {
+                    const manageConfigToolEarly = path.join(toolsRoot, "manage-config.cjs");
+                    if (fs.existsSync(manageConfigToolEarly)) {
+                        await runToolAdvisory(manageConfigToolEarly, ["set", "paths.engineering", customName.trim()], cwd, ctx, "manage-config paths.engineering");
+                    }
+                }
+            }
+        }
+        // Marketplace skills advisory (sub-decision #1)
+        ctx.ui.notify("〇 Marketplace skills auto-recommendation is Claude-Code-only. " +
+            "Pi users install extensions manually. Writing installedSkills: []", "info");
+        // Write installedSkills: []
+        const manageConfigTool = path.join(toolsRoot, "manage-config.cjs");
+        if (fs.existsSync(manageConfigTool)) {
+            await runToolAdvisory(manageConfigTool, ["set", "installedSkills", "[]"], cwd, ctx, "manage-config installedSkills");
+            // Write mode = "full"
+            await runToolAdvisory(manageConfigTool, ["set", "mode", "full"], cwd, ctx, "manage-config mode");
+        }
+        void configCache; // used by descriptor runner; accessed here only to satisfy type
+    },
+};
+export const PHASE_2 = {
+    phaseNum: 2,
+    label: "2/4: Discover",
+    bannerName: "Discover",
+    bannerKey: "oracle",
+    buildPrompt(bundleRoot, cwd, projectName, configCache) {
+        let kbPath = "engineering";
+        const cachePaths = configCache.paths;
+        if (cachePaths && typeof cachePaths.engineering === "string" && cachePaths.engineering) {
+            kbPath = cachePaths.engineering;
+        }
+        // Scaffold dirs before dispatching to ensure they exist
+        const dirs = [
+            path.join(cwd, kbPath),
+            path.join(cwd, kbPath, "architecture"),
+            path.join(cwd, kbPath, "business-domain"),
+            path.join(cwd, kbPath, "sprints"),
+            path.join(cwd, ".forge", "store"),
+            path.join(cwd, ".forge", "cache"),
+        ];
+        for (const dir of dirs) {
+            try {
+                fs.mkdirSync(dir, { recursive: true });
+                const keepPath = path.join(dir, ".gitkeep");
+                if (!fs.existsSync(keepPath)) {
+                    fs.writeFileSync(keepPath, "", "utf8");
+                }
+            }
+            catch {
+                // non-fatal
+            }
+        }
+        return buildPhase2PromptText(bundleRoot, kbPath, projectName);
+    },
+    verify(cwd, configCache) {
+        let kbPath = "engineering";
+        const cachePaths = configCache.paths;
+        if (cachePaths && typeof cachePaths.engineering === "string" && cachePaths.engineering) {
+            kbPath = cachePaths.engineering;
+        }
+        return verifyPhase2(cwd, kbPath);
+    },
+    buildRetrySteer(result, bundleRoot, _cwd) {
+        return (`Phase 2 verification failed. The following architecture docs are missing:\n${result.missing.map((m) => `  - ${m}`).join("\n")}\n\n` +
+            `Write the missing files now using the \`write\` tool. Do NOT call subagents — analyze the project codebase yourself. ` +
+            `Use the rulebook at ${path.join(bundleRoot, ".init", "generation", "generate-kb-doc.md")} for the per-doc shape and confidence-header format.`);
+    },
+    nonInteractiveAbortMsg(result) {
+        return `× Phase 2 failed: ${result.missing.length} doc(s) still missing. Aborting init in non-interactive mode.`;
+    },
+    interactiveAbortPrompt(result) {
+        return {
+            title: "Phase 2 failed twice — continue with partial init?",
+            body: `Missing docs:\n${result.missing.map((m) => `  - ${m}`).join("\n")}\n\n` +
+                `Yes = continue (you'll need to fill these manually).\n` +
+                `No  = abort. Inspect the project and re-run /forge:init.`,
+        };
+    },
+    abortNotify: "× /forge:init aborted at Phase 2 verify.",
+    partialContinueNotify: "△ Continuing with partial Phase 2.",
+    completeNotify: "〇 Phase 2 complete.",
+    async postVerify({ cwd, bundleRoot, toolsRoot, projectName, configCache, ctx }) {
+        // Construct project-context.json — use configCache (written by Phase 1)
+        let kbPathResolved = "engineering";
+        let prefix = "";
+        {
+            const cacheProj = configCache.project;
+            if (cacheProj && typeof cacheProj.prefix === "string")
+                prefix = cacheProj.prefix;
+            const cachePaths2 = configCache.paths;
+            if (cachePaths2 && typeof cachePaths2.engineering === "string")
+                kbPathResolved = cachePaths2.engineering;
+        }
+        const projectCtx = buildProjectContext({
+            projectName: configCache.project?.name ?? projectName,
+            prefix,
+            kbPath: kbPathResolved,
+        }, configCache);
+        try {
+            validateProjectContext(projectCtx);
+            writeProjectContext(cwd, projectCtx);
+            ctx.ui.notify("〇 project-context.json written.", "info");
+        }
+        catch (err) {
+            const e = err;
+            ctx.ui.notify(`△ project-context.json validation failed: ${e.message ?? "unknown"} — proceeding.`, "warning");
+        }
+        // Calibration baseline — read bundled version from plugin.json (same pattern as phase4-register.ts step 4-8)
+        let bundledPluginVersion = "";
+        try {
+            const pluginPath = path.join(bundleRoot, ".claude-plugin", "plugin.json");
+            const plugin = JSON.parse(fs.readFileSync(pluginPath, "utf8"));
+            bundledPluginVersion = plugin.version ?? "";
+        }
+        catch {
+            // non-fatal — version field stays ""
+        }
+        const baseline = computeCalibrationBaseline(cwd, kbPathResolved, bundledPluginVersion);
+        const manageConfigTool = path.join(toolsRoot, "manage-config.cjs");
+        if (fs.existsSync(manageConfigTool)) {
+            await runToolAdvisory(manageConfigTool, ["set", "calibrationBaseline", JSON.stringify(baseline)], cwd, ctx, "manage-config calibrationBaseline");
+        }
+    },
+};
+export const PHASE_3 = {
+    phaseNum: 3,
+    label: "3/4: Materialize",
+    bannerName: "Materialize",
+    bannerKey: "supervisor",
+    // Phase 3 is deterministic — no LLM dispatch.
+    buildPrompt(_bundleRoot, _cwd, _projectName, _configCache) {
+        return null;
+    },
+    async runDeterministic(cwd, bundleRoot, toolsRoot, _configCache, ctx) {
+        const buildInitContextTool = path.join(toolsRoot, "build-init-context.cjs");
+        const substituteTool = path.join(toolsRoot, "substitute-placeholders.cjs");
+        const buildOverlayTool = path.join(toolsRoot, "build-overlay.cjs");
+        const basePackDir = path.join(bundleRoot, ".base-pack");
+        // 3a: build-init-context.cjs first build
+        if (fs.existsSync(buildInitContextTool)) {
+            await runToolAdvisory(buildInitContextTool, [
+                "--config",
+                path.join(cwd, ".forge", "config.json"),
+                "--personas",
+                path.join(cwd, ".forge", "personas"),
+                "--templates",
+                path.join(cwd, ".forge", "templates"),
+                "--kb",
+                cwd,
+                "--out",
+                path.join(cwd, ".forge", "init-context.md"),
+                "--json-out",
+                path.join(cwd, ".forge", "init-context.json"),
+            ], cwd, ctx, "build-init-context", 30000);
+        }
+        // 3b: substitute-placeholders.cjs — base-pack materialisation
+        if (fs.existsSync(substituteTool) && fs.existsSync(basePackDir)) {
+            await runToolAdvisory(substituteTool, [
+                "--forge-root",
+                bundleRoot,
+                "--base-pack",
+                basePackDir,
+                "--config",
+                path.join(cwd, ".forge", "config.json"),
+                "--context",
+                path.join(cwd, ".forge", "init-context.json"),
+                "--out",
+                cwd,
+            ], cwd, ctx, "substitute-placeholders", 60000);
+        }
+        // 3c: build-overlay.cjs smoke test (exit 1 is advisory)
+        if (fs.existsSync(buildOverlayTool)) {
+            await runToolAdvisory(buildOverlayTool, ["--task", "INIT-SMOKE-TEST", "--format", "json"], cwd, ctx, "build-overlay smoke (advisory)", 15000);
+        }
+    },
+    verify(cwd, _configCache) {
+        return verifyPhase3(cwd);
+    },
+    buildRetrySteer(_result, _bundleRoot, _cwd) {
+        // Phase 3 hard-fails — retry steer is not used.
+        return null;
+    },
+    nonInteractiveAbortMsg(result) {
+        return (`× Phase 3 failed: ${result.missing.join(", ")}. ` +
+            `This usually means substitute-placeholders.cjs ran against an incomplete config. ` +
+            `Fix .forge/config.json and run /forge:regenerate, or restart /forge:init from scratch (delete .forge/init-progress.json).`);
+    },
+    interactiveAbortPrompt(result) {
+        return {
+            title: "Phase 3 failed — abort init?",
+            body: `Phase 3 materialization failed: ${result.missing.join(", ")}.\n\n` +
+                `This usually means substitute-placeholders.cjs ran against an incomplete config.\n` +
+                `Fix .forge/config.json and run /forge:regenerate.`,
+        };
+    },
+    abortNotify: "× /forge:init aborted at Phase 3 verify.",
+    partialContinueNotify: "△ Continuing with partial Phase 3.",
+    completeNotify: "〇 Phase 3 complete.",
+    // Phase 3 hard-fails on verify error — no retry, no user confirm.
+    hardFailOnVerifyError: true,
+};
+//# sourceMappingURL=phase-descriptors.js.map

package/dist/extensions/forgecli/forge-init/phase-descriptors.js.map

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

package/dist/extensions/forgecli/forge-init/phase4-register.d.ts

@@ -0,0 +1,20 @@
+import type { ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
+export interface Phase4Result {
+    kbPathFinal: string;
+}
+export interface Phase4Context {
+    cwd: string;
+    bundleRoot: string;
+    toolsRoot: string;
+    projectName: string;
+    configCache: Record<string, unknown>;
+    ctx: ExtensionCommandContext;
+    isPiRuntime: () => boolean;
+    getBundledToolsRoot: () => string;
+}
+/**
+ * Run Phase 4 — Register: 11 deterministic steps.
+ *
+ * Returns `Phase4Result` on success or `"abort"` if Step 4-1 fails (missing store-cli.cjs).
+ */
+export declare function runPhase4(ctx4: Phase4Context): Promise<Phase4Result | "abort">;