godot-cli 0.1.0

package/dist/utils/probe.js

@@ -0,0 +1,61 @@
+import { verbose } from './ui.js';
+export const PING_ENDPOINT = '/api/tools/ping';
+/**
+ * Probe a Godot-MCP server's ping endpoint (`<base>/api/tools/ping`).
+ * Returns a structured result. The `ping` tool is registered by the
+ * `Tool_Ping` family (pure-managed, no editor required), so a connected
+ * plugin responds `{ "structured": { "result": "pong" } }`.
+ */
+export async function probe(baseUrl, headers, timeoutMs) {
+    const endpoint = `${baseUrl}${PING_ENDPOINT}`;
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const response = await fetch(endpoint, {
+            method: 'POST',
+            headers,
+            body: '{}',
+            signal: controller.signal,
+        });
+        const text = await response.text();
+        if (response.ok) {
+            let data;
+            try {
+                data = JSON.parse(text);
+            }
+            catch {
+                data = text;
+            }
+            return { ok: true, baseUrl, data };
+        }
+        verbose(`[${baseUrl}] HTTP ${response.status} — not ready yet`);
+        return { ok: false, reason: `HTTP ${response.status}` };
+    }
+    catch (err) {
+        const cause = err instanceof Error && 'cause' in err ? err.cause : null;
+        const code = cause?.code ?? '';
+        const isAbort = err instanceof Error && err.name === 'AbortError';
+        let reason;
+        if (isAbort) {
+            reason = 'timed out';
+            verbose(`[${baseUrl}] probe timed out`);
+        }
+        else if (code === 'ECONNREFUSED') {
+            reason = 'connection refused';
+            verbose(`[${baseUrl}] connection refused`);
+        }
+        else if (code === 'ECONNRESET') {
+            reason = 'connection reset';
+            verbose(`[${baseUrl}] connection reset`);
+        }
+        else {
+            reason = err instanceof Error ? err.message : String(err);
+            verbose(`[${baseUrl}] probe failed: ${reason}`);
+        }
+        return { ok: false, reason };
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+//# sourceMappingURL=probe.js.map

package/dist/utils/probe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe.js","sourceRoot":"","sources":["../../src/utils/probe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,MAAM,CAAC,MAAM,aAAa,GAAG,iBAAiB,CAAC;AAe/C;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CACzB,OAAe,EACf,OAA+B,EAC/B,SAAiB;IAEjB,MAAM,QAAQ,GAAG,GAAG,OAAO,GAAG,aAAa,EAAE,CAAC;IAC9C,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,SAAS,CAAC,CAAC;IAE9D,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,QAAQ,EAAE;YACrC,MAAM,EAAE,MAAM;YACd,OAAO;YACP,IAAI,EAAE,IAAI;YACV,MAAM,EAAE,UAAU,CAAC,MAAM;SAC1B,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnC,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;YAChB,IAAI,IAAa,CAAC;YAClB,IAAI,CAAC;gBAAC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC;gBAAC,IAAI,GAAG,IAAI,CAAC;YAAC,CAAC;YACvD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACrC,CAAC;QAED,OAAO,CAAC,IAAI,OAAO,UAAU,QAAQ,CAAC,MAAM,kBAAkB,CAAC,CAAC;QAChE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;IAC1D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,KAAK,GAAG,GAAG,YAAY,KAAK,IAAI,OAAO,IAAI,GAAG,CAAC,CAAC,CAAE,GAAG,CAAC,KAAmC,CAAC,CAAC,CAAC,IAAI,CAAC;QACvG,MAAM,IAAI,GAAG,KAAK,EAAE,IAAI,IAAI,EAAE,CAAC;QAC/B,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,CAAC;QAElE,IAAI,MAAc,CAAC;QACnB,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,GAAG,WAAW,CAAC;YACrB,OAAO,CAAC,IAAI,OAAO,mBAAmB,CAAC,CAAC;QAC1C,CAAC;aAAM,IAAI,IAAI,KAAK,cAAc,EAAE,CAAC;YACnC,MAAM,GAAG,oBAAoB,CAAC;YAC9B,OAAO,CAAC,IAAI,OAAO,sBAAsB,CAAC,CAAC;QAC7C,CAAC;aAAM,IAAI,IAAI,KAAK,YAAY,EAAE,CAAC;YACjC,MAAM,GAAG,kBAAkB,CAAC;YAC5B,OAAO,CAAC,IAAI,OAAO,oBAAoB,CAAC,CAAC;QAC3C,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC1D,OAAO,CAAC,IAAI,OAAO,mBAAmB,MAAM,EAAE,CAAC,CAAC;QAClD,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAC/B,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;AACH,CAAC"}

package/dist/utils/project-godot.d.ts

@@ -0,0 +1,41 @@
+/**
+ * The plugin.cfg resource path Godot uses to identify the godot_mcp addon in
+ * the `[editor_plugins]` `enabled` array.
+ */
+export declare const GODOT_MCP_PLUGIN_PATH = "res://addons/godot_mcp/plugin.cfg";
+/** Absolute path to a project's `project.godot` manifest. */
+export declare function projectGodotPath(projectRoot: string): string;
+/** True when `<projectRoot>/project.godot` exists. */
+export declare function isGodotProjectRoot(projectRoot: string): boolean;
+/**
+ * Parse the `enabled=PackedStringArray("a", "b")` entry inside the
+ * `[editor_plugins]` section of a `project.godot` file body, returning the
+ * ordered list of enabled plugin.cfg paths. Returns an empty array when the
+ * section or the `enabled` key is absent.
+ *
+ * Pure — operates on the file text only. Exported for unit tests.
+ */
+export declare function parseEnabledPlugins(projectGodotText: string): string[];
+export type PluginToggleResult = {
+    kind: 'changed';
+    enabled: string[];
+} | {
+    kind: 'unchanged';
+    enabled: string[];
+};
+/**
+ * Return a new `project.godot` body with the godot_mcp plugin path added to
+ * (enable) or removed from (disable) the `[editor_plugins]` `enabled` array.
+ *
+ * - Creates the `[editor_plugins]` section / `enabled` line when enabling and
+ *   they are absent.
+ * - Idempotent: enabling an already-enabled plugin (or disabling an
+ *   already-disabled one) returns `{ kind: 'unchanged' }` with the original
+ *   text untouched.
+ *
+ * Pure — returns the new text; never touches the filesystem. Exported for
+ * unit tests.
+ */
+export declare function togglePluginInText(projectGodotText: string, enable: boolean, pluginPath?: string): {
+    text: string;
+} & PluginToggleResult;

package/dist/utils/project-godot.js

@@ -0,0 +1,126 @@
+import * as fs from 'fs';
+import * as path from 'path';
+/**
+ * The plugin.cfg resource path Godot uses to identify the godot_mcp addon in
+ * the `[editor_plugins]` `enabled` array.
+ */
+export const GODOT_MCP_PLUGIN_PATH = 'res://addons/godot_mcp/plugin.cfg';
+/** Absolute path to a project's `project.godot` manifest. */
+export function projectGodotPath(projectRoot) {
+    return path.join(projectRoot, 'project.godot');
+}
+/** True when `<projectRoot>/project.godot` exists. */
+export function isGodotProjectRoot(projectRoot) {
+    return fs.existsSync(projectGodotPath(projectRoot));
+}
+/**
+ * Parse the `enabled=PackedStringArray("a", "b")` entry inside the
+ * `[editor_plugins]` section of a `project.godot` file body, returning the
+ * ordered list of enabled plugin.cfg paths. Returns an empty array when the
+ * section or the `enabled` key is absent.
+ *
+ * Pure — operates on the file text only. Exported for unit tests.
+ */
+export function parseEnabledPlugins(projectGodotText) {
+    const section = extractEditorPluginsSection(projectGodotText);
+    if (section === null)
+        return [];
+    const match = section.match(/enabled\s*=\s*PackedStringArray\(([^)]*)\)/);
+    if (!match)
+        return [];
+    const inner = match[1];
+    const paths = [];
+    // Match each double-quoted string literal in the array.
+    const re = /"([^"]*)"/g;
+    let m;
+    while ((m = re.exec(inner)) !== null) {
+        paths.push(m[1]);
+    }
+    return paths;
+}
+/**
+ * Extract the raw text of the `[editor_plugins]` section (everything between
+ * its header and the next `[section]` header or EOF). Returns null when the
+ * section is absent.
+ */
+function extractEditorPluginsSection(text) {
+    const lines = text.split('\n');
+    const headerIdx = lines.findIndex((l) => l.trim() === '[editor_plugins]');
+    if (headerIdx === -1)
+        return null;
+    let endIdx = headerIdx + 1;
+    while (endIdx < lines.length && !lines[endIdx].trim().startsWith('[')) {
+        endIdx++;
+    }
+    return lines.slice(headerIdx + 1, endIdx).join('\n');
+}
+/**
+ * Render a PackedStringArray literal from a list of plugin paths.
+ */
+function renderEnabledLine(paths) {
+    const quoted = paths.map((p) => `"${p}"`).join(', ');
+    return `enabled=PackedStringArray(${quoted})`;
+}
+/**
+ * Return a new `project.godot` body with the godot_mcp plugin path added to
+ * (enable) or removed from (disable) the `[editor_plugins]` `enabled` array.
+ *
+ * - Creates the `[editor_plugins]` section / `enabled` line when enabling and
+ *   they are absent.
+ * - Idempotent: enabling an already-enabled plugin (or disabling an
+ *   already-disabled one) returns `{ kind: 'unchanged' }` with the original
+ *   text untouched.
+ *
+ * Pure — returns the new text; never touches the filesystem. Exported for
+ * unit tests.
+ */
+export function togglePluginInText(projectGodotText, enable, pluginPath = GODOT_MCP_PLUGIN_PATH) {
+    const current = parseEnabledPlugins(projectGodotText);
+    const has = current.includes(pluginPath);
+    if (enable && has) {
+        return { text: projectGodotText, kind: 'unchanged', enabled: current };
+    }
+    if (!enable && !has) {
+        return { text: projectGodotText, kind: 'unchanged', enabled: current };
+    }
+    const next = enable
+        ? [...current, pluginPath]
+        : current.filter((p) => p !== pluginPath);
+    const newText = writeEnabledArray(projectGodotText, next);
+    return { text: newText, kind: 'changed', enabled: next };
+}
+/**
+ * Write the `enabled=PackedStringArray(...)` line into the `[editor_plugins]`
+ * section, creating the section/line if needed. The Godot `[editor_plugins]`
+ * section is conventionally written with a blank line between the header and
+ * the `enabled` line; this preserves that shape on creation.
+ */
+function writeEnabledArray(text, paths) {
+    const lines = text.split('\n');
+    const headerIdx = lines.findIndex((l) => l.trim() === '[editor_plugins]');
+    const enabledLine = renderEnabledLine(paths);
+    if (headerIdx === -1) {
+        // Append a fresh [editor_plugins] section.
+        const prefix = text.length > 0 && !text.endsWith('\n') ? '\n' : '';
+        const sep = text.trim().length > 0 ? '\n' : '';
+        return `${text}${prefix}${sep}[editor_plugins]\n\n${enabledLine}\n`;
+    }
+    // Find an existing `enabled` line within the section.
+    let endIdx = headerIdx + 1;
+    while (endIdx < lines.length && !lines[endIdx].trim().startsWith('[')) {
+        endIdx++;
+    }
+    const enabledIdx = lines.findIndex((l, i) => i > headerIdx && i < endIdx && /^\s*enabled\s*=/.test(l));
+    if (enabledIdx >= 0) {
+        lines[enabledIdx] = enabledLine;
+    }
+    else {
+        // Insert after the header (and a following blank line if present).
+        const insertAt = headerIdx + 1 < lines.length && lines[headerIdx + 1].trim() === ''
+            ? headerIdx + 2
+            : headerIdx + 1;
+        lines.splice(insertAt, 0, enabledLine);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=project-godot.js.map

package/dist/utils/project-godot.js.map

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

package/dist/utils/semver.d.ts

@@ -0,0 +1,4 @@
+/** Returns true if the string is a valid numeric semver (e.g. "1.2.3"). */
+export declare function isValidVersion(version: string): boolean;
+/** Returns true if `latest` is strictly greater than `current`. */
+export declare function isNewerVersion(current: string, latest: string): boolean;

package/dist/utils/semver.js

@@ -0,0 +1,25 @@
+const SEMVER_NUMERIC = /^\d+(\.\d+)*$/;
+/** Returns true if the string is a valid numeric semver (e.g. "1.2.3"). */
+export function isValidVersion(version) {
+    return SEMVER_NUMERIC.test(version);
+}
+/** Returns -1 if a < b, 0 if equal, 1 if a > b. */
+function compareVersions(a, b) {
+    const pa = a.split('.').map(Number);
+    const pb = b.split('.').map(Number);
+    const len = Math.max(pa.length, pb.length);
+    for (let i = 0; i < len; i++) {
+        const na = pa[i] ?? 0;
+        const nb = pb[i] ?? 0;
+        if (na < nb)
+            return -1;
+        if (na > nb)
+            return 1;
+    }
+    return 0;
+}
+/** Returns true if `latest` is strictly greater than `current`. */
+export function isNewerVersion(current, latest) {
+    return compareVersions(current, latest) < 0;
+}
+//# sourceMappingURL=semver.js.map

package/dist/utils/semver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semver.js","sourceRoot":"","sources":["../../src/utils/semver.ts"],"names":[],"mappings":"AAAA,MAAM,cAAc,GAAG,eAAe,CAAC;AAEvC,2EAA2E;AAC3E,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,OAAO,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACtC,CAAC;AAED,mDAAmD;AACnD,SAAS,eAAe,CAAC,CAAS,EAAE,CAAS;IAC3C,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC;IAE3C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7B,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACtB,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACtB,IAAI,EAAE,GAAG,EAAE;YAAE,OAAO,CAAC,CAAC,CAAC;QACvB,IAAI,EAAE,GAAG,EAAE;YAAE,OAAO,CAAC,CAAC;IACxB,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,cAAc,CAAC,OAAe,EAAE,MAAc;IAC5D,OAAO,eAAe,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;AAC9C,CAAC"}

package/dist/utils/ui.d.ts

@@ -0,0 +1,61 @@
+import { type Spinner } from 'yocto-spinner';
+import type { Command } from 'commander';
+export declare function setVerbose(enabled: boolean): void;
+export declare function verbose(msg: string): void;
+/**
+ * Apply styled help formatting to a Commander command.
+ * Call this on every Command instance (root and subcommands)
+ * so that --help / -h always renders the fancy UI.
+ *
+ * @param appVersion - The CLI version string, shown in the root banner.
+ */
+export declare function configureStyledHelp(cmd: Command, appVersion?: string): Command;
+/**
+ * Print a success message with a green checkmark.
+ * In non-TTY mode, uses plain text prefix.
+ */
+export declare function success(msg: string): void;
+/**
+ * Print an error message with a red cross to stderr.
+ * In non-TTY mode, uses plain text prefix.
+ */
+export declare function error(msg: string): void;
+/**
+ * Print an info message with a blue info symbol.
+ * In non-TTY mode, uses plain text prefix.
+ */
+export declare function info(msg: string): void;
+/**
+ * Print a warning message with a yellow warning symbol.
+ * In non-TTY mode, uses plain text prefix.
+ */
+export declare function warn(msg: string): void;
+/**
+ * Print a bold cyan section heading.
+ */
+export declare function heading(msg: string): void;
+/**
+ * Print a formatted key-value label.
+ */
+export declare function label(key: string, value: string): void;
+/**
+ * Start a spinner with the given text. Returns a wrapped spinner instance
+ * whose success/error/warning/info methods add an extra space after the symbol
+ * for consistent formatting.
+ *
+ * In non-TTY environments (CI pipelines, piped output), returns a no-op
+ * spinner that outputs plain text without ANSI escape codes.
+ */
+export declare function startSpinner(text: string): Spinner;
+/**
+ * Format a status badge (enabled/disabled).
+ */
+export declare function badge(enabled: boolean): string;
+/**
+ * Print a feature row with a styled badge and name.
+ */
+export declare function featureRow(name: string, enabled: boolean): void;
+/**
+ * Print a divider line.
+ */
+export declare function divider(): void;

package/dist/utils/ui.js

@@ -0,0 +1,238 @@
+import chalk from 'chalk';
+import yoctoSpinner from 'yocto-spinner';
+// --- Verbose mode ---
+let verboseEnabled = false;
+export function setVerbose(enabled) {
+    verboseEnabled = enabled;
+}
+export function verbose(msg) {
+    if (verboseEnabled) {
+        if (isTTY()) {
+            console.log(chalk.dim(`[verbose] ${msg}`));
+        }
+        else {
+            console.log(`[verbose] ${msg}`);
+        }
+    }
+}
+// --- TTY detection ---
+function isTTY() {
+    return !!process.stdout.isTTY;
+}
+/**
+ * Draw a Unicode rounded box around text with cyan borders.
+ */
+function drawBox(text) {
+    const lines = text.split('\n');
+    const padding = 2;
+    const maxLen = Math.max(...lines.map(l => stripAnsi(l).length));
+    const innerWidth = maxLen + padding * 2;
+    const pad = ' '.repeat(padding);
+    const top = chalk.cyan('╭' + '─'.repeat(innerWidth) + '╮');
+    const bottom = chalk.cyan('╰' + '─'.repeat(innerWidth) + '╯');
+    const middle = lines.map(l => {
+        const visible = stripAnsi(l).length;
+        const right = ' '.repeat(maxLen - visible);
+        return chalk.cyan('│') + pad + l + right + pad + chalk.cyan('│');
+    });
+    return [top, ...middle, bottom].join('\n');
+}
+/**
+ * Strip ANSI escape codes from a string.
+ */
+function stripAnsi(str) {
+    // eslint-disable-next-line no-control-regex
+    return str.replace(/\x1B\[[0-9;]*m/g, '');
+}
+/**
+ * Apply styled help formatting to a Commander command.
+ * Call this on every Command instance (root and subcommands)
+ * so that --help / -h always renders the fancy UI.
+ *
+ * @param appVersion - The CLI version string, shown in the root banner.
+ */
+export function configureStyledHelp(cmd, appVersion) {
+    cmd.configureHelp({
+        formatHelp(target, helper) {
+            const isRoot = !target.parent;
+            const lines = [];
+            // Banner for root, styled title for subcommands
+            if (isRoot && appVersion) {
+                lines.push(drawBox(`${chalk.bold.cyan('Godot-MCP CLI')}  ${chalk.dim(`v${appVersion}`)}\n${chalk.dim('Bridge LLMs with Godot via Model Context Protocol')}`));
+            }
+            else {
+                lines.push(drawBox(`${chalk.bold.cyan(target.name())} ${chalk.dim('—')} ${target.description()}`));
+            }
+            lines.push('');
+            // Usage
+            lines.push(`${chalk.bold('Usage:')} ${chalk.yellow(helper.commandUsage(target))}`);
+            lines.push('');
+            // Subcommands
+            const subcommands = helper.visibleCommands(target);
+            if (subcommands.length > 0) {
+                lines.push(chalk.bold('Commands:'));
+                for (const sub of subcommands) {
+                    lines.push(`  ${chalk.yellow(sub.name().padEnd(20))} ${chalk.dim(sub.description() || '')}`);
+                }
+                lines.push('');
+            }
+            // Arguments
+            const args = helper.visibleArguments(target);
+            if (args.length > 0) {
+                lines.push(chalk.bold('Arguments:'));
+                for (const arg of args) {
+                    lines.push(`  ${chalk.green(helper.argumentTerm(arg).padEnd(30))} ${chalk.dim(helper.argumentDescription(arg))}`);
+                }
+                lines.push('');
+            }
+            // Options
+            const options = helper.visibleOptions(target);
+            if (options.length > 0) {
+                lines.push(chalk.bold('Options:'));
+                for (const opt of options) {
+                    lines.push(`  ${chalk.green(helper.optionTerm(opt).padEnd(30))} ${chalk.dim(helper.optionDescription(opt))}`);
+                }
+                lines.push('');
+            }
+            // Footer
+            if (isRoot) {
+                lines.push(chalk.dim('Run ') +
+                    chalk.yellow('godot-cli <command> --help') +
+                    chalk.dim(' for detailed usage of each command.'));
+                lines.push('');
+            }
+            return lines.join('\n');
+        },
+    });
+    return cmd;
+}
+/**
+ * Print a success message with a green checkmark.
+ * In non-TTY mode, uses plain text prefix.
+ */
+export function success(msg) {
+    if (isTTY()) {
+        console.log(`${chalk.green('✔')}  ${msg}`);
+    }
+    else {
+        console.log(`SUCCESS: ${msg}`);
+    }
+}
+/**
+ * Print an error message with a red cross to stderr.
+ * In non-TTY mode, uses plain text prefix.
+ */
+export function error(msg) {
+    if (isTTY()) {
+        console.error(`${chalk.red('✖')}  ${chalk.red(msg)}`);
+    }
+    else {
+        console.error(`ERROR: ${msg}`);
+    }
+}
+/**
+ * Print an info message with a blue info symbol.
+ * In non-TTY mode, uses plain text prefix.
+ */
+export function info(msg) {
+    if (isTTY()) {
+        console.log(`${chalk.blue('ℹ')}  ${msg}`);
+    }
+    else {
+        console.log(`INFO: ${msg}`);
+    }
+}
+/**
+ * Print a warning message with a yellow warning symbol.
+ * In non-TTY mode, uses plain text prefix.
+ */
+export function warn(msg) {
+    if (isTTY()) {
+        console.log(`${chalk.yellow('⚠')}  ${chalk.yellow(msg)}`);
+    }
+    else {
+        console.log(`WARN: ${msg}`);
+    }
+}
+/**
+ * Print a bold cyan section heading.
+ */
+export function heading(msg) {
+    console.log(`\n${chalk.bold.cyan(msg)}`);
+}
+/**
+ * Print a formatted key-value label.
+ */
+export function label(key, value) {
+    console.log(`  ${chalk.bold(key + ':')} ${value}`);
+}
+/**
+ * Create a no-op spinner for non-TTY environments.
+ * Methods are safe to call but produce no ANSI output.
+ */
+function createNoOpSpinner(text) {
+    console.log(text);
+    const self = {
+        start: () => self,
+        stop: () => self,
+        success: (msg) => { if (msg)
+            console.log(`SUCCESS: ${msg}`); return self; },
+        error: (msg) => { if (msg)
+            console.error(`ERROR: ${msg}`); return self; },
+        warning: (msg) => { if (msg)
+            console.log(`WARN: ${msg}`); return self; },
+        info: (msg) => { if (msg)
+            console.log(`INFO: ${msg}`); return self; },
+        clear: () => self,
+        get text() { return text; },
+        set text(value) { text = value; },
+        get isSpinning() { return false; },
+        get color() { return 'cyan'; },
+        set color(_) { },
+    };
+    return self;
+}
+/**
+ * Start a spinner with the given text. Returns a wrapped spinner instance
+ * whose success/error/warning/info methods add an extra space after the symbol
+ * for consistent formatting.
+ *
+ * In non-TTY environments (CI pipelines, piped output), returns a no-op
+ * spinner that outputs plain text without ANSI escape codes.
+ */
+export function startSpinner(text) {
+    if (!isTTY()) {
+        return createNoOpSpinner(text);
+    }
+    const spinner = yoctoSpinner({ text, color: 'cyan' }).start();
+    const origSuccess = spinner.success.bind(spinner);
+    const origError = spinner.error.bind(spinner);
+    const origWarning = spinner.warning.bind(spinner);
+    const origInfo = spinner.info.bind(spinner);
+    spinner.success = (msg) => origSuccess(msg ? ` ${msg}` : undefined);
+    spinner.error = (msg) => origError(msg ? ` ${msg}` : undefined);
+    spinner.warning = (msg) => origWarning(msg ? ` ${msg}` : undefined);
+    spinner.info = (msg) => origInfo(msg ? ` ${msg}` : undefined);
+    return spinner;
+}
+/**
+ * Format a status badge (enabled/disabled).
+ */
+export function badge(enabled) {
+    return enabled
+        ? chalk.bgGreen.black('[enabled]')
+        : chalk.bgRed.white('[disabled]');
+}
+/**
+ * Print a feature row with a styled badge and name.
+ */
+export function featureRow(name, enabled) {
+    console.log(`    ${badge(enabled)} ${name}`);
+}
+/**
+ * Print a divider line.
+ */
+export function divider() {
+    console.log(chalk.dim('─'.repeat(50)));
+}
+//# sourceMappingURL=ui.js.map

package/dist/utils/ui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.js","sourceRoot":"","sources":["../../src/utils/ui.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,YAA8B,MAAM,eAAe,CAAC;AAG3D,uBAAuB;AACvB,IAAI,cAAc,GAAG,KAAK,CAAC;AAE3B,MAAM,UAAU,UAAU,CAAC,OAAgB;IACzC,cAAc,GAAG,OAAO,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,GAAW;IACjC,IAAI,cAAc,EAAE,CAAC;QACnB,IAAI,KAAK,EAAE,EAAE,CAAC;YACZ,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,aAAa,GAAG,EAAE,CAAC,CAAC,CAAC;QAC7C,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,aAAa,GAAG,EAAE,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;AACH,CAAC;AAED,wBAAwB;AACxB,SAAS,KAAK;IACZ,OAAO,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,SAAS,OAAO,CAAC,IAAY;IAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,OAAO,GAAG,CAAC,CAAC;IAClB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IAChE,MAAM,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,CAAC,CAAC;IACxC,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAEhC,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,CAAC;IAC3D,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,CAAC;IAC9D,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;QAC3B,MAAM,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QACpC,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,OAAO,CAAC,CAAC;QAC3C,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,KAAK,GAAG,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,EAAE,GAAG,MAAM,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,SAAS,SAAS,CAAC,GAAW;IAC5B,4CAA4C;IAC5C,OAAO,GAAG,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAY,EAAE,UAAmB;IACnE,GAAG,CAAC,aAAa,CAAC;QAChB,UAAU,CAAC,MAAe,EAAE,MAAY;YACtC,MAAM,MAAM,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC;YAC9B,MAAM,KAAK,GAAa,EAAE,CAAC;YAE3B,gDAAgD;YAChD,IAAI,MAAM,IAAI,UAAU,EAAE,CAAC;gBACzB,KAAK,CAAC,IAAI,CACR,OAAO,CACL,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,IAAI,UAAU,EAAE,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,mDAAmD,CAAC,EAAE,CACzI,CACF,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,IAAI,CACR,OAAO,CACL,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,WAAW,EAAE,EAAE,CAC9E,CACF,CAAC;YACJ,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAEf,QAAQ;YACR,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC;YACnF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAEf,cAAc;YACd,MAAM,WAAW,GAAG,MAAM,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;YACnD,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC3B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;gBACpC,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;oBAC9B,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;gBAC/F,CAAC;gBACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACjB,CAAC;YAED,YAAY;YACZ,MAAM,IAAI,GAAG,MAAM,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;YAC7C,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;gBACrC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;oBACvB,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;gBACpH,CAAC;gBACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACjB,CAAC;YAED,UAAU;YACV,MAAM,OAAO,GAAG,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;YAC9C,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;gBACnC,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;oBAC1B,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;gBAChH,CAAC;gBACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACjB,CAAC;YAED,SAAS;YACT,IAAI,MAAM,EAAE,CAAC;gBACX,KAAK,CAAC,IAAI,CACR,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC;oBACjB,KAAK,CAAC,MAAM,CAAC,4BAA4B,CAAC;oBAC1C,KAAK,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAClD,CAAC;gBACF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACjB,CAAC;YAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;KACF,CAAC,CAAC;IACH,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,GAAW;IACjC,IAAI,KAAK,EAAE,EAAE,CAAC;QACZ,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;IAC7C,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,YAAY,GAAG,EAAE,CAAC,CAAC;IACjC,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,KAAK,CAAC,GAAW;IAC/B,IAAI,KAAK,EAAE,EAAE,CAAC;QACZ,OAAO,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACxD,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,UAAU,GAAG,EAAE,CAAC,CAAC;IACjC,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,IAAI,CAAC,GAAW;IAC9B,IAAI,KAAK,EAAE,EAAE,CAAC;QACZ,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;IAC5C,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,SAAS,GAAG,EAAE,CAAC,CAAC;IAC9B,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,IAAI,CAAC,GAAW;IAC9B,IAAI,KAAK,EAAE,EAAE,CAAC;QACZ,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC5D,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,SAAS,GAAG,EAAE,CAAC,CAAC;IAC9B,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,GAAW;IACjC,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAC3C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,KAAK,CAAC,GAAW,EAAE,KAAa;IAC9C,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC;AACrD,CAAC;AAED;;;GAGG;AACH,SAAS,iBAAiB,CAAC,IAAY;IACrC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAClB,MAAM,IAAI,GAAY;QACpB,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI;QACjB,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI;QAChB,OAAO,EAAE,CAAC,GAAY,EAAE,EAAE,GAAG,IAAI,GAAG;YAAE,OAAO,CAAC,GAAG,CAAC,YAAY,GAAG,EAAE,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC;QACpF,KAAK,EAAE,CAAC,GAAY,EAAE,EAAE,GAAG,IAAI,GAAG;YAAE,OAAO,CAAC,KAAK,CAAC,UAAU,GAAG,EAAE,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC;QAClF,OAAO,EAAE,CAAC,GAAY,EAAE,EAAE,GAAG,IAAI,GAAG;YAAE,OAAO,CAAC,GAAG,CAAC,SAAS,GAAG,EAAE,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC;QACjF,IAAI,EAAE,CAAC,GAAY,EAAE,EAAE,GAAG,IAAI,GAAG;YAAE,OAAO,CAAC,GAAG,CAAC,SAAS,GAAG,EAAE,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC;QAC9E,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI;QACjB,IAAI,IAAI,KAAK,OAAO,IAAI,CAAC,CAAC,CAAC;QAC3B,IAAI,IAAI,CAAC,KAAa,IAAI,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC;QACzC,IAAI,UAAU,KAAK,OAAO,KAAK,CAAC,CAAC,CAAC;QAClC,IAAI,KAAK,KAAK,OAAO,MAAe,CAAC,CAAC,CAAC;QACvC,IAAI,KAAK,CAAC,CAAS,IAAgB,CAAC;KACf,CAAC;IACxB,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;QACb,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,MAAM,OAAO,GAAG,YAAY,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;IAE9D,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAClD,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC9C,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAE5C,OAAO,CAAC,OAAO,GAAG,CAAC,GAAY,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC7E,OAAO,CAAC,KAAK,GAAG,CAAC,GAAY,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACzE,OAAO,CAAC,OAAO,GAAG,CAAC,GAAY,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC7E,OAAO,CAAC,IAAI,GAAG,CAAC,GAAY,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAEvE,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,KAAK,CAAC,OAAgB;IACpC,OAAO,OAAO;QACZ,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC;QAClC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,OAAgB;IACvD,OAAO,CAAC,GAAG,CAAC,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO;IACrB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AACzC,CAAC"}

package/dist/utils/update-check.d.ts

@@ -0,0 +1,19 @@
+interface UpdateInfo {
+    current: string;
+    latest: string;
+}
+/** Fetch the latest version string from the npm registry. */
+export declare function fetchLatestVersion(): Promise<string>;
+/**
+ * Check if a newer version is available on npm.
+ * Returns update info if available, null otherwise.
+ * Never throws — all errors are silently caught.
+ */
+export declare function checkForUpdate(currentVersion: string): Promise<UpdateInfo | null>;
+/** Format the "update available" message with chalk styling. */
+export declare function formatUpdateAvailable(current: string, latest: string): string;
+/** Print a styled update notification to stderr (does not interfere with stdout piping). */
+export declare function printUpdateNotification(current: string, latest: string): void;
+/** Returns true if the CLI was likely invoked via npx. */
+export declare function isRunningViaNpx(): boolean;
+export {};