@rawsql-ts/ztd-cli 0.20.0 → 0.20.2

package/dist/commands/options.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_TESTS_DIRECTORY = exports.DEFAULT_DDL_DIRECTORY = exports.DEFAULT_EXTENSIONS = void 0;
+exports.collectDirectories = collectDirectories;
+exports.collectValues = collectValues;
+exports.normalizeDirectoryList = normalizeDirectoryList;
+exports.parseExtensions = parseExtensions;
+exports.resolveExtensions = resolveExtensions;
+exports.parseCsvList = parseCsvList;
+exports.DEFAULT_EXTENSIONS = ['.sql'];
+exports.DEFAULT_DDL_DIRECTORY = 'ztd/ddl';
+exports.DEFAULT_TESTS_DIRECTORY = 'tests';
+const EXTENSION_TOKEN_PATTERN = /^[A-Za-z0-9_]+$/;
+function collectDirectories(value, previous) {
+    return [...previous, value];
+}
+function collectValues(value, previous) {
+    return [...previous, value];
+}
+function normalizeDirectoryList(userDirectories, fallback) {
+    const candidates = (userDirectories !== null && userDirectories !== void 0 ? userDirectories : []).map((entry) => entry.trim()).filter(Boolean);
+    // Fall back to the configured default directory when no explicit paths are provided.
+    const directories = candidates.length ? candidates : [fallback];
+    return Array.from(new Set(directories));
+}
+function parseExtensions(value) {
+    const rawEntries = Array.isArray(value) ? value : value.split(',');
+    // Clean and normalize each candidate before deduplicating to ensure stable output.
+    const cleanedTokens = rawEntries
+        .map((entry) => entry.trim())
+        .filter((entry) => entry.length > 0 && entry !== '.')
+        .map((entry) => (entry.startsWith('.') ? entry.slice(1) : entry))
+        .filter((token) => token.length > 0 && EXTENSION_TOKEN_PATTERN.test(token))
+        .map((token) => `.${token.toLowerCase()}`);
+    return Array.from(new Set(cleanedTokens)).sort();
+}
+function resolveExtensions(input, fallback) {
+    // Use user-specified extensions when present; otherwise rely on the default list.
+    const normalized = (input === null || input === void 0 ? void 0 : input.length) ? input : fallback;
+    return Array.from(new Set(normalized));
+}
+function parseCsvList(value) {
+    return value
+        .split(',')
+        .map((entry) => entry.trim())
+        .filter((entry) => entry.length > 0);
+}
+//# sourceMappingURL=options.js.map

package/dist/commands/options.js.map

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

package/dist/commands/perf.d.ts

@@ -0,0 +1,9 @@
+import { Command } from 'commander';
+export declare const PERF_COMMAND_SPANS: {
+    readonly resolveRunOptions: "resolve-perf-run-options";
+    readonly executeBenchmark: "execute-perf-benchmark";
+    readonly renderBenchmark: "render-perf-report";
+    readonly loadDiff: "load-perf-report-diff";
+    readonly renderDiff: "render-perf-diff-output";
+};
+export declare function registerPerfCommands(program: Command): void;

package/dist/commands/perf.js

@@ -0,0 +1,374 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PERF_COMMAND_SPANS = void 0;
+exports.registerPerfCommands = registerPerfCommands;
+const node_path_1 = __importDefault(require("node:path"));
+const rawsql_ts_1 = require("rawsql-ts");
+const sandbox_1 = require("../perf/sandbox");
+const benchmark_1 = require("../perf/benchmark");
+const agentCli_1 = require("../utils/agentCli");
+const collectSqlFiles_1 = require("../utils/collectSqlFiles");
+const telemetry_1 = require("../utils/telemetry");
+const ztdProjectConfig_1 = require("../utils/ztdProjectConfig");
+exports.PERF_COMMAND_SPANS = {
+    resolveRunOptions: 'resolve-perf-run-options',
+    executeBenchmark: 'execute-perf-benchmark',
+    renderBenchmark: 'render-perf-report',
+    loadDiff: 'load-perf-report-diff',
+    renderDiff: 'render-perf-diff-output',
+};
+function registerPerfCommands(program) {
+    const perf = program.command('perf').description('Opt-in perf sandbox workflows for reproducible SQL experiments');
+    perf.addHelpText('after', `
+Examples:
+  $ ztd perf init
+  $ ztd perf db reset --dry-run
+  $ ztd perf seed --dry-run
+  $ ztd perf run --query src/sql/report.sql --dry-run
+  $ ztd perf report diff perf/evidence/run_001 perf/evidence/run_002
+`);
+    perf
+        .command('init')
+        .description('Scaffold the perf sandbox configuration and Docker assets')
+        .option('--dry-run', 'Emit the perf scaffold plan without writing files')
+        .option('--json <payload>', 'Pass perf init options as a JSON object')
+        .action((options) => {
+        runPerfInitCommand(options);
+    });
+    const db = perf.command('db').description('Manage the perf sandbox database');
+    db
+        .command('reset')
+        .description('Recreate the perf sandbox schema from local DDL')
+        .option('--dry-run', 'Emit the reset plan without touching Docker or PostgreSQL')
+        .option('--json <payload>', 'Pass perf db reset options as a JSON object')
+        .action(async (options) => {
+        await runPerfDbResetCommand(options);
+    });
+    perf
+        .command('seed')
+        .description('Generate deterministic synthetic data from perf/seed.yml')
+        .option('--dry-run', 'Emit the seed plan without touching PostgreSQL')
+        .option('--json <payload>', 'Pass perf seed options as a JSON object')
+        .action(async (options) => {
+        await runPerfSeedCommand(options);
+    });
+    perf
+        .command('run')
+        .description('Benchmark one SQL query and capture evidence for AI-driven tuning loops')
+        .option('--query <sqlFile>', 'SQL file to benchmark inside the perf sandbox')
+        .option('--params <path>', 'JSON or YAML file with query parameters (object for named placeholders, array for positional)')
+        .option('--strategy <strategy>', 'Execution strategy (direct|decomposed)', 'direct')
+        .option('--material <cteNames>', 'Comma-separated CTEs to materialize when --strategy decomposed is used')
+        .option('--mode <mode>', 'Benchmark mode (auto|latency|completion)', 'auto')
+        .option('--repeat <count>', `Measured repetitions for latency mode (default: ${benchmark_1.PERF_BENCHMARK_DEFAULTS.repeat})`)
+        .option('--warmup <count>', `Warmup repetitions for latency mode (default: ${benchmark_1.PERF_BENCHMARK_DEFAULTS.warmup})`)
+        .option('--classify-threshold-seconds <seconds>', `Threshold for auto mode classification (default: ${benchmark_1.PERF_BENCHMARK_DEFAULTS.classifyThresholdSeconds})`)
+        .option('--timeout-minutes <minutes>', `Timeout for measured runs (default: ${benchmark_1.PERF_BENCHMARK_DEFAULTS.timeoutMinutes})`)
+        .option('--save', 'Persist benchmark evidence under perf/evidence/run_xxx')
+        .option('--dry-run', 'Resolve mode, params, and evidence shape without touching PostgreSQL')
+        .option('--label <name>', 'Attach a short label to the saved run directory')
+        .option('--json <payload>', 'Pass perf run options as a JSON object')
+        .action(async (options) => {
+        await runPerfRunCommand(options);
+    });
+    const report = perf.command('report').description('Compare saved perf benchmark evidence');
+    report
+        .command('diff <baselineDir> <candidateDir>')
+        .description('Compare two saved perf benchmark runs and highlight the primary metric delta')
+        .option('--format <format>', 'Output format (text|json)', 'text')
+        .option('--json <payload>', 'Pass perf report diff options as a JSON object')
+        .action((baselineDir, candidateDir, options) => {
+        runPerfReportDiffCommand(baselineDir, candidateDir, options);
+    });
+}
+function runPerfInitCommand(options) {
+    const merged = resolvePerfOptions(options);
+    const plan = (0, sandbox_1.buildPerfInitPlan)(process.cwd());
+    if (merged.dryRun) {
+        emitPerfResult('perf init', {
+            dryRun: true,
+            files: plan.files.map((file) => node_path_1.default.relative(process.cwd(), file.path).replace(/\\/g, '/'))
+        });
+        return;
+    }
+    const written = (0, sandbox_1.applyPerfInitPlan)(plan).map((file) => node_path_1.default.relative(process.cwd(), file).replace(/\\/g, '/'));
+    emitPerfResult('perf init', {
+        dryRun: false,
+        files: written
+    }, [`Perf sandbox initialized.`, ...written.map((file) => `- ${file}`)]);
+}
+async function runPerfDbResetCommand(options) {
+    const merged = resolvePerfOptions(options);
+    const ddlInventory = (0, sandbox_1.inspectPerfDdlInventory)(process.cwd(), { requireExistingDdlDir: true });
+    if (merged.dryRun) {
+        emitPerfResult('perf db reset', {
+            dryRun: true,
+            ddl_files: ddlInventory.files,
+            ddl_file_count: ddlInventory.files.length,
+            ddl_statement_count: ddlInventory.ddlStatementCount,
+            table_count: ddlInventory.tableCount,
+            index_count: ddlInventory.indexCount,
+            index_names: ddlInventory.indexNames
+        });
+        return;
+    }
+    const result = await (0, sandbox_1.resetPerfSandbox)(process.cwd());
+    const displayConnectionUrl = toDisplayConnectionUrl(result.connectionUrl);
+    const appliedInventory = (0, sandbox_1.inspectPerfDdlInventory)(process.cwd(), { requireExistingDdlDir: true });
+    emitPerfResult('perf db reset', {
+        dryRun: false,
+        connection_url: displayConnectionUrl,
+        used_docker: result.usedDocker,
+        ddl_files: result.appliedFiles,
+        ddl_statement_count: result.ddlStatements,
+        table_count: appliedInventory.tableCount,
+        index_count: appliedInventory.indexCount,
+        index_names: appliedInventory.indexNames
+    }, [
+        `Perf sandbox reset complete.`,
+        `Connection: ${displayConnectionUrl}`,
+        `DDL files: ${result.appliedFiles.length}`,
+        `DDL statements: ${result.ddlStatements}`,
+        `Tables: ${appliedInventory.tableCount}`,
+        `Indexes: ${appliedInventory.indexCount}`
+    ]);
+}
+async function runPerfSeedCommand(options) {
+    const merged = resolvePerfOptions(options);
+    if (merged.dryRun) {
+        const plan = buildPerfSeedDryRunPlan(process.cwd());
+        emitPerfResult('perf seed', {
+            dryRun: true,
+            seed: plan.seed,
+            tables: plan.tables
+        });
+        return;
+    }
+    const result = await (0, sandbox_1.seedPerfSandbox)(process.cwd());
+    const displayConnectionUrl = toDisplayConnectionUrl(result.connectionUrl);
+    emitPerfResult('perf seed', {
+        dryRun: false,
+        connection_url: displayConnectionUrl,
+        used_docker: result.usedDocker,
+        seed: result.seed,
+        inserted_rows: result.insertedRows
+    }, [
+        `Perf seed complete.`,
+        `Connection: ${displayConnectionUrl}`,
+        `Seed: ${result.seed}`,
+        ...Object.entries(result.insertedRows).map(([tableName, rows]) => `- ${tableName}: ${rows} rows`)
+    ]);
+}
+async function runPerfRunCommand(options) {
+    const resolved = (0, telemetry_1.withSpanSync)(exports.PERF_COMMAND_SPANS.resolveRunOptions, () => {
+        var _a, _b;
+        const merged = options.json ? { ...options, ...(0, agentCli_1.parseJsonPayload)(options.json, '--json') } : options;
+        const queryFile = normalizeRequiredStringOption(merged.query, '--query');
+        return {
+            rootDir: process.cwd(),
+            queryFile,
+            paramsFile: normalizeOptionalStringOption(merged.params),
+            strategy: normalizePerfStrategy((_a = normalizeOptionalStringOption(merged.strategy)) !== null && _a !== void 0 ? _a : 'direct'),
+            material: normalizeCsvListOption(merged.material),
+            mode: normalizeBenchmarkMode((_b = normalizeOptionalStringOption(merged.mode)) !== null && _b !== void 0 ? _b : 'auto'),
+            repeat: normalizePositiveIntegerOption(merged.repeat, '--repeat', benchmark_1.PERF_BENCHMARK_DEFAULTS.repeat),
+            warmup: normalizeNonNegativeIntegerOption(merged.warmup, '--warmup', benchmark_1.PERF_BENCHMARK_DEFAULTS.warmup),
+            classifyThresholdSeconds: normalizePositiveIntegerOption(merged.classifyThresholdSeconds, '--classify-threshold-seconds', benchmark_1.PERF_BENCHMARK_DEFAULTS.classifyThresholdSeconds),
+            timeoutMinutes: normalizePositiveIntegerOption(merged.timeoutMinutes, '--timeout-minutes', benchmark_1.PERF_BENCHMARK_DEFAULTS.timeoutMinutes),
+            save: normalizeBooleanOption(merged.save),
+            dryRun: normalizeBooleanOption(merged.dryRun),
+            label: normalizeOptionalStringOption(merged.label)
+        };
+    }, {
+        jsonPayload: Boolean(options.json),
+    });
+    const report = await (0, telemetry_1.withSpan)(exports.PERF_COMMAND_SPANS.executeBenchmark, () => {
+        return (0, benchmark_1.runPerfBenchmark)(resolved);
+    }, {
+        strategy: resolved.strategy,
+        requestedMode: resolved.mode,
+        save: resolved.save,
+        dryRun: resolved.dryRun,
+    });
+    (0, telemetry_1.withSpanSync)(exports.PERF_COMMAND_SPANS.renderBenchmark, () => {
+        emitPerfReport('perf run', report);
+    }, {
+        selectedMode: report.selected_mode,
+        strategy: report.strategy,
+        saved: report.saved,
+        dryRun: report.dry_run,
+    });
+}
+function runPerfReportDiffCommand(baselineDir, candidateDir, options) {
+    const resolved = (0, telemetry_1.withSpanSync)(exports.PERF_COMMAND_SPANS.loadDiff, () => {
+        const merged = options.json ? { ...options, ...(0, agentCli_1.parseJsonPayload)(options.json, '--json') } : options;
+        const format = normalizePerfFormat(normalizeOptionalStringOption(merged.format));
+        const report = (0, benchmark_1.diffPerfBenchmarkReports)(node_path_1.default.resolve(process.cwd(), baselineDir), node_path_1.default.resolve(process.cwd(), candidateDir));
+        return { format, report };
+    }, {
+        jsonPayload: Boolean(options.json),
+    });
+    if ((0, agentCli_1.isJsonOutput)()) {
+        (0, telemetry_1.withSpanSync)(exports.PERF_COMMAND_SPANS.renderDiff, () => {
+            (0, agentCli_1.writeCommandEnvelope)('perf report diff', resolved.report);
+        }, {
+            format: resolved.format,
+        });
+        return;
+    }
+    (0, telemetry_1.withSpanSync)(exports.PERF_COMMAND_SPANS.renderDiff, () => {
+        process.stdout.write((0, benchmark_1.formatPerfDiffReport)(resolved.report, resolved.format));
+    }, {
+        format: resolved.format,
+    });
+}
+function buildPerfSeedDryRunPlan(rootDir) {
+    const config = (0, ztdProjectConfig_1.loadZtdProjectConfig)(rootDir);
+    const seedConfig = (0, sandbox_1.loadPerfSeedConfig)(rootDir);
+    const ddlSources = (0, collectSqlFiles_1.collectSqlFiles)([node_path_1.default.resolve(rootDir, config.ddlDir)], ['.sql']);
+    const definitions = ddlSources.flatMap((source) => {
+        const split = rawsql_ts_1.MultiQuerySplitter.split(source.sql);
+        return split.queries.flatMap((chunk) => {
+            const sql = chunk.sql.trim();
+            if (!sql) {
+                return [];
+            }
+            const parsed = rawsql_ts_1.SqlParser.parse(sql);
+            if (!(parsed instanceof rawsql_ts_1.CreateTableQuery)) {
+                return [];
+            }
+            return [(0, rawsql_ts_1.createTableDefinitionFromCreateTableQuery)(parsed)];
+        });
+    });
+    const tables = Object.fromEntries(Object.entries(seedConfig.tables).map(([tableName, tableConfig]) => {
+        const definition = definitions.find((candidate) => candidate.name === tableName || candidate.name === `${config.ddl.defaultSchema}.${tableName}`);
+        if (!definition) {
+            throw new Error(`No table definition found for perf seed table: ${tableName}`);
+        }
+        return [definition.name, (0, sandbox_1.buildInsertStatementsForTable)(definition, tableConfig.rows, seedConfig).length];
+    }));
+    return { seed: seedConfig.seed, tables };
+}
+function toDisplayConnectionUrl(connectionUrl) {
+    try {
+        const parsed = new URL(connectionUrl);
+        return `${parsed.protocol}//${parsed.host}${parsed.pathname}`;
+    }
+    catch {
+        return '[unavailable]';
+    }
+}
+function emitPerfResult(command, data, textLines) {
+    if ((0, agentCli_1.isJsonOutput)()) {
+        (0, agentCli_1.writeCommandEnvelope)(command, data);
+        return;
+    }
+    if (textLines) {
+        process.stdout.write(`${textLines.join('\n')}\n`);
+        return;
+    }
+    process.stdout.write(`${JSON.stringify(data, null, 2)}\n`);
+}
+function emitPerfReport(command, report) {
+    if ((0, agentCli_1.isJsonOutput)()) {
+        (0, agentCli_1.writeCommandEnvelope)(command, report);
+        return;
+    }
+    process.stdout.write((0, benchmark_1.formatPerfBenchmarkReport)(report, 'text'));
+}
+function resolvePerfOptions(options) {
+    const merged = options.json
+        ? { ...options, ...(0, agentCli_1.parseJsonPayload)(options.json, '--json') }
+        : options;
+    if (merged.dryRun !== undefined && typeof merged.dryRun !== 'boolean') {
+        throw new Error('Expected --dry-run to resolve to a boolean.');
+    }
+    return {
+        dryRun: Boolean(merged.dryRun)
+    };
+}
+function normalizeOptionalStringOption(value) {
+    if (value === undefined || value === null || value === '') {
+        return undefined;
+    }
+    if (typeof value !== 'string') {
+        throw new Error(`Expected a string option but received ${typeof value}.`);
+    }
+    return value;
+}
+function normalizeRequiredStringOption(value, label) {
+    const normalized = normalizeOptionalStringOption(value);
+    if (!normalized) {
+        throw new Error(`${label} is required.`);
+    }
+    return normalized;
+}
+function normalizeBooleanOption(value) {
+    if (value === undefined) {
+        return false;
+    }
+    if (typeof value !== 'boolean') {
+        throw new Error(`Expected a boolean option but received ${typeof value}.`);
+    }
+    return value;
+}
+function normalizePositiveIntegerOption(value, label, fallback) {
+    if (value === undefined || value === null || value === '') {
+        return fallback;
+    }
+    const parsed = Number(value);
+    if (!Number.isInteger(parsed) || parsed <= 0) {
+        throw new Error(`${label} must be a positive integer.`);
+    }
+    return parsed;
+}
+function normalizeNonNegativeIntegerOption(value, label, fallback) {
+    if (value === undefined || value === null || value === '') {
+        return fallback;
+    }
+    const parsed = Number(value);
+    if (!Number.isInteger(parsed) || parsed < 0) {
+        throw new Error(`${label} must be a non-negative integer.`);
+    }
+    return parsed;
+}
+function normalizeCsvListOption(value) {
+    if (Array.isArray(value)) {
+        return value.map((entry) => {
+            if (typeof entry !== 'string') {
+                throw new Error(`Expected material entries to be strings but received ${typeof entry}.`);
+            }
+            return entry.trim();
+        }).filter(Boolean);
+    }
+    const normalized = normalizeOptionalStringOption(value);
+    if (!normalized) {
+        return [];
+    }
+    return normalized.split(',').map((entry) => entry.trim()).filter(Boolean);
+}
+function normalizePerfStrategy(value) {
+    const normalized = value.trim().toLowerCase();
+    if (normalized === 'direct' || normalized === 'decomposed') {
+        return normalized;
+    }
+    throw new Error(`Unsupported perf execution strategy: ${value}`);
+}
+function normalizeBenchmarkMode(value) {
+    const normalized = value.trim().toLowerCase();
+    if (normalized === 'auto' || normalized === 'latency' || normalized === 'completion') {
+        return normalized;
+    }
+    throw new Error(`Unsupported perf benchmark mode: ${value}`);
+}
+function normalizePerfFormat(value) {
+    const normalized = (value !== null && value !== void 0 ? value : 'text').trim().toLowerCase();
+    if (normalized === 'text' || normalized === 'json') {
+        return normalized;
+    }
+    throw new Error(`Unsupported format: ${value}`);
+}
+//# sourceMappingURL=perf.js.map

package/dist/commands/perf.js.map

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

package/dist/commands/pull.d.ts

@@ -0,0 +1,21 @@
+import type { DbConnectionContext } from '../utils/dbConnection';
+export interface PullSchemaOptions {
+    url: string;
+    out: string;
+    pgDumpPath?: string;
+    pgDumpShell?: boolean;
+    schemas?: string[];
+    tables?: string[];
+    connectionContext?: DbConnectionContext;
+    dryRun?: boolean;
+}
+export interface PullSchemaResult {
+    outDir: string;
+    files: Array<{
+        schema: string;
+        filePath: string;
+        contents: string;
+    }>;
+    dryRun: boolean;
+}
+export declare function runPullSchema(options: PullSchemaOptions): PullSchemaResult;

package/dist/commands/pull.js

@@ -0,0 +1,115 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runPullSchema = runPullSchema;
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+const pgDump_1 = require("../utils/pgDump");
+const fs_1 = require("../utils/fs");
+const normalizePulledSchema_1 = require("../utils/normalizePulledSchema");
+function runPullSchema(options) {
+    var _a, _b;
+    // Canonicalize CLI filters before invoking pg_dump so later steps can rely on consistent casing.
+    const schemaFilters = ((_a = options.schemas) !== null && _a !== void 0 ? _a : []).map((value) => normalizeSchemaName(value));
+    const tableFilters = ((_b = options.tables) !== null && _b !== void 0 ? _b : []).map((value) => parseTableSpecifier(value));
+    // Build the schema set that should survive the normalization pass.
+    const allowedSchemas = buildAllowedSchemas(schemaFilters, tableFilters);
+    // Invoke pg_dump once with the normalized filters so only the desired objects are exported.
+    const ddlSql = (0, pgDump_1.runPgDump)({
+        url: options.url,
+        pgDumpPath: options.pgDumpPath,
+        pgDumpShell: options.pgDumpShell,
+        extraArgs: buildPgDumpArguments(schemaFilters, tableFilters),
+        connectionContext: options.connectionContext
+    });
+    // Normalize and bucket the pg_dump output while respecting the requested schema set.
+    const normalizedMap = (0, normalizePulledSchema_1.normalizePulledSchema)(ddlSql, {
+        allowedSchemas: allowedSchemas.size ? allowedSchemas : undefined
+    });
+    if (normalizedMap.size === 0) {
+        // Help callers realize their filters may have excluded everything from the dump.
+        const filterHints = [];
+        if (schemaFilters.length) {
+            filterHints.push(`--schema ${schemaFilters.join(', ')}`);
+        }
+        if (tableFilters.length) {
+            filterHints.push(`--table ${tableFilters.map((table) => table.original).join(', ')}`);
+        }
+        const hint = filterHints.length ? ` Filters applied: ${filterHints.join('; ')}.` : '';
+        throw new Error(`The dump did not contain any supported DDL statements.${hint} Verify the schema/table filters match your database.`);
+    }
+    const outDir = node_path_1.default.resolve(options.out);
+    const files = Array.from(normalizedMap.entries())
+        .sort(([schemaA], [schemaB]) => schemaA.localeCompare(schemaB))
+        .map(([schema, statements]) => ({
+        schema,
+        filePath: node_path_1.default.join(outDir, `${sanitizeSchemaFileName(schema)}.sql`),
+        contents: buildSchemaFile(statements)
+    }));
+    if (!options.dryRun) {
+        (0, fs_1.ensureDirectory)(outDir);
+        // Remove the legacy schema.sql snapshot only when it is still present.
+        const legacySchemaFile = node_path_1.default.join(outDir, 'schema.sql');
+        if ((0, node_fs_1.existsSync)(legacySchemaFile)) {
+            (0, node_fs_1.rmSync)(legacySchemaFile, { force: true });
+        }
+        const schemasDir = node_path_1.default.join(outDir, 'schemas');
+        if ((0, node_fs_1.existsSync)(schemasDir)) {
+            (0, node_fs_1.rmSync)(schemasDir, { recursive: true, force: true });
+        }
+        // Persist each schema snapshot directly under the DDL directory for easier discovery.
+        for (const file of files) {
+            (0, node_fs_1.writeFileSync)(file.filePath, file.contents, 'utf8');
+            console.log(`Wrote normalized schema for ${file.schema} at ${file.filePath}`);
+        }
+    }
+    return { outDir, files, dryRun: Boolean(options.dryRun) };
+}
+function buildPgDumpArguments(schemaFilters, tableFilters) {
+    // Allow callers to target specific schemas or tables when invoking pg_dump.
+    const args = [];
+    for (const schema of schemaFilters) {
+        args.push('--schema', schema);
+    }
+    for (const table of tableFilters) {
+        args.push('--table', table.original);
+    }
+    return args;
+}
+function buildAllowedSchemas(schemaFilters, tableFilters) {
+    // Combine the schemas referenced via filters so the normalizer can limit output.
+    const combined = new Set(schemaFilters);
+    for (const table of tableFilters) {
+        combined.add(table.schema);
+    }
+    return combined;
+}
+function buildSchemaFile(statements) {
+    // Join the sorted statements with blank lines so the file stays readable.
+    const body = statements.map((statement) => statement.sql).join('\n\n');
+    return `${body}\n`;
+}
+function sanitizeSchemaFileName(schema) {
+    const sanitized = schema.replace(/[^a-z0-9_-]/g, '_').replace(/^_+|_+$/g, '');
+    // Fall back to a safe default when all characters were stripped away.
+    return sanitized || 'schema';
+}
+function normalizeSchemaName(value) {
+    // Trim, unquote, and lowercase schema names to keep filter comparison predictable.
+    return value.trim().replace(/^"|"$/g, '').toLowerCase();
+}
+function parseTableSpecifier(value) {
+    var _a, _b;
+    const trimmed = value.trim();
+    const qualifiedPattern = /^\s*(?:"([^"]+)"|([^".\s]+))\.(?:"([^"]+)"|([^".\s]+))\s*$/;
+    const match = trimmed.match(qualifiedPattern);
+    // Resolve the schema portion, falling back to public when the specifier is unqualified.
+    const schema = match ? (_b = (_a = match[1]) !== null && _a !== void 0 ? _a : match[2]) !== null && _b !== void 0 ? _b : 'public' : 'public';
+    return {
+        schema: normalizeSchemaName(schema),
+        original: trimmed
+    };
+}
+//# sourceMappingURL=pull.js.map

package/dist/commands/pull.js.map

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

package/dist/commands/query.d.ts

@@ -0,0 +1,9 @@
+import { Command } from 'commander';
+export declare const QUERY_USES_COMMAND_SPANS: {
+    readonly resolveOptions: "resolve-query-options";
+    readonly renderOutput: "render-query-usage-output";
+};
+/**
+ * Register strict-first impact investigation commands on the CLI root.
+ */
+export declare function registerQueryCommands(program: Command): void;