@crewx/cli 0.8.0-rc.66 → 0.8.0-rc.82

package/dist/main.js

@@ -1,5 +1,14 @@
 #!/usr/bin/env node
 "use strict";
+/**
+ * CrewX CLI entry point.
+ * Dispatches commands to the appropriate handler.
+ *
+ * Boot sequence:
+ *   1. Inject CREWX_CLI / CREWX_WORKSPACE env defaults (must be first)
+ *   2. Parse command
+ *   3. Dispatch to handler
+ */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -34,278 +43,259 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-const core_1 = require("@nestjs/core");
-const app_module_1 = require("./app.module");
-const nestjs_mcp_adapter_1 = require("@sowonai/nestjs-mcp-adapter");
-const common_1 = require("@nestjs/common");
-const cli_options_1 = require("./cli-options");
-const stderr_logger_1 = require("./stderr.logger");
-const sdk_1 = require("@crewx/sdk");
-const cli_handler_1 = require("./cli/cli.handler");
-const slack_bot_1 = require("./slack/slack-bot");
-const crewx_tool_1 = require("./crewx.tool");
-const config_service_1 = require("./services/config.service");
-const ai_provider_service_1 = require("./ai-provider.service");
-const mcp_handler_1 = require("./cli/mcp.handler");
-const env_defaults_1 = require("@crewx/sdk/core/env-defaults");
-if (!process.env.CREWX_CLI) {
-    process.env.CREWX_CLI = (0, env_defaults_1.resolveCrewxCli)();
-}
-if (!process.env.CREWX_WORKSPACE) {
-    process.env.CREWX_WORKSPACE = process.cwd();
-}
-const logger = new common_1.Logger('Bootstrap');
-const args = (0, cli_options_1.parseCliOptions)();
-process.stdout.on('error', (err) => {
-    if (err.code === 'EPIPE') {
-        return;
+// ─── P0-1: Env Bootstrap ─────────────────────────────────────────────────────
+// Must run before any other code that might use process.env.CREWX_CLI.
+const env_defaults_1 = require("./utils/env-defaults");
+process.env.CREWX_CLI ??= (0, env_defaults_1.resolveCrewxCli)();
+process.env.CREWX_WORKSPACE ??= (0, env_defaults_1.resolveCrewxWorkspace)();
+// ─── Command Imports ──────────────────────────────────────────────────────────
+const query_1 = require("./commands/query");
+const execute_1 = require("./commands/execute");
+const agent_1 = require("./commands/agent");
+const ps_1 = require("./commands/ps");
+const kill_1 = require("./commands/kill");
+const result_1 = require("./commands/result");
+const log_1 = require("./commands/log");
+const doctor_1 = require("./commands/doctor");
+const init_1 = require("./commands/init");
+const builtin_1 = require("./builtin");
+const slack_1 = require("./commands/slack");
+const install_1 = require("./commands/hook/install");
+const uninstall_1 = require("./commands/hook/uninstall");
+const status_1 = require("./commands/hook/status");
+const hook_dispatch_1 = require("./commands/hook-dispatch");
+const version_1 = require("./utils/version");
+// Commands deferred to future rounds
+const NOT_YET_MIGRATED = new Set([
+    'template',
+    'templates',
+    'chat',
+    'mcp',
+]);
+async function main() {
+    const args = process.argv.slice(2);
+    const command = args[0];
+    if (!command) {
+        printHelp();
+        process.exit(0);
     }
-});
-process.stderr.on('error', (err) => {
-    if (err.code === 'EPIPE') {
+    // Built-in tools: memory, search, doc, wbs, cron, workflow
+    if (builtin_1.BUILTIN_COMMANDS.has(command)) {
+        await (0, builtin_1.handleBuiltin)(command, args.slice(1));
         return;
     }
-});
-if (process.argv.includes('--help') || process.argv.includes('-h')) {
-    const isSkillExecution = args.command === 'skill' &&
-        args.skillAction &&
-        !['list', 'ls', 'info'].includes(args.skillAction);
-    const isBuiltinCommand = ['memory', 'search', 'doc', 'wbs', 'cron', 'workflow'].includes(args.command);
-    if (!isSkillExecution && !isBuiltinCommand) {
-        args.command = 'help';
-    }
-}
-async function cli() {
-    try {
-        if (args.install) {
-            logger.log('Installation mode - CrewX MCP Server setup');
-            const app = await core_1.NestFactory.createApplicationContext(app_module_1.AppModule.forRoot(args), {
-                logger: args.log ? new stderr_logger_1.StderrLogger('CrewXInstall', { timestamp: true }) : false,
-            });
-            console.log(`
-=================================
-CrewX MCP Server Setup
-=================================
-
-This MCP server provides AI-powered code analysis tools using Claude CLI and Gemini CLI.
-
-Prerequisites:
-- Install Claude CLI: Follow the official installation guide for claude-cli
-- Install Gemini CLI: Follow the official installation guide for gemini-cli
-
-MCP Server Configuration:
-Add this to your MCP client configuration:
-
-{
-  "mcpServers": {
-    "${sdk_1.SERVER_NAME}": {
-      "command": "npx",
-      "args": ["@sowonlabs/crewx"]
-    }
-  }
-}
-
-Available Tools:
-- analyzeProject: AI-powered project analysis
-- reviewCode: Code review with AI
-- exploreCodebase: Codebase exploration and analysis  
-- checkAIProviders: Check AI CLI tool availability
-
-Environment Variables (optional):
-- Set working directory and other preferences as needed
-
-Setup completed successfully!
-=================================
-      `);
-            await app.close();
-            process.exit(0);
-        }
-    }
-    catch (error) {
-        logger.error(`Installation failed: ${(0, sdk_1.getErrorMessage)(error)}`, (0, sdk_1.getErrorStack)(error));
-        process.exit(1);
+    // P2: skill routing — pass through to @crewx/skill binary
+    if (command === 'skill') {
+        await runSkill(args.slice(1));
+        return;
     }
-}
-async function bootstrap() {
-    try {
-        let app;
-        let adapter;
-        if (args.protocol === 'HTTP') {
-            app = await core_1.NestFactory.create(app_module_1.AppModule.forRoot(args), {
-                logger: args.log ? ['error', 'warn', 'debug', 'log'] : false
-            });
-        }
-        else {
-            adapter = new nestjs_mcp_adapter_1.StdioExpressAdapter('/mcp');
-            app = await core_1.NestFactory.create(app_module_1.AppModule.forRoot(args), adapter, {
-                logger: args.log ? new stderr_logger_1.StderrLogger('CrewX', { timestamp: true }) : false,
-            });
-        }
-        await app.init();
-        const listenHost = args.host || '127.0.0.1';
-        if (args.protocol === 'HTTP') {
-            await app.listen(args.port, listenHost);
-            logger.log(`MCP HTTP server listening on http://${listenHost}:${args.port}`);
+    // Core commands
+    switch (command) {
+        // P0-2: q/x aliases
+        case 'q':
+        case 'query':
+            await (0, query_1.handleQuery)(args.slice(1));
+            return;
+        case 'x':
+        case 'execute':
+            await (0, execute_1.handleExecute)(args.slice(1));
+            return;
+        case 'agent':
+            await (0, agent_1.handleAgent)(args.slice(1));
+            return;
+        // P0-4: ps
+        case 'ps':
+            await (0, ps_1.handlePs)(args.slice(1));
+            return;
+        // P0-5: kill
+        case 'kill':
+            await (0, kill_1.handleKill)(args.slice(1));
+            return;
+        // P0-6: result
+        case 'result':
+            await (0, result_1.handleResult)(args.slice(1));
+            return;
+        // P1-1: log
+        case 'log':
+            await (0, log_1.handleLog)(args.slice(1));
+            return;
+        // P1-1: doctor
+        case 'doctor':
+            await (0, doctor_1.handleDoctor)(args.slice(1));
+            return;
+        // P1-1: init
+        case 'init': {
+            const initArgs = args.slice(1);
+            const force = initArgs.includes('--force') || initArgs.includes('-f');
+            try {
+                const r = await (0, init_1.handleInit)({ path: process.cwd(), force });
+                if (r.skippedReason === 'yaml-exists') {
+                    console.log('✓ crewx.yaml already exists (use --force to overwrite)');
+                }
+                else {
+                    console.log(r.yamlCreated ? '✓ crewx.yaml created' : '✓ yaml skipped');
+                    console.log(r.hookInstalled ? '✓ hook installed' : '⚠ hook skipped');
+                    if (r.errors.length > 0)
+                        console.warn('Warnings:', r.errors.join('; '));
+                }
+                console.log('✓ done');
+            }
+            catch (e) {
+                console.error('✗ init failed:', e.message);
+                process.exit(1);
+            }
+            return;
         }
-        else {
-            await app.listen(args.port);
+        // SDK-009: slack / slack:files
+        case 'slack':
+        case 'slack:files':
+            await (0, slack_1.handleSlack)(args.slice(1));
+            return;
+        // Hook Platform (Phase 0)
+        case 'hook-dispatch':
+            await (0, hook_dispatch_1.handleHookDispatch)(args.slice(1));
+            return;
+        case 'help':
+        case '--help':
+        case '-h':
+            printHelp();
+            return;
+        case '--version':
+        case '-v': {
+            // eslint-disable-next-line @typescript-eslint/no-require-imports
+            const pkg = require('../package.json');
+            console.log(pkg.version);
+            return;
         }
-        process.on('uncaughtException', (err) => {
-            logger.error('Unexpected error occurred:', err);
-        });
-        const cleanup = async () => {
-            await app.close();
-            if (adapter) {
-                await adapter.close();
-            }
-        };
-        process.on('SIGTERM', async () => {
-            logger.log('Shutting down application...');
-            await cleanup();
-            process.exit(0);
-        });
-        process.on('SIGINT', async () => {
-            logger.log('Shutting down application...');
-            await cleanup();
-            process.exit(0);
-        });
-        logger.log('Code CLI MCP Server initialized successfully');
-        return app;
     }
-    catch (error) {
-        logger.error(`Bootstrap failed: ${(0, sdk_1.getErrorMessage)(error)}`, (0, sdk_1.getErrorStack)(error));
+    // Not yet migrated commands (SDK-009)
+    if (NOT_YET_MIGRATED.has(command)) {
+        console.error(`Command '${command}' is not yet migrated in SDK refactor round. ` +
+            'See packages/cli-bak for reference.');
         process.exit(1);
     }
-}
-async function runCli() {
-    const command = args.command || 'help';
-    const effectiveArgs = args.command ? args : { ...args, command: 'help' };
-    const app = await core_1.NestFactory.createApplicationContext(app_module_1.AppModule.forRoot(args), {
-        logger: args.log ? new stderr_logger_1.StderrLogger('CrewXCLI', { timestamp: true }) : false,
-    });
-    if (args.config) {
-        const configService = app.get(config_service_1.ConfigService);
-        const aiProviderService = app.get(ai_provider_service_1.AIProviderService);
-        configService.setConfigPath(args.config);
-        configService.loadAgentConfigs();
-        await aiProviderService.reloadPluginProviders();
-    }
-    const cleanup = async () => {
-        await app.close();
-        process.exit(0);
-    };
-    process.on('SIGTERM', cleanup);
-    process.on('SIGINT', cleanup);
-    const cliHandler = new cli_handler_1.CLIHandler();
-    await cliHandler.handleCommand(app, effectiveArgs);
-}
-async function runSlackBot() {
-    try {
-        logger.log('Starting Slack Bot mode...');
-        process.stdout.on('error', (err) => {
-            if (err.code === 'EPIPE') {
-                logger.warn('EPIPE on stdout - ignoring (broken pipe)');
+    // Hook subcommands: crewx hook install/uninstall/status
+    if (command === 'hook') {
+        const subcommand = args[1];
+        const subArgs = args.slice(2);
+        switch (subcommand) {
+            case 'install':
+                await (0, install_1.handleHookInstall)(subArgs);
                 return;
-            }
-            logger.error('Unexpected stdout error:', err);
-        });
-        process.stderr.on('error', (err) => {
-            if (err.code === 'EPIPE') {
-                logger.warn('EPIPE on stderr - ignoring (broken pipe)');
+            case 'uninstall':
+                await (0, uninstall_1.handleHookUninstall)(subArgs);
                 return;
-            }
-            logger.error('Unexpected stderr error:', err);
-        });
-        process.on('uncaughtException', (err) => {
-            if (err.code === 'EPIPE') {
-                logger.warn('Uncaught EPIPE exception - ignoring');
+            case 'status':
+                await (0, status_1.handleHookStatus)(subArgs);
                 return;
-            }
-            logger.error('Uncaught exception:', err);
-            process.exit(1);
-        });
-        if (!process.env.SLACK_BOT_TOKEN) {
-            throw new Error('SLACK_BOT_TOKEN environment variable is required');
-        }
-        if (!process.env.SLACK_APP_TOKEN) {
-            throw new Error('SLACK_APP_TOKEN environment variable is required');
-        }
-        if (!process.env.SLACK_SIGNING_SECRET) {
-            throw new Error('SLACK_SIGNING_SECRET environment variable is required');
+            default:
+                console.error(`Unknown hook subcommand: ${subcommand ?? '(none)'}`);
+                console.error('Usage: crewx hook install|uninstall|status');
+                process.exit(1);
         }
-        const app = await core_1.NestFactory.createApplicationContext(app_module_1.AppModule.forRoot(args), {
-            logger: args.log ? new stderr_logger_1.StderrLogger('CrewXSlack', { timestamp: true }) : false,
-        });
-        const crewXTool = app.get(crewx_tool_1.CrewXTool);
-        const configService = app.get(config_service_1.ConfigService);
-        const aiProviderService = app.get(ai_provider_service_1.AIProviderService);
-        const defaultAgent = args.slackAgent || 'claude';
-        const mode = args.slackMode || 'query';
-        const mentionOnly = args.slackMentionOnly || false;
-        logger.log(`Using default agent for Slack: ${defaultAgent}`);
-        logger.log(`Slack bot mode: ${mode}`);
-        logger.log(`Mention-only mode: ${mentionOnly ? 'enabled' : 'disabled'}`);
-        const slackBot = new slack_bot_1.SlackBot(crewXTool, configService, aiProviderService, defaultAgent, mode, mentionOnly);
-        await slackBot.start();
-        const cleanup = async () => {
-            logger.log('Shutting down Slack Bot...');
-            await slackBot.stop();
-            await app.close();
-            process.exit(0);
-        };
-        process.on('SIGTERM', cleanup);
-        process.on('SIGINT', cleanup);
-    }
-    catch (error) {
-        logger.error(`Slack Bot failed: ${(0, sdk_1.getErrorMessage)(error)}`, (0, sdk_1.getErrorStack)(error));
-        process.exit(1);
     }
+    // Unknown command
+    console.error(`Unknown command: ${command}`);
+    console.error('Run `crewx --help` for usage.');
+    process.exit(1);
 }
-async function main() {
-    if (args.install) {
-        await cli();
-    }
-    else if (args.command === 'mcp') {
-        if (args.subcommand === 'call_tool') {
-            const exitCode = await (0, mcp_handler_1.handleMcpCallTool)(args);
-            process.exit(exitCode);
-        }
-        else if (args.subcommand === 'list_tools') {
-            const exitCode = await (0, mcp_handler_1.handleMcpListTools)(args);
-            process.exit(exitCode);
-        }
-        else {
-            if (args.protocol === 'HTTP' && !args.key) {
-                logger.error('MCP HTTP server requires --key or CREWX_MCP_KEY for authentication.');
-                process.exit(1);
+/**
+ * P2: Route `crewx skill ...` to the @crewx/skill CLI.
+ * Uses `node <skill-cli-path>` to avoid symlink exec permission issues.
+ * Falls back to spawning 'skill' on PATH if the local binary is not found.
+ */
+async function runSkill(skillArgs) {
+    const { spawn } = await Promise.resolve().then(() => __importStar(require('child_process')));
+    const { resolve } = await Promise.resolve().then(() => __importStar(require('path')));
+    const { existsSync } = await Promise.resolve().then(() => __importStar(require('fs')));
+    // Resolve the @crewx/skill CLI entry point directly (monorepo root)
+    const skillCliJs = resolve(__dirname, '../../../node_modules/@crewx/skill/dist/cli.js');
+    await new Promise((res, rej) => {
+        // Prefer: node <skill-cli.js> (avoids symlink exec issues on macOS)
+        const [cmd, args] = existsSync(skillCliJs)
+            ? ['node', [skillCliJs, ...skillArgs]]
+            : ['skill', skillArgs];
+        const proc = spawn(cmd, args, { stdio: 'inherit' });
+        proc.on('close', (code) => {
+            process.exitCode = code ?? 0;
+            res();
+        });
+        proc.on('error', (spawnErr) => {
+            if (cmd === 'node') {
+                // Fallback: try 'skill' on PATH
+                const fallback = spawn('skill', skillArgs, { stdio: 'inherit' });
+                fallback.on('close', (c) => { process.exitCode = c ?? 0; res(); });
+                fallback.on('error', rej);
             }
-            if (args.log)
-                logger.log('Starting MCP server mode...');
-            await bootstrap();
-        }
-    }
-    else if (args.command === 'slack') {
-        if (args.log)
-            logger.log('Starting Slack Bot mode...');
-        await runSlackBot();
-    }
-    else if (['memory', 'search', 'doc', 'wbs', 'cron', 'workflow'].includes(args.command)) {
-        const { handleBuiltin } = await Promise.resolve().then(() => __importStar(require('./cli/builtin.handler')));
-        await handleBuiltin(args.command, args.rawArgs.slice(1));
-    }
-    else if (!args.command) {
-        if (args.log)
-            logger.log('Starting CLI mode (help)...');
-        await runCli();
-    }
-    else {
-        if (args.log)
-            logger.log('Starting CLI mode...');
-        await runCli();
-    }
+            else {
+                rej(spawnErr);
+            }
+        });
+    });
+}
+function printHelp() {
+    console.log(`
+CrewX CLI v${version_1.CLI_VERSION}
+
+Usage:
+  crewx <command> [options]
+
+Query / Execute:
+  q|query [@agent] <message>     Query an agent (read-only)
+  x|execute [@agent] <task>      Execute a task with an agent (write-capable)
+
+  @agent is optional — defaults to @crewx when omitted.
+
+  Common flags:
+    --thread <name>              Conversation thread
+    --provider <cli/xxx>         Provider override
+    --metadata <json>            Extra metadata (JSON object, double-quoted). Propagated to events/hooks/tracing.
+                                 Invalid JSON aborts with exit code 2.
+                                 e.g. --metadata='{"workflow_id":"wf-1"}'
+    --verbose                    Debug output mode (default: raw response only)
+    --config/-c <path>           Config file path (default: CREWX_CONFIG or crewx.yaml)
+    --output-format <fmt>        Output format (json|text|stream-json)
+    --effort <level>             Model effort (high|medium|low)
+
+Agent Management:
+  agent ls [options]             List configured agents
+    --role <value>               Filter by role (comma-separated for OR match)
+    --team <value>               Filter by team (comma-separated for OR match)
+    --provider <value>           Filter by provider (comma-separated for OR match)
+  agent prompt <@id>             Show rendered system prompt for an agent
+
+Task Management:
+  ps                             List running tasks
+  kill <task-id>                 Kill a running task
+  kill --all                     Kill all running tasks
+  result [task-id]               Get task result (or list recent tasks)
+
+Logs & Diagnostics:
+  log [ls|<task-id>]             View task logs
+  doctor [--config <path>]       Run system diagnosis
+  init [--force] [--config <p>]  Initialize crewx.yaml
+
+Built-in Tools:
+  memory <args>                  Memory tool
+  search <args>                  Search tool
+  doc <args>                     Doc tool
+  wbs <args>                     WBS tool
+  cron <args>                    Cron tool
+  workflow <args>                Workflow tool
+  skill <args>                   Skill tool
+
+Hook Platform:
+  hook install [--yes]           Install PreToolUse hook in .claude/settings.json
+  hook uninstall                 Remove crewx hook from .claude/settings.json
+  hook status                    Show hook installation status and plugins
+  hook-dispatch                  Internal: IPC router called by Claude (stdin→stdout)
+
+Global Options:
+  --help, -h                     Show this help
+  --version, -v                  Show version
+`.trim());
 }
-main().catch(err => {
-    logger.error('Error during application startup:', err);
+main().catch((err) => {
+    console.error(err instanceof Error ? err.message : String(err));
     process.exit(1);
 });
-//# sourceMappingURL=main.js.map

package/dist/plugins/examples/echo-hook.d.ts

@@ -0,0 +1,24 @@
+/**
+ * EchoObserverPlugin — Tool observer that echoes events to a JSONL log.
+ *
+ * Observes tool:before / tool:after events from the Crewx event bus
+ * and appends them as JSONL to ~/.crewx/logs/echo-hook.log.
+ * Pure observer — no flow control (deny/inject/modify not applicable).
+ */
+import { ToolObserverPlugin } from '@crewx/sdk/hooks';
+import type { ObserverContext, ObserverResult } from '@crewx/sdk/hooks';
+export declare class EchoHookPlugin extends ToolObserverPlugin {
+    readonly name = "echo-hook";
+    readonly version = "0.0.1";
+    readonly on: {
+        beforeTool: true;
+        afterTool: true;
+        beforePrompt: true;
+        sessionStart: true;
+    };
+    private readonly logPath;
+    constructor(logDir?: string);
+    run(ctx: ObserverContext): Promise<ObserverResult>;
+    private ensureLogDir;
+    private echo;
+}

package/dist/plugins/examples/echo-hook.js

@@ -0,0 +1,60 @@
+"use strict";
+/**
+ * EchoObserverPlugin — Tool observer that echoes events to a JSONL log.
+ *
+ * Observes tool:before / tool:after events from the Crewx event bus
+ * and appends them as JSONL to ~/.crewx/logs/echo-hook.log.
+ * Pure observer — no flow control (deny/inject/modify not applicable).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EchoHookPlugin = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const os_1 = require("os");
+const hooks_1 = require("@crewx/sdk/hooks");
+class EchoHookPlugin extends hooks_1.ToolObserverPlugin {
+    name = 'echo-hook';
+    version = '0.0.1';
+    on = {
+        beforeTool: true,
+        afterTool: true,
+        beforePrompt: true,
+        sessionStart: true,
+    };
+    logPath;
+    constructor(logDir) {
+        super();
+        this.logPath = (0, path_1.join)(logDir ?? (0, os_1.homedir)(), '.crewx', 'logs', 'echo-hook.log');
+        this.ensureLogDir();
+    }
+    async run(ctx) {
+        this.echo(ctx);
+        return ctx.pass();
+    }
+    ensureLogDir() {
+        const dir = (0, path_1.dirname)(this.logPath);
+        if (!(0, fs_1.existsSync)(dir)) {
+            (0, fs_1.mkdirSync)(dir, { recursive: true, mode: 0o700 });
+        }
+    }
+    echo(ctx) {
+        try {
+            const line = JSON.stringify({
+                timestamp: new Date().toISOString(),
+                event: ctx.event,
+                traceId: ctx.traceId,
+                agent: ctx.agent,
+                provider: ctx.provider,
+                thread: ctx.thread,
+                tool: ctx.tool,
+                cwd: ctx.cwd,
+                sessionId: ctx.sessionId,
+            });
+            (0, fs_1.appendFileSync)(this.logPath, line + '\n', { encoding: 'utf8', mode: 0o600 });
+        }
+        catch {
+            // Non-fatal
+        }
+    }
+}
+exports.EchoHookPlugin = EchoHookPlugin;

package/dist/plugins/examples/verify-echo-hook.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env npx tsx
+/**
+ * Phase 0 e2e verification — EchoHookPlugin logs Claude Code tool calls.
+ *
+ * Run: npx tsx packages/cli/src/plugins/examples/verify-echo-hook.ts
+ * Prereq: claude CLI installed, crewx.yaml with @claude agent
+ */
+export {};