@cogenta/cli 0.1.0

package/dist/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":""}

package/dist/bin.js

@@ -0,0 +1,31 @@
+#!/usr/bin/env node
+import process from 'node:process';
+import { run } from './index.js';
+/**
+ * Node prints "ExperimentalWarning: SQLite is an experimental feature" on every
+ * command that opens a database, which is every useful command. It is Node's
+ * notice about its own module, not something a Cogenta user can act on, and it
+ * would train people to ignore warnings — including the ones that matter.
+ *
+ * Only that one warning is dropped. Everything else is re-emitted exactly as
+ * Node would have printed it.
+ */
+process.removeAllListeners('warning');
+process.on('warning', (warning) => {
+    const isSqliteNotice = warning.name === 'ExperimentalWarning' && warning.message.includes('SQLite');
+    if (!isSqliteNotice)
+        process.stderr.write(`${warning.stack ?? warning.message}\n`);
+});
+// Only `serve` reads this; every other command finishes on its own and
+// nothing ever calls `abort()`. Ctrl-C or a process manager's SIGTERM should
+// close the listening socket and the database cleanly rather than dropping
+// whatever request was in flight.
+const shutdown = new AbortController();
+process.once('SIGINT', () => shutdown.abort());
+process.once('SIGTERM', () => shutdown.abort());
+process.exitCode = await run({
+    argv: process.argv.slice(2),
+    isTty: process.stdout.isTTY === true,
+    signal: shutdown.signal,
+});
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA,OAAO,OAAO,MAAM,cAAc,CAAA;AAClC,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAA;AAEhC;;;;;;;;GAQG;AACH,OAAO,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAA;AACrC,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE;IAChC,MAAM,cAAc,GAClB,OAAO,CAAC,IAAI,KAAK,qBAAqB,IAAI,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;IAE9E,IAAI,CAAC,cAAc;QAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,OAAO,IAAI,CAAC,CAAA;AACpF,CAAC,CAAC,CAAA;AAEF,uEAAuE;AACvE,6EAA6E;AAC7E,2EAA2E;AAC3E,kCAAkC;AAClC,MAAM,QAAQ,GAAG,IAAI,eAAe,EAAE,CAAA;AACtC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;AAC9C,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;AAE/C,OAAO,CAAC,QAAQ,GAAG,MAAM,GAAG,CAAC;IAC3B,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAC3B,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,KAAK,IAAI;IACpC,MAAM,EAAE,QAAQ,CAAC,MAAM;CACxB,CAAC,CAAA"}

package/dist/commands/doctor.d.ts

@@ -0,0 +1,45 @@
+import { type DriverTier, type Logger } from '@cogenta/core';
+import type { Output } from '../output.js';
+export interface DoctorCheck {
+    readonly need: string;
+    readonly status: 'ok' | 'degraded' | 'down';
+    readonly driver: string;
+    readonly tier: DriverTier;
+    readonly reason: string;
+    readonly message: string | undefined;
+    readonly skipped: readonly {
+        driver: string;
+        tier: DriverTier;
+        reason: string;
+    }[];
+}
+export interface DoctorReport {
+    readonly node: string;
+    readonly platform: string;
+    readonly arch: string;
+    readonly configPath: string | null;
+    readonly site: {
+        name: string;
+        url: string;
+        locales: readonly string[];
+    } | undefined;
+    readonly checks: readonly DoctorCheck[];
+    readonly notes: readonly string[];
+    readonly problems: readonly string[];
+}
+export interface DoctorOptions {
+    readonly cwd?: string;
+    readonly env?: Record<string, string | undefined>;
+    readonly logger?: Logger;
+}
+/**
+ * Diagnoses an install: which driver is running for each need, why that one, and
+ * what it costs.
+ *
+ * "Why" is not decoration. The registry can silently fall back from Redis to the
+ * filesystem, and an operator who cannot see that has a site that is slower than
+ * they think for a reason nothing told them.
+ */
+export declare function runDoctor(options?: DoctorOptions): Promise<DoctorReport>;
+export declare function formatDoctorReport(report: DoctorReport, out: Output): void;
+//# sourceMappingURL=doctor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AACA,OAAO,EAOL,KAAK,UAAU,EAEf,KAAK,MAAM,EAEZ,MAAM,eAAe,CAAA;AACtB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAE1C,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,IAAI,GAAG,UAAU,GAAG,MAAM,CAAA;IAC3C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;IACpC,QAAQ,CAAC,OAAO,EAAE,SAAS;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,UAAU,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAClF;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IAClC,QAAQ,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,GAAG,SAAS,CAAA;IACpF,QAAQ,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAA;IACvC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;CACrC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;IACjD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB;AASD;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,CA6GlF;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAsC1E"}

package/dist/commands/doctor.js

@@ -0,0 +1,147 @@
+import process from 'node:process';
+import { createCacheRegistry, createDatabaseRegistry, createLogger, createStorageRegistry, isCogentaError, loadConfig, } from '@cogenta/core';
+function describe(error) {
+    if (isCogentaError(error)) {
+        return error.hint === undefined ? error.message : `${error.message}\n${error.hint}`;
+    }
+    return error instanceof Error ? error.message : String(error);
+}
+/**
+ * Diagnoses an install: which driver is running for each need, why that one, and
+ * what it costs.
+ *
+ * "Why" is not decoration. The registry can silently fall back from Redis to the
+ * filesystem, and an operator who cannot see that has a site that is slower than
+ * they think for a reason nothing told them.
+ */
+export async function runDoctor(options = {}) {
+    const env = options.env ?? process.env;
+    const checks = [];
+    const notes = [];
+    const problems = [];
+    const base = {
+        node: process.versions.node,
+        platform: process.platform,
+        arch: process.arch,
+    };
+    let config;
+    let configPath = null;
+    try {
+        const loaded = await loadConfig({
+            ...(options.cwd === undefined ? {} : { cwd: options.cwd }),
+            env,
+        });
+        config = loaded.config;
+        configPath = loaded.path;
+    }
+    catch (error) {
+        return {
+            ...base,
+            configPath: null,
+            site: undefined,
+            checks: [],
+            notes: [],
+            problems: [describe(error)],
+        };
+    }
+    if (configPath === null) {
+        notes.push('No cogenta.config file found. The configuration came from the environment.');
+    }
+    // Silent unless the caller asks otherwise. A human report on stdout must not
+    // be interleaved with NDJSON: piping doctor into a file should give something
+    // a person can read, and `--verbose` sends the structured lines to stderr.
+    const registryOptions = { logger: options.logger ?? createLogger({ level: 'silent' }) };
+    /** Selects a driver and turns the outcome — success or failure — into a check. */
+    const check = async (need, select) => {
+        let selection;
+        try {
+            selection = await select();
+            const health = await selection.health();
+            checks.push({
+                need,
+                status: health.status,
+                driver: selection.driver,
+                tier: selection.tier,
+                reason: selection.requested ? 'named in the configuration' : selection.reason,
+                message: health.message,
+                skipped: selection.skipped,
+            });
+        }
+        catch (error) {
+            problems.push(`${need}: ${describe(error)}`);
+        }
+        finally {
+            await selection?.dispose();
+        }
+    };
+    await check('database', () => createDatabaseRegistry(registryOptions).select(config.database));
+    await check('cache', () => createCacheRegistry(registryOptions).select(config.cache));
+    await check('storage', () => createStorageRegistry(registryOptions).select(config.storage));
+    // Rule R2, stated out loud rather than left to be discovered: no provider is a
+    // supported configuration, not a broken one.
+    notes.push(config.llm === undefined
+        ? 'No LLM provider configured. Everything works except the agents.'
+        : `LLM provider: ${config.llm.provider} (${config.llm.model}).${config.llm.apiKey === undefined
+            ? ' No API key in the environment, so the agents will not run.'
+            : ''}`);
+    if (config.database.driver === 'sqlite') {
+        notes.push('SQLite: one machine, no vector index. Fine for a single site, not for a fleet.');
+    }
+    if (config.storage.driver !== 's3' && env['COGENTA_STORAGE_SIGNING_KEY'] === undefined) {
+        notes.push('COGENTA_STORAGE_SIGNING_KEY is not set, so signed media URLs stop working after a restart.');
+    }
+    const [major, minor] = process.versions.node.split('.').map(Number);
+    if (major !== undefined && minor !== undefined && (major < 22 || (major === 22 && minor < 13))) {
+        problems.push(`Node ${process.versions.node} has no built-in SQLite. Upgrade to 22.13 or later, or use Postgres or MySQL.`);
+    }
+    return {
+        ...base,
+        configPath,
+        site: { name: config.site.name, url: config.site.url, locales: config.site.locales },
+        checks,
+        notes,
+        problems,
+    };
+}
+export function formatDoctorReport(report, out) {
+    out.heading('Environment');
+    out.ok(`Node ${report.node} on ${report.platform} ${report.arch}`);
+    out.ok(report.configPath ?? 'configuration from the environment');
+    if (report.site !== undefined) {
+        out.heading('Site');
+        out.ok(`${report.site.name} — ${report.site.url}`);
+        out.detail(`locales: ${report.site.locales.join(', ')}`);
+    }
+    if (report.checks.length > 0) {
+        out.heading('Drivers');
+        for (const item of report.checks) {
+            const label = `${item.need}: ${item.driver} (${item.tier}) — ${item.reason}`;
+            if (item.status === 'ok')
+                out.ok(label);
+            else if (item.status === 'degraded')
+                out.warn(label);
+            else
+                out.bad(label);
+            if (item.message !== undefined)
+                out.detail(item.message);
+            for (const skipped of item.skipped)
+                out.detail(`${skipped.driver}: ${skipped.reason}`);
+        }
+    }
+    if (report.notes.length > 0) {
+        out.heading('Notes');
+        for (const note of report.notes)
+            out.warn(note);
+    }
+    if (report.problems.length > 0) {
+        out.heading('Problems');
+        for (const problem of report.problems)
+            out.bad(problem);
+    }
+    out.line();
+    if (report.problems.length === 0)
+        out.line('Nothing is broken.');
+    else
+        out.line(`${report.problems.length} problem(s) to fix.`);
+}
+//# 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/generate.d.ts

@@ -0,0 +1,19 @@
+import { type Logger } from '@cogenta/core';
+import type { Output, Writer } from '../output.js';
+export type GenerateSubcommand = 'types';
+export interface GenerateOptions {
+    readonly subcommand: string | undefined;
+    readonly cwd?: string;
+    readonly env?: Record<string, string | undefined>;
+    readonly logger?: Logger;
+    readonly out: Output;
+    readonly stderr: Writer;
+    /** Overrides the default `.cogenta/types/schema.d.ts` output path. */
+    readonly outFile?: string;
+}
+/**
+ * `cogenta generate` — only `types` is real (see USAGE). 0 written. 1 the
+ * schema failed to load. 2 the command line was wrong.
+ */
+export declare function runGenerate(options: GenerateOptions): Promise<number>;
+//# sourceMappingURL=generate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../src/commands/generate.ts"],"names":[],"mappings":"AAGA,OAAO,EAAkB,KAAK,MAAM,EAAc,MAAM,eAAe,CAAA;AAEvE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAGlD,MAAM,MAAM,kBAAkB,GAAG,OAAO,CAAA;AAExC,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAA;IACvC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;IACjD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,sEAAsE;IACtE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAC1B;AAgBD;;;GAGG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAqC3E"}

package/dist/commands/generate.js

@@ -0,0 +1,60 @@
+import { mkdir, writeFile } from 'node:fs/promises';
+import { dirname, join, resolve as resolvePath } from 'node:path';
+import process from 'node:process';
+import { isCogentaError, loadConfig } from '@cogenta/core';
+import { renderTypeDeclarations } from '@cogenta/schema';
+import { loadCollections } from './serve.js';
+const DEFAULT_OUTPUT = join('.cogenta', 'types', 'schema.d.ts');
+const USAGE = `Usage
+  cogenta generate types [--out <file>]
+
+Writes TypeScript declarations for every collection in cogenta.schema.(m)js —
+the same generator "cogenta doctor"'s type checks rely on being accurate.
+Defaults to ${DEFAULT_OUTPUT}, relative to the project root.
+
+"generate schema" and "generate migrations" do not exist yet: nothing in this
+codebase can diff a schema into a migration file today — migrations are
+still hand-written (see the write-migration skill). Only "types" is real.
+`;
+/**
+ * `cogenta generate` — only `types` is real (see USAGE). 0 written. 1 the
+ * schema failed to load. 2 the command line was wrong.
+ */
+export async function runGenerate(options) {
+    const { out, stderr } = options;
+    const env = options.env ?? process.env;
+    if (options.subcommand === undefined) {
+        stderr(`cogenta generate needs a subcommand.\n\n${USAGE}`);
+        return 2;
+    }
+    if (options.subcommand !== 'types') {
+        stderr(`Unknown subcommand "${options.subcommand}". Only "types" exists today.\n\n${USAGE}`);
+        return 2;
+    }
+    const loaded = await loadConfig({
+        ...(options.cwd === undefined ? {} : { cwd: options.cwd }),
+        env,
+    });
+    const projectRoot = loaded.path === null ? resolvePath(options.cwd ?? process.cwd()) : dirname(loaded.path);
+    try {
+        const collections = await loadCollections(projectRoot);
+        const declarations = renderTypeDeclarations(collections);
+        const outFile = options.outFile ?? join(projectRoot, DEFAULT_OUTPUT);
+        await mkdir(dirname(outFile), { recursive: true });
+        await writeFile(outFile, declarations, 'utf8');
+        out.ok(`Wrote types for ${collections.length} collection(s) to ${outFile}`);
+        return 0;
+    }
+    catch (error) {
+        if (isCogentaError(error)) {
+            stderr(`${error.code}: ${error.message}\n`);
+            if (error.hint !== undefined)
+                stderr(`${error.hint}\n`);
+        }
+        else {
+            stderr(`${error instanceof Error ? error.stack : String(error)}\n`);
+        }
+        return 1;
+    }
+}
+//# sourceMappingURL=generate.js.map

package/dist/commands/generate.js.map

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

package/dist/commands/import.d.ts

@@ -0,0 +1,22 @@
+import { type Logger } from '@cogenta/core';
+import type { Output, Writer } from '../output.js';
+export type ImportSubcommand = 'wordpress';
+export interface ImportOptions {
+    readonly subcommand: string | undefined;
+    readonly file: string | undefined;
+    readonly cwd?: string;
+    readonly env?: Record<string, string | undefined>;
+    readonly logger?: Logger;
+    readonly out: Output;
+    readonly stderr: Writer;
+}
+/**
+ * Runs one `import` subcommand and returns its exit code.
+ *
+ * 0 the import ran, even with items reported as unconverted (that report *is*
+ * success — see `formatConversionReport`'s own framing). 1 the file could not
+ * be read or parsed at all, or the database refused. 2 the command line was
+ * wrong.
+ */
+export declare function runImport(options: ImportOptions): Promise<number>;
+//# sourceMappingURL=import.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"import.d.ts","sourceRoot":"","sources":["../../src/commands/import.ts"],"names":[],"mappings":"AAEA,OAAO,EAML,KAAK,MAAM,EAGZ,MAAM,eAAe,CAAA;AAEtB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAElD,MAAM,MAAM,gBAAgB,GAAG,WAAW,CAAA;AAE1C,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAA;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAA;IACjC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;IACjD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB;AA+BD;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CA6CvE"}

package/dist/commands/import.js

@@ -0,0 +1,77 @@
+import { readFile } from 'node:fs/promises';
+import process from 'node:process';
+import { createDatabaseRegistry, createLogger, createStorageRegistry, isCogentaError, loadConfig, } from '@cogenta/core';
+import { formatConversionReport, importWordPress } from '@cogenta/import';
+const USAGE = `Usage
+  cogenta import wordpress <file.xml>
+
+Imports a WordPress "Export All Content" WXR file: posts, pages, categories,
+tags, media, authors, comments and redirects. Prints a report of what could
+not be converted — a partial import with a report is the expected outcome for
+a real-world export, not a failure.
+`;
+async function withSite(options, logger, use) {
+    const env = options.env ?? process.env;
+    const loaded = await loadConfig({
+        ...(options.cwd === undefined ? {} : { cwd: options.cwd }),
+        env,
+    });
+    const dbSelection = await createDatabaseRegistry({ logger }).select(loaded.config.database);
+    const storageSelection = await createStorageRegistry({ logger }).select(loaded.config.storage);
+    try {
+        return await use(dbSelection.instance, storageSelection.instance);
+    }
+    finally {
+        await dbSelection.dispose();
+    }
+}
+/**
+ * Runs one `import` subcommand and returns its exit code.
+ *
+ * 0 the import ran, even with items reported as unconverted (that report *is*
+ * success — see `formatConversionReport`'s own framing). 1 the file could not
+ * be read or parsed at all, or the database refused. 2 the command line was
+ * wrong.
+ */
+export async function runImport(options) {
+    const { out, stderr } = options;
+    if (options.subcommand === undefined) {
+        stderr(`cogenta import needs a subcommand.\n\n${USAGE}`);
+        return 2;
+    }
+    if (options.subcommand !== 'wordpress') {
+        stderr(`Unknown subcommand "${options.subcommand}".\n\n${USAGE}`);
+        return 2;
+    }
+    if (options.file === undefined || options.file.trim().length === 0) {
+        stderr(`A file path is required.\n\n${USAGE}`);
+        return 2;
+    }
+    const logger = options.logger ?? createLogger({ level: 'silent' });
+    let xml;
+    try {
+        xml = await readFile(options.file, 'utf8');
+    }
+    catch (error) {
+        stderr(`Could not read "${options.file}": ${error instanceof Error ? error.message : String(error)}\n`);
+        return 1;
+    }
+    try {
+        const report = await withSite(options, logger, (db, storage) => importWordPress(xml, { db, storage }));
+        out.heading('WordPress import');
+        out.line(formatConversionReport(report));
+        return 0;
+    }
+    catch (error) {
+        if (isCogentaError(error)) {
+            stderr(`${error.code}: ${error.message}\n`);
+            if (error.hint !== undefined)
+                stderr(`${error.hint}\n`);
+        }
+        else {
+            stderr(`${error instanceof Error ? error.stack : String(error)}\n`);
+        }
+        return 1;
+    }
+}
+//# sourceMappingURL=import.js.map

package/dist/commands/import.js.map

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

package/dist/commands/migrate.d.ts

@@ -0,0 +1,38 @@
+import { type Logger, type Migration } from '@cogenta/core';
+import type { Output, Writer } from '../output.js';
+/** The directory a project keeps its migrations in, relative to the config file. */
+export declare const MIGRATIONS_DIRECTORY = "migrations";
+export type MigrateSubcommand = 'status' | 'up' | 'down';
+export interface MigrateOptions {
+    readonly subcommand: string | undefined;
+    readonly cwd?: string;
+    readonly env?: Record<string, string | undefined>;
+    readonly logger?: Logger;
+    /** Where the human-readable report goes. */
+    readonly out: Output;
+    /** Where refusals and failures go, so a piped report stays clean. */
+    readonly stderr: Writer;
+    readonly to?: string;
+    readonly steps?: number;
+    readonly confirmDestructive?: boolean;
+    readonly backupVerified?: boolean;
+    /** Overrides the `migrations/` directory next to the configuration file. */
+    readonly directory?: string;
+}
+/**
+ * Loads every migration from a directory, in file-name order.
+ *
+ * A missing directory is not an error. L0 ships no business schema at all, so a
+ * fresh project legitimately has nothing to migrate, and failing there would
+ * make `migrate status` unusable exactly when an operator wants to check.
+ */
+export declare function loadMigrations(directory: string): Promise<Migration[]>;
+/**
+ * Runs one `migrate` subcommand and returns its exit code.
+ *
+ * 0 succeeded, 1 the database or a migration said no, 2 the command line was
+ * wrong. Nothing calls `process.exit` and nothing writes to a stream directly,
+ * so a test drives this exactly as a shell does.
+ */
+export declare function runMigrate(options: MigrateOptions): Promise<number>;
+//# sourceMappingURL=migrate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../src/commands/migrate.ts"],"names":[],"mappings":"AAKA,OAAO,EAOL,KAAK,MAAM,EAEX,KAAK,SAAS,EAIf,MAAM,eAAe,CAAA;AACtB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAElD,oFAAoF;AACpF,eAAO,MAAM,oBAAoB,eAAe,CAAA;AAShD,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,IAAI,GAAG,MAAM,CAAA;AAExD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAA;IACvC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;IACjD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,4CAA4C;IAC5C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,qEAAqE;IACrE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAA;IACrC,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAA;IACjC,4EAA4E;IAC5E,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC5B;AAmED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CA4C5E;AAwFD;;;;;;GAMG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CA0FzE"}