@syrin/cli 1.3.1 → 1.4.0

package/dist/cli/index.js

@@ -11,7 +11,9 @@ import { executeAnalyse } from '../cli/commands/analyse.js';
 import { executeDev } from '../cli/commands/dev.js';
 import { executeUpdate } from '../cli/commands/update.js';
 import { executeRollback } from '../cli/commands/rollback.js';
-import { logger, log } from '../utils/logger.js';
+import { executeStatus } from '../cli/commands/status.js';
+import { executeConfigSet, executeConfigGet, executeConfigList, executeConfigShow, executeConfigEdit, executeConfigEditEnv, executeConfigSetDefault, executeConfigRemove, } from '../cli/commands/config.js';
+import { log, setQuietMode, setVerboseMode } from '../utils/logger.js';
 import { Messages, ListTypes } from '../constants/index.js';
 import { getCurrentVersion } from '../utils/version-checker.js';
 /**
@@ -19,7 +21,6 @@ import { getCurrentVersion } from '../utils/version-checker.js';
  * Logs full error to internal logger and concise message to user.
  */
 function reportAnalyseError(error) {
-    logger.error('Analyse command failed', error);
     log.error(`Analyse command failed: ${error.message}`);
 }
 const program = new Command();
@@ -32,29 +33,46 @@ export function setupCLI() {
     program
         .name('syrin')
         .description('Syrin - Runtime intelligence system for MCP servers')
-        .version(currentVersion, '-v, --version', 'Display version number');
+        .version(currentVersion, '-v, --version', 'Display version number')
+        .option('-q, --quiet', 'Minimal output (errors only)')
+        .option('--verbose', 'Verbose output for debugging')
+        .hook('preAction', (_thisCommand, actionCommand) => {
+        const opts = actionCommand.optsWithGlobals();
+        if (opts.quiet) {
+            setQuietMode(true);
+        }
+        if (opts.verbose) {
+            setVerboseMode(true);
+        }
+    })
+        .addHelpText('after', '\nAliases:\n' +
+        '  ls        Alias for list\n' +
+        '  doc       Alias for doctor\n' +
+        '  cfg       Alias for config');
     // init command
     program
         .command('init')
         .description('Initialize a new Syrin project')
         .option('-y, --yes', 'Skip interactive prompts and use default values')
         .option('--project-root <path>', 'Project root directory (defaults to current directory)')
+        .option('--global', 'Create global configuration (LLM providers only)')
         .action(async (options) => {
         try {
             await executeInit({
                 yes: options.yes || false,
                 projectRoot: options.projectRoot,
+                global: options.global || false,
             });
         }
         catch (error) {
             // Handle ALREADY_INITIALIZED case first with early return
-            if (error instanceof Error && error.message === 'ALREADY_INITIALIZED') {
+            if (error instanceof Error &&
+                error.message === 'ALREADY_INITIALIZED') {
                 // Already handled in executeInit, just exit
                 return;
             }
             // Handle other Error cases
             if (error instanceof Error) {
-                logger.error('Init command failed', error);
                 log.blank();
                 log.error(`Error: ${error.message}`);
                 log.blank();
@@ -67,6 +85,7 @@ export function setupCLI() {
     // doctor command
     program
         .command('doctor')
+        .alias('doc')
         .description('Validate Syrin project configuration and setup')
         .option('--project-root <path>', 'Project root directory (defaults to current directory)')
         .action(async (options) => {
@@ -76,8 +95,9 @@ export function setupCLI() {
         catch (error) {
             // Error handling is done in executeDoctor, this is a safety net
             if (error instanceof Error) {
-                logger.error('Doctor command failed', error);
+                log.error(`Error: ${error.message}`);
             }
+            process.exit(1);
         }
     });
     // test command
@@ -171,13 +191,15 @@ export function setupCLI() {
         catch (error) {
             // Error handling is done in executeTest
             if (error instanceof Error) {
-                logger.error('Test command failed', error);
+                log.error(`Error: ${error.message}`);
+                process.exit(1);
             }
         }
     });
     // list command
     program
         .command('list')
+        .alias('ls')
         .description('List tools, resources, or prompts from an MCP server')
         .argument('[type]', `Type to list: ${ListTypes.TOOLS}, ${ListTypes.RESOURCES}, or ${ListTypes.PROMPTS} (default: ${ListTypes.TOOLS})`, ListTypes.TOOLS)
         .option('--transport <type>', 'Transport type (http or stdio). If not provided, uses transport from config.yaml')
@@ -216,7 +238,8 @@ export function setupCLI() {
         catch (error) {
             // Error handling is done in executeList
             if (error instanceof Error) {
-                logger.error('List command failed', error);
+                log.error(`Error: ${error.message}`);
+                process.exit(1);
             }
         }
     });
@@ -273,6 +296,9 @@ export function setupCLI() {
         .option('--save-events', 'Save events to file for debugging')
         .option('--event-file <path>', 'Directory path for event files (default: .syrin/events). Events are saved as {sessionId}.jsonl')
         .option('--run-script', 'Run script to spawn server internally. If not provided, stdio uses script automatically, http connects to existing server')
+        .option('--transport <type>', 'Transport type (stdio or http). Required when using global config.')
+        .option('--mcp-url <url>', 'MCP server URL (required for http transport when using global config)')
+        .option('--script <command>', 'Script command to run MCP server (required for stdio transport when using global config)')
         .action(async (options) => {
         try {
             await executeDev({
@@ -282,12 +308,16 @@ export function setupCLI() {
                 saveEvents: options.saveEvents || false,
                 eventFile: options.eventFile,
                 runScript: options.runScript || false,
+                transport: options.transport,
+                mcpUrl: options.mcpUrl,
+                script: options.script,
             });
         }
         catch (error) {
             // Error handling is done in executeDev
             if (error instanceof Error) {
-                logger.error('Dev command failed', error);
+                log.error(`Error: ${error.message}`);
+                process.exit(1);
             }
         }
     });
@@ -302,7 +332,8 @@ export function setupCLI() {
         catch (error) {
             // Error handling is done in executeUpdate
             if (error instanceof Error) {
-                logger.error('Update command failed', error);
+                log.error(`Error: ${error.message}`);
+                process.exit(1);
             }
         }
     });
@@ -318,10 +349,178 @@ export function setupCLI() {
         catch (error) {
             // Error handling is done in executeRollback
             if (error instanceof Error) {
-                logger.error('Rollback command failed', error);
+                log.error(`Error: ${error.message}`);
+                process.exit(1);
+            }
+        }
+    });
+    // status command
+    program
+        .command('status')
+        .description('Show project health overview (config, LLM, MCP connection)')
+        .option('--project-root <path>', 'Project root directory (defaults to current directory)')
+        .action(async (options) => {
+        try {
+            await executeStatus(options.projectRoot);
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                log.error(`Error: ${error.message}`);
+                process.exit(1);
+            }
+        }
+    });
+    // config command
+    const configCommand = program
+        .command('config')
+        .alias('cfg')
+        .description('Manage Syrin configuration (local or global)');
+    // config set
+    configCommand
+        .command('set')
+        .description('Set a configuration value')
+        .argument('<key>', 'Configuration key (e.g., "openai.model", "agent_name")')
+        .argument('<value>', 'Value to set')
+        .option('--global', 'Operate on global config')
+        .option('--local', 'Operate on local config')
+        .action(async (key, value, options) => {
+        try {
+            await executeConfigSet(key, value, options);
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                log.error(`Error: ${error.message}`);
+            }
+            process.exit(1);
+        }
+    });
+    // config get
+    configCommand
+        .command('get')
+        .description('Get a configuration value')
+        .argument('<key>', 'Configuration key')
+        .option('--global', 'Operate on global config')
+        .option('--local', 'Operate on local config')
+        .action(async (key, options) => {
+        try {
+            await executeConfigGet(key, options);
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                log.error(`Error: ${error.message}`);
+            }
+            process.exit(1);
+        }
+    });
+    // config list
+    configCommand
+        .command('list')
+        .description('List all configuration values')
+        .option('--global', 'Operate on global config')
+        .option('--local', 'Operate on local config')
+        .action(async (options) => {
+        try {
+            await executeConfigList(options);
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                log.error(`Error: ${error.message}`);
             }
+            process.exit(1);
         }
     });
+    // config show
+    configCommand
+        .command('show')
+        .description('Show full configuration')
+        .option('--global', 'Operate on global config')
+        .option('--local', 'Operate on local config')
+        .action(async (options) => {
+        try {
+            await executeConfigShow(options);
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                log.error(`Error: ${error.message}`);
+            }
+            process.exit(1);
+        }
+    });
+    // config edit
+    configCommand
+        .command('edit')
+        .description('Edit configuration file in editor')
+        .option('--global', 'Operate on global config')
+        .option('--local', 'Operate on local config')
+        .action(async (options) => {
+        try {
+            await executeConfigEdit(options);
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                log.error(`Error: ${error.message}`);
+            }
+            process.exit(1);
+        }
+    });
+    // config edit-env
+    configCommand
+        .command('edit-env')
+        .description('Edit environment file in editor')
+        .option('--global', 'Operate on global config')
+        .option('--local', 'Operate on local config')
+        .action(async (options) => {
+        try {
+            await executeConfigEditEnv(options);
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                log.error(`Error: ${error.message}`);
+            }
+            process.exit(1);
+        }
+    });
+    // config set-default
+    configCommand
+        .command('set-default')
+        .description('Set default LLM provider')
+        .argument('<provider>', 'LLM provider name (e.g., openai, claude)')
+        .option('--global', 'Operate on global config')
+        .option('--local', 'Operate on local config')
+        .action(async (provider, options) => {
+        try {
+            await executeConfigSetDefault(provider, options);
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                log.error(`Error: ${error.message}`);
+            }
+            process.exit(1);
+        }
+    });
+    // config remove
+    configCommand
+        .command('remove')
+        .description('Remove an LLM provider from configuration')
+        .argument('<provider>', 'LLM provider name to remove')
+        .option('--global', 'Operate on global config')
+        .option('--local', 'Operate on local config')
+        .action(async (provider, options) => {
+        try {
+            await executeConfigRemove(provider, options);
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                log.error(`Error: ${error.message}`);
+            }
+            process.exit(1);
+        }
+    });
+    // Handle no command provided - show help and exit with 0
+    if (process.argv.length <= 2) {
+        program.outputHelp();
+        process.exit(0);
+    }
     // Parse command line arguments
     program.parse();
 }
@@ -334,7 +533,7 @@ export function run() {
     }
     catch (error) {
         const err = error instanceof Error ? error : new Error(String(error));
-        logger.error('CLI setup failed', err);
+        log.error(`Error: ${err.message}`);
         log.error(Messages.CLI_START_FAILED);
         process.exit(1);
     }

package/dist/cli/prompts/init-prompt.d.ts

@@ -2,6 +2,7 @@
  * Interactive prompts for the `syrin init` command.
  */
 import type { InitOptions } from '../../config/types.js';
+import { makeAgentName } from '../../types/factories.js';
 /**
  * Prompt user for project initialization details.
  * @param defaults - Default values for non-interactive mode
@@ -14,4 +15,21 @@ export declare function promptInitOptions(defaults?: Partial<InitOptions>): Prom
  * @returns Default options
  */
 export declare function getDefaultInitOptions(projectRoot: string): InitOptions;
+/**
+ * Global init options (LLM providers only).
+ */
+export interface GlobalInitOptions {
+    agentName: ReturnType<typeof makeAgentName>;
+    llmProviders: InitOptions['llmProviders'];
+}
+/**
+ * Prompt user for global initialization details (LLM providers only).
+ * @returns User's answers for global config
+ */
+export declare function promptGlobalInitOptions(): Promise<GlobalInitOptions>;
+/**
+ * Create default global init options for non-interactive mode.
+ * @returns Default options for global config
+ */
+export declare function getDefaultGlobalInitOptions(): GlobalInitOptions;
 //# sourceMappingURL=init-prompt.d.ts.map

package/dist/cli/prompts/init-prompt.js

@@ -6,116 +6,33 @@ import * as path from 'path';
 import { makeProjectName, makeAgentName, makeMCPURL, makeAPIKey, makeModelName, makeScriptCommand, } from '../../types/factories.js';
 import { Messages, TransportTypes, LLMProviders, LLMProviderDisplayNames, Defaults, EnvVars, } from '../../constants/index.js';
 /**
- * Prompt user for project initialization details.
- * @param defaults - Default values for non-interactive mode
- * @returns User's answers
+ * Get LLM provider prompts (shared between init and global init).
+ * @param defaultProviders - Default providers to check (for non-interactive mode)
+ * @returns Array of inquirer questions for LLM provider configuration
  */
-export async function promptInitOptions(defaults) {
-    const currentDirName = path.basename(process.cwd());
-    const defaultProjectName = defaults?.projectName ||
-        currentDirName.replace(/[^a-z0-9-]/gi, '-').toLowerCase();
-    const answers = await inquirer.prompt([
-        {
-            type: 'input',
-            name: 'projectName',
-            message: 'Project name:',
-            default: defaultProjectName,
-            validate: (input) => {
-                if (!input.trim()) {
-                    return Messages.PROMPT_PROJECT_NAME_REQUIRED;
-                }
-                if (!/^[a-z0-9-]+$/i.test(input)) {
-                    return Messages.PROMPT_PROJECT_NAME_INVALID;
-                }
-                return true;
-            },
-        },
-        {
-            type: 'input',
-            name: 'agentName',
-            message: 'Agent name:',
-            default: defaults?.agentName
-                ? String(defaults.agentName)
-                : Defaults.AGENT_NAME,
-            validate: (input) => {
-                if (!input.trim()) {
-                    return Messages.PROMPT_AGENT_NAME_REQUIRED;
-                }
-                return true;
-            },
-        },
-        {
-            type: 'list',
-            name: 'transport',
-            message: 'Transport type:',
-            choices: [
-                {
-                    name: `${TransportTypes.STDIO} - Spawn MCP server as a subprocess`,
-                    value: TransportTypes.STDIO,
-                },
-                {
-                    name: `${TransportTypes.HTTP} - Connect to a running MCP server via HTTP`,
-                    value: TransportTypes.HTTP,
-                },
-            ],
-            default: defaults?.transport || Defaults.TRANSPORT,
-        },
-        {
-            type: 'input',
-            name: 'mcpUrl',
-            message: 'MCP server URL:',
-            default: defaults?.mcpUrl ? String(defaults.mcpUrl) : Defaults.MCP_URL,
-            when: (answers) => answers?.transport === TransportTypes.HTTP,
-            validate: (input, answers) => {
-                if (answers?.transport === TransportTypes.HTTP) {
-                    if (!input.trim()) {
-                        return Messages.PROMPT_MCP_URL_REQUIRED;
-                    }
-                    try {
-                        new URL(input);
-                        return true;
-                    }
-                    catch {
-                        return Messages.PROMPT_URL_INVALID;
-                    }
-                }
-                return true;
-            },
-        },
-        {
-            type: 'input',
-            name: 'script',
-            message: 'Script command to run MCP server:',
-            default: defaults?.script ? String(defaults.script) : 'python3 server.py',
-            validate: (input) => {
-                if (!input.trim()) {
-                    return Messages.PROMPT_SCRIPT_REQUIRED;
-                }
-                return true;
-            },
-        },
+function getLLMProviderPrompts(defaultProviders) {
+    return [
         {
             type: 'checkbox',
             name: 'llmProviders',
-            message: 'Select LLM providers to configure:',
+            message: 'Select LLM providers to configure (SPACE to toggle, ENTER to confirm):',
             choices: [
                 {
                     name: LLMProviderDisplayNames.OPENAI,
                     value: LLMProviders.OPENAI,
-                    checked: true,
+                    checked: defaultProviders?.includes(LLMProviders.OPENAI) ?? true,
                 },
                 {
                     name: LLMProviderDisplayNames.CLAUDE,
                     value: LLMProviders.CLAUDE,
+                    checked: defaultProviders?.includes(LLMProviders.CLAUDE) ?? false,
                 },
                 {
                     name: LLMProviderDisplayNames.OLLAMA,
                     value: LLMProviders.OLLAMA,
+                    checked: defaultProviders?.includes(LLMProviders.OLLAMA) ?? false,
                 },
             ],
-            default: defaults?.llmProviders
-                ? Object.keys(defaults.llmProviders)
-                : [LLMProviders.OPENAI],
             validate: (input) => {
                 if (input.length === 0) {
                     return Messages.PROMPT_LLM_PROVIDER_REQUIRED;
@@ -198,23 +115,29 @@ export async function promptInitOptions(defaults) {
             name: 'defaultProvider',
             message: 'Default LLM provider:',
             choices: (answers) => answers.llmProviders || [],
-            default: (answers) => answers.llmProviders?.[0] || 'openai',
+            default: (answers) => answers.llmProviders?.[0],
         },
-    ]);
-    // Build LLM providers config
+    ];
+}
+/**
+ * Build LLM providers config from answers (shared between init and global init).
+ * @param answers - User answers containing LLM provider selections
+ * @returns LLM providers configuration object
+ */
+function buildLLMProvidersConfig(answers) {
     const llmProviders = {};
     if (answers.llmProviders.includes('openai')) {
         llmProviders.openai = {
             apiKey: makeAPIKey(answers.openaiApiKey || ''),
             modelName: makeModelName(answers.openaiModel || ''),
-            default: answers.defaultProvider === 'openai' || false,
+            default: answers.defaultProvider === 'openai',
         };
     }
     if (answers.llmProviders.includes('claude')) {
         llmProviders.claude = {
             apiKey: makeAPIKey(answers.claudeApiKey || ''),
             modelName: makeModelName(answers.claudeModel || ''),
-            default: answers.defaultProvider === 'claude' || false,
+            default: answers.defaultProvider === 'claude',
         };
     }
     if (answers.llmProviders.includes('ollama')) {
@@ -222,16 +145,112 @@ export async function promptInitOptions(defaults) {
             modelName: answers.ollamaModelName
                 ? makeModelName(answers.ollamaModelName)
                 : undefined,
-            default: answers.defaultProvider === 'ollama' || false,
+            default: answers.defaultProvider === 'ollama',
         };
     }
+    return llmProviders;
+}
+/**
+ * Prompt user for project initialization details.
+ * @param defaults - Default values for non-interactive mode
+ * @returns User's answers
+ */
+export async function promptInitOptions(defaults) {
+    const currentDirName = path.basename(process.cwd());
+    const defaultProjectName = defaults?.projectName ||
+        currentDirName.replace(/[^a-z0-9-]/gi, '-').toLowerCase();
+    const projectPrompts = [
+        {
+            type: 'input',
+            name: 'projectName',
+            message: 'Project name:',
+            default: defaultProjectName,
+            validate: (input) => {
+                if (!input.trim()) {
+                    return Messages.PROMPT_PROJECT_NAME_REQUIRED;
+                }
+                if (!/^[a-z0-9-]+$/i.test(input)) {
+                    return Messages.PROMPT_PROJECT_NAME_INVALID;
+                }
+                return true;
+            },
+        },
+        {
+            type: 'input',
+            name: 'agentName',
+            message: 'Agent name:',
+            default: defaults?.agentName
+                ? String(defaults.agentName)
+                : Defaults.AGENT_NAME,
+            validate: (input) => {
+                if (!input.trim()) {
+                    return Messages.PROMPT_AGENT_NAME_REQUIRED;
+                }
+                return true;
+            },
+        },
+        {
+            type: 'list',
+            name: 'transport',
+            message: 'Transport type:',
+            choices: [
+                {
+                    name: `${TransportTypes.STDIO} - Spawn MCP server as a subprocess`,
+                    value: TransportTypes.STDIO,
+                },
+                {
+                    name: `${TransportTypes.HTTP} - Connect to a running MCP server via HTTP`,
+                    value: TransportTypes.HTTP,
+                },
+            ],
+            default: defaults?.transport || Defaults.TRANSPORT,
+        },
+        {
+            type: 'input',
+            name: 'mcpUrl',
+            message: 'MCP server URL:',
+            default: defaults?.mcpUrl ? String(defaults.mcpUrl) : Defaults.MCP_URL,
+            when: (answers) => answers?.transport === TransportTypes.HTTP,
+            validate: (input, answers) => {
+                if (answers?.transport === TransportTypes.HTTP) {
+                    if (!input.trim()) {
+                        return Messages.PROMPT_MCP_URL_REQUIRED;
+                    }
+                    try {
+                        new URL(input);
+                        return true;
+                    }
+                    catch {
+                        return Messages.PROMPT_URL_INVALID;
+                    }
+                }
+                return true;
+            },
+        },
+        {
+            type: 'input',
+            name: 'script',
+            message: 'Script command to run MCP server:',
+            default: defaults?.script ? String(defaults.script) : 'python3 server.py',
+            validate: (input) => {
+                if (!input.trim()) {
+                    return Messages.PROMPT_SCRIPT_REQUIRED;
+                }
+                return true;
+            },
+        },
+    ];
+    // Combine project prompts with LLM provider prompts
+    const llmPrompts = getLLMProviderPrompts(defaults?.llmProviders ? Object.keys(defaults.llmProviders) : undefined);
+    const allPrompts = [...projectPrompts, ...llmPrompts];
+    const answers = await inquirer.prompt(allPrompts);
     return {
         projectName: makeProjectName(answers.projectName),
         agentName: makeAgentName(answers.agentName),
         transport: answers.transport,
         mcpUrl: answers.mcpUrl ? makeMCPURL(answers.mcpUrl) : undefined,
         script: makeScriptCommand(answers.script),
-        llmProviders,
+        llmProviders: buildLLMProvidersConfig(answers),
         nonInteractive: false,
     };
 }
@@ -260,4 +279,45 @@ export function getDefaultInitOptions(projectRoot) {
         nonInteractive: true,
     };
 }
+/**
+ * Prompt user for global initialization details (LLM providers only).
+ * @returns User's answers for global config
+ */
+export async function promptGlobalInitOptions() {
+    const answers = await inquirer.prompt([
+        {
+            type: 'input',
+            name: 'agentName',
+            message: 'Agent name:',
+            default: Defaults.AGENT_NAME,
+            validate: (input) => {
+                if (!input.trim()) {
+                    return Messages.PROMPT_AGENT_NAME_REQUIRED;
+                }
+                return true;
+            },
+        },
+        ...getLLMProviderPrompts(),
+    ]);
+    return {
+        agentName: makeAgentName(answers.agentName),
+        llmProviders: buildLLMProvidersConfig(answers),
+    };
+}
+/**
+ * Create default global init options for non-interactive mode.
+ * @returns Default options for global config
+ */
+export function getDefaultGlobalInitOptions() {
+    return {
+        agentName: makeAgentName(Defaults.AGENT_NAME),
+        llmProviders: {
+            openai: {
+                apiKey: makeAPIKey(EnvVars.OPENAI_API_KEY),
+                modelName: makeModelName(EnvVars.OPENAI_MODEL_NAME),
+                default: true,
+            },
+        },
+    };
+}
 //# sourceMappingURL=init-prompt.js.map