@vurb/core 3.2.0

package/dist/cli/commands/dev.js

@@ -0,0 +1,58 @@
+import { ProgressTracker } from '../progress.js';
+import { ansi } from '../constants.js';
+import { resolveRegistry } from '../registry.js';
+import { inferServerEntry, inferWatchDir } from '../utils.js';
+import { createDevServer } from '../../server/DevServer.js';
+/** @internal exported for testing */
+export async function commandDev(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: vurb dev --server ./src/server.ts');
+            process.exit(1);
+        }
+        args.server = detected;
+    }
+    const serverEntry = args.server;
+    process.stderr.write(`\n  ${ansi.bold('vurb dev')} ${ansi.dim('— HMR Development Server')}\n\n`);
+    // Step 1: Resolve registry
+    progress.start('resolve', 'Resolving server entrypoint');
+    const { registry, name } = await resolveRegistry(serverEntry);
+    progress.done('resolve', 'Resolving server entrypoint', name);
+    // Step 2: Determine watch directory
+    const watchDir = args.dir ?? inferWatchDir(serverEntry);
+    progress.start('watch', `Watching ${watchDir}`);
+    progress.done('watch', `Watching ${watchDir}`);
+    // Step 3: Create and start dev server
+    const devServer = createDevServer({
+        dir: watchDir,
+        setup: async (reg) => {
+            // Bug #75 fix: resolve NEW registry first, only clear+register on success.
+            // If resolveRegistry throws (syntax error in user code), the
+            // current tools remain available until the next successful reload.
+            let resolved;
+            try {
+                resolved = await resolveRegistry(serverEntry);
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                throw new Error(`Failed to reload: ${message}`);
+            }
+            if ('clear' in reg && typeof reg.clear === 'function') {
+                reg.clear();
+            }
+            for (const builder of resolved.registry.getBuilders()) {
+                reg.register(builder);
+            }
+        },
+    });
+    process.on('SIGINT', () => {
+        process.stderr.write(`\n  ${ansi.dim('Shutting down...')}\n\n`);
+        devServer.stop();
+        process.exit(0);
+    });
+    await devServer.start();
+}
+//# sourceMappingURL=dev.js.map

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

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

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

@@ -0,0 +1,5 @@
+import type { CliArgs } from '../args.js';
+import type { ProgressReporter } from '../progress.js';
+/** @internal exported for testing */
+export declare function commandLock(args: CliArgs, reporter?: ProgressReporter): Promise<void>;
+//# sourceMappingURL=lock.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/lock.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAMvD,qCAAqC;AACrC,wBAAsB,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgF3F"}

package/dist/cli/commands/lock.js

@@ -0,0 +1,94 @@
+/**
+ * `vurb 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 { VURB_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: vurb 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: vurb 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, VURB_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 @@
+/**
+ * `vurb remote` — manage .vurbrc cloud configuration.
+ * @module
+ */
+import { resolve } from 'node:path';
+import { ansi, VINKIUS_CLOUD_URL } from '../constants.js';
+import { VURBRC, readVurbRc, writeVurbRc } from '../rc.js';
+export async function commandRemote(args) {
+    const cwd = args.cwd;
+    // vurb remote <url> [--server-id <id>] — set one or both at once
+    // vurb remote --server-id <id>        — uses default Vinkius Cloud URL
+    if (args.remoteUrl || args.serverId) {
+        const remote = args.remoteUrl ?? VINKIUS_CLOUD_URL;
+        writeVurbRc(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;
+    }
+    // vurb remote — print current config
+    const config = readVurbRc(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('$')} vurb 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, VURBRC)}\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,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE3D,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAa;IAC7C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;IAErB,iEAAiE;IACjE,uEAAuE;IACvE,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,IAAI,iBAAiB,CAAC;QAEnD,WAAW,CAAC,GAAG,EAAE;YACb,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,qCAAqC;IACrC,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;IAC/B,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,qCAAqC,CAAC,CAAC;QACjF,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,MAAM,CAAC,MAAM,CAAC,CAAC;AACpF,CAAC"}

package/dist/cli/constants.d.ts

@@ -0,0 +1,18 @@
+/** @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";
+};
+export declare const VURB_VERSION: string;
+/** 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":"AASA,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;AAMX,eAAO,MAAM,YAAY,EAAE,MAGvB,CAAC;AAEL,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,95 @@
+/**
+ * CLI constants — version, help text, ANSI styling.
+ * @module
+ */
+import { createRequire } from 'node: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 */
+const _require = createRequire(import.meta.url);
+export const VURB_VERSION = (() => {
+    try {
+        return _require('../../package.json').version;
+    }
+    catch {
+        return '0.0.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 = `
+vurb — Vurb CLI
+
+USAGE
+  vurb create <name>                Scaffold a new Vurb server
+  vurb dev --server <entry>         Start HMR dev server with auto-reload
+  vurb lock                         Generate or update ${LOCKFILE_NAME}
+  vurb lock --check                 Verify lockfile is up to date (CI gate)
+  vurb deploy                       Bundle, compress & deploy to Edge
+  vurb remote                       Show current remote configuration
+  vurb inspect                      Launch the real-time TUI dashboard
+  vurb 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 VURB_DEPLOY_TOKEN (connection token)
+
+REMOTE OPTIONS
+  vurb remote <url>          Override API endpoint (default: Vinkius Cloud)
+  vurb 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
+  vurb create my-server
+  vurb create my-server -y
+  vurb create my-server --vector prisma --transport sse
+  vurb dev --server ./src/server.ts
+  vurb dev --server ./src/server.ts --dir ./src/tools
+  vurb lock --server ./src/server.ts
+  vurb deploy
+  vurb remote --server-id abc-123-def
+  vurb remote http://localhost:8080 --server-id abc-123-def
+  vurb inspect --demo
+  vurb 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,aAAa,CAAC;AAC5C,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,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAChD,MAAM,CAAC,MAAM,YAAY,GAAW,CAAC,GAAG,EAAE;IACtC,IAAI,CAAC;QAAC,OAAQ,QAAQ,CAAC,oBAAoB,CAAyB,CAAC,OAAO,CAAC;IAAC,CAAC;IAC/E,MAAM,CAAC;QAAC,OAAO,OAAO,CAAC;IAAC,CAAC;AAC7B,CAAC,CAAC,EAAE,CAAC;AAEL,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;;;;;;yDAMqC,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoDrE,CAAC,IAAI,EAAE,CAAC"}

package/dist/cli/progress.d.ts

@@ -0,0 +1,34 @@
+/**
+ * CLI progress reporting — animated spinner, step tracking.
+ *
+ * Drives Composer/Yarn-style step output with a live spinner
+ * that cycles while a step is running, so the user always sees
+ * movement and knows the CLI hasn't frozen.
+ *
+ * @module
+ */
+/** @internal */
+export type StepStatus = 'pending' | 'running' | 'done' | 'failed';
+/** @internal */
+export interface ProgressStep {
+    readonly id: string;
+    readonly label: string;
+    readonly status: StepStatus;
+    readonly detail?: string;
+    readonly durationMs?: number;
+}
+/** @internal */
+export type ProgressReporter = (step: ProgressStep) => void;
+/** @internal exported for testing */
+export declare function createDefaultReporter(): ProgressReporter;
+/** @internal exported for testing */
+export declare class ProgressTracker {
+    private readonly reporter;
+    private startTimes;
+    constructor(reporter?: ProgressReporter);
+    start(id: string, label: string): void;
+    done(id: string, label: string, detail?: string): void;
+    fail(id: string, label: string, detail?: string): void;
+    private elapsed;
+}
+//# sourceMappingURL=progress.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../src/cli/progress.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,gBAAgB;AAChB,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEnE,gBAAgB;AAChB,MAAM,WAAW,YAAY;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,gBAAgB;AAChB,MAAM,MAAM,gBAAgB,GAAG,CAAC,IAAI,EAAE,YAAY,KAAK,IAAI,CAAC;AAS5D,qCAAqC;AACrC,wBAAgB,qBAAqB,IAAI,gBAAgB,CAsDxD;AAID,qCAAqC;AACrC,qBAAa,eAAe;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;IAC5C,OAAO,CAAC,UAAU,CAA6B;gBAEnC,QAAQ,CAAC,EAAE,gBAAgB;IAIvC,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAKtC,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAStD,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAStD,OAAO,CAAC,OAAO;CAMlB"}

package/dist/cli/progress.js

@@ -0,0 +1,102 @@
+/**
+ * CLI progress reporting — animated spinner, step tracking.
+ *
+ * Drives Composer/Yarn-style step output with a live spinner
+ * that cycles while a step is running, so the user always sees
+ * movement and knows the CLI hasn't frozen.
+ *
+ * @module
+ */
+// ─── Spinner ─────────────────────────────────────────────────────
+const SPINNER_FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+const SPINNER_INTERVAL_MS = 80;
+// ─── Default Reporter ────────────────────────────────────────────
+/** @internal exported for testing */
+export function createDefaultReporter() {
+    let spinnerTimer;
+    let frameIndex = 0;
+    let currentLine = '';
+    function clearLine() {
+        if (currentLine) {
+            process.stderr.write(`\r\x1b[2K`);
+            currentLine = '';
+        }
+    }
+    function startSpinner(label) {
+        stopSpinner();
+        frameIndex = 0;
+        const render = () => {
+            const frame = SPINNER_FRAMES[frameIndex % SPINNER_FRAMES.length];
+            currentLine = `  ${frame} ${label}...`;
+            process.stderr.write(`\r\x1b[2K${currentLine}`);
+            frameIndex++;
+        };
+        render();
+        spinnerTimer = setInterval(render, SPINNER_INTERVAL_MS);
+        // Don't let the spinner timer prevent process exit (important in tests)
+        if (spinnerTimer && typeof spinnerTimer === 'object' && 'unref' in spinnerTimer) {
+            spinnerTimer.unref();
+        }
+    }
+    function stopSpinner() {
+        if (spinnerTimer) {
+            clearInterval(spinnerTimer);
+            spinnerTimer = undefined;
+        }
+        clearLine();
+    }
+    return (step) => {
+        switch (step.status) {
+            case 'running':
+                startSpinner(step.label);
+                break;
+            case 'done':
+                stopSpinner();
+                process.stderr.write(`  \x1b[32m✓\x1b[0m ${step.label}\n`);
+                break;
+            case 'failed': {
+                stopSpinner();
+                const detail = step.detail ? ` — ${step.detail}` : '';
+                process.stderr.write(`  \x1b[31m✗\x1b[0m ${step.label}${detail}\n`);
+                break;
+            }
+        }
+    };
+}
+// ─── Tracker ─────────────────────────────────────────────────────
+/** @internal exported for testing */
+export class ProgressTracker {
+    reporter;
+    startTimes = new Map();
+    constructor(reporter) {
+        this.reporter = reporter ?? createDefaultReporter();
+    }
+    start(id, label) {
+        this.startTimes.set(id, Date.now());
+        this.reporter({ id, label, status: 'running' });
+    }
+    done(id, label, detail) {
+        const durationMs = this.elapsed(id);
+        this.reporter({
+            id, label, status: 'done',
+            ...(detail !== undefined ? { detail } : {}),
+            ...(durationMs !== undefined ? { durationMs } : {}),
+        });
+    }
+    fail(id, label, detail) {
+        const durationMs = this.elapsed(id);
+        this.reporter({
+            id, label, status: 'failed',
+            ...(detail !== undefined ? { detail } : {}),
+            ...(durationMs !== undefined ? { durationMs } : {}),
+        });
+    }
+    elapsed(id) {
+        const start = this.startTimes.get(id);
+        if (start === undefined)
+            return undefined;
+        this.startTimes.delete(id);
+        return Date.now() - start;
+    }
+}
+//# sourceMappingURL=progress.js.map

package/dist/cli/progress.js.map

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

package/dist/cli/rc.d.ts

@@ -0,0 +1,11 @@
+import type { RemoteConfig } from './types.js';
+export declare const VURBRC = ".vurbrc";
+/** Load .env file from cwd into process.env (won't overwrite existing). */
+export declare function loadEnv(cwd: string): void;
+/** Ensure .vurbrc is listed in .gitignore. */
+export declare function ensureGitignore(cwd: string): void;
+/** Read .vurbrc from project root. */
+export declare function readVurbRc(cwd: string): Partial<RemoteConfig>;
+/** Write .vurbrc and ensure .gitignore coverage. */
+export declare function writeVurbRc(cwd: string, config: Partial<RemoteConfig>): void;
+//# sourceMappingURL=rc.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rc.d.ts","sourceRoot":"","sources":["../../src/cli/rc.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAK/C,eAAO,MAAM,MAAM,YAAY,CAAC;AAIhC,2EAA2E;AAC3E,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAqBzC;AAID,8CAA8C;AAC9C,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAYjD;AAID,sCAAsC;AACtC,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAQ7D;AAED,oDAAoD;AACpD,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI,CAK5E"}

package/dist/cli/rc.js

@@ -0,0 +1,75 @@
+/**
+ * .vurbrc management — local cloud config, .env loading.
+ * @module
+ */
+import { resolve } from 'node:path';
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { ansi } from './constants.js';
+// ─── Constants ───────────────────────────────────────────────────
+export const VURBRC = '.vurbrc';
+// ─── Environment ─────────────────────────────────────────────────
+/** Load .env file from cwd into process.env (won't overwrite existing). */
+export function loadEnv(cwd) {
+    try {
+        const content = readFileSync(resolve(cwd, '.env'), 'utf-8');
+        for (const line of content.split('\n')) {
+            const trimmed = line.trim();
+            if (!trimmed || trimmed.startsWith('#'))
+                continue;
+            const eq = trimmed.indexOf('=');
+            if (eq === -1)
+                continue;
+            const key = trimmed.slice(0, eq).trim();
+            let val = trimmed.slice(eq + 1).trim();
+            // Strip matching quote pairs only (e.g. 'value' or "value", not 'bar")
+            const quoteMatch = val.match(/^(["'])(.*?)\1$/);
+            if (quoteMatch) {
+                val = quoteMatch[2] ?? '';
+            }
+            else {
+                // Strip inline comments only for unquoted values
+                val = val.replace(/\s+#.*$/, '');
+            }
+            if (!process.env[key])
+                process.env[key] = val;
+        }
+    }
+    catch { /* No .env file — env vars may be set directly (CI/CD) */ }
+}
+// ─── .gitignore ──────────────────────────────────────────────────
+/** Ensure .vurbrc is listed in .gitignore. */
+export function ensureGitignore(cwd) {
+    const gitignorePath = resolve(cwd, '.gitignore');
+    try {
+        const content = existsSync(gitignorePath)
+            ? readFileSync(gitignorePath, 'utf-8')
+            : '';
+        if (!content.split('\n').some(l => l.trim() === VURBRC)) {
+            const nl = content.length > 0 && !content.endsWith('\n') ? '\n' : '';
+            writeFileSync(gitignorePath, `${content}${nl}${VURBRC}\n`);
+            process.stderr.write(`  ${ansi.yellow('⚠')} Added ${VURBRC} to .gitignore\n`);
+        }
+    }
+    catch { /* No git project — skip silently */ }
+}
+// ─── Read / Write ────────────────────────────────────────────────
+/** Read .vurbrc from project root. */
+export function readVurbRc(cwd) {
+    const rcPath = resolve(cwd, VURBRC);
+    if (!existsSync(rcPath))
+        return {};
+    try {
+        return JSON.parse(readFileSync(rcPath, 'utf-8'));
+    }
+    catch {
+        return {};
+    }
+}
+/** Write .vurbrc and ensure .gitignore coverage. */
+export function writeVurbRc(cwd, config) {
+    const existing = readVurbRc(cwd);
+    const merged = { ...existing, ...config };
+    writeFileSync(resolve(cwd, VURBRC), JSON.stringify(merged, null, 2) + '\n');
+    ensureGitignore(cwd);
+}
+//# sourceMappingURL=rc.js.map

package/dist/cli/rc.js.map

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

package/dist/cli/registry.d.ts

@@ -0,0 +1,25 @@
+import type { PromptBuilderLike } from '../introspection/CapabilityLockfile.js';
+/** @internal exported for testing */
+export interface RegistryLike {
+    getBuilders(): Iterable<import('../core/types.js').ToolBuilder<unknown>>;
+}
+/** @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 vurb = initVurb()`
+ *
+ * @internal exported for testing
+ */
+export declare function resolveRegistry(serverPath: string): Promise<{
+    registry: RegistryLike;
+    name: string;
+    promptRegistry?: PromptRegistryLike;
+}>;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/cli/registry.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAIhF,qCAAqC;AACrC,MAAM,WAAW,YAAY;IACzB,WAAW,IAAI,QAAQ,CAAC,OAAO,kBAAkB,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;CAC5E;AAED,qCAAqC;AACrC,MAAM,WAAW,kBAAkB;IAC/B,WAAW,CAAC,IAAI,QAAQ,CAAC,iBAAiB,CAAC,CAAC;CAC/C;AAID;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,kBAAkB,CAAA;CAAE,CAAC,CA2EhJ"}