ikarmic-forge 0.0.0-stage → 4.5.0

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,23 @@
+/**
+ * `forge spec …` subcommand: list / show / cancel / sync already-approved
+ * spec-driven-planning-mode output (`.forge/specs/<id>/`). `sync` is the one
+ * that needs a model: it re-reads the code and updates the documents.
+ *
+ * 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 interface SpecCommandDeps {
+    /** Runs a read-only spec-mode agent on `task` and returns its final text and end reason. */
+    runSpecAgent?: (task: string) => Promise<{
+        finalText: string;
+        reason: string;
+    }>;
+    /** Asks a yes/no question; defaults to a terminal prompt (no when stdin is not a TTY). */
+    confirm?: (question: string) => Promise<boolean>;
+}
+export declare function handleSpecCommand(cmd: ParsedSpecCommand, cwd: string, deps?: SpecCommandDeps): 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;;;;;;;;;;GAUG;AAmBH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvD,MAAM,WAAW,eAAe;IAC9B,4FAA4F;IAC5F,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChF,0FAA0F;IAC1F,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAClD;AAED,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,iBAAiB,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,eAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,CAmBxH"}

package/dist/commands/spec.js

@@ -0,0 +1,147 @@
+/**
+ * `forge spec …` subcommand: list / show / cancel / sync already-approved
+ * spec-driven-planning-mode output (`.forge/specs/<id>/`). `sync` is the one
+ * that needs a model: it re-reads the code and updates the documents.
+ *
+ * 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 { createInterface } from 'node:readline/promises';
+import { changeSize, convertToCheckboxes, keepDoneTasks, SpecStore, specDrift, splitSpecSections, syncSpecTask, } from '@ikarmic/forge-core';
+export async function handleSpecCommand(cmd, cwd, deps = {}) {
+    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);
+    }
+    if (cmd.sync) {
+        return syncSpec(store, cwd, cmd.sync.id, cmd.sync.yes, deps);
+    }
+    process.stderr.write('forge spec: expected one of list|show|cancel|sync. 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;
+}
+async function askInTerminal(question) {
+    if (!process.stdin.isTTY)
+        return false;
+    const rl = createInterface({ input: process.stdin, output: process.stderr });
+    try {
+        return /^y(es)?$/i.test((await rl.question(`${question} [y/N] `)).trim());
+    }
+    finally {
+        rl.close();
+    }
+}
+/** Re-read the code and bring the spec's documents up to date; the old ones go to history/. */
+async function syncSpec(store, cwd, id, yes, deps) {
+    const spec = await store.get(id);
+    const docs = spec ? await store.readDocs(id) : null;
+    if (!spec || !docs) {
+        process.stderr.write(`forge spec: no spec with id "${id}"\n`);
+        return 2;
+    }
+    if (!deps.runSpecAgent) {
+        process.stderr.write('forge spec sync: no model available\n');
+        return 2;
+    }
+    const confirm = deps.confirm ?? askInTerminal;
+    // Ask for --yes before spending on a model run whose result could not be written.
+    if (!yes && !deps.confirm && !process.stdin.isTTY) {
+        process.stderr.write('forge spec sync: not a terminal, so pass --yes to write the updated documents.\n');
+        return 2;
+    }
+    const drift = await specDrift(cwd, spec, docs);
+    process.stderr.write(`Spec ${id}: ${drift.changedFiles.length} file(s) changed since ${drift.since.slice(0, 10)}, ` +
+        `${drift.missingPaths.length} mentioned path(s) gone, ${drift.tasks.done}/${drift.tasks.total} tasks ticked.\n` +
+        'Re-reading the code (read-only)…\n');
+    const result = await deps.runSpecAgent(syncSpecTask(spec, docs, drift));
+    if (result.reason !== 'spec' && result.reason !== 'completed') {
+        process.stderr.write(`forge spec sync: the run ended (${result.reason}); nothing was changed.\n`);
+        return 1;
+    }
+    let next;
+    try {
+        next = splitSpecSections(result.finalText);
+    }
+    catch (err) {
+        process.stderr.write(`forge spec sync: ${err.message}; nothing was changed.\n`);
+        return 1;
+    }
+    next = { ...next, tasks: keepDoneTasks(docs.tasks, convertToCheckboxes(next.tasks)) };
+    let any = false;
+    for (const file of ['requirements', 'design', 'tasks']) {
+        const { added, removed } = changeSize(docs[file], next[file]);
+        if (added || removed)
+            any = true;
+        process.stdout.write(`  ${file}.md: ${added || removed ? `+${added} -${removed} lines` : 'unchanged'}\n`);
+    }
+    if (!any) {
+        process.stdout.write(`spec ${id} already matches the code\n`);
+        return 0;
+    }
+    if (!yes && !(await confirm(`Write the updated documents to ${spec.dir}?`))) {
+        process.stdout.write('not written\n');
+        return 1;
+    }
+    const updated = await store.update(id, next);
+    process.stdout.write(`updated spec ${id} (previous version in ${path.join(updated.dir, 'history')})\n`);
+    return 0;
+}
+//# 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":"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"}

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"}

package/dist/commands/watch.js

@@ -0,0 +1,83 @@
+/**
+ * `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 process from 'node:process';
+import { createAiCommentHandler } from './ai-comments.js';
+import { Agent, createAgentHookRunner, FileChangeCoalescer, HooksBus, loadHooksConfig, watchFilesystem, } from '@ikarmic/forge-core';
+function hasAgentHooks(config) {
+    return Object.values(config).some((entries) => entries?.some((e) => e.hooks.some((h) => h.type === 'agent')));
+}
+export async function handleWatchCommand(cwd, resolveModel, watchOptions = {}) {
+    const { config, sources, warnings } = await loadHooksConfig(cwd);
+    for (const warning of warnings) {
+        process.stderr.write(`forge watch: warning: ${warning}\n`);
+    }
+    if (sources.length === 0) {
+        process.stdout.write('(no hooks configured: neither ~/.forge/settings.json nor .forge/settings.json exists; watching anyway, but nothing will run)\n');
+    }
+    // `type: 'agent'` hooks need a model. Resolve it only when one is configured, so a
+    // shell-only watch keeps working with no API key.
+    let agentRunner;
+    if (hasAgentHooks(config)) {
+        try {
+            if (!resolveModel)
+                throw new Error('no model resolver');
+            agentRunner = createAgentHookRunner({ model: resolveModel(), cwd });
+        }
+        catch (err) {
+            process.stderr.write(`forge watch: agent hooks disabled: ${err.message}
+`);
+        }
+    }
+    const bus = new HooksBus(config, agentRunner ? { agentRunner } : {});
+    const coalescer = new FileChangeCoalescer((relPath, changeType) => {
+        void dispatchAndReport(bus, cwd, relPath, changeType);
+    });
+    const onAiComments = watchOptions.aiComments
+        ? createAiCommentHandler({
+            cwd,
+            run: async (task, mode) => {
+                if (!resolveModel)
+                    throw new Error('no model configured');
+                const agent = new Agent({
+                    model: resolveModel(),
+                    cwd,
+                    auto: true,
+                    ...(mode === 'question' ? { planMode: true } : {}),
+                });
+                return (await agent.run({ task })).finalText;
+            },
+        })
+        : null;
+    const watcherHandle = watchFilesystem(cwd, (relPath, changeType) => {
+        coalescer.notify(relPath, changeType);
+        if (onAiComments && changeType !== 'deleted')
+            void onAiComments(relPath);
+    });
+    process.stdout.write(`forge watch: watching ${cwd}${watchOptions.aiComments ? ' for AI!/AI? comments' : ''} (Ctrl+C to stop)\n`);
+    return new Promise((resolve) => {
+        const shutdown = () => {
+            coalescer.dispose();
+            void watcherHandle.close().then(() => {
+                process.stdout.write('\nforge watch: stopped\n');
+                resolve(130);
+            });
+        };
+        process.on('SIGINT', shutdown);
+    });
+}
+async function dispatchAndReport(bus, cwd, relPath, changeType) {
+    const log = await bus.dispatch({ type: 'FileChanged', path: relPath, changeType, cwd });
+    const ranCount = log.results.length;
+    if (ranCount > 0) {
+        process.stdout.write(`[${changeType}] ${relPath} -> ${ranCount} hook${ranCount === 1 ? '' : 's'} run\n`);
+    }
+}
+//# sourceMappingURL=watch.js.map

package/dist/commands/watch.js.map

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

package/dist/commands/worktree.d.ts

@@ -0,0 +1,22 @@
+/**
+ * `forge worktree …` CLI subcommand. v2.11 + v2.14.
+ *
+ *   forge worktree list: show active worktrees
+ *   forge worktree cleanup [--with-branches|--no-branches] [-f]
+ *: remove all (confirms)
+ *   forge worktree cleanup --force: remove without confirm
+ *   forge worktree prune: orphan worktrees only
+ *   forge worktree sweep  [--force]: remove orphans + delete
+ *                                                         their auto-branches
+ *
+ * v2.14: cleanup now also deletes the auto-created branches by
+ * default (pass `--no-branches` to keep them). The new `sweep`
+ * subcommand is the one-shot "I'm done with this repo" cleanup:
+ * orphans get their branches deleted too.
+ *
+ * Mirrors the soft-prefix pattern of the other CLI subcommands:
+ * doesn't need an AI provider.
+ */
+import type { ParsedWorktreeCommand } from '../options.js';
+export declare function handleWorktreeCommand(cmd: ParsedWorktreeCommand, cwd: string): Promise<number>;
+//# sourceMappingURL=worktree.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"worktree.d.ts","sourceRoot":"","sources":["../../src/commands/worktree.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAMH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAE3D,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,qBAAqB,EAC1B,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,CAAC,CAmCjB"}