@crewx/cli 0.9.0-rc.10 → 0.9.0-rc.100

package/dist/commands/execute.js

@@ -6,40 +6,85 @@
  * Flags:
  *   --thread <name>          Conversation thread name
  *   --provider <cli/xxx>     Provider override
+ *   --model <name>           Model override (e.g. claude-sonnet-5)
  *   --metadata <json>        Extra metadata JSON (double-quoted object). Propagated to events/hooks/tracing.
- *                           e.g. --metadata='{"workflow_id":"wf-1"}'
  *   --verbose                Debug output mode (default: raw agent response only)
  *   --config/-c <path>       Config file path override
  *   --output-format <fmt>    Output format (json|text|stream-json)
  *   --effort <level>         Model effort (high|medium|low)
- *   -f/--prompt-file <path>  Read task body from file (bypasses cmd.exe argv truncation)
+ *   -f/--prompt-file <path>  Read task body from file
+ *   --detach/--async         Persist a receipt and launch a detached runner
+ *   --wait                   Force synchronous execution
  *
  * Stdin support:
  *   Pipe or redirect content into crewx x to supply the task body via stdin.
- *   e.g. cat task.md | crewx x "@agent label"
  *   Stdin is ignored when running in an interactive TTY.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.runDetachedMiddle = void 0;
 exports.handleExecute = handleExecute;
 const sdk_1 = require("@crewx/sdk");
+const repository_1 = require("@crewx/sdk/repository");
 const parse_agent_message_1 = require("./parse-agent-message");
 const parse_common_flags_1 = require("./parse-common-flags");
 const resolve_prompt_1 = require("./resolve-prompt");
 const crewx_cli_1 = require("../bootstrap/crewx-cli");
 const inherited_trace_1 = require("../utils/inherited-trace");
+const write_output_1 = require("./write-output");
+const detached_1 = require("./detached");
+const emit_trailer_1 = require("./emit-trailer");
+// Exported for platform-focused tests; the middle hop remains an internal CLI
+// contract and is not routed through the public command registry.
+var detached_2 = require("./detached");
+Object.defineProperty(exports, "runDetachedMiddle", { enumerable: true, get: function () { return detached_2.runDetachedMiddle; } });
 /**
  * Handle `crewx execute <agentRef> <message>` command.
  *
  * Default output: raw agent response only (stdout).
  * --verbose: debug info written to stderr, response to stdout.
  */
-async function handleExecute(args) {
-    const { thread, provider, metadata, verbose, config, outputFormat, effort, promptFile, overdrive, vars, rest } = (0, parse_common_flags_1.parseCommonFlags)(args);
-    const { agentRef: parsedAgentRef, message } = (0, parse_agent_message_1.parseAgentMessage)(rest);
-    // No @mention → default to @crewx agent (matches cli-bak behaviour)
+async function handleExecute(args, command = 'execute', emitState = (0, emit_trailer_1.createDelegationEmitState)()) {
+    // The private middle-hop marker is consumed before public flag parsing. An
+    // invalid direct use remains an unknown option and is rejected normally.
+    const middleHop = (0, detached_1.readDetachedMiddleHop)(args);
+    if (middleHop) {
+        await (0, detached_1.runDetachedMiddle)(command, middleHop);
+        return;
+    }
+    const receiptFlags = (0, detached_1.extractReceiptFlags)(args);
+    const receiptMode = (0, detached_1.resolveReceiptMode)({
+        detach: receiptFlags.detach,
+        wait: receiptFlags.wait,
+        detachedRunner: (0, inherited_trace_1.isDetachedRunner)(),
+        agentContext: Boolean(process.env['CREWX_AGENT_ID']),
+    });
+    if (receiptMode.receipt) {
+        await (0, detached_1.runDetached)(command, receiptFlags.rest, receiptMode.reason);
+        return;
+    }
+    let parsedFlags;
+    try {
+        parsedFlags = (0, parse_common_flags_1.parseCommonFlags)(receiptFlags.rest);
+    }
+    catch (err) {
+        (0, emit_trailer_1.emitDelegationResult)({ command, isError: true, state: emitState });
+        throw err;
+    }
+    const { thread, provider, model, metadata, verbose, config, outputFormat, effort, promptFile, overdrive, vars, out, rest } = parsedFlags;
+    const inheritedTrace = (0, inherited_trace_1.readInheritedTrace)();
+    let parsedAgentRef;
+    let message;
+    let finalMessage;
+    try {
+        ({ agentRef: parsedAgentRef, message } = (0, parse_agent_message_1.parseAgentMessage)(rest));
+        // Resolve final prompt: argv | stdin pipe | --prompt-file (or combination)
+        finalMessage = await (0, resolve_prompt_1.resolvePrompt)(message, promptFile);
+    }
+    catch (err) {
+        (0, emit_trailer_1.emitDelegationResult)({ command, trace: inheritedTrace, isError: true, state: emitState });
+        throw err;
+    }
     const agentRef = parsedAgentRef || '@crewx';
-    // Resolve final prompt: argv | stdin pipe | --prompt-file (or combination)
-    const finalMessage = await (0, resolve_prompt_1.resolvePrompt)(message, promptFile);
     if (!finalMessage) {
         console.error('Usage: crewx execute [@agent] <task> [options]');
         console.error('       crewx x [@agent] <task> [options]');
@@ -55,6 +100,7 @@ async function handleExecute(args) {
         console.error('Options:');
         console.error('  --thread <name>           Conversation thread name');
         console.error('  --provider <cli/xxx>      Provider override');
+        console.error('  --model <name>            Model override (e.g. claude-sonnet-5)');
         console.error('  --metadata <json>         Extra metadata (JSON object, double-quoted).');
         console.error('                            Propagated to events/hooks/tracing.');
         console.error('                            Invalid JSON aborts with exit code 2.');
@@ -62,30 +108,43 @@ async function handleExecute(args) {
         console.error('  --verbose                 Debug output mode');
         console.error('  --config/-c <path>        Config file path');
         console.error('  --output-format <fmt>     Output format (json|text|stream-json)');
+        console.error('  --out/-o <path>           Save result to file (stdout suppressed)');
         console.error('  --effort <level>          Model effort (high|medium|low)');
         console.error('  -f/--prompt-file <path>   Read task body from file');
         console.error('  --var key=value           Template variable (repeatable)');
         console.error('  --overdrive               Activate overdrive (boost) profile for this request');
+        (0, emit_trailer_1.emitDelegationResult)({ command, trace: inheritedTrace, isError: true, state: emitState });
         process.exit(1);
+        return;
     }
     const configPath = config ?? process.env.CREWX_CONFIG ?? 'crewx.yaml';
     // Only show exec audit span JSON in verbose mode
     (0, sdk_1.setAuditVerbose)(verbose);
-    const crewx = await (0, crewx_cli_1.createCliCrewx)(configPath);
+    let crewx;
+    try {
+        crewx = await (0, crewx_cli_1.createCliCrewx)(configPath);
+    }
+    catch (err) {
+        (0, emit_trailer_1.emitDelegationResult)({ command, trace: inheritedTrace, isError: true, state: emitState });
+        throw err;
+    }
     // file:// remote agent delegation is handled transparently inside Crewx.query/execute.
     if (verbose) {
+        process.stderr.write(`mode=sync reason=${receiptMode.reason}\n`);
         process.stderr.write(`📋 Task: ${finalMessage}\n`);
         process.stderr.write(`🤖 Agent: ${agentRef}\n`);
         if (thread)
             process.stderr.write(`🔗 Thread: ${thread}\n`);
         if (provider)
             process.stderr.write(`🔌 Provider: ${provider}\n`);
+        if (model)
+            process.stderr.write(`🧠 Model: ${model}\n`);
         if (outputFormat)
             process.stderr.write(`📄 Output-format: ${outputFormat}\n`);
         if (effort)
             process.stderr.write(`⚡ Effort: ${effort}\n`);
         if (overdrive)
-            process.stderr.write(`🚀 Overdrive: ON\n`);
+            process.stderr.write('🚀 Overdrive: ON\n');
         process.stderr.write('─'.repeat(60) + '\n');
     }
     let parsedMetadata = {};
@@ -95,22 +154,43 @@ async function handleExecute(args) {
     catch (err) {
         const msg = err instanceof Error ? err.message : String(err);
         process.stderr.write(`Error: ${msg}\n`);
+        (0, emit_trailer_1.emitDelegationResult)({ command, trace: inheritedTrace, isError: true, state: emitState });
         process.exit(2);
+        return;
+    }
+    // Only the detached runner may adopt a pre-issued task row. Trace variables
+    // describe the caller chain and are never used as this task's identity.
+    const detachedRunner = (0, inherited_trace_1.isDetachedRunner)();
+    const assignedTaskId = (0, inherited_trace_1.readRunnerAssignment)();
+    let selfTaskId;
+    if (assignedTaskId !== undefined) {
+        const adoption = (0, detached_1.adoptAssignedTask)(new repository_1.TaskRepository(), assignedTaskId, detachedRunner);
+        if (adoption.kind === 'failed') {
+            (0, emit_trailer_1.emitDelegationResult)({ command, trace: inheritedTrace, isError: true, state: emitState });
+            process.exit(1);
+            return;
+        }
+        if (adoption.kind === 'adopted')
+            selfTaskId = adoption.taskId;
     }
     let exitCode = 0;
+    let result;
     try {
-        const result = await crewx.execute(agentRef, finalMessage, {
+        result = await crewx.execute(agentRef, finalMessage, {
             provider,
+            model,
             effort: effort || undefined,
             overdrive: overdrive || undefined,
             threadId: thread,
+            taskId: selfTaskId,
             metadata: Object.keys(parsedMetadata).length > 0 ? parsedMetadata : undefined,
             vars: Object.keys(vars).length > 0 ? vars : undefined,
-            trace: (0, inherited_trace_1.readInheritedTrace)(),
+            trace: inheritedTrace,
         });
         if (!result.ok) {
             const errMsg = result.error?.message ?? 'Execute failed';
             console.error(errMsg);
+            (0, write_output_1.appendError)(out, errMsg);
             exitCode = 1;
         }
         else {
@@ -123,20 +203,41 @@ async function handleExecute(args) {
                 process.stderr.write('\n📄 Response:\n');
                 process.stderr.write('─'.repeat(40) + '\n');
             }
-            console.log(result.data);
-            if (verbose) {
+            (0, write_output_1.writeResult)(out, result.data);
+            if (verbose)
                 process.stderr.write('\n✅ Execute completed successfully\n');
-            }
         }
     }
     catch (err) {
         const errMsg = err instanceof Error ? err.message : String(err);
         console.error(`Error: ${errMsg}`);
+        (0, write_output_1.appendError)(out, `Error: ${errMsg}`);
         exitCode = 1;
     }
     finally {
-        await crewx.close();
+        try {
+            await crewx.close();
+        }
+        catch (err) {
+            (0, emit_trailer_1.emitDelegationResult)({
+                command,
+                trace: inheritedTrace,
+                taskId: result?.meta.taskId,
+                agentId: result?.meta.agentId,
+                isError: true,
+                state: emitState,
+            });
+            throw err;
+        }
     }
+    (0, emit_trailer_1.emitDelegationResult)({
+        command,
+        trace: inheritedTrace,
+        taskId: result?.meta.taskId,
+        agentId: result?.meta.agentId,
+        isError: exitCode !== 0 || result?.ok === false,
+        state: emitState,
+    });
     if (exitCode !== 0)
         process.exit(exitCode);
 }

package/dist/commands/hook/command-marker.d.ts

@@ -0,0 +1,2 @@
+/** Match only commands that invoke CrewX's hook-dispatch subcommand. */
+export declare const CREWX_HOOK_COMMAND_RE: RegExp;

package/dist/commands/hook/command-marker.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CREWX_HOOK_COMMAND_RE = void 0;
+/** Match only commands that invoke CrewX's hook-dispatch subcommand. */
+exports.CREWX_HOOK_COMMAND_RE = /crewx(?:\.js|\.cmd|\.exe)?['"]?\s+hook-dispatch\b/i;

package/dist/commands/hook/install.d.ts

@@ -10,7 +10,6 @@
  *   - Never traverses parent directories — project root determined by crewx.yaml
  */
 import { type HookProvider } from './paths';
-export declare const CREWX_HOOK_COMMAND_MARKER = "crewx hook-dispatch";
 export declare function resolveCrewxBinary(): string;
 export interface HookInstallOpts {
     projectRoot: string;

package/dist/commands/hook/install.js

@@ -10,49 +10,14 @@
  *   - Preserves existing user hooks
  *   - Never traverses parent directories — project root determined by crewx.yaml
  */
-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.CREWX_HOOK_COMMAND_MARKER = void 0;
 exports.resolveCrewxBinary = resolveCrewxBinary;
 exports.handleHookInstall = handleHookInstall;
 const fs_1 = require("fs");
-const path_1 = require("path");
-const cp = __importStar(require("child_process"));
+const sdk_1 = require("@crewx/sdk");
 const paths_1 = require("./paths");
-exports.CREWX_HOOK_COMMAND_MARKER = 'crewx hook-dispatch';
-function getProviderConfigs(projectRoot, providers, crewxBin) {
+const command_marker_1 = require("./command-marker");
+function getProviderConfigs(projectRoot, providers) {
     return providers.map((provider) => ({
         settingsPath: provider === 'claude'
             ? (0, paths_1.getClaudeSettingsPath)(projectRoot)
@@ -63,24 +28,13 @@ function getProviderConfigs(projectRoot, providers, crewxBin) {
     }));
 }
 function resolveCrewxBinary() {
-    if (process.env.CREWX_CLI)
-        return process.env.CREWX_CLI;
-    try {
-        const which = cp.execSync('which crewx 2>/dev/null', { encoding: 'utf8' }).trim();
-        const isTmpProxy = which.includes('/T/crewx-proxy-') ||
-            which.includes('/tmp/crewx-proxy-') ||
-            /\/[Tt]e?mp\//.test(which);
-        if (which && !isTmpProxy)
-            return which;
+    const resolution = (0, sdk_1.resolveCrewxExecutable)();
+    if (!resolution.ok) {
+        throw new Error((0, sdk_1.formatCrewxExecutableFailure)(resolution));
     }
-    catch { }
-    if (process.argv[1]) {
-        const scriptPath = (0, path_1.resolve)(process.argv[1]);
-        if ((0, fs_1.existsSync)(scriptPath)) {
-            return `${process.execPath} ${scriptPath}`;
-        }
-    }
-    return 'crewx';
+    const stableEntrypoint = (0, sdk_1.materializeCrewxStableEntrypoint)(resolution);
+    const useStable = stableEntrypoint && resolution.argv.some(sdk_1.isRotatingInstallPath);
+    return (0, sdk_1.formatCrewxExecutableArgv)(useStable ? [stableEntrypoint] : resolution.argv);
 }
 function readSettingsTyped(settingsPath) {
     return (0, paths_1.readSettings)(settingsPath);
@@ -88,10 +42,19 @@ function readSettingsTyped(settingsPath) {
 function findCrewxEntry(preToolUse) {
     if (!preToolUse)
         return -1;
-    return preToolUse.findIndex((entry) => entry.hooks?.some((h) => h.command?.includes(exports.CREWX_HOOK_COMMAND_MARKER)));
+    return preToolUse.findIndex((entry) => entry.hooks?.some((h) => command_marker_1.CREWX_HOOK_COMMAND_RE.test(h.command)));
+}
+function findCrewxHook(entry) {
+    if (!entry.hooks)
+        return undefined;
+    const index = entry.hooks.findIndex((hook) => command_marker_1.CREWX_HOOK_COMMAND_RE.test(hook.command));
+    if (index < 0)
+        return undefined;
+    return { index, command: entry.hooks[index].command };
 }
 function installForProvider(projectRoot, config, crewxBin, yes) {
     const { settingsPath, provider, matcher, commandArg } = config;
+    const command = `${crewxBin} hook-dispatch ${commandArg}`;
     const settings = readSettingsTyped(settingsPath);
     if (!settings.hooks)
         settings.hooks = {};
@@ -99,8 +62,28 @@ function installForProvider(projectRoot, config, crewxBin, yes) {
         settings.hooks.PreToolUse = [];
     const existingIdx = findCrewxEntry(settings.hooks.PreToolUse);
     if (existingIdx >= 0) {
-        console.log(`[crewx] Hook already installed in ${settingsPath} (${provider})`);
-        return false;
+        const existingEntry = settings.hooks.PreToolUse[existingIdx];
+        const existingHook = findCrewxHook(existingEntry);
+        if (existingHook?.command === command) {
+            console.log(`[crewx] Hook already installed in ${settingsPath} (${provider})`);
+            return false;
+        }
+        if (!yes) {
+            console.log(`[crewx] Existing CrewX hook needs an install-path refresh in ${settingsPath} (${provider})`);
+            return false;
+        }
+        if ((0, fs_1.existsSync)(settingsPath)) {
+            const backupPath = settingsPath + '.crewx-backup';
+            (0, fs_1.copyFileSync)(settingsPath, backupPath);
+            console.log(`[crewx] Backup created: ${backupPath}`);
+        }
+        if (existingHook) {
+            existingEntry.hooks[existingHook.index] = { ...existingEntry.hooks[existingHook.index], command };
+        }
+        (0, fs_1.writeFileSync)(settingsPath, JSON.stringify(settings, null, 2) + '\n', 'utf8');
+        console.log(`[crewx] Hook updated (${provider}): ${command}`);
+        console.log(`[crewx] Settings: ${settingsPath}`);
+        return true;
     }
     if (!yes) {
         console.log(`⚠️  crewx hook install will register crewx-hook-dispatch as a PreToolUse hook.\n` +
@@ -119,7 +102,6 @@ function installForProvider(projectRoot, config, crewxBin, yes) {
     else {
         (0, paths_1.ensureCodexHooks)(projectRoot);
     }
-    const command = `${crewxBin} hook-dispatch ${commandArg}`;
     settings.hooks.PreToolUse.push({
         matcher,
         hooks: [{ type: 'command', command }],
@@ -133,8 +115,15 @@ async function handleHookInstall(argsOrOpts) {
     if (!Array.isArray(argsOrOpts)) {
         const { projectRoot, yes, provider } = argsOrOpts;
         const providers = (0, paths_1.providersFromFilter)(provider ?? 'all');
-        const crewxBin = resolveCrewxBinary();
-        const configs = getProviderConfigs(projectRoot, providers, crewxBin);
+        let crewxBin;
+        try {
+            crewxBin = resolveCrewxBinary();
+        }
+        catch (error) {
+            console.error(`[crewx] ${error instanceof Error ? error.message : String(error)}`);
+            return;
+        }
+        const configs = getProviderConfigs(projectRoot, providers);
         for (const config of configs) {
             installForProvider(projectRoot, config, crewxBin, yes);
         }
@@ -152,8 +141,16 @@ async function handleHookInstall(argsOrOpts) {
     }
     const providerFilter = (0, paths_1.parseProviderArg)(args);
     const providers = (0, paths_1.providersFromFilter)(providerFilter);
-    const crewxBin = resolveCrewxBinary();
-    const configs = getProviderConfigs(projectRoot, providers, crewxBin);
+    let crewxBin;
+    try {
+        crewxBin = resolveCrewxBinary();
+    }
+    catch (error) {
+        console.error(`[crewx] ${error instanceof Error ? error.message : String(error)}`);
+        process.exitCode = 1;
+        return;
+    }
+    const configs = getProviderConfigs(projectRoot, providers);
     if (!yes) {
         const targets = configs.map((c) => `   - ${c.provider}: ${c.settingsPath}`).join('\n');
         console.log(`⚠️  crewx hook install will register crewx-hook-dispatch as a PreToolUse hook.\n` +

package/dist/commands/hook/status.js

@@ -11,7 +11,7 @@ const fs_1 = require("fs");
 const path_1 = require("path");
 const sdk_1 = require("@crewx/sdk");
 const paths_1 = require("./paths");
-const CREWX_HOOK_COMMAND_MARKER = 'crewx hook-dispatch';
+const command_marker_1 = require("./command-marker");
 function showProviderStatus(projectRoot, provider) {
     const settingsPath = provider === 'claude'
         ? (0, paths_1.getClaudeSettingsPath)(projectRoot)
@@ -26,9 +26,9 @@ function showProviderStatus(projectRoot, provider) {
     try {
         const settings = JSON.parse((0, fs_1.readFileSync)(settingsPath, 'utf8'));
         const preHooks = settings.hooks?.PreToolUse ?? [];
-        const crewxEntry = preHooks.find((entry) => entry.hooks?.some((h) => h.command?.includes(CREWX_HOOK_COMMAND_MARKER)));
+        const crewxEntry = preHooks.find((entry) => entry.hooks?.some((h) => command_marker_1.CREWX_HOOK_COMMAND_RE.test(h.command ?? '')));
         if (crewxEntry) {
-            const command = crewxEntry.hooks.find((h) => h.command?.includes(CREWX_HOOK_COMMAND_MARKER))?.command;
+            const command = crewxEntry.hooks.find((h) => command_marker_1.CREWX_HOOK_COMMAND_RE.test(h.command ?? ''))?.command;
             console.log(`    Status:   INSTALLED`);
             console.log(`    Command:  ${command}`);
         }

package/dist/commands/hook/uninstall.js

@@ -10,7 +10,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.handleHookUninstall = handleHookUninstall;
 const fs_1 = require("fs");
 const paths_1 = require("./paths");
-const CREWX_HOOK_COMMAND_MARKER = 'crewx hook-dispatch';
+const command_marker_1 = require("./command-marker");
 function getSettingsPath(projectRoot, provider) {
     return provider === 'claude'
         ? (0, paths_1.getClaudeSettingsPath)(projectRoot)
@@ -35,7 +35,7 @@ function uninstallFromProvider(projectRoot, provider) {
         return;
     }
     const before = settings.hooks.PreToolUse.length;
-    settings.hooks.PreToolUse = settings.hooks.PreToolUse.filter((entry) => !entry.hooks?.some((h) => h.command?.includes(CREWX_HOOK_COMMAND_MARKER)));
+    settings.hooks.PreToolUse = settings.hooks.PreToolUse.filter((entry) => !entry.hooks?.some((h) => command_marker_1.CREWX_HOOK_COMMAND_RE.test(h.command)));
     const removed = settings.hooks.PreToolUse.length < before;
     if (settings.hooks.PreToolUse.length === 0) {
         delete settings.hooks.PreToolUse;

package/dist/commands/init.js

@@ -52,6 +52,7 @@ const git = __importStar(require("isomorphic-git"));
 const nodeFs = __importStar(require("fs"));
 const os_1 = __importDefault(require("os"));
 const repository_1 = require("@crewx/sdk/repository");
+const sdk_1 = require("@crewx/sdk");
 const install_1 = require("./hook/install");
 const STATUSLINE_SCRIPT_NAME = 'claude-usage-statusline.js';
 const STATUSLINE_SCRIPT_MARKER = 'CrewX claude-usage-statusline';
@@ -84,6 +85,11 @@ const CREWX_MARKER = '# CrewX runtime';
 const CREWX_GITIGNORE = `# CrewX runtime
 .crewx/
 
+# Secrets (workspace .env — see docs/manual)
+.env
+.env.*
+!.env.example
+
 # Memory runtime state (regenerable from entries/)
 memory/*/.dirty-summary
 memory/*/graph.json
@@ -435,7 +441,7 @@ async function handleInit(opts) {
         }
     }
     // Always create docs dirs and templates, regardless of whether yaml was skipped
-    for (const dir of ['.crewx/logs', '.claude/commands', 'docs/goal', 'docs/daily', 'docs/wi']) {
+    for (const dir of ['.crewx/logs', '.claude/commands', 'docs/goal', 'docs/daily', 'docs/wi', 'workflows']) {
         try {
             (0, fs_1.mkdirSync)((0, path_1.join)(target, dir), { recursive: true });
         }
@@ -456,6 +462,21 @@ async function handleInit(opts) {
             console.log(`✅ ${t.dir}/ ${action} (${t.file})`);
         }
     }
+    try {
+        const workflowTemplatesDir = (0, sdk_1.resolveWorkflowTemplatesPath)();
+        for (const filename of [sdk_1.WI_DEFAULT_FLOW_FILENAME, sdk_1.WI_PLAN_FLOW_FILENAME]) {
+            const sourcePath = (0, path_1.join)(workflowTemplatesDir, filename);
+            const targetPath = (0, path_1.join)(target, 'workflows', filename);
+            if (force || !(0, fs_1.existsSync)(targetPath)) {
+                const action = (0, fs_1.existsSync)(targetPath) ? 'updated' : 'created';
+                (0, fs_1.copyFileSync)(sourcePath, targetPath);
+                console.log(`✅ workflows/ ${action} (${filename})`);
+            }
+        }
+    }
+    catch (e) {
+        errors.push(`WORKFLOW_TEMPLATE_FAILED:${e.message}`);
+    }
     // Always register workspace in ~/.crewx/crewx.db (best-effort, idempotent)
     let workspaceId;
     let slug;

package/dist/commands/kill.d.ts

@@ -1,9 +1,3 @@
-/**
- * crewx kill handler.
- * Kills a running task by ID or kills all running tasks.
- *
- * Usage:
- *   crewx kill <task-id>   Kill a specific running task
- *   crewx kill --all       Kill all running tasks
- */
+/** Compatibility entry point for `crewx kill`; the implementation lives in stop.ts. */
+export { handleStop } from './stop';
 export declare function handleKill(args: string[]): Promise<void>;

package/dist/commands/kill.js

@@ -1,52 +1,11 @@
 "use strict";
-/**
- * crewx kill handler.
- * Kills a running task by ID or kills all running tasks.
- *
- * Usage:
- *   crewx kill <task-id>   Kill a specific running task
- *   crewx kill --all       Kill all running tasks
- */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleStop = void 0;
 exports.handleKill = handleKill;
-const repository_1 = require("@crewx/sdk/repository");
+/** Compatibility entry point for `crewx kill`; the implementation lives in stop.ts. */
+var stop_1 = require("./stop");
+Object.defineProperty(exports, "handleStop", { enumerable: true, get: function () { return stop_1.handleStop; } });
+const stop_2 = require("./stop");
 async function handleKill(args) {
-    const killAll = args.includes('--all');
-    const taskId = args.find(a => !a.startsWith('--'));
-    if (!taskId && !killAll) {
-        console.error('Error: Please provide a task ID or use --all to kill all running tasks.');
-        console.error('');
-        console.error('Usage:');
-        console.error('  crewx kill <task-id>    Kill a running task by ID');
-        console.error('  crewx kill --all        Kill all running tasks');
-        process.exit(1);
-        return;
-    }
-    const repo = new repository_1.TaskRepository();
-    if (killAll) {
-        const running = repo.getRunningTasks();
-        if (running.length === 0) {
-            console.log('No running tasks found.');
-            return;
-        }
-        console.log(`Found ${running.length} running task(s). Killing...`);
-        for (const task of running) {
-            const r = repo.killTask(task.id);
-            if (r.killed) {
-                console.log(`Killed task ${task.id}${r.pid ? ` (PID: ${r.pid})` : ''}`);
-            }
-            else {
-                console.log(`Task ${task.id} could not be killed (may have already finished)`);
-            }
-        }
-        return;
-    }
-    const r = repo.killTask(taskId);
-    if (r.killed) {
-        console.log(`Killed task ${taskId}${r.pid ? ` (PID: ${r.pid})` : ''}`);
-    }
-    else {
-        console.error(`Error: Task not found or not running: ${taskId}`);
-        process.exit(1);
-    }
+    return (0, stop_2.handleStop)(args, 'kill');
 }

package/dist/commands/log.js

@@ -10,6 +10,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.handleLog = handleLog;
+const sdk_1 = require("@crewx/sdk");
 const repository_1 = require("@crewx/sdk/repository");
 function statusIcon(status) {
     switch (status) {
@@ -36,10 +37,10 @@ async function handleLog(args) {
         console.log(`Status: ${statusIcon(task.status)} ${task.status}`);
         console.log(`Agent: ${task.agent_id ?? '—'}`);
         console.log(`Mode: ${task.mode ?? '—'}`);
-        console.log(`Started: ${new Date(task.started_at).toLocaleString()}`);
+        console.log(`Started: ${(0, sdk_1.formatDisplayTimestamp)(new Date(task.started_at))}`);
         if (task.completed_at) {
             const duration = new Date(task.completed_at).getTime() - new Date(task.started_at).getTime();
-            console.log(`Completed: ${new Date(task.completed_at).toLocaleString()} (${duration}ms)`);
+            console.log(`Completed: ${(0, sdk_1.formatDisplayTimestamp)(new Date(task.completed_at))} (${duration}ms)`);
         }
         console.log('='.repeat(60));
         console.log('');
@@ -78,7 +79,7 @@ async function handleLog(args) {
                 : 'running...';
             console.log(`${idx + 1}. ${icon} ${task.id}`);
             console.log(`   Agent: ${task.agent_id ?? '—'}  Mode: ${task.mode ?? '—'}`);
-            console.log(`   Started: ${new Date(task.started_at).toLocaleString()}`);
+            console.log(`   Started: ${(0, sdk_1.formatDisplayTimestamp)(new Date(task.started_at))}`);
             console.log(`   Duration: ${duration}`);
             console.log('');
         });

package/dist/commands/parse-common-flags.d.ts

@@ -2,7 +2,7 @@
  * Common flag parser for query/execute commands.
  *
  * Supports both `--flag=value` and `--flag value` forms.
- * Handles: --thread, --provider, --metadata, --verbose, --config/-c,
+ * Handles: --thread, --provider, --model, --metadata, --verbose, --config/-c,
  *          --output-format, --effort, --prompt-file/-f, --overdrive.
  *
  * Strict mode: unknown --xxx tokens after known flags are consumed throw an
@@ -14,6 +14,8 @@ export interface CommonFlags {
     thread?: string;
     /** Provider override (e.g., cli/claude). */
     provider?: string;
+    /** Model override (e.g., claude-sonnet-5). */
+    model?: string;
     /** Raw metadata JSON string. */
     metadata?: string;
     /** Enable verbose/debug output mode. */
@@ -28,6 +30,8 @@ export interface CommonFlags {
     promptFile?: string;
     /** Whether overdrive (boost) is active for this request. */
     overdrive: boolean;
+    /** Output file path for saving result (--out/-o). */
+    out?: string;
     /** Template variables from --var key=value flags. */
     vars: Record<string, string>;
     /** Remaining non-flag positional arguments. */