@crewx/cli 0.9.0-rc.5 → 0.9.0-rc.51

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/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/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 {};

package/dist/main.js

@@ -6,8 +6,9 @@
  *
  * 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
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
@@ -45,9 +46,21 @@ var __importStar = (this && this.__importStar) || (function () {
 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)();
+const sdk_compat_1 = require("./utils/sdk-compat");
+const dotenv = __importStar(require("dotenv"));
+const path_1 = require("path");
+process.env.CREWX_CLI ??= sdk_compat_1.sdkCompat.resolveCrewxCli();
+process.env.CREWX_WORKSPACE ??= sdk_compat_1.sdkCompat.resolveCrewxWorkspace();
+// Load the workspace .env (WI-20260725-010): keeps CLI (crewx q/x) in parity with
+// the server's ConfigModule, which already reads cwd/.env. override:false so a
+// value already present in the shell/environment always wins over the file.
+// quiet:true suppresses dotenv's injected-keys log and tip banner on stdout.
+dotenv.config({ path: (0, path_1.join)(process.env.CREWX_WORKSPACE, '.env'), override: false, quiet: true });
+// ─── Pricing remote override (WI-20260701-002) ───────────────────────────────
+// Best-effort, non-blocking: fetch remote model registry so new models get
+// accurate pricing without a CLI republish. Falls back to bundled table on
+// failure / offline. Browser entry does not call this automatically.
+sdk_compat_1.sdkCompat.initPricingRemote();
 // ─── Command Imports ──────────────────────────────────────────────────────────
 const query_1 = require("./commands/query");
 const execute_1 = require("./commands/execute");
@@ -59,6 +72,8 @@ 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 shortcut_1 = require("./commands/shortcut");
+const publish_1 = require("./commands/publish");
 const builtin_1 = require("./builtin");
 const slack_1 = require("./commands/slack");
 const install_1 = require("./commands/hook/install");
@@ -175,6 +190,14 @@ async function main() {
         case 'db':
             await (0, db_1.handleDb)(args.slice(1));
             return;
+        // Windows Desktop shortcut: crewx shortcut status|install|uninstall
+        case 'shortcut':
+            await (0, shortcut_1.handleShortcut)(args.slice(1));
+            return;
+        // WI-20260803-004: crewx publish [dir] [--dry-run] [--version <semver>] [--json]
+        case 'publish':
+            await (0, publish_1.handlePublish)(args.slice(1));
+            return;
         // SDK-009: slack / slack:files
         case 'slack':
         case 'slack:files':
@@ -256,12 +279,19 @@ 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)
     --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
 
+  x/execute only:
+    --detach                     Re-spawn as a detached background runner; print task-id
+                                 and exit 0 immediately. Ignored if CREWX_TRACE_ID is
+                                 already set (recursive-spawn guard). Unsupported on win32.
+                                 e.g. crewx x "@agent label" --detach
+
 Agent Management:
   agent ls [options]             List configured agents
     --role <value>               Filter by role (comma-separated for OR match)
@@ -274,6 +304,8 @@ Task Management:
   kill <task-id>                 Kill a running task
   kill --all                     Kill all running tasks
   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:
@@ -286,6 +318,18 @@ Database:
     --force                      Reset migration history + skip confirmation
     --dry-run                    Preview changes without applying
 
+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
+    (marketplace upload is not yet supported by this command)
+
 Built-in Tools:
   memory <args>                  Memory tool
   search <args>                  Search tool

package/dist/utils/env-defaults.d.ts

@@ -1,5 +1,2 @@
-/**
- * CREWX_* environment variable defaults for CLI bootstrap.
- * Re-exported from @crewx/sdk for convenience.
- */
-export { resolveCrewxCli, resolveCrewxWorkspace } from '@crewx/sdk';
+export declare function resolveCrewxCli(): string;
+export declare function resolveCrewxWorkspace(): string;

package/dist/utils/env-defaults.js

@@ -1,10 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveCrewxWorkspace = exports.resolveCrewxCli = void 0;
+exports.resolveCrewxCli = resolveCrewxCli;
+exports.resolveCrewxWorkspace = resolveCrewxWorkspace;
 /**
  * CREWX_* environment variable defaults for CLI bootstrap.
- * Re-exported from @crewx/sdk for convenience.
+ * Routed through the SDK compatibility accessor for older SDK installations.
  */
-var sdk_1 = require("@crewx/sdk");
-Object.defineProperty(exports, "resolveCrewxCli", { enumerable: true, get: function () { return sdk_1.resolveCrewxCli; } });
-Object.defineProperty(exports, "resolveCrewxWorkspace", { enumerable: true, get: function () { return sdk_1.resolveCrewxWorkspace; } });
+const sdk_compat_1 = require("./sdk-compat");
+function resolveCrewxCli() {
+    return sdk_compat_1.sdkCompat.resolveCrewxCli();
+}
+function resolveCrewxWorkspace() {
+    return sdk_compat_1.sdkCompat.resolveCrewxWorkspace();
+}

package/dist/utils/sdk-compat.d.ts

@@ -0,0 +1,21 @@
+type PricingInitializer = () => Promise<unknown> | unknown;
+export interface SdkLike {
+    resolveCrewxCli?: () => string;
+    resolveCrewxWorkspace?: () => string;
+    initPricingRemote?: PricingInitializer;
+}
+export interface SdkCompat {
+    resolveCrewxCli(): string;
+    resolveCrewxWorkspace(): string;
+    initPricingRemote(): void;
+}
+/**
+ * Create the CLI bootstrap capability accessor for the installed SDK.
+ *
+ * SDK exports are additive across compatible majors, so an older SDK may not
+ * expose every capability that a newer CLI knows about. Optional capabilities
+ * are checked here rather than at each bootstrap call site.
+ */
+export declare function createSdkCompat(sdkLike?: SdkLike): SdkCompat;
+export declare const sdkCompat: SdkCompat;
+export {};

package/dist/utils/sdk-compat.js

@@ -0,0 +1,72 @@
+"use strict";
+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.sdkCompat = void 0;
+exports.createSdkCompat = createSdkCompat;
+const sdk = __importStar(require("@crewx/sdk"));
+/**
+ * Create the CLI bootstrap capability accessor for the installed SDK.
+ *
+ * SDK exports are additive across compatible majors, so an older SDK may not
+ * expose every capability that a newer CLI knows about. Optional capabilities
+ * are checked here rather than at each bootstrap call site.
+ */
+function createSdkCompat(sdkLike = sdk) {
+    return {
+        resolveCrewxCli: () => {
+            if (typeof sdkLike.resolveCrewxCli === 'function') {
+                return sdkLike.resolveCrewxCli();
+            }
+            return process.env.CREWX_CLI || 'npx crewx';
+        },
+        resolveCrewxWorkspace: () => {
+            if (typeof sdkLike.resolveCrewxWorkspace === 'function') {
+                return sdkLike.resolveCrewxWorkspace();
+            }
+            return process.env.CREWX_WORKSPACE || process.cwd();
+        },
+        initPricingRemote: () => {
+            if (typeof sdkLike.initPricingRemote !== 'function')
+                return;
+            try {
+                void Promise.resolve(sdkLike.initPricingRemote()).catch(() => undefined);
+            }
+            catch {
+                // Remote pricing is optional and must not block CLI startup.
+            }
+        },
+    };
+}
+exports.sdkCompat = createSdkCompat();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crewx/cli",
-  "version": "0.9.0-rc.5",
+  "version": "0.9.0-rc.51",
   "license": "UNLICENSED",
   "engines": {
     "node": ">=20.19.0"
@@ -23,18 +23,20 @@
   "dependencies": {
     "@crewx/adapter-slack": "0.1.4",
     "better-sqlite3": "*",
+    "dotenv": "17.2.3",
     "isomorphic-git": "1.37.1",
-    "@crewx/doc": "0.1.9",
-    "@crewx/sdk": "0.9.0-rc.5",
-    "@crewx/search": "0.1.10",
-    "@crewx/workflow": "0.3.22-rc.51",
+    "@crewx/sdk": "0.9.0-rc.51",
+    "@crewx/memory": "0.1.23-rc.67",
+    "@crewx/search": "0.1.10-rc.46",
+    "@crewx/doc": "0.1.9-rc.43",
+    "@crewx/cron": "0.1.10-rc.85",
+    "@crewx/workflow": "0.3.22-rc.97",
     "@crewx/skill": "0.1.20",
-    "@crewx/cron": "0.1.10",
-    "@crewx/chromex": "0.1.0",
+    "@crewx/wi": "0.1.10-rc.71",
     "@crewx/shared": "0.0.6",
-    "@crewx/wbs": "0.1.10",
-    "@crewx/wi": "0.1.10",
-    "@crewx/memory": "0.1.23"
+    "@crewx/notify": "0.1.0-rc.21",
+    "@crewx/wbs": "0.1.10-rc.76",
+    "@crewx/chromex": "0.1.0-rc.83"
   },
   "devDependencies": {
     "@types/better-sqlite3": "*",