@negusdev/dbask 0.0.0-stage → 0.1.8

package/dist/cli-args.d.ts

@@ -0,0 +1,26 @@
+import type { ResponseMode } from './core/agent/agent.js';
+export type CliCommand = {
+    kind: 'help';
+} | {
+    kind: 'version';
+} | {
+    kind: 'init';
+    args: string[];
+} | {
+    kind: 'validate';
+    args: string[];
+} | {
+    kind: 'ask';
+    mode: ResponseMode;
+    question: string;
+} | {
+    kind: 'error';
+    message: string;
+    showUsage?: boolean;
+};
+/**
+ * Parses `dbask <command>` and the shorthand `dbask "your question"`.
+ * `ask` still works, so existing scripts keep running.
+ */
+export declare function parseCli(argv: string[]): CliCommand;
+//# sourceMappingURL=cli-args.d.ts.map

package/dist/cli-args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-args.d.ts","sourceRoot":"","sources":["../src/cli-args.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAkE5D;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAWnD"}

package/dist/cli-args.js

@@ -0,0 +1,72 @@
+const MODES = ['natural', 'technical', 'debug'];
+const OPTION_LIKE = /^--?[A-Za-z]/;
+function parseAsk(args, implicit) {
+    let mode = 'natural';
+    const words = [];
+    for (let i = 0; i < args.length; i += 1) {
+        const arg = args[i] ?? '';
+        if (arg === '--') {
+            words.push(...args.slice(i + 1));
+            break;
+        }
+        if (arg === '--help' || arg === '-h')
+            return { kind: 'help' };
+        if (arg === '--mode' || arg.startsWith('--mode=')) {
+            const value = arg === '--mode' ? args[++i] : arg.slice('--mode='.length);
+            if (!MODES.includes(value)) {
+                return { kind: 'error', message: 'Invalid response mode. Use natural, technical, or debug.' };
+            }
+            mode = value;
+            continue;
+        }
+        if (arg === '--technical') {
+            mode = 'technical';
+            continue;
+        }
+        if (arg === '--debug') {
+            mode = 'debug';
+            continue;
+        }
+        // A mistyped option must not be sent to the model as part of the question.
+        if (OPTION_LIKE.test(arg)) {
+            return { kind: 'error', message: `Unknown option: ${arg}`, showUsage: true };
+        }
+        words.push(arg);
+    }
+    const question = words.join(' ').trim();
+    if (!question) {
+        return { kind: 'error', message: 'a question is required.', showUsage: implicit };
+    }
+    // `dbask valdiate` is far more likely a mistyped command than a one-word
+    // question, and sending it to the model would cost a request. A question mark
+    // or a second word makes it a question; `dbask ask <word>` always works.
+    if (implicit && words.length === 1 && !/\s/.test(question) && !question.includes('?')) {
+        return {
+            kind: 'error',
+            message: `Unknown command: ${question}. To ask a one-word question, use: dbask ask ${question}`,
+            showUsage: true,
+        };
+    }
+    return { kind: 'ask', mode, question };
+}
+/**
+ * Parses `dbask <command>` and the shorthand `dbask "your question"`.
+ * `ask` still works, so existing scripts keep running.
+ */
+export function parseCli(argv) {
+    const [first, ...rest] = argv;
+    if (first === undefined)
+        return { kind: 'help' };
+    if (first === 'help' || first === '--help' || first === '-h')
+        return { kind: 'help' };
+    if (first === '--version' || first === '-v')
+        return { kind: 'version' };
+    if (first === 'init')
+        return { kind: 'init', args: rest };
+    if (first === 'validate')
+        return { kind: 'validate', args: rest };
+    if (first === 'ask')
+        return parseAsk(rest, false);
+    return parseAsk(argv, true);
+}
+//# sourceMappingURL=cli-args.js.map

package/dist/cli-args.js.map

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

package/dist/cli-observer.d.ts

@@ -0,0 +1,23 @@
+import type { AgentObserver, AgentToolEvent } from './core/agent/observability.js';
+import type { Spinner } from './ui/spinner.js';
+import { type Style } from './ui/style.js';
+/** Lines describing a submitted plan; tolerates plans that do not match the schema. */
+export declare function describePlan(input: unknown): Array<[string, string]>;
+export interface CliObserverOptions {
+    /** Print the full tool trace. Without it only the spinner shows progress. */
+    verbose?: boolean;
+    style?: Style;
+    spinner?: Spinner;
+    width?: number;
+}
+export declare class CliAgentObserver implements AgentObserver {
+    private readonly verbose;
+    private readonly style;
+    private readonly spinner?;
+    private readonly width;
+    constructor(options?: CliObserverOptions);
+    onToolEvent(event: AgentToolEvent): void;
+    private printPlain;
+    private printRich;
+}
+//# sourceMappingURL=cli-observer.d.ts.map

package/dist/cli-observer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-observer.d.ts","sourceRoot":"","sources":["../src/cli-observer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACf,MAAM,+BAA+B,CAAC;AAEvC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAA+C,KAAK,KAAK,EAAE,MAAM,eAAe,CAAC;AAmFxF,uFAAuF;AACvF,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAuBpE;AAwBD,MAAM,WAAW,kBAAkB;IACjC,6EAA6E;IAC7E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,gBAAiB,YAAW,aAAa;IACpD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAU;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAE/B,YAAY,OAAO,GAAE,kBAAuB,EAK3C;IAED,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAoBvC;IAED,OAAO,CAAC,UAAU;IAkDlB,OAAO,CAAC,SAAS;CAyDlB"}

package/dist/cli-observer.js

@@ -0,0 +1,224 @@
+import process from 'node:process';
+import { highlightSql } from './ui/sql-highlight.js';
+import { createStyle, terminalWidth, truncateVisible } from './ui/style.js';
+function formatInput(input) {
+    if (!input || typeof input !== 'object') {
+        return String(input ?? '');
+    }
+    const value = input;
+    if (typeof value.sql === 'string') {
+        return value.sql;
+    }
+    return JSON.stringify(value);
+}
+function getRowCount(data) {
+    if (!data || typeof data !== 'object')
+        return undefined;
+    const value = data;
+    if (typeof value.rowCount === 'number') {
+        return value.rowCount;
+    }
+    if (Array.isArray(value.rows)) {
+        return value.rows.length;
+    }
+    return undefined;
+}
+function emitStructuredEvent(event) {
+    if (process.env.SQL_AI_TRACE_JSON !== '1')
+        return;
+    if (event.type !== 'tool-end')
+        return;
+    try {
+        const json = JSON.stringify({
+            source: 'dbask',
+            ...event,
+        }, (_key, value) => typeof value === 'bigint' ? value.toString() : value);
+        if (json) {
+            // One complete JSON object per line, on stderr.
+            console.error(json);
+        }
+    }
+    catch (error) {
+        console.error(JSON.stringify({
+            source: 'dbask',
+            type: 'trace-serialization-error',
+            message: error instanceof Error ? error.message : String(error),
+        }));
+    }
+}
+const SPINNER_LABELS = {
+    get_relationships: 'Checking foreign keys',
+    list_tables: 'Listing tables',
+    describe_table: 'Inspecting schema',
+    describe_tables: 'Inspecting schema',
+    submit_query_plan: 'Checking the query plan',
+    execute_query: 'Running query',
+    explain_query: 'Explaining query',
+};
+function asRecord(value) {
+    return value && typeof value === 'object' && !Array.isArray(value) ? value : undefined;
+}
+function refName(ref) {
+    const record = asRecord(ref);
+    return record ? `${String(record.table ?? '?')}.${String(record.column ?? '?')}` : String(ref);
+}
+/** Lines describing a submitted plan; tolerates plans that do not match the schema. */
+export function describePlan(input) {
+    const plan = asRecord(input);
+    if (!plan)
+        return [];
+    const rows = [];
+    const list = (value) => (Array.isArray(value) ? value : []);
+    if (typeof plan.objective === 'string')
+        rows.push(['objective', plan.objective]);
+    if (list(plan.tables).length)
+        rows.push(['tables', list(plan.tables).join(', ')]);
+    if (list(plan.fields).length)
+        rows.push(['fields', list(plan.fields).map(refName).join(', ')]);
+    const joins = list(plan.joins).map((join) => {
+        const record = asRecord(join);
+        return record && ('left' in record || 'right' in record)
+            ? `${refName(record.left)} = ${refName(record.right)}`
+            : String(join);
+    });
+    if (joins.length)
+        rows.push(['joins', joins.join('; ')]);
+    if (list(plan.filters).length)
+        rows.push(['filters', list(plan.filters).join('; ')]);
+    if (list(plan.aggregations).length)
+        rows.push(['aggregates', list(plan.aggregations).join('; ')]);
+    if (list(plan.sorting).length)
+        rows.push(['sorting', list(plan.sorting).join('; ')]);
+    return rows;
+}
+function summarize(name, data) {
+    const count = (n, noun) => `${n} ${noun}${n === 1 ? '' : 's'}`;
+    if (name === 'list_tables' || name === 'describe_tables') {
+        return Array.isArray(data) ? count(data.length, 'table') : '';
+    }
+    if (name === 'get_relationships') {
+        return Array.isArray(data) ? count(data.length, 'relationship') : '';
+    }
+    if (name === 'describe_table') {
+        const columns = asRecord(data)?.columns;
+        return Array.isArray(columns) ? count(columns.length, 'column') : '';
+    }
+    const rows = getRowCount(data);
+    if (rows !== undefined) {
+        return `${count(rows, 'row')}${asRecord(data)?.truncated === true ? ' (truncated)' : ''}`;
+    }
+    return '';
+}
+export class CliAgentObserver {
+    verbose;
+    style;
+    spinner;
+    width;
+    constructor(options = {}) {
+        this.verbose = options.verbose ?? true;
+        this.style = options.style ?? createStyle(process.stderr);
+        this.spinner = options.spinner;
+        this.width = options.width ?? terminalWidth(process.stderr);
+    }
+    onToolEvent(event) {
+        if (!this.verbose) {
+            if (event.type === 'tool-start') {
+                this.spinner?.update(SPINNER_LABELS[event.name] ?? 'Working');
+            }
+            else {
+                this.spinner?.update('Thinking');
+            }
+            return;
+        }
+        // Emit the structured event before the human-readable diagnostic.
+        emitStructuredEvent(event);
+        this.spinner?.clear();
+        if (this.style.rich)
+            this.printRich(event);
+        else
+            this.printPlain(event);
+        this.spinner?.update(event.type === 'tool-start' ? SPINNER_LABELS[event.name] ?? 'Working' : 'Thinking');
+        this.spinner?.resume();
+    }
+    printPlain(event) {
+        if (event.type === 'tool-start') {
+            console.error(`\n[tool] ${event.name}`);
+            const input = formatInput(event.input);
+            if (!input)
+                return;
+            if (typeof event.input === 'object' &&
+                event.input !== null &&
+                'sql' in event.input) {
+                console.error('[sql]');
+                console.error(input);
+            }
+            else {
+                console.error(`[input] ${input}`);
+            }
+            return;
+        }
+        if (event.success) {
+            const rowCount = getRowCount(event.data);
+            const rows = rowCount === undefined
+                ? ''
+                : `, ${rowCount} row${rowCount === 1 ? '' : 's'}`;
+            console.error(`[done] ${event.name} (${event.durationMs}ms${rows})`);
+            if (event.name === 'submit_query_plan') {
+                const data = asRecord(event.data);
+                const max = data?.maxSubmissions;
+                console.error(`[plan] accepted (submission ${String(data?.submission ?? '?')}${typeof max === 'number' ? ` of ${max}` : ''})`);
+                const warnings = Array.isArray(data?.warnings) ? data.warnings : [];
+                for (const warning of warnings)
+                    console.error(`[warn] ${String(warning)}`);
+            }
+        }
+        else {
+            console.error(`[error] ${event.name} (${event.durationMs}ms): ${event.error ?? 'Unknown error'}`);
+        }
+    }
+    printRich(event) {
+        const { style } = this;
+        const room = Math.max(20, this.width - 6);
+        if (event.type === 'tool-start') {
+            console.error(`\n${style.cyan('▸')} ${style.bold(event.name)}`);
+            if (event.name === 'submit_query_plan') {
+                for (const [label, value] of describePlan(event.input)) {
+                    console.error(`  ${style.dim(label.padEnd(10))} ${truncateVisible(value, room - 10)}`);
+                }
+                return;
+            }
+            const record = asRecord(event.input);
+            if (typeof record?.sql === 'string') {
+                highlightSql(record.sql.trim(), style)
+                    .split('\n')
+                    .forEach((line) => console.error(`  ${style.dim('│')} ${line}`));
+                return;
+            }
+            if (Array.isArray(record?.tables)) {
+                console.error(`  ${style.dim(record.tables.join(', '))}`);
+                return;
+            }
+            if (typeof record?.table === 'string') {
+                console.error(`  ${style.dim(record.table)}`);
+            }
+            return;
+        }
+        if (!event.success) {
+            console.error(`  ${style.red('✗')} ${style.red(event.error ?? 'Unknown error')} ${style.dim(`${event.durationMs}ms`)}`);
+            return;
+        }
+        const data = asRecord(event.data);
+        const detail = summarize(event.name, event.data);
+        const parts = [`${event.durationMs}ms`, ...(detail ? [detail] : [])];
+        if (event.name === 'submit_query_plan') {
+            const max = data?.maxSubmissions;
+            parts.unshift(`accepted ${String(data?.submission ?? '?')}${typeof max === 'number' ? `/${max}` : ''}`);
+        }
+        console.error(`  ${style.green('✓')} ${style.dim(parts.join(' · '))}`);
+        const warnings = Array.isArray(data?.warnings) ? data.warnings : [];
+        for (const warning of warnings) {
+            console.error(`  ${style.yellow('⚠')} ${style.yellow(String(warning))}`);
+        }
+    }
+}
+//# sourceMappingURL=cli-observer.js.map

package/dist/cli-observer.js.map

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

package/dist/cli.d.ts

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

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -0,0 +1,127 @@
+#!/usr/bin/env node
+import { Agent } from './core/agent/index.js';
+import { loadConfig } from './config/config.js';
+import { createDatabaseAdapter } from './database/index.js';
+import { createAiProvider } from './ai/factory.js';
+import { CliAgentObserver } from './cli-observer.js';
+import { SchemaCache } from './schema/cache.js';
+import { createRequire } from 'node:module';
+import { parseCli } from './cli-args.js';
+import { loadDatabaseContext } from './context/db-context.js';
+import { runInit } from './commands/init.js';
+import { runValidate } from './commands/validate.js';
+import { renderMarkdown } from './ui/markdown.js';
+import { Spinner } from './ui/spinner.js';
+import { createStyle, terminalWidth } from './ui/style.js';
+function printUsage() {
+    const s = createStyle(process.stdout);
+    console.log(`${s.bold('Usage:')}
+  dbask "your question" [--mode natural|technical|debug]
+  dbask init [--force]
+  dbask validate [--skip-provider]
+  dbask --version
+
+${s.dim('dbask ask "your question" is the same as dbask "your question".')}
+
+${s.cyan('validate')} checks your configuration, database connection, foreign keys, and sends
+one tiny request to the AI provider (use --skip-provider to avoid it). It never
+reads table data or runs model-written SQL.
+
+${s.bold('Modes:')}
+  ${s.cyan('natural')}    Business-friendly answer (default)
+  ${s.cyan('technical')}  Include useful SQL and technical details
+  ${s.cyan('debug')}      Technical answer plus tool execution diagnostics`);
+}
+async function main() {
+    const command = parseCli(process.argv.slice(2));
+    switch (command.kind) {
+        case 'help':
+            printUsage();
+            return;
+        case 'version':
+            console.log(createRequire(import.meta.url)('../package.json').version);
+            return;
+        case 'init':
+            await runInit(command.args);
+            return;
+        case 'validate':
+            await runValidate(command.args);
+            return;
+        case 'error':
+            console.error(`${createStyle(process.stderr).red('Error:')} ${command.message}`);
+            if (command.showUsage)
+                console.error('Run dbask --help for usage.');
+            process.exitCode = 1;
+            return;
+        case 'ask':
+            break;
+    }
+    const { mode, question } = command;
+    const config = loadConfig();
+    const errStyle = createStyle(process.stderr);
+    const outStyle = createStyle(process.stdout);
+    if (errStyle.rich) {
+        console.error(errStyle.dim(`dbask · ${config.ai.provider}/${config.ai.model} · ${config.database.driver}:${config.database.name || 'unnamed'}`));
+    }
+    const spinner = new Spinner(process.stderr, errStyle);
+    const database = createDatabaseAdapter(config.database);
+    const provider = createAiProvider(config.ai);
+    const databaseContext = await loadDatabaseContext();
+    const schemaCache = new SchemaCache({ ttlMs: config.schema.cacheTtlMs });
+    const agent = new Agent(provider, {
+        database,
+        safety: config.safety,
+        schemaCache,
+    }, {
+        maxSteps: config.agent.maxSteps,
+        requirePlan: config.agent.queryPlan,
+        observer: new CliAgentObserver({
+            verbose: mode === 'debug',
+            style: errStyle,
+            spinner,
+        }),
+        databaseContext,
+        responseMode: mode,
+    });
+    try {
+        spinner.start('Thinking');
+        const result = await agent.ask(question).finally(() => spinner.stop());
+        if (result.incomplete) {
+            console.error(`\n${errStyle.red('Error:')} ${result.text}`);
+            process.exitCode = 1;
+        }
+        else {
+            console.log('\n' + renderMarkdown(result.text, outStyle, terminalWidth(process.stdout)));
+        }
+        if (mode === 'debug') {
+            const steps = `${result.steps} step${result.steps === 1 ? '' : 's'}`;
+            const calls = `${result.toolCalls} tool call${result.toolCalls === 1 ? '' : 's'}`;
+            const plan = result.plan;
+            if (errStyle.rich) {
+                const parts = [steps, calls];
+                if (plan) {
+                    parts.push(`plan ${plan.accepted} accepted` +
+                        (plan.rejected ? `, ${plan.rejected} rejected` : '') +
+                        (plan.sqlMismatches ? `, ${plan.sqlMismatches} SQL mismatch${plan.sqlMismatches === 1 ? '' : 'es'}` : ''));
+                }
+                const mark = result.incomplete ? errStyle.red('✗') : errStyle.green('✓');
+                console.error(`\n${mark} ${errStyle.dim(parts.join(' · '))}`);
+            }
+            else {
+                console.error(`\n[agent] ${steps}, ${calls}`);
+                if (plan) {
+                    console.error(`[plan] ${plan.submitted} submitted, ${plan.accepted} accepted, ${plan.rejected} rejected, ${plan.sqlMismatches} SQL mismatches`);
+                }
+            }
+        }
+    }
+    finally {
+        spinner.stop();
+        await database.close?.();
+    }
+}
+main().catch((error) => {
+    console.error(`\n${createStyle(process.stderr).red('Error:')} ${error instanceof Error ? error.message : String(error)}`);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE3D,SAAS,UAAU;IACjB,MAAM,CAAC,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACtC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC;;;;;;EAM/B,CAAC,CAAC,GAAG,CAAC,iEAAiE,CAAC;;EAExE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC;;;;EAIlB,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC;IACd,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC;IACjB,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC;IACnB,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,wDAAwD,CAAC,CAAC;AAC7E,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAEhD,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;QACrB,KAAK,MAAM;YACT,UAAU,EAAE,CAAC;YACb,OAAO;QACT,KAAK,SAAS;YACZ,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,iBAAiB,CAAC,CAAC,OAAiB,CAAC,CAAC;YACjF,OAAO;QACT,KAAK,MAAM;YACT,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC5B,OAAO;QACT,KAAK,UAAU;YACb,MAAM,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAChC,OAAO;QACT,KAAK,OAAO;YACV,OAAO,CAAC,KAAK,CAAC,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;YACjF,IAAI,OAAO,CAAC,SAAS;gBAAE,OAAO,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;YACpE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,KAAK,KAAK;YACR,MAAM;IACV,CAAC;IAED,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IAEnC,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAE7C,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;QAClB,OAAO,CAAC,KAAK,CACX,QAAQ,CAAC,GAAG,CACV,WAAW,MAAM,CAAC,EAAE,CAAC,QAAQ,IAAI,MAAM,CAAC,EAAE,CAAC,KAAK,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,IAAI,SAAS,EAAE,CACpH,CACF,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACtD,MAAM,QAAQ,GAAG,qBAAqB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAExD,MAAM,QAAQ,GAAG,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC7C,MAAM,eAAe,GAAG,MAAM,mBAAmB,EAAE,CAAC;IACpD,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;IACzE,MAAM,KAAK,GAAG,IAAI,KAAK,CACrB,QAAQ,EACR;QACE,QAAQ;QACR,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,WAAW;KACZ,EACD;QACE,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,QAAQ;QAC/B,WAAW,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS;QACnC,QAAQ,EAAE,IAAI,gBAAgB,CAAC;YAC7B,OAAO,EAAE,IAAI,KAAK,OAAO;YACzB,KAAK,EAAE,QAAQ;YACf,OAAO;SACR,CAAC;QACF,eAAe;QACf,YAAY,EAAE,IAAI;KACnB,CACF,CAAC;IAEF,IAAI,CAAC;QACH,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC1B,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QAEvE,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YACtB,OAAO,CAAC,KAAK,CAAC,KAAK,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;YAC5D,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACvB,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,cAAc,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC3F,CAAC;QAED,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;YACrB,MAAM,KAAK,GAAG,GAAG,MAAM,CAAC,KAAK,QAAQ,MAAM,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;YACrE,MAAM,KAAK,GAAG,GAAG,MAAM,CAAC,SAAS,aAAa,MAAM,CAAC,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;YAClF,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;YAEzB,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;gBAClB,MAAM,KAAK,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;gBAC7B,IAAI,IAAI,EAAE,CAAC;oBACT,KAAK,CAAC,IAAI,CACR,QAAQ,IAAI,CAAC,QAAQ,WAAW;wBAC9B,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,QAAQ,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;wBACpD,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,aAAa,gBAAgB,IAAI,CAAC,aAAa,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAC5G,CAAC;gBACJ,CAAC;gBACD,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBACzE,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;YAChE,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,KAAK,CAAC,aAAa,KAAK,KAAK,KAAK,EAAE,CAAC,CAAC;gBAC9C,IAAI,IAAI,EAAE,CAAC;oBACT,OAAO,CAAC,KAAK,CACX,UAAU,IAAI,CAAC,SAAS,eAAe,IAAI,CAAC,QAAQ,cAAc,IAAI,CAAC,QAAQ,cAAc,IAAI,CAAC,aAAa,iBAAiB,CACjI,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;YAAS,CAAC;QACT,OAAO,CAAC,IAAI,EAAE,CAAC;QACf,MAAM,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC;IAC3B,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,KAAK,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC1H,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}

package/dist/commands/init.d.ts

@@ -0,0 +1,2 @@
+export declare function runInit(args?: string[]): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAgHA,wBAAsB,OAAO,CAAC,IAAI,GAAE,MAAM,EAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CA+HhE"}