@crewx/cli 0.9.0-rc.2 → 0.9.0-rc.200

package/dist/logging.js

@@ -1,86 +1,10 @@
-"use strict";
-/**
- * CLI file-based logging for CrewX SDK events.
- *
- * Subscribe to task:start / task:end events from a Crewx instance
- * and write structured log files to .crewx/logs/ in the workspace root.
- *
- * File name format: {YYYYMMDDTHHmmss}_{traceId}.log
- * e.g. 20260412T145044_tsk_AbCdEfGh.log
- *
- * Format mirrors cli-bak TaskManagementService for backward compatibility.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.attachFileLogger = attachFileLogger;
-const fs_1 = require("fs");
-const path_1 = require("path");
-const CREWX_VERSION = '0.9.0-alpha.1';
-/** Format Date as YYYYMMDDTHHmmss (local time) */
-function formatTimestamp(date) {
-    const pad = (n) => String(n).padStart(2, '0');
-    return (`${date.getFullYear()}` +
-        `${pad(date.getMonth() + 1)}` +
-        `${pad(date.getDate())}` +
-        `T${pad(date.getHours())}` +
-        `${pad(date.getMinutes())}` +
-        `${pad(date.getSeconds())}`);
-}
-function ensureLogsDir(logsDir) {
-    if (!(0, fs_1.existsSync)(logsDir)) {
-        (0, fs_1.mkdirSync)(logsDir, { recursive: true });
-    }
-}
-/**
- * Attach file-based logging to a Crewx instance.
- * Subscribes to task:start and task:end events and writes log files.
- *
- * @param crewx - The Crewx instance to attach logging to
- * @param workspaceRoot - Root directory for .crewx/logs/ (default: process.cwd())
- * @returns Cleanup function that removes all event listeners
- */
-function attachFileLogger(crewx, workspaceRoot) {
-    const logsDir = (0, path_1.join)(workspaceRoot ?? process.cwd(), '.crewx', 'logs');
-    // traceId → absolute log file path (in-memory map for the process lifetime)
-    const logFiles = new Map();
-    const unsubStart = crewx.on('task:start', (event) => {
-        try {
-            ensureLogsDir(logsDir);
-            const ts = formatTimestamp(event.timestamp);
-            const logFile = (0, path_1.join)(logsDir, `${ts}_${event.traceId}.log`);
-            logFiles.set(event.traceId, logFile);
-            const header = `=== TASK LOG: ${event.traceId} ===\n` +
-                `CrewX Version: ${CREWX_VERSION}\n` +
-                `Mode: ${event.mode}\n` +
-                `Agent: ${event.agentRef}\n` +
-                `Started: ${event.timestamp.toLocaleString()}\n` +
-                `Message: ${event.message}\n` +
-                `\n`;
-            (0, fs_1.writeFileSync)(logFile, header, { encoding: 'utf8', mode: 0o600 });
-        }
-        catch {
-            // Non-fatal: CLI logging must never crash the main process
-        }
-    });
-    const unsubEnd = crewx.on('task:end', (event) => {
-        try {
-            const logFile = logFiles.get(event.traceId);
-            if (!logFile)
-                return;
-            const ts = new Date().toLocaleString();
-            const status = event.error
-                ? `failed: ${event.error.message}`
-                : 'completed successfully';
-            const completion = `[${ts}] INFO: Task ${status} in ${event.durationMs}ms\n` +
-                `[${ts}] INFO: Process closed with exit code: ${event.error ? 1 : 0}\n`;
-            (0, fs_1.appendFileSync)(logFile, completion, 'utf8');
-            logFiles.delete(event.traceId);
-        }
-        catch {
-            // Non-fatal
-        }
-    });
-    return () => {
-        unsubStart();
-        unsubEnd();
-    };
-}
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.attachFileLogger=S;const c=require("fs");const u=require("path");const l=require("@crewx/sdk");const $="0.9.0-alpha.1";function p(e){const s=o=>String(o).padStart(2,"0");return`${e.getFullYear()}${s(e.getMonth()+1)}${s(e.getDate())}T${s(e.getHours())}${s(e.getMinutes())}${s(e.getSeconds())}`}function f(e){if(!(0,c.existsSync)(e)){(0,c.mkdirSync)(e,{recursive:true})}}function S(e,s){const o=(0,u.join)(s??process.cwd(),".crewx","logs");const a=new Map;const g=e.on("task:start",t=>{try{f(o);const n=p(t.timestamp);const r=(0,u.join)(o,`${n}_${t.traceId}.log`);a.set(t.traceId,r);const i=`=== TASK LOG: ${t.traceId} ===
+CrewX Version: ${$}
+Mode: ${t.mode}
+Agent: ${t.agentRef}
+Started: ${(0,l.formatDisplayTimestamp)(t.timestamp)}
+Message: ${t.message}
+
+`;(0,c.writeFileSync)(r,i,{encoding:"utf8",mode:384})}catch{}});const d=e.on("task:end",t=>{try{const n=a.get(t.traceId);if(!n)return;const r=(0,l.formatDisplayTimestamp)(new Date);const i=t.error?`failed: ${t.error.message}`:"completed successfully";const m=`[${r}] INFO: Task ${i} in ${t.durationMs}ms
+[${r}] INFO: Process closed with exit code: ${t.error?1:0}
+`;(0,c.appendFileSync)(n,m,"utf8");a.delete(t.traceId)}catch{}});return()=>{g();d()}}

package/dist/main.d.ts

@@ -5,7 +5,8 @@
  *
  * Boot sequence:
  *   1. Inject CREWX_CLI / CREWX_WORKSPACE env defaults (must be first)
- *   2. Parse command
- *   3. Dispatch to handler
+ *   2. Load workspace and ~/.crewx .env files (does not override process.env)
+ *   3. Parse command
+ *   4. Dispatch to handler
  */
 export {};

package/dist/main.js

@@ -1,236 +1,8 @@
 #!/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);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-// ─── 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 restart_1 = require("./commands/restart");
-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 db_1 = require("./commands/db");
-const parse_common_flags_1 = require("./commands/parse-common-flags");
-const registry_1 = require("./commands/registry");
-const version_1 = require("./utils/version");
-/**
- * Dev-only SSOT assertion: bin/cli-commands.js must be the exact union of
- * KNOWN_COMMANDS ∪ BUILTIN_COMMAND_NAMES ∪ NOT_YET_MIGRATED from registry.ts.
- * Throws on drift so the discrepancy is caught immediately during development.
- */
-async function assertSsotParity() {
-    const { join } = await Promise.resolve().then(() => __importStar(require('path')));
-    // eslint-disable-next-line @typescript-eslint/no-require-imports
-    const { createRequire } = require('module');
-    // Use createRequire(__filename) + plain path to avoid TypeScript compiling import() → require()
-    // in the CJS dist. Node.js 22.12+ supports require(esm), so this loads ESM cli-commands.js fine.
-    const req = createRequire(__filename);
-    const cliCommandsPath = join(__dirname, '../../../bin/cli-commands.js');
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const { CLI_SUBCOMMANDS } = req(cliCommandsPath);
-    const union = new Set([...registry_1.KNOWN_COMMANDS, ...registry_1.BUILTIN_COMMAND_NAMES, ...registry_1.NOT_YET_MIGRATED]);
-    const missing = [...union].filter((c) => !CLI_SUBCOMMANDS.has(c));
-    const extra = [...CLI_SUBCOMMANDS].filter((c) => !union.has(c));
-    if (missing.length > 0 || extra.length > 0) {
-        throw new Error(`[crewx dev] SSOT drift detected!\n` +
-            (missing.length ? `  registry has, CLI_SUBCOMMANDS missing: ${missing.join(', ')}\n` : '') +
-            (extra.length ? `  CLI_SUBCOMMANDS has, registry missing: ${extra.join(', ')}` : ''));
-    }
-}
-async function main() {
-    if (process.env['NODE_ENV'] === 'development') {
-        await assertSsotParity();
-    }
-    const args = process.argv.slice(2);
-    const command = args[0];
-    if (!command) {
-        printHelp();
-        process.exit(0);
-    }
-    // Built-in tools: memory, search, doc, wbs, cron, workflow, skill
-    if (builtin_1.BUILTIN_COMMANDS.has(command)) {
-        await (0, builtin_1.handleBuiltin)(command, args.slice(1));
-        return;
-    }
-    // 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;
-        // CLI Task Lifecycle 2단계: restart a failed task as a new task
-        case 'restart':
-            await (0, restart_1.handleRestart)(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('; '));
-                }
-                if (r.workspaceId)
-                    console.log(`✓ workspace registered (id=${r.workspaceId}, slug=${r.slug})`);
-                console.log('✓ done');
-            }
-            catch (e) {
-                console.error('✗ init failed:', e.message);
-                process.exit(1);
-            }
-            return;
-        }
-        // DB management: crewx db push [--force] [--dry-run]
-        case 'db':
-            await (0, db_1.handleDb)(args.slice(1));
-            return;
-        // 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;
-        }
-    }
-    // Not yet migrated commands (SDK-009)
-    if (registry_1.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);
-    }
-    // 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;
-            case 'uninstall':
-                await (0, uninstall_1.handleHookUninstall)(subArgs);
-                return;
-            case 'status':
-                await (0, status_1.handleHookStatus)(subArgs);
-                return;
-            default:
-                console.error(`Unknown hook subcommand: ${subcommand ?? '(none)'}`);
-                console.error('Usage: crewx hook install|uninstall|status');
-                process.exit(1);
-        }
-    }
-    // Unknown command
-    console.error(`Unknown command: ${command}`);
-    console.error('Run `crewx --help` for usage.');
-    process.exit(1);
-}
-function printHelp() {
-    console.log(`
-CrewX CLI v${version_1.CLI_VERSION}
+"use strict";var v=exports&&exports.__createBinding||(Object.create?(function(s,e,t,r){if(r===void 0)r=t;var o=Object.getOwnPropertyDescriptor(e,t);if(!o||("get"in o?!e.__esModule:o.writable||o.configurable)){o={enumerable:true,get:function(){return e[t]}}}Object.defineProperty(s,r,o)}):(function(s,e,t,r){if(r===void 0)r=t;s[r]=e[t]}));var k=exports&&exports.__setModuleDefault||(Object.create?(function(s,e){Object.defineProperty(s,"default",{enumerable:true,value:e})}):function(s,e){s["default"]=e});var _=exports&&exports.__importStar||(function(){var s=function(e){s=Object.getOwnPropertyNames||function(t){var r=[];for(var o in t)if(Object.prototype.hasOwnProperty.call(t,o))r[r.length]=o;return r};return s(e)};return function(e){if(e&&e.__esModule)return e;var t={};if(e!=null){for(var r=s(e),o=0;o<r.length;o++)if(r[o]!=="default")v(t,e,r[o])}k(t,e);return t}})();Object.defineProperty(exports,"__esModule",{value:true});const d=require("./utils/sdk-compat");const y=require("@crewx/sdk/account");const b=require("@crewx/sdk");const x=require("./utils/inherited-trace");const l=require("./commands/ai-account");const q=(0,l.isAiAccountCapabilitiesRequest)(process.argv.slice(2));if(!q){process.env.CREWX_CLI??=d.sdkCompat.resolveCrewxCli();process.env.CREWX_WORKSPACE??=d.sdkCompat.resolveCrewxWorkspace();(0,y.loadCrewxEnvFiles)();(0,x.consumeInheritedRunnerIdentity)();d.sdkCompat.initPricingRemote()}const C=require("./commands/query");const S=require("./commands/execute");const O=require("./commands/agent");const P=require("./commands/ps");const h=require("./commands/stop");const I=require("./commands/result");const A=require("./commands/restart");const D=require("./commands/log");const R=require("./commands/doctor");const p=require("./commands/init");const E=require("./commands/shortcut");const M=require("./commands/publish");const g=require("./builtin");const j=require("./commands/slack");const N=require("./commands/hook/install");const U=require("./commands/hook/uninstall");const L=require("./commands/hook/status");const T=require("./commands/hook-dispatch");const B=require("./commands/db");const W=require("./commands/history");const $=require("./commands/command-help");const F=require("./commands/parse-common-flags");const u=require("./commands/registry");const H=require("./utils/version");const K=require("./utils/product-package-root");const f=require("./commands/emit-trailer");async function G(){const{join:s}=await Promise.resolve().then(()=>_(require("path")));const{createRequire:e}=require("module");const t=e(__filename);const r=s(__dirname,"../../../bin/cli-commands.js");const{CLI_SUBCOMMANDS:o}=t(r);const n=new Set([...u.KNOWN_COMMANDS,...u.BUILTIN_COMMAND_NAMES,...u.NOT_YET_MIGRATED]);const i=[...n].filter(c=>!o.has(c));const a=[...o].filter(c=>!n.has(c));if(i.length>0||a.length>0){throw new Error(`[crewx dev] SSOT drift detected!
+`+(i.length?`  registry has, CLI_SUBCOMMANDS missing: ${i.join(", ")}
+`:"")+(a.length?`  CLI_SUBCOMMANDS has, registry missing: ${a.join(", ")}`:""))}}async function V(s){const e=process.argv.slice(2);if((0,l.isAiAccountCapabilitiesRequest)(e)){await(0,l.handleAiAccount)(e.slice(1));return}if(process.env["NODE_ENV"]==="development"){await G()}const t=e[0];if(!t){m();process.exit(0)}if(g.BUILTIN_COMMANDS.has(t)){const o=t==="skill"?(0,K.resolveProductRootFromCliEntry)(process.argv[1]):void 0;await(0,g.handleBuiltin)(t,e.slice(1),o);return}const r=(0,$.helpUsageFor)(t,e.slice(1));if(r!==void 0){console.log(r);return}switch(t){case"history":await(0,W.handleHistory)(e.slice(1));return;case"q":case"query":await(0,C.handleQuery)(e.slice(1),t,s);return;case"x":case"execute":await(0,S.handleExecute)(e.slice(1),t,s);return;case"agent":await(0,O.handleAgent)(e.slice(1));return;case"ps":await(0,P.handlePs)(e.slice(1));return;case"stop":await(0,h.handleStop)(e.slice(1),"stop");return;case"kill":await(0,h.handleStop)(e.slice(1),"kill");return;case"result":await(0,I.handleResult)(e.slice(1));return;case"restart":await(0,A.handleRestart)(e.slice(1));return;case"log":await(0,D.handleLog)(e.slice(1));return;case"doctor":await(0,R.handleDoctor)(e.slice(1));return;case"init":{const o=e.slice(1);const n=o.includes("--force")||o.includes("-f");try{const i=(0,p.parseInitProvider)(o);const a=await(0,p.handleInit)({path:process.cwd(),force:n,provider:i});if(a.skippedReason==="yaml-exists"){console.log("\u2713 crewx.yaml already exists (use --force to overwrite)")}else{console.log(a.yamlCreated?"\u2713 crewx.yaml created":"\u2713 yaml skipped");console.log(a.hookInstalled?"\u2713 hook installed":"\u26A0 hook skipped");if(a.errors.length>0)console.warn("Warnings:",a.errors.join("; "))}const c=(0,b.getDefaultAgentProfile)(a.provider);if(c){console.log(`\u2713 default agents: ${a.provider} (${c.planner.model} / ${c.worker.model})`)}if(a.workspaceId)console.log(`\u2713 workspace registered (id=${a.workspaceId}, slug=${a.slug})`);console.log("\u2713 done")}catch(i){console.error("\u2717 init failed:",i.message);process.exit(1)}return}case"db":await(0,B.handleDb)(e.slice(1));return;case"shortcut":await(0,E.handleShortcut)(e.slice(1));return;case"ai-account":await(0,l.handleAiAccount)(e.slice(1));return;case"publish":await(0,M.handlePublish)(e.slice(1));return;case"slack":case"slack:files":await(0,j.handleSlack)(e.slice(1));return;case"hook-dispatch":await(0,T.handleHookDispatch)(e.slice(1));return;case"help":case"--help":case"-h":m();return;case"--version":case"-v":{const o=require("../package.json");console.log(o.version);return}}if(u.NOT_YET_MIGRATED.has(t)){console.error(`Command '${t}' is not yet migrated in SDK refactor round. See packages/cli-bak for reference.`);process.exit(1)}if(t==="hook"){const o=e[1];const n=e.slice(2);switch(o){case"install":await(0,N.handleHookInstall)(n);return;case"uninstall":await(0,U.handleHookUninstall)(n);return;case"status":await(0,L.handleHookStatus)(n);return;default:console.error(`Unknown hook subcommand: ${o??"(none)"}`);console.error("Usage: crewx hook install|uninstall|status");process.exit(1)}}console.error(`Unknown command: ${t}`);console.error("Run `crewx --help` for usage.");process.exit(1)}function m(){console.log(`
+CrewX CLI v${H.CLI_VERSION}
 
 Usage:
   crewx                          Launch web dashboard + open browser (default)
@@ -242,12 +14,14 @@ UI Modes:
   crewx electron [--overlay]     Launch Electron (desktop or overlay window)
 
 Query / Execute:
-  q|query "@agent <message>"     Query an agent (quoted single string)
-  x|execute "@agent <task>"      Execute a task with an agent (quoted single string)
+  q|query --to <agent> <message> Query an agent
+  x|execute --to <agent> <task>  Execute a task with an agent
 
-  @agent is optional — defaults to @crewx when omitted.
+  Positional @agent <message> is shorthand for selecting a recipient.
+  Agent calls require a recipient; human terminal and cron calls default to @crewx.
 
   Common flags:
+    --to <agent>                 Explicit agent recipient
     --thread <name>              Conversation thread
     --provider <cli/xxx>         Provider override
     --metadata <json>            Extra metadata (JSON object, double-quoted). Propagated to events/hooks/tracing.
@@ -256,11 +30,18 @@ Query / Execute:
     --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)
+    --out/-o <path>              Save result to file (stdout suppressed)
     --effort <level>             Model effort (high|medium|low)
-    -f/--prompt-file <path>      Read task body from file (bypasses argv length limits)
+    -f/--prompt-file <path>      Read body only from file; set recipient with --to (bypasses argv length limits)
     --var key=value              Template variable (repeatable). Accessible as {{key}} in agent prompt.
     --                           End of flags; remaining tokens treated as message text
-                                 e.g. crewx q "@agent label" -- --flag-in-message
+                                 e.g. crewx q --to agent "label" -- --flag-in-message
+
+  q/query/x/execute:
+    --detach/--async              Persist a receipt, launch a detached runner, and print task-id
+                                 (automatic inside an agent process; q/x stay synchronous elsewhere).
+    --wait                        Force synchronous execution, including inside an agent process.
+                                 e.g. crewx x --to agent "label" --detach
 
 Agent Management:
   agent ls [options]             List configured agents
@@ -269,22 +50,51 @@ Agent Management:
     --provider <value>           Filter by provider (comma-separated for OR match)
   agent prompt <@id>             Show rendered system prompt for an agent
 
+Provider Accounts:
+  ai-account list|add|login|status|use|remove [options]
+                                 Manage Claude, Codex, and isolated Antigravity accounts
+  ai-account capabilities --json  Print the SDK capability contract without bootstrap
+  ai-account runtime status|install [--json]
+                                 Inspect or explicitly install the Antigravity runtime
+
 Task Management:
   ps                             List running tasks
-  kill <task-id>                 Kill a running task
-  kill --all                     Kill all running tasks
+  stop <task-id>                 Stop a running task (cooperative, then forced)
+  stop --all                     Stop all running tasks
+  kill <task-id>                 Alias for stop
   result [task-id]               Get task result (or list recent tasks)
+    --wait=N                     Poll (1s interval) up to N seconds for the task to
+                                 finish. Exit 124 on timeout. --wait=0 = single check.
   restart <task-id>              Restart a failed task as a new task
 
 Logs & Diagnostics:
   log [ls|<task-id>]             View task logs
   doctor [--config <path>]       Run system diagnosis
-  init [--force] [--config <p>]  Initialize crewx.yaml
+  init [--force] [--provider cli/claude|cli/codex]  Initialize crewx.yaml
 
 Database:
   db push                        Sync DB schema to current code (additive only)
     --force                      Reset migration history + skip confirmation
     --dry-run                    Preview changes without applying
+  db migrate-task-logs           Backfill legacy tasks.logs into task_log_events
+    --dry-run                    Validate and estimate without writing
+    --apply                      Consistent backup + resumable task-by-task apply
+    --verify                     Check event/source invariants and parity
+  db migrate-request-logs        Move request logs from crewx.db into logs.db (bodies stored once)
+    --batch N                    Rows per batch (default 250)
+    --dry-run                    Count rows and distinct bodies without writing
+
+Desktop Shortcut (Windows only):
+  shortcut status [--json]                Show current shortcut status
+  shortcut install [--force] [--json]     Install/repair the Desktop shortcut
+  shortcut uninstall [--json]             Remove the Desktop shortcut
+
+Publish:
+  publish [dir] [options]         Package a workspace as a distributable template archive
+    --dry-run                     Scan + build manifest only; do not write a .tgz
+    --version <ver>               Override manifest version (semver)
+    --json                        Print machine-readable JSON to stdout
+    --upload                      Submit + upload using the SDK account session
 
 Built-in Tools:
   memory <args>                  Memory tool
@@ -299,14 +109,9 @@ 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)
+  hook-dispatch                  Internal: IPC router called by Claude (stdin\u2192stdout)
 
 Global Options:
   --help, -h                     Show this help
   --version, -v                  Show version
-`.trim());
-}
-main().catch((err) => {
-    console.error(err instanceof Error ? err.message : String(err));
-    process.exit(err instanceof parse_common_flags_1.UnknownOptionError ? 2 : 1);
-});
+`.trim())}function X(s){if(s instanceof F.UnknownOptionError)return 2;if(typeof s==="object"&&s!==null&&"exitCode"in s){const e=s.exitCode;if(typeof e==="number")return e}return 1}const w=(0,f.createDelegationEmitState)();V(w).catch(s=>{console.error(s instanceof Error?s.message:String(s));(0,f.emitDelegationResult)({command:process.argv[2],isError:true,state:w});process.exit(X(s))});

package/dist/register-builtin-tools.js

@@ -1,9 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.registerBuiltinToolsIfNeeded = void 0;
-/**
- * Register built-in Node.js tools for api/* provider agents.
- * Delegates to @crewx/sdk/tools/node.
- */
-var node_1 = require("@crewx/sdk/tools/node");
-Object.defineProperty(exports, "registerBuiltinToolsIfNeeded", { enumerable: true, get: function () { return node_1.registerBuiltinTools; } });
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.registerBuiltinToolsIfNeeded=void 0;var e=require("@crewx/sdk/tools/node");Object.defineProperty(exports,"registerBuiltinToolsIfNeeded",{enumerable:true,get:function(){return e.registerBuiltinTools}});

package/dist/slack/file-download.js

@@ -1,134 +1 @@
-"use strict";
-/**
- * Lightweight Slack file downloader for CLI bot mode.
- * Ported from cli-bak SlackFileDownloadService, stripped of NestJS deps.
- * Uses Node.js built-in https for API calls.
- */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.downloadInboundFiles = downloadInboundFiles;
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
-const https = __importStar(require("https"));
-const MAX_FILE_SIZE = 50 * 1024 * 1024;
-async function downloadInboundFiles(botToken, files, threadId) {
-    if (!files || files.length === 0)
-        return [];
-    const results = [];
-    const downloadDir = path.join(process.cwd(), '.crewx', 'slack-files');
-    const safeThreadDir = threadId.replace(/:/g, '_');
-    for (const file of files) {
-        if (!file.url_private)
-            continue;
-        const sanitizedName = sanitizeFileName(file.name || 'unnamed_file');
-        const saveDir = path.join(downloadDir, safeThreadDir);
-        const savePath = path.join(saveDir, sanitizedName);
-        try {
-            if (fs.existsSync(savePath)) {
-                const stats = fs.statSync(savePath);
-                results.push({
-                    fileId: '',
-                    fileName: sanitizedName,
-                    filePath: savePath,
-                    fileSize: stats.size,
-                    threadId,
-                });
-                continue;
-            }
-            await fs.promises.mkdir(saveDir, { recursive: true });
-            const buffer = await fetchUrl(botToken, file.url_private);
-            if (buffer.length > MAX_FILE_SIZE) {
-                console.error(`File too large: ${sanitizedName} (${formatSize(buffer.length)})`);
-                continue;
-            }
-            await fs.promises.writeFile(savePath, new Uint8Array(buffer));
-            results.push({
-                fileId: '',
-                fileName: sanitizedName,
-                filePath: savePath,
-                fileSize: buffer.length,
-                threadId,
-            });
-        }
-        catch (err) {
-            console.error(`Failed to download file ${sanitizedName}: ${err instanceof Error ? err.message : String(err)}`);
-        }
-    }
-    return results;
-}
-function fetchUrl(token, url) {
-    const parsed = new URL(url);
-    return new Promise((resolve, reject) => {
-        const options = {
-            hostname: parsed.hostname,
-            path: parsed.pathname + parsed.search,
-            method: 'GET',
-            headers: { Authorization: `Bearer ${token}` },
-        };
-        const req = https.request(options, (res) => {
-            if (res.statusCode === 301 || res.statusCode === 302) {
-                const location = res.headers.location;
-                if (location) {
-                    fetchUrl(token, location).then(resolve).catch(reject);
-                    return;
-                }
-            }
-            if (res.statusCode !== 200) {
-                reject(new Error(`HTTP ${res.statusCode}`));
-                return;
-            }
-            const chunks = [];
-            res.on('data', (chunk) => chunks.push(chunk));
-            res.on('end', () => resolve(Buffer.concat(chunks)));
-            res.on('error', reject);
-        });
-        req.on('error', reject);
-        req.setTimeout(30000, () => { req.destroy(); reject(new Error('Timeout')); });
-        req.end();
-    });
-}
-function sanitizeFileName(name) {
-    let safe = name.replace(/[/\\]/g, '_').replace(/\.\./g, '_');
-    safe = safe.replace(/[\x00-\x1f\x80-\x9f<>:"|?*]/g, '_');
-    safe = safe.replace(/^\.+|\.+$/g, '').trim();
-    return safe || 'unnamed_file';
-}
-function formatSize(bytes) {
-    if (bytes < 1024)
-        return `${bytes}B`;
-    if (bytes < 1024 * 1024)
-        return `${(bytes / 1024).toFixed(1)}KB`;
-    return `${(bytes / (1024 * 1024)).toFixed(1)}MB`;
-}
+"use strict";var g=exports&&exports.__createBinding||(Object.create?(function(t,e,i,n){if(n===void 0)n=i;var r=Object.getOwnPropertyDescriptor(e,i);if(!r||("get"in r?!e.__esModule:r.writable||r.configurable)){r={enumerable:true,get:function(){return e[i]}}}Object.defineProperty(t,n,r)}):(function(t,e,i,n){if(n===void 0)n=i;t[n]=e[i]}));var w=exports&&exports.__setModuleDefault||(Object.create?(function(t,e){Object.defineProperty(t,"default",{enumerable:true,value:e})}):function(t,e){t["default"]=e});var d=exports&&exports.__importStar||(function(){var t=function(e){t=Object.getOwnPropertyNames||function(i){var n=[];for(var r in i)if(Object.prototype.hasOwnProperty.call(i,r))n[n.length]=r;return n};return t(e)};return function(e){if(e&&e.__esModule)return e;var i={};if(e!=null){for(var n=t(e),r=0;r<n.length;r++)if(n[r]!=="default")g(i,e,n[r])}w(i,e);return i}})();Object.defineProperty(exports,"__esModule",{value:true});exports.downloadInboundFiles=b;const f=d(require("fs"));const h=d(require("path"));const m=d(require("https"));const v=50*1024*1024;async function b(t,e,i){if(!e||e.length===0)return[];const n=[];const r=h.join(process.cwd(),".crewx","slack-files");const l=i.replace(/:/g,"_");for(const u of e){if(!u.url_private)continue;const o=O(u.name||"unnamed_file");const s=h.join(r,l);const a=h.join(s,o);try{if(f.existsSync(a)){const p=f.statSync(a);n.push({fileId:"",fileName:o,filePath:a,fileSize:p.size,threadId:i});continue}await f.promises.mkdir(s,{recursive:true});const c=await _(t,u.url_private);if(c.length>v){console.error(`File too large: ${o} (${P(c.length)})`);continue}await f.promises.writeFile(a,new Uint8Array(c));n.push({fileId:"",fileName:o,filePath:a,fileSize:c.length,threadId:i})}catch(c){console.error(`Failed to download file ${o}: ${c instanceof Error?c.message:String(c)}`)}}return n}function _(t,e){const i=new URL(e);return new Promise((n,r)=>{const l={hostname:i.hostname,path:i.pathname+i.search,method:"GET",headers:{Authorization:`Bearer ${t}`}};const u=m.request(l,o=>{if(o.statusCode===301||o.statusCode===302){const a=o.headers.location;if(a){_(t,a).then(n).catch(r);return}}if(o.statusCode!==200){r(new Error(`HTTP ${o.statusCode}`));return}const s=[];o.on("data",a=>s.push(a));o.on("end",()=>n(Buffer.concat(s)));o.on("error",r)});u.on("error",r);u.setTimeout(3e4,()=>{u.destroy();r(new Error("Timeout"))});u.end()})}function O(t){let e=t.replace(/[/\\]/g,"_").replace(/\.\./g,"_");e=e.replace(/[\x00-\x1f\x80-\x9f<>:"|?*]/g,"_");e=e.replace(/^\.+|\.+$/g,"").trim();return e||"unnamed_file"}function P(t){if(t<1024)return`${t}B`;if(t<1024*1024)return`${(t/1024).toFixed(1)}KB`;return`${(t/(1024*1024)).toFixed(1)}MB`}

package/dist/slack/markdown.js

@@ -1,33 +1 @@
-"use strict";
-/**
- * Lightweight Markdown → Slack mrkdwn converter.
- * Ported from cli-bak formatters, stripped of NestJS / md-to-slack deps.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.markdownToMrkdwn = markdownToMrkdwn;
-const HEADING_RE = /^(#{1,6})\s+(.+)$/gm;
-const BOLD_RE = /\*\*([^*]+)\*\*/g;
-const ITALIC_RE = /(?<!\*)\*([^*]+)\*(?!\*)/g;
-const CODE_BLOCK_RE = /```(\w*)\n([\s\S]*?)```/g;
-const INLINE_CODE_RE = /`([^`]+)`/g;
-const LINK_RE = /\[([^\]]+)\]\(([^)]+)\)/g;
-const UNORDERED_LIST_RE = /^[\s]*[-*]\s+/gm;
-const ORDERED_LIST_RE = /^[\s]*(\d+)\.\s+/gm;
-function markdownToMrkdwn(text) {
-    if (!text)
-        return '';
-    let result = text;
-    result = result.replace(CODE_BLOCK_RE, (_match, _lang, code) => {
-        return `\`\`\`${code.trim()}\`\`\``;
-    });
-    result = result.replace(INLINE_CODE_RE, '`$1`');
-    result = result.replace(HEADING_RE, (_match, _hashes, content) => {
-        return `*${content.trim()}*`;
-    });
-    result = result.replace(BOLD_RE, '*$1*');
-    result = result.replace(ITALIC_RE, '_$1_');
-    result = result.replace(LINK_RE, '<$2|$1>');
-    result = result.replace(UNORDERED_LIST_RE, '• ');
-    result = result.replace(ORDERED_LIST_RE, '$1. ');
-    return result;
-}
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.markdownToMrkdwn=g;const s=/^(#{1,6})\s+(.+)$/gm;const _=/\*\*([^*]+)\*\*/g;const E=/(?<!\*)\*([^*]+)\*(?!\*)/g;const a=/```(\w*)\n([\s\S]*?)```/g;const o=/`([^`]+)`/g;const l=/\[([^\]]+)\]\(([^)]+)\)/g;const R=/^[\s]*[-*]\s+/gm;const u=/^[\s]*(\d+)\.\s+/gm;function g(t){if(!t)return"";let e=t;e=e.replace(a,(c,n,r)=>{return`\`\`\`${r.trim()}\`\`\``});e=e.replace(o,"`$1`");e=e.replace(s,(c,n,r)=>{return`*${r.trim()}*`});e=e.replace(_,"*$1*");e=e.replace(E,"_$1_");e=e.replace(l,"<$2|$1>");e=e.replace(R,"\u2022 ");e=e.replace(u,"$1. ");return e}