@entelligentsia/forgecli 1.0.25 → 1.0.36

package/dist/extensions/forgecli/collate.js

@@ -0,0 +1,134 @@
+// forge:collate — 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.
+//
+// The collator_agent.md workflow has no audience restriction (defaults to
+// "any"), so standalone human invocations are allowed — useful for retro
+// runs and manual collation triggers.
+//
+// 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 { 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 { 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 parseCollateArgs(rawArgs, cwd) {
+    const trimmed = (rawArgs ?? "").trim();
+    if (trimmed === "") {
+        return { mode: "empty", taskRef: "", sourceLabel: "(no input — collator infers sprint 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 } = opts;
+    const sections = ["# /forge:collate", ""];
+    if (personaIdentity.trim().length > 0) {
+        sections.push(personaIdentity.trim(), "");
+    }
+    sections.push("## Dispatch", "", "Run the workflow below. Specifically:", "", "1. Identify the active sprint via `forge_store_query` — do NOT raw-read `.forge/store/`.", "2. Follow the workflow Algorithm verbatim: collate store data into MASTER_INDEX.md, sprint INDEX.md, task INDEX.md files.", "3. Write all collated markdown files using the `write` tool.", "4. Honour Pack-06 Read/Write/Ask/Store discipline: store reads go via `forge_store_query`; in-conversation clarifications use `forge_ask_user`.");
+    sections.push("", "---", "", "## Workflow", "", workflowMd.trim(), "", "---");
+    if (parsed.mode === "empty") {
+        sections.push("", "## Input", "", "(no seed — infer sprint from store context)");
+    }
+    else {
+        sections.push("", `## Input — ${parsed.sourceLabel}`, "", parsed.taskRef.trim());
+    }
+    return sections.join("\n");
+}
+// Registration -------------------------------------------------------------
+const WORKFLOW_REL_PATH = path.join(".forge", "workflows", "collator_agent.md");
+export function registerCollate(pi, options = {}) {
+    pi.registerCommand("forge:collate", {
+        description: "Run the collator-agent workflow. " +
+            "Usage: /forge:collate [@<file> | <sprint-id> | <free-form text>]. " +
+            "Empty args → collator infers the active sprint from store context.",
+        async handler(args, ctx) {
+            const cwd = options.cwd ?? process.cwd();
+            const workflowPath = path.join(cwd, WORKFLOW_REL_PATH);
+            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:collate — workflow not found at ${WORKFLOW_REL_PATH}; run /forge:init or /forge:rebuild first.`, "error");
+                    }
+                    else {
+                        ctx.ui.notify(`× forge:collate — workflow load failed (${err.code}): ${err.message}`, "error");
+                    }
+                    return;
+                }
+                const e = err;
+                ctx.ui.notify(`× forge:collate — failed to read workflow: ${e.message ?? "unknown"}`, "error");
+                return;
+            }
+            let parsed;
+            try {
+                parsed = parseCollateArgs(args, cwd);
+            }
+            catch (err) {
+                const e = err;
+                ctx.ui.notify(`× forge:collate — failed to read seed: ${e.message ?? "unknown"}`, "error");
+                return;
+            }
+            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:collate — persona '${personas[0]}' load failed (${err.code}): ${err.message}`, "error");
+                        return;
+                    }
+                    const e = err;
+                    ctx.ui.notify(`× forge:collate — persona load error: ${e.message ?? "unknown"}`, "error");
+                    return;
+                }
+            }
+            if (!assertAudience({ workflowName: "collator_agent", audience: workflowAudience }, ctx)) {
+                return;
+            }
+            const kickoff = composeKickoff({
+                workflowMd,
+                personaIdentity,
+                parsed,
+            });
+            sendKickoff(pi, kickoff);
+        },
+    });
+}
+//# sourceMappingURL=collate.js.map

package/dist/extensions/forgecli/collate.js.map

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

package/dist/extensions/forgecli/commit.d.ts

@@ -0,0 +1,22 @@
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { extractPersonaNames } from "./lib/frontmatter-parser.js";
+export { extractPersonaNames };
+import { checkMaterialization, type MaterializationCheck } from "./lib/manifest-checker.js";
+export { checkMaterialization, type MaterializationCheck };
+export type ArgMode = "empty" | "file" | "text";
+export interface ParsedArgs {
+    mode: ArgMode;
+    taskRef: string;
+    sourceLabel: string;
+}
+export declare function parseCommitArgs(rawArgs: string, cwd: string): ParsedArgs;
+export interface ComposeKickoffOpts {
+    workflowMd: string;
+    personaIdentity: string;
+    parsed: ParsedArgs;
+}
+export declare function composeKickoff(opts: ComposeKickoffOpts): string;
+export interface RegisterCommitOptions {
+    cwd?: string;
+}
+export declare function registerCommit(pi: ExtensionAPI, options?: RegisterCommitOptions): void;

package/dist/extensions/forgecli/commit.js

@@ -0,0 +1,152 @@
+// forge:commit — 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 (commit_task.md) declares
+// `audience: subagent` — advisory only. Users may invoke this command
+// manually from the CLI; assertAudience never refuses subagent-audience
+// workflows. Orchestrator chains still dispatch via runForgeSubagent
+// directly and do NOT route through this handler.
+//
+// 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 "./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 parseCommitArgs(rawArgs, cwd) {
+    const trimmed = (rawArgs ?? "").trim();
+    if (trimmed === "") {
+        return { mode: "empty", taskRef: "", sourceLabel: "(no input — engineer 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 } = opts;
+    const sections = ["# /forge:commit", ""];
+    if (personaIdentity.trim().length > 0) {
+        sections.push(personaIdentity.trim(), "");
+    }
+    sections.push("## Dispatch", "", "Run the workflow below. Specifically:", "", "1. Read the task implementation at `engineering/sprints/<SPRINT_ID>/<TASK_ID>/PROGRESS.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: stage changes, write commit message, finalize store status.", "4. Write `COMMIT-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','committed']}`. 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");
+}
+// Registration -------------------------------------------------------------
+const WORKFLOW_REL_PATH = path.join(".forge", "workflows", "commit_task.md");
+export function registerCommit(pi, options = {}) {
+    pi.registerCommand("forge:commit", {
+        description: "Run the commit-task workflow for a Forge task. " +
+            "Usage: /forge:commit [@<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("commit", 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:commit — workflow not found at ${WORKFLOW_REL_PATH}; run /forge:init or /forge:rebuild first.`, "error");
+                    }
+                    else {
+                        ctx.ui.notify(`× forge:commit — workflow load failed (${err.code}): ${err.message}`, "error");
+                    }
+                    return;
+                }
+                const e = err;
+                ctx.ui.notify(`× forge:commit — failed to read workflow: ${e.message ?? "unknown"}`, "error");
+                return;
+            }
+            let parsed;
+            try {
+                parsed = parseCommitArgs(effectiveArgs, cwd);
+            }
+            catch (err) {
+                const e = err;
+                ctx.ui.notify(`× forge:commit — failed to read seed: ${e.message ?? "unknown"}`, "error");
+                return;
+            }
+            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:commit — persona '${personas[0]}' load failed (${err.code}): ${err.message}`, "error");
+                        return;
+                    }
+                    const e = err;
+                    ctx.ui.notify(`× forge:commit — persona load error: ${e.message ?? "unknown"}`, "error");
+                    return;
+                }
+            }
+            if (!assertAudience({ workflowName: "commit_task", audience: workflowAudience }, ctx)) {
+                return;
+            }
+            const kickoff = composeKickoff({
+                workflowMd,
+                personaIdentity,
+                parsed,
+            });
+            sendKickoff(pi, kickoff);
+        },
+    });
+}
+//# sourceMappingURL=commit.js.map

package/dist/extensions/forgecli/commit.js.map

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

package/dist/extensions/forgecli/config-command.d.ts

@@ -0,0 +1,8 @@
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+export interface RegisterConfigCommandOptions {
+    /** When null, /forge:config is registered but only the routing-config bits
+     *  are reachable — plugin-config display is hidden (no .forge to read).
+     */
+    forgeRoot: string | null;
+}
+export declare function registerConfigCommand(pi: ExtensionAPI, _opts: RegisterConfigCommandOptions): void;

package/dist/extensions/forgecli/config-command.js

@@ -0,0 +1,67 @@
+// Native /forge:config handler — replaces the LLM-backed delegateMarkdownCommand
+// stub that previously lived in forge-commands.ts.
+//
+// Plan 16 Slice 4a + 4b. The handler delegates to runConfigTui which is the
+// same entry point used by the `forge config` bin subcommand — single source
+// of truth for the routing config TUI / show flow. The wrapper supplies a
+// `mountConfigTui` callback that uses ctx.ui.custom() to overlay the TUI.
+import { createConfigTuiComponent } from "./config-tui/component.js";
+import { runConfigTui } from "./config-tui/handler.js";
+import { getInputRouter } from "./input-router.js";
+export function registerConfigCommand(pi, _opts) {
+    pi.registerCommand("forge:config", {
+        description: "Inspect or change forge-cli routing config (persona-models, pipeline overrides) and view Forge project config",
+        async handler(args, ctx) {
+            const argv = args.trim().length === 0 ? [] : args.trim().split(/\s+/);
+            const mountConfigTui = async (init) => {
+                // Mark overlay active so forge-input-router suppresses arrow-activator
+                // listeners (thread-switcher's ↓, whats-new's ↓) while the TUI owns
+                // input focus.
+                const router = getInputRouter();
+                router.pushOverlay();
+                try {
+                    const exitCode = await ctx.ui.custom((tui, theme, _kb, done) => {
+                        // Component drives done() on q or successful confirm-quit.
+                        // Pi TUI key rule 3: call tui.requestRender() after state changes.
+                        const component = createConfigTuiComponent({
+                            ...init,
+                            onExit: (code) => done(code),
+                            onSaved: (target) => ctx.ui.notify(`forge config: saved → ${target}`, "info"),
+                            onError: (msg) => ctx.ui.notify(`forge config: ${msg}`, "error"),
+                            requestRender: () => tui.requestRender(),
+                            theme,
+                        });
+                        return component;
+                    }, {
+                        overlay: true,
+                        overlayOptions: {
+                            width: "100%",
+                            anchor: "center",
+                            margin: 0,
+                        },
+                    });
+                    return exitCode;
+                }
+                finally {
+                    router.popOverlay();
+                }
+            };
+            const exitCode = await runConfigTui(argv, process.cwd(), {
+                write: () => { },
+                writeErr: (s) => ctx.ui.notify(s, "error"),
+                ctx: {
+                    notify: (msg, level) => {
+                        const lvl = (level === "warning" || level === "error" ? level : "info");
+                        ctx.ui.notify(msg, lvl);
+                    },
+                    mountConfigTui,
+                    modelRegistry: ctx.modelRegistry,
+                },
+            });
+            if (exitCode !== 0) {
+                ctx.ui.notify(`forge:config exited with code ${exitCode}`, "warning");
+            }
+        },
+    });
+}
+//# sourceMappingURL=config-command.js.map

package/dist/extensions/forgecli/config-command.js.map

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

package/dist/extensions/forgecli/config-layer.d.ts

@@ -0,0 +1,53 @@
+export interface PersonaModel {
+    provider: string;
+    model: string;
+    description?: string;
+}
+export type PersonaModelsMap = Record<string, PersonaModel>;
+export interface PhaseConfig {
+    "model-override"?: string | PersonaModel;
+}
+export interface PipelineConfig {
+    "persona-models"?: PersonaModelsMap;
+    /** Phase overrides keyed by role string. */
+    phases?: Record<string, PhaseConfig>;
+}
+export interface SkillCurationConfig {
+    /**
+     * FORGE-S24 SKILL-CURATION pipeline rollout flag. Default false.
+     * When false, the four T08–T11 modules (skill-retriever, skill-usage-tracker,
+     * skill-curator-subagent, friction-emit) no-op at entry. Wired into the
+     * orchestrator handlers (run-task / fix-bug) so a flag-off run is
+     * byte-identical to pre-FORGE-S24 behaviour.
+     */
+    enabled?: boolean;
+}
+export interface ForgeCliFeatureFlags {
+    skillCuration?: SkillCurationConfig;
+}
+export interface GlobalConfig {
+    "persona-models"?: PersonaModelsMap;
+    forgeCli?: ForgeCliFeatureFlags;
+}
+export interface ProjectConfig {
+    "persona-models"?: PersonaModelsMap;
+    forgeCli?: ForgeCliFeatureFlags;
+    pipelines?: Record<string, PipelineConfig>;
+}
+export interface MergedConfig {
+    /** Shallow-merged persona-models (project wins on key collision). */
+    "persona-models"?: PersonaModelsMap;
+    /** Project-only pipelines (L3/L4 config lives here). */
+    pipelines?: Record<string, PipelineConfig>;
+    /** The raw global config for L1 lookups — null if absent or invalid. */
+    _global: GlobalConfig | null;
+    /** The raw project config for L2 lookups — null if absent or invalid. */
+    _project: ProjectConfig | null;
+}
+export interface LayeredConfig {
+    global: GlobalConfig | null;
+    project: ProjectConfig | null;
+    merged: MergedConfig;
+    errors: string[];
+}
+export declare function loadLayeredConfig(cwd: string): LayeredConfig;

package/dist/extensions/forgecli/config-layer.js

@@ -0,0 +1,72 @@
+import * as fs from "node:fs";
+import AjvModule from "ajv";
+import schema from "./forge-cli-schema.json" with { type: "json" };
+import { getGlobalConfigPath, getProjectConfigPath } from "./paths/paths.js";
+// Ajv v8 ESM interop: default export is a namespace holder;
+// the actual constructor lives at .Ajv or .default.Ajv.
+const Ajv = AjvModule.default?.Ajv ?? AjvModule.Ajv ?? AjvModule;
+const ajv = new Ajv({ allErrors: true });
+const validate = ajv.compile(schema);
+function validateConfig(raw, label) {
+    const ok = validate(raw);
+    if (!ok) {
+        const messages = validate.errors
+            ?.map((e) => `${e.instancePath || "/"} ${e.message}`)
+            .join("; ") ?? "unknown";
+        return { valid: false, error: `forge-cli ${label} config schema error: ${messages}` };
+    }
+    return { valid: true, data: raw };
+}
+function readJsonFile(filePath) {
+    try {
+        return JSON.parse(fs.readFileSync(filePath, "utf-8"));
+    }
+    catch (_err) {
+        return null;
+    }
+}
+export function loadLayeredConfig(cwd) {
+    const errors = [];
+    const globalPath = getGlobalConfigPath();
+    const projectPath = getProjectConfigPath(cwd);
+    let globalConfig = null;
+    let projectConfig = null;
+    const rawGlobal = readJsonFile(globalPath);
+    if (rawGlobal !== null) {
+        const result = validateConfig(rawGlobal, "global");
+        if (result.valid) {
+            globalConfig = result.data;
+        }
+        else {
+            errors.push(result.error);
+        }
+    }
+    const rawProject = readJsonFile(projectPath);
+    if (rawProject !== null) {
+        const result = validateConfig(rawProject, "project");
+        if (result.valid) {
+            projectConfig = result.data;
+        }
+        else {
+            errors.push(result.error);
+        }
+    }
+    // Shallow-merge persona-models: global first, project overwrites per key
+    const mergedPersonaModels = {
+        ...(globalConfig?.["persona-models"] ?? {}),
+        ...(projectConfig?.["persona-models"] ?? {}),
+    };
+    const merged = {
+        _global: globalConfig,
+        _project: projectConfig,
+    };
+    if (Object.keys(mergedPersonaModels).length > 0) {
+        merged["persona-models"] = mergedPersonaModels;
+    }
+    // Pipelines are project-only (global config is project-agnostic)
+    if (projectConfig?.pipelines) {
+        merged.pipelines = projectConfig.pipelines;
+    }
+    return { global: globalConfig, project: projectConfig, merged, errors };
+}
+//# sourceMappingURL=config-layer.js.map

package/dist/extensions/forgecli/config-layer.js.map

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

package/dist/extensions/forgecli/config-writer.d.ts

@@ -0,0 +1,16 @@
+import type { PersonaModelsMap, PipelineConfig } from "./config-layer.js";
+export type ConfigLayer = "global" | "project";
+export interface RoutingConfigBuffer {
+    "persona-models"?: PersonaModelsMap;
+    pipelines?: Record<string, PipelineConfig>;
+}
+export interface WriteOptions {
+    layer: ConfigLayer;
+    cwd: string;
+    buffer: RoutingConfigBuffer;
+}
+export declare function resolveTargetPath(opts: {
+    layer: ConfigLayer;
+    cwd: string;
+}): string;
+export declare function writeRoutingConfig(opts: WriteOptions): string;

package/dist/extensions/forgecli/config-writer.js

@@ -0,0 +1,69 @@
+// Atomic, schema-validated writer for forge-cli routing config files.
+//
+// Plan 16, Slice 4a. Writes ONLY to (paths resolved via paths/paths.ts):
+//   - global layer (L1) → getGlobalConfigPath() → ~/.pi/forge-cli/config.json
+//   - project layer (L2/L3/L4) → getProjectConfigPath(cwd) →
+//     <cwd>/.pi/forge-cli/config.json
+//
+// Never writes to .forge/config.json — that's the plugin's pipeline catalogue,
+// read-only from this TUI.
+//
+// Write protocol:
+//   1. Validate buffer against forge-cli-schema.json. Throw on fail.
+//   2. If buffer is empty ({}) and target file exists → unlink. Return target.
+//   3. Otherwise: write to <target>.tmp, fsync, rename atomically to <target>.
+import * as fs from "node:fs";
+import * as path from "node:path";
+import AjvModule from "ajv";
+import schema from "./forge-cli-schema.json" with { type: "json" };
+import { getGlobalConfigPath, getProjectConfigPath } from "./paths/paths.js";
+// Ajv v8 ESM interop: default export is a namespace holder;
+// the actual constructor lives at .Ajv or .default.Ajv.
+const Ajv = AjvModule.default?.Ajv ?? AjvModule.Ajv ?? AjvModule;
+const ajv = new Ajv({ allErrors: true });
+const validate = ajv.compile(schema);
+export function resolveTargetPath(opts) {
+    if (opts.layer === "global") {
+        return getGlobalConfigPath();
+    }
+    return getProjectConfigPath(opts.cwd);
+}
+function isEmpty(buffer) {
+    const personaCount = Object.keys(buffer["persona-models"] ?? {}).length;
+    const pipelineCount = Object.keys(buffer.pipelines ?? {}).length;
+    return personaCount === 0 && pipelineCount === 0;
+}
+export function writeRoutingConfig(opts) {
+    const target = resolveTargetPath(opts);
+    // Empty buffer → delete file if present.
+    if (isEmpty(opts.buffer)) {
+        if (fs.existsSync(target)) {
+            fs.unlinkSync(target);
+        }
+        return target;
+    }
+    // Validate FIRST. Any failure short-circuits before touching the filesystem.
+    const ok = validate(opts.buffer);
+    if (!ok) {
+        const messages = validate.errors
+            ?.map((e) => `${e.instancePath || "/"} ${e.message}`)
+            .join("; ") ?? "unknown";
+        throw new Error(`forge-cli config schema error: ${messages}`);
+    }
+    // Ensure parent dir exists.
+    fs.mkdirSync(path.dirname(target), { recursive: true });
+    // Atomic write: temp file + rename. Pretty-print for human-readable diffs.
+    const tmpPath = `${target}.tmp`;
+    const serialized = `${JSON.stringify(opts.buffer, null, 2)}\n`;
+    const fd = fs.openSync(tmpPath, "w");
+    try {
+        fs.writeSync(fd, serialized);
+        fs.fsyncSync(fd);
+    }
+    finally {
+        fs.closeSync(fd);
+    }
+    fs.renameSync(tmpPath, target);
+    return target;
+}
+//# sourceMappingURL=config-writer.js.map

package/dist/extensions/forgecli/config-writer.js.map

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