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

package/dist/commands/doctor.js

@@ -0,0 +1,96 @@
+import { count, loadConfig } from '@lorepack/core';
+import { DEV_PORT, isRunning, readReceipt } from '../services/dev-session.js';
+import { runDoctor } from '../services/doctor.js';
+/**
+ * `lorepack doctor`: when something is wrong, one command names it and says what to do.
+ *
+ * Architecture 6.5 and 6.9. Everything here is read-only, so it is safe to run at any time,
+ * including against a project that is mid-build, and it works in a directory that is not a
+ * project at all: reporting the environment is useful before there is anything to configure.
+ *
+ * The checks themselves live in `services/doctor.ts` because Phase 4's Studio Diagnostics
+ * route (#69) renders the same results over HTTP, and two implementations of "what is wrong
+ * with this environment" would be two answers to one question.
+ */
+export function doctorCommand() {
+    return {
+        name: 'doctor',
+        description: 'Check this environment and project, and say how to fix what is wrong.',
+        flags: [
+            {
+                flags: '--ci',
+                description: 'exit non-zero when any check fails, for use in a pipeline',
+            },
+            { flags: '--port <number>', description: 'the dev port to test (default 43110)' },
+        ],
+        handler: async (_args, flags, context) => {
+            const port = flags.port === undefined ? undefined : Number(flags.port);
+            const report = await runDoctor({
+                cwd: context.options.cwd,
+                ...(port === undefined ? {} : { port }),
+                // A dev session of this project holding the port is not a problem to report, and
+                // running doctor while your own `lorepack dev` is up is the common case. Studio reaches
+                // the same conclusion from the other side, so the two never disagree.
+                portHeldByThisProject: heldByThisProject(context.options.cwd, port),
+            });
+            return {
+                human: render(report),
+                json: report,
+                // Without `--ci` a failed check is information, not a failed command: someone
+                // running doctor to read it has not done anything wrong. With it, the exit code is
+                // the whole point (architecture 18.8).
+                ...(flags.ci === true && report.status === 'fail' ? { exitCode: 1 } : {}),
+            };
+        },
+    };
+}
+/**
+ * Whether the port under test is held by this project's own live dev session.
+ *
+ * Read from the receipt, which is evidence rather than a lock, so the pid is checked: a
+ * receipt left behind by a crash names a process that is gone, and believing it would report
+ * a genuinely occupied port as fine.
+ */
+function heldByThisProject(cwd, port) {
+    try {
+        const config = loadConfig({ cwd });
+        const receipt = readReceipt(config);
+        if (receipt === null || !isRunning(receipt.pid))
+            return false;
+        return receipt.port === (port ?? DEV_PORT);
+    }
+    catch {
+        // No project, or one that will not load. Either way there is no session to credit, and
+        // doctor's whole job is to keep working in exactly those directories.
+        return false;
+    }
+}
+const MARK = { pass: 'ok', warn: 'warn', fail: 'FAIL' };
+function render(report) {
+    const lines = [];
+    lines.push(report.project === null
+        ? 'No project here. Checking the environment only.'
+        : `Project ${report.project}`);
+    lines.push('');
+    for (const check of report.checks) {
+        lines.push(`  ${MARK[check.status].padEnd(5)} ${check.title.padEnd(22)} ${check.detail}`);
+        if (check.remediation !== undefined) {
+            // Indented under the check it belongs to, and never truncated: the remediation is the
+            // reason the command exists.
+            for (const line of check.remediation.split('\n'))
+                lines.push(`        ${line}`);
+        }
+    }
+    lines.push('');
+    if (report.counts.fail > 0) {
+        lines.push(`${count(report.counts.fail, 'check')} failed. Fix the ones marked FAIL above.`);
+    }
+    else if (report.counts.warn > 0) {
+        lines.push(`Everything essential works. ${count(report.counts.warn, 'check')} worth knowing about.`);
+    }
+    else {
+        lines.push('Everything checks out.');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

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

package/dist/commands/export.d.ts

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

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

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

package/dist/commands/export.js

@@ -0,0 +1,126 @@
+import { existsSync } from 'node:fs';
+import { isAbsolute, resolve } from 'node:path';
+import { createLocalRuntimeBackend } from '@lorepack/backend-local';
+import { contextProfileSchema, LoreError, loadConfig, writeFileAtomic, } from '@lorepack/core';
+import { createRuntime } from '@lorepack/runtime';
+import { renderBundleMarkdown } from '../services/export.js';
+import { readFreshness } from '../services/status.js';
+/**
+ * `lorepack export`: one file a person can paste into any chat product.
+ *
+ * Architecture 14.6 calls this the universal compatibility bridge, and that is the honest
+ * framing: MCP is better, and most chat products cannot speak it. The output is bounded,
+ * cited, and explicit about what did not fit, because a context bundle that quietly
+ * dropped half the corpus is indistinguishable from one that had nothing else to give.
+ *
+ * Defaults to the `chat` profile and its 24,000 token budget, which is the profile sized
+ * for exactly this: one paste, one bounded file.
+ */
+const EXPORT_PROFILE = 'chat';
+export function exportCommand() {
+    return {
+        name: 'export',
+        description: 'Write a bounded, cited context bundle for a task. Markdown or JSON.',
+        flags: [
+            { flags: '--task <text>', description: 'what the context is for' },
+            { flags: '--profile <name>', description: 'agent, coding, chat or deep (default chat)' },
+            { flags: '--budget <tokens>', description: 'estimated token budget, overriding the profile' },
+            { flags: '--format <format>', description: 'markdown or json (default markdown)' },
+            { flags: '--output <file>', description: 'write to a file instead of stdout' },
+            { flags: '--force', description: 'overwrite an existing output file' },
+            {
+                flags: '--allow-unsupported-budget',
+                description: 'permit a budget outside the supported 4,000 to 40,000 range',
+            },
+        ],
+        handler: async (_args, flags, context) => {
+            const config = loadConfig({ cwd: context.options.cwd });
+            const task = typeof flags.task === 'string' ? flags.task.trim() : '';
+            if (task === '') {
+                throw new LoreError('LORE_E_INVALID_ARGUMENT', 'An export needs a task to select for.', {
+                    remediation: 'Pass --task "what you are trying to do".',
+                });
+            }
+            const format = parseFormat(flags.format);
+            const profile = parseProfile(flags.profile);
+            const output = typeof flags.output === 'string' ? absolute(flags.output, config) : null;
+            if (output !== null && existsSync(output) && flags.force !== true) {
+                throw new LoreError('LORE_E_INVALID_ARGUMENT', `${flags.output} already exists.`, {
+                    remediation: 'Pass --force to overwrite it, or choose another --output path.',
+                    subject: String(flags.output),
+                });
+            }
+            const freshness = await readFreshness({ config });
+            const backend = createLocalRuntimeBackend({
+                projectRoot: config.projectRoot,
+                freshness: async () => freshness.sourceState,
+            });
+            try {
+                if ((await backend.provider.current()) === null) {
+                    throw new LoreError('LORE_E_BUILD_NOT_FOUND', 'This project has no build to export.', {
+                        remediation: 'Run `lorepack build` first.',
+                    });
+                }
+                const bundle = await createRuntime(backend).contextForTask({
+                    task,
+                    profile,
+                    includeArchived: false,
+                    allowUnsupportedBudget: flags.allowUnsupportedBudget === true,
+                    ...(flags.budget === undefined ? {} : { budget: parseBudget(flags.budget) }),
+                });
+                const rendered = format === 'json'
+                    ? `${JSON.stringify(bundle, null, 2)}\n`
+                    : renderBundleMarkdown(bundle, {
+                        projectName: config.config.name,
+                        sourceState: bundle.sourceState,
+                        moreCommand: `lorepack export --task ${JSON.stringify(task)} --profile deep`,
+                    });
+                if (output === null) {
+                    // stdout carries the export and nothing else, so `lorepack export ... > file.md` and
+                    // `--output file.md` produce the same bytes.
+                    return { human: rendered.trimEnd(), json: bundle };
+                }
+                // Atomic, because a half-written context file that looks complete is worse than no
+                // file: a person would paste it without noticing.
+                writeFileAtomic(output, rendered);
+                context.warn(`Wrote ${output}\n  ${bundle.estimatedTokens} estimated tokens of ${bundle.budget}, ${bundle.citations.length} citations, ${bundle.omitted.length} omitted.\n`);
+                return { human: '', json: { ...bundle, output } };
+            }
+            finally {
+                backend.close();
+            }
+        },
+    };
+}
+function parseFormat(raw) {
+    if (raw === undefined)
+        return 'markdown';
+    if (raw === 'markdown' || raw === 'json')
+        return raw;
+    throw new LoreError('LORE_E_INVALID_ARGUMENT', `--format must be markdown or json, got ${raw}.`, {
+        remediation: 'Pass --format markdown for a file to paste, or --format json for a program.',
+    });
+}
+function parseProfile(raw) {
+    if (raw === undefined)
+        return EXPORT_PROFILE;
+    const parsed = contextProfileSchema.safeParse(raw);
+    if (parsed.success)
+        return parsed.data;
+    throw new LoreError('LORE_E_INVALID_ARGUMENT', `--profile must be one of agent, coding, chat, deep, got ${raw}.`, {
+        remediation: 'Omit it for `chat`, which is sized for one paste into a chat product.',
+    });
+}
+function parseBudget(raw) {
+    const value = Number(raw);
+    if (!Number.isInteger(value) || value < 1) {
+        throw new LoreError('LORE_E_INVALID_ARGUMENT', `--budget must be a whole number, got ${raw}.`, {
+            remediation: 'Pass an estimated token budget, for example --budget 24000.',
+        });
+    }
+    return value;
+}
+function absolute(path, config) {
+    return isAbsolute(path) ? path : resolve(config.projectRoot, path);
+}
+//# sourceMappingURL=export.js.map

package/dist/commands/export.js.map

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

package/dist/commands/index.d.ts

@@ -0,0 +1,8 @@
+import type { CommandDefinition } from '../framework/program.js';
+/**
+ * Commands are registered explicitly. No dynamic discovery: architecture section 4.8
+ * applies to the CLI as much as to adapters, and an explicit list is what makes
+ * `lorepack --help` reviewable in a pull request.
+ */
+export declare function registerCommands(): CommandDefinition[];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAqBjE;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,iBAAiB,EAAE,CAyBtD"}

package/dist/commands/index.js

@@ -0,0 +1,51 @@
+import { activateCommand, buildsCommand, rollbackCommand } from './activate.js';
+import { buildCommand } from './build.js';
+import { configCommand } from './config.js';
+import { connectCommand, disconnectCommand } from './connect.js';
+import { deployCommand } from './deploy.js';
+import { devCommand } from './dev.js';
+import { diffCommand } from './diff.js';
+import { doctorCommand } from './doctor.js';
+import { exportCommand } from './export.js';
+import { initCommand } from './init.js';
+import { inspectCommand } from './inspect.js';
+import { mcpCommand } from './mcp.js';
+import { packCommand } from './pack.js';
+import { planCommand } from './plan.js';
+import { pruneCommand } from './prune.js';
+import { searchCommand } from './search.js';
+import { serveCommand } from './serve.js';
+import { statusCommand } from './status.js';
+import { targetCommand } from './target.js';
+/**
+ * Commands are registered explicitly. No dynamic discovery: architecture section 4.8
+ * applies to the CLI as much as to adapters, and an explicit list is what makes
+ * `lorepack --help` reviewable in a pull request.
+ */
+export function registerCommands() {
+    return [
+        initCommand(),
+        planCommand(),
+        buildCommand(),
+        statusCommand(),
+        diffCommand(),
+        searchCommand(),
+        inspectCommand(),
+        packCommand(),
+        buildsCommand(),
+        activateCommand(),
+        rollbackCommand(),
+        pruneCommand(),
+        devCommand(),
+        deployCommand(),
+        targetCommand(),
+        connectCommand(),
+        disconnectCommand(),
+        doctorCommand(),
+        configCommand(),
+        mcpCommand(),
+        serveCommand(),
+        exportCommand(),
+    ];
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChF,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C;;;;GAIG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO;QACL,WAAW,EAAE;QACb,WAAW,EAAE;QACb,YAAY,EAAE;QACd,aAAa,EAAE;QACf,WAAW,EAAE;QACb,aAAa,EAAE;QACf,cAAc,EAAE;QAChB,WAAW,EAAE;QACb,aAAa,EAAE;QACf,eAAe,EAAE;QACjB,eAAe,EAAE;QACjB,YAAY,EAAE;QACd,UAAU,EAAE;QACZ,aAAa,EAAE;QACf,aAAa,EAAE;QACf,cAAc,EAAE;QAChB,iBAAiB,EAAE;QACnB,aAAa,EAAE;QACf,aAAa,EAAE;QACf,UAAU,EAAE;QACZ,YAAY,EAAE;QACd,aAAa,EAAE;KAChB,CAAC;AACJ,CAAC"}

package/dist/commands/init.d.ts

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

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

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

package/dist/commands/init.js

@@ -0,0 +1,95 @@
+import { isAbsolute, resolve } from 'node:path';
+import { CONFIG_FILENAME, count, LoreError } from '@lorepack/core';
+import { enclosingProject, planInit, runInit } from '../services/init.js';
+/**
+ * The verb the run earned, rather than the one the flag implies.
+ *
+ * `--force` rewrites files and used to announce "Created:" over a list marked `~`, and a
+ * run with nothing to do said "Created:" over the word "nothing" (#178). The markers were
+ * right both times; only the heading was making things up.
+ */
+function heading(result, dryRun) {
+    const created = result.creates.length > 0;
+    const rewritten = result.modifies.length > 0;
+    if (!created && !rewritten)
+        return dryRun ? 'Nothing to create.' : 'Nothing to do.';
+    if (created && rewritten)
+        return dryRun ? 'Would create and rewrite:' : 'Created and rewrote:';
+    if (created)
+        return dryRun ? 'Would create:' : 'Created:';
+    return dryRun ? 'Would rewrite:' : 'Rewrote:';
+}
+function renderHuman(result, dryRun) {
+    const lines = [];
+    if (result.alreadyInitialized && result.written.length === 0 && !dryRun) {
+        lines.push(`Already initialized: ${CONFIG_FILENAME} exists. Nothing was changed.`);
+        if (result.creates.length > 0) {
+            lines.push('');
+            lines.push('Created the missing files:');
+            for (const file of result.creates)
+                lines.push(`  + ${file}`);
+        }
+        if (result.forceWouldChange.length > 0) {
+            lines.push('');
+            lines.push(result.configDiffers
+                ? 'Your configuration differs from a freshly generated one. `--force` would overwrite:'
+                : '`--force` would rewrite:');
+            for (const file of result.forceWouldChange)
+                lines.push(`  ~ ${file}`);
+        }
+    }
+    else {
+        lines.push(heading(result, dryRun));
+        for (const file of result.creates)
+            lines.push(`  + ${file}`);
+        for (const file of result.modifies)
+            lines.push(`  ~ ${file}`);
+    }
+    if (result.secretShaped.length > 0) {
+        lines.push('');
+        lines.push(`Warning: ${count(result.secretShaped.length, 'file')} ${result.secretShaped.length === 1 ? 'looks' : 'look'} like credentials and will never be indexed:`);
+        for (const file of result.secretShaped.slice(0, 10))
+            lines.push(`  ${file}`);
+        if (result.secretShaped.length > 10) {
+            lines.push(`  and ${result.secretShaped.length - 10} more`);
+        }
+        lines.push('This is a guardrail on filenames, not a secret scanner.');
+    }
+    if (!dryRun && result.written.length > 0) {
+        lines.push('');
+        lines.push('Next: run `lorepack build` to create your first build.');
+    }
+    return lines.join('\n');
+}
+export function initCommand() {
+    return {
+        name: 'init',
+        description: 'Create a minimal Lorepack project in a directory.',
+        arguments: [{ name: 'path', description: 'project directory (default: .)', required: false }],
+        flags: [
+            { flags: '--force', description: 'overwrite existing Lorepack configuration' },
+            { flags: '--dry-run', description: 'show what would change without writing' },
+        ],
+        handler: (args, flags, context) => {
+            const directory = resolveDirectory(args[0], context);
+            const force = flags.force === true;
+            const dryRun = flags.dryRun === true;
+            const enclosing = enclosingProject(directory);
+            if (enclosing !== null && !force) {
+                throw new LoreError('LORE_E_INVALID_ARGUMENT', `${directory} is already inside a Lorepack project rooted at ${enclosing}.`, {
+                    remediation: 'Nested projects are not supported. Run `lorepack build` in the existing project, or pass --force if you really want a separate one.',
+                });
+            }
+            const result = dryRun
+                ? { ...planInit({ directory, force, dryRun: true }), written: [] }
+                : runInit({ directory, force });
+            return { human: renderHuman(result, dryRun), json: result };
+        },
+    };
+}
+function resolveDirectory(argument, context) {
+    if (argument === undefined)
+        return context.options.cwd;
+    return isAbsolute(argument) ? resolve(argument) : resolve(context.options.cwd, argument);
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

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

package/dist/commands/inspect.d.ts

@@ -0,0 +1,15 @@
+import type { CommandDefinition } from '../framework/program.js';
+export declare function inspectCommand(): CommandDefinition;
+/**
+ * The ordinal path a node id ends with, as numbers.
+ *
+ * `demo:docs/a.md#0.1.2` is `[0, 1, 2]`. Numbers rather than the string, because a
+ * lexicographic sort puts the tenth sibling before the second.
+ */
+export declare function ordinalPath(id: string): number[];
+/** A row from the `nodes` table, as `node:sqlite` hands it back. */
+type NodeRow = Record<string, string | number | null>;
+/** Document order: every node after its parent, siblings in the order they were written. */
+export declare function orderByTree(nodes: readonly NodeRow[]): NodeRow[];
+export {};
+//# sourceMappingURL=inspect.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.d.ts","sourceRoot":"","sources":["../../src/commands/inspect.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,iBAAiB,EAAiB,MAAM,yBAAyB,CAAC;AA2BhF,wBAAgB,cAAc,IAAI,iBAAiB,CA6DlD;AA8PD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,CAOhD;AAED,oEAAoE;AACpE,KAAK,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC,CAAC;AAEtD,4FAA4F;AAC5F,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,OAAO,EAAE,GAAG,OAAO,EAAE,CAUhE"}