@entelligentsia/forgecli 0.7.10 → 0.9.0

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

@@ -0,0 +1,66 @@
+// 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,
+                },
+            });
+            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,38 @@
+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 GlobalConfig {
+    "persona-models"?: PersonaModelsMap;
+}
+export interface ProjectConfig {
+    "persona-models"?: PersonaModelsMap;
+    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,68 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { getAgentDir } from "@earendil-works/pi-coding-agent";
+import { Ajv } from "ajv";
+import schema from "./forge-cli-schema.json" with { type: "json" };
+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 = path.join(getAgentDir(), "forge-cli", "config.json");
+    const projectPath = path.join(cwd, ".pi", "forge-cli", "config.json");
+    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-tui/component.d.ts

@@ -0,0 +1,35 @@
+import type { Component, Focusable } from "@earendil-works/pi-tui";
+import type { Theme } from "@earendil-works/pi-coding-agent";
+import { type InitOptions } from "./state.js";
+export interface ConfigTuiComponentOptions extends InitOptions {
+    /** Called by the component when the user has quit (with discard or via clean exit). */
+    onExit: (exitCode: number) => void;
+    /** Called when a write to disk completes successfully — surfaces "saved to X". */
+    onSaved?: (target: string) => void;
+    /** Called on write failure — surfaces the error to the parent ctx. */
+    onError?: (message: string) => void;
+    /** Optional invalidate hook supplied by the TUI driver (forces re-render). */
+    requestRender?: () => void;
+    /** pi TUI theme — drives all colour choices inside the overlay. */
+    theme: Theme;
+}
+export declare class ConfigTuiComponent implements Component, Focusable {
+    private state;
+    private readonly opts;
+    /** Focusable — pi sets this to true when the overlay has keyboard focus.
+     *  Without this, arrow keys don't route to handleInput (see commit 07e886f). */
+    focused: boolean;
+    /** Timer handle for the auto-clearing save banner (guards against unmount). */
+    private clearStatusTimer?;
+    constructor(opts: ConfigTuiComponentOptions);
+    invalidate(): void;
+    render(width: number): string[];
+    handleInput(data: string): void;
+    private handleResult;
+    private dispatch;
+    private maybeExit;
+    private maybePersist;
+    /** Schedule save-banner auto-clear.  Guards against unmount (Hard Rule 5). */
+    private scheduleClearStatus;
+}
+export declare function createConfigTuiComponent(opts: ConfigTuiComponentOptions): ConfigTuiComponent;

package/dist/extensions/forgecli/config-tui/component.js

@@ -0,0 +1,236 @@
+// Composite Component that drives the config TUI.
+//
+// Phase 2: thin orchestrator that delegates render and handleInput to the
+// active Screen implementation. The Component & Focusable impl stays here;
+// per-view logic moved into screens/*.ts modules.
+//
+// The component composes:
+//   - state/ reducer (single source of truth)
+//   - screens/* renderers + input handlers (delegated via Screen interface)
+//   - config-writer.ts for atomic persistence on commit-persona-edit
+import * as fs from "node:fs";
+import { Key, matchesKey, truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
+import { DynamicBorder } from "@earendil-works/pi-coding-agent";
+import { writeRoutingConfig } from "../config-writer.js";
+import { getActiveView, initialState, reducer, } from "./state.js";
+import { AdvancedMenuScreen } from "./screens/advanced-menu.js";
+import { TierMenuScreen } from "./screens/tier-menu.js";
+import { TierPickerScreen } from "./screens/tier-picker.js";
+import { ConfirmQuitScreen, renderSaveBanner } from "./screens/confirm-quit.js";
+import { PersonasListScreen } from "./screens/personas-list.js";
+import { PersonaPickerScreen } from "./screens/persona-picker.js";
+import { PersonaEditorScreen } from "./screens/persona-editor.js";
+import { ShowResolvedScreen } from "./screens/show-resolved.js";
+import { OverridesListPipelinesScreen } from "./screens/overrides-list.js";
+import { OverridesListPhasesScreen } from "./screens/overrides-list-phases.js";
+import { OverrideEditorScreen } from "./screens/override-editor.js";
+function debugLog(line) {
+    if (process.env.FORGE_DEBUG_INPUT !== "1")
+        return;
+    try {
+        const ts = new Date().toISOString();
+        const path = process.env.FORGE_DEBUG_INPUT_LOG ?? "/tmp/forge-input-router.log";
+        fs.appendFileSync(path, `${ts} [config-tui] ${line}\n`);
+    }
+    catch {
+        /* swallow */
+    }
+}
+function hexEscape(s) {
+    return [...s]
+        .map((c) => {
+        const cp = c.codePointAt(0);
+        if (cp >= 0x20 && cp <= 0x7e)
+            return c;
+        return `\\x${cp.toString(16).padStart(2, "0")}`;
+    })
+        .join("");
+}
+// ── Screen factory ──────────────────────────────────────────────────────────
+const SCREEN_INSTANCES = {
+    "confirm-quit": new ConfirmQuitScreen(),
+    "tier-menu": new TierMenuScreen(),
+    "tier-picker": new TierPickerScreen(),
+    "advanced-menu": new AdvancedMenuScreen(),
+    "personas-list": new PersonasListScreen(),
+    "persona-picker": new PersonaPickerScreen(),
+    "persona-editor": new PersonaEditorScreen(),
+    "show-resolved": new ShowResolvedScreen(),
+    "overrides-list-pipelines": new OverridesListPipelinesScreen(),
+    "overrides-list-phases": new OverridesListPhasesScreen(),
+    "override-editor": new OverrideEditorScreen(),
+};
+function createScreen(view) {
+    return SCREEN_INSTANCES[view.kind] ?? SCREEN_INSTANCES["tier-menu"];
+}
+// ── Hard Rule 4: Explicit layer-to-action mapping ──────────────────────────
+function persistLayerForAction(action) {
+    switch (action.kind) {
+        case "commit-tier-model": return action.layer;
+        case "commit-persona-edit": return action.layer;
+        case "delete-persona-entry": return action.layer;
+        case "commit-override-name": return "project"; // L4 lives on project only
+        case "commit-override-inline": return "project"; // L4 lives on project only
+        case "clear-phase-override": return "project"; // L4 lives on project only
+        default: return undefined;
+    }
+}
+export class ConfigTuiComponent {
+    state;
+    opts;
+    /** Focusable — pi sets this to true when the overlay has keyboard focus.
+     *  Without this, arrow keys don't route to handleInput (see commit 07e886f). */
+    focused = false;
+    /** Timer handle for the auto-clearing save banner (guards against unmount). */
+    clearStatusTimer;
+    constructor(opts) {
+        this.opts = opts;
+        this.state = initialState(opts);
+    }
+    invalidate() {
+        // Stateless renderer; no cache to drop. (Hard Rule 3: no render caching.)
+    }
+    render(width) {
+        const theme = this.opts.theme;
+        const view = getActiveView(this.state);
+        // Delegate rendering to the active screen (or confirm-quit overlay).
+        let contentLines;
+        if (this.state.confirmQuit) {
+            // show the underlying screen plus the confirm-quit overlay
+            const screen = createScreen(view);
+            const baseLines = screen.render(this.state, width, theme);
+            const quitLines = SCREEN_INSTANCES["confirm-quit"].render(this.state, width, theme);
+            contentLines = [...baseLines, ...renderSaveBanner(this.state, width, theme), ...quitLines];
+        }
+        else {
+            const screen = createScreen(view);
+            contentLines = [
+                ...screen.render(this.state, width, theme),
+                ...renderSaveBanner(this.state, width, theme),
+            ];
+        }
+        // ── Modal frame ────────────────────────────────────────────────────
+        const bgFn = (s) => theme.bg("selectedBg", s);
+        const lines = [];
+        // Top border
+        lines.push(...new DynamicBorder((s) => theme.fg("borderAccent", s)).render(width));
+        // Content: each line padded to full width so the background colour fills
+        // the entire row.  visibleWidth correctly ignores ANSI codes added by theme.
+        // truncateToWidth ensures no line exceeds the terminal width.
+        for (const line of contentLines) {
+            const truncated = truncateToWidth(line, width, "");
+            const vis = visibleWidth(truncated);
+            const padded = vis < width ? truncated + " ".repeat(width - vis) : truncated;
+            lines.push(bgFn(padded));
+        }
+        // Bottom border
+        lines.push(...new DynamicBorder((s) => theme.fg("borderAccent", s)).render(width));
+        return lines;
+    }
+    handleInput(data) {
+        debugLog(`handleInput IN data="${hexEscape(data)}" focused=${this.focused} view=${getActiveView(this.state).kind}`);
+        if (this.state.shouldExit) {
+            debugLog(`handleInput RETURN (shouldExit)`);
+            return;
+        }
+        // Universal: q always requests quit
+        if (matchesKey(data, "q")) {
+            this.dispatch({ kind: "request-quit" });
+            this.maybeExit();
+            return;
+        }
+        // confirmQuit modal hijacks subsequent input
+        if (this.state.confirmQuit) {
+            const result = SCREEN_INSTANCES["confirm-quit"].handleInput(data, this.state);
+            this.handleResult(result);
+            // After confirm-quit, check if we should exit
+            this.maybeExit();
+            return;
+        }
+        if (matchesKey(data, Key.escape)) {
+            this.dispatch({ kind: "pop-view" });
+            return;
+        }
+        // Delegate to the active screen's handleInput
+        const view = getActiveView(this.state);
+        const screen = createScreen(view);
+        const result = screen.handleInput(data, this.state);
+        this.handleResult(result);
+    }
+    // ── Result dispatcher ─────────────────────────────────────────────────────
+    handleResult(result) {
+        switch (result.kind) {
+            case "dispatch":
+                this.dispatch(result.action);
+                this.maybePersist(result.action);
+                break;
+            case "dispatch-seq":
+                for (const action of result.actions) {
+                    this.dispatch(action);
+                }
+                // Persist the last action (the one that triggers the write)
+                if (result.actions.length > 0) {
+                    this.maybePersist(result.actions[result.actions.length - 1]);
+                }
+                break;
+            case "pop":
+                this.dispatch({ kind: "pop-view" });
+                break;
+            case "quit":
+                this.dispatch({ kind: "request-quit" });
+                this.maybeExit();
+                break;
+            case "error":
+                this.opts.onError?.(result.message);
+                this.opts.requestRender?.();
+                break;
+            case "consumed":
+                this.opts.requestRender?.();
+                break;
+            case "no-op":
+                break;
+        }
+    }
+    // ── Dispatcher helpers ────────────────────────────────────────────────────
+    dispatch(action) {
+        this.state = reducer(this.state, action);
+        this.opts.requestRender?.();
+    }
+    maybeExit() {
+        if (this.state.shouldExit) {
+            if (this.clearStatusTimer)
+                clearTimeout(this.clearStatusTimer); // Hard Rule 5
+            this.opts.onExit(0);
+        }
+    }
+    maybePersist(action) {
+        const layer = persistLayerForAction(action);
+        if (!layer)
+            return;
+        try {
+            const buffer = layer === "global" ? this.state.buffer.global : this.state.buffer.project;
+            const target = writeRoutingConfig({ layer, cwd: this.state.cwd, buffer });
+            this.dispatch({ kind: "mark-clean", lastSaved: { target, layer } });
+            this.scheduleClearStatus(); // Hard Rule 5
+            this.opts.onSaved?.(target);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            this.opts.onError?.(msg);
+        }
+    }
+    /** Schedule save-banner auto-clear.  Guards against unmount (Hard Rule 5). */
+    scheduleClearStatus() {
+        if (this.clearStatusTimer)
+            clearTimeout(this.clearStatusTimer);
+        this.clearStatusTimer = setTimeout(() => {
+            if (!this.state.shouldExit) {
+                this.dispatch({ kind: "clear-status" });
+            }
+        }, 3000);
+    }
+}
+export function createConfigTuiComponent(opts) {
+    return new ConfigTuiComponent(opts);
+}
+//# sourceMappingURL=component.js.map

package/dist/extensions/forgecli/config-tui/component.js.map

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

package/dist/extensions/forgecli/config-tui/handler.d.ts

@@ -0,0 +1,40 @@
+import type { InitOptions } from "./state.js";
+export type ConfigTuiRoute = {
+    kind: "tier-menu";
+} | {
+    kind: "show";
+    resolved: boolean;
+    json: boolean;
+} | {
+    kind: "dispatch";
+    pipeline: string | undefined;
+    json: boolean;
+} | {
+    kind: "edit-persona";
+    persona: string;
+} | {
+    kind: "edit-override";
+    pipeline: string;
+    phaseRole: string;
+};
+export interface ConfigTuiArgsError {
+    error: string;
+}
+export type ParseConfigTuiResult = ConfigTuiRoute | ConfigTuiArgsError;
+export declare function parseConfigTuiArgs(args: string[]): ParseConfigTuiResult;
+/**
+ * Caller-provided interaction surface. The pi-extension wrapper supplies
+ * `ctx.mountConfigTui` to give us TUI access; the bin surface omits it (and
+ * gets a non-interactive fallback message).
+ */
+export interface ConfigTuiCallbacks {
+    write: (line: string) => void;
+    writeErr?: (line: string) => void;
+    /** Present only when invoked inside a pi session (TUI mount available). */
+    ctx?: {
+        notify: (msg: string, level?: string) => void;
+        mountConfigTui?: (init: InitOptions) => Promise<number>;
+    };
+}
+export declare function readPipelineCatalogue(cwd: string): string[] | null;
+export declare function runConfigTui(args: string[], cwd: string, cb: ConfigTuiCallbacks): Promise<number>;