@crewx/cli 0.9.0-rc.8 → 0.9.0-rc.80

package/dist/commands/query.js

@@ -6,6 +6,7 @@
  * 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)
@@ -27,6 +28,7 @@ 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");
 /**
  * Handle `crewx query <agentRef> <message>` command.
  *
@@ -34,7 +36,7 @@ const inherited_trace_1 = require("../utils/inherited-trace");
  * --verbose: debug info written to stderr, response to stdout.
  */
 async function handleQuery(args) {
-    const { thread, provider, metadata, verbose, config, outputFormat, effort, promptFile, overdrive, vars, rest } = (0, parse_common_flags_1.parseCommonFlags)(args);
+    const { thread, provider, model, metadata, verbose, config, outputFormat, effort, promptFile, overdrive, vars, out, 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)
     const agentRef = parsedAgentRef || '@crewx';
@@ -55,6 +57,7 @@ async function handleQuery(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,6 +65,7 @@ async function handleQuery(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 prompt body from file');
         console.error('  --var key=value           Template variable (repeatable)');
@@ -80,6 +84,8 @@ async function handleQuery(args) {
             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)
@@ -101,6 +107,7 @@ async function handleQuery(args) {
     try {
         const result = await crewx.query(agentRef, finalMessage, {
             provider,
+            model,
             effort: effort || undefined,
             overdrive: overdrive || undefined,
             threadId: thread,
@@ -111,6 +118,7 @@ async function handleQuery(args) {
         if (!result.ok) {
             const errMsg = result.error?.message ?? 'Query failed';
             console.error(errMsg);
+            (0, write_output_1.appendError)(out, errMsg);
             exitCode = 1;
         }
         else {
@@ -123,7 +131,7 @@ async function handleQuery(args) {
                 process.stderr.write('\n📄 Response:\n');
                 process.stderr.write('─'.repeat(40) + '\n');
             }
-            console.log(result.data);
+            (0, write_output_1.writeResult)(out, result.data);
             if (verbose) {
                 process.stderr.write('\n✅ Query completed successfully\n');
             }
@@ -132,6 +140,7 @@ async function handleQuery(args) {
     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 {

package/dist/commands/registry.js

@@ -17,13 +17,15 @@ exports.KNOWN_COMMANDS = new Set([
     'doctor', 'init',
     'db',
     'help',
+    'shortcut',
+    'publish',
     'slack', 'slack:files',
     'hook', 'hook-dispatch',
 ]);
 /** Built-in tool commands routed via handleBuiltin(). */
 exports.BUILTIN_COMMAND_NAMES = new Set([
     'memory', 'search', 'doc', 'wbs', 'cron', 'workflow', 'skill', 'dreaming',
-    'wi', 'chromex',
+    'wi', 'chromex', 'notify',
 ]);
 /** Commands not yet migrated from cli-bak — show a migration message. */
 exports.NOT_YET_MIGRATED = new Set([

package/dist/commands/result.d.ts

@@ -3,8 +3,12 @@
  * Retrieves the result of a completed task by its ID.
  *
  * Usage:
- *   crewx result <task-id>         Print raw result
- *   crewx result <task-id> --json  Print full task record as JSON
- *   crewx result                   List recent tasks (latest 10)
+ *   crewx result <task-id>            Print raw result
+ *   crewx result <task-id> --json     Print full task record as JSON
+ *   crewx result <task-id> --wait=N   Poll (1s interval) up to N seconds for
+ *                                    the task to leave 'running'. Exit 124 on
+ *                                    timeout. --wait=0 behaves like no --wait
+ *                                    (single immediate check).
+ *   crewx result                      List recent tasks (latest 10)
  */
 export declare function handleResult(args: string[]): Promise<void>;

package/dist/commands/result.js

@@ -4,13 +4,19 @@
  * Retrieves the result of a completed task by its ID.
  *
  * Usage:
- *   crewx result <task-id>         Print raw result
- *   crewx result <task-id> --json  Print full task record as JSON
- *   crewx result                   List recent tasks (latest 10)
+ *   crewx result <task-id>            Print raw result
+ *   crewx result <task-id> --json     Print full task record as JSON
+ *   crewx result <task-id> --wait=N   Poll (1s interval) up to N seconds for
+ *                                    the task to leave 'running'. Exit 124 on
+ *                                    timeout. --wait=0 behaves like no --wait
+ *                                    (single immediate check).
+ *   crewx result                      List recent tasks (latest 10)
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.handleResult = handleResult;
+const sdk_1 = require("@crewx/sdk");
 const repository_1 = require("@crewx/sdk/repository");
+const POLL_INTERVAL_MS = 1000;
 function statusIcon(status) {
     switch (status) {
         case 'running': return '⏳';
@@ -19,8 +25,20 @@ function statusIcon(status) {
         default: return '❓';
     }
 }
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/** Parses `--wait=N` (seconds). Returns undefined when the flag is absent. */
+function parseWaitSeconds(args) {
+    const arg = args.find(a => a.startsWith('--wait='));
+    if (arg === undefined)
+        return undefined;
+    const n = Number(arg.slice('--wait='.length));
+    return Number.isFinite(n) && n >= 0 ? n : 0;
+}
 async function handleResult(args) {
     const jsonMode = args.includes('--json');
+    const waitSeconds = parseWaitSeconds(args);
     const taskId = args.find(a => !a.startsWith('--'));
     const repo = new repository_1.TaskRepository();
     if (!taskId) {
@@ -36,21 +54,38 @@ async function handleResult(args) {
             const icon = statusIcon(task.status);
             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))}`);
             if (task.completed_at) {
-                console.log(`   Completed: ${new Date(task.completed_at).toLocaleString()}`);
+                console.log(`   Completed: ${(0, sdk_1.formatDisplayTimestamp)(new Date(task.completed_at))}`);
             }
             console.log('');
         });
         console.log('Tip: Run `crewx result <task-id>` to see full output.');
         return;
     }
-    const task = repo.getTask(taskId);
+    let task = repo.getTask(taskId);
     if (!task) {
         console.error(`Error: Task not found: ${taskId}`);
         process.exit(1);
         return;
     }
+    if (waitSeconds !== undefined && waitSeconds > 0 && task.status === 'running') {
+        const deadline = Date.now() + waitSeconds * 1000;
+        while (task && task.status === 'running') {
+            if (Date.now() >= deadline) {
+                console.error(`Task ${taskId} did not complete within --wait=${waitSeconds}s (status: running).`);
+                process.exit(124);
+                return;
+            }
+            await sleep(Math.min(POLL_INTERVAL_MS, Math.max(0, deadline - Date.now())));
+            task = repo.getTask(taskId);
+            if (!task) {
+                console.error(`Error: Task not found: ${taskId}`);
+                process.exit(1);
+                return;
+            }
+        }
+    }
     if (jsonMode) {
         console.log(JSON.stringify(task, null, 2));
         return;

package/dist/commands/shortcut.d.ts

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

package/dist/commands/shortcut.js

@@ -0,0 +1,267 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleShortcut = handleShortcut;
+/**
+ * crewx shortcut handler — thin CLI wrapper over @crewx/sdk/desktop.
+ *
+ * Usage:
+ *   crewx shortcut status [--json]
+ *   crewx shortcut install [--force] [--json]
+ *   crewx shortcut uninstall [--json]
+ *
+ * All win32/foreign/superseded/force judgment lives in @crewx/sdk/desktop.
+ * This module only parses argv, forwards options, and renders the result.
+ */
+const desktop_1 = require("@crewx/sdk/desktop");
+const parse_common_flags_1 = require("./parse-common-flags");
+const NOT_WINDOWS_MESSAGE = 'NOT_WINDOWS: Desktop shortcuts are only supported on Windows.';
+function parseShortcutFlags(args, allowForce) {
+    let json = false;
+    let force = false;
+    for (const arg of args) {
+        if (arg === '--json') {
+            json = true;
+            continue;
+        }
+        if (arg === '--force' && allowForce) {
+            force = true;
+            continue;
+        }
+        throw new parse_common_flags_1.UnknownOptionError(`Unknown option: ${arg}`);
+    }
+    return { json, force };
+}
+/** Forwarded verbatim to stderr as each SDK phase starts — never buffered. */
+function onProgress(event) {
+    process.stderr.write(`[shortcut] ${event.message}\n`);
+}
+function printJson(payload) {
+    console.log(JSON.stringify(payload));
+}
+/** Prints the error and exits 1. Never returns (matches `process.exit`'s `never` type). */
+function failWithError(err, json) {
+    const message = err instanceof Error ? err.message : String(err);
+    if (json) {
+        printJson({ success: false, error: message });
+    }
+    else {
+        console.error(`✗ ${message}`);
+    }
+    process.exit(1);
+}
+/** The SDK returns `supported:false` (no throw) for install/uninstall on non-Windows. */
+function failNotWindows(json) {
+    if (json) {
+        printJson({ success: false, supported: false, state: 'unsupported', error: NOT_WINDOWS_MESSAGE });
+    }
+    else {
+        console.error(`✗ ${NOT_WINDOWS_MESSAGE}`);
+    }
+    process.exit(1);
+}
+/**
+ * Detects the two ways a resolved (non-thrown) install result must NOT be
+ * read as success: a `superseded` shortcut (checked via both `state` and the
+ * `errors[]` entry, since either alone could otherwise be missed) and an
+ * unconfirmed global install (`installedGlobal:false` with
+ * `GLOBAL_INSTALL_UNCONFIRMED` in errors — npm exited 0 but re-detection
+ * could not confirm it).
+ */
+function installFailureReason(result) {
+    const supersededError = result.errors.find((e) => e.startsWith('SUPERSEDED:'));
+    if (result.state === 'superseded' || supersededError) {
+        return supersededError ?? 'Installed shortcut belongs to a newer CrewX version; refusing to modify it.';
+    }
+    const unconfirmedError = result.errors.find((e) => e.startsWith('GLOBAL_INSTALL_UNCONFIRMED:'));
+    if (!result.installedGlobal && unconfirmedError) {
+        return unconfirmedError;
+    }
+    if (result.errors.length > 0) {
+        return result.errors[0];
+    }
+    return null;
+}
+/**
+ * Only these two re-detected states mean the Desktop truly has no CrewX
+ * shortcut left. Everything else — `foreign`/`superseded` (SDK refused to
+ * touch it) and `installed`/`stale` (the `.lnk` unlink threw and was
+ * swallowed as "already gone" — install.ts `uninstallShortcut`) — means the
+ * file is still on disk. A success ALLOWLIST is used instead of enumerating
+ * failure states so an unlink failure (EPERM/EBUSY/locked/AV hook) that
+ * re-detects back to `installed` fails closed by construction, rather than
+ * requiring every new failure path to be added to an exclusion list.
+ */
+const UNINSTALL_SUCCESS_STATES = new Set(['declined', 'not-installed']);
+function uninstallFailureReason(result) {
+    if (UNINSTALL_SUCCESS_STATES.has(result.state)) {
+        return null;
+    }
+    const supersededError = result.errors.find((e) => e.startsWith('SUPERSEDED:'));
+    if (result.state === 'superseded' || supersededError) {
+        return supersededError ?? 'Installed shortcut belongs to a newer CrewX version; nothing was removed.';
+    }
+    if (result.state === 'foreign') {
+        const nsisError = result.errors.find((e) => e.startsWith('NSIS_PRESENT:'));
+        return nsisError ?? 'Existing Desktop shortcut is not managed by CrewX; nothing was removed.';
+    }
+    if (result.errors.length > 0) {
+        return result.errors[0];
+    }
+    return `CrewX desktop shortcut could not be removed (state: ${result.state}).`;
+}
+function printStatusHuman(status) {
+    switch (status.state) {
+        case 'unsupported':
+            console.log('Desktop shortcuts are only supported on Windows.');
+            break;
+        case 'not-installed':
+            console.log('No CrewX desktop shortcut installed yet.');
+            console.log('Run `crewx shortcut install` to create one.');
+            break;
+        case 'declined':
+            console.log('CrewX desktop shortcut setup was previously dismissed.');
+            console.log('Run `crewx shortcut install` to create one.');
+            break;
+        case 'installed':
+            console.log('✓ CrewX desktop shortcut is installed and up to date.');
+            if (status.shortcutPath)
+                console.log(`  Shortcut: ${status.shortcutPath}`);
+            break;
+        case 'stale':
+            console.log('⚠ CrewX desktop shortcut needs an update.');
+            console.log('Run `crewx shortcut install` to refresh it.');
+            break;
+        case 'foreign':
+            console.log('⚠ A Desktop shortcut exists that CrewX does not manage.');
+            console.log('Run `crewx shortcut install --force` to replace it.');
+            break;
+        case 'superseded':
+            console.log('⚠ The installed shortcut belongs to a newer CrewX version than the one running.');
+            console.log('Update CrewX before touching the shortcut.');
+            break;
+    }
+    for (const e of status.errors) {
+        console.log(`  note: ${e}`);
+    }
+}
+async function runStatus(args) {
+    const { json } = parseShortcutFlags(args, false);
+    let status;
+    try {
+        status = await (0, desktop_1.getShortcutStatus)();
+    }
+    catch (err) {
+        failWithError(err, json);
+    }
+    if (json) {
+        printJson(status);
+        return;
+    }
+    printStatusHuman(status);
+}
+async function runInstall(args) {
+    const { json, force } = parseShortcutFlags(args, true);
+    let result;
+    try {
+        result = await (0, desktop_1.installShortcut)({ force, onProgress });
+    }
+    catch (err) {
+        failWithError(err, json);
+    }
+    if (!result.supported) {
+        failNotWindows(json);
+    }
+    const failure = installFailureReason(result);
+    if (failure) {
+        if (json) {
+            printJson({ ...result, success: false });
+        }
+        else {
+            console.error(`✗ ${failure}`);
+        }
+        process.exit(1);
+    }
+    if (json) {
+        printJson({ ...result, success: true });
+        return;
+    }
+    if (result.changed) {
+        console.log('✓ CrewX desktop shortcut installed. Double-click "CrewX" on your Desktop to launch it.');
+    }
+    else {
+        console.log('✓ CrewX desktop shortcut is already up to date. Double-click "CrewX" on your Desktop to launch it.');
+    }
+    if (result.shortcutPath)
+        console.log(`  Shortcut: ${result.shortcutPath}`);
+}
+async function runUninstall(args) {
+    const { json } = parseShortcutFlags(args, false);
+    let result;
+    try {
+        result = await (0, desktop_1.uninstallShortcut)();
+    }
+    catch (err) {
+        failWithError(err, json);
+    }
+    if (!result.supported) {
+        failNotWindows(json);
+    }
+    const failure = uninstallFailureReason(result);
+    if (failure) {
+        if (json) {
+            printJson({ ...result, success: false });
+        }
+        else {
+            console.error(`✗ ${failure}`);
+            for (const e of result.errors) {
+                if (e !== failure)
+                    console.error(`  note: ${e}`);
+            }
+        }
+        process.exit(1);
+    }
+    if (json) {
+        printJson({ ...result, success: true });
+        return;
+    }
+    console.log('✓ CrewX desktop shortcut removed.');
+}
+function printHelp() {
+    console.log(`
+crewx shortcut — manage the Windows Desktop shortcut for CrewX
+
+Usage:
+  crewx shortcut status [--json]
+  crewx shortcut install [--force] [--json]
+  crewx shortcut uninstall [--json]
+
+Options:
+  --json     Print machine-readable JSON to stdout (progress/log always go to stderr)
+  --force    (install only) Overwrite a Desktop shortcut CrewX does not manage.
+             Never overwrites a shortcut created by a newer CrewX version.
+
+Notes:
+  Windows only. On macOS/Linux, \`status\` reports state "unsupported" (exit 0);
+  \`install\`/\`uninstall\` exit 1 with no changes made.
+`.trim());
+}
+async function handleShortcut(args) {
+    const subcommand = args[0];
+    if (!subcommand || subcommand === 'help' || subcommand === '--help' || subcommand === '-h') {
+        printHelp();
+        return;
+    }
+    const rest = args.slice(1);
+    switch (subcommand) {
+        case 'status':
+            return runStatus(rest);
+        case 'install':
+            return runInstall(rest);
+        case 'uninstall':
+            return runUninstall(rest);
+        default:
+            console.error(`Unknown shortcut subcommand: ${subcommand}`);
+            console.error('Run `crewx shortcut help` for usage.');
+            process.exit(1);
+    }
+}

package/dist/commands/slack.js

@@ -44,6 +44,7 @@ exports.handleSlack = handleSlack;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const https = __importStar(require("https"));
+const sdk_1 = require("@crewx/sdk");
 const adapter_slack_1 = require("@crewx/adapter-slack");
 const crewx_cli_1 = require("../bootstrap/crewx-cli");
 const markdown_1 = require("../slack/markdown");
@@ -186,7 +187,7 @@ async function handleListFiles(threadId) {
             console.log(`  📎 ${file.fileName}`);
             console.log(`     Size: ${formatFileSize(file.fileSize)}`);
             console.log(`     Path: ${file.filePath}`);
-            console.log(`     Downloaded: ${file.downloadedAt.toLocaleString()}`);
+            console.log(`     Downloaded: ${(0, sdk_1.formatDisplayTimestamp)(file.downloadedAt)}`);
             console.log('');
         }
         console.log(`Total: ${files.length} file${files.length > 1 ? 's' : ''}\n`);

package/dist/commands/write-output.d.ts

@@ -0,0 +1,3 @@
+export declare function writeResult(out: string | undefined, data: string): void;
+/** On failure: if out is specified, append to file (avoid empty file). stderr is kept by the caller. */
+export declare function appendError(out: string | undefined, message: string): void;

package/dist/commands/write-output.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeResult = writeResult;
+exports.appendError = appendError;
+/**
+ * EPIPE-safe result output.
+ * - out specified: write success result to file (sync, no stream EPIPE)
+ * - out not specified: fall back to existing stdout (console.log)
+ */
+const fs_1 = require("fs");
+function writeResult(out, data) {
+    if (out) {
+        (0, fs_1.writeFileSync)(out, data, 'utf8');
+    }
+    else {
+        console.log(data);
+    }
+}
+/** On failure: if out is specified, append to file (avoid empty file). stderr is kept by the caller. */
+function appendError(out, message) {
+    if (out) {
+        (0, fs_1.appendFileSync)(out, message.endsWith('\n') ? message : message + '\n', 'utf8');
+    }
+}

package/dist/logging.d.ts

@@ -9,7 +9,7 @@
  *
  * Format mirrors cli-bak TaskManagementService for backward compatibility.
  */
-import type { Crewx } from '@crewx/sdk';
+import { type Crewx } from '@crewx/sdk';
 /**
  * Attach file-based logging to a Crewx instance.
  * Subscribes to task:start and task:end events and writes log files.

package/dist/logging.js

@@ -14,6 +14,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.attachFileLogger = attachFileLogger;
 const fs_1 = require("fs");
 const path_1 = require("path");
+const sdk_1 = require("@crewx/sdk");
 const CREWX_VERSION = '0.9.0-alpha.1';
 /** Format Date as YYYYMMDDTHHmmss (local time) */
 function formatTimestamp(date) {
@@ -52,7 +53,7 @@ function attachFileLogger(crewx, workspaceRoot) {
                 `CrewX Version: ${CREWX_VERSION}\n` +
                 `Mode: ${event.mode}\n` +
                 `Agent: ${event.agentRef}\n` +
-                `Started: ${event.timestamp.toLocaleString()}\n` +
+                `Started: ${(0, sdk_1.formatDisplayTimestamp)(event.timestamp)}\n` +
                 `Message: ${event.message}\n` +
                 `\n`;
             (0, fs_1.writeFileSync)(logFile, header, { encoding: 'utf8', mode: 0o600 });
@@ -66,7 +67,7 @@ function attachFileLogger(crewx, workspaceRoot) {
             const logFile = logFiles.get(event.traceId);
             if (!logFile)
                 return;
-            const ts = new Date().toLocaleString();
+            const ts = (0, sdk_1.formatDisplayTimestamp)(new Date());
             const status = event.error
                 ? `failed: ${event.error.message}`
                 : 'completed successfully';

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 .env (does not override existing process.env values)
+ *   3. Parse command
+ *   4. Dispatch to handler
  */
 export {};