@crewx/cli 0.9.0-rc.13 → 0.9.0-rc.131

package/dist/commands/init.js

@@ -44,6 +44,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildDefaultAgents = buildDefaultAgents;
+exports.parseInitProvider = parseInitProvider;
+exports.resolveInitProvider = resolveInitProvider;
 exports.handleInit = handleInit;
 const fs_1 = require("fs");
 const path_1 = require("path");
@@ -52,6 +55,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 +88,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
@@ -97,59 +106,66 @@ skills/*/.crewx/
 
 # OS
 .DS_Store`.trim();
-const DEFAULT_AGENTS = [
-    {
-        id: 'planner',
-        name: 'Planner',
-        role: 'Product/Architecture Planner',
-        team: 'core',
-        provider: 'acp/claude',
-        working_directory: './',
-        description: 'Owns requirements analysis, design, and work breakdown',
-        options: {
-            query: { effort: 'high' },
-            execute: { effort: 'high', mode: 'bypassPermissions' },
-        },
-        inline: {
-            model: 'claude-opus-4-7',
-            prompt: `You are a planner. Break down user goals into concrete,\ntestable steps. Challenge assumptions. Never write code directly.`,
-        },
-    },
-    {
-        id: 'developer',
-        name: 'Developer',
-        role: 'Implementation Engineer',
-        team: 'core',
-        provider: 'acp/claude',
-        working_directory: './',
-        description: 'Implements code changes and tests',
-        options: {
-            query: { effort: 'high' },
-            execute: { effort: 'high', mode: 'bypassPermissions' },
-        },
-        inline: {
-            model: 'claude-sonnet-4-6',
-            prompt: `Implement what the planner specifies. Prefer editing\nexisting files. Run tests before reporting done.`,
+/** Build the three default agents using the selected CLI provider profile. */
+function buildDefaultAgents(provider) {
+    const profile = (0, sdk_1.getDefaultAgentProfile)(provider);
+    if (!profile) {
+        throw new Error(`DEFAULT_AGENT_PROFILE_NOT_FOUND: ${provider}`);
+    }
+    return [
+        {
+            id: 'planner',
+            name: 'Planner',
+            role: 'Product/Architecture Planner',
+            team: 'core',
+            provider,
+            working_directory: './',
+            description: 'Owns requirements analysis, design, and work breakdown',
+            options: {
+                query: profile.planner.query,
+                execute: profile.planner.execute,
+            },
+            inline: {
+                model: profile.planner.model,
+                prompt: `You are a planner. Break down user goals into concrete,\ntestable steps. Challenge assumptions. Never write code directly.`,
+            },
         },
-    },
-    {
-        id: 'reviewer',
-        name: 'Reviewer',
-        role: 'Code Reviewer',
-        team: 'core',
-        provider: 'acp/claude',
-        working_directory: './',
-        description: 'Reviews code quality, security, and readability',
-        options: {
-            query: { effort: 'high' },
-            execute: { effort: 'high', mode: 'bypassPermissions' },
+        {
+            id: 'developer',
+            name: 'Developer',
+            role: 'Implementation Engineer',
+            team: 'core',
+            provider,
+            working_directory: './',
+            description: 'Implements code changes and tests',
+            options: {
+                query: profile.worker.query,
+                execute: profile.worker.execute,
+            },
+            inline: {
+                model: profile.worker.model,
+                prompt: `Implement what the planner specifies. Prefer editing\nexisting files. Run tests before reporting done.`,
+            },
         },
-        inline: {
-            model: 'claude-sonnet-4-6',
-            prompt: `Review diffs for correctness, security, readability.\nCite file:line. Be blunt, not polite.`,
+        {
+            id: 'reviewer',
+            name: 'Reviewer',
+            role: 'Code Reviewer',
+            team: 'core',
+            provider,
+            working_directory: './',
+            description: 'Reviews code quality, security, and readability',
+            options: {
+                query: profile.worker.query,
+                execute: profile.worker.execute,
+            },
+            inline: {
+                model: profile.worker.model,
+                prompt: `Review diffs for correctness, security, readability.\nCite file:line. Be blunt, not polite.`,
+            },
         },
-    },
-];
+    ];
+}
 const GOAL_TEMPLATE = `---
 type: goal
 description: CrewX Goal — OKR
@@ -370,10 +386,11 @@ function generateDefaultYaml(agents) {
     description: "${a.description}"
     options:
       query:
-        effort: "high"
+        mode: "${a.options.query.mode}"
+        effort: "${a.options.query.effort}"
       execute:
-        effort: "high"
-        mode: "bypassPermissions"
+        mode: "${a.options.execute.mode}"
+        effort: "${a.options.execute.effort}"
     inline:
       model: "${a.inline.model}"
       prompt: |
@@ -386,11 +403,51 @@ agents:
 ${agentBlocks}
 
 # Usage examples:
-#   crewx query "@planner analyze this codebase"
-#   crewx execute "@developer implement the feature described above"
+#   crewx q --to planner "analyze this codebase"
+#   crewx x --to developer "implement the feature described above"
 #   crewx agent ls
 `;
 }
+function isInitProvider(value) {
+    return value === 'cli/claude' || value === 'cli/codex';
+}
+function invalidProviderError(value) {
+    if (value === undefined || value.length === 0) {
+        return new Error('Missing --provider value. Expected: cli/claude | cli/codex');
+    }
+    return new Error(`Invalid --provider value: "${value}". Expected: cli/claude | cli/codex`);
+}
+/** Parse the provider option accepted by `crewx init`. */
+function parseInitProvider(args) {
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (arg === '--provider') {
+            const value = args[index + 1];
+            if (value === undefined || value.startsWith('--'))
+                throw invalidProviderError(undefined);
+            if (!isInitProvider(value))
+                throw invalidProviderError(value);
+            return value;
+        }
+        if (arg?.startsWith('--provider=')) {
+            const value = arg.slice('--provider='.length);
+            if (!isInitProvider(value))
+                throw invalidProviderError(value);
+            return value;
+        }
+    }
+    return undefined;
+}
+/** Resolve an explicit provider or detect Claude, then Codex, using PATH only. */
+function resolveInitProvider(provider, deps = {}) {
+    if (provider !== undefined)
+        return provider;
+    if ((0, sdk_1.isProviderAvailable)('cli/claude', deps))
+        return 'cli/claude';
+    if ((0, sdk_1.isProviderAvailable)('cli/codex', deps))
+        return 'cli/codex';
+    return 'cli/claude';
+}
 /**
  * Programmatic init — creates crewx.yaml, support dirs, and optionally installs hooks.
  * Throws on unrecoverable errors (PATH_NOT_FOUND, YAML_CREATE_FAILED).
@@ -399,7 +456,8 @@ ${agentBlocks}
  * server paths both produce a row in ~/.crewx/crewx.db.
  */
 async function handleInit(opts) {
-    const { path: target, skipHook = false, force = false } = opts;
+    const { path: target, skipHook = false, force = false, provider: requestedProvider } = opts;
+    const provider = resolveInitProvider(requestedProvider);
     const errors = [];
     let yamlCreated = false;
     let hookInstalled = false;
@@ -417,7 +475,7 @@ async function handleInit(opts) {
     }
     if (!skippedReason) {
         try {
-            const content = generateDefaultYaml(DEFAULT_AGENTS);
+            const content = generateDefaultYaml(buildDefaultAgents(provider));
             (0, fs_1.writeFileSync)(yamlPath, content, 'utf-8');
             yamlCreated = true;
         }
@@ -435,7 +493,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 +514,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;
@@ -487,7 +560,7 @@ async function handleInit(opts) {
     await initGitRepo(target, errors);
     // Idempotent statusLine merge into ~/.claude/settings.json
     const statusLineResult = ensureClaudeStatusLine();
-    return { yamlCreated, hookInstalled, errors, skippedReason, workspaceId, slug, ...statusLineResult };
+    return { yamlCreated, hookInstalled, errors, provider, skippedReason, workspaceId, slug, ...statusLineResult };
 }
 function ensureClaudeStatusLine() {
     const home = os_1.default.homedir();

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: --to, --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
@@ -12,8 +12,12 @@
 export interface CommonFlags {
     /** Thread name for conversation continuity. */
     thread?: string;
+    /** Explicit agent recipient. */
+    to?: 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 +32,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. */

package/dist/commands/parse-common-flags.js

@@ -3,7 +3,7 @@
  * Common flag parser for query/execute commands.
  *
  * Supports both `--flag=value` and `--flag value` forms.
- * Handles: --thread, --provider, --metadata, --verbose, --config/-c,
+ * Handles: --to, --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
@@ -61,25 +61,30 @@ exports.UnknownOptionError = UnknownOptionError;
  * The `--` sentinel itself is NOT included in `rest`.
  */
 function parseCommonFlags(args) {
+    const { value: to, consumed: toConsumed } = parseToFlag(args);
     const thread = parseFlag(args, '--thread');
     const provider = parseFlag(args, '--provider');
+    const model = parseFlag(args, '--model');
     const metadata = parseFlag(args, '--metadata');
     const config = parseFlag(args, '--config', '-c');
     const outputFormat = parseFlag(args, '--output-format');
     const effort = parseFlag(args, '--effort');
     const promptFile = parseFlag(args, '--prompt-file', '-f');
+    const out = parseFlag(args, '--out', '-o');
     const verbose = hasFlag(args, '--verbose');
     const overdrive = hasFlag(args, '--overdrive');
     // Collect consumed positions for known flags
-    const consumed = new Set();
+    const consumed = new Set(toConsumed);
     const flagPairs = [
         { names: ['--thread'] },
         { names: ['--provider'] },
+        { names: ['--model'] },
         { names: ['--metadata'] },
         { names: ['--config', '-c'] },
         { names: ['--output-format'] },
         { names: ['--effort'] },
         { names: ['--prompt-file', '-f'] },
+        { names: ['--out', '-o'] },
     ];
     // Parse --var key=value flags (multiple allowed; last value wins on duplicate keys)
     const vars = {};
@@ -145,7 +150,7 @@ function parseCommonFlags(args) {
         if (!escapeMode && token.startsWith('--')) {
             throw new UnknownOptionError(`Unknown option: ${token}. Use "--" to pass literal flag-like tokens as message.\n` +
                 `   Did you mean: crewx serve ${token}\n` +
-                `              or: crewx q -- ${token} <message>   (to include in message)`);
+                `              or: crewx q --to <agent> -- ${token} <message>`);
         }
         // Reject short -x flags that are not numeric (e.g. -f was consumed above)
         if (!escapeMode && token.startsWith('-') && token.length > 1 && !/^-?\d/.test(token)) {
@@ -153,7 +158,35 @@ function parseCommonFlags(args) {
         }
         rest.push(token);
     }
-    return { thread, provider, metadata, verbose, config, outputFormat, effort, promptFile, overdrive, vars, rest };
+    return { to, thread, provider, model, metadata, verbose, config, outputFormat, effort, promptFile, overdrive, vars, out, rest };
+}
+/** Parse the explicit recipient flag without treating tokens after `--` as flags. */
+function parseToFlag(args) {
+    let value;
+    const consumed = [];
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (arg === '--')
+            break;
+        if (arg.startsWith('--to=')) {
+            const candidate = arg.slice('--to='.length);
+            if (!candidate.trim())
+                throw new UnknownOptionError('--to requires an agent id');
+            value = candidate;
+            consumed.push(index);
+            continue;
+        }
+        if (arg !== '--to')
+            continue;
+        const candidate = args[index + 1];
+        if (candidate === undefined || candidate === '--' || candidate.startsWith('--') || !candidate.trim()) {
+            throw new UnknownOptionError('--to requires an agent id');
+        }
+        value = candidate;
+        consumed.push(index, index + 1);
+        index += 1;
+    }
+    return { value, consumed };
 }
 /**
  * Parse metadata JSON string from --metadata flag.

package/dist/commands/ps.d.ts

@@ -1,9 +1,9 @@
 /**
  * crewx ps handler.
- * Lists currently running tasks in table format.
+ * Lists active tasks (pending or running) in table format.
  *
  * Usage:
- *   crewx ps           List all running tasks
+ *   crewx ps           List all pending and running tasks
  *   crewx ps --json    Output as JSON array
  */
 export declare function handlePs(args: string[]): Promise<void>;

package/dist/commands/ps.js

@@ -1,15 +1,16 @@
 "use strict";
 /**
  * crewx ps handler.
- * Lists currently running tasks in table format.
+ * Lists active tasks (pending or running) in table format.
  *
  * Usage:
- *   crewx ps           List all running tasks
+ *   crewx ps           List all pending and running tasks
  *   crewx ps --json    Output as JSON array
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.handlePs = handlePs;
 const repository_1 = require("@crewx/sdk/repository");
+const cal_1 = require("./cal");
 function formatElapsed(ms) {
     const s = Math.floor(ms / 1000);
     if (s < 60)
@@ -34,9 +35,9 @@ function isAgyCommand(codingAgentCommand) {
     const base = firstToken.split('/').pop() ?? firstToken;
     return base.startsWith('agy');
 }
-function getLastActive(task) {
+function getLastActive(task, taskRepo) {
     try {
-        const entries = task.logs ? JSON.parse(task.logs) : [];
+        const entries = taskRepo.readLogsTail(task.id, 1)?.entries ?? [];
         if (Array.isArray(entries) && entries.length > 0) {
             const lastEntry = entries[entries.length - 1];
             const ts = lastEntry?.timestamp;
@@ -59,12 +60,13 @@ function getLastActive(task) {
     }
     return { display: '—', isoTimestamp: null, logCapable: true };
 }
-function taskToRow(task) {
+function taskToRow(task, taskRepo) {
     const elapsed = formatElapsed(Date.now() - new Date(task.started_at).getTime());
-    const lastActive = getLastActive(task);
+    const lastActive = getLastActive(task, taskRepo);
     return [
         task.id,
         task.agent_id ?? '—',
+        task.status,
         task.pid !== null && task.pid !== undefined ? String(task.pid) : '—',
         elapsed,
         task.mode ?? '—',
@@ -83,14 +85,14 @@ function renderTable(headers, rows) {
 }
 async function handlePs(args) {
     const repo = new repository_1.TaskRepository();
-    const tasks = repo.getRunningTasks();
-    if (tasks.length === 0) {
-        console.log('No running tasks.');
-        return;
-    }
+    const reaped = repo.reapOrphanedTasks();
+    if (reaped > 0)
+        console.error(`Reaped ${reaped} orphaned task(s)`);
+    repo.reapRunningWorkflowTasks();
+    const tasks = repo.getActiveTasks();
     if (args.includes('--json')) {
         const withLastActive = tasks.map((task) => {
-            const lastActive = getLastActive(task);
+            const lastActive = getLastActive(task, repo);
             return {
                 ...task,
                 last_active_at: lastActive.isoTimestamp,
@@ -100,8 +102,16 @@ async function handlePs(args) {
         console.log(JSON.stringify(withLastActive, null, 2));
         return;
     }
-    const headers = ['TASK ID', 'AGENT', 'PID', 'ELAPSED', 'MODE', 'LAST ACTIVE'];
-    const rows = tasks.map(taskToRow);
+    if (tasks.length === 0) {
+        console.log('No active tasks.');
+        return;
+    }
+    const headers = ['TASK ID', 'AGENT', 'STATUS', 'PID', 'ELAPSED', 'MODE', 'LAST ACTIVE'];
+    const rows = tasks.map((task) => taskToRow(task, repo));
     renderTable(headers, rows);
-    console.log(`\n  ${tasks.length} running task(s)`);
+    console.log(`\n  ${tasks.length} active task(s)`);
+    (0, cal_1.writeCalFooter)({
+        commandId: 'crewx.ps',
+        params: { taskId: tasks[0].id },
+    });
 }

package/dist/commands/publish.d.ts

@@ -0,0 +1 @@
+export declare function handlePublish(args: string[]): Promise<void>;