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

package/dist/services/build.d.ts

@@ -0,0 +1,48 @@
+import { sealCandidateDirectory } from '@lorepack/backend-local';
+import { type BuildId, type BuildManifest, type LoadedConfig, type ProgressBus } from '@lorepack/core';
+export interface BuildOptions {
+    readonly config: LoadedConfig;
+    readonly progress: ProgressBus;
+    readonly frozen?: boolean;
+    readonly activate?: boolean;
+    readonly allowLargeProject?: boolean;
+    readonly signal?: AbortSignal;
+    /** How long to wait for the project lock. Tests use a short wait; users get the default. */
+    readonly lockWaitMs?: number;
+    readonly now?: () => Date;
+    readonly seal?: typeof sealCandidateDirectory;
+}
+export interface BuildResult {
+    readonly buildId: BuildId;
+    readonly created: boolean;
+    readonly activated: boolean;
+    readonly counts: BuildManifest['counts'];
+    readonly warnings: number;
+    readonly reusedArtifacts: number;
+    readonly rebuiltArtifacts: number;
+    readonly durationMs: number;
+}
+/**
+ * How long a command waits for the project lock, when the environment asks for something
+ * other than the shipped default.
+ *
+ * `LORE_LOCK_WAIT_MS` exists because 30 seconds is the right default and the wrong constant
+ * to have no way around (#229). It is the time a person is willing to look at a command that
+ * appears to be doing nothing, and it is unrelated to how long a large project on a slow disk
+ * legitimately takes to build. A Windows CI runner building a 500-document fixture exceeds it,
+ * and the honest fix is to let that environment say so rather than to make every session wait
+ * longer for a lock that is genuinely stuck.
+ *
+ * Operational, so it is an environment variable rather than configuration: it never reaches
+ * the build id, and two machines that disagree about it still produce identical builds.
+ */
+export declare function lockWaitFromEnvironment(environment?: NodeJS.ProcessEnv): number | undefined;
+export declare function runBuild(options: BuildOptions): Promise<BuildResult>;
+/**
+ * Re-reads a source after fingerprinting and binds the bytes handed to the parser to that
+ * digest. A source can be edited between the fingerprint and parse stages, so trusting the
+ * first hash would record one set of bytes under another set's identity and poison the parse
+ * cache. One retry handles an in-flight save; a second mismatch fails the candidate.
+ */
+export declare function readStableSourceBytes(absolutePath: string, expectedHash: string, displayPath: string): Uint8Array;
+//# sourceMappingURL=build.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/services/build.ts"],"names":[],"mappings":"AAEA,OAAO,EAYL,sBAAsB,EAIvB,MAAM,yBAAyB,CAAC;AAgBjC,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,aAAa,EASlB,KAAK,YAAY,EAKjB,KAAK,WAAW,EAIjB,MAAM,gBAAgB,CAAC;AAmBxB,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,4FAA4F;IAC5F,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,sBAAsB,CAAC;CAC/C;AAwBD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,GAAE,MAAM,CAAC,UAAwB,GAC3C,MAAM,GAAG,SAAS,CAepB;AAED,wBAAsB,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAma1E;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,GAClB,UAAU,CAuBZ"}

package/dist/services/build.js

@@ -0,0 +1,499 @@
+import { readFileSync, rmSync } from 'node:fs';
+import { join } from 'node:path';
+import { buildMigrationsDirectory, countRows, createCandidateDirectory, discardCandidateDirectory, FileObjectStore, integrityCheck, LocalStateStore, loadMigrations, openWritable, ProjectLock, runMigrations, sealCandidateDirectory, searchCatalog, stateMigrationsDirectory, writeCatalog, } from '@lorepack/backend-local';
+import { assertNoDrift, buildLockfile, cacheKey, chunkArtifact, compareLockfiles, createPlan, normalizeArtifact, readLockfile, resolveRules, validateCandidate, writeLockfile, } from '@lorepack/compiler';
+import { buildManifestSchema, CANONICALIZATION_VERSION, count, deriveBuildId, hashCanonical, hashRoot, LORE_DIRECTORY, LoreError, NORMALIZATION_VERSION, secretsFromEnv, sha256Hex, writeFileAtomic, } from '@lorepack/core';
+import { parserFor } from '@lorepack/parsers';
+import { checkpoint } from './cancellation.js';
+import { ParseCache } from './parse-cache.js';
+import { isBuildReadable, readBuildCatalog } from './project.js';
+import { lockInputs } from './versions.js';
+/**
+ * The build orchestrator.
+ *
+ * Stage order matters and is the whole point: validate the candidate **in place**, then
+ * seal it into `builds/`, then record it, and only then activate as a separate step. A
+ * candidate lives under `.lore/tmp/` until it has passed, so an interrupted or failed
+ * build cannot leave something in `builds/` that a later run would treat as real.
+ */
+/** The `applied_at` recorded inside every build database. See `runMigrations` below. */
+const SEALED_AT = '1980-01-01T00:00:00.000Z';
+/**
+ * The class a reader groups by. Both ways of being unreadable are the same fact to a user
+ * ("this file is not in the build"), so they share a class and differ in code.
+ */
+function warningClass(code) {
+    return code === 'unsupported-format' || code === 'undecodable-content'
+        ? 'unsupported-file'
+        : 'parser';
+}
+/**
+ * How long a command waits for the project lock, when the environment asks for something
+ * other than the shipped default.
+ *
+ * `LORE_LOCK_WAIT_MS` exists because 30 seconds is the right default and the wrong constant
+ * to have no way around (#229). It is the time a person is willing to look at a command that
+ * appears to be doing nothing, and it is unrelated to how long a large project on a slow disk
+ * legitimately takes to build. A Windows CI runner building a 500-document fixture exceeds it,
+ * and the honest fix is to let that environment say so rather than to make every session wait
+ * longer for a lock that is genuinely stuck.
+ *
+ * Operational, so it is an environment variable rather than configuration: it never reaches
+ * the build id, and two machines that disagree about it still produce identical builds.
+ */
+export function lockWaitFromEnvironment(environment = process.env) {
+    const raw = environment.LORE_LOCK_WAIT_MS;
+    if (raw === undefined)
+        return undefined;
+    // `Number('')` is 0, and 0 here means "do not wait at all", which is the opposite of what
+    // someone setting a wait wants. An unset variable expands to the empty string in a shell,
+    // so reaching that by accident is easy (#195 is the same trap on a different knob).
+    const value = raw.trim() === '' ? Number.NaN : Number(raw);
+    if (!Number.isFinite(value) || value < 0) {
+        throw new LoreError('LORE_E_INVALID_ARGUMENT', `LORE_LOCK_WAIT_MS must be a number of milliseconds, got ${raw}.`, { remediation: 'Set it to milliseconds, or unset it to wait the default 30 seconds.' });
+    }
+    return value;
+}
+export async function runBuild(options) {
+    const { config, progress } = options;
+    const now = options.now ?? (() => new Date());
+    const startedAt = now();
+    const loreDirectory = join(config.projectRoot, LORE_DIRECTORY);
+    const waitMs = options.lockWaitMs ?? lockWaitFromEnvironment();
+    const lock = new ProjectLock(join(loreDirectory, 'lock'), {
+        ...(waitMs === undefined ? {} : { waitMs }),
+        onWait: ({ pid }) => progress.diagnostic('info', pid === null
+            ? 'Waiting for the project lock held by another Lorepack process.'
+            : `Waiting for the project lock held by pid ${pid}.`),
+    });
+    return lock.withLock(async () => {
+        const state = LocalStateStore.open(loreDirectory, stateMigrationsDirectory());
+        const objects = new FileObjectStore(join(loreDirectory, 'objects'));
+        try {
+            const previousLock = readLockfile(config.projectRoot);
+            const nextLock = buildLockfile(lockInputs());
+            if (options.frozen === true)
+                assertNoDrift(compareLockfiles(previousLock, nextLock));
+            const active = state.current();
+            const previous = active === null ? null : readBuildCatalog(loreDirectory, active.buildId);
+            const { discovery, fingerprint } = await createPlan({
+                config,
+                previous,
+                previousLock,
+                lockInputs: lockInputs(),
+                progress,
+                ...(options.allowLargeProject === undefined
+                    ? {}
+                    : { allowLargeProject: options.allowLargeProject }),
+            });
+            await checkpoint(options.signal, { hasActiveBuild: active !== null });
+            // Rules resolve here, before parsing, because the cache key depends on them: an
+            // artifact whose declared authority changed must be reindexed even though its bytes
+            // did not (architecture section 12.7). Resolving after the parse loop would let a rule
+            // edit reuse a stale entry, which is the quiet failure the cache key exists to prevent.
+            const ruleResolution = resolveRules({
+                artifacts: fingerprint.artifacts.map((artifact) => ({
+                    artifactId: artifact.artifactId,
+                    relativePath: artifact.relativePath,
+                })),
+                config: config.effective,
+            });
+            const rulesById = new Map(ruleResolution.resolved.map((entry) => [entry.artifactId, entry]));
+            const cache = new ParseCache(join(loreDirectory, 'cache', 'parse'));
+            progress.start('parsing', 'Parsing', fingerprint.artifacts.length);
+            const parsed = [];
+            let handled = 0;
+            for (const discovered of fingerprint.artifacts) {
+                await checkpoint(options.signal, { hasActiveBuild: active !== null });
+                const parser = parserFor({
+                    mediaType: discovered.mediaType,
+                    relativePath: discovered.relativePath,
+                });
+                if (parser === null)
+                    continue;
+                const key = cacheKey({
+                    artifactId: discovered.artifactId,
+                    contentHash: discovered.contentHash,
+                    parserId: parser.id,
+                    parserVersion: parser.version,
+                    normalizationVersion: NORMALIZATION_VERSION,
+                    chunking: config.effective.chunking,
+                    rules: ruleResolution.canonical,
+                });
+                const bytes = readStableSourceBytes(discovered.absolutePath, discovered.contentHash, discovered.displayPath);
+                // A hit still has to have its normalized body present: the object store and the
+                // cache can be pruned independently, and reusing a parse whose body is gone would
+                // produce a build that cannot answer a source read.
+                const cached = cache.get(key);
+                if (cached !== null && (await objects.has(cached.objectHash))) {
+                    parsed.push(withRules(cached, rulesById));
+                    handled += 1;
+                    continue;
+                }
+                let result;
+                try {
+                    // Awaited because a parser may be asynchronous: PDF and DOCX cannot be read any
+                    // other way. The `await` matters for the `catch` as much as for the value, since
+                    // a rejected promise from an unawaited call would escape this block entirely and
+                    // surface as an unhandled rejection rather than as `LORE_E_PARSE_FAILED`.
+                    result = await parser.parse({
+                        artifactId: discovered.artifactId,
+                        sourceId: discovered.sourceId,
+                        relativePath: discovered.relativePath,
+                        displayPath: discovered.displayPath,
+                        mediaType: discovered.mediaType,
+                        byteSize: discovered.byteSize,
+                        contentHash: discovered.contentHash,
+                        bytes,
+                    });
+                }
+                catch (cause) {
+                    // A parser that raised a `LoreError` classified its own failure, and that
+                    // classification is kept (#242).
+                    //
+                    // Wrapping everything meant a parser raising `LORE_E_ENVELOPE_EXCEEDED`, a user
+                    // problem that exits 1, was reported as `LORE_E_PARSE_FAILED`, a build integrity
+                    // failure that exits 2. The parser was right and the pipeline overrode it, so
+                    // anything branching on the stable code, which is what the taxonomy is for, was
+                    // told the wrong thing.
+                    if (cause instanceof LoreError)
+                        throw cause;
+                    // Anything else is a genuine surprise, and that is exactly what this code means:
+                    // a supported, included file whose bytes could not be read. It fails the candidate
+                    // by default (architecture section 6.9) and the previous build stays active.
+                    //
+                    // A file whose bytes are not readable text does not reach here: fingerprinting
+                    // classified it and left it out with a warning, which is the other row of the
+                    // same table (#165).
+                    throw new LoreError('LORE_E_PARSE_FAILED', `Could not parse ${discovered.displayPath}.`, {
+                        remediation: 'Fix the file, or exclude it in .loreignore. The active build is unchanged.',
+                        path: discovered.displayPath,
+                        cause,
+                    });
+                }
+                const normalized = await normalizeArtifact({ parsed: result, objects });
+                const entry = {
+                    artifact: result.artifact,
+                    nodes: normalized.nodes,
+                    chunks: chunkArtifact({
+                        artifactId: result.artifact.id,
+                        nodes: normalized.nodes,
+                        chunking: config.effective.chunking,
+                    }),
+                    objectHash: normalized.objectHash,
+                    ...(result.tables === undefined || result.tables.length === 0
+                        ? {}
+                        : { tables: result.tables }),
+                    ...(result.warnings.length === 0 ? {} : { warnings: result.warnings }),
+                };
+                // A table-bearing parse is deliberately not cached. The cache is a JSON file per
+                // artifact, and a 500,000-row table would write hundreds of megabytes there to save
+                // a re-read that takes seconds. Rows are exactly reproducible from bytes the build
+                // has already read, so the cheap thing to keep is nothing. Nothing is ever written,
+                // so nothing can ever be read back missing its tables.
+                if (entry.tables === undefined)
+                    cache.put(key, entry);
+                parsed.push(withRules(entry, rulesById));
+                handled += 1;
+                if (handled % 10 === 0)
+                    progress.progress('parsing', handled, { unit: 'documents' });
+            }
+            progress.finish('parsing', handled);
+            // One list from here on. Discovery decides an extension has no parser; parsing decides
+            // the bytes are not readable text. Both are the same promise to the user, which is
+            // that a file the build left out is named rather than silently missing.
+            const warnings = [
+                ...discovery.warnings,
+                ...fingerprint.warnings,
+                // What the parsers said. Discovery reports files left out; these report decisions
+                // taken *inside* a file that was kept, which is the other half of the same promise:
+                // a heading flattened, a column widened, a sheet not read as a table. Without this
+                // every one of them was computed carefully and then dropped (#223).
+                ...ruleResolution.warnings,
+                ...parsed.flatMap((entry) => (entry.warnings ?? []).map((warning) => ({
+                    code: warning.code,
+                    path: entry.artifact.displayPath,
+                    message: warning.message,
+                }))),
+            ]
+                .map((warning) => ({
+                code: warning.code,
+                class: warningClass(warning.code),
+                path: warning.path,
+                message: warning.message,
+            }))
+                .sort((a, b) => (a.path < b.path ? -1 : a.path > b.path ? 1 : 0));
+            // Identity, derived before anything is written so the directory is named correctly.
+            const buildId = deriveBuildId({
+                formatVersion: 1,
+                schemaVersion: nextLock.schema,
+                compilerVersion: nextLock.compiler,
+                canonicalizationVersion: CANONICALIZATION_VERSION,
+                normalizationVersion: NORMALIZATION_VERSION,
+                effectiveConfig: config.effective,
+                parserVersions: nextLock.parsers,
+                ruleResolution: ruleResolution.canonical,
+                embeddingProfile: null,
+                canonicalRoots: canonicalRoots(parsed),
+            });
+            /**
+             * Reuse only a build that is actually there and actually readable (#251).
+             *
+             * `state.getBuild` answers from `state.sqlite`, a separate database that stays perfectly
+             * intact while the build directory it points at is deleted, truncated, overwritten or
+             * left at a catalog schema this version does not read. Trusting the record alone made
+             * every one of those permanently unrecoverable: `lorepack build` reported "No changes" and
+             * the next read failed exactly as before, including when the failing read's own
+             * remediation was to run `lorepack build`.
+             */
+            const existing = state.getBuild(buildId);
+            const reusable = existing !== null && isBuildReadable(loreDirectory, buildId);
+            if (existing !== null && !reusable) {
+                // Said out loud rather than rebuilt silently: someone whose build was removed by a
+                // disk, a sync tool or an ignore rule should learn that it was.
+                progress.diagnostic('warn', `The recorded build ${buildId.slice(0, 17)} cannot be read, so it is being compiled again.`);
+                /**
+                 * Clear the damaged directory, or sealing will decline to replace it.
+                 *
+                 * `sealCandidateDirectory` treats an existing id as a no-op, and its reasoning is
+                 * right for a build that is intact: identical id means identical logical content, so
+                 * there is nothing to write. It is exactly wrong here. The id still describes the
+                 * content, and the bytes on disk are no longer that content, so the one case where
+                 * replacing matters is the one case it refused (#251).
+                 *
+                 * Safe because unreadability was just established: there is nothing here to lose that
+                 * is not already lost, and the candidate that replaces it is validated before it is
+                 * sealed.
+                 */
+                rmSync(join(loreDirectory, 'builds', buildId), {
+                    recursive: true,
+                    force: true,
+                    maxRetries: 3,
+                });
+            }
+            if (reusable) {
+                const activated = options.activate !== false && state.current()?.buildId !== buildId;
+                if (activated)
+                    state.activate(buildId);
+                return {
+                    buildId,
+                    created: false,
+                    activated,
+                    counts: countsOf(parsed),
+                    warnings: warnings.length,
+                    reusedArtifacts: cache.hits,
+                    rebuiltArtifacts: cache.misses,
+                    durationMs: now().getTime() - startedAt.getTime(),
+                };
+            }
+            // Index into a candidate directory, outside builds/.
+            const candidate = createCandidateDirectory(loreDirectory);
+            let sealed = false;
+            try {
+                await checkpoint(options.signal, { hasActiveBuild: active !== null });
+                progress.start('indexing', 'Indexing');
+                const db = openWritable(join(candidate.path, 'context.sqlite'));
+                try {
+                    // A fixed timestamp, not the wall clock: a sealed build must carry no
+                    // operational time. Otherwise two builds of identical content differ in bytes,
+                    // and `.lorepack` stops being reproducible.
+                    runMigrations(db, loadMigrations(buildMigrationsDirectory()), () => SEALED_AT);
+                    const counts = writeCatalog({
+                        db,
+                        artifacts: parsed,
+                        warnings,
+                    });
+                    progress.finish('indexing', counts.chunks);
+                    const manifest = {
+                        formatVersion: 1,
+                        buildId,
+                        projectName: config.config.name,
+                        compilerVersion: nextLock.compiler,
+                        schemaVersion: nextLock.schema,
+                        configurationHash: hashCanonical(config.effective),
+                        sourceFingerprint: fingerprint.fingerprint,
+                        canonicalRoots: canonicalRoots(parsed),
+                        // Declared from what the build contains, not from what the compiler can do. A
+                        // client that sees `table-query` and finds no tables has been misled about this
+                        // build, which is worse than not offering the capability.
+                        capabilities: counts.tables > 0
+                            ? ['lexical-search', 'structured-context', 'table-query']
+                            : ['lexical-search', 'structured-context'],
+                        counts,
+                        warnings: warnings.map((warning) => ({
+                            code: warning.code,
+                            message: warning.message,
+                            ...(warning.path === '.' ? {} : { path: warning.path }),
+                            class: warning.class,
+                        })),
+                        // Sealed with the build, so `lorepack inspect exclusions` and Studio can answer after
+                        // the sources have moved on and after a rollback, without reading a source file.
+                        // Not an input to `deriveBuildId`: identity is what a build contains, and two
+                        // builds holding the same artifacts are the same build however the rest was
+                        // filtered out. Warnings are already outside identity for the same reason.
+                        exclusions: discovery.exclusions.map((exclusion) => ({
+                            ...exclusion,
+                            sample: [...exclusion.sample],
+                        })),
+                    };
+                    progress.start('validating', 'Validating');
+                    const report = await validateCandidate({
+                        db,
+                        objects,
+                        artifacts: parsed,
+                        manifest: manifest,
+                        secrets: secretsFromEnv(),
+                        integrityCheck,
+                        search: (database, query, limit) => searchCatalog(database, query, limit),
+                        countRows,
+                    });
+                    progress.finish('validating', report.checksRun.length, report.ok ? 'done' : 'failed');
+                    if (!report.ok) {
+                        throw new LoreError('LORE_E_BUILD_VALIDATION', `The candidate build failed ${count(report.failures.length, 'check')}:\n${report.failures
+                            .map((failure) => `  ${failure.check}: ${failure.message}${failure.subject === undefined ? '' : ` (${failure.subject})`}`)
+                            .join('\n')}`, {
+                            remediation: 'The active build is unchanged. Fix the reported problems and build again.',
+                            details: { failures: report.failures },
+                        });
+                    }
+                    buildManifestSchema.parse(manifest);
+                    writeFileAtomic(join(candidate.path, 'manifest.json'), `${JSON.stringify(manifest, null, 2)}\n`);
+                    writeFileAtomic(join(candidate.path, 'reports', 'warnings.json'), `${JSON.stringify(warnings, null, 2)}\n`);
+                    writeFileAtomic(join(candidate.path, 'reports', 'canonical-hashes.json'), `${JSON.stringify({
+                        algorithm: 'sha256',
+                        canonicalizationVersion: CANONICALIZATION_VERSION,
+                        roots: canonicalRoots(parsed),
+                    }, null, 2)}\n`);
+                }
+                finally {
+                    db.close();
+                }
+                await checkpoint(options.signal, { hasActiveBuild: active !== null });
+                progress.start('sealing', 'Sealing');
+                const sealedResult = (options.seal ?? sealCandidateDirectory)(candidate, join(loreDirectory, 'builds', buildId));
+                if (!sealedResult.sealed && !isBuildReadable(loreDirectory, buildId)) {
+                    throw new LoreError('LORE_E_INTERNAL', `The build ${buildId} was not sealed and no readable destination exists.`, {
+                        remediation: 'Check the build directory permissions and build again.',
+                    });
+                }
+                sealed = true;
+                progress.finish('sealing', 1);
+            }
+            finally {
+                // Any failure or cancellation removes the candidate. builds/ is never touched
+                // until the seal, so the active build cannot be disturbed by a failed run.
+                if (!sealed)
+                    discardCandidateDirectory(candidate);
+            }
+            const counts = countsOf(parsed);
+            state.recordBuild({
+                buildId,
+                state: 'verified',
+                createdAt: startedAt.toISOString(),
+                counts,
+            });
+            writeLockfile(config.projectRoot, nextLock);
+            let activated = false;
+            if (options.activate !== false) {
+                progress.start('activating', 'Activating');
+                state.activate(buildId, () => now().toISOString());
+                progress.finish('activating', 1);
+                activated = true;
+            }
+            return {
+                buildId,
+                created: true,
+                activated,
+                counts,
+                warnings: warnings.length,
+                reusedArtifacts: cache.hits,
+                rebuiltArtifacts: cache.misses,
+                durationMs: now().getTime() - startedAt.getTime(),
+            };
+        }
+        finally {
+            state.close();
+        }
+    });
+}
+/**
+ * Re-reads a source after fingerprinting and binds the bytes handed to the parser to that
+ * digest. A source can be edited between the fingerprint and parse stages, so trusting the
+ * first hash would record one set of bytes under another set's identity and poison the parse
+ * cache. One retry handles an in-flight save; a second mismatch fails the candidate.
+ */
+export function readStableSourceBytes(absolutePath, expectedHash, displayPath) {
+    for (let attempt = 0; attempt < 2; attempt += 1) {
+        let bytes;
+        try {
+            bytes = new Uint8Array(readFileSync(absolutePath));
+        }
+        catch (cause) {
+            throw new LoreError('LORE_E_SOURCE_UNREADABLE', `${displayPath} could not be read.`, {
+                remediation: 'Check the file permissions, or exclude it in .loreignore.',
+                path: displayPath,
+                cause,
+            });
+        }
+        if (sha256Hex(bytes) === expectedHash)
+            return bytes;
+    }
+    throw new LoreError('LORE_E_STALE_SOURCES', `${displayPath} changed while the build was reading it.`, {
+        remediation: 'Save the source completely, then run `lorepack build` again.',
+        path: displayPath,
+    });
+}
+function canonicalRoots(parsed) {
+    return {
+        artifacts: hashRoot(parsed.map((entry) => hashCanonical([entry.artifact.id, entry.artifact.contentHash]))),
+        nodes: hashRoot(parsed.flatMap((entry) => entry.nodes.map((node) => node.revisionHash))),
+        chunks: hashRoot(parsed.flatMap((entry) => entry.chunks.map((chunk) => chunk.revisionHash))),
+        // Every cell, not just the schema. Section 11.4 requires a row change to change the
+        // build id, and hashing only the column layout would let two builds with different data
+        // share an identity, which is the one thing a build id may never do.
+        tables: hashRoot(parsed.flatMap((entry) => (entry.tables ?? []).map((table) => hashCanonical([
+            table.tableId,
+            table.columns.map((column) => [column.name, column.type, column.nullable]),
+            table.rows,
+        ])))),
+        objects: hashRoot(parsed.map((entry) => entry.objectHash)),
+    };
+}
+function countsOf(parsed) {
+    const tables = parsed.flatMap((entry) => entry.tables ?? []);
+    return {
+        artifacts: parsed.length,
+        nodes: parsed.reduce((sum, entry) => sum + entry.nodes.length, 0),
+        chunks: parsed.reduce((sum, entry) => sum + entry.chunks.length, 0),
+        tables: tables.length,
+        // Counted from the parse rather than read back from SQLite, so this agrees with the
+        // manifest on a rebuild that reused an existing build directory and wrote no rows.
+        tableRows: tables.reduce((sum, table) => sum + table.rows.length, 0),
+    };
+}
+/**
+ * A parsed artifact with its declared rules applied.
+ *
+ * Parsers leave every artifact neutral on purpose, with a comment forbidding them from
+ * inferring status or authority from content: that would be inventing truth. The declaration
+ * is the user's, and this is where it lands, after parsing and before indexing.
+ *
+ * Applied on the cached path too. The cache key covers the resolution, so a hit already agrees
+ * about the rules, but reapplying costs nothing and means the rule values in a build come from
+ * one place rather than from whichever path an artifact happened to take.
+ */
+function withRules(entry, rulesById) {
+    const rule = rulesById.get(entry.artifact.id);
+    if (rule === undefined)
+        return entry;
+    return {
+        ...entry,
+        artifact: {
+            ...entry.artifact,
+            status: rule.status,
+            authority: rule.authority,
+            supersedes: [...rule.supersedes],
+        },
+    };
+}
+//# sourceMappingURL=build.js.map

package/dist/services/build.js.map

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

package/dist/services/builds.d.ts

@@ -0,0 +1,40 @@
+import { LocalStateStore } from '@lorepack/backend-local';
+import type { BuildSnapshot } from '@lorepack/compiler';
+import { assertBuildId, type BuildId, type BuildSummary } from '@lorepack/core';
+/**
+ * Reading sealed builds: history, resolution of a short id, and the snapshot the diff
+ * engine works on.
+ *
+ * Everything here reads build data only. Nothing re-parses a source, which is what lets
+ * `lorepack diff` and `lorepack rollback` work in a project whose source directory has been
+ * deleted, and what makes both operations instant.
+ */
+export declare function openStateStore(loreDirectory: string): LocalStateStore;
+/**
+ * Resolves a full id or an unambiguous prefix.
+ *
+ * An ambiguous prefix lists the candidates rather than picking one. Silently choosing
+ * would mean activating a build the user did not name.
+ */
+export declare function resolveBuildId(builds: readonly BuildSummary[], reference: string): BuildId;
+/**
+ * The build a rollback returns to: the newest activatable one that is not already live.
+ *
+ * One definition, used by `lorepack rollback` and by the Studio endpoint behind the same button,
+ * because two definitions is how a terminal and a browser end up returning to different
+ * builds from the same history.
+ */
+export declare function previousBuild(builds: readonly BuildSummary[], active: BuildId | null): BuildId;
+export declare function buildDirectory(loreDirectory: string, buildId: BuildId): string;
+/** Reads the canonical records a diff compares, straight out of the sealed build. */
+export declare function readSnapshot(loreDirectory: string, buildId: BuildId): BuildSnapshot;
+/**
+ * Pre-flight before a pointer change: the build exists, passed validation, its database
+ * opens, and its integrity check passes.
+ *
+ * Activation is cheap, but activating a corrupt build is not, so the check happens before
+ * the pointer moves rather than at the first request that fails.
+ */
+export declare function assertActivatable(loreDirectory: string, build: BuildSummary): void;
+export { assertBuildId };
+//# sourceMappingURL=builds.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"builds.d.ts","sourceRoot":"","sources":["../../src/services/builds.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,eAAe,EAIhB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EACL,aAAa,EACb,KAAK,OAAO,EACZ,KAAK,YAAY,EAMlB,MAAM,gBAAgB,CAAC;AAExB;;;;;;;GAOG;AAEH,wBAAgB,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,eAAe,CAOrE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAkC1F;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,GAAG,OAAO,CAa9F;AAED,wBAAgB,cAAc,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAE9E;AAED,qFAAqF;AACrF,wBAAgB,YAAY,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,aAAa,CAsGnF;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI,CA4ClF;AAED,OAAO,EAAE,aAAa,EAAE,CAAC"}