ikarmic-forge 0.0.0-stage → 4.5.0

package/dist/commands/checkpoint.js

@@ -0,0 +1,168 @@
+/**
+ * `forge checkpoint …` subcommand: list / show / restore / prune
+ * the per-turn file snapshots the agent captures automatically.
+ *
+ * Mirrors the other soft-prefix subcommands (`session`, `skill`,
+ * `hook`, `mcp`): no AI provider required, exits 0/1/2.
+ */
+import process from 'node:process';
+import { compareWorktreeContexts, defaultSessionDir, listSessions, snapshotWorktreeContext, } from '@ikarmic/forge-core';
+import { sessionCheckpointStore } from '../session-checkpoints.js';
+export async function handleCheckpointCommand(cmd, cwd) {
+    // Checkpoints are per-session (`<sessions>/<id>/checkpoints`). Without
+    // --session, default to the most recently updated session.
+    const sessionsDir = defaultSessionDir();
+    const sessionId = cmd.sessionId ?? (await listSessions(sessionsDir))[0]?.id;
+    if (!sessionId) {
+        process.stdout.write('(no sessions found: checkpoints appear after the first file-mutating tool call)\n');
+        return 0;
+    }
+    const store = sessionCheckpointStore(sessionsDir, sessionId, cwd);
+    if (cmd.list) {
+        return listCheckpoints(store, cmd.list.limit ?? undefined);
+    }
+    if (cmd.show) {
+        return showCheckpoint(store, cmd.show.id);
+    }
+    if (cmd.restore) {
+        return restoreCheckpoint(store, cmd.restore.id, cmd.restore.yes);
+    }
+    if (cmd.prune) {
+        return pruneCheckpoints(store, cmd.prune.keep ?? undefined);
+    }
+    process.stderr.write('forge checkpoint: expected one of list|show|restore|prune. Try `forge checkpoint --help` (not yet implemented; read the README).\n');
+    return 2;
+}
+async function listCheckpoints(store, limit) {
+    const all = await store.list();
+    const items = typeof limit === 'number' ? all.slice(-limit) : all;
+    if (items.length === 0) {
+        process.stdout.write('(no checkpoints found: they appear after the first file-mutating tool call)\n');
+        return 0;
+    }
+    process.stdout.write('id                       turn  trigger          files  size       when\n');
+    process.stdout.write('────────────────────────────────────────────────────────────────────\n');
+    for (const cp of items) {
+        const id = cp.id.length > 24 ? cp.id.slice(0, 23) + '…' : cp.id.padEnd(24);
+        const turn = String(cp.turnIndex).padEnd(5);
+        const trigger = cp.trigger.padEnd(15);
+        const files = String(cp.fileCount).padEnd(6);
+        const size = formatBytes(cp.totalBytes).padEnd(10);
+        const when = cp.createdAt.replace('T', ' ').slice(0, 19);
+        process.stdout.write(`${id} ${turn} ${trigger} ${files} ${size} ${when}\n`);
+    }
+    return 0;
+}
+async function showCheckpoint(store, id) {
+    const cp = await store.get(id);
+    if (!cp) {
+        process.stderr.write(`forge checkpoint: no checkpoint with id "${id}"\n`);
+        return 2;
+    }
+    process.stdout.write(`Checkpoint ${cp.id}\n`);
+    process.stdout.write(`  turn:       ${cp.turnIndex}\n`);
+    process.stdout.write(`  trigger:    ${cp.trigger}\n`);
+    process.stdout.write(`  when:       ${cp.createdAt}\n`);
+    process.stdout.write(`  description: ${cp.description}\n`);
+    if (cp.toolName)
+        process.stdout.write(`  tool:       ${cp.toolName}\n`);
+    process.stdout.write(`  files:      ${cp.files.length} (${formatBytes(cp.totalBytes)})\n`);
+    for (const f of cp.files) {
+        process.stdout.write(`    [${f.status.padEnd(8)}] ${f.path}`);
+        if (f.status !== 'deleted')
+            process.stdout.write(` (${formatBytes(f.size)})`);
+        process.stdout.write('\n');
+    }
+    return 0;
+}
+async function restoreCheckpoint(store, id, yes) {
+    const cp = await store.get(id);
+    if (!cp) {
+        process.stderr.write(`forge checkpoint: no checkpoint with id "${id}"\n`);
+        return 2;
+    }
+    // v2.12: worktree-aware restore warning. When the checkpoint was
+    // captured inside a different git worktree (or a different repo
+    // entirely), surface that to the user before we go overwriting
+    // files. The store still operates on cwd-relative paths, so the
+    // restore would silently succeed: just on the wrong tree.
+    //
+    // We probe the current cwd's worktree context on demand (cheap,
+    // and skipped when not in a git repo). Best-effort: if the probe
+    // fails, we proceed without a warning rather than blocking the
+    // restore.
+    let mismatch = null;
+    try {
+        const currentSnap = await snapshotWorktreeContext(store.cwdPath());
+        mismatch = compareWorktreeContexts(cp.worktreeContext, currentSnap);
+    }
+    catch {
+        // ignore: proceed without warning
+    }
+    const worktreeWarning = mismatch?.message ?? null;
+    if (!yes) {
+        process.stderr.write(`About to restore ${cp.files.length} file${cp.files.length === 1 ? '' : 's'} from checkpoint "${cp.id}".\n`);
+        if (worktreeWarning) {
+            // Prefix with a clear marker so users (and CI logs) can grep
+            // for the warning class.
+            process.stderr.write(`  ⚠  worktree mismatch (${mismatch.kind}): ${worktreeWarning}\n`);
+        }
+        process.stderr.write('Re-run with --yes to confirm. Refusing to overwrite uncommitted work without an explicit flag.\n');
+        return 2;
+    }
+    // Even with --yes, print the worktree warning before proceeding so
+    // it's visible in logs / transcripts. Users can redirect to a
+    // file to suppress the visual but the warning still surfaces.
+    if (worktreeWarning) {
+        process.stderr.write(`⚠  ${worktreeWarning}\n`);
+    }
+    const result = await store.restore(id);
+    if (!result) {
+        process.stderr.write(`forge checkpoint: failed to restore "${id}"\n`);
+        return 1;
+    }
+    const parts = [];
+    if (result.restored.length > 0)
+        parts.push(`${result.restored.length} restored`);
+    if (result.modified.length > 0)
+        parts.push(`${result.modified.length} modified`);
+    if (result.removed.length > 0)
+        parts.push(`${result.removed.length} removed`);
+    if (result.unchanged.length > 0)
+        parts.push(`${result.unchanged.length} unchanged`);
+    process.stdout.write(`restored ${id}: ${parts.join(', ') || 'no changes'}\n`);
+    if (result.modified.length > 0) {
+        process.stdout.write('  modified:\n');
+        for (const f of result.modified)
+            process.stdout.write(`    ${f}\n`);
+    }
+    if (result.restored.length > 0) {
+        process.stdout.write('  restored:\n');
+        for (const f of result.restored)
+            process.stdout.write(`    ${f}\n`);
+    }
+    if (result.removed.length > 0) {
+        process.stdout.write('  removed:\n');
+        for (const f of result.removed)
+            process.stdout.write(`    ${f}\n`);
+    }
+    return 0;
+}
+async function pruneCheckpoints(store, keep) {
+    const result = await store.prune(keep);
+    process.stdout.write(`pruned: kept ${result.kept}, removed ${result.removed}, freed ${formatBytes(result.bytesFreed)}\n`);
+    return 0;
+}
+function formatBytes(n) {
+    if (n < 1024)
+        return `${n}B`;
+    if (n < 1024 * 1024)
+        return `${(n / 1024).toFixed(1)}KB`;
+    return `${(n / (1024 * 1024)).toFixed(2)}MB`;
+}
+// Late import: keeps the file-relative path resolution at function call
+// time (we already use the function above). The import is at the bottom
+// so it doesn't disturb the soft-prefix handler shape.
+import path from 'node:path';
+void path;
+//# sourceMappingURL=checkpoint.js.map

package/dist/commands/checkpoint.js.map

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

package/dist/commands/config.d.ts

@@ -0,0 +1,15 @@
+import React from 'react';
+import { loadForgeConfigFile as coreLoad, saveForgeConfigFile as coreSave } from '@ikarmic/forge-core';
+import type { CredentialStore } from '@ikarmic/forge-core';
+export interface ConfigWizardProps {
+    loadForgeConfigFile: typeof coreLoad;
+    saveForgeConfigFile: typeof coreSave;
+    credentialStore: CredentialStore;
+    onExit: () => void;
+}
+export declare function ConfigWizard(props: ConfigWizardProps): React.ReactElement;
+/** Renders the wizard and resolves once the user finishes. */
+export declare function runConfigWizard(deps: {
+    credentialStore: CredentialStore;
+}): Promise<void>;
+//# sourceMappingURL=config.d.ts.map

package/dist/commands/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/commands/config.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA8B,MAAM,OAAO,CAAC;AAMnD,OAAO,EAOL,mBAAmB,IAAI,QAAQ,EAE/B,mBAAmB,IAAI,QAAQ,EAGhC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,eAAe,EAA0E,MAAM,qBAAqB,CAAC;AAEnI,MAAM,WAAW,iBAAiB;IAChC,mBAAmB,EAAE,OAAO,QAAQ,CAAC;IACrC,mBAAmB,EAAE,OAAO,QAAQ,CAAC;IACrC,eAAe,EAAE,eAAe,CAAC;IACjC,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB;AAID,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,KAAK,CAAC,YAAY,CA2NzE;AAED,8DAA8D;AAC9D,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAAE,eAAe,EAAE,eAAe,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAU/F"}

package/dist/commands/config.js

@@ -0,0 +1,180 @@
+import React, { useEffect, useState } from 'react';
+import { Box, Text, render, useApp } from 'ink';
+import SelectInput from 'ink-select-input';
+import TextInput from 'ink-text-input';
+import { readFile, writeFile } from 'node:fs/promises';
+import { BUILTIN_TOOLS, MODEL_CATALOG, SUPPORTED_PROVIDERS, exportSettings, importSettings, listSpecialists, loadForgeConfigFile as coreLoad, loadToolSandboxConfig, saveForgeConfigFile as coreSave, saveSpecialistsToConfig, saveToolSandboxConfig, } from '@ikarmic/forge-core';
+export function ConfigWizard(props) {
+    const { exit } = useApp();
+    const [step, setStep] = useState('provider');
+    const [provider, setProvider] = useState(null);
+    const [keyInput, setKeyInput] = useState('');
+    const [agents, setAgents] = useState(() => [...listSpecialists()]);
+    const [agentError, setAgentError] = useState(null);
+    const [exportImportMsg, setExportImportMsg] = useState(null);
+    const [denyTools, setDenyTools] = useState([]);
+    const [permissionsMsg, setPermissionsMsg] = useState(null);
+    useEffect(() => {
+        loadToolSandboxConfig(process.cwd(), { trustedProjectSettings: false }).then(({ sandbox }) => {
+            setDenyTools(sandbox.denyTools ?? []);
+        });
+    }, []);
+    if (step === 'provider') {
+        return (React.createElement(Box, { flexDirection: "column" },
+            React.createElement(Text, { bold: true }, "Provider"),
+            React.createElement(SelectInput, { items: SUPPORTED_PROVIDERS.map((p) => ({ label: p, value: p })), onSelect: (item) => {
+                    setProvider(item.value);
+                    setStep('model');
+                } })));
+    }
+    if (step === 'model' && provider) {
+        const entries = MODEL_CATALOG[provider];
+        return (React.createElement(Box, { flexDirection: "column" },
+            React.createElement(Text, { bold: true },
+                "Model (",
+                provider,
+                ")"),
+            React.createElement(SelectInput, { items: entries.map((e) => ({ label: e.label, value: e.id })), onSelect: async (item) => {
+                    await props.saveForgeConfigFile({ provider, model: item.value });
+                    setStep('reasoningEffort');
+                } })));
+    }
+    if (step === 'reasoningEffort') {
+        const options = [
+            { label: '(provider default)', value: '' },
+            { label: 'None', value: 'none' },
+            { label: 'Minimal', value: 'minimal' },
+            { label: 'Low', value: 'low' },
+            { label: 'Medium', value: 'medium' },
+            { label: 'High', value: 'high' },
+            { label: 'Extra high', value: 'xhigh' },
+        ];
+        return (React.createElement(Box, { flexDirection: "column" },
+            React.createElement(Text, { bold: true }, "Reasoning effort"),
+            React.createElement(SelectInput, { items: options, onSelect: async (item) => {
+                    await props.saveForgeConfigFile({
+                        ...(item.value ? { reasoningEffort: item.value } : {}),
+                    });
+                    setStep('apiKey');
+                } })));
+    }
+    if (step === 'apiKey' && provider) {
+        return (React.createElement(Box, { flexDirection: "column" },
+            React.createElement(Text, { bold: true },
+                "API key for ",
+                provider),
+            React.createElement(TextInput, { value: keyInput, onChange: setKeyInput, mask: "*", onSubmit: async (value) => {
+                    if (value)
+                        await props.credentialStore.set(provider, value);
+                    setStep('agents');
+                } }),
+            React.createElement(Text, { color: "gray" }, "Press Enter to skip")));
+    }
+    if (step === 'agents') {
+        return (React.createElement(Box, { flexDirection: "column" },
+            React.createElement(Text, { bold: true },
+                "Agents (",
+                agents.length,
+                " custom)"),
+            agents.map((a) => (React.createElement(Text, { key: a.id },
+                "- ",
+                a.id,
+                ": ",
+                a.description))),
+            agentError && React.createElement(Text, { color: "red" }, agentError),
+            React.createElement(SelectInput, { items: [
+                    { label: 'Save and continue', value: 'save' },
+                    { label: 'Skip (no changes)', value: 'skip' },
+                ], onSelect: async (item) => {
+                    if (item.value === 'save') {
+                        try {
+                            await saveSpecialistsToConfig(agents);
+                            setStep('permissions');
+                        }
+                        catch (err) {
+                            setAgentError(err.message);
+                        }
+                    }
+                    else {
+                        setStep('permissions');
+                    }
+                } })));
+    }
+    if (step === 'permissions') {
+        const items = BUILTIN_TOOLS.map((t) => ({
+            label: (denyTools.includes(t.name) ? '[x] ' : '[ ] ') + t.name,
+            value: t.name,
+        }));
+        return (React.createElement(Box, { flexDirection: "column" },
+            React.createElement(Text, { bold: true }, "Permissions: toggle tools to deny (Enter to toggle, select \"Done\" to save)"),
+            permissionsMsg && React.createElement(Text, { color: "green" }, permissionsMsg),
+            React.createElement(SelectInput, { items: [...items, { label: 'Done', value: '__done__' }], onSelect: async (item) => {
+                    if (item.value === '__done__') {
+                        const sandbox = denyTools.length > 0 ? { denyTools } : {};
+                        await saveToolSandboxConfig(sandbox);
+                        setPermissionsMsg('Saved.');
+                        setStep('display');
+                        return;
+                    }
+                    setDenyTools((prev) => prev.includes(item.value) ? prev.filter((t) => t !== item.value) : [...prev, item.value]);
+                } })));
+    }
+    if (step === 'display') {
+        const options = [
+            { label: 'Review first (expanded blocks, reasoning shown)', value: 'review' },
+            { label: 'High autonomy (collapsed blocks, reasoning hidden)', value: 'autonomy' },
+            { label: 'Continue without changing', value: 'skip' },
+        ];
+        return (React.createElement(Box, { flexDirection: "column" },
+            React.createElement(Text, { bold: true }, "Display"),
+            React.createElement(SelectInput, { items: options, onSelect: async (item) => {
+                    if (item.value === 'review') {
+                        await props.saveForgeConfigFile({ display: { detail: 'full', showReasoning: true } });
+                    }
+                    else if (item.value === 'autonomy') {
+                        await props.saveForgeConfigFile({ display: { detail: 'compact', showReasoning: false } });
+                    }
+                    setStep('exportImport');
+                } })));
+    }
+    if (step === 'exportImport') {
+        const options = [
+            { label: 'Export settings to ./forge-settings.json', value: 'export' },
+            { label: 'Import settings from ./forge-settings.json', value: 'import' },
+            { label: 'Done', value: 'done' },
+        ];
+        return (React.createElement(Box, { flexDirection: "column" },
+            React.createElement(Text, { bold: true }, "Export / Import"),
+            exportImportMsg && React.createElement(Text, { color: "green" }, exportImportMsg),
+            React.createElement(SelectInput, { items: options, onSelect: async (item) => {
+                    if (item.value === 'export') {
+                        const data = await exportSettings({});
+                        await writeFile('./forge-settings.json', JSON.stringify(data, null, 2) + '\n', 'utf8');
+                        setExportImportMsg('Exported to ./forge-settings.json');
+                        return;
+                    }
+                    if (item.value === 'import') {
+                        try {
+                            const raw = await readFile('./forge-settings.json', 'utf8');
+                            await importSettings(JSON.parse(raw), {});
+                            setExportImportMsg('Imported from ./forge-settings.json');
+                        }
+                        catch (err) {
+                            setExportImportMsg('Import failed: ' + err.message);
+                        }
+                        return;
+                    }
+                    setStep('done');
+                    props.onExit();
+                    exit();
+                } })));
+    }
+    return (React.createElement(Box, null,
+        React.createElement(Text, { color: "green" }, "Saved.")));
+}
+/** Renders the wizard and resolves once the user finishes. */
+export async function runConfigWizard(deps) {
+    const { waitUntilExit } = render(React.createElement(ConfigWizard, { loadForgeConfigFile: coreLoad, saveForgeConfigFile: coreSave, credentialStore: deps.credentialStore, onExit: () => { } }));
+    await waitUntilExit();
+}
+//# sourceMappingURL=config.js.map

package/dist/commands/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/commands/config.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACnD,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,CAAC;AAChD,OAAO,WAAW,MAAM,kBAAkB,CAAC;AAC3C,OAAO,SAAS,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,EACL,aAAa,EACb,aAAa,EACb,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,eAAe,EACf,mBAAmB,IAAI,QAAQ,EAC/B,qBAAqB,EACrB,mBAAmB,IAAI,QAAQ,EAC/B,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAY7B,MAAM,UAAU,YAAY,CAAC,KAAwB;IACnD,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC;IAC1B,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAO,UAAU,CAAC,CAAC;IACnD,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAsB,IAAI,CAAC,CAAC;IACpE,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC7C,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAqB,GAAG,EAAE,CAAC,CAAC,GAAG,eAAe,EAAE,CAAC,CAAC,CAAC;IACvF,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAC;IAClE,MAAM,CAAC,eAAe,EAAE,kBAAkB,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAC;IAC5E,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAW,EAAE,CAAC,CAAC;IACzD,MAAM,CAAC,cAAc,EAAE,iBAAiB,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAC;IAE1E,SAAS,CAAC,GAAG,EAAE;QACb,qBAAqB,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,EAAE,sBAAsB,EAAE,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE;YAC3F,YAAY,CAAC,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;IACL,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;QACxB,OAAO,CACL,oBAAC,GAAG,IAAC,aAAa,EAAC,QAAQ;YACzB,oBAAC,IAAI,IAAC,IAAI,qBAAgB;YAC1B,oBAAC,WAAW,IACV,KAAK,EAAE,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,EAC/D,QAAQ,EAAE,CAAC,IAA6B,EAAE,EAAE;oBAC1C,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;oBACxB,OAAO,CAAC,OAAO,CAAC,CAAC;gBACnB,CAAC,GACD,CACE,CACP,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,KAAK,OAAO,IAAI,QAAQ,EAAE,CAAC;QACjC,MAAM,OAAO,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;QACxC,OAAO,CACL,oBAAC,GAAG,IAAC,aAAa,EAAC,QAAQ;YACzB,oBAAC,IAAI,IAAC,IAAI;;gBAAS,QAAQ;oBAAS;YACpC,oBAAC,WAAW,IACV,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAC5D,QAAQ,EAAE,KAAK,EAAE,IAAuB,EAAE,EAAE;oBAC1C,MAAM,KAAK,CAAC,mBAAmB,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;oBACjE,OAAO,CAAC,iBAAiB,CAAC,CAAC;gBAC7B,CAAC,GACD,CACE,CACP,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,KAAK,iBAAiB,EAAE,CAAC;QAC/B,MAAM,OAAO,GAAG;YACd,EAAE,KAAK,EAAE,oBAAoB,EAAE,KAAK,EAAE,EAAE,EAAE;YAC1C,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE;YAChC,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;YACtC,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE;YAC9B,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE;YACpC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE;YAChC,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE;SACxC,CAAC;QACF,OAAO,CACL,oBAAC,GAAG,IAAC,aAAa,EAAC,QAAQ;YACzB,oBAAC,IAAI,IAAC,IAAI,6BAAwB;YAClC,oBAAC,WAAW,IACV,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,KAAK,EAAE,IAAuB,EAAE,EAAE;oBAC1C,MAAM,KAAK,CAAC,mBAAmB,CAAC;wBAC9B,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,IAAI,CAAC,KAA2C,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;qBAC7F,CAAC,CAAC;oBACH,OAAO,CAAC,QAAQ,CAAC,CAAC;gBACpB,CAAC,GACD,CACE,CACP,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,KAAK,QAAQ,IAAI,QAAQ,EAAE,CAAC;QAClC,OAAO,CACL,oBAAC,GAAG,IAAC,aAAa,EAAC,QAAQ;YACzB,oBAAC,IAAI,IAAC,IAAI;;gBAAc,QAAQ,CAAQ;YACxC,oBAAC,SAAS,IACR,KAAK,EAAE,QAAQ,EACf,QAAQ,EAAE,WAAW,EACrB,IAAI,EAAC,GAAG,EACR,QAAQ,EAAE,KAAK,EAAE,KAAa,EAAE,EAAE;oBAChC,IAAI,KAAK;wBAAE,MAAM,KAAK,CAAC,eAAe,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;oBAC5D,OAAO,CAAC,QAAQ,CAAC,CAAC;gBACpB,CAAC,GACD;YACF,oBAAC,IAAI,IAAC,KAAK,EAAC,MAAM,0BAA2B,CACzC,CACP,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,OAAO,CACL,oBAAC,GAAG,IAAC,aAAa,EAAC,QAAQ;YACzB,oBAAC,IAAI,IAAC,IAAI;;gBAAU,MAAM,CAAC,MAAM;2BAAgB;YAChD,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CACjB,oBAAC,IAAI,IAAC,GAAG,EAAE,CAAC,CAAC,EAAE;;gBACV,CAAC,CAAC,EAAE;;gBAAI,CAAC,CAAC,WAAW,CACnB,CACR,CAAC;YACD,UAAU,IAAI,oBAAC,IAAI,IAAC,KAAK,EAAC,KAAK,IAAE,UAAU,CAAQ;YACpD,oBAAC,WAAW,IACV,KAAK,EAAE;oBACL,EAAE,KAAK,EAAE,mBAAmB,EAAE,KAAK,EAAE,MAAM,EAAE;oBAC7C,EAAE,KAAK,EAAE,mBAAmB,EAAE,KAAK,EAAE,MAAM,EAAE;iBAC9C,EACD,QAAQ,EAAE,KAAK,EAAE,IAAuB,EAAE,EAAE;oBAC1C,IAAI,IAAI,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;wBAC1B,IAAI,CAAC;4BACH,MAAM,uBAAuB,CAAC,MAAM,CAAC,CAAC;4BACtC,OAAO,CAAC,aAAa,CAAC,CAAC;wBACzB,CAAC;wBAAC,OAAO,GAAG,EAAE,CAAC;4BACb,aAAa,CAAE,GAAa,CAAC,OAAO,CAAC,CAAC;wBACxC,CAAC;oBACH,CAAC;yBAAM,CAAC;wBACN,OAAO,CAAC,aAAa,CAAC,CAAC;oBACzB,CAAC;gBACH,CAAC,GACD,CACE,CACP,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,KAAK,aAAa,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACtC,KAAK,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI;YAC9D,KAAK,EAAE,CAAC,CAAC,IAAI;SACd,CAAC,CAAC,CAAC;QACJ,OAAO,CACL,oBAAC,GAAG,IAAC,aAAa,EAAC,QAAQ;YACzB,oBAAC,IAAI,IAAC,IAAI,yFAA4F;YACrG,cAAc,IAAI,oBAAC,IAAI,IAAC,KAAK,EAAC,OAAO,IAAE,cAAc,CAAQ;YAC9D,oBAAC,WAAW,IACV,KAAK,EAAE,CAAC,GAAG,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,EACvD,QAAQ,EAAE,KAAK,EAAE,IAAuB,EAAE,EAAE;oBAC1C,IAAI,IAAI,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;wBAC9B,MAAM,OAAO,GAA0B,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;wBACjF,MAAM,qBAAqB,CAAC,OAAO,CAAC,CAAC;wBACrC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;wBAC5B,OAAO,CAAC,SAAS,CAAC,CAAC;wBACnB,OAAO;oBACT,CAAC;oBACD,YAAY,CAAC,CAAC,IAAI,EAAE,EAAE,CACpB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CACzF,CAAC;gBACJ,CAAC,GACD,CACE,CACP,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG;YACd,EAAE,KAAK,EAAE,iDAAiD,EAAE,KAAK,EAAE,QAAQ,EAAE;YAC7E,EAAE,KAAK,EAAE,oDAAoD,EAAE,KAAK,EAAE,UAAU,EAAE;YAClF,EAAE,KAAK,EAAE,2BAA2B,EAAE,KAAK,EAAE,MAAM,EAAE;SACtD,CAAC;QACF,OAAO,CACL,oBAAC,GAAG,IAAC,aAAa,EAAC,QAAQ;YACzB,oBAAC,IAAI,IAAC,IAAI,oBAAe;YACzB,oBAAC,WAAW,IACV,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,KAAK,EAAE,IAAuB,EAAE,EAAE;oBAC1C,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;wBAC5B,MAAM,KAAK,CAAC,mBAAmB,CAAC,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;oBACxF,CAAC;yBAAM,IAAI,IAAI,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;wBACrC,MAAM,KAAK,CAAC,mBAAmB,CAAC,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;oBAC5F,CAAC;oBACD,OAAO,CAAC,cAAc,CAAC,CAAC;gBAC1B,CAAC,GACD,CACE,CACP,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,KAAK,cAAc,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG;YACd,EAAE,KAAK,EAAE,0CAA0C,EAAE,KAAK,EAAE,QAAQ,EAAE;YACtE,EAAE,KAAK,EAAE,4CAA4C,EAAE,KAAK,EAAE,QAAQ,EAAE;YACxE,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE;SACjC,CAAC;QACF,OAAO,CACL,oBAAC,GAAG,IAAC,aAAa,EAAC,QAAQ;YACzB,oBAAC,IAAI,IAAC,IAAI,4BAAuB;YAChC,eAAe,IAAI,oBAAC,IAAI,IAAC,KAAK,EAAC,OAAO,IAAE,eAAe,CAAQ;YAChE,oBAAC,WAAW,IACV,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,KAAK,EAAE,IAAuB,EAAE,EAAE;oBAC1C,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;wBAC5B,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,EAAE,CAAC,CAAC;wBACtC,MAAM,SAAS,CAAC,uBAAuB,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;wBACvF,kBAAkB,CAAC,mCAAmC,CAAC,CAAC;wBACxD,OAAO;oBACT,CAAC;oBACD,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;wBAC5B,IAAI,CAAC;4BACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC,CAAC;4BAC5D,MAAM,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;4BAC1C,kBAAkB,CAAC,qCAAqC,CAAC,CAAC;wBAC5D,CAAC;wBAAC,OAAO,GAAG,EAAE,CAAC;4BACb,kBAAkB,CAAC,iBAAiB,GAAI,GAAa,CAAC,OAAO,CAAC,CAAC;wBACjE,CAAC;wBACD,OAAO;oBACT,CAAC;oBACD,OAAO,CAAC,MAAM,CAAC,CAAC;oBAChB,KAAK,CAAC,MAAM,EAAE,CAAC;oBACf,IAAI,EAAE,CAAC;gBACT,CAAC,GACD,CACE,CACP,CAAC;IACJ,CAAC;IAED,OAAO,CACL,oBAAC,GAAG;QACF,oBAAC,IAAI,IAAC,KAAK,EAAC,OAAO,aAAc,CAC7B,CACP,CAAC;AACJ,CAAC;AAED,8DAA8D;AAC9D,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAA0C;IAC9E,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,CAC9B,oBAAC,YAAY,IACX,mBAAmB,EAAE,QAAQ,EAC7B,mBAAmB,EAAE,QAAQ,EAC7B,eAAe,EAAE,IAAI,CAAC,eAAe,EACrC,MAAM,EAAE,GAAG,EAAE,GAAE,CAAC,GAChB,CACH,CAAC;IACF,MAAM,aAAa,EAAE,CAAC;AACxB,CAAC"}

package/dist/commands/diff.d.ts

@@ -0,0 +1,29 @@
+/**
+ * `forge diff <file1> <file2>` subcommand: print a unified diff between
+ * two files (or a file and stdin). Pure CLI surface over the
+ * {@link computeUnifiedDiff} core helper; no AI provider needed.
+ *
+ * Examples:
+ *   forge diff before.txt after.txt
+ *   forge diff --from-stdin package.json < updated-package.json
+ *   forge diff --context 5 src/old.ts src/new.ts
+ *
+ * The output is pipe-friendly: same format as `git diff`, so it
+ * composes with `less`, `diff-so-fancy`, etc.
+ */
+export interface DiffCommandOptions {
+    fileA: string;
+    fileB?: string;
+    contextLines?: number;
+    fromStdin?: boolean;
+    /** When set, only print the one-line summary (no diff text). */
+    summaryOnly?: boolean;
+    cwd?: string;
+}
+/**
+ * Run the `forge diff` subcommand. Resolves file paths relative to
+ * `cwd` and prints the unified diff (or summary) to stdout. Returns
+ * the shell exit code: 0 = files identical, 1 = files differ, 2 = error.
+ */
+export declare function handleDiffCommand(opts: DiffCommandOptions): number;
+//# sourceMappingURL=diff.d.ts.map

package/dist/commands/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../src/commands/diff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,gEAAgE;IAChE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,CA6ClE"}

package/dist/commands/diff.js

@@ -0,0 +1,90 @@
+/**
+ * `forge diff <file1> <file2>` subcommand: print a unified diff between
+ * two files (or a file and stdin). Pure CLI surface over the
+ * {@link computeUnifiedDiff} core helper; no AI provider needed.
+ *
+ * Examples:
+ *   forge diff before.txt after.txt
+ *   forge diff --from-stdin package.json < updated-package.json
+ *   forge diff --context 5 src/old.ts src/new.ts
+ *
+ * The output is pipe-friendly: same format as `git diff`, so it
+ * composes with `less`, `diff-so-fancy`, etc.
+ */
+import { readFileSync } from 'node:fs';
+import process from 'node:process';
+import { computeDiffSummary, computeUnifiedDiff } from '@ikarmic/forge-core';
+/**
+ * Run the `forge diff` subcommand. Resolves file paths relative to
+ * `cwd` and prints the unified diff (or summary) to stdout. Returns
+ * the shell exit code: 0 = files identical, 1 = files differ, 2 = error.
+ */
+export function handleDiffCommand(opts) {
+    let before;
+    let after;
+    try {
+        before = readFileSync(resolvePath(opts.cwd ?? process.cwd(), opts.fileA), 'utf8');
+    }
+    catch (err) {
+        process.stderr.write(`forge diff: failed to read ${opts.fileA}: ${err.message}\n`);
+        return 2;
+    }
+    if (opts.fromStdin) {
+        try {
+            after = readStdinSync();
+        }
+        catch (err) {
+            process.stderr.write(`forge diff: failed to read stdin: ${err.message}\n`);
+            return 2;
+        }
+    }
+    else {
+        const fileB = opts.fileB;
+        if (!fileB) {
+            process.stderr.write('forge diff: missing <fileB> (or pass --from-stdin)\n');
+            return 2;
+        }
+        try {
+            after = readFileSync(resolvePath(opts.cwd ?? process.cwd(), fileB), 'utf8');
+        }
+        catch (err) {
+            process.stderr.write(`forge diff: failed to read ${fileB}: ${err.message}\n`);
+            return 2;
+        }
+    }
+    const diffOpts = {
+        filePath: opts.fileB ?? opts.fileA,
+        ...(opts.contextLines !== undefined ? { contextLines: opts.contextLines } : {}),
+    };
+    const result = computeUnifiedDiff(before, after, diffOpts);
+    if (opts.summaryOnly) {
+        const summary = computeDiffSummary(before, after, diffOpts);
+        process.stdout.write(`${summary.summary}\n`);
+    }
+    else if (!result.unchanged) {
+        process.stdout.write(result.text);
+        if (!result.text.endsWith('\n'))
+            process.stdout.write('\n');
+    }
+    return result.unchanged ? 0 : 1;
+}
+function resolvePath(cwd, p) {
+    // Simple path resolver: accepts absolute paths as-is, otherwise
+    // joins with cwd. Node's path.resolve would also normalize `..` but
+    // we keep it minimal here. Also recognizes Windows UNC paths
+    // (`\\server\share\file`) as absolute.
+    if (p.startsWith('/') || p.startsWith('\\\\') || /^[a-zA-Z]:[\\/]/.test(p))
+        return p;
+    return `${cwd}/${p}`;
+}
+function readStdinSync() {
+    // Node 18+ exposes fs.readFileSync('/dev/stdin') as a synchronous
+    // stdin read. On Windows this falls back to reading 0 via `readFileSync`
+    // which works for short inputs. Errors (e.g. a known partial-read/EAGAIN
+    // behavior on non-regular-file descriptors for large piped input on
+    // Windows) propagate to the caller rather than being swallowed into ''
+    //: silently treating a read failure as empty stdin would make `forge
+    // diff --from-stdin` claim the whole file was deleted with no warning.
+    return readFileSync(0, 'utf8');
+}
+//# sourceMappingURL=diff.js.map

package/dist/commands/diff.js.map

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

package/dist/commands/hook.d.ts

@@ -0,0 +1,10 @@
+/**
+ * `forge hook …` subcommand: list, test, log hooks.
+ *
+ * Hooks are loaded from `~/.forge/settings.json` + `.forge/settings.json`
+ * exactly the way the agent does, so what you see here matches what the
+ * agent runs.
+ */
+import type { ParsedHookCommand } from '../options.js';
+export declare function handleHookCommand(cmd: ParsedHookCommand, cwd: string): Promise<number>;
+//# sourceMappingURL=hook.d.ts.map

package/dist/commands/hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook.d.ts","sourceRoot":"","sources":["../../src/commands/hook.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvD,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,iBAAiB,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAa5F"}