crewx 0.8.1 → 0.8.2-rc.2

package/packages/cli/dist/main.js

@@ -9,6 +9,39 @@
  *   2. Parse command
  *   3. Dispatch to handler
  */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 // ─── P0-1: Env Bootstrap ─────────────────────────────────────────────────────
 // Must run before any other code that might use process.env.CREWX_CLI.
@@ -31,15 +64,36 @@ const install_1 = require("./commands/hook/install");
 const uninstall_1 = require("./commands/hook/uninstall");
 const status_1 = require("./commands/hook/status");
 const hook_dispatch_1 = require("./commands/hook-dispatch");
+const parse_common_flags_1 = require("./commands/parse-common-flags");
+const registry_1 = require("./commands/registry");
 const version_1 = require("./utils/version");
-// Commands deferred to future rounds
-const NOT_YET_MIGRATED = new Set([
-    'template',
-    'templates',
-    'chat',
-    'mcp',
-]);
+/**
+ * Dev-only SSOT assertion: bin/cli-commands.js must be the exact union of
+ * KNOWN_COMMANDS ∪ BUILTIN_COMMAND_NAMES ∪ NOT_YET_MIGRATED from registry.ts.
+ * Throws on drift so the discrepancy is caught immediately during development.
+ */
+async function assertSsotParity() {
+    const { join } = await Promise.resolve().then(() => __importStar(require('path')));
+    const { createRequire } = await Promise.resolve().then(() => __importStar(require('module')));
+    // Use createRequire(__filename) + plain path to avoid TypeScript compiling import() → require()
+    // in the CJS dist. Node.js 22.12+ supports require(esm), so this loads ESM cli-commands.js fine.
+    const req = createRequire(__filename);
+    const cliCommandsPath = join(__dirname, '../../../bin/cli-commands.js');
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const { CLI_SUBCOMMANDS } = req(cliCommandsPath);
+    const union = new Set([...registry_1.KNOWN_COMMANDS, ...registry_1.BUILTIN_COMMAND_NAMES, ...registry_1.NOT_YET_MIGRATED]);
+    const missing = [...union].filter((c) => !CLI_SUBCOMMANDS.has(c));
+    const extra = [...CLI_SUBCOMMANDS].filter((c) => !union.has(c));
+    if (missing.length > 0 || extra.length > 0) {
+        throw new Error(`[crewx dev] SSOT drift detected!\n` +
+            (missing.length ? `  registry has, CLI_SUBCOMMANDS missing: ${missing.join(', ')}\n` : '') +
+            (extra.length ? `  CLI_SUBCOMMANDS has, registry missing: ${extra.join(', ')}` : ''));
+    }
+}
 async function main() {
+    if (process.env['NODE_ENV'] === 'development') {
+        await assertSsotParity();
+    }
     const args = process.argv.slice(2);
     const command = args[0];
     if (!command) {
@@ -131,7 +185,7 @@ async function main() {
         }
     }
     // Not yet migrated commands (SDK-009)
-    if (NOT_YET_MIGRATED.has(command)) {
+    if (registry_1.NOT_YET_MIGRATED.has(command)) {
         console.error(`Command '${command}' is not yet migrated in SDK refactor round. ` +
             'See packages/cli-bak for reference.');
         process.exit(1);
@@ -162,68 +216,80 @@ async function main() {
     process.exit(1);
 }
 function printHelp() {
-    console.log(`
-CrewX CLI v${version_1.CLI_VERSION}
-
-Usage:
-  crewx <command> [options]
-
-Query / Execute:
-  q|query "@agent <message>"     Query an agent (quoted single string)
-  x|execute "@agent <task>"      Execute a task with an agent (quoted single string)
-
-  @agent is optional — defaults to @crewx when omitted.
-
-  Common flags:
-    --thread <name>              Conversation thread
-    --provider <cli/xxx>         Provider override
-    --metadata <json>            Extra metadata (JSON object, double-quoted). Propagated to events/hooks/tracing.
-                                 Invalid JSON aborts with exit code 2.
-                                 e.g. --metadata='{"workflow_id":"wf-1"}'
-    --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)
-    --effort <level>             Model effort (high|medium|low)
-
-Agent Management:
-  agent ls [options]             List configured agents
-    --role <value>               Filter by role (comma-separated for OR match)
-    --team <value>               Filter by team (comma-separated for OR match)
-    --provider <value>           Filter by provider (comma-separated for OR match)
-  agent prompt <@id>             Show rendered system prompt for an agent
-
-Task Management:
-  ps                             List running tasks
-  kill <task-id>                 Kill a running task
-  kill --all                     Kill all running tasks
-  result [task-id]               Get task result (or list recent tasks)
-
-Logs & Diagnostics:
-  log [ls|<task-id>]             View task logs
-  doctor [--config <path>]       Run system diagnosis
-  init [--force] [--config <p>]  Initialize crewx.yaml
-
-Built-in Tools:
-  memory <args>                  Memory tool
-  search <args>                  Search tool
-  doc <args>                     Doc tool
-  wbs <args>                     WBS tool
-  cron <args>                    Cron tool
-  workflow <args>                Workflow tool
-  skill <args>                   Skill tool
-
-Hook Platform:
-  hook install [--yes]           Install PreToolUse hook in .claude/settings.json
-  hook uninstall                 Remove crewx hook from .claude/settings.json
-  hook status                    Show hook installation status and plugins
-  hook-dispatch                  Internal: IPC router called by Claude (stdin→stdout)
-
-Global Options:
-  --help, -h                     Show this help
-  --version, -v                  Show version
+    console.log(`
+CrewX CLI v${version_1.CLI_VERSION}
+
+Usage:
+  crewx                          Launch web dashboard + open browser (default)
+  crewx <command> [options]
+
+UI Modes:
+  crewx                          Web dashboard (port 8150, random token, auto-open)
+  crewx serve [options]          Web server (explicit)
+    --port <N>                   Port (default: 8150)
+    --token <T>                  MCP bearer token (⚠️  use --token-file in shared shells)
+    --token-file <PATH>          Read bearer token from file
+    --no-open                    Do not auto-open browser
+  crewx electron [--overlay]     Launch Electron (desktop or overlay window)
+
+Query / Execute:
+  q|query "@agent <message>"     Query an agent (quoted single string)
+  x|execute "@agent <task>"      Execute a task with an agent (quoted single string)
+
+  @agent is optional — defaults to @crewx when omitted.
+
+  Common flags:
+    --thread <name>              Conversation thread
+    --provider <cli/xxx>         Provider override
+    --metadata <json>            Extra metadata (JSON object, double-quoted). Propagated to events/hooks/tracing.
+                                 Invalid JSON aborts with exit code 2.
+                                 e.g. --metadata='{"workflow_id":"wf-1"}'
+    --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)
+    --effort <level>             Model effort (high|medium|low)
+    --                           End of flags; remaining tokens treated as message text
+                                 e.g. crewx q "@agent label" -- --flag-in-message
+
+Agent Management:
+  agent ls [options]             List configured agents
+    --role <value>               Filter by role (comma-separated for OR match)
+    --team <value>               Filter by team (comma-separated for OR match)
+    --provider <value>           Filter by provider (comma-separated for OR match)
+  agent prompt <@id>             Show rendered system prompt for an agent
+
+Task Management:
+  ps                             List running tasks
+  kill <task-id>                 Kill a running task
+  kill --all                     Kill all running tasks
+  result [task-id]               Get task result (or list recent tasks)
+
+Logs & Diagnostics:
+  log [ls|<task-id>]             View task logs
+  doctor [--config <path>]       Run system diagnosis
+  init [--force] [--config <p>]  Initialize crewx.yaml
+
+Built-in Tools:
+  memory <args>                  Memory tool
+  search <args>                  Search tool
+  doc <args>                     Doc tool
+  wbs <args>                     WBS tool
+  cron <args>                    Cron tool
+  workflow <args>                Workflow tool
+  skill <args>                   Skill tool
+
+Hook Platform:
+  hook install [--yes]           Install PreToolUse hook in .claude/settings.json
+  hook uninstall                 Remove crewx hook from .claude/settings.json
+  hook status                    Show hook installation status and plugins
+  hook-dispatch                  Internal: IPC router called by Claude (stdin→stdout)
+
+Global Options:
+  --help, -h                     Show this help
+  --version, -v                  Show version
 `.trim());
 }
 main().catch((err) => {
     console.error(err instanceof Error ? err.message : String(err));
-    process.exit(1);
+    process.exit(err instanceof parse_common_flags_1.UnknownOptionError ? 2 : 1);
 });

package/packages/cli/dist/plugins/examples/echo-hook.d.ts

@@ -0,0 +1,24 @@
+/**
+ * EchoObserverPlugin — Tool observer that echoes events to a JSONL log.
+ *
+ * Observes tool:before / tool:after events from the Crewx event bus
+ * and appends them as JSONL to ~/.crewx/logs/echo-hook.log.
+ * Pure observer — no flow control (deny/inject/modify not applicable).
+ */
+import { ToolObserverPlugin } from '@crewx/sdk/hooks';
+import type { ObserverContext, ObserverResult } from '@crewx/sdk/hooks';
+export declare class EchoHookPlugin extends ToolObserverPlugin {
+    readonly name = "echo-hook";
+    readonly version = "0.0.1";
+    readonly on: {
+        beforeTool: true;
+        afterTool: true;
+        beforePrompt: true;
+        sessionStart: true;
+    };
+    private readonly logPath;
+    constructor(logDir?: string);
+    run(ctx: ObserverContext): Promise<ObserverResult>;
+    private ensureLogDir;
+    private echo;
+}

package/packages/cli/dist/plugins/examples/echo-hook.js

@@ -0,0 +1,60 @@
+"use strict";
+/**
+ * EchoObserverPlugin — Tool observer that echoes events to a JSONL log.
+ *
+ * Observes tool:before / tool:after events from the Crewx event bus
+ * and appends them as JSONL to ~/.crewx/logs/echo-hook.log.
+ * Pure observer — no flow control (deny/inject/modify not applicable).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EchoHookPlugin = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const os_1 = require("os");
+const hooks_1 = require("@crewx/sdk/hooks");
+class EchoHookPlugin extends hooks_1.ToolObserverPlugin {
+    name = 'echo-hook';
+    version = '0.0.1';
+    on = {
+        beforeTool: true,
+        afterTool: true,
+        beforePrompt: true,
+        sessionStart: true,
+    };
+    logPath;
+    constructor(logDir) {
+        super();
+        this.logPath = (0, path_1.join)(logDir ?? (0, os_1.homedir)(), '.crewx', 'logs', 'echo-hook.log');
+        this.ensureLogDir();
+    }
+    async run(ctx) {
+        this.echo(ctx);
+        return ctx.pass();
+    }
+    ensureLogDir() {
+        const dir = (0, path_1.dirname)(this.logPath);
+        if (!(0, fs_1.existsSync)(dir)) {
+            (0, fs_1.mkdirSync)(dir, { recursive: true, mode: 0o700 });
+        }
+    }
+    echo(ctx) {
+        try {
+            const line = JSON.stringify({
+                timestamp: new Date().toISOString(),
+                event: ctx.event,
+                traceId: ctx.traceId,
+                agent: ctx.agent,
+                provider: ctx.provider,
+                thread: ctx.thread,
+                tool: ctx.tool,
+                cwd: ctx.cwd,
+                sessionId: ctx.sessionId,
+            });
+            (0, fs_1.appendFileSync)(this.logPath, line + '\n', { encoding: 'utf8', mode: 0o600 });
+        }
+        catch {
+            // Non-fatal
+        }
+    }
+}
+exports.EchoHookPlugin = EchoHookPlugin;

package/packages/cli/dist/plugins/examples/verify-echo-hook.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env npx tsx
+/**
+ * Phase 0 e2e verification — EchoHookPlugin logs Claude Code tool calls.
+ *
+ * Run: npx tsx packages/cli/src/plugins/examples/verify-echo-hook.ts
+ * Prereq: claude CLI installed, crewx.yaml with @claude agent
+ */
+export {};

package/packages/cli/dist/plugins/examples/verify-echo-hook.js

@@ -0,0 +1,47 @@
+#!/usr/bin/env npx tsx
+"use strict";
+/**
+ * Phase 0 e2e verification — EchoHookPlugin logs Claude Code tool calls.
+ *
+ * Run: npx tsx packages/cli/src/plugins/examples/verify-echo-hook.ts
+ * Prereq: claude CLI installed, crewx.yaml with @claude agent
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const sdk_1 = require("@crewx/sdk");
+const echo_hook_1 = require("./echo-hook");
+const fs_1 = require("fs");
+const path_1 = require("path");
+const os_1 = require("os");
+const LOG_PATH = (0, path_1.join)((0, os_1.homedir)(), '.crewx', 'logs', 'echo-hook.log');
+async function main() {
+    if ((0, fs_1.existsSync)(LOG_PATH))
+        (0, fs_1.unlinkSync)(LOG_PATH);
+    const crewx = await sdk_1.Crewx.loadYaml('crewx.yaml');
+    await crewx.use(new echo_hook_1.EchoHookPlugin());
+    console.log('[verify] querying @claude with "ls"...');
+    await crewx.query('@claude', 'Run ls in the current directory. Use the Bash tool.');
+    await crewx.close();
+    if (!(0, fs_1.existsSync)(LOG_PATH)) {
+        console.error('[FAIL] echo-hook.log not created');
+        process.exit(1);
+    }
+    const lines = (0, fs_1.readFileSync)(LOG_PATH, 'utf8').trim().split('\n');
+    const entries = lines.map((l) => JSON.parse(l));
+    const hasBeforeTool = entries.some((e) => e.event === 'beforeTool');
+    const hasTraceId = entries.every((e) => e.traceId?.startsWith('tsk_'));
+    const hasToolName = entries
+        .filter((e) => e.event === 'beforeTool')
+        .every((e) => typeof e.tool?.rawName === 'string' && e.tool.rawName.length > 0);
+    console.log(`[verify] entries: ${entries.length}`);
+    console.log(`[verify] beforeTool: ${hasBeforeTool}`);
+    console.log(`[verify] traceId:    ${hasTraceId}`);
+    console.log(`[verify] toolName:   ${hasToolName}`);
+    if (hasBeforeTool && hasTraceId && hasToolName) {
+        console.log('[PASS] Phase 0 e2e verification passed');
+    }
+    else {
+        console.error('[FAIL] Some checks failed');
+        process.exit(1);
+    }
+}
+main().catch((err) => { console.error(err); process.exit(1); });

package/packages/cli/dist/plugins/sqlite-tracing.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Re-export of SqliteTracingPlugin with a CLI-friendly constructor that
+ * accepts a plain dbRoot string (in addition to the SDK's options-object form).
+ */
+import { SqliteTracingPlugin as SdkSqliteTracingPlugin } from '@crewx/sdk/plugins';
+export declare class SqliteTracingPlugin extends SdkSqliteTracingPlugin {
+    constructor(dbRootOrOpts?: string | {
+        dbRoot?: string;
+        version?: string;
+    });
+}

package/packages/cli/dist/plugins/sqlite-tracing.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SqliteTracingPlugin = void 0;
+/**
+ * Re-export of SqliteTracingPlugin with a CLI-friendly constructor that
+ * accepts a plain dbRoot string (in addition to the SDK's options-object form).
+ */
+const plugins_1 = require("@crewx/sdk/plugins");
+class SqliteTracingPlugin extends plugins_1.SqliteTracingPlugin {
+    constructor(dbRootOrOpts) {
+        if (typeof dbRootOrOpts === 'string') {
+            super({ dbRoot: dbRootOrOpts });
+        }
+        else {
+            super(dbRootOrOpts);
+        }
+    }
+}
+exports.SqliteTracingPlugin = SqliteTracingPlugin;

package/packages/cli/dist/schema/tasks.d.ts

@@ -0,0 +1,7 @@
+import type BetterSqlite3 from 'better-sqlite3';
+/**
+ * Ensure the `tasks` table exists in the given database.
+ * Safe to call multiple times — CREATE TABLE IF NOT EXISTS is idempotent.
+ * Owns the canonical schema for the CLI-side tasks table.
+ */
+export declare function ensureTasksSchema(db: InstanceType<typeof BetterSqlite3>): void;

package/packages/cli/dist/schema/tasks.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureTasksSchema = ensureTasksSchema;
+/**
+ * Ensure the `tasks` table exists in the given database.
+ * Safe to call multiple times — CREATE TABLE IF NOT EXISTS is idempotent.
+ * Owns the canonical schema for the CLI-side tasks table.
+ */
+function ensureTasksSchema(db) {
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS tasks (
+      id                    TEXT PRIMARY KEY,
+      agent_id              TEXT,
+      user_id               TEXT,
+      prompt                TEXT,
+      mode                  TEXT,
+      status                TEXT NOT NULL,
+      result                TEXT,
+      error                 TEXT,
+      started_at            TEXT NOT NULL,
+      completed_at          TEXT,
+      duration_ms           INTEGER,
+      metadata              TEXT,
+      project_id            TEXT,
+      project_name          TEXT,
+      trace_id              TEXT,
+      parent_task_id        TEXT,
+      caller_agent_id       TEXT,
+      model                 TEXT,
+      platform              TEXT,
+      crewx_version         TEXT,
+      input_tokens          INTEGER DEFAULT 0,
+      output_tokens         INTEGER DEFAULT 0,
+      cost_usd              REAL,
+      pid                   INTEGER,
+      rendered_prompt       TEXT,
+      command               TEXT,
+      coding_agent_command  TEXT,
+      exit_code             INTEGER,
+      logs                  TEXT,
+      thread_id             TEXT,
+      project_ref           TEXT,
+      workspace_id          TEXT,
+      workspace_name        TEXT,
+      cached_input_tokens   INTEGER DEFAULT 0
+    )
+  `);
+}

package/packages/cli/package.json

@@ -1,52 +1,52 @@
-{
-  "name": "@crewx/cli",
-  "version": "0.8.1",
-  "license": "UNLICENSED",
-  "engines": {
-    "node": ">=20.19.0"
-  },
-  "description": "CrewX CLI — thin wrapper over @crewx/sdk",
-  "type": "commonjs",
-  "main": "dist/main.js",
-  "types": "dist/index.d.ts",
-  "exports": {
-    ".": {
-      "require": "./dist/index.js",
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
-    }
-  },
-  "bin": {
-    "crewx": "bin/crewx"
-  },
-  "files": [
-    "dist",
-    "bin",
-    "README.md"
-  ],
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "test": "vitest run --config ./vitest.config.ts",
-    "test:watch": "vitest --config ./vitest.config.ts",
-    "lint": "echo 'CLI lint pending' && exit 0"
-  },
-  "dependencies": {
-    "@crewx/sdk": "workspace:*",
-    "@crewx/memory": "workspace:*",
-    "@crewx/search": "workspace:*",
-    "@crewx/doc": "workspace:*",
-    "@crewx/wbs": "workspace:*",
-    "@crewx/cron": "workspace:*",
-    "@crewx/workflow": "workspace:*",
-    "@crewx/skill": "workspace:*",
-    "@crewx/shared": "workspace:*",
-    "@crewx/adapter-slack": "^0.1.4",
-    "better-sqlite3": "*"
-  },
-  "devDependencies": {
-    "@types/better-sqlite3": "*",
-    "@types/node": "^22.0.0",
-    "typescript": "^5.4.0",
-    "vitest": "^3.1.1"
-  }
-}
+{
+  "name": "@crewx/cli",
+  "version": "0.8.2-rc.2",
+  "license": "UNLICENSED",
+  "engines": {
+    "node": ">=20.19.0"
+  },
+  "description": "CrewX CLI — thin wrapper over @crewx/sdk",
+  "type": "commonjs",
+  "main": "dist/main.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "require": "./dist/index.js",
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "bin": {
+    "crewx": "bin/crewx"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run --config ./vitest.config.ts",
+    "test:watch": "vitest --config ./vitest.config.ts",
+    "lint": "echo 'CLI lint pending' && exit 0"
+  },
+  "dependencies": {
+    "@crewx/sdk": "workspace:*",
+    "@crewx/memory": "workspace:*",
+    "@crewx/search": "workspace:*",
+    "@crewx/doc": "workspace:*",
+    "@crewx/wbs": "workspace:*",
+    "@crewx/cron": "workspace:*",
+    "@crewx/workflow": "workspace:*",
+    "@crewx/skill": "workspace:*",
+    "@crewx/shared": "workspace:*",
+    "@crewx/adapter-slack": "^0.1.4",
+    "better-sqlite3": "*"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "*",
+    "@types/node": "^22.0.0",
+    "typescript": "^5.4.0",
+    "vitest": "^3.1.1"
+  }
+}