ikarmic-forge 0.0.0-stage → 4.4.0

package/dist/commands/orchestrator.d.ts

@@ -0,0 +1,22 @@
+/**
+ * `forge orchestrator …` subcommand: multi-agent routing.
+ *
+ * `forge orchestrator list`: show available specialists
+ * `forge orchestrator run "<task>"`: dispatch the task via the orchestrator
+ * `forge orchestrator plan "<task>"`: preview the routing plan without running it
+ *
+ * Mirrors the other soft-prefix subcommands: no special parsing,
+ * exits 0/1/2.
+ */
+import type { ParsedOrchestratorCommand } from '../options.js';
+export declare function handleOrchestratorCommand(cmd: ParsedOrchestratorCommand, cwd: string, model: {
+    provider: string;
+    model: string;
+}, options?: {
+    worktrees?: 'auto' | 'always' | 'never';
+    /** v2.14: delete orchestrator-created branches alongside their worktrees. */
+    cleanupBranches?: boolean;
+    /** Commit worktree specialists' edits onto kept branches. */
+    commitChanges?: boolean;
+}): Promise<number>;
+//# sourceMappingURL=orchestrator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../src/commands/orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAYH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAE/D,wBAAsB,yBAAyB,CAC7C,GAAG,EAAE,yBAAyB,EAC9B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAC1C,OAAO,GAAE;IACP,SAAS,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IACxC,6EAA6E;IAC7E,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,6DAA6D;IAC7D,aAAa,CAAC,EAAE,OAAO,CAAC;CACpB,GACL,OAAO,CAAC,MAAM,CAAC,CAmBjB"}

package/dist/commands/orchestrator.js

@@ -0,0 +1,113 @@
+/**
+ * `forge orchestrator …` subcommand: multi-agent routing.
+ *
+ * `forge orchestrator list`: show available specialists
+ * `forge orchestrator run "<task>"`: dispatch the task via the orchestrator
+ * `forge orchestrator plan "<task>"`: preview the routing plan without running it
+ *
+ * Mirrors the other soft-prefix subcommands: no special parsing,
+ * exits 0/1/2.
+ */
+import process from 'node:process';
+import { BUILTIN_SPECIALISTS, listSpecialists, parseRouterOutput, runOrchestrator, runRouter, } from '@ikarmic/forge-core';
+export async function handleOrchestratorCommand(cmd, cwd, model, options = {}) {
+    if (cmd.list) {
+        return printSpecialistsList();
+    }
+    if (cmd.run) {
+        return runOrchestratorCli(cmd.run.task, cwd, model, {
+            preview: false,
+            worktrees: options.worktrees ?? 'auto',
+            cleanupBranches: options.cleanupBranches ?? true,
+            commitChanges: options.commitChanges ?? false,
+        });
+    }
+    if (cmd.plan) {
+        return runOrchestratorCli(cmd.plan.task, cwd, model, { preview: true });
+    }
+    process.stderr.write('forge orchestrator: expected one of list|run|plan. Try `forge orchestrator --help` (not yet implemented; read docs/ORCHESTRATOR.md).\n');
+    return 2;
+}
+async function printSpecialistsList() {
+    const builtinIds = new Set(BUILTIN_SPECIALISTS.map((s) => s.id));
+    const all = listSpecialists();
+    process.stdout.write('Available specialists:\n');
+    for (const s of all) {
+        const tag = builtinIds.has(s.id) ? 'core' : 'custom';
+        process.stdout.write(`  ${s.id.padEnd(8)} ${tag.padEnd(6)} ${s.description}\n`);
+    }
+    const customCount = all.length - BUILTIN_SPECIALISTS.length;
+    if (customCount > 0) {
+        process.stdout.write(`\n${customCount} custom specialist${customCount === 1 ? '' : 's'} loaded from ~/.forge/specialists.json\n`);
+    }
+    return 0;
+}
+async function runOrchestratorCli(task, cwd, model, opts) {
+    try {
+        if (opts.preview) {
+            const result = await runRouter({
+                task,
+                model: model,
+                cwd,
+                auto: true,
+                maxIterations: 5,
+            });
+            const plan = parseRouterOutput(result.finalText, task);
+            process.stdout.write(`Plan:\n  rationale: ${plan.rationale ?? '(none)'}\n`);
+            for (let i = 0; i < plan.steps.length; i++) {
+                const step = plan.steps[i];
+                process.stdout.write(`  ${i + 1}. [${step.specialist}] ${step.task}${step.parallelGroup ? ` (group: ${step.parallelGroup})` : ''}\n`);
+            }
+            return 0;
+        }
+        const result = await runOrchestrator({
+            task,
+            model: model,
+            cwd,
+            auto: true,
+            worktrees: opts.worktrees ?? 'auto',
+            // v2.14: delete auto-created branches (default true). Mirror
+            // the user's CLI flag via the dispatchOpts field below.
+            ...(opts.cleanupBranches !== undefined
+                ? { cleanupBranches: opts.cleanupBranches }
+                : {}),
+            ...(opts.commitChanges ? { commitChanges: true } : {}),
+            onWorktreeEvent: (event) => {
+                // Surface worktree lifecycle in stderr (so it doesn't pollute
+                // the plan/results output). Cheap progress signal.
+                process.stderr.write(`forge orchestrator: ${event.kind} worktree ${event.path} (${event.branch})\n`);
+            },
+        });
+        process.stdout.write(`Plan (${result.plan.rationale ?? 'no rationale'}):\n`);
+        for (let i = 0; i < result.steps.length; i++) {
+            const s = result.steps[i];
+            const wtInfo = s.worktreePath
+                ? ` worktree=${s.worktreeBranch}`
+                : '';
+            process.stdout.write(`  ${i + 1}. [${s.step.specialist}] ${s.reason} (${s.durationMs}ms)${wtInfo}${s.error ? ` ERROR: ${s.error}` : ''}\n`);
+            if (s.finalText) {
+                const preview = s.finalText.length > 200 ? s.finalText.slice(0, 200) + '…' : s.finalText;
+                process.stdout.write(`     → ${preview.replace(/\n/g, ' ')}\n`);
+            }
+        }
+        const kept = result.steps.filter((s) => s.worktreeCommit && s.worktreeBranch);
+        if (kept.length > 0) {
+            process.stdout.write('\nBranches with committed work (review, then merge or delete):\n');
+            for (const s of kept) {
+                process.stdout.write(`  ${s.worktreeBranch}  (${s.changedFiles?.length ?? 0} file${s.changedFiles?.length === 1 ? '' : 's'})\n` +
+                    `    review: git diff HEAD...${s.worktreeBranch}\n` +
+                    `    merge:  git merge --no-ff ${s.worktreeBranch}\n` +
+                    `    drop:   git branch -D ${s.worktreeBranch}\n`);
+            }
+        }
+        process.stdout.write(`\ntotal: ${result.durationMs}ms, ${result.totalInputTokens} in / ${result.totalOutputTokens} out tokens` +
+            (result.costKnown ? `, $${result.totalCostUsd.toFixed(4)}` : '') +
+            '\n');
+        return 0;
+    }
+    catch (err) {
+        process.stderr.write(`forge orchestrator: ${err.message}\n`);
+        return 1;
+    }
+}
+//# sourceMappingURL=orchestrator.js.map

package/dist/commands/orchestrator.js.map

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

package/dist/commands/plugin.d.ts

@@ -0,0 +1,3 @@
+import type { ParsedPluginCommand } from '../options.js';
+export declare function handlePluginCommand(cmd: ParsedPluginCommand, cwd: string): Promise<number>;
+//# sourceMappingURL=plugin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/commands/plugin.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAQzD,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,mBAAmB,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA6ChG"}

package/dist/commands/plugin.js

@@ -0,0 +1,62 @@
+/**
+ * `forge plugin …` subcommand: list, show, install, remove plugin bundles.
+ * No AI provider required. Exit codes: 0 ok, 2 user error, 1 unexpected.
+ */
+import { discoverPlugins, installPlugin, removePlugin } from '@ikarmic/forge-core';
+function counts(p) {
+    const hookCount = Object.values(p.hooks).reduce((n, entries) => n + (entries?.length ?? 0), 0);
+    const mcpCount = Object.keys(p.mcpServers).length;
+    return `skills: ${p.skillsDir ? 'yes' : 'no'}, hook entries: ${hookCount}, mcp servers: ${mcpCount}`;
+}
+export async function handlePluginCommand(cmd, cwd) {
+    const out = (s) => process.stdout.write(`${s}\n`);
+    const err = (s) => process.stderr.write(`${s}\n`);
+    try {
+        if (cmd.list) {
+            const plugins = await discoverPlugins(cwd);
+            if (plugins.length === 0)
+                out('(no plugins installed)');
+            for (const p of plugins)
+                out(`${p.name}${p.version ? `@${p.version}` : ''}  [${p.scope}]  ${counts(p)}${p.description ? `\n    ${p.description}` : ''}`);
+            return 0;
+        }
+        if (cmd.show) {
+            const plugin = (await discoverPlugins(cwd)).find((p) => p.name === cmd.show.name);
+            if (!plugin) {
+                err(`forge plugin: "${cmd.show.name}" is not installed`);
+                return 2;
+            }
+            out(`${plugin.name}${plugin.version ? `@${plugin.version}` : ''}  [${plugin.scope}]\n${plugin.root}\n${counts(plugin)}`);
+            for (const w of plugin.warnings)
+                out(`warning: ${w}`);
+            if (plugin.scope === 'project')
+                out('note: project plugins run hooks only after the project is trusted; their MCP servers are not started.');
+            return 0;
+        }
+        if (cmd.install) {
+            const plugin = await installPlugin(cmd.install.source, {
+                scope: cmd.install.project ? 'project' : 'global',
+                cwd,
+                overwrite: cmd.install.overwrite,
+            });
+            out(`installed ${plugin.name}${plugin.version ? `@${plugin.version}` : ''} → ${plugin.root}\n${counts(plugin)}`);
+            return 0;
+        }
+        if (cmd.remove) {
+            const removed = await removePlugin(cmd.remove.name, { scope: cmd.remove.project ? 'project' : 'global', cwd });
+            if (!removed) {
+                err(`forge plugin: "${cmd.remove.name}" is not installed in that scope`);
+                return 2;
+            }
+            out(`removed ${cmd.remove.name}`);
+            return 0;
+        }
+    }
+    catch (e) {
+        err(`forge plugin: ${e.message}`);
+        return 2;
+    }
+    err('forge plugin: expected one of list|show <name>|install <source>|remove <name>');
+    return 2;
+}
+//# sourceMappingURL=plugin.js.map

package/dist/commands/plugin.js.map

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

package/dist/commands/policy.d.ts

@@ -0,0 +1,2 @@
+export declare function handlePolicyCommand(): number;
+//# sourceMappingURL=policy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../src/commands/policy.ts"],"names":[],"mappings":"AAOA,wBAAgB,mBAAmB,IAAI,MAAM,CAa5C"}

package/dist/commands/policy.js

@@ -0,0 +1,21 @@
+/**
+ * `forge policy`: show which organization policy (if any) applies on this machine.
+ */
+import process from 'node:process';
+import { PolicyError, getOrgPolicy, managedPolicyPath } from '@ikarmic/forge-core';
+export function handlePolicyCommand() {
+    try {
+        const loaded = getOrgPolicy();
+        if (!loaded) {
+            process.stdout.write(`No organization policy is active.\n(Looked for ${process.env.FORGE_POLICY_FILE ?? managedPolicyPath()})\n`);
+            return 0;
+        }
+        process.stdout.write(`Organization policy: ${loaded.source}\n\n${JSON.stringify(loaded.policy, null, 2)}\n`);
+        return 0;
+    }
+    catch (err) {
+        process.stderr.write(`forge: ${err.message}\n`);
+        return err instanceof PolicyError ? 2 : 1;
+    }
+}
+//# sourceMappingURL=policy.js.map

package/dist/commands/policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.js","sourceRoot":"","sources":["../../src/commands/policy.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,OAAO,MAAM,cAAc,CAAC;AAEnC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAEnF,MAAM,UAAU,mBAAmB;IACjC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;QAC9B,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,kDAAkD,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,iBAAiB,EAAE,KAAK,CAAC,CAAC;YAClI,OAAO,CAAC,CAAC;QACX,CAAC;QACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,wBAAwB,MAAM,CAAC,MAAM,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QAC7G,OAAO,CAAC,CAAC;IACX,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAW,GAAa,CAAC,OAAO,IAAI,CAAC,CAAC;QAC3D,OAAO,GAAG,YAAY,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5C,CAAC;AACH,CAAC"}

package/dist/commands/skill.d.ts

@@ -0,0 +1,13 @@
+/**
+ * `forge skill …` subcommand: list, show, install, search, browse skills.
+ *
+ * Mirrors how `forge session …` works: no AI provider required, exits
+ * with code 0 on success / 2 on user error / 1 on unexpected failure.
+ *
+ * v2.1: `install <name>` consults the marketplace catalog first; falls
+ * back to the GitHub-URL / shorthand path when the name isn't found.
+ * `search <query>` fetches + filters the catalog.
+ */
+import type { ParsedSkillCommand } from '../options.js';
+export declare function handleSkillCommand(cmd: ParsedSkillCommand, cwd: string): Promise<number>;
+//# sourceMappingURL=skill.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../../src/commands/skill.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAcH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAWxD,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,kBAAkB,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAoB9F"}

package/dist/commands/skill.js

@@ -0,0 +1,194 @@
+/**
+ * `forge skill …` subcommand: list, show, install, search, browse skills.
+ *
+ * Mirrors how `forge session …` works: no AI provider required, exits
+ * with code 0 on success / 2 on user error / 1 on unexpected failure.
+ *
+ * v2.1: `install <name>` consults the marketplace catalog first; falls
+ * back to the GitHub-URL / shorthand path when the name isn't found.
+ * `search <query>` fetches + filters the catalog.
+ */
+import { mkdir, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { DEFAULT_SKILL_CATALOG_URL, discoverSkills, fetchSkillsCatalog, installSkillFromCatalog, loadSkillsRegistryAsync, searchSkills, } from '@ikarmic/forge-core';
+/**
+ * Skill marketplace catalog URL. The default URL points at a public
+ * JSON document hosted on GitHub raw content. Operators can override
+ * via `FORGE_SKILL_CATALOG_URL`.
+ */
+function catalogUrl() {
+    return process.env.FORGE_SKILL_CATALOG_URL ?? DEFAULT_SKILL_CATALOG_URL;
+}
+export async function handleSkillCommand(cmd, cwd) {
+    if (cmd.list) {
+        return listSkills(cwd);
+    }
+    if (cmd.show) {
+        return showSkill(cwd, cmd.show.name);
+    }
+    if (cmd.install) {
+        return installFromSource(cmd.install.url, cwd);
+    }
+    if (cmd.search) {
+        return searchCatalog(cmd.search.query, cmd.search.limit ?? undefined);
+    }
+    if (cmd.browse) {
+        return browseMarketplace();
+    }
+    process.stderr.write('forge skill: expected one of list|show|install|search|browse. Try `forge skill --help` (not yet implemented; read the README).\n');
+    return 2;
+}
+async function listSkills(cwd) {
+    const skills = await discoverSkills(cwd);
+    if (skills.length === 0) {
+        process.stdout.write(`(no skills found in ${cwd})\n`);
+        process.stdout.write('Discovery roots: ./skills/  ./.forge/skills/  ~/.forge/skills/\n');
+        return 0;
+    }
+    for (const skill of skills) {
+        const ver = skill.version ? ` v${skill.version}` : '';
+        process.stdout.write(`${skill.name}${ver}  [${skill.source.kind}]  ${skill.source.path}\n`);
+        if (skill.description) {
+            process.stdout.write(`    ${skill.description}\n`);
+        }
+    }
+    return 0;
+}
+async function showSkill(cwd, name) {
+    const registry = await loadSkillsRegistryAsync(cwd);
+    const skill = registry.get(name);
+    if (!skill) {
+        process.stderr.write(`forge skill: no skill named "${name}"\n`);
+        return 2;
+    }
+    process.stdout.write(`# ${skill.name}\n`);
+    if (skill.version)
+        process.stdout.write(`version: ${skill.version}\n`);
+    process.stdout.write(`source: ${skill.source.kind}  ${skill.source.path}\n`);
+    if (skill.description)
+        process.stdout.write(`description: ${skill.description}\n`);
+    if (skill.allowedTools && skill.allowedTools.length > 0) {
+        process.stdout.write(`allowed-tools: ${skill.allowedTools.join(', ')}\n`);
+    }
+    process.stdout.write('\n');
+    process.stdout.write(skill.body);
+    if (!skill.body.endsWith('\n'))
+        process.stdout.write('\n');
+    return 0;
+}
+async function installFromSource(source, cwd) {
+    // v2.1: try the marketplace catalog first when `source` looks like a
+    // name (no `/`, no scheme, no `.git`). Falls back to GitHub URL /
+    // shorthand handling when the catalog fetch fails or the name isn't
+    // found.
+    if (looksLikeSkillName(source)) {
+        const catalog = await fetchSkillsCatalog(catalogUrl());
+        if (catalog) {
+            const entry = catalog.skills.find((s) => s.name === source);
+            if (entry) {
+                const result = await installSkillFromCatalog({
+                    name: source,
+                    catalog,
+                });
+                if (result) {
+                    process.stdout.write(`installed ${result.path}\n`);
+                    return 0;
+                }
+                process.stderr.write(`forge skill install: failed to fetch ${entry.github}: falling back\n`);
+            }
+            else {
+                process.stderr.write(`forge skill install: "${source}" not in marketplace: falling back\n`);
+            }
+        }
+        else {
+            process.stderr.write(`forge skill install: could not load marketplace catalog (${catalogUrl()}): falling back to URL stub\n`);
+        }
+    }
+    // Fallback: scaffold a SKILL.md stub (the v1.1 behavior).
+    const targetDir = path.resolve(cwd, 'skills');
+    await mkdir(targetDir, { recursive: true });
+    const slug = slugFromUrl(source);
+    const skillPath = path.join(targetDir, `${slug}.md`);
+    const content = `---
+name: ${slug}
+description: Skill installed from ${source}. Edit this description so the activator picks it up for matching tasks.
+version: 1.0.0
+---
+
+# ${slug}
+
+This skill was installed by \`forge skill install ${source}\`.
+
+Replace this body with your own instructions. The activator matches on the
+\`description\` field above: keep it focused (1-2 sentences) and free of
+generic words ("the", "and", "use", "tool") so description-scoring
+selects it for the right tasks.
+
+Upstream: ${source}
+`;
+    await writeFile(skillPath, content, 'utf8');
+    process.stdout.write(`installed ${skillPath}\n`);
+    process.stdout.write(`Next: edit ${skillPath} and write your skill body.\n`);
+    return 0;
+}
+/** Heuristic: does `source` look like a skill name (vs a URL)? */
+function looksLikeSkillName(source) {
+    if (!source)
+        return false;
+    if (source.includes('/') || source.includes('\\'))
+        return false;
+    if (/^[a-z]+:\/\//i.test(source))
+        return false;
+    if (source.includes('.'))
+        return false; // skip .git, .com, etc.
+    return /^[a-z0-9_-]+$/i.test(source);
+}
+async function searchCatalog(query, limit) {
+    const catalog = await fetchSkillsCatalog(catalogUrl());
+    if (!catalog) {
+        process.stderr.write(`forge skill search: could not load marketplace catalog (${catalogUrl()})\n` +
+            `Set FORGE_SKILL_CATALOG_URL to override.\n`);
+        return 1;
+    }
+    const result = searchSkills(catalog, query, limit);
+    if (result.matches.length === 0) {
+        process.stdout.write(`(no skills match "${query}" in ${result.totalScanned} catalog entries)\n`);
+        return 0;
+    }
+    for (const skill of result.matches) {
+        const ver = skill.version ? ` v${skill.version}` : '';
+        process.stdout.write(`${skill.name}${ver}  ·  ${skill.displayName}\n`);
+        if (skill.description)
+            process.stdout.write(`    ${skill.description}\n`);
+        if (skill.tags && skill.tags.length > 0) {
+            process.stdout.write(`    tags: ${skill.tags.join(', ')}\n`);
+        }
+    }
+    process.stdout.write(`\n${result.matches.length} of ${result.totalScanned} entries matched.\n`);
+    process.stdout.write(`Install with: forge skill install <name>\n`);
+    return 0;
+}
+function slugFromUrl(url) {
+    try {
+        const u = new URL(url);
+        const segs = u.pathname.split('/').filter((s) => s.length > 0);
+        const last = segs[segs.length - 1] ?? 'external-skill';
+        return last
+            .toLowerCase()
+            .replace(/\.git$/, '')
+            .replace(/[^a-z0-9_-]+/g, '-')
+            .replace(/^-+|-+$/g, '') || 'external-skill';
+    }
+    catch {
+        return 'external-skill';
+    }
+}
+function browseMarketplace() {
+    process.stdout.write(`IKarmic Forge Skills Marketplace (catalog):\n  ${catalogUrl()}\n\n`);
+    process.stdout.write('Browse community skills there. To install one:\n');
+    process.stdout.write('  forge skill install <github-url>           # any GitHub repo with SKILL.md\n');
+    process.stdout.write('  forge skill install <name>                  # from the marketplace catalog\n');
+    process.stdout.write('  forge skill search <query>                  # find skills by keyword\n');
+    return 0;
+}
+//# sourceMappingURL=skill.js.map

package/dist/commands/skill.js.map

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

package/dist/commands/spec.d.ts

@@ -0,0 +1,13 @@
+/**
+ * `forge spec …` subcommand: list / show / cancel already-approved
+ * spec-driven-planning-mode output (`.forge/specs/<id>/`).
+ *
+ * Mirrors `commands/checkpoint.ts`'s soft-prefix shape: no AI provider
+ * required, exits 0/1/2. Generation itself happens via `--spec "<task>"`
+ * (one-shot) or `/spec <task>` (REPL): see `options.ts`'s header
+ * comment on `ParsedSpecCommand` for why "approve" isn't a subcommand
+ * here.
+ */
+import type { ParsedSpecCommand } from '../options.js';
+export declare function handleSpecCommand(cmd: ParsedSpecCommand, cwd: string): Promise<number>;
+//# sourceMappingURL=spec.d.ts.map

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

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

package/dist/commands/spec.js

@@ -0,0 +1,76 @@
+/**
+ * `forge spec …` subcommand: list / show / cancel already-approved
+ * spec-driven-planning-mode output (`.forge/specs/<id>/`).
+ *
+ * Mirrors `commands/checkpoint.ts`'s soft-prefix shape: no AI provider
+ * required, exits 0/1/2. Generation itself happens via `--spec "<task>"`
+ * (one-shot) or `/spec <task>` (REPL): see `options.ts`'s header
+ * comment on `ParsedSpecCommand` for why "approve" isn't a subcommand
+ * here.
+ */
+import process from 'node:process';
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { SpecStore } from '@ikarmic/forge-core';
+export async function handleSpecCommand(cmd, cwd) {
+    const store = new SpecStore(cwd);
+    if (cmd.list) {
+        return listSpecs(store);
+    }
+    if (cmd.show) {
+        return showSpec(store, cmd.show.id);
+    }
+    if (cmd.cancel) {
+        return cancelSpec(store, cmd.cancel.id, cmd.cancel.yes);
+    }
+    process.stderr.write('forge spec: expected one of list|show|cancel. Generate a new spec with `forge --spec "<task>"` or `/spec <task>` in the REPL.\n');
+    return 2;
+}
+async function listSpecs(store) {
+    const all = await store.list();
+    if (all.length === 0) {
+        process.stdout.write('(no approved specs found: generate one with `forge --spec "<task>"` or `/spec <task>` in the REPL)\n');
+        return 0;
+    }
+    process.stdout.write('id                                  task                            when\n');
+    process.stdout.write('────────────────────────────────────────────────────────────────────────\n');
+    for (const s of all) {
+        const id = s.id.length > 36 ? s.id.slice(0, 35) + '…' : s.id.padEnd(36);
+        const task = s.task.length > 30 ? s.task.slice(0, 29) + '…' : s.task.padEnd(30);
+        const when = s.approvedAt.replace('T', ' ').slice(0, 19);
+        process.stdout.write(`${id} ${task} ${when}\n`);
+    }
+    return 0;
+}
+async function showSpec(store, id) {
+    const summary = await store.get(id);
+    if (!summary) {
+        process.stderr.write(`forge spec: no spec with id "${id}"\n`);
+        return 2;
+    }
+    process.stdout.write(`Spec ${summary.id}\n`);
+    process.stdout.write(`  task:       ${summary.task}\n`);
+    process.stdout.write(`  approved:   ${summary.approvedAt}\n`);
+    process.stdout.write(`  dir:        ${summary.dir}\n\n`);
+    for (const file of ['requirements.md', 'design.md', 'tasks.md']) {
+        const content = await readFile(path.join(summary.dir, file), 'utf8');
+        process.stdout.write(`── ${file} ──\n${content}\n\n`);
+    }
+    return 0;
+}
+async function cancelSpec(store, id, yes) {
+    const summary = await store.get(id);
+    if (!summary) {
+        process.stderr.write(`forge spec: no spec with id "${id}"\n`);
+        return 2;
+    }
+    if (!yes) {
+        process.stderr.write(`About to permanently delete spec "${id}" (${summary.dir}).\n` +
+            'Re-run with --yes to confirm. Refusing to delete without an explicit flag.\n');
+        return 2;
+    }
+    const removed = await store.delete(id);
+    process.stdout.write(removed ? `deleted spec ${id}\n` : `forge spec: failed to delete "${id}"\n`);
+    return removed ? 0 : 1;
+}
+//# sourceMappingURL=spec.js.map

package/dist/commands/spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.js","sourceRoot":"","sources":["../../src/commands/spec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAIhD,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,GAAsB,EAAE,GAAW;IACzE,MAAM,KAAK,GAAG,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC;IAEjC,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;QACb,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IACD,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;QACb,OAAO,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACtC,CAAC;IACD,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QACf,OAAO,UAAU,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,iIAAiI,CAClI,CAAC;IACF,OAAO,CAAC,CAAC;AACX,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,KAAgB;IACvC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;IAC/B,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,sGAAsG,CACvG,CAAC;QACF,OAAO,CAAC,CAAC;IACX,CAAC;IACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,4EAA4E,CAAC,CAAC;IACnG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,4EAA4E,CAAC,CAAC;IACnG,KAAK,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC;QACpB,MAAM,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACxE,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAChF,MAAM,IAAI,GAAG,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACzD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,IAAI,IAAI,IAAI,IAAI,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,KAAgB,EAAE,EAAU;IAClD,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACpC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gCAAgC,EAAE,KAAK,CAAC,CAAC;QAC9D,OAAO,CAAC,CAAC;IACX,CAAC;IACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC;IAC7C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC;IACxD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,OAAO,CAAC,UAAU,IAAI,CAAC,CAAC;IAC9D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC;IACzD,KAAK,MAAM,IAAI,IAAI,CAAC,iBAAiB,EAAE,WAAW,EAAE,UAAU,CAAC,EAAE,CAAC;QAChE,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;QACrE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,IAAI,QAAQ,OAAO,MAAM,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,KAAgB,EAAE,EAAU,EAAE,GAAY;IAClE,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACpC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gCAAgC,EAAE,KAAK,CAAC,CAAC;QAC9D,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,qCAAqC,EAAE,MAAM,OAAO,CAAC,GAAG,MAAM;YAC5D,8EAA8E,CACjF,CAAC;QACF,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACvC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAC,CAAC,iCAAiC,EAAE,KAAK,CAAC,CAAC;IAClG,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACzB,CAAC"}

package/dist/commands/watch.d.ts

@@ -0,0 +1,15 @@
+/**
+ * `forge watch`: runs a filesystem watcher that dispatches FileChanged
+ * hook events independent of any active Agent.run(). Runs until
+ * SIGINT (Ctrl+C). No agent loop involved.
+ *
+ * Loads hooks config exactly the way toAgentConfig does elsewhere
+ * (loadHooksConfig -> new HooksBus). trustedProjectHooks is never set
+ * to true here, same as every other CLI call site: project-level
+ * FileChanged hooks stay blocked by default.
+ */
+import { type ModelConfig } from '@ikarmic/forge-core';
+export declare function handleWatchCommand(cwd: string, resolveModel?: () => ModelConfig, watchOptions?: {
+    aiComments?: boolean;
+}): Promise<number>;
+//# sourceMappingURL=watch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../src/commands/watch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,OAAO,EAUL,KAAK,WAAW,EACjB,MAAM,qBAAqB,CAAC;AAM7B,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,EACX,YAAY,CAAC,EAAE,MAAM,WAAW,EAChC,YAAY,GAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAO,GAC1C,OAAO,CAAC,MAAM,CAAC,CA4DjB"}