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

package/dist/commands/prune.js

@@ -0,0 +1,341 @@
+import { join } from 'node:path';
+import { ProjectLock } from '@lorepack/backend-local';
+import { count, LORE_DIRECTORY, LoreError, loadConfig, } from '@lorepack/core';
+import { applyRemoteRetentionPlan, planRemoteRetention, } from '@lorepack/deploy-cloudflare';
+import { openStateStore } from '../services/builds.js';
+import { createWranglerDeployAdapter, resolveCloudflareResourcesWithAdapter, } from '../services/cloudflare-target.js';
+import { readRemotePruneReceipt, remotePruneReceiptId, remotePruneReceiptPath, writeRemotePruneReceipt, } from '../services/remote-prune.js';
+import { applyRetention, DEFAULT_KEEP_PREVIOUS, planRetention, renderRetentionPlan, } from '../services/retention.js';
+export function pruneCommand(options = {}) {
+    return {
+        name: 'prune',
+        description: 'Remove old builds, keeping the active one and the previous five.',
+        flags: [
+            {
+                flags: '--keep <count>',
+                description: `previous builds to keep (default ${DEFAULT_KEEP_PREVIOUS})`,
+            },
+            { flags: '--target <target>', description: 'plan cleanup for a remote deployment target' },
+            { flags: '--resume <receipt-id>', description: 'continue an interrupted remote cleanup' },
+            { flags: '--yes', description: 'apply the plan instead of only printing it' },
+        ],
+        handler: async (_args, flags, context) => {
+            const targetName = typeof flags.target === 'string' && flags.target.trim() !== '' ? flags.target.trim() : null;
+            const resumeId = typeof flags.resume === 'string' && flags.resume.trim() !== '' ? flags.resume.trim() : null;
+            if (resumeId !== null && targetName === null) {
+                throw new LoreError('LORE_E_INVALID_ARGUMENT', 'Remote cleanup resume requires `--target cloudflare`.', {
+                    remediation: 'Run `lorepack prune --target cloudflare --yes --resume <receipt-id>`.',
+                    subject: resumeId,
+                });
+            }
+            if (targetName !== null) {
+                return await pruneRemote(targetName, flags.yes === true, flags.keep, context.options.cwd, options.cloudflareAdapter, resumeId);
+            }
+            const config = loadConfig({ cwd: context.options.cwd });
+            const loreDirectory = join(config.projectRoot, LORE_DIRECTORY);
+            const state = openStateStore(loreDirectory);
+            try {
+                const keep = parseKeep(flags.keep);
+                const plan = planRetention(loreDirectory, state.listBuilds(), state.current()?.buildId ?? null, keep);
+                // Deletion is never the default. A plan that prints and stops is recoverable; one
+                // that deletes because it was run is not.
+                if (flags.yes !== true) {
+                    // Only offer `--yes` when it would do something. Telling a user to re-run a
+                    // command that has nothing to remove is an instruction to no purpose.
+                    const next = plan.remove.length === 0 ? '' : '\n\nNothing was removed. Re-run with --yes to apply.';
+                    return {
+                        human: `${renderRetentionPlan(plan)}${next}`,
+                        json: { ...plan, applied: false },
+                    };
+                }
+                const lock = new ProjectLock(join(loreDirectory, 'lock'));
+                await lock.withLock(() => {
+                    for (const id of plan.remove)
+                        state.forgetBuild(id);
+                    applyRetention(loreDirectory, plan);
+                });
+                // "Removed." after "Nothing to remove." claimed a deletion that never happened.
+                const outcome = plan.remove.length === 0
+                    ? ''
+                    : `\n\nRemoved ${count(plan.remove.length, 'build')} and ${count(plan.objectsToRemove.length, 'object')}.`;
+                return {
+                    human: `${renderRetentionPlan(plan)}${outcome}`,
+                    json: { ...plan, applied: true },
+                };
+            }
+            finally {
+                state.close();
+            }
+        },
+    };
+}
+function parseKeep(raw) {
+    if (raw === undefined)
+        return DEFAULT_KEEP_PREVIOUS;
+    const value = Number(raw);
+    if (!Number.isInteger(value) || value < 0) {
+        throw new LoreError('LORE_E_INVALID_ARGUMENT', `--keep must be a whole number, got ${raw}.`, {
+            remediation: 'Pass a count, for example `--keep 10`.',
+        });
+    }
+    return value;
+}
+async function pruneRemote(targetName, apply, keepRaw, cwd, cloudflareAdapter, resumeId) {
+    if (targetName !== 'cloudflare') {
+        throw new LoreError('LORE_E_INVALID_ARGUMENT', `Unknown prune target ${targetName}.`, {
+            remediation: 'Use `cloudflare`. Additional remote prune targets are not implemented in v0.1.',
+            subject: targetName,
+        });
+    }
+    if (resumeId !== null && !apply) {
+        throw new LoreError('LORE_E_INVALID_ARGUMENT', 'Remote cleanup resume requires `--yes`.', {
+            remediation: 'Run `lorepack prune --target cloudflare --yes --resume <receipt-id>`.',
+            subject: resumeId,
+        });
+    }
+    const config = loadConfig({ cwd });
+    if (resumeId !== null) {
+        return await resumeRemotePrune(config.projectRoot, keepRaw, resumeId, cloudflareAdapter ?? createWranglerDeployAdapter());
+    }
+    const resolved = await resolveCloudflareResourcesWithAdapter(config.projectRoot, cloudflareAdapter ?? createWranglerDeployAdapter());
+    const keep = parseKeep(keepRaw);
+    if (!apply) {
+        const plan = await planRemoteRetention(resolved.catalogDb, resolved.receipt.project, keep);
+        return {
+            human: renderRemoteRetentionPlan(plan),
+            json: {
+                target: 'cloudflare',
+                applied: false,
+                ...plan,
+            },
+        };
+    }
+    const plan = await planRemoteRetention(resolved.catalogDb, resolved.receipt.project, keep);
+    if (plan.remove.length === 0) {
+        return {
+            human: `Nothing to remove remotely. ${count(plan.keep.length, 'build')} retained.`,
+            json: {
+                target: 'cloudflare',
+                applied: true,
+                ...zeroRemovalResult(plan),
+            },
+        };
+    }
+    const receipt = createRemotePruneReceipt(resolved.receipt.project, keep, plan);
+    return await applyRemotePruneWithReceipt(config.projectRoot, receipt, resolved.catalogDb, resolved.objects);
+}
+function renderRemoteRetentionPlan(plan) {
+    if (plan.remove.length === 0) {
+        return `Nothing to remove remotely. ${count(plan.keep.length, 'build')} retained.`;
+    }
+    const lines = [
+        `Cloudflare cleanup plan: removing ${count(plan.remove.length, 'remote build')}, keeping ${plan.keep.length}:`,
+        '',
+    ];
+    for (const buildId of plan.remove)
+        lines.push(`  - ${buildId}`);
+    lines.push('');
+    lines.push(`  ${count(plan.archiveKeysToRemove.length, 'build archive')}`);
+    lines.push(`  ${count(plan.objectKeysToRemove.length, 'unreferenced object')}`);
+    lines.push('');
+    lines.push('Nothing was removed. Re-run with --yes to apply.');
+    return lines.join('\n');
+}
+function renderRemoteRetentionApplyResult(result) {
+    if (result.remove.length === 0) {
+        return `Nothing to remove remotely. ${count(result.keep.length, 'build')} retained.`;
+    }
+    const lines = [
+        `Cloudflare cleanup applied: removed ${count(result.remove.length, 'remote build')}, kept ${result.keep.length}.`,
+        '',
+        `D1 rows removed: ${renderD1Counts(result)}`,
+        `R2 objects removed: ${count(result.r2.archiveKeysRemoved.length, 'build archive')} and ${count(result.r2.objectKeysRemoved.length, 'unreferenced object')}.`,
+    ];
+    if (result.d1.physicalTablesDropped.length > 0) {
+        lines.push(`Dropped ${count(result.d1.physicalTablesDropped.length, 'physical table')}.`);
+    }
+    return lines.join('\n');
+}
+async function resumeRemotePrune(projectRoot, keepRaw, resumeId, cloudflareAdapter) {
+    const receipt = readRemotePruneReceipt(projectRoot, resumeId);
+    if (keepRaw !== undefined) {
+        const keep = parseKeep(keepRaw);
+        if (keep !== receipt.keepPrevious) {
+            throw new LoreError('LORE_E_INVALID_ARGUMENT', `Receipt ${resumeId} was created with --keep ${receipt.keepPrevious}, not ${keep}.`, {
+                remediation: 'Resume with the original keep count, or start a fresh cleanup from the beginning.',
+                subject: resumeId,
+            });
+        }
+    }
+    if (receipt.state === 'applied') {
+        return {
+            human: renderRemoteRetentionApplyResult(resultFromReceipt(receipt)),
+            json: {
+                target: 'cloudflare',
+                receiptId: receipt.receiptId,
+                applied: true,
+                ...resultFromReceipt(receipt),
+            },
+        };
+    }
+    const resolved = await resolveCloudflareResourcesWithAdapter(projectRoot, cloudflareAdapter);
+    if (resolved.receipt.project !== receipt.project) {
+        throw new LoreError('LORE_E_TARGET_NOT_CONFIGURED', `Receipt ${resumeId} belongs to project ${receipt.project}, but the current Cloudflare target receipt points at ${resolved.receipt.project}.`, {
+            remediation: 'Restore the matching Cloudflare target receipt or restart cleanup against the current target.',
+            subject: resumeId,
+        });
+    }
+    return await applyRemotePruneWithReceipt(projectRoot, receipt, resolved.catalogDb, resolved.objects);
+}
+async function applyRemotePruneWithReceipt(projectRoot, receipt, catalogDb, objects) {
+    const applyingReceipt = {
+        ...receipt,
+        state: 'applying',
+    };
+    writeRemotePruneReceipt(projectRoot, applyingReceipt);
+    try {
+        const result = await applyRemoteRetentionPlan(catalogDb, objects, receipt.plan, resumeStateFromReceipt(receipt));
+        const finished = {
+            ...receipt,
+            state: 'applied',
+            completedSteps: ['plan', 'd1', 'archives', 'objects'],
+            d1: cloneD1Report(result.d1),
+            r2: cloneR2Report(result.r2),
+        };
+        writeRemotePruneReceipt(projectRoot, finished);
+        return {
+            human: `${renderRemoteRetentionApplyResult(result)}\nReceipt: ${remotePruneReceiptPath(projectRoot, finished.receiptId)}`,
+            json: {
+                target: 'cloudflare',
+                receiptId: finished.receiptId,
+                applied: true,
+                ...result,
+            },
+        };
+    }
+    catch (error) {
+        const failed = receiptForFailure(receipt, error);
+        writeRemotePruneReceipt(projectRoot, failed);
+        throw new LoreError('LORE_E_REMOTE_DEPLOY', `Cloudflare cleanup failed while removing ${count(receipt.plan.remove.length, 'remote build')}.`, {
+            remediation: `Completed cleanup work was recorded. Resume with \`lorepack prune --target cloudflare --yes --resume ${receipt.receiptId}\`.`,
+            details: { receiptId: receipt.receiptId },
+            cause: error,
+        });
+    }
+}
+function renderD1Counts(result) {
+    return [
+        `${count(result.d1.projectedBuildsRemoved, 'projected build')}`,
+        `${count(result.d1.buildManifestsRemoved, 'manifest')}`,
+        `${count(result.d1.buildWarningsRemoved, 'warning')}`,
+        `${count(result.d1.artifactsRemoved, 'artifact')}`,
+        `${count(result.d1.supersessionsRemoved, 'supersession')}`,
+        `${count(result.d1.nodesRemoved, 'node')}`,
+        `${count(result.d1.chunksRemoved, 'chunk')}`,
+        `${count(result.d1.ftsRowsRemoved, 'fts row')}`,
+        `${count(result.d1.projectedTablesRemoved, 'projected table')}`,
+        `${count(result.d1.projectedTableColumnsRemoved, 'projected table column')}`,
+    ].join(', ');
+}
+function createRemotePruneReceipt(project, keepPrevious, plan) {
+    return {
+        formatVersion: 1,
+        receiptId: remotePruneReceiptId(plan.activeBuildId ?? plan.keep[0] ?? plan.remove[0] ?? null),
+        target: 'cloudflare',
+        project,
+        keepPrevious,
+        createdAt: new Date().toISOString(),
+        state: 'planned',
+        completedSteps: ['plan'],
+        plan: clonePlanForReceipt(plan),
+        d1: cloneD1Report(zeroRemovalResult(plan).d1),
+        r2: cloneR2Report(zeroRemovalResult(plan).r2),
+    };
+}
+function zeroRemovalResult(plan) {
+    return {
+        ...plan,
+        d1: {
+            projectedBuildsRemoved: 0,
+            buildManifestsRemoved: 0,
+            buildWarningsRemoved: 0,
+            artifactsRemoved: 0,
+            supersessionsRemoved: 0,
+            nodesRemoved: 0,
+            chunksRemoved: 0,
+            ftsRowsRemoved: 0,
+            projectedTablesRemoved: 0,
+            projectedTableColumnsRemoved: 0,
+            physicalTablesDropped: [],
+        },
+        r2: {
+            archiveKeysRemoved: [],
+            objectKeysRemoved: [],
+        },
+    };
+}
+function resumeStateFromReceipt(receipt) {
+    return {
+        d1Completed: receipt.completedSteps.includes('d1'),
+        archivesCompleted: receipt.completedSteps.includes('archives'),
+        objectsCompleted: receipt.completedSteps.includes('objects'),
+        d1: receipt.d1,
+        archiveKeysRemoved: receipt.r2.archiveKeysRemoved,
+        objectKeysRemoved: receipt.r2.objectKeysRemoved,
+    };
+}
+function resultFromReceipt(receipt) {
+    return {
+        activeBuildId: receipt.plan.activeBuildId,
+        keep: [...receipt.plan.keep],
+        remove: [...receipt.plan.remove],
+        archiveKeysToRemove: [...receipt.plan.archiveKeysToRemove],
+        objectKeysToRemove: [...receipt.plan.objectKeysToRemove],
+        d1: cloneD1Report(receipt.d1),
+        r2: cloneR2Report(receipt.r2),
+    };
+}
+function receiptForFailure(receipt, error) {
+    return {
+        ...receipt,
+        state: 'failed',
+        completedSteps: completedStepsFromResumeState(error.progress),
+        d1: cloneD1Report(error.progress.d1),
+        r2: cloneR2Report({
+            archiveKeysRemoved: error.progress.archiveKeysRemoved,
+            objectKeysRemoved: error.progress.objectKeysRemoved,
+        }),
+    };
+}
+function completedStepsFromResumeState(state) {
+    const completed = ['plan'];
+    if (state.d1Completed)
+        completed.push('d1');
+    if (state.archivesCompleted)
+        completed.push('archives');
+    if (state.objectsCompleted)
+        completed.push('objects');
+    return completed;
+}
+function clonePlanForReceipt(plan) {
+    return {
+        activeBuildId: plan.activeBuildId,
+        keep: [...plan.keep],
+        remove: [...plan.remove],
+        archiveKeysToRemove: [...plan.archiveKeysToRemove],
+        objectKeysToRemove: [...plan.objectKeysToRemove],
+    };
+}
+function cloneD1Report(report) {
+    return {
+        ...report,
+        physicalTablesDropped: [...report.physicalTablesDropped],
+    };
+}
+function cloneR2Report(report) {
+    return {
+        archiveKeysRemoved: [...report.archiveKeysRemoved],
+        objectKeysRemoved: [...report.objectKeysRemoved],
+    };
+}
+//# sourceMappingURL=prune.js.map

package/dist/commands/prune.js.map

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

package/dist/commands/search.d.ts

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

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

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

package/dist/commands/search.js

@@ -0,0 +1,84 @@
+import { LoreError, loadConfig } from '@lorepack/core';
+import { renderSearch, runSearch } from '../services/search.js';
+import { readFreshness } from '../services/status.js';
+export function searchCommand() {
+    return {
+        name: 'search',
+        description: 'Search the active build. Every result carries its source location.',
+        arguments: [{ name: 'query', description: 'what to look for' }],
+        flags: [
+            { flags: '--limit <count>', description: 'results to return (default 10)' },
+            { flags: '--path <glob>', description: 'restrict to paths matching a glob' },
+            { flags: '--type <extension>', description: 'restrict to one file extension' },
+            {
+                flags: '--source <artifact>',
+                description: 'restrict to one document, by path or artifact id',
+            },
+            {
+                flags: '--include-archived',
+                description: 'include archived and superseded sources, which are labelled',
+            },
+            { flags: '--debug', description: 'show why each result ranked where it did' },
+        ],
+        handler: async (args, flags, context) => {
+            const config = loadConfig({ cwd: context.options.cwd });
+            const query = args[0] ?? '';
+            // Freshness travels with the answer (section 4.10): a result from a stale build is
+            // still a result, but the reader has to be told which build it came from. It is an
+            // annotation, never a precondition, so failing to establish it degrades the label
+            // rather than the query. See `readFreshness`.
+            const freshness = await readFreshness({ config });
+            const result = await runSearch({
+                config,
+                query,
+                sourceState: freshness.sourceState,
+                limit: parseLimit(flags.limit),
+                includeArchived: flags.includeArchived === true,
+                debug: flags.debug === true,
+                ...(typeof flags.path === 'string' ? { pathGlob: filter('--path', flags.path) } : {}),
+                ...(typeof flags.type === 'string' ? { type: filter('--type', flags.type) } : {}),
+                ...(typeof flags.source === 'string'
+                    ? { artifactId: filter('--source', flags.source) }
+                    : {}),
+            });
+            // On stderr, so `--json` stdout stays the structured result alone. A consumer reading
+            // JSON sees `sourceState: "unknown"`, which is what the contract's third state means.
+            if (freshness.reason !== null) {
+                context.warn(`Freshness unknown: ${freshness.reason}\n`);
+            }
+            return {
+                human: renderSearch(result, query, context.options.verbose || flags.debug === true),
+                json: result,
+            };
+        },
+    };
+}
+/**
+ * A filter has to filter something.
+ *
+ * An empty value is what an unset shell variable expands to, and passing it through returns
+ * "no matches" for a query that would otherwise have answered. That is a wrong answer
+ * wearing the clothes of a right one, which is worse than an error. The protocol surfaces
+ * already refuse it (`artifactId` is `min(1)`), so refusing here also makes the CLI and the
+ * API agree.
+ */
+function filter(flag, value) {
+    if (value.trim() !== '')
+        return value;
+    throw new LoreError('LORE_E_INVALID_ARGUMENT', `${flag} was given an empty value.`, {
+        remediation: `Pass something for ${flag}, or leave the flag off to search everything.`,
+        subject: flag,
+    });
+}
+function parseLimit(raw) {
+    if (raw === undefined)
+        return 10;
+    const value = Number(raw);
+    if (!Number.isInteger(value) || value < 1 || value > 100) {
+        throw new LoreError('LORE_E_INVALID_ARGUMENT', `--limit must be between 1 and 100, got ${raw}.`, {
+            remediation: 'Pass a whole number, for example `--limit 20`.',
+        });
+    }
+    return value;
+}
+//# sourceMappingURL=search.js.map

package/dist/commands/search.js.map

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

package/dist/commands/serve.d.ts

@@ -0,0 +1,20 @@
+import type { CommandDefinition } from '../framework/program.js';
+import { SERVE_DEFAULTS } from '../services/serving.js';
+/**
+ * `lorepack serve`: the read-only server for whatever build is active.
+ *
+ * It does not watch, fingerprint on a timer, or build. That is `lorepack dev`'s job, and keeping
+ * them apart is what makes this one safe to leave running: a server that rebuilds on its own
+ * is a server that can change what a client sees mid-conversation for reasons the client
+ * cannot see.
+ *
+ * What it does do is re-read the active pointer on every request, so `lorepack build` or
+ * `lorepack rollback` in another terminal is picked up at the next request with no restart
+ * (architecture 15.2).
+ *
+ * The serving itself lives in `services/serving.ts`, because `lorepack dev` serves the same way
+ * and a second implementation would be a second port policy and a second way to drain.
+ */
+export declare function serveCommand(): CommandDefinition;
+export { SERVE_DEFAULTS };
+//# sourceMappingURL=serve.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../src/commands/serve.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAiB,MAAM,yBAAyB,CAAC;AAEhF,OAAO,EAGL,cAAc,EAGf,MAAM,wBAAwB,CAAC;AAEhC;;;;;;;;;;;;;;GAcG;AAEH,wBAAgB,YAAY,IAAI,iBAAiB,CAmDhD;AAED,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/commands/serve.js

@@ -0,0 +1,66 @@
+import { loadConfig } from '@lorepack/core';
+import { DEFAULT_REVALIDATE_INTERVAL_MS } from '../services/revalidate.js';
+import { parseInterval, parsePort, SERVE_DEFAULTS, startServing, untilInterrupted, } from '../services/serving.js';
+/**
+ * `lorepack serve`: the read-only server for whatever build is active.
+ *
+ * It does not watch, fingerprint on a timer, or build. That is `lorepack dev`'s job, and keeping
+ * them apart is what makes this one safe to leave running: a server that rebuilds on its own
+ * is a server that can change what a client sees mid-conversation for reasons the client
+ * cannot see.
+ *
+ * What it does do is re-read the active pointer on every request, so `lorepack build` or
+ * `lorepack rollback` in another terminal is picked up at the next request with no restart
+ * (architecture 15.2).
+ *
+ * The serving itself lives in `services/serving.ts`, because `lorepack dev` serves the same way
+ * and a second implementation would be a second port policy and a second way to drain.
+ */
+export function serveCommand() {
+    return {
+        name: 'serve',
+        description: 'Serve the active build over HTTP and MCP. Read-only, and never rebuilds.',
+        flags: [
+            {
+                flags: '--port <number>',
+                description: `port to listen on (default ${SERVE_DEFAULTS.port})`,
+            },
+            { flags: '--host <address>', description: 'address to bind (default 127.0.0.1)' },
+            {
+                flags: '--revalidate-interval <ms>',
+                description: 'how often to recheck the sources (default 5000, 0 every request)',
+            },
+        ],
+        handler: async (_args, flags, context) => {
+            const config = loadConfig({ cwd: context.options.cwd });
+            const host = typeof flags.host === 'string' ? flags.host : '127.0.0.1';
+            const server = await startServing({
+                config,
+                host,
+                port: parsePort(flags.port),
+                warn: context.warn,
+                // Rechecked on an interval with a cheap metadata prescreen inside it, so a server
+                // left running all day stays honest without hashing the corpus per request (#112).
+                revalidateIntervalMs: flags.revalidateInterval === undefined
+                    ? DEFAULT_REVALIDATE_INTERVAL_MS
+                    : parseInterval(flags.revalidateInterval),
+            });
+            context.write([
+                `Serving ${config.config.name} from build ${server.buildId.slice(0, 17)}`,
+                '',
+                `  REST  ${server.url}/v1`,
+                `  MCP   ${server.url}/mcp`,
+                `  Health ${server.url}/health`,
+                '',
+                'Read-only. `lorepack build` in another terminal is picked up on the next request.',
+                'Press Ctrl-C to stop.',
+                '',
+            ].join('\n'));
+            await untilInterrupted(context.warn);
+            await server.close();
+            return { human: '', json: undefined };
+        },
+    };
+}
+export { SERVE_DEFAULTS };
+//# sourceMappingURL=serve.js.map

package/dist/commands/serve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.js","sourceRoot":"","sources":["../../src/commands/serve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C,OAAO,EAAE,8BAA8B,EAAE,MAAM,2BAA2B,CAAC;AAC3E,OAAO,EACL,aAAa,EACb,SAAS,EACT,cAAc,EACd,YAAY,EACZ,gBAAgB,GACjB,MAAM,wBAAwB,CAAC;AAEhC;;;;;;;;;;;;;;GAcG;AAEH,MAAM,UAAU,YAAY;IAC1B,OAAO;QACL,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,0EAA0E;QACvF,KAAK,EAAE;YACL;gBACE,KAAK,EAAE,iBAAiB;gBACxB,WAAW,EAAE,8BAA8B,cAAc,CAAC,IAAI,GAAG;aAClE;YACD,EAAE,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,qCAAqC,EAAE;YACjF;gBACE,KAAK,EAAE,4BAA4B;gBACnC,WAAW,EAAE,kEAAkE;aAChF;SACF;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,IAAI,GAAG,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC;YAEvE,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC;gBAChC,MAAM;gBACN,IAAI;gBACJ,IAAI,EAAE,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC;gBAC3B,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,kFAAkF;gBAClF,mFAAmF;gBACnF,oBAAoB,EAClB,KAAK,CAAC,kBAAkB,KAAK,SAAS;oBACpC,CAAC,CAAC,8BAA8B;oBAChC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,kBAAkB,CAAC;aAC9C,CAAC,CAAC;YAEH,OAAO,CAAC,KAAK,CACX;gBACE,WAAW,MAAM,CAAC,MAAM,CAAC,IAAI,eAAe,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE;gBACzE,EAAE;gBACF,WAAW,MAAM,CAAC,GAAG,KAAK;gBAC1B,WAAW,MAAM,CAAC,GAAG,MAAM;gBAC3B,YAAY,MAAM,CAAC,GAAG,SAAS;gBAC/B,EAAE;gBACF,mFAAmF;gBACnF,uBAAuB;gBACvB,EAAE;aACH,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;YAEF,MAAM,gBAAgB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACrC,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;YACrB,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QACxC,CAAC;KACF,CAAC;AACJ,CAAC;AAED,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/commands/status.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAiB,MAAM,yBAAyB,CAAC;AAGhF,wBAAgB,aAAa,IAAI,iBAAiB,CAwBjD"}

package/dist/commands/status.js

@@ -0,0 +1,27 @@
+import { loadConfig } from '@lorepack/core';
+import { readStatus, renderStatus } from '../services/status.js';
+export function statusCommand() {
+    return {
+        name: 'status',
+        description: 'Report whether the active build still matches the sources.',
+        flags: [
+            { flags: '--exit-code', description: 'exit 2 when sources are dirty, for scripting' },
+            { flags: '--allow-large-project', description: 'continue past the supported file count' },
+        ],
+        handler: async (_args, flags, context) => {
+            const config = loadConfig({ cwd: context.options.cwd });
+            const status = await readStatus({
+                config,
+                progress: context.progress,
+                allowLargeProject: flags.allowLargeProject === true,
+            });
+            return {
+                human: renderStatus(status, context.options.verbose),
+                json: status,
+                // Dirty is a normal state, not a failure, so the non-zero exit is opt-in.
+                ...(flags.exitCode === true && status.sourceState === 'dirty' ? { exitCode: 2 } : {}),
+            };
+        },
+    };
+}
+//# sourceMappingURL=status.js.map

package/dist/commands/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAEjE,MAAM,UAAU,aAAa;IAC3B,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,4DAA4D;QACzE,KAAK,EAAE;YACL,EAAE,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,8CAA8C,EAAE;YACrF,EAAE,KAAK,EAAE,uBAAuB,EAAE,WAAW,EAAE,wCAAwC,EAAE;SAC1F;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,MAAM,GAAG,MAAM,UAAU,CAAC;gBAC9B,MAAM;gBACN,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,iBAAiB,EAAE,KAAK,CAAC,iBAAiB,KAAK,IAAI;aACpD,CAAC,CAAC;YAEH,OAAO;gBACL,KAAK,EAAE,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC;gBACpD,IAAI,EAAE,MAAM;gBACZ,0EAA0E;gBAC1E,GAAG,CAAC,KAAK,CAAC,QAAQ,KAAK,IAAI,IAAI,MAAM,CAAC,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACtF,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}