@a1st/aix 0.0.3

package/bin/dev.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+
+import { register } from 'node:module';
+import { dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+// Resolve ts-exec from this file's directory, not cwd
+const __dirname = dirname(fileURLToPath(import.meta.url));
+register('@poppinss/ts-exec', new URL(`file://${__dirname}/`));
+
+const { execute } = await import('@oclif/core');
+
+await execute({ development: true, dir: import.meta.url });

package/bin/run.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+
+import { execute } from '@oclif/core';
+
+await execute({ dir: import.meta.url });

package/dist/base-command.d.ts

@@ -0,0 +1,48 @@
+import { Command, Interfaces } from '@oclif/core';
+import { ConfigParseError, type LoadedConfig } from '@a1st/aix-core';
+import { Output } from './lib/output.js';
+export type InferredFlags<T extends typeof Command> = Interfaces.InferredFlags<(typeof BaseCommand)['baseFlags'] & T['flags']>;
+export declare abstract class BaseCommand<T extends typeof Command> extends Command {
+    static baseFlags: {
+        config: Interfaces.OptionFlag<string | undefined, Interfaces.CustomOptions>;
+        quiet: Interfaces.BooleanFlag<boolean>;
+        json: Interfaces.BooleanFlag<boolean>;
+    };
+    protected flags: InferredFlags<T>;
+    protected output: Output;
+    protected loadedConfig?: LoadedConfig;
+    init(): Promise<void>;
+    protected loadConfig(): Promise<LoadedConfig | undefined>;
+    protected requireConfig(): Promise<LoadedConfig>;
+    /** Log formatted install results */
+    protected logInstallResults(results: Array<{
+        message: string;
+        success: boolean;
+    }>): void;
+    /** Log delete operation results */
+    protected logDeleteResults(results: Array<{
+        editor: string;
+        deleted: string[];
+        errors: string[];
+    }>): void;
+    protected catch(error: Error & {
+        exitCode?: number;
+    }): Promise<void>;
+    /**
+     * Display a ConfigParseError in human-readable format.
+     *
+     * Format:
+     * ```
+     * ✗ Configuration Error
+     *
+     *   File: ai.local.json
+     *
+     *   ● mcp.playwright
+     *     Expected object or false, received true
+     *
+     *   Found 2 validation errors.
+     * ```
+     */
+    protected displayConfigParseError(error: ConfigParseError): void;
+}
+//# sourceMappingURL=base-command.d.ts.map

package/dist/base-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-command.d.ts","sourceRoot":"","sources":["../src/base-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAS,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzD,OAAO,EAAgC,gBAAgB,EAAE,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnG,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEzC,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,OAAO,OAAO,IAAI,UAAU,CAAC,aAAa,CAC3E,CAAC,OAAO,WAAW,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAChD,CAAC;AAEF,8BAAsB,WAAW,CAAC,CAAC,SAAS,OAAO,OAAO,CAAE,SAAQ,OAAO;IACxE,MAAM,CAAC,SAAS;;;;MAed;IAEF,SAAS,CAAC,KAAK,EAAG,aAAa,CAAC,CAAC,CAAC,CAAC;IACnC,SAAS,CAAC,MAAM,EAAG,MAAM,CAAC;IAC1B,SAAS,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;IAEzB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;cAgBlB,UAAU,IAAI,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;cAiB/C,aAAa,IAAI,OAAO,CAAC,YAAY,CAAC;IAStD,oCAAoC;IACpC,SAAS,CAAC,iBAAiB,CAAC,OAAO,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,GAAG,IAAI;IAUxF,mCAAmC;IACnC,SAAS,CAAC,gBAAgB,CACvB,OAAO,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,GACvE,IAAI;cAWS,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAW1E;;;;;;;;;;;;;;OAcG;IACH,SAAS,CAAC,uBAAuB,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI;CA6BlE"}

package/dist/base-command.js

@@ -0,0 +1,131 @@
+import { Command, Flags } from '@oclif/core';
+import chalk from 'chalk';
+import { basename } from 'pathe';
+import { loadConfig as coreLoadConfig, ConfigParseError } from '@a1st/aix-core';
+import { Output } from './lib/output.js';
+export class BaseCommand extends Command {
+    static baseFlags = {
+        config: Flags.string({
+            char: 'c',
+            description: 'Path to ai.json config file',
+            env: 'AI_JSON_CONFIG',
+        }),
+        quiet: Flags.boolean({
+            char: 'q',
+            description: 'Suppress non-essential output',
+            default: false,
+        }),
+        json: Flags.boolean({
+            description: 'Output as JSON',
+            default: false,
+        }),
+    };
+    flags;
+    output;
+    loadedConfig;
+    async init() {
+        await super.init();
+        const { flags } = await this.parse({
+            flags: this.ctor.flags,
+            baseFlags: super.ctor.baseFlags,
+            args: this.ctor.args,
+            strict: this.ctor.strict,
+        });
+        this.flags = flags;
+        this.output = new Output({
+            quiet: this.flags.quiet,
+            json: this.flags.json,
+        });
+    }
+    async loadConfig() {
+        if (this.loadedConfig) {
+            return this.loadedConfig;
+        }
+        const result = await coreLoadConfig(this.flags.config);
+        if (result) {
+            this.loadedConfig = result;
+            // Log when local overrides are applied
+            if (result.hasLocalOverrides && result.localPath) {
+                this.output.info(`Using local overrides from ${result.localPath}`);
+            }
+        }
+        return this.loadedConfig;
+    }
+    async requireConfig() {
+        const config = await this.loadConfig();
+        if (!config) {
+            this.error('No ai.json found. Run `aix init` to create one.');
+        }
+        return config;
+    }
+    /** Log formatted install results */
+    logInstallResults(results) {
+        for (const r of results) {
+            if (r.success) {
+                this.output.info(r.message);
+            }
+            else {
+                this.output.warn(r.message);
+            }
+        }
+    }
+    /** Log delete operation results */
+    logDeleteResults(results) {
+        for (const result of results) {
+            if (result.deleted.length > 0) {
+                this.output.info(`Deleted ${result.deleted.length} file(s) from ${result.editor}`);
+            }
+            for (const err of result.errors) {
+                this.output.warn(`Failed to delete: ${err}`);
+            }
+        }
+    }
+    async catch(error) {
+        // Handle ConfigParseError with human-readable formatting (unless --json)
+        if (error instanceof ConfigParseError && error.issues && !this.flags?.json) {
+            this.displayConfigParseError(error);
+            this.exit(1);
+        }
+        // Let oclif handle other errors
+        return super.catch(error);
+    }
+    /**
+     * Display a ConfigParseError in human-readable format.
+     *
+     * Format:
+     * ```
+     * ✗ Configuration Error
+     *
+     *   File: ai.local.json
+     *
+     *   ● mcp.playwright
+     *     Expected object or false, received true
+     *
+     *   Found 2 validation errors.
+     * ```
+     */
+    displayConfigParseError(error) {
+        const fileName = basename(error.filePath), issues = error.issues ?? [];
+        console.error('');
+        console.error(chalk.red('✗') + ' Configuration ' + chalk.red('Error'));
+        console.error('');
+        console.error('  File: ' + chalk.cyan(fileName));
+        console.error('');
+        for (const issue of issues) {
+            console.error('  ' + chalk.yellow('●') + ' ' + chalk.yellow(issue.path));
+            console.error('    ' + issue.message);
+            console.error('');
+        }
+        if (issues.length > 1) {
+            console.error(chalk.dim(`  Found ${issues.length} validation errors.`));
+        }
+        else if (issues.length === 1) {
+            // Add a hint for single errors about object/false types
+            const firstIssue = issues[0];
+            if (firstIssue && firstIssue.message.includes('object or false')) {
+                console.error(chalk.dim('  Hint: Set to false to disable, or use { "command": "..." } to configure.'));
+            }
+        }
+    }
+}
+//# sourceMappingURL=base-command.js.map

package/dist/base-command.js.map

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

package/dist/commands/add/index.d.ts

@@ -0,0 +1,7 @@
+import { Command } from '@oclif/core';
+export default class AddIndex extends Command {
+    static description: string;
+    static hidden: boolean;
+    run(): Promise<void>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/add/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/add/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAQ,MAAM,aAAa,CAAC;AAE5C,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,OAAO;IAC1C,OAAgB,WAAW,SAAkD;IAE7E,OAAgB,MAAM,UAAQ;IAExB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAK5B"}

package/dist/commands/add/index.js

@@ -0,0 +1,10 @@
+import { Command, Help } from '@oclif/core';
+export default class AddIndex extends Command {
+    static description = 'Add skills, MCP servers, or rules to ai.json';
+    static hidden = true;
+    async run() {
+        const help = new Help(this.config);
+        await help.showHelp(['add']);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/add/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/add/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,OAAO;IAC1C,MAAM,CAAU,WAAW,GAAG,8CAA8C,CAAC;IAE7E,MAAM,CAAU,MAAM,GAAG,IAAI,CAAC;IAE9B,KAAK,CAAC,GAAG;QACN,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAEnC,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IAChC,CAAC"}

package/dist/commands/add/mcp.d.ts

@@ -0,0 +1,32 @@
+import { BaseCommand } from '../../base-command.js';
+export default class AddMcp extends BaseCommand<typeof AddMcp> {
+    static description: string;
+    static examples: string[];
+    static args: {
+        name: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        command: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        args: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        url: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        env: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'no-install': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        local: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+    /**
+     * Search the MCP Registry for a server by name.
+     * If multiple results are found, prompts the user to select one.
+     * Returns the server config and name, or undefined if cancelled/not found.
+     */
+    private searchRegistry;
+    /**
+     * Find the first npm package with stdio transport from the packages array.
+     */
+    private findNpmPackage;
+    /**
+     * Build an MCP server config from a registry package.
+     */
+    private buildConfigFromPackage;
+}
+//# sourceMappingURL=mcp.d.ts.map

package/dist/commands/add/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../../src/commands/add/mcp.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAOpD,MAAM,CAAC,OAAO,OAAO,MAAO,SAAQ,WAAW,CAAC,OAAO,MAAM,CAAC;IAC3D,OAAgB,WAAW,SAAkC;IAE7D,OAAgB,QAAQ,WAOtB;IAEF,OAAgB,IAAI;;MAKlB;IAEF,OAAgB,KAAK;;;;;;;MAkBnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAyF1B;;;;OAIG;YACW,cAAc;IAmE5B;;OAEG;IACH,OAAO,CAAC,cAAc;IAOtB;;OAEG;IACH,OAAO,CAAC,sBAAsB;CAwBhC"}

package/dist/commands/add/mcp.js

@@ -0,0 +1,209 @@
+import { Args, Flags } from '@oclif/core';
+import { select } from '@inquirer/prompts';
+import { BaseCommand } from '../../base-command.js';
+import { installAfterAdd, formatInstallResults } from '../../lib/install-helper.js';
+import { localFlag } from '../../flags/local.js';
+import { updateConfig, updateLocalConfig, getLocalConfigPath } from '@a1st/aix-core';
+import { McpRegistryClient } from '@a1st/mcp-registry-client';
+export default class AddMcp extends BaseCommand {
+    static description = 'Add an MCP server to ai.json';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> playwright',
+        '<%= config.bin %> <%= command.id %> filesystem',
+        '<%= config.bin %> <%= command.id %> github --command "npx @modelcontextprotocol/server-github"',
+        '<%= config.bin %> <%= command.id %> filesystem --command "npx @modelcontextprotocol/server-filesystem" --args "/path/to/dir"',
+        '<%= config.bin %> <%= command.id %> custom --url "http://localhost:3000/mcp"',
+        '<%= config.bin %> <%= command.id %> github --command "npx @modelcontextprotocol/server-github" --no-install',
+    ];
+    static args = {
+        name: Args.string({
+            description: 'MCP server name',
+            required: true,
+        }),
+    };
+    static flags = {
+        ...localFlag,
+        command: Flags.string({
+            description: 'Command to run (stdio transport)',
+        }),
+        args: Flags.string({
+            description: 'Command arguments (comma-separated)',
+        }),
+        url: Flags.string({
+            description: 'SSE endpoint URL',
+        }),
+        env: Flags.string({
+            description: 'Environment variables (KEY=value,KEY2=value2)',
+        }),
+        'no-install': Flags.boolean({
+            description: 'Skip installing to editors after adding',
+            default: false,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(AddMcp);
+        const loaded = await this.loadConfig();
+        let serverConfig;
+        let serverName = args.name;
+        if (flags.command) {
+            const config = { command: flags.command };
+            if (flags.args) {
+                config.args = flags.args.split(',').map((a) => a.trim());
+            }
+            if (flags.env) {
+                config.env = Object.fromEntries(flags.env.split(',').map((e) => {
+                    const idx = e.indexOf('=');
+                    if (idx === -1) {
+                        return [e.trim(), ''];
+                    }
+                    return [e.slice(0, idx).trim(), e.slice(idx + 1).trim()];
+                }));
+            }
+            serverConfig = config;
+        }
+        else if (flags.url) {
+            serverConfig = { url: flags.url };
+        }
+        else {
+            // No --command or --url provided: search the MCP Registry
+            const result = await this.searchRegistry(args.name);
+            if (!result) {
+                return;
+            }
+            serverConfig = result.config;
+            serverName = result.name;
+        }
+        // Determine target file based on --local flag
+        if (flags.local) {
+            const localPath = loaded ? getLocalConfigPath(loaded.path) : 'ai.local.json';
+            await updateLocalConfig(localPath, (config) => ({
+                ...config,
+                mcp: {
+                    ...config.mcp,
+                    [serverName]: serverConfig,
+                },
+            }));
+            this.output.success(`Added MCP server "${serverName}" to ai.local.json`);
+        }
+        else {
+            if (!loaded) {
+                this.error('No ai.json found. Run `aix init` to create one, or use --local to write to ai.local.json.');
+            }
+            await updateConfig(loaded.path, (config) => ({
+                ...config,
+                mcp: {
+                    ...config.mcp,
+                    [serverName]: serverConfig,
+                },
+            }));
+            this.output.success(`Added MCP server "${serverName}"`);
+            // Auto-install to configured editors unless --no-install
+            if (!flags['no-install']) {
+                const installResult = await installAfterAdd({
+                    configPath: loaded.path,
+                    scopes: ['mcp'],
+                });
+                if (installResult.installed) {
+                    this.logInstallResults(formatInstallResults(installResult.results));
+                }
+            }
+        }
+        if (this.flags.json) {
+            this.output.json({
+                action: 'add',
+                type: 'mcp',
+                name: serverName,
+                config: serverConfig,
+            });
+        }
+    }
+    /**
+     * Search the MCP Registry for a server by name.
+     * If multiple results are found, prompts the user to select one.
+     * Returns the server config and name, or undefined if cancelled/not found.
+     */
+    async searchRegistry(query) {
+        this.output.startSpinner(`Searching MCP Registry for "${query}"...`);
+        const client = new McpRegistryClient();
+        let results;
+        try {
+            const response = await client.search(query);
+            results = response.servers ?? [];
+        }
+        catch (error) {
+            this.output.stopSpinner(false, 'Failed to search MCP Registry');
+            const message = error instanceof Error ? error.message : String(error);
+            this.error(`Registry search failed: ${message}`);
+        }
+        if (results.length === 0) {
+            this.output.stopSpinner(false, 'No servers found');
+            this.error(`No MCP servers found matching "${query}".\n\n` +
+                'You can manually specify a server with:\n' +
+                `  aix add mcp ${query} --command "npx @some/mcp-server"\n` +
+                `  aix add mcp ${query} --url "http://localhost:3000/mcp"`);
+        }
+        this.output.stopSpinner(true, `Found ${results.length} server(s)`);
+        // Select server (prompt if multiple)
+        let selected;
+        if (results.length === 1) {
+            selected = results[0];
+            this.output.info(`Using: ${selected.server.name}`);
+        }
+        else {
+            selected = await select({
+                message: 'Multiple servers found. Which one do you want to add?',
+                choices: results.map((r) => ({
+                    name: `${r.server.name} - ${r.server.description}`,
+                    value: r,
+                })),
+            });
+        }
+        // Find an npm package with stdio transport
+        const pkg = this.findNpmPackage(selected.server.packages);
+        if (!pkg) {
+            this.error(`Server "${selected.server.name}" has no compatible npm package with stdio transport.\n\n` +
+                'You may need to configure it manually with --command or --url.');
+        }
+        // Build the config from the registry package info
+        const config = this.buildConfigFromPackage(pkg);
+        // Use a friendly name (last part of reverse-DNS name)
+        const nameParts = selected.server.name.split('/');
+        const friendlyName = nameParts[nameParts.length - 1] ?? selected.server.name;
+        return { config, name: friendlyName };
+    }
+    /**
+     * Find the first npm package with stdio transport from the packages array.
+     */
+    findNpmPackage(packages) {
+        if (!packages) {
+            return undefined;
+        }
+        return packages.find((p) => p.registryType === 'npm' && p.transport.type === 'stdio');
+    }
+    /**
+     * Build an MCP server config from a registry package.
+     */
+    buildConfigFromPackage(pkg) {
+        const config = {
+            command: `npx ${pkg.identifier}${pkg.version ? `@${pkg.version}` : ''}`,
+        };
+        // Add environment variables if specified
+        if (pkg.environmentVariables && pkg.environmentVariables.length > 0) {
+            const env = {};
+            for (const envVar of pkg.environmentVariables) {
+                // Use default value, or placeholder for required secrets
+                if (envVar.default) {
+                    env[envVar.name] = envVar.default;
+                }
+                else if (envVar.isRequired) {
+                    env[envVar.name] = envVar.isSecret ? '<YOUR_SECRET>' : '<REQUIRED>';
+                }
+            }
+            if (Object.keys(env).length > 0) {
+                config.env = env;
+            }
+        }
+        return config;
+    }
+}
+//# sourceMappingURL=mcp.js.map

package/dist/commands/add/mcp.js.map

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

package/dist/commands/add/prompt.d.ts

@@ -0,0 +1,18 @@
+import { BaseCommand } from '../../base-command.js';
+export default class AddPrompt extends BaseCommand<typeof AddPrompt> {
+    static description: string;
+    static examples: string[];
+    static args: {
+        source: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        name: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        description: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'argument-hint': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        ref: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'no-install': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        local: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=prompt.d.ts.map

package/dist/commands/add/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../src/commands/add/prompt.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAsHpD,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,WAAW,CAAC,OAAO,SAAS,CAAC;IACjE,OAAgB,WAAW,SAAqC;IAEhE,OAAgB,QAAQ,WAOtB;IAEF,OAAgB,IAAI;;MAKlB;IAEF,OAAgB,KAAK;;;;;;;MAsBnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAsF5B"}