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

package/dist/services/builds.js

@@ -0,0 +1,184 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { assertIdentifier, decodeValue, LocalStateStore, openReadOnly, stateMigrationsDirectory, tableLocator, } from '@lorepack/backend-local';
+import { assertBuildId, buildManifestSchema, count, LoreError, } 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 function openStateStore(loreDirectory) {
+    if (!existsSync(join(loreDirectory, 'state.sqlite'))) {
+        throw new LoreError('LORE_E_BUILD_NOT_FOUND', 'This project has no builds yet.', {
+            remediation: 'Run `lorepack build` to create the first one.',
+        });
+    }
+    return LocalStateStore.open(loreDirectory, stateMigrationsDirectory());
+}
+/**
+ * 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 function resolveBuildId(builds, reference) {
+    const needle = reference.trim();
+    if (needle === '') {
+        throw new LoreError('LORE_E_INVALID_ARGUMENT', 'No build was named.', {
+            remediation: 'Pass a build id, or run `lorepack builds` to list them.',
+        });
+    }
+    const exact = builds.find((build) => build.buildId === needle);
+    if (exact !== undefined)
+        return exact.buildId;
+    const matches = builds.filter((build) => build.buildId.startsWith(needle));
+    if (matches.length === 1)
+        return matches[0].buildId;
+    if (matches.length === 0) {
+        throw new LoreError('LORE_E_BUILD_NOT_FOUND', `No build matches ${needle}.`, {
+            remediation: builds.length === 0
+                ? 'Run `lorepack build` to create one.'
+                : `Available builds:\n${builds.map((build) => `  ${build.buildId}`).join('\n')}`,
+            subject: needle,
+        });
+    }
+    throw new LoreError('LORE_E_INVALID_ARGUMENT', `${needle} matches ${count(matches.length, 'build')}.`, {
+        remediation: `Use a longer prefix. Candidates:\n${matches
+            .map((build) => `  ${build.buildId}`)
+            .join('\n')}`,
+        subject: needle,
+    });
+}
+/**
+ * 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 function previousBuild(builds, active) {
+    const candidates = builds.filter((build) => build.buildId !== active && (build.state === 'verified' || build.state === 'active'));
+    const previous = candidates[0];
+    if (previous === undefined) {
+        throw new LoreError('LORE_E_BUILD_NOT_FOUND', 'There is no earlier verified build to return to.', { remediation: 'Run `lorepack builds` to see the history.' });
+    }
+    return previous.buildId;
+}
+export function buildDirectory(loreDirectory, buildId) {
+    return join(loreDirectory, 'builds', buildId);
+}
+/** Reads the canonical records a diff compares, straight out of the sealed build. */
+export function readSnapshot(loreDirectory, buildId) {
+    const directory = buildDirectory(loreDirectory, buildId);
+    const manifestPath = join(directory, 'manifest.json');
+    if (!existsSync(manifestPath)) {
+        throw new LoreError('LORE_E_BUILD_NOT_FOUND', `Build ${buildId} has no manifest.`, {
+            remediation: 'The build directory is incomplete. Rebuild, or activate another build.',
+            subject: buildId,
+        });
+    }
+    const manifest = buildManifestSchema.parse(JSON.parse(readFileSync(manifestPath, 'utf8')));
+    const db = openReadOnly(join(directory, 'context.sqlite'));
+    try {
+        const artifacts = db
+            .prepare('SELECT id, relative_path, content_hash, status, authority FROM artifacts ORDER BY id')
+            .all();
+        const supersessions = db
+            .prepare('SELECT artifact_id, superseded_id FROM supersessions')
+            .all();
+        const superseded = new Map();
+        for (const row of supersessions) {
+            const list = superseded.get(row.artifact_id) ?? [];
+            list.push(row.superseded_id);
+            superseded.set(row.artifact_id, list);
+        }
+        const chunks = db.prepare('SELECT id, revision_hash FROM chunks ORDER BY id').all();
+        const tableRows = db
+            .prepare('SELECT id, artifact_id, name, sheet, sql_name, row_count, relative_path, line_start, line_end, cell_range FROM tables ORDER BY id')
+            .all();
+        const tables = tableRows.map((table) => {
+            const columns = db
+                .prepare('SELECT ordinal, name, sql_name, type FROM table_columns WHERE table_id = ? ORDER BY ordinal')
+                .all(table.id);
+            const physical = assertIdentifier(table.sql_name);
+            const rows = db.prepare(`SELECT * FROM ${physical}`).all();
+            return {
+                tableId: table.id,
+                name: table.name,
+                rows: table.row_count,
+                columns: columns.map((column) => column.name),
+                locator: tableLocator(table),
+                cells: rows.flatMap((row, rowIndex) => columns.map((column) => ({
+                    row: rowIndex,
+                    column: column.name,
+                    value: decodeValue(row[column.sql_name], column.type),
+                }))),
+            };
+        });
+        return {
+            buildId,
+            formatVersion: manifest.formatVersion,
+            schemaVersion: manifest.schemaVersion,
+            compilerVersion: manifest.compilerVersion,
+            configurationHash: manifest.configurationHash,
+            capabilities: manifest.capabilities,
+            canonicalRoots: manifest.canonicalRoots,
+            artifacts: artifacts.map((row) => ({
+                id: row.id,
+                relativePath: row.relative_path,
+                contentHash: row.content_hash,
+                status: row.status,
+                authority: Number(row.authority),
+                supersedes: superseded.get(row.id) ?? [],
+            })),
+            chunks: chunks.map((row) => ({ id: row.id, revisionHash: row.revision_hash })),
+            tables,
+        };
+    }
+    finally {
+        db.close();
+    }
+}
+/**
+ * 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 function assertActivatable(loreDirectory, build) {
+    if (build.state !== 'verified' && build.state !== 'active') {
+        throw new LoreError('LORE_E_BUILD_VALIDATION', `Build ${build.buildId} is ${build.state}, and only a verified build may be activated.`, {
+            remediation: 'Activate a build that passed validation, or run `lorepack build` again.',
+            subject: build.buildId,
+        });
+    }
+    const databasePath = join(buildDirectory(loreDirectory, build.buildId), 'context.sqlite');
+    if (!existsSync(databasePath)) {
+        throw new LoreError('LORE_E_BUILD_NOT_FOUND', `Build ${build.buildId} is recorded but its files are missing.`, {
+            remediation: 'Run `lorepack build` to recreate it. The active build is unchanged.',
+            subject: build.buildId,
+        });
+    }
+    const db = openReadOnly(databasePath);
+    try {
+        const rows = db.prepare('PRAGMA integrity_check').all();
+        const problems = rows
+            .map((row) => row.integrity_check ?? '')
+            .filter((value) => value !== '' && value !== 'ok');
+        if (problems.length > 0) {
+            throw new LoreError('LORE_E_OBJECT_CORRUPT', `Build ${build.buildId} failed its integrity check: ${problems.join('; ')}`, {
+                remediation: 'Run `lorepack build` to produce a fresh build. The active build is unchanged.',
+                subject: build.buildId,
+            });
+        }
+    }
+    finally {
+        db.close();
+    }
+}
+export { assertBuildId };
+//# sourceMappingURL=builds.js.map

package/dist/services/builds.js.map

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

package/dist/services/cancellation.d.ts

@@ -0,0 +1,27 @@
+/**
+ * A cancellation checkpoint: give the process a chance to hear the signal, then honour it.
+ *
+ * The yield is the load-bearing half, and its absence was #146.
+ *
+ * Node delivers signals from the event loop, but a build stage can run without ever
+ * reaching it. `await` only suspends until a promise settles, and every promise awaited in
+ * the parse loop is settled already: `FileObjectStore` is asynchronous in signature and
+ * synchronous inside. The whole stage therefore runs as one unbroken chain of microtasks,
+ * the loop is never reached, the SIGINT handler never runs, and `signal.aborted` stays
+ * false however often it is read. The checkpoints were correct and unreachable, which is
+ * why a test that set the flag itself passed while Ctrl-C did nothing at all.
+ *
+ * `setImmediate` rather than `queueMicrotask`: only a full turn of the loop lets libuv
+ * deliver a pending signal. It costs microseconds against work measured in milliseconds per
+ * artifact, and a 500 document corpus builds no slower with it than without.
+ *
+ * Cancellation is therefore granular to the checkpoints, not to the instant: a signal that
+ * arrives inside one long synchronous call, such as writing the catalog, is honoured at the
+ * next checkpoint rather than immediately. What the guarantee promises is that `builds/`
+ * and the active pointer are unchanged, and a checkpoint before every write is enough for
+ * that.
+ */
+export declare function checkpoint(signal: AbortSignal | undefined, state?: {
+    readonly hasActiveBuild?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=cancellation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cancellation.d.ts","sourceRoot":"","sources":["../../src/services/cancellation.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,KAAK,GAAE;IAAE,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAA;CAAO,GAChD,OAAO,CAAC,IAAI,CAAC,CAcf"}

package/dist/services/cancellation.js

@@ -0,0 +1,41 @@
+import { LoreError } from '@lorepack/core';
+/**
+ * A cancellation checkpoint: give the process a chance to hear the signal, then honour it.
+ *
+ * The yield is the load-bearing half, and its absence was #146.
+ *
+ * Node delivers signals from the event loop, but a build stage can run without ever
+ * reaching it. `await` only suspends until a promise settles, and every promise awaited in
+ * the parse loop is settled already: `FileObjectStore` is asynchronous in signature and
+ * synchronous inside. The whole stage therefore runs as one unbroken chain of microtasks,
+ * the loop is never reached, the SIGINT handler never runs, and `signal.aborted` stays
+ * false however often it is read. The checkpoints were correct and unreachable, which is
+ * why a test that set the flag itself passed while Ctrl-C did nothing at all.
+ *
+ * `setImmediate` rather than `queueMicrotask`: only a full turn of the loop lets libuv
+ * deliver a pending signal. It costs microseconds against work measured in milliseconds per
+ * artifact, and a 500 document corpus builds no slower with it than without.
+ *
+ * Cancellation is therefore granular to the checkpoints, not to the instant: a signal that
+ * arrives inside one long synchronous call, such as writing the catalog, is honoured at the
+ * next checkpoint rather than immediately. What the guarantee promises is that `builds/`
+ * and the active pointer are unchanged, and a checkpoint before every write is enough for
+ * that.
+ */
+export async function checkpoint(signal, state = {}) {
+    if (signal === undefined)
+        return;
+    await new Promise((resolve) => {
+        setImmediate(resolve);
+    });
+    if (!signal.aborted)
+        return;
+    throw new LoreError('LORE_E_CANCELLED', 'The build was cancelled.', {
+        // The first build in a project is the most likely one to be interrupted, and it is
+        // exactly the case where "the previously active build is still serving" is false (#168).
+        remediation: state.hasActiveBuild === true
+            ? 'Nothing was changed. The previously active build is still serving.'
+            : 'Nothing was changed. This project still has no build.',
+    });
+}
+//# sourceMappingURL=cancellation.js.map

package/dist/services/cancellation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cancellation.js","sourceRoot":"","sources":["../../src/services/cancellation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,MAA+B,EAC/B,KAAK,GAA0C,EAAE;IAEjD,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO;IACjC,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC5B,YAAY,CAAC,OAAO,CAAC,CAAC;IACxB,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO;IAC5B,MAAM,IAAI,SAAS,CAAC,kBAAkB,EAAE,0BAA0B,EAAE;QAClE,mFAAmF;QACnF,yFAAyF;QACzF,WAAW,EACT,KAAK,CAAC,cAAc,KAAK,IAAI;YAC3B,CAAC,CAAC,oEAAoE;YACtE,CAAC,CAAC,uDAAuD;KAC9D,CAAC,CAAC;AACL,CAAC"}

package/dist/services/cloudflare-target.d.ts

@@ -0,0 +1,38 @@
+import { type DeploymentTarget } from '@lorepack/core';
+import { type D1CatalogDatabaseLike, type D1DatabaseLike, type D1QueryDatabaseLike, type ProjectionMigrationDatabaseLike, type R2BucketLike } from '@lorepack/deploy-cloudflare';
+import { type CloudflareTargetAdapter, readCloudflareTargetReceipt } from '../commands/target.js';
+interface CloudflareDatabaseInfo {
+    readonly name: string;
+}
+export interface ResolvedCloudflareTargetResources {
+    readonly receipt: ReturnType<typeof readCloudflareTargetReceipt>;
+    readonly endpoint: string;
+    readonly catalogDb: ProjectionMigrationDatabaseLike & D1CatalogDatabaseLike & D1QueryDatabaseLike & D1DatabaseLike;
+    readonly objects: R2BucketLike;
+}
+export interface CloudflareResolverAdapter extends CloudflareTargetAdapter {
+    listDatabases(): Promise<readonly CloudflareDatabaseInfo[]>;
+    openCatalogDatabase(name: string): ProjectionMigrationDatabaseLike & D1CatalogDatabaseLike & D1QueryDatabaseLike & D1DatabaseLike;
+    openObjectsBucket(name: string): R2BucketLike;
+}
+export declare function resolveCloudflareTarget(projectRoot: string): Promise<DeploymentTarget>;
+export declare function resolveCloudflareTargetWithAdapter(projectRoot: string, adapter: CloudflareResolverAdapter): Promise<DeploymentTarget>;
+export declare function resolveCloudflareResourcesWithAdapter(projectRoot: string, adapter: CloudflareResolverAdapter): Promise<ResolvedCloudflareTargetResources>;
+export declare function createWranglerDeployAdapter(): CloudflareResolverAdapter;
+export declare function isWranglerD1TransactionControl(query: string): boolean;
+export declare function wranglerD1ExecutionMode(query: string): 'skip' | 'command' | 'file';
+export declare class WranglerD1TransactionBatch {
+    #private;
+    get active(): boolean;
+    begin(): void;
+    stage(sql: string): void;
+    flush(): string | null;
+    commit(): string | null;
+    rollback(): void;
+}
+export declare function renderWranglerSqlBatch(statements: readonly string[]): string;
+export declare function parseWranglerJson(stdout: string): unknown;
+export declare function isWranglerMissingObjectFailure(text: string): boolean;
+export declare function isRetryableWranglerRemoteR2Failure(text: string): boolean;
+export {};
+//# sourceMappingURL=cloudflare-target.d.ts.map

package/dist/services/cloudflare-target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudflare-target.d.ts","sourceRoot":"","sources":["../../src/services/cloudflare-target.ts"],"names":[],"mappings":"AAKA,OAAO,EAAgB,KAAK,gBAAgB,EAAa,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,+BAA+B,EAEpC,KAAK,YAAY,EAClB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,KAAK,uBAAuB,EAG5B,2BAA2B,EAC5B,MAAM,uBAAuB,CAAC;AAiB/B,UAAU,sBAAsB;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC,OAAO,2BAA2B,CAAC,CAAC;IACjE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,+BAA+B,GACjD,qBAAqB,GACrB,mBAAmB,GACnB,cAAc,CAAC;IACjB,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;CAChC;AAED,MAAM,WAAW,yBAA0B,SAAQ,uBAAuB;IACxE,aAAa,IAAI,OAAO,CAAC,SAAS,sBAAsB,EAAE,CAAC,CAAC;IAC5D,mBAAmB,CACjB,IAAI,EAAE,MAAM,GACX,+BAA+B,GAAG,qBAAqB,GAAG,mBAAmB,GAAG,cAAc,CAAC;IAClG,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAAC;CAC/C;AAeD,wBAAsB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAE5F;AAED,wBAAsB,kCAAkC,CACtD,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,gBAAgB,CAAC,CAY3B;AAED,wBAAsB,qCAAqC,CACzD,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,iCAAiC,CAAC,CAoE5C;AAED,wBAAgB,2BAA2B,IAAI,yBAAyB,CA0BvE;AAwFD,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAErE;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAGlF;AAED,qBAAa,0BAA0B;;IAGrC,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,KAAK,IAAI,IAAI,CAEZ;IAED,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAGvB;IAED,KAAK,IAAI,MAAM,GAAG,IAAI,CAKrB;IAED,MAAM,IAAI,MAAM,GAAG,IAAI,CAItB;IAED,QAAQ,IAAI,IAAI,CAEf;CACF;AAED,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAE5E;AAmGD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAQzD;AA4ED,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAMpE;AAED,wBAAgB,kCAAkC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAIxE"}