@rawsql-ts/ztd-cli 0.19.0 → 0.20.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 MSugiura
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -111,7 +111,7 @@ How to read that layout:
 * `src/domain`, `src/application`, and `src/presentation/http` are where generic WebAPI work should begin.
 * `src/infrastructure/persistence`, `src/sql`, `src/catalog`, and `ztd/ddl` are the ZTD-owned persistence side.
 * `tests/generated` is generated output. Recreate it with `ztd ztd-config` instead of editing it manually.
-* `.ztd/agents` contains managed AI guidance so a later prompt such as "WebAPI化して" does not accidentally jump straight into persistence-specific rules.
+* Optional AI guidance files can be generated when you explicitly request them, but the default scaffold stays focused on consumer-facing project files.
 
 ## Choose The Right Happy Path
 
@@ -158,8 +158,6 @@ After `ztd init` you should see:
 | `tests/smoke.validation.test.ts`  | Validator integration smoke test                                |
 | `tests/support/testkit-client.ts` | Driver wiring placeholder                                       |
 | `src/catalog/specs/`              | Spec and runtime files for the smoke contract                   |
-| `CONTEXT.md`                      | Agent-focused project invariants and recommended command usage  |
-| `.ztd/agents/manifest.json`       | Managed AI guidance index with security notices and entrypoints |
 
 ```bash
 # 4. Generate test types from the demo DDL
@@ -184,6 +182,7 @@ All smoke tests should pass. You now have a working ZTD project.
 
 * Replace the demo DDL with your own schema, or inspect an explicit target with `npx ztd ddl pull --url <target>`
 * Re-run `npx ztd ztd-config` whenever DDL changes (or use `--watch`)
+* Add AI guidance files only if you want them in the repo: `npx ztd init --with-ai-guidance`
 * Install visible AGENTS files only if you want them in the repo: `npx ztd agents install`
 * Wire a real driver in `tests/support/testkit-client.ts` (see [adapter-node-pg](../adapters/adapter-node-pg) for Postgres)
 * Write domain tests against generated `TestRowMap` types
@@ -214,6 +213,7 @@ mkdir /tmp/my-ztd-dogfood && cd /tmp/my-ztd-dogfood
 node "<LOCAL_SOURCE_ROOT>/packages/ztd-cli/dist/index.js" init \
   --workflow empty \
   --validator zod \
+  --with-ai-guidance \
   --local-source-root "<LOCAL_SOURCE_ROOT>"
 
 # 4. Install the scaffolded dependencies
@@ -314,7 +314,7 @@ Most write-capable commands support `--dry-run` and `--json <payload>` for autom
 
 | Command | Description |
 |---------|-------------|
-| `ztd init` | Create a ZTD-ready project layout (DDL folder, config, test stubs). Flags: `--yes`, `--workflow <pg_dump\|empty\|demo>`, `--validator <zod\|arktype>`, `--with-sqlclient`, `--with-app-interface`, `--local-source-root <path>` |
+| `ztd init` | Create a ZTD-ready project layout (DDL folder, config, test stubs). Flags: `--yes`, `--workflow <pg_dump\|empty\|demo>`, `--validator <zod\|arktype>`, `--with-ai-guidance`, `--with-sqlclient`, `--with-app-interface`, `--local-source-root <path>` |
 | `ztd agents install` | Materialize visible `AGENTS.md` files from the managed templates |
 | `ztd agents status` | Report internal/visible AGENTS state and drift signals |
 | `ztd ztd-config` | Generate `TestRowMap` and layout from DDL files. Flags: `--watch`, `--quiet` |

package/dist/commands/agents.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerAgentsCommand(program: Command): void;

package/dist/commands/agents.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerAgentsCommand = registerAgentsCommand;
+const agents_1 = require("../utils/agents");
+const agentCli_1 = require("../utils/agentCli");
+function registerAgentsCommand(program) {
+    const agents = program.command('agents').description('Manage internal and visible AGENTS guidance for ztd projects');
+    agents
+        .command('install')
+        .description('Install visible AGENTS.md files from the managed templates')
+        .action(() => {
+        const plannedPaths = (0, agents_1.getVisibleAgentsInstallPaths)(process.cwd());
+        const lines = ['About to create:'];
+        if (plannedPaths.length === 0) {
+            lines.push(' - (none)');
+        }
+        else {
+            for (const targetPath of plannedPaths) {
+                lines.push(` - ${targetPath}`);
+            }
+        }
+        lines.push('No files will be overwritten.');
+        lines.push('Disable with: skip `ztd agents install` (visible AGENTS are disabled by default).');
+        const written = (0, agents_1.installVisibleAgents)(process.cwd());
+        if ((0, agentCli_1.isJsonOutput)()) {
+            (0, agentCli_1.writeCommandEnvelope)('agents install', {
+                schemaVersion: 1,
+                plannedPaths,
+                createdPaths: written.map((summary) => summary.relativePath),
+                messageLines: lines
+            });
+            return;
+        }
+        const finalLines = [...lines];
+        if (written.length === 0) {
+            finalLines.push('Visible AGENTS guidance is already installed or intentionally preserved.');
+        }
+        else {
+            finalLines.push('Installed visible AGENTS guidance:');
+            for (const summary of written) {
+                finalLines.push(` - ${summary.relativePath}`);
+            }
+        }
+        process.stdout.write(`${finalLines.join('\n')}\n`);
+    });
+    agents
+        .command('status')
+        .description('Report managed AGENTS guidance state and drift signals')
+        .action(() => {
+        var _a;
+        const report = (0, agents_1.getAgentsStatus)(process.cwd());
+        if ((0, agentCli_1.isJsonOutput)()) {
+            (0, agentCli_1.writeCommandEnvelope)('agents status', {
+                schemaVersion: 1,
+                targets: report.targets,
+                recommended_actions: report.recommendedActions
+            });
+            return;
+        }
+        const lines = ['AGENTS status:'];
+        for (const target of report.targets) {
+            lines.push(`- ${target.path}: installed=${target.installed} managed=${target.managed} installed_version=${(_a = target.installedVersion) !== null && _a !== void 0 ? _a : 'null'} template_version=${target.templateVersion} drift=${target.drift}`);
+        }
+        lines.push(`recommended_actions: ${report.recommendedActions.length > 0 ? report.recommendedActions.join(', ') : '(none)'}`);
+        process.stdout.write(`${lines.join('\n')}\n`);
+    });
+}
+//# sourceMappingURL=agents.js.map

package/dist/commands/agents.js.map

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

package/dist/commands/checkContract.d.ts

@@ -0,0 +1,46 @@
+import { Command } from 'commander';
+export type CheckFormat = 'human' | 'json';
+export type ViolationSeverity = 'error' | 'warning';
+/** A single deterministic contract-check violation/warning item. */
+export interface ContractViolation {
+    rule: 'duplicate-spec-id' | 'unresolved-sql-file' | 'params-shape-mismatch' | 'mapping-invalid-entry' | 'mapping-duplicate-entry' | 'safety-select-star' | 'safety-missing-where' | 'sql-parse-error';
+    severity: ViolationSeverity;
+    specId: string;
+    filePath: string;
+    message: string;
+}
+export interface CheckContractResult {
+    ok: boolean;
+    violations: ContractViolation[];
+    filesChecked: number;
+    specsChecked: number;
+}
+/**
+ * Resolve command exit code for contract checks.
+ * @param args.result Completed check result when execution succeeded.
+ * @param args.error Error thrown while running checks.
+ * @returns 0 when result is ok, 1 when violations exist or non-runtime errors occur, 2 for runtime/config errors.
+ */
+export declare function resolveCheckContractExitCode(args: {
+    result?: CheckContractResult;
+    error?: unknown;
+}): 0 | 1 | 2;
+/** Runtime/configuration error for contract check command (maps to exit code 2). */
+export declare class CheckContractRuntimeError extends Error {
+    readonly exitCode = 2;
+}
+/** Register `ztd check contract` command on the CLI root program. */
+export declare function registerCheckContractCommand(program: Command): void;
+/**
+ * Run deterministic contract checks for catalog specs under a project root.
+ * @param options.strict Treat safety checks as errors when true, warnings otherwise.
+ * @param options.rootDir Optional project root override.
+ * @param options.specsDir Optional specs directory override (relative to rootDir).
+ */
+export declare function runCheckContract(options: {
+    strict: boolean;
+    rootDir?: string;
+    specsDir?: string;
+}): CheckContractResult;
+/** Format check results into human text or deterministic JSON text. */
+export declare function formatOutput(result: CheckContractResult, format: CheckFormat): string;

package/dist/commands/checkContract.js

@@ -0,0 +1,359 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CheckContractRuntimeError = void 0;
+exports.resolveCheckContractExitCode = resolveCheckContractExitCode;
+exports.registerCheckContractCommand = registerCheckContractCommand;
+exports.runCheckContract = runCheckContract;
+exports.formatOutput = formatOutput;
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+const rawsql_ts_1 = require("rawsql-ts");
+const sqlCatalogDiscovery_1 = require("../utils/sqlCatalogDiscovery");
+const agentCli_1 = require("../utils/agentCli");
+/**
+ * Resolve command exit code for contract checks.
+ * @param args.result Completed check result when execution succeeded.
+ * @param args.error Error thrown while running checks.
+ * @returns 0 when result is ok, 1 when violations exist or non-runtime errors occur, 2 for runtime/config errors.
+ */
+function resolveCheckContractExitCode(args) {
+    if (args.error) {
+        return args.error instanceof CheckContractRuntimeError ? 2 : 1;
+    }
+    if (!args.result) {
+        return 2;
+    }
+    return args.result.ok ? 0 : 1;
+}
+/** Runtime/configuration error for contract check command (maps to exit code 2). */
+class CheckContractRuntimeError extends Error {
+    constructor() {
+        super(...arguments);
+        this.exitCode = 2;
+    }
+}
+exports.CheckContractRuntimeError = CheckContractRuntimeError;
+/** Register `ztd check contract` command on the CLI root program. */
+function registerCheckContractCommand(program) {
+    const check = program.command('check').description('Contract validation workflows');
+    check
+        .command('contract')
+        .description('Check SQL contract specs deterministically')
+        .option('--format <format>', 'Output format (human|json)')
+        .option('--out <path>', 'Write output to file')
+        .option('--strict', 'Treat safety warnings as violations')
+        .option('--specs-dir <path>', 'Override specs directory (default: src/catalog/specs)')
+        .option('--json <payload>', 'Pass command options as a JSON object')
+        .action(async (options) => {
+        try {
+            const merged = options.json ? { ...options, ...(0, agentCli_1.parseJsonPayload)(options.json, '--json') } : options;
+            const format = resolveCheckOutputFormat(merged.format);
+            const result = runCheckContract({
+                strict: normalizeBooleanOption(merged.strict),
+                rootDir: process.env.ZTD_PROJECT_ROOT,
+                specsDir: normalizeStringOption(merged.specsDir)
+            });
+            const text = formatOutput(result, format);
+            const outPath = normalizeStringOption(merged.out);
+            if (outPath) {
+                const absolute = node_path_1.default.resolve(process.cwd(), outPath);
+                (0, node_fs_1.mkdirSync)(node_path_1.default.dirname(absolute), { recursive: true });
+                (0, node_fs_1.writeFileSync)(absolute, text, 'utf8');
+            }
+            else {
+                const writer = result.ok ? console.log : console.error;
+                writer(text);
+            }
+            process.exitCode = resolveCheckContractExitCode({ result });
+        }
+        catch (error) {
+            process.exitCode = resolveCheckContractExitCode({ error });
+            console.error(error instanceof Error ? error.message : String(error));
+        }
+    });
+}
+function normalizeFormat(format) {
+    const normalized = format.trim().toLowerCase();
+    if (normalized === 'human') {
+        return 'human';
+    }
+    if (normalized === 'json') {
+        return 'json';
+    }
+    throw new CheckContractRuntimeError(`Unsupported format: ${format}`);
+}
+function resolveCheckOutputFormat(value) {
+    const explicitFormat = normalizeStringOption(value);
+    if (explicitFormat) {
+        return normalizeFormat(explicitFormat);
+    }
+    // Map the global CLI output mode onto the contract command's local format names.
+    return (0, agentCli_1.getAgentOutputFormat)() === 'json' ? 'json' : 'human';
+}
+function normalizeStringOption(value) {
+    if (value === undefined || value === null || value === '') {
+        return undefined;
+    }
+    if (typeof value !== 'string') {
+        throw new CheckContractRuntimeError(`Expected a string option but received ${typeof value}.`);
+    }
+    return value;
+}
+function normalizeBooleanOption(value) {
+    if (value === undefined) {
+        return false;
+    }
+    if (typeof value !== 'boolean') {
+        throw new CheckContractRuntimeError(`Expected a boolean option but received ${typeof value}.`);
+    }
+    return value;
+}
+/**
+ * Run deterministic contract checks for catalog specs under a project root.
+ * @param options.strict Treat safety checks as errors when true, warnings otherwise.
+ * @param options.rootDir Optional project root override.
+ * @param options.specsDir Optional specs directory override (relative to rootDir).
+ */
+function runCheckContract(options) {
+    var _a, _b, _c, _d, _e;
+    const root = node_path_1.default.resolve((_a = options.rootDir) !== null && _a !== void 0 ? _a : process.cwd());
+    const specsDir = options.specsDir ? node_path_1.default.resolve(root, options.specsDir) : node_path_1.default.resolve(root, 'src', 'catalog', 'specs');
+    if (!(0, node_fs_1.existsSync)(specsDir)) {
+        throw new CheckContractRuntimeError(`Spec directory not found: ${specsDir}`);
+    }
+    const specFiles = (0, sqlCatalogDiscovery_1.walkSqlCatalogSpecFiles)(specsDir, { excludeTestFiles: true });
+    const loadedSpecs = specFiles.flatMap((filePath) => (0, sqlCatalogDiscovery_1.loadSqlCatalogSpecsFromFile)(filePath, (message) => new CheckContractRuntimeError(message)));
+    const violations = [];
+    const duplicateMap = new Map();
+    for (const loaded of loadedSpecs) {
+        const id = typeof loaded.spec.id === 'string' ? loaded.spec.id.trim() : '';
+        if (!id) {
+            continue;
+        }
+        const list = (_b = duplicateMap.get(id)) !== null && _b !== void 0 ? _b : [];
+        list.push(loaded);
+        duplicateMap.set(id, list);
+    }
+    for (const [id, entries] of Array.from(duplicateMap.entries()).sort((a, b) => a[0].localeCompare(b[0]))) {
+        if (entries.length < 2) {
+            continue;
+        }
+        for (const entry of entries.sort((a, b) => a.filePath.localeCompare(b.filePath))) {
+            violations.push({
+                rule: 'duplicate-spec-id',
+                severity: 'error',
+                specId: id,
+                filePath: entry.filePath,
+                message: `Duplicate spec.id "${id}" detected.`
+            });
+        }
+    }
+    for (const loaded of loadedSpecs.sort((a, b) => {
+        const idA = typeof a.spec.id === 'string' ? a.spec.id : '';
+        const idB = typeof b.spec.id === 'string' ? b.spec.id : '';
+        return idA.localeCompare(idB) || a.filePath.localeCompare(b.filePath);
+    })) {
+        const specId = typeof loaded.spec.id === 'string' && loaded.spec.id.trim().length > 0
+            ? loaded.spec.id.trim()
+            : '<missing-id>';
+        if (typeof loaded.spec.sqlFile !== 'string' || loaded.spec.sqlFile.trim().length === 0) {
+            violations.push({
+                rule: 'unresolved-sql-file',
+                severity: 'error',
+                specId,
+                filePath: loaded.filePath,
+                message: 'spec.sqlFile must be a non-empty string.'
+            });
+        }
+        else {
+            const sqlPath = node_path_1.default.resolve(node_path_1.default.dirname(loaded.filePath), loaded.spec.sqlFile);
+            if (!(0, node_fs_1.existsSync)(sqlPath)) {
+                violations.push({
+                    rule: 'unresolved-sql-file',
+                    severity: 'error',
+                    specId,
+                    filePath: loaded.filePath,
+                    message: `SQL file does not exist: ${loaded.spec.sqlFile}`
+                });
+            }
+            else {
+                applySafetyChecks(sqlPath, specId, loaded.filePath, options.strict, violations);
+            }
+        }
+        const shape = (_c = loaded.spec.params) === null || _c === void 0 ? void 0 : _c.shape;
+        const example = (_d = loaded.spec.params) === null || _d === void 0 ? void 0 : _d.example;
+        if (shape === 'positional' && !Array.isArray(example)) {
+            violations.push({
+                rule: 'params-shape-mismatch',
+                severity: 'error',
+                specId,
+                filePath: loaded.filePath,
+                message: 'params.shape="positional" requires params.example to be an array.'
+            });
+        }
+        else if (shape === 'named' && !(0, sqlCatalogDiscovery_1.isPlainObject)(example)) {
+            violations.push({
+                rule: 'params-shape-mismatch',
+                severity: 'error',
+                specId,
+                filePath: loaded.filePath,
+                message: 'params.shape="named" requires params.example to be an object.'
+            });
+        }
+        const mapping = (_e = loaded.spec.output) === null || _e === void 0 ? void 0 : _e.mapping;
+        if (mapping) {
+            validateMapping(specId, loaded.filePath, mapping, violations);
+        }
+    }
+    const sorted = violations.sort((a, b) => a.rule.localeCompare(b.rule) ||
+        a.specId.localeCompare(b.specId) ||
+        a.filePath.localeCompare(b.filePath) ||
+        a.message.localeCompare(b.message));
+    return {
+        ok: sorted.length === 0 || sorted.every((item) => item.severity === 'warning'),
+        violations: sorted,
+        filesChecked: specFiles.length,
+        specsChecked: loadedSpecs.length
+    };
+}
+function applySafetyChecks(sqlPath, specId, specFilePath, strict, violations) {
+    const sql = (0, node_fs_1.readFileSync)(sqlPath, 'utf8');
+    const chunks = rawsql_ts_1.MultiQuerySplitter.split(sql).queries.filter((item) => !item.isEmpty);
+    for (const chunk of chunks) {
+        const statement = chunk.sql.trim();
+        if (!statement) {
+            continue;
+        }
+        let parsed;
+        try {
+            parsed = rawsql_ts_1.SqlParser.parse(statement);
+        }
+        catch (error) {
+            violations.push({
+                rule: 'sql-parse-error',
+                severity: 'warning',
+                specId,
+                filePath: specFilePath,
+                message: `SQL parse failed in safety check: ${error instanceof Error ? error.message : String(error)}`
+            });
+            continue;
+        }
+        const severity = strict ? 'error' : 'warning';
+        if (parsed instanceof rawsql_ts_1.UpdateQuery || parsed instanceof rawsql_ts_1.DeleteQuery) {
+            if (!parsed.whereClause) {
+                violations.push({
+                    rule: 'safety-missing-where',
+                    severity,
+                    specId,
+                    filePath: specFilePath,
+                    message: 'UPDATE/DELETE statement without WHERE detected.'
+                });
+            }
+            continue;
+        }
+        if (hasRootLevelSelectWildcard(parsed)) {
+            violations.push({
+                rule: 'safety-select-star',
+                severity,
+                specId,
+                filePath: specFilePath,
+                message: 'SELECT * detected at root query level.'
+            });
+        }
+    }
+}
+function hasRootLevelSelectWildcard(parsed) {
+    if (parsed instanceof rawsql_ts_1.SimpleSelectQuery) {
+        return parsed.selectClause.items.some((item) => isWildcardSelectItem(item.value));
+    }
+    if (parsed instanceof rawsql_ts_1.BinarySelectQuery) {
+        return hasRootLevelSelectWildcard(parsed.left) || hasRootLevelSelectWildcard(parsed.right);
+    }
+    return false;
+}
+function isWildcardSelectItem(value) {
+    return value instanceof rawsql_ts_1.ColumnReference && value.column.name === '*';
+}
+function validateMapping(specId, filePath, mapping, violations) {
+    const hasPrefix = typeof mapping.prefix === 'string' && mapping.prefix.trim().length > 0;
+    if (!hasPrefix && mapping.columnMap === undefined) {
+        violations.push({
+            rule: 'mapping-invalid-entry',
+            severity: 'error',
+            specId,
+            filePath,
+            message: 'output.mapping must provide prefix or columnMap.'
+        });
+        return;
+    }
+    if (mapping.columnMap === undefined) {
+        return;
+    }
+    if (!(0, sqlCatalogDiscovery_1.isPlainObject)(mapping.columnMap)) {
+        violations.push({
+            rule: 'mapping-invalid-entry',
+            severity: 'error',
+            specId,
+            filePath,
+            message: 'output.mapping.columnMap must be an object when provided.'
+        });
+        return;
+    }
+    const seenColumns = new Map();
+    for (const key of Object.keys(mapping.columnMap).sort()) {
+        const value = mapping.columnMap[key];
+        if (!key.trim()) {
+            violations.push({
+                rule: 'mapping-invalid-entry',
+                severity: 'error',
+                specId,
+                filePath,
+                message: 'output.mapping.columnMap keys must be non-empty strings.'
+            });
+            continue;
+        }
+        if (typeof value !== 'string' || value.trim().length === 0) {
+            violations.push({
+                rule: 'mapping-invalid-entry',
+                severity: 'error',
+                specId,
+                filePath,
+                message: `output.mapping.columnMap["${key}"] must be a non-empty string.`
+            });
+            continue;
+        }
+        const normalized = value.trim();
+        const prev = seenColumns.get(normalized);
+        if (prev) {
+            violations.push({
+                rule: 'mapping-duplicate-entry',
+                severity: 'error',
+                specId,
+                filePath,
+                message: `Duplicate mapped column "${normalized}" for keys "${prev}" and "${key}".`
+            });
+            continue;
+        }
+        seenColumns.set(normalized, key);
+    }
+}
+/** Format check results into human text or deterministic JSON text. */
+function formatOutput(result, format) {
+    if (format === 'json') {
+        return `${JSON.stringify(result, null, 2)}\n`;
+    }
+    if (result.violations.length === 0) {
+        return `contract check passed (${result.specsChecked} specs in ${result.filesChecked} files)`;
+    }
+    const lines = [];
+    lines.push(`contract check found ${result.violations.length} violation(s)`);
+    for (const item of result.violations) {
+        lines.push(`- [${item.severity}] ${item.rule} ${item.specId} @ ${item.filePath}`);
+        lines.push(`  ${item.message}`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=checkContract.js.map

package/dist/commands/checkContract.js.map

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

package/dist/commands/connectionOptions.d.ts

@@ -0,0 +1,12 @@
+import type { DbConnectionFlags, ResolvedDatabaseConnection } from '../utils/dbConnection';
+export interface ConnectionCliOptions {
+    url?: string;
+    dbHost?: string;
+    dbPort?: string;
+    dbUser?: string;
+    dbPassword?: string;
+    dbName?: string;
+}
+export declare function resolveExplicitCliConnection(options: ConnectionCliOptions): ResolvedDatabaseConnection;
+export declare function resolveZtdOwnedCliConnection(): ResolvedDatabaseConnection;
+export declare function buildFlagSet(options: ConnectionCliOptions): DbConnectionFlags;

package/dist/commands/connectionOptions.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveExplicitCliConnection = resolveExplicitCliConnection;
+exports.resolveZtdOwnedCliConnection = resolveZtdOwnedCliConnection;
+exports.buildFlagSet = buildFlagSet;
+const dbConnection_1 = require("../utils/dbConnection");
+function resolveExplicitCliConnection(options) {
+    return (0, dbConnection_1.resolveExplicitTargetConnection)(buildFlagSet(options), options.url);
+}
+function resolveZtdOwnedCliConnection() {
+    return (0, dbConnection_1.resolveZtdOwnedTestConnection)();
+}
+function buildFlagSet(options) {
+    return {
+        host: options.dbHost,
+        port: options.dbPort,
+        user: options.dbUser,
+        password: options.dbPassword,
+        database: options.dbName
+    };
+}
+//# sourceMappingURL=connectionOptions.js.map

package/dist/commands/connectionOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connectionOptions.js","sourceRoot":"","sources":["../../src/commands/connectionOptions.ts"],"names":[],"mappings":";;AAeA,oEAEC;AAED,oEAEC;AAED,oCAQC;AA/BD,wDAG+B;AAY/B,SAAgB,4BAA4B,CAAC,OAA6B;IACxE,OAAO,IAAA,8CAA+B,EAAC,YAAY,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;AAC7E,CAAC;AAED,SAAgB,4BAA4B;IAC1C,OAAO,IAAA,4CAA6B,GAAE,CAAC;AACzC,CAAC;AAED,SAAgB,YAAY,CAAC,OAA6B;IACxD,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,MAAM;QACpB,IAAI,EAAE,OAAO,CAAC,MAAM;QACpB,IAAI,EAAE,OAAO,CAAC,MAAM;QACpB,QAAQ,EAAE,OAAO,CAAC,UAAU;QAC5B,QAAQ,EAAE,OAAO,CAAC,MAAM;KACzB,CAAC;AACJ,CAAC"}

package/dist/commands/ddl.d.ts

@@ -0,0 +1,7 @@
+import { Command } from 'commander';
+/**
+ * Registers all DDL-related commands (`pull`, `gen-entities`, `diff`) on the top-level CLI program.
+ * @param program - The Commander program instance to extend.
+ */
+export declare function registerDdlCommands(program: Command): void;
+export { collectDirectories, parseExtensions, DEFAULT_EXTENSIONS, DEFAULT_DDL_DIRECTORY } from './options';