@entelligentsia/forgecli 0.15.0 → 0.20.0

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

@@ -0,0 +1,353 @@
+// forge-init/phase4-register.ts — Phase 4 Register extraction (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.
+//
+// Key contract:
+//   - Returns `Phase4Result { kbPathFinal }` on success — caller reads kbPathFinal for
+//     the post-init report section.
+//   - Returns `"abort"` when Step 4-1 detects store-cli.cjs is missing (half-built dist).
+//     The caller MUST handle "abort" and return immediately from the init handler.
+//   - `deleteInitProgress` is called on successful completion.
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { deleteInitProgress } from "../init-progress.js";
+import { execFileAsync, runToolAdvisory } from "../lib/exec-helpers.js";
+import { getRefreshKbLinksHandler } from "../refresh-kb-links.js";
+// ── Private helpers ────────────────────────────────────────────────────────
+function updateGitignore(cwd, ctx) {
+    const gitignorePath = path.join(cwd, ".gitignore");
+    if (!fs.existsSync(gitignorePath)) {
+        return;
+    }
+    let content;
+    try {
+        content = fs.readFileSync(gitignorePath, "utf8");
+    }
+    catch {
+        return;
+    }
+    const IGNORE_PATTERNS = [".forge/store/events/", ".forge/store/events", ".forge/store/", ".forge/"];
+    const lines = content.split("\n");
+    const alreadyIgnored = lines.some((line) => {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith("#"))
+            return false;
+        return IGNORE_PATTERNS.some((pat) => trimmed.includes(pat));
+    });
+    if (alreadyIgnored) {
+        ctx.ui.notify("〇 .forge/store/events/ already gitignored — skipped.", "info");
+        return;
+    }
+    const toAppend = "\n# Forge — transient agent event logs (one file per phase, do not commit)\n.forge/store/events/\n";
+    try {
+        fs.appendFileSync(gitignorePath, toAppend, "utf8");
+        ctx.ui.notify("〇 Appended .forge/store/events/ to .gitignore.", "info");
+    }
+    catch {
+        ctx.ui.notify("△ Could not update .gitignore — update manually.", "warning");
+    }
+}
+function collectMdFiles(dir) {
+    if (!fs.existsSync(dir))
+        return [];
+    const results = [];
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+        const full = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            results.push(...collectMdFiles(full));
+        }
+        else if (entry.isFile() && entry.name.endsWith(".md")) {
+            results.push(full);
+        }
+    }
+    return results;
+}
+function isNonInteractiveLocal() {
+    return process.env.FORGE_YES === "1" || process.env.FORGE_NON_INTERACTIVE === "1";
+}
+async function linkAgentInstructionFile(cwd, kbPath, projectName, ctx) {
+    const INSTRUCTION_FILES = ["CLAUDE.md", "AGENTS.md", "CLAUDE.local.md", ".cursorrules"];
+    const existing = INSTRUCTION_FILES.filter((f) => fs.existsSync(path.join(cwd, f)));
+    if (existing.length > 0) {
+        // Already exists — do NOT modify (per spec step 4-11: avoid KB-link bloat)
+        return;
+    }
+    // None exist — prompt to create minimal CLAUDE.md (G4: bypassed in non-interactive mode)
+    const ok = isNonInteractiveLocal()
+        ? true
+        : await ctx.ui.confirm("Create CLAUDE.md?", `No agent instruction file found at project root.\nCreate a minimal CLAUDE.md with links to the Forge knowledge base? [Y/n]`);
+    if (!ok) {
+        ctx.ui.notify("〇 KB not linked — run /forge:refresh-kb-links after creating CLAUDE.md.", "info");
+        return;
+    }
+    const claudeMdPath = path.join(cwd, "CLAUDE.md");
+    const content = [
+        `# ${projectName}`,
+        ``,
+        `## Forge Knowledge Base`,
+        ``,
+        `| Index | Contents |`,
+        `|-------|----------|`,
+        `| [MASTER_INDEX](${kbPath}/MASTER_INDEX.md) | All sprints, tasks, bugs, and features |`,
+        `| [Architecture](${kbPath}/architecture/INDEX.md) | Stack, processes, database, routing, deployment |`,
+        `| [Business Domain](${kbPath}/business-domain/INDEX.md) | Entity model and domain concepts |`,
+        ``,
+        `## Forge Workflows`,
+        ``,
+        `| Workflow | Purpose |`,
+        `|----------|---------|`,
+        `| /forge:plan | Research codebase, produce implementation plan |`,
+        `| /forge:implement | Execute approved plan, make code changes |`,
+        `| /forge:validate | Validate task implementation against acceptance criteria |`,
+        `| /forge:approve | Final architect approval gate |`,
+        `| /forge:commit | Stage and commit completed task artifacts |`,
+        `| /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 |`,
+        ``,
+        `---`,
+        `_Generated by /forge:init. Run /forge:refresh-kb-links to update._`,
+        ``,
+    ].join("\n");
+    try {
+        fs.writeFileSync(claudeMdPath, content, "utf8");
+        ctx.ui.notify("〇 Created CLAUDE.md with KB links.", "info");
+    }
+    catch (err) {
+        const e = err;
+        ctx.ui.notify(`△ Could not create CLAUDE.md: ${e.message ?? "unknown"}`, "warning");
+    }
+}
+// ── Phase 4 runner ─────────────────────────────────────────────────────────
+/**
+ * Run Phase 4 — Register: 11 deterministic steps.
+ *
+ * Returns `Phase4Result` on success or `"abort"` if Step 4-1 fails (missing store-cli.cjs).
+ */
+export async function runPhase4(ctx4) {
+    const { cwd, bundleRoot, toolsRoot, projectName, configCache, ctx, isPiRuntime, getBundledToolsRoot: getToolsRoot, } = ctx4;
+    ctx.ui.setStatus?.("forge:init", "Phase 4/4: Register");
+    // Banner
+    const bannersTool = path.join(toolsRoot, "banners.cjs");
+    if (fs.existsSync(bannersTool)) {
+        await execFileAsync("node", [bannersTool, "--phase", "4", "4", "Register", "forge"], {
+            cwd,
+            timeout: 5000,
+        }).catch(() => {
+            /* non-fatal */
+        });
+    }
+    const manageConfigTool = path.join(toolsRoot, "manage-config.cjs");
+    const manageVersionsTool = path.join(toolsRoot, "manage-versions.cjs");
+    const generationManifestTool = path.join(toolsRoot, "generation-manifest.cjs");
+    const buildPersonaPackTool = path.join(toolsRoot, "build-persona-pack.cjs");
+    const buildContextPackTool = path.join(toolsRoot, "build-context-pack.cjs");
+    const buildInitContextTool = path.join(toolsRoot, "build-init-context.cjs");
+    const seedStoreTool = path.join(toolsRoot, "seed-store.cjs");
+    // ── Step 4-1: write paths.forgeRoot + copy schemas ──────────────────────
+    // Stamp paths.forgeRoot to the bundle root (dist/forge-payload/) so
+    // that the canonical Forge convention "$FORGE_ROOT/tools/<tool>.cjs"
+    // resolves correctly. The bundled tools live at
+    // dist/forge-payload/tools/ (renamed from .tools/ — the dot prefix
+    // broke the convention and forced consumers/workflows to special-case
+    // the layout).
+    if (fs.existsSync(manageConfigTool)) {
+        // Validate that store-cli.cjs is present in the bundled tools dir
+        // before stamping. Guards against half-built dist trees.
+        let forgeRootToStamp;
+        if (isPiRuntime()) {
+            const runtimeToolsRoot = getToolsRoot();
+            const storeCli = path.join(runtimeToolsRoot, "store-cli.cjs");
+            if (!fs.existsSync(storeCli)) {
+                ctx.ui.notify(`× step 4-1 paths.forgeRoot: store-cli.cjs missing from bundled tools (expected: ${storeCli}). ` +
+                    "Run 'npm run build' to populate dist/forge-payload/tools/. Aborting Phase 4.", "error");
+                return "abort";
+            }
+            forgeRootToStamp = bundleRoot;
+        }
+        else {
+            // Claude Code path (not active today — preserved for future use)
+            forgeRootToStamp = bundleRoot;
+        }
+        await runToolAdvisory(manageConfigTool, ["set", "paths.forgeRoot", forgeRootToStamp], cwd, ctx, "step 4-1 paths.forgeRoot");
+    }
+    const schemasSrc = path.join(bundleRoot, ".schemas");
+    const schemasDest = path.join(cwd, ".forge", "schemas");
+    fs.mkdirSync(schemasDest, { recursive: true });
+    if (fs.existsSync(schemasSrc)) {
+        const schemaFiles = fs.readdirSync(schemasSrc).filter((f) => f.endsWith(".json"));
+        for (const f of schemaFiles) {
+            try {
+                fs.copyFileSync(path.join(schemasSrc, f), path.join(schemasDest, f));
+            }
+            catch {
+                // non-fatal
+            }
+        }
+        ctx.ui.notify(`〇 Copied ${schemaFiles.length} schema files to .forge/schemas/.`, "info");
+    }
+    // Step 4-1b: enhancement substrate
+    const enhancementsDir = path.join(cwd, ".forge", "enhancements");
+    fs.mkdirSync(enhancementsDir, { recursive: true });
+    const overlaySchemaPath = path.join(schemasSrc, "project-overlay.schema.json");
+    if (fs.existsSync(overlaySchemaPath)) {
+        try {
+            fs.copyFileSync(overlaySchemaPath, path.join(schemasDest, "project-overlay.schema.json"));
+        }
+        catch {
+            // non-fatal
+        }
+    }
+    // ── Step 4-2: manage-versions init ──────────────────────────────────────
+    if (fs.existsSync(manageVersionsTool)) {
+        await runToolAdvisory(manageVersionsTool, ["init"], cwd, ctx, "step 4-2 manage-versions");
+    }
+    // ── Step 4-3: generation-manifest seed + record-all ─────────────────────
+    // record-all re-hashes already-tracked files but is a no-op on an empty
+    // manifest. When Phase 2 ran inline (no subagent dispatch), the model skips
+    // the per-file self-check step that calls `record <path>`, leaving the
+    // manifest empty. Seed first by recording every .md in the KB directory so
+    // record-all has something to work with regardless of which Phase 2 path ran.
+    if (fs.existsSync(generationManifestTool)) {
+        const engPath = (() => {
+            const p = configCache.paths;
+            return p && typeof p.engineering === "string" ? p.engineering : "engineering";
+        })();
+        const kbDir = path.join(cwd, engPath);
+        for (const mdFile of collectMdFiles(kbDir)) {
+            await runToolAdvisory(generationManifestTool, ["record", mdFile], cwd, ctx, `step 4-3 generation-manifest seed: ${path.relative(cwd, mdFile)}`, 10000);
+        }
+        await runToolAdvisory(generationManifestTool, ["record-all"], cwd, ctx, "step 4-3 generation-manifest record-all", 30000);
+    }
+    // ── Step 4-4: build-persona-pack ─────────────────────────────────────────
+    if (fs.existsSync(buildPersonaPackTool)) {
+        await runToolAdvisory(buildPersonaPackTool, ["--out", path.join(cwd, ".forge", "cache", "persona-pack.json")], cwd, ctx, "step 4-4 build-persona-pack", 30000);
+    }
+    // ── Step 4-5: build-context-pack — extract kbPathFinal from configCache ──
+    let kbPathFinal = "engineering";
+    {
+        const p = configCache.paths;
+        if (p && typeof p.engineering === "string")
+            kbPathFinal = p.engineering;
+    }
+    if (fs.existsSync(buildContextPackTool)) {
+        await runToolAdvisory(buildContextPackTool, [
+            "--arch-dir",
+            path.join(cwd, kbPathFinal, "architecture"),
+            "--out-md",
+            path.join(cwd, ".forge", "cache", "context-pack.md"),
+            "--out-json",
+            path.join(cwd, ".forge", "cache", "context-pack.json"),
+        ], cwd, ctx, "step 4-5 build-context-pack", 30000);
+    }
+    // ── Step 4-6: build-init-context final rebuild ───────────────────────────
+    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, "step 4-6 build-init-context final", 30000);
+    }
+    // ── Step 4-7: seed-store ─────────────────────────────────────────────────
+    if (fs.existsSync(seedStoreTool)) {
+        await runToolAdvisory(seedStoreTool, [], cwd, ctx, "step 4-7 seed-store", 30000);
+    }
+    // ── Step 4-8: update-check cache baseline ────────────────────────────────
+    const updateCachePath = path.join(cwd, ".forge", "update-check-cache.json");
+    try {
+        const pluginPath = path.join(bundleRoot, ".claude-plugin", "plugin.json");
+        const pluginRaw = fs.readFileSync(pluginPath, "utf8");
+        const plugin = JSON.parse(pluginRaw);
+        const bundledVersion = plugin.version ?? "0.0.0";
+        const cache = {
+            lastChecked: new Date().toISOString(),
+            installedVersion: bundledVersion,
+            latestVersion: bundledVersion,
+            upToDate: true,
+        };
+        fs.writeFileSync(updateCachePath, JSON.stringify(cache, null, 2) + "\n", "utf8");
+        ctx.ui.notify("〇 Update-check cache baseline written.", "info");
+    }
+    catch {
+        ctx.ui.notify("△ Could not write update-check cache — non-fatal.", "warning");
+    }
+    // ── Step 4-9: Tomoshibi — invoke refresh-kb-links handler directly ───────
+    try {
+        const refreshHandler = getRefreshKbLinksHandler();
+        const refreshResult = await refreshHandler(cwd);
+        for (const msg of refreshResult.messages) {
+            ctx.ui.notify(msg, "info");
+        }
+        if (refreshResult.filesUpdated === 0) {
+            ctx.ui.notify("△ Run /forge:refresh-kb-links manually after init completes " + "(no agent instruction files found).", "info");
+        }
+    }
+    catch (err) {
+        const e = err;
+        ctx.ui.notify(`△ Tomoshibi (refresh-kb-links) failed: ${e.message ?? "unknown"} — ` +
+            "Run /forge:refresh-kb-links manually after init completes.", "warning");
+    }
+    // ── Step 4-10: .gitignore update ─────────────────────────────────────────
+    updateGitignore(cwd, ctx);
+    // Step 4-10b: BUG-025 fix — remove Claude-Code-only .claude/commands/ artifact.
+    // substitute-placeholders.cjs (Phase 3) unconditionally writes command .md files
+    // to .claude/commands/<prefix>/ regardless of runtime. Under pi runtime pi never
+    // scans .claude/commands/ (commands are discovered via programmatic registerCommand
+    // in registerAllForgeCommands). Delete the directory so it does not pollute the
+    // project root. This runs in Phase 4 so it handles both same-session and resumed
+    // inits (where Phase 3 ran in a prior session).
+    if (isPiRuntime()) {
+        // Use configCache — Phase 1 wrote config.json and configCache was populated before Phase 2
+        let commandsPrefix = "forge";
+        {
+            const proj = configCache.project;
+            if (proj && typeof proj.prefix === "string" && proj.prefix) {
+                commandsPrefix = proj.prefix.toLowerCase();
+            }
+        }
+        const claudeCommandsDir = path.join(cwd, ".claude", "commands", commandsPrefix);
+        if (fs.existsSync(claudeCommandsDir)) {
+            try {
+                fs.rmSync(claudeCommandsDir, { recursive: true, force: true });
+                // Remove empty ancestor dirs best-effort
+                const parentDir = path.join(cwd, ".claude", "commands");
+                try {
+                    if (fs.readdirSync(parentDir).length === 0) {
+                        fs.rmdirSync(parentDir);
+                        const grandparent = path.join(cwd, ".claude");
+                        if (fs.readdirSync(grandparent).length === 0)
+                            fs.rmdirSync(grandparent);
+                    }
+                }
+                catch {
+                    // best-effort
+                }
+            }
+            catch (err) {
+                const e = err;
+                ctx.ui.notify(`△ Could not remove .claude/commands/${commandsPrefix}/: ${e.message ?? "unknown"} — non-fatal.`, "warning");
+            }
+        }
+    }
+    // ── Step 4-11: agent instruction file linking ─────────────────────────────
+    await linkAgentInstructionFile(cwd, kbPathFinal, projectName, ctx);
+    // Completion — delete init-progress (always at the END, after all steps succeed)
+    deleteInitProgress(cwd);
+    ctx.ui.notify("〇 Phase 4 complete — /forge:init done.", "info");
+    return { kbPathFinal };
+}
+//# sourceMappingURL=phase4-register.js.map

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

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

package/dist/extensions/forgecli/forge-init/prompts.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Build the Phase 1 prompt: instructs the agent to run 5 parallel discovery scans
+ * and synthesize results into `.forge/config.json`.
+ */
+export declare function buildPhase1PromptText(bundleRoot: string, projectName: string): string;
+/**
+ * Build the Phase 2 prompt: instructs the agent to generate 7 parallel KB docs
+ * under `kbPath/architecture/`.
+ */
+export declare function buildPhase2PromptText(bundleRoot: string, kbPath: string, projectName: string): string;

package/dist/extensions/forgecli/forge-init/prompts.js

@@ -0,0 +1,91 @@
+// forge-init/prompts.ts — phase prompt text builders (FORGE-S25-T23, B-4)
+//
+// Centralises the LLM prompt strings sent to the agent via `sendToAgent` during init phases.
+// Keeping these out of forge-init.ts makes the orchestration logic easier to read and the
+// prompt text easier to iterate on independently.
+import * as path from "node:path";
+/**
+ * Build the Phase 1 prompt: instructs the agent to run 5 parallel discovery scans
+ * and synthesize results into `.forge/config.json`.
+ */
+export function buildPhase1PromptText(bundleRoot, projectName) {
+    const discoveryDir = path.join(bundleRoot, ".init", "discovery");
+    const topics = ["stack", "processes", "database", "routing", "testing"];
+    const topicLines = topics.map((t) => `  • ${path.join(discoveryDir, `discover-${t}.md`)}`).join("\n");
+    return `## /forge:init Phase 1 — Collect: 5 parallel discovery scans
+
+Project: ${projectName}
+
+Run 5 discovery scans concurrently. In a single response, issue 5 parallel tool
+calls — one per discovery topic — using whatever read/search tools you have
+available (Read, Glob, Grep, Bash). If a \`subagent\` tool is exposed in your
+toolset, you MAY dispatch via it (mode: "parallel"); otherwise execute the
+scans inline. Do NOT preface with "I don't have a subagent tool" — either path
+is acceptable, what matters is concurrency and the resulting deliverable.
+
+For each topic:
+1. Read the discovery prompt file at its assigned path (shown below)
+2. Analyze the current project codebase
+3. Capture structured findings
+
+Discovery prompt files:
+${topicLines}
+
+After all 5 complete, synthesize the findings into a unified config and write .forge/config.json.
+
+Required .forge/config.json structure:
+{
+  "version": "1",
+  "project": { "name": "${projectName}", "prefix": "<UPPERCASE_ABBREV>" },
+  "stack": { "primary": [...], "test": <framework>, "build": <tool>, "lint": <tool> },
+  "commands": { "test": "<test cmd>", "build": "<build cmd>", "lint": "<lint cmd>" },
+  "paths": {
+    "engineering": "engineering",
+    "store": ".forge/store",
+    "workflows": ".forge/workflows",
+    "commands": ".claude/commands/forge",
+    "templates": ".forge/templates"
+  }
+}
+
+Write the config with: node "${path.join(bundleRoot, "tools/manage-config.cjs")}" set <key> <value>
+Or write .forge/config.json directly as valid JSON.`;
+}
+/**
+ * Build the Phase 2 prompt: instructs the agent to generate 7 parallel KB docs
+ * under `kbPath/architecture/`.
+ */
+export function buildPhase2PromptText(bundleRoot, kbPath, projectName) {
+    const generateKbDocPath = path.join(bundleRoot, ".init", "generation", "generate-kb-doc.md");
+    const docs = ["stack", "processes", "database", "routing", "deployment", "entity-model", "stack-checklist"];
+    const docLines = docs.map((d) => `  • ${kbPath}/architecture/${d}.md`).join("\n");
+    return `## /forge:init Phase 2 — Discover: 7 parallel KB doc generation
+
+Project: ${projectName}
+KB path: ${kbPath}/
+Rulebook: ${generateKbDocPath}
+
+Generate 7 knowledge-base documents concurrently. In a single response, issue
+7 parallel tool calls — one per document — using whatever read/search/write
+tools you have available (Read, Glob, Grep, Bash, Write). If a \`subagent\`
+tool is exposed in your toolset, you MAY dispatch via it (mode: "parallel");
+otherwise execute the generation inline. Do NOT preface with "I don't have a
+subagent tool" — either path is acceptable, what matters is concurrency and
+the 7 output files.
+
+For each document:
+1. Read the rulebook at: ${generateKbDocPath}
+2. Analyze the project codebase for its assigned topic
+3. Write the resulting document to its assigned output file
+
+Documents to generate:
+${docLines}
+
+After all complete, check for any that returned "FAILED:" in their output — retry those once.
+
+Also create these index files after generation:
+- ${kbPath}/architecture/INDEX.md
+- ${kbPath}/business-domain/INDEX.md
+- ${kbPath}/MASTER_INDEX.md (scaffold)`;
+}
+//# sourceMappingURL=prompts.js.map

package/dist/extensions/forgecli/forge-init/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../../../src/extensions/forgecli/forge-init/prompts.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,EAAE;AACF,6FAA6F;AAC7F,0FAA0F;AAC1F,kDAAkD;AAElD,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,UAAkB,EAAE,WAAmB;IAC5E,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;IACjE,MAAM,MAAM,GAAG,CAAC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IACxE,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEtG,OAAO;;WAEG,WAAW;;;;;;;;;;;;;;;EAepB,UAAU;;;;;;;0BAOc,WAAW;;;;;;;;;;;;+BAYN,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,yBAAyB,CAAC;oDAC3B,CAAC;AACrD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,UAAkB,EAAE,MAAc,EAAE,WAAmB;IAC5F,MAAM,iBAAiB,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,YAAY,EAAE,oBAAoB,CAAC,CAAC;IAC7F,MAAM,IAAI,GAAG,CAAC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,cAAc,EAAE,iBAAiB,CAAC,CAAC;IAC5G,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,MAAM,iBAAiB,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAElF,OAAO;;WAEG,WAAW;WACX,MAAM;YACL,iBAAiB;;;;;;;;;;;2BAWF,iBAAiB;;;;;EAK1C,QAAQ;;;;;IAKN,MAAM;IACN,MAAM;IACN,MAAM,6BAA6B,CAAC;AACxC,CAAC"}

package/dist/extensions/forgecli/forge-init/verifiers.d.ts

@@ -0,0 +1,20 @@
+export interface VerifyResult {
+    ok: boolean;
+    missing: string[];
+    reason?: string;
+}
+/**
+ * Verify Phase 1 deliverable: `.forge/config.json` exists and contains all required fields.
+ *
+ * Called immediately after the Phase-1 agent's `waitForIdle()` completes. Reads config.json
+ * directly — intentionally does NOT use a cached value because Phase 1 writes this file.
+ */
+export declare function verifyPhase1(cwd: string): VerifyResult;
+/**
+ * Verify Phase 2 deliverable: 7 architecture KB docs exist under `kbPath/architecture/`.
+ */
+export declare function verifyPhase2(cwd: string, kbPath: string): VerifyResult;
+/**
+ * Verify Phase 3 deliverable: all four `.forge/` subdirectories contain at least one file.
+ */
+export declare function verifyPhase3(cwd: string): VerifyResult;

package/dist/extensions/forgecli/forge-init/verifiers.js

@@ -0,0 +1,81 @@
+// forge-init/verifiers.ts — per-phase deliverable verification helpers (FORGE-S25-T23, B-4, N-B-A)
+//
+// Each verifier reads the filesystem directly rather than accepting a cached config object
+// because they run immediately after a phase's `waitForIdle()` — the moment the deliverable
+// should have been written. Using a cached pre-phase value would return stale data.
+import * as fs from "node:fs";
+import * as path from "node:path";
+/**
+ * Verify Phase 1 deliverable: `.forge/config.json` exists and contains all required fields.
+ *
+ * Called immediately after the Phase-1 agent's `waitForIdle()` completes. Reads config.json
+ * directly — intentionally does NOT use a cached value because Phase 1 writes this file.
+ */
+export function verifyPhase1(cwd) {
+    const configPath = path.join(cwd, ".forge", "config.json");
+    if (!fs.existsSync(configPath)) {
+        return { ok: false, missing: [".forge/config.json"], reason: "config file not written" };
+    }
+    let cfg;
+    try {
+        cfg = JSON.parse(fs.readFileSync(configPath, "utf8"));
+    }
+    catch (err) {
+        const e = err;
+        return { ok: false, missing: [".forge/config.json"], reason: `JSON parse failed: ${e.message ?? "?"}` };
+    }
+    const missing = [];
+    if (!cfg.version)
+        missing.push("version");
+    const proj = cfg.project;
+    if (!proj?.name)
+        missing.push("project.name");
+    if (!proj?.prefix)
+        missing.push("project.prefix");
+    if (!cfg.stack)
+        missing.push("stack");
+    if (!cfg.commands)
+        missing.push("commands");
+    const paths = cfg.paths;
+    if (!paths?.engineering)
+        missing.push("paths.engineering");
+    if (!paths?.store)
+        missing.push("paths.store");
+    if (!paths?.workflows)
+        missing.push("paths.workflows");
+    return { ok: missing.length === 0, missing };
+}
+/**
+ * Verify Phase 2 deliverable: 7 architecture KB docs exist under `kbPath/architecture/`.
+ */
+export function verifyPhase2(cwd, kbPath) {
+    const archDocs = ["stack", "processes", "database", "routing", "deployment", "entity-model", "stack-checklist"];
+    const missing = [];
+    for (const d of archDocs) {
+        if (!fs.existsSync(path.join(cwd, kbPath, "architecture", `${d}.md`))) {
+            missing.push(`${kbPath}/architecture/${d}.md`);
+        }
+    }
+    return { ok: missing.length === 0, missing };
+}
+/**
+ * Verify Phase 3 deliverable: all four `.forge/` subdirectories contain at least one file.
+ */
+export function verifyPhase3(cwd) {
+    const dirs = ["workflows", "personas", "skills", "templates"];
+    const missing = [];
+    for (const d of dirs) {
+        const dir = path.join(cwd, ".forge", d);
+        let count = 0;
+        try {
+            count = fs.readdirSync(dir).filter((f) => f.endsWith(".md") || f.endsWith(".json")).length;
+        }
+        catch {
+            count = 0;
+        }
+        if (count === 0)
+            missing.push(`.forge/${d}/ (empty)`);
+    }
+    return { ok: missing.length === 0, missing };
+}
+//# sourceMappingURL=verifiers.js.map

package/dist/extensions/forgecli/forge-init/verifiers.js.map

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