@entelligentsia/forgecli 1.0.14 → 1.0.21

package/dist/extensions/forgecli/commands/store-query.d.ts

@@ -0,0 +1,22 @@
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+export interface StoreQueryResult {
+    stdout: string;
+    ok: boolean;
+    errorMessage?: string;
+}
+/**
+ * Run store-cli in query or nlp mode.
+ * - Args starting with "--" → query branch: `store-cli query ...flags`
+ * - Otherwise → nlp branch: `store-cli nlp "<args>"`
+ *
+ * Returns raw stdout for display. Does NOT JSON-parse — caller renders as-is.
+ * Exported so orchestrators can call directly without going through sendUserMessage.
+ */
+export declare function runStoreQuery(args: string, forgeRoot: string, cwd: string): Promise<StoreQueryResult>;
+/**
+ * Register /forge:store-query.
+ * forgeRoot is nullable — null means we're outside a Forge project.
+ */
+export declare function registerStoreQuery(pi: ExtensionAPI, opts: {
+    forgeRoot: string | null;
+}): void;

package/dist/extensions/forgecli/commands/store-query.js

@@ -0,0 +1,107 @@
+// store-query.ts — native atomic handler for /forge:store-query (FORGE-S23-T10)
+//
+// Dispatches to store-cli query (flags path) or store-cli nlp (intent path)
+// and emits raw stdout via ctx.ui.notify.
+//
+// Archetype: Atomic (no LLM in loop — pack-04 §Atomic).
+// Iron Laws:
+//   IL1 — new code lives in forge-cli/ only
+//   IL6 — no shell-string interpolation (argv-array throughout)
+//   IL7 — silent continuation past failures is never acceptable
+import { execFile } from "node:child_process";
+import * as path from "node:path";
+import { promisify } from "node:util";
+import { resolveToolDir } from "../store/store-resolver.js";
+const execFileAsync = promisify(execFile);
+// ── Usage message ─────────────────────────────────────────────────────────────
+const USAGE = `Usage: /forge:search <intent or flags>
+
+Examples:
+  /forge:search open bugs in S12
+  /forge:search FORGE-BUG-047
+  /forge:search --sprint FORGE-S12 --status in-progress
+  /forge:search --keyword auth
+  /forge:search schema`;
+/**
+ * Run store-cli in query or nlp mode.
+ * - Args starting with "--" → query branch: `store-cli query ...flags`
+ * - Otherwise → nlp branch: `store-cli nlp "<args>"`
+ *
+ * Returns raw stdout for display. Does NOT JSON-parse — caller renders as-is.
+ * Exported so orchestrators can call directly without going through sendUserMessage.
+ */
+export async function runStoreQuery(args, forgeRoot, cwd) {
+    const trimmed = args.trim();
+    const toolDir = resolveToolDir(forgeRoot);
+    const storeCliPath = path.join(toolDir, "store-cli.cjs");
+    let argv;
+    let timeoutMs;
+    if (trimmed.startsWith("--")) {
+        // Query branch: pass flags verbatim as argv tokens
+        const tokens = trimmed.split(/\s+/).filter(Boolean);
+        argv = ["query", ...tokens];
+        timeoutMs = 10_000;
+    }
+    else {
+        // NLP branch: pass entire trimmed arg string as single argument
+        argv = ["nlp", trimmed];
+        timeoutMs = 30_000;
+    }
+    try {
+        const result = await execFileAsync("node", [storeCliPath, ...argv], {
+            cwd,
+            encoding: "utf8",
+            timeout: timeoutMs,
+        });
+        return { stdout: result.stdout, ok: true };
+    }
+    catch (err) {
+        const e = err;
+        // execFile rejects on non-zero exit; stdout may still contain partial results
+        const stderr = e.stderr || e.message || String(err);
+        const stdout = e.stdout || "";
+        return {
+            stdout,
+            ok: false,
+            errorMessage: stderr.slice(0, 500),
+        };
+    }
+}
+// ── Register ─────────────────────────────────────────────────────────────────
+/**
+ * Register /forge:store-query.
+ * forgeRoot is nullable — null means we're outside a Forge project.
+ */
+export function registerStoreQuery(pi, opts) {
+    pi.registerCommand("forge:search", {
+        description: "Query the Forge store by natural language or exact flags. " +
+            "Use flags (--sprint, --task, --keyword) for exact queries; " +
+            "use plain text for NLP intent queries.",
+        async handler(args, ctx) {
+            const cwd = process.cwd();
+            // Outside-project guard
+            if (!opts.forgeRoot) {
+                ctx.ui.notify("× forge:search — not inside a Forge project. Run /forge:init first.", "error");
+                return;
+            }
+            const trimmed = args.trim();
+            if (!trimmed) {
+                ctx.ui.notify(USAGE, "info");
+                return;
+            }
+            ctx.ui.setStatus?.("forge:search", "Querying store…");
+            const result = await runStoreQuery(trimmed, opts.forgeRoot, cwd);
+            ctx.ui.setStatus?.("forge:search", undefined);
+            if (!result.ok && result.errorMessage) {
+                ctx.ui.notify(`× forge:search — ${result.errorMessage}`, "error");
+                // Still show partial stdout if available
+                if (result.stdout.trim()) {
+                    ctx.ui.notify(result.stdout.trim(), "info");
+                }
+                return;
+            }
+            ctx.ui.notify(result.stdout.trim() || "(no results)", "info");
+        },
+    });
+}
+//# sourceMappingURL=store-query.js.map

package/dist/extensions/forgecli/commands/store-query.js.map

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

package/dist/extensions/forgecli/commands/store-repair.d.ts

@@ -0,0 +1,17 @@
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+export interface ParsedStoreRepairArgs {
+    dryRun: boolean;
+    seed: string;
+    sourceLabel: string;
+}
+export declare function parseStoreRepairArgs(rawArgs: string, cwd: string): ParsedStoreRepairArgs;
+export interface ComposeStoreRepairKickoffOpts {
+    commandMd: string;
+    parsed: ParsedStoreRepairArgs;
+}
+export declare function composeStoreRepairKickoff(opts: ComposeStoreRepairKickoffOpts): string;
+export interface RegisterStoreRepairOptions {
+    forgeRoot: string | null;
+    cwd?: string;
+}
+export declare function registerStoreRepair(pi: ExtensionAPI, options: RegisterStoreRepairOptions): void;

package/dist/extensions/forgecli/commands/store-repair.js

@@ -0,0 +1,123 @@
+// forge:store-repair — native kickoff handler (FORGE-S23-T11).
+//
+// 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.
+//
+// --dry-run flag is forwarded in the kickoff body so the LLM calls
+// validate-store --dry-run and skips write phases accordingly.
+//
+// Workflow source: <forgeRoot>/commands/store-repair.md (command file).
+// File-existence check only — command files lack Pack-06 workflow markers.
+//
+// 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 { sendKickoff } from "../kickoff.js";
+export function parseStoreRepairArgs(rawArgs, cwd) {
+    const trimmed = (rawArgs ?? "").trim();
+    const result = {
+        dryRun: false,
+        seed: "",
+        sourceLabel: "",
+    };
+    if (!trimmed) {
+        result.sourceLabel = "(no args — full repair run)";
+        return result;
+    }
+    const tokens = trimmed.split(/\s+/);
+    const remaining = [];
+    for (const tok of tokens) {
+        if (tok === "--dry-run") {
+            result.dryRun = true;
+        }
+        else {
+            remaining.push(tok);
+        }
+    }
+    const tail = remaining.join(" ").trim();
+    if (tail.startsWith("@")) {
+        const ref = tail.slice(1).trim();
+        const filePath = path.isAbsolute(ref) ? ref : path.resolve(cwd, ref);
+        result.seed = fs.readFileSync(filePath, "utf8");
+        result.sourceLabel = `(seed from file: ${ref})`;
+    }
+    else if (tail) {
+        result.seed = tail;
+        result.sourceLabel = "(seed from inline text)";
+    }
+    else {
+        result.sourceLabel = result.dryRun ? "(--dry-run mode)" : "(no args — full repair run)";
+    }
+    return result;
+}
+export function composeStoreRepairKickoff(opts) {
+    const { commandMd, parsed } = opts;
+    const sections = ["# /forge:repair", ""];
+    sections.push("## Dispatch", "");
+    sections.push("Diagnose and repair the Forge JSON store. Run the repair workflow below. Specifically:");
+    sections.push("");
+    if (parsed.dryRun) {
+        sections.push("**`--dry-run` mode.** Preview all repairs without writing anything. " +
+            "In Phase 2 (LLM repair) and Phase 3 (final validation), show what would change but skip all writes. " +
+            "Skip Phase 4 verification (nothing changed).");
+    }
+    else {
+        sections.push("Full repair mode: diagnose, propose fixes, apply approved repairs, verify.");
+    }
+    sections.push("", "Use `forge_store` for all store reads and writes (never raw file writes to `.forge/store/`).");
+    sections.push("", "---", "", "## Command", "", commandMd.trim(), "", "---");
+    if (parsed.seed) {
+        sections.push("", `## Additional Context — ${parsed.sourceLabel}`, "", parsed.seed.trim());
+    }
+    return sections.join("\n");
+}
+// ── Registration ──────────────────────────────────────────────────────────
+const COMMAND_NAME = "store-repair";
+export function registerStoreRepair(pi, options) {
+    pi.registerCommand("forge:repair", {
+        description: "Diagnose and repair corrupted Forge store records. " +
+            "Usage: /forge:repair [--dry-run]. " +
+            "--dry-run shows what would be repaired without making changes.",
+        async handler(args, ctx) {
+            const { forgeRoot } = options;
+            const cwd = options.cwd ?? process.cwd();
+            if (!forgeRoot) {
+                ctx.ui.notify("× forge:repair — no Forge project at cwd; run /forge:init to bootstrap", "warning");
+                return;
+            }
+            const commandPath = path.join(forgeRoot, "commands", `${COMMAND_NAME}.md`);
+            let commandMd;
+            try {
+                commandMd = fs.readFileSync(commandPath, "utf8");
+            }
+            catch (err) {
+                const e = err;
+                if (e.code === "ENOENT") {
+                    ctx.ui.notify(`× forge:repair — command file not found at commands/${COMMAND_NAME}.md; run /forge:init or /forge:rebuild first.`, "error");
+                }
+                else {
+                    ctx.ui.notify(`× forge:repair — failed to read command file: ${e.message ?? "unknown error"}`, "error");
+                }
+                return;
+            }
+            let parsed;
+            try {
+                parsed = parseStoreRepairArgs(args, cwd);
+            }
+            catch (err) {
+                const e = err;
+                ctx.ui.notify(`× forge:repair — failed to parse args: ${e.message ?? "unknown"}`, "error");
+                return;
+            }
+            const kickoff = composeStoreRepairKickoff({ commandMd, parsed });
+            sendKickoff(pi, kickoff);
+        },
+    });
+}
+//# sourceMappingURL=store-repair.js.map

package/dist/extensions/forgecli/commands/store-repair.js.map

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

package/dist/extensions/forgecli/commands/test-orchestrate.d.ts

@@ -0,0 +1,2 @@
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+export declare function registerTestOrchestrate(pi: ExtensionAPI): void;

package/dist/extensions/forgecli/commands/test-orchestrate.js

@@ -0,0 +1,182 @@
+// test-orchestrate.ts — /test-orchestrate slash command for subagent harness e2e.
+//
+// Spawns a forge subagent via runForgeSubagent() and delegates the user-provided
+// prompt to it. Multi-turn allowed (subagent loops until no more tool calls).
+// Streams live updates back to UI via setStatus + ctx.ui.notify.
+//
+// Usage:
+//   /test-orchestrate <prompt>
+//   /test-orchestrate @path/to/prompt-file.md
+//
+// Persona: inline minimal generic-assistant persona. Replace with
+// loadForgePersona("engineer", cwd) once persona frontmatter is backfilled.
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { getFinalOutput, loadForgePersona, runForgeSubagent } from "../forge-subagent.js";
+const STATUS_KEY = "test-orchestrate";
+const GENERIC_PERSONA = {
+    name: "test-scribe",
+    description: "Generic assistant for /test-orchestrate harness",
+    systemPrompt: [
+        "You are a test subagent invoked through the Forge subagent harness.",
+        "Use the available tools (read, write, edit, bash) as needed to fulfill the user's request.",
+        "Be terse. Show evidence (file paths, command output) over narration.",
+        "If the task asks for a file, write it. If it asks for analysis, summarize in <200 words.",
+    ].join(" "),
+    filePath: "<inline>",
+};
+function parseArgs(args, cwd) {
+    const trimmed = args.trim();
+    if (!trimmed) {
+        return { mode: "text", text: "", persona: GENERIC_PERSONA, cwd };
+    }
+    // @path/to/file → read file as task body
+    if (trimmed.startsWith("@")) {
+        const rel = trimmed.slice(1);
+        const abs = path.isAbsolute(rel) ? rel : path.resolve(cwd, rel);
+        const text = fs.readFileSync(abs, "utf-8");
+        return { mode: "file", text, persona: GENERIC_PERSONA, cwd };
+    }
+    // --persona <name> <task>
+    const personaMatch = trimmed.match(/^--persona\s+(\S+)\s+(.+)$/s);
+    if (personaMatch) {
+        const personaName = personaMatch[1];
+        const text = personaMatch[2];
+        const persona = loadForgePersona(personaName, cwd);
+        return { mode: "persona-file", text, persona, cwd };
+    }
+    return { mode: "text", text: trimmed, persona: GENERIC_PERSONA, cwd };
+}
+export function registerTestOrchestrate(pi) {
+    pi.registerCommand("test-orchestrate", {
+        description: "Spawn a forge subagent via the SDK harness and delegate a prompt. " +
+            "Usage: /test-orchestrate <prompt>  |  @<file>  |  --persona <name> <prompt>",
+        async handler(args, ctx) {
+            const cwd = process.cwd();
+            let parsed;
+            try {
+                parsed = parseArgs(args, cwd);
+            }
+            catch (err) {
+                const e = err;
+                ctx.ui.notify(`× /test-orchestrate — ${e.message ?? "arg parse failed"}`, "error");
+                return;
+            }
+            if (!parsed.text.trim()) {
+                ctx.ui.notify("× /test-orchestrate — prompt required (usage: /test-orchestrate <prompt> | @<file> | --persona <name> <prompt>)", "error");
+                return;
+            }
+            const ac = new AbortController();
+            ctx.ui.setStatus?.(STATUS_KEY, `subagent: ${parsed.persona.name} starting…`);
+            // Rolling tail of recent events for the live monitor widget.
+            const TAIL_MAX = 12;
+            const TEXT_WINDOW = 80; // chars of streaming text shown
+            const tail = [];
+            let turn = 0;
+            let lastToolName = "";
+            let textBuffer = ""; // accumulator for current message_update text_delta
+            const refreshWidget = () => {
+                const header = `▶ subagent ${parsed.persona.name} · turn ${turn}`;
+                const lines = [header, ...tail.slice(-TAIL_MAX)];
+                if (textBuffer) {
+                    const tailText = textBuffer.slice(-TEXT_WINDOW).replace(/\n/g, " ⏎ ");
+                    lines.push(`▌ ${tailText}`);
+                }
+                ctx.ui.setWidget?.(STATUS_KEY, lines);
+            };
+            const push = (line) => {
+                tail.push(line);
+                if (tail.length > TAIL_MAX * 2)
+                    tail.splice(0, tail.length - TAIL_MAX);
+                refreshWidget();
+            };
+            try {
+                const result = await runForgeSubagent({
+                    persona: parsed.persona,
+                    task: parsed.text,
+                    cwd,
+                    signal: ac.signal,
+                    modelRegistry: ctx.modelRegistry,
+                    onEvent: (event) => {
+                        switch (event.type) {
+                            case "agent_start":
+                                push("◉ agent_start");
+                                break;
+                            case "message_start":
+                                textBuffer = "";
+                                push("▸ message_start");
+                                break;
+                            case "message_update": {
+                                const ame = event.assistantMessageEvent;
+                                if (ame?.type === "text_delta" && typeof ame.delta === "string") {
+                                    textBuffer += ame.delta;
+                                    refreshWidget();
+                                }
+                                else if (ame?.type === "thinking_delta") {
+                                    push("💭 thinking…");
+                                }
+                                break;
+                            }
+                            case "tool_execution_start":
+                                lastToolName = event.toolName;
+                                push(`🔧 tool_call · ${lastToolName}`);
+                                ctx.ui.setStatus?.(STATUS_KEY, `subagent: ${parsed.persona.name} · turn ${turn} · tool: ${lastToolName}`);
+                                break;
+                            case "tool_execution_update":
+                                refreshWidget();
+                                break;
+                            case "tool_execution_end": {
+                                const verdict = event.isError ? "✗" : "✓";
+                                push(`${verdict} tool_end · ${lastToolName}`);
+                                break;
+                            }
+                            case "message_end":
+                                push("◼ message_end");
+                                break;
+                            case "turn_end": {
+                                turn++;
+                                const u = event.message?.usage;
+                                const usageStr = u
+                                    ? ` · ↑${u.input ?? 0} ↓${u.output ?? 0}` +
+                                        (u.cost?.total ? ` $${u.cost.total.toFixed(4)}` : "")
+                                    : "";
+                                push(`── turn ${turn}${usageStr} ──`);
+                                textBuffer = "";
+                                break;
+                            }
+                            case "agent_end":
+                                push("◉ agent_end");
+                                break;
+                        }
+                    },
+                });
+                ctx.ui.setStatus?.(STATUS_KEY, undefined);
+                ctx.ui.setWidget?.(STATUS_KEY, undefined);
+                if (result.exitCode !== 0) {
+                    ctx.ui.notify(`× /test-orchestrate — subagent exited ${result.exitCode}` +
+                        (result.errorMessage ? `: ${result.errorMessage}` : "") +
+                        (result.stopReason ? ` [${result.stopReason}]` : ""), "error");
+                    return;
+                }
+                const finalOutput = getFinalOutput(result.messages);
+                const usage = result.usage;
+                const summary = [
+                    `〇 /test-orchestrate — ${parsed.persona.name} done.`,
+                    `Turns: ${usage.turns}  ↑${usage.input}  ↓${usage.output}  R${usage.cacheRead}  W${usage.cacheWrite}  $${usage.cost.toFixed(4)}`,
+                    `Model: ${result.model ?? "unknown"}`,
+                    "",
+                    "── Output ──",
+                    finalOutput || "(no assistant text returned)",
+                ].join("\n");
+                ctx.ui.notify(summary, "info");
+            }
+            catch (err) {
+                const e = err;
+                ctx.ui.setStatus?.(STATUS_KEY, undefined);
+                ctx.ui.setWidget?.(STATUS_KEY, undefined);
+                ctx.ui.notify(`× /test-orchestrate — harness error: ${e.message ?? "unknown"}`, "error");
+            }
+        },
+    });
+}
+//# sourceMappingURL=test-orchestrate.js.map

package/dist/extensions/forgecli/commands/test-orchestrate.js.map

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

package/dist/extensions/forgecli/commands/transcripts-command.d.ts

@@ -0,0 +1,87 @@
+import type { ExtensionAPI, ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
+import { digestPhasePayload } from "../transcript-archive.js";
+export { digestPhasePayload };
+import type { IndexEntry, ProjectsRegistry, RunManifest } from "../transcript-archive-types.js";
+export interface ListRow {
+    runId: string;
+    projectKey: string;
+    projectName: string;
+    entityId: string;
+    entityKind: string;
+    sprintId?: string;
+    startedAt: string;
+    outcome: string;
+    input: number;
+    output: number;
+    cost: number;
+    durationMs?: number;
+}
+export interface ListFilter {
+    entityId?: string;
+    project?: string;
+    sinceDays?: number;
+}
+/**
+ * Assemble list rows from the index, refreshed against each run's manifest
+ * when readable — the index line is append-only and can be stale for
+ * resumed runs (manifest is the source of truth; index is the timeline).
+ */
+export declare function collectListRows(filter?: ListFilter): ListRow[];
+export declare function formatList(rows: ListRow[]): string[];
+export interface ResolvedRun {
+    entry: IndexEntry;
+    manifest: RunManifest;
+    runDir: string;
+    /** Other runs that matched an entityId lookup (newest first, incl. this). */
+    siblingCount: number;
+}
+/**
+ * Resolve `show` target: exact runId match first, else latest run for the
+ * entityId (or sprintId back-reference). Null when nothing matches or the
+ * manifest is unreadable.
+ */
+export declare function resolveRun(idArg: string): ResolvedRun | null;
+export declare function formatShow(manifest: RunManifest, digest?: {
+    role: string;
+    file: string;
+    lines: string[];
+}): string[];
+export type TimelineBy = "day" | "model" | "phase" | "outcome";
+export interface TimelineRow {
+    key: string;
+    runs: number;
+    phases: number;
+    input: number;
+    output: number;
+    cost: number;
+}
+/**
+ * Aggregate archived runs along one dimension. Day/outcome come from the
+ * (manifest-refreshed) list rows; model/phase need the per-run manifests.
+ */
+export declare function collectTimeline(filter: ListFilter, by: TimelineBy): TimelineRow[];
+export declare function formatTimeline(rows: TimelineRow[], by: TimelineBy): string[];
+export declare function formatProjects(registry: ProjectsRegistry): string[];
+export interface ParsedArgs {
+    subcommand: "list" | "show" | "timeline" | "projects";
+    positional: string[];
+    project?: string;
+    sinceDays?: number;
+    by?: TimelineBy;
+    json: boolean;
+    error?: string;
+}
+export declare function parseTranscriptsArgs(args: string): ParsedArgs;
+/**
+ * Browse → replay re-entry loop. Overlays run strictly SEQUENTIALLY (each
+ * pushOverlay/popOverlay pair completes before the next overlay opens) so
+ * the input-router depth stays at exactly 1 — never stacked. Closing the
+ * replay dashboard (Esc) lands back in the browser; quitting the browser
+ * (q / Esc) ends the loop.
+ */
+export declare function openTranscriptsBrowser(ctx: ExtensionCommandContext): Promise<void>;
+/**
+ * Register /forge:transcripts. Takes no forgeRoot — the archive is central
+ * and the command must work outside any Forge project (cross-project recall).
+ */
+export declare function registerTranscriptsCommand(pi: ExtensionAPI, _opts?: Record<string, never>): void;