@agents-dev/cli 0.7.7 → 0.8.1

package/dist/core/project.js.map

@@ -1 +1 @@
-{"version":3,"file":"project.js","sourceRoot":"","sources":["../../src/core/project.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAC/C,OAAO,EAAE,yBAAyB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAC5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AAEtD,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,IAO/C;IACC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,QAAQ,EAAE,qBAAqB,EAAE,GAAG,IAAI,CAAA;IAEtG,MAAM,KAAK,GAAG,eAAe,CAAC,WAAW,CAAC,CAAA;IAC1C,MAAM,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;IAChC,MAAM,SAAS,CAAC,KAAK,CAAC,YAAY,CAAC,CAAA;IACnC,MAAM,SAAS,CAAC,KAAK,CAAC,eAAe,CAAC,CAAA;IAEtC,MAAM,OAAO,GAAa,EAAE,CAAA;IAC5B,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,qBAAqB,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC,CAAA;IAElE,MAAM,MAAM,GAAG,yBAAyB,CAAC;QACvC,mBAAmB,EAAE,YAAY;QACjC,kBAAkB;QAClB,QAAQ;QACR,aAAa,EAAE,qBAAqB;KACrC,CAAC,CAAA;IAEF,IAAI,KAAK,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC;QACrD,MAAM,gBAAgB,CAAC,WAAW,EAAE,MAAM,CAAC,CAAA;QAC3C,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,KAAK,CAAC,YAAY,CAAC,IAAI,KAAK,CAAC,YAAY,CAAC,CAAA;IACpF,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,CAAA;AACpB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAGxC;IACC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;IACpC,MAAM,gBAAgB,CAAC,WAAW,EAAE,MAAM,CAAC,CAAA;AAC7C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,WAAmB;IAC1D,MAAM,KAAK,GAAG,eAAe,CAAC,WAAW,CAAC,CAAA;IAC1C,OAAO,UAAU,CAAC,KAAK,CAAC,YAAY,CAAC,CAAA;AACvC,CAAC"}
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../../src/core/project.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAC/C,OAAO,EAAE,yBAAyB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAC5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AAEtD,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,IAO/C;IACC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,QAAQ,EAAE,qBAAqB,EAAE,GAAG,IAAI,CAAA;IAEtG,MAAM,KAAK,GAAG,eAAe,CAAC,WAAW,CAAC,CAAA;IAC1C,MAAM,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;IAChC,MAAM,SAAS,CAAC,KAAK,CAAC,YAAY,CAAC,CAAA;IACnC,MAAM,SAAS,CAAC,KAAK,CAAC,eAAe,CAAC,CAAA;IAEtC,MAAM,OAAO,GAAa,EAAE,CAAA;IAC5B,MAAM,QAAQ,GAAa,EAAE,CAAA;IAC7B,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAAC,WAAW,EAAE,KAAK,CAAC,CAAA;IAChE,OAAO,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAA;IACjC,QAAQ,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAA;IAEnC,MAAM,MAAM,GAAG,yBAAyB,CAAC;QACvC,mBAAmB,EAAE,YAAY;QACjC,kBAAkB;QAClB,QAAQ;QACR,aAAa,EAAE,qBAAqB;KACrC,CAAC,CAAA;IAEF,IAAI,KAAK,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC;QACrD,MAAM,gBAAgB,CAAC,WAAW,EAAE,MAAM,CAAC,CAAA;QAC3C,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,KAAK,CAAC,YAAY,CAAC,IAAI,KAAK,CAAC,YAAY,CAAC,CAAA;IACpF,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAA;AAC9B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAGxC;IACC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;IACpC,MAAM,gBAAgB,CAAC,WAAW,EAAE,MAAM,CAAC,CAAA;AAC7C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,WAAmB;IAC1D,MAAM,KAAK,GAAG,eAAe,CAAC,WAAW,CAAC,CAAA;IAC1C,OAAO,UAAU,CAAC,KAAK,CAAC,YAAY,CAAC,CAAA;AACvC,CAAC"}

package/dist/core/templates.d.ts

@@ -1 +1,4 @@
-export declare function scaffoldBaseTemplates(projectRoot: string, force: boolean): Promise<string[]>;
+export declare function scaffoldBaseTemplates(projectRoot: string, force: boolean): Promise<{
+    changed: string[];
+    warnings: string[];
+}>;

package/dist/core/templates.js

@@ -1,5 +1,5 @@
 import path from 'node:path';
-import { copyFile } from 'node:fs/promises';
+import { copyFile, lstat } from 'node:fs/promises';
 import { fileURLToPath } from 'node:url';
 import { ensureDir, pathExists, writeTextAtomic } from './fs.js';
 import { getProjectPaths } from './paths.js';
@@ -21,8 +21,17 @@ export async function scaffoldBaseTemplates(projectRoot, force) {
         }
     ];
     const changed = [];
+    const warnings = [];
     for (const pair of pairs) {
-        if (!force && (await pathExists(pair.to))) {
+        const exists = await pathExists(pair.to);
+        if (pair.to === paths.rootAgentsMd && exists) {
+            const info = await lstat(pair.to);
+            if (!info.isFile()) {
+                warnings.push('AGENTS.md exists and is not a regular file (symlink/directory). Skipped overwrite.');
+            }
+            continue;
+        }
+        if (!force && exists) {
             continue;
         }
         await ensureDir(path.dirname(pair.to));
@@ -33,6 +42,6 @@ export async function scaffoldBaseTemplates(projectRoot, force) {
         await writeTextAtomic(paths.agentsLocal, '{\n  "mcpServers": {}\n}\n');
         changed.push(path.relative(projectRoot, paths.agentsLocal) || paths.agentsLocal);
     }
-    return changed;
+    return { changed, warnings };
 }
 //# sourceMappingURL=templates.js.map

package/dist/core/templates.js.map

@@ -1 +1 @@
-{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/core/templates.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAE5C,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AACjD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAA;AAC1C,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,wBAAwB,CAAC,CAAA;AAEvE,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,WAAmB,EAAE,KAAc;IAC7E,MAAM,KAAK,GAAG,eAAe,CAAC,WAAW,CAAC,CAAA;IAC1C,MAAM,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;IAChC,MAAM,SAAS,CAAC,KAAK,CAAC,YAAY,CAAC,CAAA;IACnC,MAAM,SAAS,CAAC,KAAK,CAAC,eAAe,CAAC,CAAA;IAEtC,MAAM,KAAK,GAAwC;QACjD,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,YAAY,EAAE;QACvE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,YAAY,EAAE;QACvE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,QAAQ,EAAE,WAAW,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,eAAe,EAAE,WAAW,CAAC,EAAE;QAC5G;YACE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,QAAQ,EAAE,aAAa,EAAE,UAAU,CAAC;YACnE,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,eAAe,EAAE,aAAa,EAAE,UAAU,CAAC;SAChE;KACF,CAAA;IAED,MAAM,OAAO,GAAa,EAAE,CAAA;IAE5B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YAC1C,SAAQ;QACV,CAAC;QACD,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAA;QACtC,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC,CAAA;QAClC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC,CAAA;IAC9D,CAAC;IAED,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC;QAC3C,MAAM,eAAe,CAAC,KAAK,CAAC,WAAW,EAAE,4BAA4B,CAAC,CAAA;QACtE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,KAAK,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC,WAAW,CAAC,CAAA;IAClF,CAAC;IAED,OAAO,OAAO,CAAA;AAChB,CAAC"}
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/core/templates.ts"],"names":[],"mappings":"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"}

package/dist/core/ui.d.ts

@@ -0,0 +1,155 @@
+/**
+ * Unified UI module for @agents-dev/cli
+ *
+ * Provides consistent formatting, colors, and symbols across all commands.
+ * Features:
+ * - Unicode symbols with ASCII fallback
+ * - Minimalist colors (only for status indicators)
+ * - Context-aware output (respects --json, NO_COLOR)
+ * - Spinner wrapper for async operations
+ */
+import * as clack from '@clack/prompts';
+import color from 'picocolors';
+export declare const symbols: {
+    readonly success: "✓";
+    readonly error: "✗";
+    readonly warning: "⚠";
+    readonly info: "○";
+    readonly bullet: "•";
+    readonly arrow: "→";
+    readonly ellipsis: "…";
+} | {
+    readonly success: "[ok]";
+    readonly error: "[error]";
+    readonly warning: "[warn]";
+    readonly info: "[info]";
+    readonly bullet: "-";
+    readonly arrow: "->";
+    readonly ellipsis: "...";
+};
+interface UIContext {
+    json: boolean;
+    quiet: boolean;
+    noColor: boolean;
+}
+/**
+ * Set UI context flags (call at command start)
+ */
+export declare function setContext(options: Partial<UIContext>): void;
+/**
+ * Reset UI context to defaults
+ */
+export declare function resetContext(): void;
+/**
+ * Write raw text to stdout
+ */
+export declare function write(text: string): void;
+/**
+ * Write a line to stdout
+ */
+export declare function writeln(text?: string): void;
+/**
+ * Output success message: ✓ message (green)
+ */
+export declare function success(message: string): void;
+/**
+ * Output error message: ✗ message (red)
+ */
+export declare function error(message: string): void;
+/**
+ * Output warning message: ⚠ message (yellow)
+ */
+export declare function warning(message: string): void;
+/**
+ * Output info message: ○ message (cyan)
+ */
+export declare function info(message: string): void;
+/**
+ * Output dim/secondary text
+ */
+export declare function dim(message: string): void;
+/**
+ * Output a blank line
+ */
+export declare function blank(): void;
+/**
+ * Output key-value pair with aligned formatting
+ * Example: "Project:      /path/to/project"
+ */
+export declare function keyValue(key: string, value: string, keyWidth?: number): void;
+/**
+ * Output a bulleted list
+ * Example:
+ *   • item1
+ *   • item2
+ */
+export declare function list(items: string[], indent?: number): void;
+/**
+ * Output a list with status indicators
+ * Example:
+ *   ✓ file1.json
+ *   ✗ file2.json (missing)
+ */
+export declare function statusList(items: Array<{
+    label: string;
+    ok: boolean;
+    detail?: string;
+}>, indent?: number): void;
+/**
+ * Output a section with title
+ * Example:
+ *   Files:
+ *     ✓ config.json
+ *     ✗ local.json
+ */
+export declare function section(title: string, content: string[] | (() => void)): void;
+/**
+ * Output items with arrow prefix (for "changed" lists)
+ * Example:
+ *   → file1.json
+ *   → file2.json
+ */
+export declare function arrowList(items: string[], indent?: number): void;
+/**
+ * Output a hint/help message
+ */
+export declare function hint(message: string): void;
+/**
+ * Output next steps
+ */
+export declare function nextSteps(message: string): void;
+export interface Spinner {
+    start: (message?: string) => void;
+    stop: (message?: string) => void;
+    message: (message: string) => void;
+}
+/**
+ * Create a spinner for async operations
+ * Returns a no-op spinner if in JSON mode or non-TTY
+ */
+export declare function spinner(): Spinner;
+/**
+ * Output JSON and exit (for --json flag handling)
+ */
+export declare function json<T>(data: T): void;
+/**
+ * Format a count with singular/plural label
+ * Example: formatCount(1, 'file', 'files') => '1 file'
+ * Example: formatCount(3, 'file', 'files') => '3 files'
+ */
+export declare function formatCount(count: number, singular: string, plural: string): string;
+/**
+ * Format a list of items with "none" fallback
+ * Example: formatList(['a', 'b']) => 'a, b'
+ * Example: formatList([]) => '(none)'
+ */
+export declare function formatList(items: string[], fallback?: string): string;
+/**
+ * Format enabled/disabled status
+ */
+export declare function formatEnabled(enabled: boolean): string;
+/**
+ * Format ok/missing status for files
+ */
+export declare function formatExists(exists: boolean): string;
+export { color, clack };

package/dist/core/ui.js

@@ -0,0 +1,350 @@
+/**
+ * Unified UI module for @agents-dev/cli
+ *
+ * Provides consistent formatting, colors, and symbols across all commands.
+ * Features:
+ * - Unicode symbols with ASCII fallback
+ * - Minimalist colors (only for status indicators)
+ * - Context-aware output (respects --json, NO_COLOR)
+ * - Spinner wrapper for async operations
+ */
+import * as clack from '@clack/prompts';
+import color from 'picocolors';
+// ---------------------------------------------------------------------------
+// Terminal Detection
+// ---------------------------------------------------------------------------
+/**
+ * Detect if terminal supports Unicode characters
+ */
+function detectUnicodeSupport() {
+    // Windows Terminal and modern terminals support Unicode
+    if (process.env.WT_SESSION)
+        return true;
+    if (process.env.TERM_PROGRAM === 'vscode')
+        return true;
+    if (process.env.TERM_PROGRAM === 'iTerm.app')
+        return true;
+    if (process.env.TERM_PROGRAM === 'Apple_Terminal')
+        return true;
+    // Check locale settings
+    const locale = (process.env.LC_ALL ?? process.env.LC_CTYPE ?? process.env.LANG ?? '').toLowerCase();
+    if (locale.includes('utf-8') || locale.includes('utf8'))
+        return true;
+    // Check TERM
+    const term = (process.env.TERM ?? '').toLowerCase();
+    if (term.includes('xterm') || term.includes('256color') || term.includes('kitty') || term.includes('alacritty')) {
+        return true;
+    }
+    // CI environments usually support Unicode
+    if (process.env.CI)
+        return true;
+    // Default to ASCII for unknown terminals
+    return false;
+}
+/**
+ * Check if colors should be disabled
+ */
+function isNoColor() {
+    return Boolean(process.env.NO_COLOR) || process.argv.includes('--no-color');
+}
+/**
+ * Check if we're in a TTY (interactive terminal)
+ */
+function isTTY() {
+    return Boolean(process.stdout.isTTY);
+}
+// ---------------------------------------------------------------------------
+// Symbols
+// ---------------------------------------------------------------------------
+const UNICODE_SYMBOLS = {
+    success: '\u2713', // ✓
+    error: '\u2717', // ✗
+    warning: '\u26a0', // ⚠
+    info: '\u25cb', // ○
+    bullet: '\u2022', // •
+    arrow: '\u2192', // →
+    ellipsis: '\u2026' // …
+};
+const ASCII_SYMBOLS = {
+    success: '[ok]',
+    error: '[error]',
+    warning: '[warn]',
+    info: '[info]',
+    bullet: '-',
+    arrow: '->',
+    ellipsis: '...'
+};
+const supportsUnicode = detectUnicodeSupport();
+export const symbols = supportsUnicode ? UNICODE_SYMBOLS : ASCII_SYMBOLS;
+const context = {
+    json: false,
+    quiet: false,
+    noColor: isNoColor()
+};
+/**
+ * Set UI context flags (call at command start)
+ */
+export function setContext(options) {
+    if (options.json !== undefined)
+        context.json = options.json;
+    if (options.quiet !== undefined)
+        context.quiet = options.quiet;
+    if (options.noColor !== undefined)
+        context.noColor = options.noColor;
+}
+/**
+ * Reset UI context to defaults
+ */
+export function resetContext() {
+    context.json = false;
+    context.quiet = false;
+    context.noColor = isNoColor();
+}
+/**
+ * Check if output should be suppressed
+ */
+function shouldSuppress() {
+    return context.json || context.quiet;
+}
+// ---------------------------------------------------------------------------
+// Color Helpers
+// ---------------------------------------------------------------------------
+function applyColor(fn, text) {
+    if (context.noColor)
+        return text;
+    return fn(text);
+}
+const colors = {
+    success: (s) => applyColor(color.green, s),
+    error: (s) => applyColor(color.red, s),
+    warning: (s) => applyColor(color.yellow, s),
+    info: (s) => applyColor(color.cyan, s),
+    dim: (s) => applyColor(color.dim, s),
+    bold: (s) => applyColor(color.bold, s)
+};
+// ---------------------------------------------------------------------------
+// Output Functions
+// ---------------------------------------------------------------------------
+/**
+ * Write raw text to stdout
+ */
+export function write(text) {
+    if (shouldSuppress())
+        return;
+    process.stdout.write(text);
+}
+/**
+ * Write a line to stdout
+ */
+export function writeln(text = '') {
+    write(`${text}\n`);
+}
+/**
+ * Output success message: ✓ message (green)
+ */
+export function success(message) {
+    if (shouldSuppress())
+        return;
+    writeln(`${colors.success(symbols.success)} ${message}`);
+}
+/**
+ * Output error message: ✗ message (red)
+ */
+export function error(message) {
+    if (shouldSuppress())
+        return;
+    writeln(`${colors.error(symbols.error)} ${message}`);
+}
+/**
+ * Output warning message: ⚠ message (yellow)
+ */
+export function warning(message) {
+    if (shouldSuppress())
+        return;
+    writeln(`${colors.warning(symbols.warning)} ${message}`);
+}
+/**
+ * Output info message: ○ message (cyan)
+ */
+export function info(message) {
+    if (shouldSuppress())
+        return;
+    writeln(`${colors.info(symbols.info)} ${message}`);
+}
+/**
+ * Output dim/secondary text
+ */
+export function dim(message) {
+    if (shouldSuppress())
+        return;
+    writeln(colors.dim(message));
+}
+/**
+ * Output a blank line
+ */
+export function blank() {
+    if (shouldSuppress())
+        return;
+    writeln();
+}
+// ---------------------------------------------------------------------------
+// Layout Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Output key-value pair with aligned formatting
+ * Example: "Project:      /path/to/project"
+ */
+export function keyValue(key, value, keyWidth = 14) {
+    if (shouldSuppress())
+        return;
+    const paddedKey = key.padEnd(keyWidth);
+    writeln(`${paddedKey} ${value}`);
+}
+/**
+ * Output a bulleted list
+ * Example:
+ *   • item1
+ *   • item2
+ */
+export function list(items, indent = 2) {
+    if (shouldSuppress())
+        return;
+    const padding = ' '.repeat(indent);
+    for (const item of items) {
+        writeln(`${padding}${symbols.bullet} ${item}`);
+    }
+}
+/**
+ * Output a list with status indicators
+ * Example:
+ *   ✓ file1.json
+ *   ✗ file2.json (missing)
+ */
+export function statusList(items, indent = 2) {
+    if (shouldSuppress())
+        return;
+    const padding = ' '.repeat(indent);
+    for (const item of items) {
+        const symbol = item.ok ? colors.success(symbols.success) : colors.error(symbols.error);
+        const detail = item.detail ? colors.dim(` (${item.detail})`) : '';
+        writeln(`${padding}${symbol} ${item.label}${detail}`);
+    }
+}
+/**
+ * Output a section with title
+ * Example:
+ *   Files:
+ *     ✓ config.json
+ *     ✗ local.json
+ */
+export function section(title, content) {
+    if (shouldSuppress())
+        return;
+    writeln(`${title}:`);
+    if (typeof content === 'function') {
+        content();
+    }
+    else {
+        for (const line of content) {
+            writeln(`  ${line}`);
+        }
+    }
+}
+/**
+ * Output items with arrow prefix (for "changed" lists)
+ * Example:
+ *   → file1.json
+ *   → file2.json
+ */
+export function arrowList(items, indent = 2) {
+    if (shouldSuppress())
+        return;
+    const padding = ' '.repeat(indent);
+    for (const item of items) {
+        writeln(`${padding}${colors.dim(symbols.arrow)} ${item}`);
+    }
+}
+/**
+ * Output a hint/help message
+ */
+export function hint(message) {
+    if (shouldSuppress())
+        return;
+    writeln(colors.dim(`Hint: ${message}`));
+}
+/**
+ * Output next steps
+ */
+export function nextSteps(message) {
+    if (shouldSuppress())
+        return;
+    writeln(`Next: ${message}`);
+}
+/**
+ * Create a spinner for async operations
+ * Returns a no-op spinner if in JSON mode or non-TTY
+ */
+export function spinner() {
+    // No spinner in JSON mode or non-TTY
+    if (context.json || context.quiet || !isTTY()) {
+        return {
+            start: () => { },
+            stop: () => { },
+            message: () => { }
+        };
+    }
+    const spin = clack.spinner();
+    return {
+        start: (message) => spin.start(message ?? 'Working...'),
+        stop: (message) => spin.stop(message ?? 'Done'),
+        message: (message) => spin.message(message)
+    };
+}
+// ---------------------------------------------------------------------------
+// JSON Output
+// ---------------------------------------------------------------------------
+/**
+ * Output JSON and exit (for --json flag handling)
+ */
+export function json(data) {
+    process.stdout.write(`${JSON.stringify(data, null, 2)}\n`);
+}
+// ---------------------------------------------------------------------------
+// Formatting Utilities
+// ---------------------------------------------------------------------------
+/**
+ * Format a count with singular/plural label
+ * Example: formatCount(1, 'file', 'files') => '1 file'
+ * Example: formatCount(3, 'file', 'files') => '3 files'
+ */
+export function formatCount(count, singular, plural) {
+    return `${count} ${count === 1 ? singular : plural}`;
+}
+/**
+ * Format a list of items with "none" fallback
+ * Example: formatList(['a', 'b']) => 'a, b'
+ * Example: formatList([]) => '(none)'
+ */
+export function formatList(items, fallback = '(none)') {
+    return items.length > 0 ? items.join(', ') : fallback;
+}
+/**
+ * Format enabled/disabled status
+ */
+export function formatEnabled(enabled) {
+    return enabled ? 'enabled' : 'disabled';
+}
+/**
+ * Format ok/missing status for files
+ */
+export function formatExists(exists) {
+    if (exists) {
+        return colors.success(symbols.success);
+    }
+    return `${colors.error(symbols.error)} ${colors.dim('(missing)')}`;
+}
+// ---------------------------------------------------------------------------
+// Re-exports for convenience
+// ---------------------------------------------------------------------------
+export { color, clack };
+//# sourceMappingURL=ui.js.map

package/dist/core/ui.js.map

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

package/dist/core/windsurfPaths.d.ts

@@ -0,0 +1,8 @@
+export interface WindsurfMcpPathResolution {
+    configPath: string;
+    source: 'env' | 'existing-modern' | 'existing-legacy' | 'default-modern';
+    modernPath: string;
+    legacyPath: string;
+}
+export declare function resolveWindsurfMcpConfigPath(): Promise<WindsurfMcpPathResolution>;
+export declare function getWindsurfMcpLockPath(configPath: string): string;

package/dist/core/windsurfPaths.js

@@ -0,0 +1,43 @@
+import os from 'node:os';
+import path from 'node:path';
+import { pathExists } from './fs.js';
+const ENV_OVERRIDE = 'AGENTS_WINDSURF_MCP_CONFIG_PATH';
+export async function resolveWindsurfMcpConfigPath() {
+    const modernPath = path.join(os.homedir(), '.codeium', 'windsurf', 'mcp_config.json');
+    const legacyPath = path.join(os.homedir(), '.codeium', 'mcp_config.json');
+    const override = process.env[ENV_OVERRIDE]?.trim();
+    if (override) {
+        return {
+            configPath: path.resolve(override),
+            source: 'env',
+            modernPath,
+            legacyPath
+        };
+    }
+    if (await pathExists(modernPath)) {
+        return {
+            configPath: modernPath,
+            source: 'existing-modern',
+            modernPath,
+            legacyPath
+        };
+    }
+    if (await pathExists(legacyPath)) {
+        return {
+            configPath: legacyPath,
+            source: 'existing-legacy',
+            modernPath,
+            legacyPath
+        };
+    }
+    return {
+        configPath: modernPath,
+        source: 'default-modern',
+        modernPath,
+        legacyPath
+    };
+}
+export function getWindsurfMcpLockPath(configPath) {
+    return path.join(path.dirname(configPath), `${path.basename(configPath)}.agents.lock`);
+}
+//# sourceMappingURL=windsurfPaths.js.map

package/dist/core/windsurfPaths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"windsurfPaths.js","sourceRoot":"","sources":["../../src/core/windsurfPaths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAEpC,MAAM,YAAY,GAAG,iCAAiC,CAAA;AAStD,MAAM,CAAC,KAAK,UAAU,4BAA4B;IAChD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,UAAU,EAAE,iBAAiB,CAAC,CAAA;IACrF,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,iBAAiB,CAAC,CAAA;IACzE,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,CAAA;IAElD,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO;YACL,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;YAClC,MAAM,EAAE,KAAK;YACb,UAAU;YACV,UAAU;SACX,CAAA;IACH,CAAC;IAED,IAAI,MAAM,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACjC,OAAO;YACL,UAAU,EAAE,UAAU;YACtB,MAAM,EAAE,iBAAiB;YACzB,UAAU;YACV,UAAU;SACX,CAAA;IACH,CAAC;IAED,IAAI,MAAM,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACjC,OAAO;YACL,UAAU,EAAE,UAAU;YACtB,MAAM,EAAE,iBAAiB;YACzB,UAAU;YACV,UAAU;SACX,CAAA;IACH,CAAC;IAED,OAAO;QACL,UAAU,EAAE,UAAU;QACtB,MAAM,EAAE,gBAAgB;QACxB,UAAU;QACV,UAAU;KACX,CAAA;AACH,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,UAAkB;IACvD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,cAAc,CAAC,CAAA;AACxF,CAAC"}

package/dist/integrations/windsurf.d.ts

@@ -0,0 +1,9 @@
+import type { ResolvedMcpServer } from '../types.js';
+export declare function buildWindsurfPayload(servers: ResolvedMcpServer[]): {
+    payload: {
+        mcpServers: Record<string, unknown>;
+    };
+    warnings: string[];
+};
+export declare function toManagedWindsurfName(projectHash: string, serverName: string): string;
+export declare function deriveWindsurfProjectHash(projectRoot: string): string;

package/dist/integrations/windsurf.js

@@ -0,0 +1,17 @@
+import { createHash } from 'node:crypto';
+import path from 'node:path';
+import { renderWindsurfMcp } from '../core/renderers.js';
+export function buildWindsurfPayload(servers) {
+    const rendered = renderWindsurfMcp(servers);
+    return {
+        payload: { mcpServers: rendered.servers },
+        warnings: rendered.warnings
+    };
+}
+export function toManagedWindsurfName(projectHash, serverName) {
+    return `agents__${projectHash}__${serverName}`;
+}
+export function deriveWindsurfProjectHash(projectRoot) {
+    return createHash('sha256').update(path.resolve(projectRoot)).digest('hex').slice(0, 12);
+}
+//# sourceMappingURL=windsurf.js.map

package/dist/integrations/windsurf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"windsurf.js","sourceRoot":"","sources":["../../src/integrations/windsurf.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAGxD,MAAM,UAAU,oBAAoB,CAAC,OAA4B;IAI/D,MAAM,QAAQ,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAA;IAC3C,OAAO;QACL,OAAO,EAAE,EAAE,UAAU,EAAE,QAAQ,CAAC,OAAO,EAAE;QACzC,QAAQ,EAAE,QAAQ,CAAC,QAAQ;KAC5B,CAAA;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,WAAmB,EAAE,UAAkB;IAC3E,OAAO,WAAW,WAAW,KAAK,UAAU,EAAE,CAAA;AAChD,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,WAAmB;IAC3D,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;AAC1F,CAAC"}