@entelligentsia/forgecli 0.21.0 → 1.0.3

package/node_modules/@entelligentsia/forge-compress/src/progressive.ts

@@ -0,0 +1,123 @@
+import { countTokens, truncateToTokenBudget } from "./tokens.js";
+
+const LAMBDA = 1.35;
+
+function expWeights(n: number): number[] {
+  return Array.from({ length: n }, (_, i) => Math.exp(LAMBDA * i));
+}
+
+function allocateBudget(budgetTokens: number, weights: number[]): number[] {
+  const n = weights.length;
+  if (n === 0 || budgetTokens === 0) return new Array(n).fill(0);
+
+  const sumW = Math.max(weights.reduce((a, b) => a + b, 0), Number.EPSILON);
+  const base = new Array(n).fill(0);
+  const frac = new Array(n).fill(0);
+
+  for (let i = 0; i < n; i++) {
+    const exact = (budgetTokens * weights[i]) / sumW;
+    base[i] = Math.floor(exact);
+    frac[i] = exact - base[i];
+  }
+
+  const given = base.reduce((a: number, b: number) => a + b, 0);
+  const order = Array.from({ length: n }, (_, i) => i).sort(
+    (a, b) => frac[b] - frac[a],
+  );
+
+  let extra = budgetTokens - given;
+  for (const i of order) {
+    if (extra <= 0) break;
+    base[i]++;
+    extra--;
+  }
+  return base;
+}
+
+function tierForIndex(i: number, n: number): number {
+  if (n <= 1) return 2;
+  const r = i / (n - 1);
+  if (r < 1 / 3) return 0;
+  if (r < 2 / 3) return 1;
+  return 2;
+}
+
+const STRUCTURE_KEYWORDS = [
+  "fn ",
+  "pub ",
+  "struct ",
+  "enum ",
+  "trait ",
+  "impl ",
+  "mod ",
+  "use ",
+  "def ",
+  "class ",
+  "function ",
+  "export ",
+  "import ",
+  "const ",
+  "interface ",
+];
+
+function mapLike(s: string, maxTokens: number): string {
+  const picked: string[] = [];
+  const lines = s.split("\n");
+  for (let i = 0; i < lines.length; i++) {
+    if (i === 0 || STRUCTURE_KEYWORDS.some((k) => lines[i].includes(k))) {
+      picked.push(lines[i]);
+    }
+    if (picked.length >= 48) break;
+  }
+  if (picked.length === 0 && lines.length > 0) {
+    picked.push(lines[0]);
+  }
+  return truncateToTokenBudget(picked.join("\n"), Math.max(4, maxTokens));
+}
+
+function oneLineSummary(
+  segIdx: number,
+  s: string,
+  maxTokens: number,
+): string {
+  const preview = s.split("\n")[0]?.slice(0, 120) ?? "";
+  const lineCount = s.split("\n").length;
+  const draft = `// seg[${segIdx}] ${lineCount} lines, ${s.length} chars | ${preview}`;
+  return truncateToTokenBudget(draft, Math.max(8, maxTokens));
+}
+
+export function compressProgressive(
+  segments: string[],
+  budgetTokens: number,
+): string[] {
+  const n = segments.length;
+  if (n === 0) return [];
+  if (budgetTokens === 0) return segments.map(() => "");
+
+  const weights = expWeights(n);
+  const allocs = allocateBudget(budgetTokens, weights);
+  const out: string[] = [];
+
+  for (let i = 0; i < n; i++) {
+    const alloc = allocs[i];
+    const tier = tierForIndex(i, n);
+    if (alloc === 0) {
+      out.push("");
+      continue;
+    }
+    let compressed: string;
+    switch (tier) {
+      case 2:
+        compressed = truncateToTokenBudget(segments[i], alloc);
+        break;
+      case 1:
+        compressed = mapLike(segments[i], alloc);
+        break;
+      default:
+        compressed = oneLineSummary(i, segments[i], alloc);
+        break;
+    }
+    out.push(truncateToTokenBudget(compressed, alloc));
+  }
+  return out;
+}

package/node_modules/@entelligentsia/forge-compress/src/strip.ts

@@ -0,0 +1,58 @@
+const ANSI_RE = /\x1b\[[0-9;]*[a-zA-Z]/g;
+
+export function stripAnsi(s: string): string {
+  if (!s.includes("\x1b")) return s;
+  return s.replace(ANSI_RE, "");
+}
+
+const TS_RE =
+  /\d{4}-\d{2}-\d{2}[T ]\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:Z|[+-]\d{2}:?\d{2})?/g;
+const HASH_RE = /\b[0-9a-f]{32,64}\b/g;
+
+export function stripTimestampsAndHashes(line: string): string {
+  return line.replace(TS_RE, "[TS]").replace(HASH_RE, "[HASH]");
+}
+
+export function normalizeWhitespace(line: string): string {
+  let result = "";
+  let prevSpace = false;
+  for (const ch of line) {
+    if (ch === " " || ch === "\t") {
+      if (!prevSpace) {
+        result += " ";
+        prevSpace = true;
+      }
+    } else {
+      result += ch;
+      prevSpace = false;
+    }
+  }
+  return result;
+}
+
+const BOILERPLATE_PREFIXES = [
+  "copyright",
+  "licensed under",
+  "license:",
+  "all rights reserved",
+  "generated by",
+  "auto-generated",
+];
+
+const SEPARATOR_CHARS = new Set(["=", "-", "*", "─", "━"]);
+
+export function isBoilerplate(line: string): boolean {
+  const lower = line.toLowerCase();
+  if (BOILERPLATE_PREFIXES.some((p) => lower.startsWith(p))) return true;
+  if (line.length >= 4) {
+    const first = line[0];
+    if (SEPARATOR_CHARS.has(first)) {
+      let same = 0;
+      for (const c of line) {
+        if (c === first) same++;
+      }
+      if (same / line.length > 0.8) return true;
+    }
+  }
+  return false;
+}

package/node_modules/@entelligentsia/forge-compress/src/tokens.ts

@@ -0,0 +1,19 @@
+const CHARS_PER_TOKEN = 3.7;
+
+export function countTokens(text: string): number {
+  if (!text) return 0;
+  return Math.ceil(text.length / CHARS_PER_TOKEN);
+}
+
+export function truncateToTokenBudget(
+  text: string,
+  maxTokens: number,
+): string {
+  if (maxTokens <= 0) return "";
+  if (countTokens(text) <= maxTokens) return text;
+  const charBudget = Math.floor(maxTokens * CHARS_PER_TOKEN);
+  const truncated = text.slice(0, charBudget);
+  const lastNewline = truncated.lastIndexOf("\n");
+  const clean = lastNewline > 0 ? truncated.slice(0, lastNewline) : truncated;
+  return `${clean} …`;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@entelligentsia/forgecli",
-  "version": "0.21.0",
+  "version": "1.0.3",
   "description": "Forge SDLC ported onto @earendil-works/pi-coding-agent \u2014 production launcher with three bin aliases (forge/forgecli/4ge). Bundles a curated fork of pi-coding-agent vendored under earendil-works names.",
   "license": "MIT",
   "author": "Entelligentsia",
@@ -71,20 +71,22 @@
     "@earendil-works/pi-agent-core",
     "@earendil-works/pi-ai",
     "@earendil-works/pi-tui",
+    "@entelligentsia/forge-compress",
     "js-yaml"
   ],
   "dependencies": {
-    "@earendil-works/pi-agent-core": "file:./vendor-pi/earendil-works-pi-agent-core-0.75.4.tgz",
-    "@earendil-works/pi-ai": "file:./vendor-pi/earendil-works-pi-ai-0.75.4.tgz",
-    "@earendil-works/pi-coding-agent": "file:./vendor-pi/earendil-works-pi-coding-agent-0.75.4-forge.1.tgz",
-    "@earendil-works/pi-tui": "file:./vendor-pi/earendil-works-pi-tui-0.75.4.tgz",
+    "@earendil-works/pi-agent-core": "file:./vendor-pi/earendil-works-pi-agent-core-0.75.5.tgz",
+    "@earendil-works/pi-ai": "file:./vendor-pi/earendil-works-pi-ai-0.75.5.tgz",
+    "@earendil-works/pi-coding-agent": "file:./vendor-pi/earendil-works-pi-coding-agent-0.75.5-forge.1.tgz",
+    "@earendil-works/pi-tui": "file:./vendor-pi/earendil-works-pi-tui-0.75.5.tgz",
     "ajv": "^8.20.0",
     "js-yaml": "^4.1.0",
+    "@entelligentsia/forge-compress": "file:../forge-compress",
     "lunr": "2.3.9",
     "typebox": "^1.1.24"
   },
   "peerDependencies": {
-    "@earendil-works/pi-coding-agent": "0.75.4-forge.1"
+    "@earendil-works/pi-coding-agent": "0.75.5-forge.1"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.3.5",
@@ -97,12 +99,5 @@
   },
   "engines": {
     "node": ">=20.6.0"
-  },
-  "bundleDependencies": [
-    "@earendil-works/pi-coding-agent",
-    "@earendil-works/pi-agent-core",
-    "@earendil-works/pi-ai",
-    "@earendil-works/pi-tui",
-    "js-yaml"
-  ]
-}
+  }
+}

package/dist/extensions/forgecli/forge-init/phase-descriptors.d.ts

@@ -1,72 +0,0 @@
-import type { ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
-export interface VerifyResult {
-    ok: boolean;
-    missing: string[];
-    reason?: string;
-}
-/** Context passed to the `postVerify` hook. */
-export interface PostVerifyContext {
-    cwd: string;
-    bundleRoot: string;
-    toolsRoot: string;
-    projectName: string;
-    configCache: Record<string, unknown>;
-    ctx: ExtensionCommandContext;
-    sendToAgent: (text: string) => void;
-    isNonInteractive: () => boolean;
-}
-/**
- * Descriptor for a single init phase.
- *
- * LLM phases (1, 2): `buildPrompt` returns a string; `runLlmPhase` dispatches via
- * `sendToAgent` + `waitForIdle` then verifies.
- *
- * Deterministic phases (3): `buildPrompt` returns `null`; `runDeterministic` runs
- * tool calls directly without LLM dispatch.
- */
-export interface LlmPhaseDescriptor {
-    phaseNum: 1 | 2 | 3;
-    label: string;
-    bannerName: string;
-    bannerKey: string;
-    /**
-     * Build the prompt to send to the agent. Return `null` for deterministic phases
-     * that run tool calls directly (Phase 3).
-     */
-    buildPrompt: (bundleRoot: string, cwd: string, projectName: string, configCache: Record<string, unknown>) => string | null;
-    /** Direct tool execution for deterministic phases (called when buildPrompt returns null). */
-    runDeterministic?: (cwd: string, bundleRoot: string, toolsRoot: string, configCache: Record<string, unknown>, ctx: ExtensionCommandContext) => Promise<void>;
-    /** Optional notification emitted before LLM dispatch (e.g. Phase 1 parallel-scan notice). */
-    preDispatchNotify?: string;
-    verify: (cwd: string, configCache: Record<string, unknown>) => VerifyResult;
-    buildRetrySteer: (result: VerifyResult, bundleRoot: string, cwd: string) => string | null;
-    nonInteractiveAbortMsg: (result: VerifyResult) => string;
-    interactiveAbortPrompt: (result: VerifyResult) => {
-        title: string;
-        body: string;
-    };
-    abortNotify: string;
-    partialContinueNotify: string;
-    completeNotify: string;
-    /** When true, a failed verify aborts immediately with no retry or user confirm. Default: false. */
-    hardFailOnVerifyError?: boolean;
-    /**
-     * Optional async hook invoked after the failure-handling decision completes (both on
-     * success and on partial-continue). NOT called when the phase returns "abort".
-     */
-    postVerify?: (ctx: PostVerifyContext) => Promise<void> | void;
-}
-/**
- * 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 declare function runLlmPhase(desc: LlmPhaseDescriptor, ctx: ExtensionCommandContext, cwd: string, bundleRoot: string, toolsRoot: string, projectName: string, configCache: Record<string, unknown>, sendToAgent: (text: string) => void, waitForIdle: () => Promise<void>, isNonInteractive: () => boolean): Promise<"ok" | "abort">;
-export declare const PHASE_1: LlmPhaseDescriptor;
-export declare const PHASE_2: LlmPhaseDescriptor;
-export declare const PHASE_3: LlmPhaseDescriptor;

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

@@ -1,359 +0,0 @@
-// 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 fs from "node:fs";
-import * as path from "node:path";
-import { buildProjectContext, computeCalibrationBaseline, validateProjectContext, writeProjectContext, } from "../init-context.js";
-import { writeInitProgress } from "../init-progress.js";
-import { execFileAsync, runToolAdvisory } from "../lib/exec-helpers.js";
-import { buildPhase1PromptText, buildPhase2PromptText } from "./prompts.js";
-import { verifyPhase1, verifyPhase2, verifyPhase3 } from "./verifiers.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