@rawsql-ts/ztd-cli 0.20.0 → 0.20.2

package/dist/commands/ddl.js

@@ -0,0 +1,145 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_DDL_DIRECTORY = exports.DEFAULT_EXTENSIONS = exports.parseExtensions = exports.collectDirectories = void 0;
+exports.registerDdlCommands = registerDdlCommands;
+const node_path_1 = __importDefault(require("node:path"));
+const diff_1 = require("./diff");
+const genEntities_1 = require("./genEntities");
+const pull_1 = require("./pull");
+const connectionOptions_1 = require("./connectionOptions");
+const options_1 = require("./options");
+const agentCli_1 = require("../utils/agentCli");
+const agentSafety_1 = require("../utils/agentSafety");
+/**
+ * Registers all DDL-related commands (`pull`, `gen-entities`, `diff`) on the top-level CLI program.
+ * @param program - The Commander program instance to extend.
+ */
+function registerDdlCommands(program) {
+    const ddl = program.command('ddl').description('DDL-focused workflows');
+    ddl
+        .command('pull')
+        .description('Inspect schema state from an explicit target database and normalize the pulled DDL')
+        .option('--url <databaseUrl>', 'Explicit target database URL for inspection workflows (preferred over --db-*)')
+        .option('--out <directory>', 'Destination directory for the pulled DDL', options_1.DEFAULT_DDL_DIRECTORY)
+        .option('--db-host <host>', 'Explicit target database host when --url is not used')
+        .option('--db-port <port>', 'Explicit target database port (defaults to 5432)')
+        .option('--db-user <user>', 'Explicit target database user')
+        .option('--db-password <password>', 'Explicit target database password')
+        .option('--db-name <name>', 'Explicit target database name')
+        .option('--pg-dump-path <path>', 'Custom pg_dump executable path')
+        .option('--pg-dump-shell', 'Run the pg_dump path through a shell so wrapper commands like "docker exec <container> pg_dump" can be used')
+        .option('--schema <schema>', 'Schema name to include (repeatable)', options_1.collectValues, [])
+        .option('--table <table>', 'Table spec (schema.table) to include (repeatable)', options_1.collectValues, [])
+        .option('--dry-run', 'Validate pull inputs and normalize the dump without writing files')
+        .option('--json <payload>', 'Pass pull options as a JSON object')
+        .action(async (options) => {
+        var _a, _b, _c;
+        const merged = options.json ? { ...options, ...(0, agentCli_1.parseJsonPayload)(options.json, '--json') } : options;
+        const connection = (0, connectionOptions_1.resolveExplicitCliConnection)(merged);
+        const result = await (0, pull_1.runPullSchema)({
+            url: connection.url,
+            out: (0, agentSafety_1.validateProjectPath)(String((_a = merged.out) !== null && _a !== void 0 ? _a : options_1.DEFAULT_DDL_DIRECTORY), '--out'),
+            pgDumpPath: merged.pgDumpPath,
+            pgDumpShell: Boolean(merged.pgDumpShell),
+            schemas: ((_b = merged.schema) !== null && _b !== void 0 ? _b : []).map((value) => (0, agentSafety_1.validateResourceIdentifier)(String(value), '--schema')),
+            tables: ((_c = merged.table) !== null && _c !== void 0 ? _c : []).map((value) => (0, agentSafety_1.validateResourceIdentifier)(String(value), '--table')),
+            connectionContext: connection.context,
+            dryRun: Boolean(merged.dryRun)
+        });
+        if ((0, agentCli_1.isJsonOutput)()) {
+            (0, agentCli_1.writeCommandEnvelope)('ddl pull', {
+                schemaVersion: 1,
+                dryRun: result.dryRun,
+                outDir: result.outDir,
+                files: result.files.map((file) => ({ schema: file.schema, path: file.filePath, bytes: file.contents.length }))
+            });
+        }
+    });
+    ddl
+        .command('gen-entities')
+        .description('Generate optional entities.ts helpers from the DDL snapshot')
+        .option('--ddl-dir <directory>', 'DDL directory to scan (repeatable)', options_1.collectDirectories, [])
+        .option('--extensions <list>', 'Comma-separated extensions to include', options_1.parseExtensions, options_1.DEFAULT_EXTENSIONS)
+        .option('--out <file>', 'Destination TypeScript file', node_path_1.default.join('src', 'entities.ts'))
+        .option('--dry-run', 'Render entities without writing the destination file')
+        .option('--json <payload>', 'Pass generation options as a JSON object')
+        .action(async (options) => {
+        var _a;
+        const merged = options.json ? { ...options, ...(0, agentCli_1.parseJsonPayload)(options.json, '--json') } : options;
+        const directories = (0, options_1.normalizeDirectoryList)(merged.ddlDir, options_1.DEFAULT_DDL_DIRECTORY);
+        const extensions = (0, options_1.resolveExtensions)(merged.extensions, options_1.DEFAULT_EXTENSIONS);
+        const result = await (0, genEntities_1.runGenerateEntities)({
+            directories,
+            extensions,
+            out: (0, agentSafety_1.validateProjectPath)(String((_a = merged.out) !== null && _a !== void 0 ? _a : node_path_1.default.join('src', 'entities.ts')), '--out'),
+            dryRun: Boolean(merged.dryRun)
+        });
+        if ((0, agentCli_1.isJsonOutput)()) {
+            (0, agentCli_1.writeCommandEnvelope)('ddl gen-entities', {
+                schemaVersion: 1,
+                dryRun: result.dryRun,
+                outFile: result.outFile,
+                tables: result.tables.map((table) => table.name),
+                bytes: result.rendered.length
+            });
+        }
+    });
+    ddl
+        .command('diff')
+        .description('Compare local DDL against an explicit target database for inspection purposes')
+        .option('--ddl-dir <directory>', 'DDL directory to scan (repeatable)', options_1.collectDirectories, [])
+        .option('--extensions <list>', 'Comma-separated extensions to include', options_1.parseExtensions, options_1.DEFAULT_EXTENSIONS)
+        .option('--url <databaseUrl>', 'Explicit target database URL for inspection workflows (preferred over --db-*)')
+        .option('--out <file>', 'Output path for the generated plan file')
+        .option('--db-host <host>', 'Explicit target database host when --url is not used')
+        .option('--db-port <port>', 'Explicit target database port (defaults to 5432)')
+        .option('--db-user <user>', 'Explicit target database user')
+        .option('--db-password <password>', 'Explicit target database password')
+        .option('--db-name <name>', 'Explicit target database name')
+        .option('--pg-dump-path <path>', 'Custom pg_dump executable path')
+        .option('--pg-dump-shell', 'Run the pg_dump path through a shell so wrapper commands like "docker exec <container> pg_dump" can be used')
+        .option('--dry-run', 'Compute the diff plan without writing the patch file')
+        .option('--json <payload>', 'Pass diff options as a JSON object')
+        .action(async (options) => {
+        var _a;
+        const merged = options.json ? { ...options, ...(0, agentCli_1.parseJsonPayload)(options.json, '--json') } : options;
+        const outPath = resolveRequiredProjectPath(merged.out, '--out');
+        const directories = (0, options_1.normalizeDirectoryList)((_a = merged.ddlDir) !== null && _a !== void 0 ? _a : [], options_1.DEFAULT_DDL_DIRECTORY);
+        const extensions = (0, options_1.resolveExtensions)(merged.extensions, options_1.DEFAULT_EXTENSIONS);
+        const connection = (0, connectionOptions_1.resolveExplicitCliConnection)(merged);
+        const result = await (0, diff_1.runDiffSchema)({
+            directories,
+            extensions,
+            url: connection.url,
+            out: outPath,
+            pgDumpPath: merged.pgDumpPath,
+            pgDumpShell: Boolean(merged.pgDumpShell),
+            connectionContext: connection.context,
+            dryRun: Boolean(merged.dryRun)
+        });
+        if ((0, agentCli_1.isJsonOutput)()) {
+            (0, agentCli_1.writeCommandEnvelope)('ddl diff', {
+                schemaVersion: 1,
+                dryRun: result.dryRun,
+                outFile: result.outFile,
+                hasChanges: result.hasChanges,
+                patchBytes: result.patch.length
+            });
+        }
+    });
+}
+var options_2 = require("./options");
+Object.defineProperty(exports, "collectDirectories", { enumerable: true, get: function () { return options_2.collectDirectories; } });
+Object.defineProperty(exports, "parseExtensions", { enumerable: true, get: function () { return options_2.parseExtensions; } });
+Object.defineProperty(exports, "DEFAULT_EXTENSIONS", { enumerable: true, get: function () { return options_2.DEFAULT_EXTENSIONS; } });
+Object.defineProperty(exports, "DEFAULT_DDL_DIRECTORY", { enumerable: true, get: function () { return options_2.DEFAULT_DDL_DIRECTORY; } });
+function resolveRequiredProjectPath(value, label) {
+    if (typeof value !== 'string' || value.trim().length === 0) {
+        throw new Error(`${label} is required (either via ${label} or --json {"${label.slice(2)}":"..."}).`);
+    }
+    return (0, agentSafety_1.validateProjectPath)(value, label);
+}
+//# sourceMappingURL=ddl.js.map

package/dist/commands/ddl.js.map

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

package/dist/commands/describe.d.ts

@@ -0,0 +1,23 @@
+import { Command } from 'commander';
+interface CommandFlagDescriptor {
+    name: string;
+    description: string;
+    defaultValue?: string | boolean;
+}
+interface CommandDescriptor {
+    name: string;
+    summary: string;
+    writesFiles: boolean;
+    supportsDryRun: boolean;
+    supportsJsonPayload: boolean;
+    supportsDescribeOutput?: boolean;
+    output?: {
+        stdout?: string;
+        files?: string[];
+    };
+    exitCodes: Record<string, string>;
+    flags: CommandFlagDescriptor[];
+}
+export declare function getDescribeCommandDescriptors(): readonly CommandDescriptor[];
+export declare function registerDescribeCommand(program: Command): void;
+export {};

package/dist/commands/describe.js

@@ -0,0 +1,399 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDescribeCommandDescriptors = getDescribeCommandDescriptors;
+exports.registerDescribeCommand = registerDescribeCommand;
+const agentCli_1 = require("../utils/agentCli");
+const COMMANDS = [
+    {
+        name: 'init',
+        summary: 'Scaffold a ZTD project with templates, config, and optional demo assets.',
+        writesFiles: true,
+        supportsDryRun: true,
+        supportsJsonPayload: true,
+        output: {
+            stdout: 'Human summary in text mode, JSON envelope in global json mode.',
+            files: ['ztd.config.json', 'ztd/ddl/*.sql', 'tests/generated/*', '.ztd/agents/*', 'CONTEXT.md']
+        },
+        exitCodes: {
+            '0': 'Scaffold completed or dry-run plan emitted.',
+            '1': 'Validation or filesystem error.'
+        },
+        flags: [
+            { name: '--dry-run', description: 'Validate inputs and emit the planned scaffold without writing files.' },
+            { name: '--json', description: 'Pass init options as a JSON object.' },
+            { name: '--yes', description: 'Accept defaults and overwrite existing files.' }
+        ]
+    },
+    {
+        name: 'agents install',
+        summary: 'Install visible AGENTS.md files from the managed templates.',
+        writesFiles: true,
+        supportsDryRun: false,
+        supportsJsonPayload: false,
+        output: {
+            stdout: 'Human install summary in text mode, JSON envelope in global json mode.',
+            files: ['AGENTS.md or AGENTS_ztd.md', 'ztd/AGENTS.md', 'src/**/AGENTS.md', 'tests/**/AGENTS.md']
+        },
+        exitCodes: {
+            '0': 'Visible AGENTS installation completed or was already up to date.',
+            '1': 'Filesystem or validation error.'
+        },
+        flags: []
+    },
+    {
+        name: 'agents status',
+        summary: 'Report managed AGENTS guidance state and drift signals.',
+        writesFiles: false,
+        supportsDryRun: false,
+        supportsJsonPayload: false,
+        output: {
+            stdout: 'Human status report in text mode, JSON envelope in global json mode.'
+        },
+        exitCodes: {
+            '0': 'Status emitted.',
+            '1': 'Filesystem or parsing error.'
+        },
+        flags: []
+    },
+    {
+        name: 'ztd-config',
+        summary: 'Generate TestRowMap and layout metadata from local DDL.',
+        writesFiles: true,
+        supportsDryRun: true,
+        supportsJsonPayload: true,
+        output: {
+            stdout: 'Status or JSON envelope.',
+            files: ['tests/generated/ztd-row-map.generated.ts', 'tests/generated/ztd-layout.generated.ts']
+        },
+        exitCodes: {
+            '0': 'Generation completed or dry-run plan emitted.',
+            '1': 'Generation failed.'
+        },
+        flags: [
+            { name: '--dry-run', description: 'Render and validate generation without writing files.' },
+            { name: '--json', description: 'Pass ztd-config options as a JSON object.' },
+            { name: '--watch', description: 'Watch DDL files and regenerate on change.', defaultValue: false }
+        ]
+    },
+    {
+        name: 'model-gen',
+        summary: 'Probe SQL metadata and generate QuerySpec scaffolding.',
+        writesFiles: true,
+        supportsDryRun: true,
+        supportsJsonPayload: true,
+        supportsDescribeOutput: true,
+        output: {
+            stdout: 'Generated TypeScript when --out is omitted; JSON envelope in global json mode.',
+            files: ['Specified --out file when present']
+        },
+        exitCodes: {
+            '0': 'Generation completed, dry-run plan emitted, or output contract described.',
+            '1': 'Validation or probing failed.'
+        },
+        flags: [
+            { name: '--dry-run', description: 'Validate probing and show the planned output file without writing it.' },
+            { name: '--json', description: 'Pass model-gen options as a JSON object.' },
+            { name: '--describe-output', description: 'Print the generated artifact contract instead of probing.' }
+        ]
+    },
+    {
+        name: 'ddl pull',
+        summary: 'Pull PostgreSQL schema DDL via pg_dump and normalize it into per-schema files.',
+        writesFiles: true,
+        supportsDryRun: true,
+        supportsJsonPayload: true,
+        output: {
+            stdout: 'Status or JSON envelope.',
+            files: ['<out>/<schema>.sql']
+        },
+        exitCodes: {
+            '0': 'Pull completed or dry-run plan emitted.',
+            '1': 'pg_dump or normalization failed.'
+        },
+        flags: [
+            { name: '--dry-run', description: 'Run pg_dump and normalization without writing schema files.' },
+            { name: '--json', description: 'Pass pull options as a JSON object.' }
+        ]
+    },
+    {
+        name: 'ddl diff',
+        summary: 'Compare local DDL with a live database and emit a diff plan.',
+        writesFiles: true,
+        supportsDryRun: true,
+        supportsJsonPayload: true,
+        output: {
+            stdout: 'Status or JSON envelope.',
+            files: ['Specified --out patch file']
+        },
+        exitCodes: {
+            '0': 'Diff completed or dry-run plan emitted.',
+            '1': 'Local discovery or pg_dump failed.'
+        },
+        flags: [
+            { name: '--dry-run', description: 'Compute the patch without writing the plan file.' },
+            { name: '--json', description: 'Pass diff options as a JSON object.' }
+        ]
+    },
+    {
+        name: 'ddl gen-entities',
+        summary: 'Generate helper interfaces from DDL metadata.',
+        writesFiles: true,
+        supportsDryRun: true,
+        supportsJsonPayload: true,
+        output: {
+            stdout: 'Status or JSON envelope.',
+            files: ['Specified --out entities file']
+        },
+        exitCodes: {
+            '0': 'Generation completed or dry-run plan emitted.',
+            '1': 'DDL parsing failed.'
+        },
+        flags: [
+            { name: '--dry-run', description: 'Render entities without writing the output file.' },
+            { name: '--json', description: 'Pass generation options as a JSON object.' }
+        ]
+    },
+    {
+        name: 'check contract',
+        summary: 'Validate SQL contract specs and emit deterministic findings.',
+        writesFiles: true,
+        supportsDryRun: false,
+        supportsJsonPayload: true,
+        output: {
+            stdout: 'Human report or deterministic JSON report.'
+        },
+        exitCodes: {
+            '0': 'No violations.',
+            '1': 'Violations detected.',
+            '2': 'Runtime or config error.'
+        },
+        flags: [
+            { name: '--format json', description: 'Emit the report as deterministic JSON.' },
+            { name: '--json', description: 'Pass check options as a JSON object.' }
+        ]
+    },
+    {
+        name: 'perf init',
+        summary: 'Scaffold the opt-in perf sandbox configuration and Docker assets.',
+        writesFiles: true,
+        supportsDryRun: true,
+        supportsJsonPayload: true,
+        output: {
+            stdout: 'Human scaffold summary or JSON envelope.',
+            files: ['perf/sandbox.json', 'perf/seed.yml', 'perf/params.yml', 'perf/docker-compose.yml', 'perf/README.md', 'perf/.gitignore']
+        },
+        exitCodes: {
+            '0': 'Scaffold completed or dry-run plan emitted.',
+            '1': 'Validation or filesystem error.'
+        },
+        flags: [
+            { name: '--dry-run', description: 'Emit the planned perf sandbox scaffold without writing files.' },
+            { name: '--json', description: 'Pass perf init options as a JSON object.' }
+        ]
+    },
+    {
+        name: 'perf db reset',
+        summary: 'Recreate the perf sandbox schema from local DDL.',
+        writesFiles: false,
+        supportsDryRun: true,
+        supportsJsonPayload: true,
+        output: {
+            stdout: 'Human reset summary or JSON envelope.'
+        },
+        exitCodes: {
+            '0': 'Reset completed or dry-run plan emitted.',
+            '1': 'Docker, connection, or DDL replay failed.'
+        },
+        flags: [
+            { name: '--dry-run', description: 'Emit the DDL replay plan without touching Docker or PostgreSQL.' },
+            { name: '--json', description: 'Pass perf db reset options as a JSON object.' }
+        ]
+    },
+    {
+        name: 'perf seed',
+        summary: 'Generate deterministic synthetic data from perf/seed.yml.',
+        writesFiles: false,
+        supportsDryRun: true,
+        supportsJsonPayload: true,
+        output: {
+            stdout: 'Human seed summary or JSON envelope.'
+        },
+        exitCodes: {
+            '0': 'Seed completed or dry-run plan emitted.',
+            '1': 'Connection, DDL parsing, or insert generation failed.'
+        },
+        flags: [
+            { name: '--dry-run', description: 'Emit the seed plan without touching PostgreSQL.' },
+            { name: '--json', description: 'Pass perf seed options as a JSON object.' }
+        ]
+    },
+    {
+        name: 'perf run',
+        summary: 'Benchmark a SQL query and emit evidence for AI-driven tuning loops.',
+        writesFiles: true,
+        supportsDryRun: true,
+        supportsJsonPayload: true,
+        output: {
+            stdout: 'Human benchmark summary or JSON envelope.',
+            files: ['perf/evidence/run_xxx/* when --save is enabled']
+        },
+        exitCodes: {
+            '0': 'Benchmark completed or dry-run plan emitted.',
+            '1': 'Validation, connection, or execution failed.'
+        },
+        flags: [
+            { name: '--query', description: 'SQL file to benchmark inside the perf sandbox.' },
+            { name: '--params', description: 'JSON or YAML file with named or positional parameters.' },
+            { name: '--strategy', description: 'Execution strategy (direct|decomposed).', defaultValue: 'direct' },
+            { name: '--material', description: 'Comma-separated CTEs to materialize when using decomposed execution.' },
+            { name: '--mode', description: 'Benchmark mode (auto|latency|completion).', defaultValue: 'auto' },
+            { name: '--repeat', description: 'Measured repetitions for latency mode.', defaultValue: '10' },
+            { name: '--warmup', description: 'Warmup repetitions for latency mode.', defaultValue: '3' },
+            { name: '--classify-threshold-seconds', description: 'Threshold for auto mode classification.', defaultValue: '60' },
+            { name: '--timeout-minutes', description: 'Timeout for measured runs.', defaultValue: '5' },
+            { name: '--save', description: 'Persist benchmark evidence under perf/evidence/run_xxx.' },
+            { name: '--dry-run', description: 'Resolve benchmark mode and evidence shape without touching PostgreSQL.' },
+            { name: '--label', description: 'Attach a short label to the saved run directory.' },
+            { name: '--json', description: 'Pass perf run options as a JSON object.' }
+        ]
+    },
+    {
+        name: 'perf report diff',
+        summary: 'Compare two saved perf benchmark runs and report the primary delta.',
+        writesFiles: false,
+        supportsDryRun: false,
+        supportsJsonPayload: true,
+        output: {
+            stdout: 'Human diff summary or JSON envelope.'
+        },
+        exitCodes: {
+            '0': 'Diff report emitted.',
+            '1': 'Evidence loading or validation failed.'
+        },
+        flags: [
+            { name: '--format', description: 'Output format (text|json).', defaultValue: 'text' },
+            { name: '--json', description: 'Pass perf report diff options as a JSON object.' }
+        ]
+    }, {
+        name: 'query uses',
+        summary: 'Inspect catalog SQL usage of tables or columns.',
+        writesFiles: true,
+        supportsDryRun: false,
+        supportsJsonPayload: true,
+        output: {
+            stdout: 'Text report or versioned JSON report with optional display metadata.'
+        },
+        exitCodes: {
+            '0': 'Report emitted.',
+            '1': 'Validation failed.'
+        },
+        flags: [
+            { name: '--format json', description: 'Emit a versioned JSON usage report.' },
+            { name: '--json', description: 'Pass target and options as a JSON object.' },
+            { name: '--summary-only', description: 'Emit only summary counts with display metadata.' },
+            { name: '--limit', description: 'Truncate matches and warnings while preserving summary totals.' }
+        ]
+    },
+    {
+        name: 'lint',
+        summary: 'Lint SQL files with fixture-backed validation.',
+        writesFiles: false,
+        supportsDryRun: false,
+        supportsJsonPayload: true,
+        output: {
+            stdout: 'Silent on success in text mode, JSON envelope in global json mode.'
+        },
+        exitCodes: {
+            '0': 'Lint completed without failures.',
+            '1': 'Lint failures or runtime error.'
+        },
+        flags: [
+            { name: '--json', description: 'Pass lint options as a JSON object.' }
+        ]
+    },
+    {
+        name: 'evidence',
+        summary: 'Generate deterministic specification evidence artifacts.',
+        writesFiles: true,
+        supportsDryRun: false,
+        supportsJsonPayload: true,
+        output: {
+            files: ['<out-dir>/test-specification.json', '<out-dir>/test-specification.md']
+        },
+        exitCodes: {
+            '0': 'Evidence generated.',
+            '1': 'Generation failed.',
+            '2': 'Runtime or config error.'
+        },
+        flags: [
+            { name: '--json', description: 'Pass evidence options as a JSON object.' }
+        ]
+    }
+];
+function getDescribeCommandDescriptors() {
+    return COMMANDS;
+}
+function registerDescribeCommand(program) {
+    const describe = program.command('describe').description('Describe ztd-cli commands and output contracts');
+    describe.action(() => {
+        const payload = {
+            schemaVersion: 1,
+            commands: COMMANDS.map((command) => {
+                var _a;
+                return ({
+                    name: command.name,
+                    summary: command.summary,
+                    writesFiles: command.writesFiles,
+                    supportsDryRun: command.supportsDryRun,
+                    supportsJsonPayload: command.supportsJsonPayload,
+                    supportsDescribeOutput: (_a = command.supportsDescribeOutput) !== null && _a !== void 0 ? _a : false
+                });
+            })
+        };
+        if ((0, agentCli_1.isJsonOutput)()) {
+            (0, agentCli_1.writeCommandEnvelope)('describe', payload);
+            return;
+        }
+        const lines = ['Available command descriptions:'];
+        for (const command of COMMANDS) {
+            lines.push(`- ${command.name}: ${command.summary}`);
+        }
+        process.stdout.write(`${lines.join('\n')}\n`);
+    });
+    describe
+        .command('command <name>')
+        .description('Describe one command in detail')
+        .action((name) => {
+        const descriptor = COMMANDS.find((command) => command.name === name.trim());
+        if (!descriptor) {
+            throw new Error(`Unknown command description: ${name}`);
+        }
+        if ((0, agentCli_1.isJsonOutput)()) {
+            (0, agentCli_1.writeCommandEnvelope)('describe command', {
+                schemaVersion: 1,
+                command: descriptor
+            });
+            return;
+        }
+        const lines = [
+            `${descriptor.name}`,
+            descriptor.summary,
+            `writesFiles: ${descriptor.writesFiles}`,
+            `supportsDryRun: ${descriptor.supportsDryRun}`,
+            `supportsJsonPayload: ${descriptor.supportsJsonPayload}`
+        ];
+        if (descriptor.supportsDescribeOutput) {
+            lines.push('supportsDescribeOutput: true');
+        }
+        lines.push('flags:');
+        for (const flag of descriptor.flags) {
+            lines.push(`- ${flag.name}: ${flag.description}`);
+        }
+        lines.push('exitCodes:');
+        for (const [code, message] of Object.entries(descriptor.exitCodes)) {
+            lines.push(`- ${code}: ${message}`);
+        }
+        process.stdout.write(`${lines.join('\n')}\n`);
+    });
+}
+//# sourceMappingURL=describe.js.map

package/dist/commands/describe.js.map

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

package/dist/commands/diff.d.ts

@@ -0,0 +1,24 @@
+import type { DbConnectionContext } from '../utils/dbConnection';
+export interface DiffSchemaOptions {
+    directories: string[];
+    extensions: string[];
+    url: string;
+    out: string;
+    pgDumpPath?: string;
+    pgDumpShell?: boolean;
+    connectionContext?: DbConnectionContext;
+    dryRun?: boolean;
+}
+export interface DiffSchemaResult {
+    outFile: string;
+    patch: string;
+    dryRun: boolean;
+    hasChanges: boolean;
+}
+export declare const DDL_DIFF_SPAN_NAMES: {
+    readonly collectLocalDdl: "collect-local-ddl";
+    readonly pullRemoteDdl: "pull-remote-ddl";
+    readonly computeDiffPlan: "compute-diff-plan";
+    readonly emitDiffPlan: "emit-diff-plan";
+};
+export declare function runDiffSchema(options: DiffSchemaOptions): DiffSchemaResult;