@vinkius-core/mcp-fusion 3.1.4 → 3.1.6

package/dist/cli/commands/lock.js

@@ -0,0 +1,94 @@
+/**
+ * `fusion lock` — generate or verify capability lockfile.
+ * @module
+ */
+import { compileContracts } from '../../introspection/ToolContract.js';
+import { generateLockfile, writeLockfile, readLockfile, checkLockfile, serializeLockfile, LOCKFILE_NAME, } from '../../introspection/CapabilityLockfile.js';
+import { ProgressTracker } from '../progress.js';
+import { MCP_FUSION_VERSION } from '../constants.js';
+import { resolveRegistry } from '../registry.js';
+import { inferServerEntry } from '../utils.js';
+/** @internal exported for testing */
+export async function commandLock(args, reporter) {
+    const progress = new ProgressTracker(reporter);
+    if (!args.server) {
+        const detected = inferServerEntry(args.cwd);
+        if (!detected) {
+            console.error('Error: Could not auto-detect server entrypoint.\n');
+            console.error('Usage: fusion lock --server ./src/server.ts');
+            process.exit(1);
+        }
+        args.server = detected;
+    }
+    // Step 1: Resolve & load
+    progress.start('resolve', 'Resolving server entrypoint');
+    const { registry, name: serverName, promptRegistry } = await resolveRegistry(args.server);
+    const displayName = args.name ?? serverName;
+    progress.done('resolve', `Resolving (${displayName})`);
+    // Step 2: Compile tool contracts
+    progress.start('compile', 'Compiling tool contracts');
+    const builders = [...registry.getBuilders()];
+    const contracts = await compileContracts(builders);
+    const toolCount = Object.keys(contracts).length;
+    progress.done('compile', 'Compiling tool contracts', `${toolCount} tool${toolCount !== 1 ? 's' : ''}`);
+    // Step 3: Discover prompts
+    progress.start('prompts', 'Discovering prompts');
+    const promptBuilders = [];
+    if (promptRegistry && typeof promptRegistry.getBuilders === 'function') {
+        promptBuilders.push(...promptRegistry.getBuilders());
+    }
+    const options = promptBuilders.length > 0 ? { prompts: promptBuilders } : undefined;
+    const promptCount = promptBuilders.length;
+    progress.done('prompts', 'Discovering prompts', `${promptCount} prompt${promptCount !== 1 ? 's' : ''}`);
+    if (args.check) {
+        // ── Check Mode ──
+        progress.start('read', 'Reading existing lockfile');
+        const existing = await readLockfile(args.cwd);
+        if (!existing) {
+            progress.fail('read', 'Reading existing lockfile', `${LOCKFILE_NAME} not found — run: fusion lock`);
+            process.exit(1);
+        }
+        progress.done('read', 'Reading existing lockfile');
+        progress.start('verify', 'Verifying integrity');
+        const result = await checkLockfile(existing, contracts);
+        if (result.ok) {
+            progress.done('verify', 'Verifying integrity', 'up to date');
+            console.log(`\n✓ ${LOCKFILE_NAME} is up to date.`);
+            process.exit(0);
+        }
+        else {
+            progress.fail('verify', 'Verifying integrity', 'stale');
+            console.error(`\n✗ ${result.message}`);
+            if (result.added.length > 0)
+                console.error(`  + Tools added: ${result.added.join(', ')}`);
+            if (result.removed.length > 0)
+                console.error(`  - Tools removed: ${result.removed.join(', ')}`);
+            if (result.changed.length > 0)
+                console.error(`  ~ Tools changed: ${result.changed.join(', ')}`);
+            if (result.addedPrompts.length > 0)
+                console.error(`  + Prompts added: ${result.addedPrompts.join(', ')}`);
+            if (result.removedPrompts.length > 0)
+                console.error(`  - Prompts removed: ${result.removedPrompts.join(', ')}`);
+            if (result.changedPrompts.length > 0)
+                console.error(`  ~ Prompts changed: ${result.changedPrompts.join(', ')}`);
+            process.exit(1);
+        }
+    }
+    else {
+        // ── Generate Mode ──
+        progress.start('generate', 'Computing behavioral digests');
+        const lockfile = await generateLockfile(displayName, contracts, MCP_FUSION_VERSION, options);
+        progress.done('generate', 'Computing behavioral digests');
+        progress.start('write', `Writing ${LOCKFILE_NAME}`);
+        await writeLockfile(lockfile, args.cwd);
+        progress.done('write', `Writing ${LOCKFILE_NAME}`);
+        const tc = Object.keys(lockfile.capabilities.tools).length;
+        const pc = lockfile.capabilities.prompts ? Object.keys(lockfile.capabilities.prompts).length : 0;
+        const parts = [`${tc} tool${tc !== 1 ? 's' : ''}`];
+        if (pc > 0)
+            parts.push(`${pc} prompt${pc !== 1 ? 's' : ''}`);
+        console.log(`\n✓ ${LOCKFILE_NAME} generated (${parts.join(', ')}).`);
+        console.log(`  Integrity: ${lockfile.integrityDigest}`);
+    }
+}
+//# sourceMappingURL=lock.js.map

package/dist/cli/commands/lock.js.map

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

package/dist/cli/commands/remote.d.ts

@@ -0,0 +1,3 @@
+import type { CliArgs } from '../args.js';
+export declare function commandRemote(args: CliArgs): Promise<void>;
+//# sourceMappingURL=remote.d.ts.map

package/dist/cli/commands/remote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/remote.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAI1C,wBAAsB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAiChE"}

package/dist/cli/commands/remote.js

@@ -0,0 +1,37 @@
+/**
+ * `fusion remote` — manage .fusionrc cloud configuration.
+ * @module
+ */
+import { resolve } from 'node:path';
+import { ansi, VINKIUS_CLOUD_URL } from '../constants.js';
+import { FUSIONRC, readFusionRc, writeFusionRc } from '../rc.js';
+export async function commandRemote(args) {
+    const cwd = args.cwd;
+    // fusion remote <url> [--server-id <id>] — set one or both at once
+    // fusion remote --server-id <id>        — uses default Vinkius Cloud URL
+    if (args.remoteUrl || args.serverId) {
+        const remote = args.remoteUrl ?? VINKIUS_CLOUD_URL;
+        writeFusionRc(cwd, {
+            remote,
+            ...(args.serverId ? { serverId: args.serverId } : {}),
+        });
+        process.stderr.write(`  ${ansi.green('✓')} Remote set to ${ansi.cyan(remote)}${remote === VINKIUS_CLOUD_URL ? ansi.dim(' (default)') : ''}\n`);
+        if (args.serverId) {
+            process.stderr.write(`  ${ansi.green('✓')} Server ID set to ${ansi.cyan(args.serverId)}\n`);
+        }
+        return;
+    }
+    // fusion remote — print current config
+    const config = readFusionRc(cwd);
+    if (!config.remote && !config.serverId) {
+        process.stderr.write(`  ${ansi.yellow('⚠')} No remote configured.\n\n`);
+        process.stderr.write(`  ${ansi.dim('Quick setup:')}\n`);
+        process.stderr.write(`    ${ansi.cyan('$')} fusion remote --server-id <uuid>\n\n`);
+        return;
+    }
+    process.stderr.write(`\n  ${ansi.bold('Remote Configuration')}\n\n`);
+    process.stderr.write(`  ${ansi.dim('API:')}       ${config.remote ?? ansi.yellow('not set')}\n`);
+    process.stderr.write(`  ${ansi.dim('Server:')}    ${config.serverId ?? ansi.yellow('not set')}\n`);
+    process.stderr.write(`  ${ansi.dim('Config:')}    ${resolve(cwd, FUSIONRC)}\n\n`);
+}
+//# sourceMappingURL=remote.js.map

package/dist/cli/commands/remote.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote.js","sourceRoot":"","sources":["../../../src/cli/commands/remote.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEjE,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAa;IAC7C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;IAErB,mEAAmE;IACnE,yEAAyE;IACzE,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,IAAI,iBAAiB,CAAC;QAEnD,aAAa,CAAC,GAAG,EAAE;YACf,MAAM;YACN,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACxD,CAAC,CAAC;QAEH,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,kBAAkB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,MAAM,KAAK,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QAC/I,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAChB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,qBAAqB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAChG,CAAC;QACD,OAAO;IACX,CAAC;IAED,uCAAuC;IACvC,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QACrC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;QACxE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QACxD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAC;QACnF,OAAO;IACX,CAAC;IAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,sBAAsB,CAAC,MAAM,CAAC,CAAC;IACrE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACjG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,MAAM,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACnG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;AACtF,CAAC"}

package/dist/cli/constants.d.ts

@@ -0,0 +1,19 @@
+/** @internal exported for testing */
+export declare const ansi: {
+    readonly cyan: (s: string) => string;
+    readonly green: (s: string) => string;
+    readonly yellow: (s: string) => string;
+    readonly dim: (s: string) => string;
+    readonly bold: (s: string) => string;
+    readonly red: (s: string) => string;
+    readonly reset: "\u001B[0m";
+};
+/** @internal exported for testing */
+export declare const MCP_FUSION_VERSION = "1.1.0";
+/** Default API endpoint — Vinkius Cloud production */
+export declare const VINKIUS_CLOUD_URL = "https://cloud.vinkius.com";
+export declare const VALID_TRANSPORTS: readonly ["stdio", "sse"];
+export declare const VALID_VECTORS: readonly ["vanilla", "prisma", "n8n", "openapi", "oauth"];
+/** @internal exported for testing */
+export declare const HELP: string;
+//# sourceMappingURL=constants.d.ts.map

package/dist/cli/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/cli/constants.ts"],"names":[],"mappings":"AAQA,qCAAqC;AACrC,eAAO,MAAM,IAAI;uBACD,MAAM,KAAG,MAAM;wBACf,MAAM,KAAG,MAAM;yBACf,MAAM,KAAG,MAAM;sBACf,MAAM,KAAG,MAAM;uBACf,MAAM,KAAG,MAAM;sBACf,MAAM,KAAG,MAAM;;CAErB,CAAC;AAIX,qCAAqC;AACrC,eAAO,MAAM,kBAAkB,UAAU,CAAC;AAE1C,sDAAsD;AACtD,eAAO,MAAM,iBAAiB,8BAA8B,CAAC;AAI7D,eAAO,MAAM,gBAAgB,2BAA4B,CAAC;AAC1D,eAAO,MAAM,aAAa,2DAA4D,CAAC;AAIvF,qCAAqC;AACrC,eAAO,MAAM,IAAI,QA0DT,CAAC"}

package/dist/cli/constants.js

@@ -0,0 +1,86 @@
+/**
+ * CLI constants — version, help text, ANSI styling.
+ * @module
+ */
+import { LOCKFILE_NAME } from '../introspection/CapabilityLockfile.js';
+// ─── ANSI Styling (zero dependencies) ────────────────────────────
+/** @internal exported for testing */
+export const ansi = {
+    cyan: (s) => `\x1b[36m${s}\x1b[0m`,
+    green: (s) => `\x1b[32m${s}\x1b[0m`,
+    yellow: (s) => `\x1b[33m${s}\x1b[0m`,
+    dim: (s) => `\x1b[2m${s}\x1b[0m`,
+    bold: (s) => `\x1b[1m${s}\x1b[0m`,
+    red: (s) => `\x1b[31m${s}\x1b[0m`,
+    reset: '\x1b[0m',
+};
+// ─── Version ─────────────────────────────────────────────────────
+/** @internal exported for testing */
+export const MCP_FUSION_VERSION = '1.1.0';
+/** Default API endpoint — Vinkius Cloud production */
+export const VINKIUS_CLOUD_URL = 'https://cloud.vinkius.com';
+// ─── Validation Constants ────────────────────────────────────────
+export const VALID_TRANSPORTS = ['stdio', 'sse'];
+export const VALID_VECTORS = ['vanilla', 'prisma', 'n8n', 'openapi', 'oauth'];
+// ─── Help Text ───────────────────────────────────────────────────
+/** @internal exported for testing */
+export const HELP = `
+fusion — MCP Fusion CLI
+
+USAGE
+  fusion create <name>                Scaffold a new MCP Fusion server
+  fusion dev --server <entry>         Start HMR dev server with auto-reload
+  fusion lock                         Generate or update ${LOCKFILE_NAME}
+  fusion lock --check                 Verify lockfile is up to date (CI gate)
+  fusion deploy                       Bundle, compress & deploy to Edge
+  fusion remote                       Show current remote configuration
+  fusion inspect                      Launch the real-time TUI dashboard
+  fusion insp --demo                  Launch TUI with built-in simulator
+
+CREATE OPTIONS
+  --transport <stdio|sse>  Transport layer (default: stdio)
+  --vector <type>          Ingestion vector: vanilla, prisma, n8n, openapi, oauth
+  --testing                Include test suite (default: true)
+  --no-testing             Skip test suite
+  --yes, -y                Skip prompts, use defaults
+
+DEV OPTIONS
+  --server, -s <path>      Path to server entrypoint (default: auto-detect)
+  --dir, -d <path>         Directory to watch for changes (default: auto-detect from server)
+
+DEPLOY OPTIONS
+  --server, -s <path>      Path to server entrypoint (default: auto-detect)
+  --token <token>          Override FUSION_DEPLOY_TOKEN (connection token)
+
+REMOTE OPTIONS
+  fusion remote <url>          Override API endpoint (default: Vinkius Cloud)
+  fusion remote --server-id <id>  Set target server UUID
+
+INSPECTOR OPTIONS
+  --demo, -d               Launch with built-in simulator (no server needed)
+  --out, -o <mode>         Output: tui (default), stderr (headless ECS/K8s)
+  --pid, -p <pid>          Connect to a specific server PID
+  --path <path>            Custom IPC socket/pipe path
+
+LOCK OPTIONS
+  --server, -s <path>      Path to server entrypoint
+  --name, -n <name>        Server name for lockfile header
+  --cwd <dir>              Project root directory
+
+GLOBAL
+  --help, -h               Show this help message
+
+EXAMPLES
+  fusion create my-server
+  fusion create my-server -y
+  fusion create my-server --vector prisma --transport sse
+  fusion dev --server ./src/server.ts
+  fusion dev --server ./src/server.ts --dir ./src/tools
+  fusion lock --server ./src/server.ts
+  fusion deploy
+  fusion remote --server-id abc-123-def
+  fusion remote http://localhost:8080 --server-id abc-123-def
+  fusion inspect --demo
+  fusion insp --pid 12345
+`.trim();
+//# sourceMappingURL=constants.js.map

package/dist/cli/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/cli/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAEvE,oEAAoE;AAEpE,qCAAqC;AACrC,MAAM,CAAC,MAAM,IAAI,GAAG;IAChB,IAAI,EAAI,CAAC,CAAS,EAAU,EAAE,CAAC,WAAW,CAAC,SAAS;IACpD,KAAK,EAAG,CAAC,CAAS,EAAU,EAAE,CAAC,WAAW,CAAC,SAAS;IACpD,MAAM,EAAE,CAAC,CAAS,EAAU,EAAE,CAAC,WAAW,CAAC,SAAS;IACpD,GAAG,EAAK,CAAC,CAAS,EAAU,EAAE,CAAC,UAAU,CAAC,SAAS;IACnD,IAAI,EAAI,CAAC,CAAS,EAAU,EAAE,CAAC,UAAU,CAAC,SAAS;IACnD,GAAG,EAAK,CAAC,CAAS,EAAU,EAAE,CAAC,WAAW,CAAC,SAAS;IACpD,KAAK,EAAE,SAAS;CACV,CAAC;AAEX,oEAAoE;AAEpE,qCAAqC;AACrC,MAAM,CAAC,MAAM,kBAAkB,GAAG,OAAO,CAAC;AAE1C,sDAAsD;AACtD,MAAM,CAAC,MAAM,iBAAiB,GAAG,2BAA2B,CAAC;AAE7D,oEAAoE;AAEpE,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,KAAK,CAAU,CAAC;AAC1D,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,CAAU,CAAC;AAEvF,oEAAoE;AAEpE,qCAAqC;AACrC,MAAM,CAAC,MAAM,IAAI,GAAG;;;;;;2DAMuC,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoDvE,CAAC,IAAI,EAAE,CAAC"}

package/dist/cli/fusion.d.ts

@@ -1,133 +1,15 @@
 #!/usr/bin/env node
-import { type PromptBuilderLike } from '../introspection/CapabilityLockfile.js';
-import type { ProjectConfig, IngestionVector, TransportLayer } from './types.js';
-/** @internal exported for testing */
-export declare const ansi: {
-    readonly cyan: (s: string) => string;
-    readonly green: (s: string) => string;
-    readonly dim: (s: string) => string;
-    readonly bold: (s: string) => string;
-    readonly red: (s: string) => string;
-    readonly reset: "\u001B[0m";
-};
-/**
- * Step status for CLI progress reporting.
- * @internal
- */
-export type StepStatus = 'pending' | 'running' | 'done' | 'failed';
-/**
- * A progress step emitted during CLI operations.
- * @internal
- */
-export interface ProgressStep {
-    /** Step identifier */
-    readonly id: string;
-    /** Human-readable label */
-    readonly label: string;
-    /** Current status */
-    readonly status: StepStatus;
-    /** Optional detail (e.g. "12 tools, 3 prompts") */
-    readonly detail?: string;
-    /** Duration in milliseconds (set when done/failed) */
-    readonly durationMs?: number;
-}
-/**
- * Callback that receives progress updates.
- * Default implementation writes to stderr like Composer / Yarn.
- * @internal
- */
-export type ProgressReporter = (step: ProgressStep) => void;
-/**
- * Create the default pretty-print progress reporter.
- * Output goes to stderr so it doesn't pollute piped stdout.
- * @internal exported for testing
- */
-export declare function createDefaultReporter(): ProgressReporter;
-/**
- * A progress tracker that drives step-by-step progress reporting.
- * @internal exported for testing
- */
-export declare class ProgressTracker {
-    private readonly reporter;
-    private startTimes;
-    constructor(reporter?: ProgressReporter);
-    /** Mark a step as running */
-    start(id: string, label: string): void;
-    /** Mark a step as completed */
-    done(id: string, label: string, detail?: string): void;
-    /** Mark a step as failed */
-    fail(id: string, label: string, detail?: string): void;
-    private elapsed;
-}
-/** @internal exported for testing */
-export declare const MCP_FUSION_VERSION = "1.1.0";
-/** @internal exported for testing */
-export declare const HELP: string;
-/** @internal exported for testing */
-export interface CliArgs {
-    command: string;
-    check: boolean;
-    server: string | undefined;
-    name: string | undefined;
-    cwd: string;
-    help: boolean;
-    projectName: string | undefined;
-    transport: TransportLayer | undefined;
-    vector: IngestionVector | undefined;
-    testing: boolean | undefined;
-    yes: boolean;
-    dir: string | undefined;
-}
-/** @internal exported for testing */
-export declare function parseArgs(argv: string[]): CliArgs;
-/**
- * Duck-typed interface for objects that can provide tool builders.
- * Supports both ToolRegistry and FusionInstance.
- */
-/** @internal exported for testing */
-export interface RegistryLike {
-    getBuilders(): Iterable<import('../core/types.js').ToolBuilder<unknown>>;
-}
-/**
- * Duck-typed interface for objects that can provide prompt builders.
- * Supports PromptRegistry.
- */
-/** @internal exported for testing */
-export interface PromptRegistryLike {
-    getBuilders?(): Iterable<PromptBuilderLike>;
-}
-/**
- * Attempt to load and resolve a tool registry from a server entrypoint.
- *
- * Supports common export patterns:
- * - `export const registry = new ToolRegistry()`
- * - `export default { registry }`
- * - `export const fusion = initFusion()`
- *
- * @internal
- */
-/** @internal exported for testing */
-export declare function resolveRegistry(serverPath: string): Promise<{
-    registry: RegistryLike;
-    name: string;
-    promptRegistry?: PromptRegistryLike;
-}>;
-/** @internal exported for testing */
-export declare function commandLock(args: CliArgs, reporter?: ProgressReporter): Promise<void>;
-/** @internal exported for testing */
-export declare function commandDev(args: CliArgs, reporter?: ProgressReporter): Promise<void>;
-/**
- * Ask a question via readline with styled ANSI output.
- * @internal exported for testing
- */
-export declare function ask(rl: {
-    question: (q: string, cb: (a: string) => void) => void;
-}, prompt: string, fallback: string): Promise<string>;
-/**
- * Collect project config — either from flags or interactive prompts.
- * @internal exported for testing
- */
-export declare function collectConfig(args: CliArgs): Promise<ProjectConfig | null>;
-/** @internal exported for testing */
-export declare function commandCreate(args: CliArgs, reporter?: ProgressReporter): Promise<void>;
+import { commandLock } from './commands/lock.js';
+import { commandDev } from './commands/dev.js';
+import { commandCreate } from './commands/create.js';
+export { parseArgs } from './args.js';
+export type { CliArgs } from './args.js';
+export { MCP_FUSION_VERSION, HELP, ansi } from './constants.js';
+export type { StepStatus, ProgressStep, ProgressReporter } from './progress.js';
+export { ProgressTracker, createDefaultReporter } from './progress.js';
+export type { RegistryLike, PromptRegistryLike } from './registry.js';
+export { resolveRegistry } from './registry.js';
+export { collectConfig } from './commands/create.js';
+export { commandLock, commandDev, commandCreate };
+export { ask } from './utils.js';
 //# sourceMappingURL=fusion.d.ts.map

package/dist/cli/fusion.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fusion.d.ts","sourceRoot":"","sources":["../../src/cli/fusion.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"fusion.d.ts","sourceRoot":"","sources":["../../src/cli/fusion.ts"],"names":[],"mappings":";AAWA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAMrD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,YAAY,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAChE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACvE,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,CAAC;AAClD,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC"}