@lorepack/cli 0.0.0-stage → 0.1.0-alpha.0

package/dist/commands/mcp.js

@@ -0,0 +1,219 @@
+import { createLocalRuntimeBackend } from '@lorepack/backend-local';
+import { count, LoreError, loadConfig, ProgressBus, ProgressRenderer, } from '@lorepack/core';
+import { createMcpServer } from '@lorepack/mcp';
+import { createRuntime } from '@lorepack/runtime';
+import { serveStdio } from '@modelcontextprotocol/server/stdio';
+import { runBuild } from '../services/build.js';
+import { createLocalComparer } from '../services/comparer.js';
+import { createRevalidator, DEFAULT_REVALIDATE_INTERVAL_MS } from '../services/revalidate.js';
+import { readFreshness, readStatus } from '../services/status.js';
+/**
+ * `lorepack mcp`: the stdio server a coding agent launches.
+ *
+ * The startup sequence is architecture 14.3, and its order is the whole point. Freshness is
+ * reconciled **before the first protocol byte**, so a client that launched against a dirty
+ * project never sees stale context and never has to ask. Once the protocol starts, stdout
+ * belongs to it: every diagnostic goes to stderr, and a stray `console.log` here would
+ * corrupt a frame and give the client a parse error with no explanation.
+ */
+export function mcpCommand() {
+    return {
+        name: 'mcp',
+        description: 'Serve the active build to an AI client over MCP on stdio.',
+        flags: [
+            {
+                flags: '--ensure-current',
+                description: 'rebuild first when the sources have changed (the default)',
+            },
+            { flags: '--allow-stale', description: 'serve the existing build even when sources changed' },
+            { flags: '--active-only', description: 'skip source checks entirely, for pinned or CI use' },
+            { flags: '--project <path>', description: 'the project to serve' },
+            {
+                flags: '--revalidate-interval <ms>',
+                description: 'how often to recheck the sources while serving (default 5000, 0 every request, off never)',
+            },
+        ],
+        handler: async (_args, flags, context) => {
+            const cwd = typeof flags.project === 'string' ? flags.project : context.options.cwd;
+            const config = loadConfig({ cwd });
+            const mode = resolveMode(flags);
+            const sourceState = await reconcile({ config, mode, warn: context.warn });
+            // Freshness while serving, not only at startup. An open connection is not a session
+            // (2026-07-28), so a process can run for an hour and would otherwise report the state
+            // it saw in its first second for all of it (#112).
+            const revalidator = createRevalidator({
+                config,
+                intervalMs: parseInterval(flags.revalidateInterval),
+                frozen: mode !== 'ensure-current',
+            });
+            const backend = createLocalRuntimeBackend({
+                projectRoot: config.projectRoot,
+                freshness: mode === 'ensure-current' ? () => revalidator.freshness() : async () => sourceState,
+            });
+            if ((await backend.provider.current()) === null) {
+                backend.close();
+                throw new LoreError('LORE_E_BUILD_NOT_FOUND', 'This project has no build to serve.', {
+                    remediation: 'Run `lorepack build` first, or start the server with --ensure-current.',
+                });
+            }
+            // A factory, not a single server, because the opening message decides the protocol
+            // era and `serveStdio` pins one instance from this factory for the connection.
+            //
+            // Hand-wiring a `StdioServerTransport` instead, which is the shape most examples
+            // show, skips that decision entirely: the connection stays in the 2025 era, and
+            // `server/discover` (a MUST in 2026-07-28) is answered with `Method not found` even
+            // though the handler is registered. That is #189, and it was invisible because the
+            // HTTP surface reaches the same decision through `createMcpHandler`.
+            const runtime = createRuntime(backend);
+            const comparer = createLocalComparer(config.projectRoot);
+            const factory = () => createMcpServer({ runtime, comparer });
+            // The lock and the databases have to be released however the process ends, including
+            // on a signal. A client that kills the server should not leave a project locked.
+            //
+            // Idempotent, because every one of these paths can fire: a clean shutdown closes
+            // explicitly and `exit` fires afterwards. A second close used to reach a closed
+            // database and end the process with a stack trace, on the way out of a session that
+            // had worked perfectly.
+            let closed = false;
+            const close = () => {
+                if (closed)
+                    return;
+                closed = true;
+                backend.close();
+            };
+            process.once('SIGINT', close);
+            process.once('SIGTERM', close);
+            process.once('exit', close);
+            context.warn(`Serving ${config.config.name} over MCP on stdio. Sources are ${sourceState}.\n`);
+            const handle = serveStdio(factory, {
+                onerror: (error) => context.warn(`${error.message}\n`),
+            });
+            // Resolves when the client goes away.
+            //
+            // Standard input ending is the ordinary route: a client exits, or the pipe closes.
+            // It has to be handled explicitly, because without it the await never settles, Node
+            // notices an empty event loop with a pending top-level await, and prints a warning
+            // into the agent's log that looks like a defect in Lorepack (#183).
+            //
+            // `serveStdio` owns the transport and overwrites its `onclose`, so this is the one
+            // observation point left, which is fine: it is the route a real client takes.
+            await new Promise((resolve) => {
+                let done = false;
+                const finish = () => {
+                    if (done)
+                        return;
+                    done = true;
+                    resolve();
+                };
+                process.stdin.once('end', finish);
+                process.stdin.once('close', finish);
+            });
+            await handle.close();
+            close();
+            // Nothing structured on stdout: it carried protocol, and it is now finished.
+            return { human: '', json: undefined };
+        },
+    };
+}
+/**
+ * How often to recheck while serving. `off` is the startup-only behaviour, kept because a
+ * pinned deployment may want it, and named rather than implied.
+ */
+function parseInterval(raw) {
+    if (raw === undefined)
+        return DEFAULT_REVALIDATE_INTERVAL_MS;
+    if (raw === 'off')
+        return Number.POSITIVE_INFINITY;
+    // `Number('')` is 0, which here means "recheck every request", the most expensive setting
+    // there is. An unset shell variable must not be able to select it (#195).
+    const blank = typeof raw === 'string' && raw.trim() === '';
+    const value = blank ? Number.NaN : Number(raw);
+    if (!Number.isFinite(value) || value < 0) {
+        throw new LoreError('LORE_E_INVALID_ARGUMENT', `--revalidate-interval must be milliseconds, 0, or off, got ${raw}.`, { remediation: 'Pass a number of milliseconds, 0 to check every request, or off.' });
+    }
+    return value;
+}
+function resolveMode(flags) {
+    const stale = flags.allowStale === true;
+    const activeOnly = flags.activeOnly === true;
+    if (stale && activeOnly) {
+        throw new LoreError('LORE_E_INVALID_ARGUMENT', '--allow-stale and --active-only cannot both be given.', { remediation: 'Pick one: --allow-stale serves a dirty project, --active-only ignores it.' });
+    }
+    if (activeOnly)
+        return 'active-only';
+    if (stale)
+        return 'allow-stale';
+    return 'ensure-current';
+}
+/**
+ * Reconciles the build with the sources, before any protocol output.
+ *
+ * The three modes are three different promises to the client:
+ *
+ * - `ensure-current` (the default) rebuilds a dirty project, so the first tool call reads
+ *   what is on disk now. A failed rebuild exits without serving: stale context delivered
+ *   confidently is worse than no context.
+ * - `allow-stale` serves what exists and labels every result `dirty`, which is honest and
+ *   is what a user asking for it wants.
+ * - `active-only` does not look at the sources at all, for a pinned build in CI or a
+ *   forensic read of an old one.
+ */
+async function reconcile(options) {
+    if (options.mode === 'active-only')
+        return 'unknown';
+    const started = Date.now();
+    const status = await readStatus({ config: options.config, allowLargeProject: true }).catch(() => null);
+    // No build at all is a different situation from a stale one, and only one of the three
+    // modes can do anything about it. `--ensure-current` means exactly this: make the served
+    // build match the sources, and there being none yet is the strongest form of not
+    // matching. The other two modes have nothing to serve and say so.
+    if (status?.sourceState === 'unbuilt') {
+        if (options.mode !== 'ensure-current') {
+            throw new LoreError('LORE_E_BUILD_NOT_FOUND', 'This project has no build to serve.', {
+                remediation: 'Run `lorepack build`, or start the server with --ensure-current.',
+            });
+        }
+        options.warn('No build yet. Building before serving.\n');
+        await rebuild(options);
+        return 'clean';
+    }
+    const freshness = await readFreshness({ config: options.config });
+    const elapsed = Date.now() - started;
+    if (elapsed > 250) {
+        // Architecture 4.10: a check a person can notice has to say what it is doing, and the
+        // only place it may say anything is stderr.
+        options.warn(`Checked sources in ${elapsed} ms.\n`);
+    }
+    if (freshness.sourceState !== 'dirty')
+        return freshness.sourceState;
+    if (options.mode === 'allow-stale') {
+        options.warn('Sources have changed since this build. Serving it anyway: every result is labelled dirty.\n');
+        return 'dirty';
+    }
+    options.warn(`Sources have changed: ${count((status?.artifacts.changed ?? 0) + (status?.artifacts.added ?? 0), 'source')}. Rebuilding before serving.\n`);
+    await rebuild(options);
+    return 'clean';
+}
+/**
+ * Builds, with progress on stderr and nothing at all on stdout.
+ *
+ * stdout is about to carry protocol frames, and a progress line in the middle of one is a
+ * parse error the client cannot explain to anyone (architecture 14.3).
+ */
+async function rebuild(options) {
+    const progress = new ProgressBus();
+    const renderer = new ProgressRenderer({ write: options.warn, isTty: false });
+    progress.subscribe((event) => renderer.handle(event));
+    try {
+        await runBuild({ config: options.config, progress, allowLargeProject: true });
+    }
+    catch (cause) {
+        // A failed build leaves the previous pointer where it was and serves nothing. Stale
+        // context delivered confidently is worse than an error a person can act on (6.9).
+        throw new LoreError('LORE_E_STALE_SOURCES', 'The project could not be built, so nothing was served.', {
+            remediation: 'Run `lorepack build` to see the failure, or start with --allow-stale to serve the existing build.',
+            cause,
+        });
+    }
+}
+//# sourceMappingURL=mcp.js.map

package/dist/commands/mcp.js.map

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

package/dist/commands/pack.d.ts

@@ -0,0 +1,9 @@
+import type { CommandDefinition } from '../framework/program.js';
+/**
+ * `lorepack pack` writes a `.lorepack` archive: a standard, inspectable ZIP.
+ *
+ * Nothing about it is clever, and that is the feature. Section 22.3 promises no lock-in,
+ * which only means something if a plain `unzip` can open the file without Lorepack.
+ */
+export declare function packCommand(): CommandDefinition;
+//# sourceMappingURL=pack.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pack.d.ts","sourceRoot":"","sources":["../../src/commands/pack.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAiB,MAAM,yBAAyB,CAAC;AAGhF;;;;;GAKG;AACH,wBAAgB,WAAW,IAAI,iBAAiB,CAyB/C"}

package/dist/commands/pack.js

@@ -0,0 +1,57 @@
+import { existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { verifyArchive } from '@lorepack/backend-local';
+import { count, LoreError, loadConfig } from '@lorepack/core';
+import { packBuild } from '../services/packing.js';
+/**
+ * `lorepack pack` writes a `.lorepack` archive: a standard, inspectable ZIP.
+ *
+ * Nothing about it is clever, and that is the feature. Section 22.3 promises no lock-in,
+ * which only means something if a plain `unzip` can open the file without Lorepack.
+ */
+export function packCommand() {
+    return {
+        name: 'pack',
+        description: 'Write a portable .lorepack archive of a build.',
+        arguments: [{ name: 'build', description: 'build id or prefix', required: false }],
+        flags: [
+            { flags: '--verify <file>', description: 'check an existing archive instead of writing one' },
+            { flags: '--out <file>', description: 'archive path to write' },
+        ],
+        handler: async (args, flags, context) => {
+            if (typeof flags.verify === 'string')
+                return verify(flags.verify, context.options.cwd);
+            const config = loadConfig({ cwd: context.options.cwd });
+            const result = await packBuild(config, {
+                build: args[0],
+                out: typeof flags.out === 'string' ? flags.out : undefined,
+                relativeTo: context.options.cwd,
+            });
+            return {
+                human: `Wrote ${result.archive}\n  ${count(result.members, 'member')}, including the checksum index.`,
+                json: { ...result },
+            };
+        },
+    };
+}
+async function verify(file, cwd) {
+    const path = resolve(cwd, file);
+    if (!existsSync(path)) {
+        throw new LoreError('LORE_E_INVALID_ARGUMENT', `${file} does not exist.`, {
+            remediation: 'Pass the path to a .lorepack archive.',
+        });
+    }
+    const result = await verifyArchive(path);
+    if (result.ok) {
+        return {
+            human: `${path} is intact. ${count(result.memberCount, 'member')} verified.`,
+            json: { archive: path, ...result },
+        };
+    }
+    const first = result.failures[0];
+    throw new LoreError('LORE_E_OBJECT_CORRUPT', `${path} failed verification: ${first?.member} is ${first?.reason}.`, {
+        remediation: 'Download or pack the archive again. Its contents cannot be trusted.',
+        details: { failures: result.failures },
+    });
+}
+//# sourceMappingURL=pack.js.map

package/dist/commands/pack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack.js","sourceRoot":"","sources":["../../src/commands/pack.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE9D,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnD;;;;;GAKG;AACH,MAAM,UAAU,WAAW;IACzB,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,gDAAgD;QAC7D,SAAS,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;QAClF,KAAK,EAAE;YACL,EAAE,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,kDAAkD,EAAE;YAC7F,EAAE,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,uBAAuB,EAAE;SAChE;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAA0B,EAAE;YAC9D,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ;gBAAE,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAEvF,MAAM,MAAM,GAAG,UAAU,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;YACxD,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE;gBACrC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;gBACd,GAAG,EAAE,OAAO,KAAK,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS;gBAC1D,UAAU,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG;aAChC,CAAC,CAAC;YAEH,OAAO;gBACL,KAAK,EAAE,SAAS,MAAM,CAAC,OAAO,OAAO,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,iCAAiC;gBACrG,IAAI,EAAE,EAAE,GAAG,MAAM,EAAE;aACpB,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,MAAM,CAAC,IAAY,EAAE,GAAW;IAC7C,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAChC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,SAAS,CAAC,yBAAyB,EAAE,GAAG,IAAI,kBAAkB,EAAE;YACxE,WAAW,EAAE,uCAAuC;SACrD,CAAC,CAAC;IACL,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;IACzC,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;QACd,OAAO;YACL,KAAK,EAAE,GAAG,IAAI,eAAe,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE,QAAQ,CAAC,YAAY;YAC5E,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE;SACnC,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IACjC,MAAM,IAAI,SAAS,CACjB,uBAAuB,EACvB,GAAG,IAAI,yBAAyB,KAAK,EAAE,MAAM,OAAO,KAAK,EAAE,MAAM,GAAG,EACpE;QACE,WAAW,EAAE,qEAAqE;QAClF,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE;KACvC,CACF,CAAC;AACJ,CAAC"}

package/dist/commands/plan.d.ts

@@ -0,0 +1,3 @@
+import type { CommandDefinition } from '../framework/program.js';
+export declare function planCommand(): CommandDefinition;
+//# sourceMappingURL=plan.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/commands/plan.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAiB,MAAM,yBAAyB,CAAC;AAIhF,wBAAgB,WAAW,IAAI,iBAAiB,CA2C/C"}

package/dist/commands/plan.js

@@ -0,0 +1,44 @@
+import { createPlan, readLockfile, renderPlan } from '@lorepack/compiler';
+import { loadConfig } from '@lorepack/core';
+import { readPreviousBuild } from '../services/project.js';
+import { lockInputs } from '../services/versions.js';
+export function planCommand() {
+    return {
+        name: 'plan',
+        description: 'Preview what a build would change. Makes no changes itself.',
+        flags: [
+            { flags: '--allow-large-project', description: 'continue past the supported file count' },
+            { flags: '--exit-code', description: 'exit 2 when there are changes, for CI gating' },
+        ],
+        handler: async (_args, flags, context) => {
+            const config = loadConfig({ cwd: context.options.cwd });
+            const { state, previous } = readPreviousBuild(config);
+            try {
+                const { plan } = await createPlan({
+                    config,
+                    previous,
+                    previousLock: readLockfile(config.projectRoot),
+                    lockInputs: lockInputs(),
+                    progress: context.progress,
+                    allowLargeProject: flags.allowLargeProject === true,
+                });
+                const hasChanges = plan.artifacts.added + plan.artifacts.changed + plan.artifacts.removed > 0 ||
+                    plan.lock.changed ||
+                    plan.rules.length > 0 ||
+                    plan.tables.length > 0 ||
+                    plan.warnings.some((warning) => ['configuration-change-unknown', 'table-change-unknown'].includes(warning.code));
+                return {
+                    human: renderPlan(plan),
+                    json: plan,
+                    // Exit 0 by default whether or not there are changes: a plan reporting work is
+                    // a normal outcome, not a failure. CI opts into the gate explicitly.
+                    ...(flags.exitCode === true && hasChanges ? { exitCode: 2 } : {}),
+                };
+            }
+            finally {
+                state?.close();
+            }
+        },
+    };
+}
+//# sourceMappingURL=plan.js.map

package/dist/commands/plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../src/commands/plan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD,MAAM,UAAU,WAAW;IACzB,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,6DAA6D;QAC1E,KAAK,EAAE;YACL,EAAE,KAAK,EAAE,uBAAuB,EAAE,WAAW,EAAE,wCAAwC,EAAE;YACzF,EAAE,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,8CAA8C,EAAE;SACtF;QACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAA0B,EAAE;YAC/D,MAAM,MAAM,GAAG,UAAU,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;YACxD,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;YAEtD,IAAI,CAAC;gBACH,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,UAAU,CAAC;oBAChC,MAAM;oBACN,QAAQ;oBACR,YAAY,EAAE,YAAY,CAAC,MAAM,CAAC,WAAW,CAAC;oBAC9C,UAAU,EAAE,UAAU,EAAE;oBACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ;oBAC1B,iBAAiB,EAAE,KAAK,CAAC,iBAAiB,KAAK,IAAI;iBACpD,CAAC,CAAC;gBAEH,MAAM,UAAU,GACd,IAAI,CAAC,SAAS,CAAC,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,GAAG,CAAC;oBAC1E,IAAI,CAAC,IAAI,CAAC,OAAO;oBACjB,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;oBACrB,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;oBACtB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAC7B,CAAC,8BAA8B,EAAE,sBAAsB,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAChF,CAAC;gBAEJ,OAAO;oBACL,KAAK,EAAE,UAAU,CAAC,IAAI,CAAC;oBACvB,IAAI,EAAE,IAAI;oBACV,+EAA+E;oBAC/E,qEAAqE;oBACrE,GAAG,CAAC,KAAK,CAAC,QAAQ,KAAK,IAAI,IAAI,UAAU,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAClE,CAAC;YACJ,CAAC;oBAAS,CAAC;gBACT,KAAK,EAAE,KAAK,EAAE,CAAC;YACjB,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/commands/prune.d.ts

@@ -0,0 +1,7 @@
+import type { CommandDefinition } from '../framework/program.js';
+import { type CloudflareResolverAdapter } from '../services/cloudflare-target.js';
+export interface PruneCommandOptions {
+    readonly cloudflareAdapter?: CloudflareResolverAdapter;
+}
+export declare function pruneCommand(options?: PruneCommandOptions): CommandDefinition;
+//# sourceMappingURL=prune.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prune.d.ts","sourceRoot":"","sources":["../../src/commands/prune.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,iBAAiB,EAAiB,MAAM,yBAAyB,CAAC;AAEhF,OAAO,EACL,KAAK,yBAAyB,EAG/B,MAAM,kCAAkC,CAAC;AAc1C,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,yBAAyB,CAAC;CACxD;AAED,wBAAgB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,iBAAiB,CAoFjF"}