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

package/dist/services/export.js

@@ -0,0 +1,129 @@
+import { count } from '@lorepack/core';
+export function renderBundleMarkdown(bundle, options) {
+    const lines = [];
+    lines.push(`# Context for: ${bundle.task}`, '');
+    lines.push(`Project **${options.projectName}**, build \`${bundle.buildId}\`.`);
+    lines.push(`Profile **${bundle.profile}**, budget ${count(bundle.budget, 'estimated token')}, of which ${count(bundle.estimatedTokens, 'estimated token')} used.`);
+    if (options.sourceState === 'dirty') {
+        lines.push('');
+        lines.push('> The sources have changed since this build was compiled, so this context is behind them. Run `lorepack build` and export again for current context.');
+    }
+    else if (options.sourceState === 'unknown') {
+        lines.push('');
+        lines.push('> Freshness could not be established, so this context may be behind the sources.');
+    }
+    lines.push('');
+    lines.push('Every passage below is quoted from a document in this project, with the file and source coordinate it came from. Lorepack selected and bounded them; it did not write or summarise anything, and it makes no claim about which document is correct.');
+    lines.push(`Search considered up to ${count(bundle.candidateLimit, 'candidate')} using ${bundle.candidateMatchMode}-term matching${bundle.candidateLimitHit ? ', and the candidate limit was reached' : ''}.`);
+    lines.push('');
+    const included = [...bundle.overview, ...bundle.selected];
+    if (included.length > 0) {
+        lines.push('## Context', '');
+        // Grouped by source, which is how a reader navigates it: one heading per document,
+        // passages in the order the assembler chose them.
+        for (const [path, items] of groupBySource(included)) {
+            lines.push(`### ${path}`, '');
+            for (const item of items) {
+                const heading = item.headingPath.length === 0 ? '' : `${item.headingPath.join(' > ')}, `;
+                const labels = item.labels.length === 0 ? '' : ` [${item.labels.join(', ')}]`;
+                lines.push(`**${heading}${lineRange(item.locator)}**${labels}`, '');
+                lines.push(item.text.trim(), '');
+            }
+        }
+    }
+    if (bundle.alternatives.length > 0) {
+        lines.push('## Alternative relevant sources', '');
+        lines.push('These matched the task and were held back by their declared status. They are listed, not judged.', '');
+        for (const item of bundle.alternatives) {
+            const labels = item.labels.length === 0 ? '' : ` [${item.labels.join(', ')}]`;
+            lines.push(`- \`${item.locator.relativePath}\` ${lineRange(item.locator)}${labels}`);
+        }
+        lines.push('');
+    }
+    if (bundle.tables.length > 0) {
+        lines.push('## Tables', '');
+        for (const table of bundle.tables)
+            lines.push(`- ${table.name} (\`${table.tableId}\`)`);
+        lines.push('');
+    }
+    lines.push('## Citations', '');
+    for (const citation of bundle.citations) {
+        lines.push(`- \`${citation.relativePath}\` ${lineRange(citation)}`);
+    }
+    lines.push('');
+    lines.push('## What was left out', '');
+    if (bundle.omitted.length === 0) {
+        lines.push('Nothing from the candidates considered was omitted.', '');
+    }
+    else {
+        lines.push(`${count(bundle.omitted.length, 'passage')} considered candidates did not fit, grouped by reason. The report covers the candidates considered above.`, '');
+        for (const [reason, items] of groupByReason(bundle.omitted)) {
+            lines.push(`**${describeReason(reason)}** (${count(items.length, 'passage')})`, '');
+            for (const item of items.slice(0, 20)) {
+                lines.push(`- \`${item.locator.relativePath}\` ${lineRange(item.locator)}, about ${count(item.estimatedTokens, 'token')}`);
+            }
+            if (items.length > 20)
+                lines.push(`- and ${count(items.length - 20, 'more passage')}`);
+            lines.push('');
+        }
+    }
+    lines.push('## Getting more', '');
+    lines.push('To widen this context, raise the budget or name a profile with a larger one:', '');
+    lines.push('```bash', options.moreCommand, '```', '');
+    lines.push(`Token counts are conservative estimates from a deterministic counter, not a model tokenizer. Treat them as a bound, not a measurement.`);
+    return `${lines.join('\n').trimEnd()}\n`;
+}
+function groupBySource(items) {
+    const groups = new Map();
+    for (const item of items) {
+        const path = item.locator.relativePath;
+        const bucket = groups.get(path);
+        if (bucket === undefined)
+            groups.set(path, [item]);
+        else
+            bucket.push(item);
+    }
+    return [...groups.entries()];
+}
+function groupByReason(items) {
+    const groups = new Map();
+    for (const item of items) {
+        const bucket = groups.get(item.reason);
+        if (bucket === undefined)
+            groups.set(item.reason, [item]);
+        else
+            bucket.push(item);
+    }
+    // Sorted so the same bundle always renders the same file, which is what lets a person
+    // diff two exports and see what changed rather than what moved.
+    return [...groups.entries()].sort(([left], [right]) => (left < right ? -1 : 1));
+}
+function describeReason(reason) {
+    switch (reason) {
+        case 'budget':
+            return 'Did not fit in the budget';
+        case 'duplicate':
+            return 'Near-duplicate of a passage above';
+        case 'diversity':
+            return 'One document may not fill the whole bundle';
+        case 'superseded':
+            return 'Superseded by another document';
+        case 'archived':
+            return 'Archived';
+        default:
+            return 'Filtered out';
+    }
+}
+function lineRange(locator) {
+    if (locator.page !== undefined)
+        return `page ${locator.page}`;
+    if (locator.sheet !== undefined || locator.cellRange !== undefined) {
+        return [locator.sheet, locator.cellRange].filter(Boolean).join(' ');
+    }
+    if (locator.lineStart === undefined)
+        return '';
+    return locator.lineEnd === undefined || locator.lineEnd === locator.lineStart
+        ? `line ${locator.lineStart}`
+        : `lines ${locator.lineStart}-${locator.lineEnd}`;
+}
+//# sourceMappingURL=export.js.map

package/dist/services/export.js.map

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

package/dist/services/init.d.ts

@@ -0,0 +1,46 @@
+export declare const GITIGNORE_FILENAME: '.gitignore';
+export interface InitPlan {
+    readonly projectRoot: string;
+    /** Project-relative POSIX paths this run would create or modify. */
+    readonly creates: readonly string[];
+    readonly modifies: readonly string[];
+    readonly unchanged: readonly string[];
+    readonly projectName: string;
+    readonly sources: readonly string[];
+    readonly secretShaped: readonly string[];
+    readonly alreadyInitialized: boolean;
+    /**
+     * What `--force` would rewrite. Reporting "already initialized" without this leaves the
+     * user to guess what the escape hatch does, which is exactly when they reach for it.
+     */
+    readonly forceWouldChange: readonly string[];
+    /** True when the existing config differs from what this run would generate. */
+    readonly configDiffers: boolean;
+}
+export interface InitResult extends InitPlan {
+    readonly written: readonly string[];
+}
+export interface InitOptions {
+    readonly directory: string;
+    readonly force?: boolean;
+    /** Reports what would change without touching the filesystem. */
+    readonly dryRun?: boolean;
+}
+/** Slugified directory name. Collisions are not this tool's problem in v0.1. */
+export declare function projectNameFrom(directory: string): string;
+export declare function renderConfig(name: string, sources: readonly string[]): string;
+export declare function renderIgnore(): string;
+/**
+ * Files whose names suggest credentials. Architecture section 19.2 is explicit that this
+ * is a guardrail rather than a secret scanner, so contents are never read.
+ */
+export declare function findSecretShaped(root: string, limit?: number): string[];
+export declare function planInit(options: InitOptions): InitPlan;
+/**
+ * Writes the project files. Grouped so a failure leaves nothing half-created: content is
+ * prepared first, and only then written, each one atomically.
+ */
+export declare function runInit(options: InitOptions): InitResult;
+/** Guards against initializing inside an existing project by accident. */
+export declare function enclosingProject(directory: string): string | null;
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/services/init.ts"],"names":[],"mappings":"AAeA,eAAO,MAAM,kBAAkB,EAAG,YAAqB,CAAC;AAGxD,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,oEAAoE;IACpE,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;IACrC;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7C,+EAA+E;IAC/E,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CACjC;AAED,MAAM,WAAW,UAAW,SAAQ,QAAQ;IAC1C,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,iEAAiE;IACjE,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,gFAAgF;AAChF,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAWzD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAI7E;AAED,wBAAgB,YAAY,IAAI,MAAM,CAWrC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAO,GAAG,MAAM,EAAE,CAoCrE;AA2BD,wBAAgB,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,QAAQ,CA8DvD;AA6BD;;;GAGG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,UAAU,CAuCxD;AAED,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGjE"}

package/dist/services/init.js

@@ -0,0 +1,231 @@
+import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
+import { join, relative, sep } from 'node:path';
+import { ALWAYS_EXCLUDE, CONFIG_FILENAME, configSchema, findProjectRoot, IGNORE_FILENAME, LORE_DIRECTORY, LoreError, SECRET_SHAPED, toPosix, writeFileAtomic, } from '@lorepack/core';
+export const GITIGNORE_FILENAME = '.gitignore';
+const GITIGNORE_ENTRY = `${LORE_DIRECTORY}/`;
+/** Slugified directory name. Collisions are not this tool's problem in v0.1. */
+export function projectNameFrom(directory) {
+    const base = directory
+        .split(/[\\/]+/)
+        .filter(Boolean)
+        .at(-1) ?? 'project';
+    const cleaned = base
+        .normalize('NFC')
+        .replace(/[^a-zA-Z0-9 ._-]+/g, '-')
+        .replace(/^[-\s]+|[-\s]+$/g, '');
+    return cleaned === '' ? 'project' : cleaned;
+}
+export function renderConfig(name, sources) {
+    const lines = ['version: 1', `name: ${name}`, '', 'sources:'];
+    for (const source of sources)
+        lines.push(`  - ${source}`);
+    return `${lines.join('\n')}\n`;
+}
+export function renderIgnore() {
+    return [
+        '# Paths Lorepack never reads. Patterns are gitignore-style.',
+        '# Everything here is excluded before this file is consulted; it is listed so the',
+        '# defaults are visible and can be extended.',
+        '',
+        ...ALWAYS_EXCLUDE.map((pattern) => `${pattern}`),
+        '',
+        '# Add your own exclusions below.',
+        '',
+    ].join('\n');
+}
+/**
+ * Files whose names suggest credentials. Architecture section 19.2 is explicit that this
+ * is a guardrail rather than a secret scanner, so contents are never read.
+ */
+export function findSecretShaped(root, limit = 5000) {
+    const matchers = SECRET_SHAPED.map(toRegExp);
+    const found = [];
+    let visited = 0;
+    const walk = (directory) => {
+        if (visited > limit)
+            return;
+        let entries;
+        try {
+            entries = readdirSync(directory);
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries.sort()) {
+            if (visited > limit)
+                return;
+            visited += 1;
+            if (entry === '.git' || entry === 'node_modules' || entry === LORE_DIRECTORY)
+                continue;
+            const full = join(directory, entry);
+            let stats;
+            try {
+                stats = statSync(full);
+            }
+            catch {
+                continue;
+            }
+            if (stats.isDirectory()) {
+                walk(full);
+                continue;
+            }
+            if (matchers.some((matcher) => matcher.test(entry))) {
+                found.push(toPosix(relative(root, full).split(sep).join('/')));
+            }
+        }
+    };
+    walk(root);
+    return found.sort();
+}
+function toRegExp(pattern) {
+    const escaped = pattern.replace(/[.+^${}()|[\]\\]/g, '\\$&').replace(/\*/g, '.*');
+    return new RegExp(`^${escaped}$`, 'i');
+}
+function gitignoreNeedsEntry(path) {
+    if (!existsSync(path))
+        return true;
+    const contents = readFileSync(path, 'utf8');
+    return !contents
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .some((line) => line === GITIGNORE_ENTRY || line === LORE_DIRECTORY);
+}
+/** Preserves the file's existing line ending style rather than imposing one. */
+function appendGitignoreEntry(path) {
+    if (!existsSync(path)) {
+        return `# Lorepack build state. Commit lore.yaml, lore.lock and .loreignore instead.\n${GITIGNORE_ENTRY}\n`;
+    }
+    const contents = readFileSync(path, 'utf8');
+    const newline = contents.includes('\r\n') ? '\r\n' : '\n';
+    const separator = contents.length === 0 || contents.endsWith(newline) ? '' : newline;
+    return `${contents}${separator}${newline}# Lorepack build state${newline}${GITIGNORE_ENTRY}${newline}`;
+}
+export function planInit(options) {
+    const root = options.directory;
+    if (!existsSync(root)) {
+        throw new LoreError('LORE_E_INVALID_ARGUMENT', `${toPosix(root)} does not exist.`, {
+            remediation: 'Create the directory first, or point `lorepack init` at an existing one.',
+        });
+    }
+    if (!statSync(root).isDirectory()) {
+        throw new LoreError('LORE_E_INVALID_ARGUMENT', `${toPosix(root)} is not a directory.`, {
+            remediation: 'Point `lorepack init` at a directory containing your documents.',
+        });
+    }
+    const configPath = join(root, CONFIG_FILENAME);
+    const ignorePath = join(root, IGNORE_FILENAME);
+    const gitignorePath = join(root, GITIGNORE_FILENAME);
+    const creates = [];
+    const modifies = [];
+    const unchanged = [];
+    const configExists = existsSync(configPath);
+    if (!configExists)
+        creates.push(CONFIG_FILENAME);
+    else if (options.force === true)
+        modifies.push(CONFIG_FILENAME);
+    else
+        unchanged.push(CONFIG_FILENAME);
+    if (!existsSync(ignorePath))
+        creates.push(IGNORE_FILENAME);
+    else if (options.force === true)
+        modifies.push(IGNORE_FILENAME);
+    else
+        unchanged.push(IGNORE_FILENAME);
+    if (gitignoreNeedsEntry(gitignorePath)) {
+        if (existsSync(gitignorePath))
+            modifies.push(GITIGNORE_FILENAME);
+        else
+            creates.push(GITIGNORE_FILENAME);
+    }
+    else {
+        unchanged.push(GITIGNORE_FILENAME);
+    }
+    // An existing config keeps its name, so re-running never silently renames a project.
+    const projectName = configExists && options.force !== true ? existingName(configPath, root) : projectNameFrom(root);
+    const generated = renderConfig(projectNameFrom(root), ['.']);
+    const configDiffers = configExists && safeRead(configPath) !== generated;
+    const forceWouldChange = configExists && options.force !== true
+        ? [CONFIG_FILENAME, IGNORE_FILENAME].filter((name) => existsSync(join(root, name)))
+        : [];
+    return {
+        forceWouldChange,
+        configDiffers,
+        projectRoot: root,
+        creates,
+        modifies,
+        unchanged,
+        projectName,
+        sources: ['.'],
+        secretShaped: findSecretShaped(root),
+        alreadyInitialized: configExists,
+    };
+}
+function safeRead(path) {
+    try {
+        return readFileSync(path, 'utf8');
+    }
+    catch {
+        return null;
+    }
+}
+function existingName(configPath, root) {
+    try {
+        const parsed = configSchema.partial().safeParse(Object.fromEntries(readFileSync(configPath, 'utf8')
+            .split(/\r?\n/)
+            .flatMap((line) => {
+            const match = /^name:\s*(.+)$/.exec(line.trim());
+            return match?.[1] === undefined ? [] : [['name', match[1].trim()]];
+        })));
+        if (parsed.success && typeof parsed.data.name === 'string')
+            return parsed.data.name;
+    }
+    catch {
+        // Fall through: a config we cannot read is reported by loadConfig, not here.
+    }
+    return projectNameFrom(root);
+}
+/**
+ * Writes the project files. Grouped so a failure leaves nothing half-created: content is
+ * prepared first, and only then written, each one atomically.
+ */
+export function runInit(options) {
+    const plan = planInit(options);
+    if (options.dryRun === true)
+        return { ...plan, written: [] };
+    const root = plan.projectRoot;
+    const pending = [];
+    const wants = (name) => plan.creates.includes(name) || plan.modifies.includes(name);
+    if (wants(CONFIG_FILENAME)) {
+        pending.push({
+            relativePath: CONFIG_FILENAME,
+            path: join(root, CONFIG_FILENAME),
+            contents: renderConfig(plan.projectName, plan.sources),
+        });
+    }
+    if (wants(IGNORE_FILENAME)) {
+        pending.push({
+            relativePath: IGNORE_FILENAME,
+            path: join(root, IGNORE_FILENAME),
+            contents: renderIgnore(),
+        });
+    }
+    if (wants(GITIGNORE_FILENAME)) {
+        pending.push({
+            relativePath: GITIGNORE_FILENAME,
+            path: join(root, GITIGNORE_FILENAME),
+            contents: appendGitignoreEntry(join(root, GITIGNORE_FILENAME)),
+        });
+    }
+    const written = [];
+    for (const file of pending) {
+        writeFileAtomic(file.path, file.contents);
+        written.push(file.relativePath);
+    }
+    return { ...plan, written };
+}
+/** Guards against initializing inside an existing project by accident. */
+export function enclosingProject(directory) {
+    const found = findProjectRoot(directory);
+    return found === null || found === directory ? null : found;
+}
+//# sourceMappingURL=init.js.map

package/dist/services/init.js.map

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

package/dist/services/packing.d.ts

@@ -0,0 +1,25 @@
+import { type BuildId, type LoadedConfig } from '@lorepack/core';
+/**
+ * Writing a `.lorepack` archive, in the one place both `lorepack pack` and Studio call.
+ *
+ * Extracted from the command when Studio grew a pack button (#68). Two implementations of an
+ * archive format is how a file packed from a browser ends up subtly different from one packed
+ * in a terminal, and the difference would only be discovered by whoever tried to open it.
+ */
+export interface PackResult {
+    readonly buildId: BuildId;
+    readonly archive: string;
+    /** Members written, including the checksum index. */
+    readonly members: number;
+    readonly includeOriginals: boolean;
+}
+export interface PackOptions {
+    /** Build id or unique prefix. The active build when omitted. */
+    readonly build?: string | undefined;
+    /** Where to write. Defaults into the project root, named for the project and the build. */
+    readonly out?: string | undefined;
+    /** Base for a relative `out`. The process cwd for the CLI, the project root for Studio. */
+    readonly relativeTo?: string | undefined;
+}
+export declare function packBuild(config: LoadedConfig, options: PackOptions): Promise<PackResult>;
+//# sourceMappingURL=packing.d.ts.map

package/dist/services/packing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packing.d.ts","sourceRoot":"","sources":["../../src/services/packing.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,OAAO,EAAkB,KAAK,YAAY,EAAa,MAAM,gBAAgB,CAAC;AAG5F;;;;;;GAMG;AAEH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,qDAAqD;IACrD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;CACpC;AAED,MAAM,WAAW,WAAW;IAC1B,gEAAgE;IAChE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,2FAA2F;IAC3F,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,2FAA2F;IAC3F,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1C;AAED,wBAAsB,SAAS,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAsD/F"}

package/dist/services/packing.js

@@ -0,0 +1,69 @@
+import { join, resolve } from 'node:path';
+import { collectBuildMembers, collectObjects, collectOriginals, openReadOnly, writeArchive, } from '@lorepack/backend-local';
+import { LORE_DIRECTORY, LoreError } from '@lorepack/core';
+import { buildDirectory, openStateStore, resolveBuildId } from './builds.js';
+export async function packBuild(config, options) {
+    const loreDirectory = join(config.projectRoot, LORE_DIRECTORY);
+    const state = openStateStore(loreDirectory);
+    try {
+        const builds = state.listBuilds();
+        const active = state.current();
+        const buildId = options.build === undefined
+            ? activeOrFail(active?.buildId)
+            : resolveBuildId(builds, options.build);
+        const summary = builds.find((build) => build.buildId === buildId);
+        if (summary?.state !== 'verified' && summary?.state !== 'active') {
+            throw new LoreError('LORE_E_BUILD_VALIDATION', `Build ${buildId} is ${summary?.state ?? 'unknown'}, and only a verified build can be packed.`, {
+                remediation: 'Run `lorepack build` to produce a verified build.',
+                subject: buildId,
+            });
+        }
+        const directory = buildDirectory(loreDirectory, buildId);
+        const { objectHashes, sourcePaths } = readReferences(directory);
+        const members = collectBuildMembers(directory, collectObjects(join(loreDirectory, 'objects'), objectHashes));
+        // Originals are excluded by default (section 11.2): an archive is a build, not a copy of
+        // someone's document folder, and shipping binaries by default would be a surprise the
+        // user did not ask for.
+        if (config.effective.includeOriginals) {
+            members.push(...collectOriginals(config.projectRoot, sourcePaths));
+        }
+        const destination = options.out === undefined
+            ? join(config.projectRoot, `${config.config.name}-${buildId.slice(0, 17)}.lorepack`)
+            : resolve(options.relativeTo ?? config.projectRoot, options.out);
+        await writeArchive(destination, members);
+        return {
+            buildId,
+            archive: destination,
+            members: members.length + 1,
+            includeOriginals: config.effective.includeOriginals,
+        };
+    }
+    finally {
+        state.close();
+    }
+}
+function activeOrFail(buildId) {
+    if (buildId === undefined) {
+        throw new LoreError('LORE_E_BUILD_NOT_FOUND', 'This project has no active build to pack.', {
+            remediation: 'Run `lorepack build`, or name a build.',
+        });
+    }
+    return buildId;
+}
+/** The objects and source paths a build references, read from the build itself. */
+function readReferences(directory) {
+    const db = openReadOnly(join(directory, 'context.sqlite'));
+    try {
+        const rows = db
+            .prepare('SELECT object_hash AS objectHash, relative_path AS relativePath FROM artifacts')
+            .all();
+        return {
+            objectHashes: rows.map((row) => row.objectHash),
+            sourcePaths: rows.map((row) => row.relativePath),
+        };
+    }
+    finally {
+        db.close();
+    }
+}
+//# sourceMappingURL=packing.js.map

package/dist/services/packing.js.map

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

package/dist/services/parse-cache.d.ts

@@ -0,0 +1,47 @@
+import type { Chunk } from '@lorepack/compiler';
+import type { Artifact, LoreNode, ParsedTable, ParserWarning } from '@lorepack/core';
+/**
+ * The parse cache behind incremental builds.
+ *
+ * Keyed by `cacheKey` (architecture section 12.3), which covers content, parser identity,
+ * normalization version and the configuration that affects output. That is what makes a
+ * hit safe: anything that could change the parsed result changes the key, so a stale entry
+ * is unreachable rather than merely unlikely.
+ *
+ * The cache is an optimisation and nothing more. A corrupt, truncated or unreadable entry
+ * is treated as a miss, never as an error: a build must never fail because of a cache.
+ */
+export interface CachedParse {
+    readonly artifact: Artifact;
+    readonly nodes: readonly LoreNode[];
+    readonly chunks: readonly Chunk[];
+    readonly objectHash: string;
+    /**
+     * Typed tables, when the artifact produced any.
+     *
+     * Present on a fresh parse and never on a cached one, because a table-bearing parse is
+     * not written to the cache at all: the rows would be hundreds of megabytes of JSON to
+     * avoid a re-read of a file the build already has. Since nothing is written, nothing can
+     * be read back with its tables missing, which is the failure mode that would matter.
+     */
+    readonly tables?: readonly ParsedTable[];
+    /**
+     * What the parser said about this artifact, cached alongside it.
+     *
+     * Unlike table rows these are cheap, and dropping them would make a build's warnings depend
+     * on whether the cache happened to be warm: the first build would name a flattened Word
+     * style and the second would not (#223). A warning that appears only sometimes is worse
+     * than one that never appears, because it teaches a reader that silence means nothing.
+     */
+    readonly warnings?: readonly ParserWarning[];
+}
+export declare class ParseCache {
+    #private;
+    constructor(directory: string);
+    get hits(): number;
+    get misses(): number;
+    get(key: string): CachedParse | null;
+    put(key: string, value: CachedParse): void;
+    clear(): void;
+}
+//# sourceMappingURL=parse-cache.d.ts.map

package/dist/services/parse-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-cache.d.ts","sourceRoot":"","sources":["../../src/services/parse-cache.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGrF;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B;;;;;;;OAOG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IACzC;;;;;;;OAOG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;CAC9C;AASD,qBAAa,UAAU;;IAKrB,YAAY,SAAS,EAAE,MAAM,EAE5B;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAyBnC;IAED,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CASzC;IAED,KAAK,IAAI,IAAI,CAEZ;CAOF"}