@crewx/cli 0.9.0-rc.16 → 0.9.0-rc.161

package/dist/bootstrap/codex-writable-roots.d.ts

@@ -33,10 +33,29 @@ export declare function escapeTomlBasicString(value: string): string;
  * Works for both `codex exec` and `codex exec resume` (config-override form).
  */
 export declare function buildCodexWritableRootArgs(crewxHome: string): string[];
+/**
+ * Create an `AdditionalArgsProvider` that skips Codex's git repository trust
+ * check for a resolved workspace.
+ *
+ * The workspace is resolved by the product layer, so an unavailable workspace
+ * must not fall back to the host cwd. The flag is independent of execution
+ * mode because it controls repository trust rather than filesystem access.
+ */
+export declare function createCodexSkipGitRepoCheckProvider(workspaceRoot: string | undefined): AdditionalArgsProvider;
+/**
+ * Compose product-layer argument providers while preserving their order.
+ */
+export declare function composeAdditionalArgsProviders(...providers: AdditionalArgsProvider[]): AdditionalArgsProvider;
 /**
  * Create an `AdditionalArgsProvider` (SDK extension point, WI-20260703-001)
  * that injects CrewX home as a Codex writable root for `workspace-write`
- * equivalent modes (`agent`, `auto`, `undefined`).
+ * equivalent modes (`agent`, `auto`, `undefined`). Only explicit `agent`
+ * also receives a permission profile allowing localhost network access and
+ * writes to the same CrewX home. `auto`/`undefined` keep their existing policy.
+ *
+ * All overrides use `-c`, supported by both `exec` and `exec resume`. Keep
+ * writable_roots for older Codex versions that ignore permission profiles
+ * and fall back to the closed workspace-write sandbox. No version gate.
  *
  * No-ops for:
  *   - Non-codex providers.

package/dist/bootstrap/codex-writable-roots.js

@@ -1,88 +1 @@
-"use strict";
-/**
- * CLI-layer policy: inject CrewX home as an extra writable root for Codex
- * `workspace-write` sandbox invocations.
- *
- * Why this lives in packages/cli (not packages/sdk):
- * CrewX home (`~/.crewx` by default) is a product-specific path. The SDK's
- * `additionalArgsProvider` extension point (WI-20260703-001) exists precisely
- * so that product layers like this CLI can inject such paths without the SDK
- * knowing about them.
- *
- * Why `-c sandbox_workspace_write.writable_roots=[...]` instead of `--add-dir`:
- * Verified against codex-cli 0.139.0 (`codex exec --help` / `codex exec resume --help`):
- *   - `codex exec` supports `--add-dir <DIR>`.
- *   - `codex exec resume` does NOT support `--add-dir` (only `-c/--config`).
- * Using the `-c` config-override form works identically for both `exec` and
- * `exec resume`, avoiding a resume-incompatible flag.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveCrewxHome = resolveCrewxHome;
-exports.escapeTomlBasicString = escapeTomlBasicString;
-exports.buildCodexWritableRootArgs = buildCodexWritableRootArgs;
-exports.createCodexWritableRootsProvider = createCodexWritableRootsProvider;
-const os_1 = require("os");
-const path_1 = require("path");
-/**
- * crewx.yaml / query-option `mode` values for which Codex is NOT running in
- * (or being pushed into) a `workspace-write`-equivalent sandbox. Injecting an
- * extra writable root is meaningless (read-only/plan) or redundant
- * (full-access variants already allow writes everywhere) in these modes.
- */
-const NO_INJECT_MODES = new Set([
-    'read-only',
-    'plan',
-    'agent-full-access',
-    'yolo',
-    'danger-full-access',
-]);
-/**
- * Resolve CrewX home directory.
- * Priority: `CREWX_HOME` env var → `~/.crewx`.
- */
-function resolveCrewxHome() {
-    return process.env.CREWX_HOME ?? (0, path_1.join)((0, os_1.homedir)(), '.crewx');
-}
-/**
- * Escape a string for embedding inside a TOML basic string (`"..."`).
- * Sufficient for filesystem paths: handles backslash (Windows paths),
- * double-quote, and control characters that could otherwise break TOML
- * parsing of the `-c key="value"` override.
- */
-function escapeTomlBasicString(value) {
-    return value
-        .replace(/\\/g, '\\\\')
-        .replace(/"/g, '\\"')
-        .replace(/\n/g, '\\n')
-        .replace(/\r/g, '\\r')
-        .replace(/\t/g, '\\t');
-}
-/**
- * Build the `-c sandbox_workspace_write.writable_roots=["<path>"]` arg pair.
- * Works for both `codex exec` and `codex exec resume` (config-override form).
- */
-function buildCodexWritableRootArgs(crewxHome) {
-    const escaped = escapeTomlBasicString(crewxHome);
-    return ['-c', `sandbox_workspace_write.writable_roots=["${escaped}"]`];
-}
-function isCodexProvider(ctx) {
-    return ctx.providerId === 'codex' || ctx.providerStr === 'cli/codex';
-}
-/**
- * Create an `AdditionalArgsProvider` (SDK extension point, WI-20260703-001)
- * that injects CrewX home as a Codex writable root for `workspace-write`
- * equivalent modes (`agent`, `auto`, `undefined`).
- *
- * No-ops for:
- *   - Non-codex providers.
- *   - Modes in {@link NO_INJECT_MODES} (read-only/plan/agent-full-access/yolo/danger-full-access).
- */
-function createCodexWritableRootsProvider(crewxHome = resolveCrewxHome()) {
-    return (ctx) => {
-        if (!isCodexProvider(ctx))
-            return [];
-        if (ctx.mode !== undefined && NO_INJECT_MODES.has(ctx.mode))
-            return [];
-        return buildCodexWritableRootArgs(crewxHome);
-    };
-}
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.resolveCrewxHome=i;exports.escapeTomlBasicString=t;exports.buildCodexWritableRootArgs=s;exports.createCodexSkipGitRepoCheckProvider=u;exports.composeAdditionalArgsProviders=p;exports.createCodexWritableRootsProvider=w;const a=require("os");const d=require("path");const l=new Set(["read-only","plan","agent-full-access","yolo","danger-full-access"]);function i(){return process.env.CREWX_HOME??(0,d.join)((0,a.homedir)(),".crewx")}function t(e){return e.replace(/\\/g,"\\\\").replace(/"/g,'\\"').replace(/\n/g,"\\n").replace(/\r/g,"\\r").replace(/\t/g,"\\t")}function s(e){const r=t(e);return["-c",`sandbox_workspace_write.writable_roots=["${r}"]`]}function n(e){return e.providerId==="codex"||e.providerStr==="cli/codex"}function u(e){return r=>{if(!n(r))return[];if(!e)return[];return["--skip-git-repo-check"]}}function p(...e){return r=>e.flatMap(o=>o(r))}function w(e=i()){return r=>{if(!n(r))return[];if(r.mode!==void 0&&l.has(r.mode))return[];const o=s(e);if(r.mode==="agent"){const c=t(e);o.push("-c","default_permissions=crewx","-c",'permissions.crewx.extends=":workspace"',"-c","features.network_proxy=true","-c","permissions.crewx.network.enabled=true","-c","permissions.crewx.network.allow_local_binding=true","-c",'permissions.crewx.network.domains={"localhost"="allow","127.0.0.1"="allow"}',"-c",`permissions.crewx.filesystem={"${c}"="write"}`)}return o}}

package/dist/bootstrap/crewx-cli.js

@@ -1,63 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createCliCrewx = createCliCrewx;
-const fs_1 = require("fs");
-const path_1 = require("path");
-const os_1 = require("os");
-const sdk_1 = require("@crewx/sdk");
-const plugins_1 = require("@crewx/sdk/plugins");
-const repository_1 = require("@crewx/sdk/repository");
-const register_builtin_tools_1 = require("../register-builtin-tools");
-const version_1 = require("../utils/version");
-const codex_writable_roots_1 = require("./codex-writable-roots");
-/**
- * Build a Crewx instance with CLI-standard plugins (FileLogger + SqliteTracing)
- * and built-in tools registered. Use this from any CLI command that needs a
- * Crewx instance — keeps environment consistent across query / execute / slack / agent.
- *
- * workspaceRoot is always process.cwd()-based so that per-workspace logs land
- * in {cwd}/.crewx/logs/. Critical for file:// remote agent delegation.
- *
- * Behavior:
- *   - If configPath resolves to an existing file → load it (with built-ins merged)
- *   - If configPath is NOT set via CREWX_CONFIG env AND the file doesn't exist →
- *     fall back to built-in-only mode (no user yaml required)
- *   - If CREWX_CONFIG is explicitly set AND the file doesn't exist → throw
- */
-async function createCliCrewx(configPath = process.env.CREWX_CONFIG ?? 'crewx.yaml') {
-    const absConfigPath = (0, path_1.resolve)(configPath);
-    // workspaceRoot is always cwd-based, never package-internal
-    const workspaceRoot = process.cwd();
-    const isExplicitConfig = Boolean(process.env.CREWX_CONFIG);
-    const fileExists = (0, fs_1.existsSync)(absConfigPath);
-    let yamlPath;
-    if (fileExists) {
-        yamlPath = absConfigPath;
-    }
-    else if (isExplicitConfig) {
-        throw new Error(`[crewx] Config file not found: ${absConfigPath} (set via CREWX_CONFIG)`);
-    }
-    else {
-        yamlPath = undefined;
-    }
-    // Run drizzle migrations once at bootstrap — plugin relies on this guarantee.
-    const dbDir = (0, path_1.join)((0, os_1.homedir)(), '.crewx');
-    (0, fs_1.mkdirSync)(dbDir, { recursive: true });
-    const dbPath = (0, path_1.join)(dbDir, 'crewx.db');
-    const handle = (0, repository_1.openDrizzleDb)(dbPath);
-    try {
-        (0, repository_1.runMigrations)(handle.db);
-    }
-    finally {
-        handle.close();
-    }
-    const crewx = await sdk_1.Crewx.loadYaml(yamlPath, {
-        remoteFactory: createCliCrewx,
-        additionalArgsProvider: (0, codex_writable_roots_1.createCodexWritableRootsProvider)(),
-    });
-    (0, register_builtin_tools_1.registerBuiltinToolsIfNeeded)(crewx);
-    await crewx.use(new plugins_1.ConversationPlugin());
-    await crewx.use(new plugins_1.FileLoggerPlugin({ version: version_1.CLI_VERSION, workspaceRoot }));
-    await crewx.use(new plugins_1.SqliteTracingPlugin({ version: version_1.CLI_VERSION }));
-    return crewx;
-}
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.createCliCrewx=C;const n=require("fs");const o=require("path");const x=require("os");const s=require("@crewx/sdk");const y=require("@crewx/workflow/list");const a=require("@crewx/sdk/plugins");const l=require("@crewx/sdk/repository");const h=require("../register-builtin-tools");const _=require("../utils/version");const R=require("../utils/inherited-trace");const d=require("./codex-writable-roots");async function C(P=process.env.CREWX_CONFIG??"crewx.yaml"){const t=(0,o.resolve)(P);const u=process.cwd();const v=Boolean(process.env.CREWX_CONFIG);const f=(0,n.existsSync)(t);let e;if(f){e=t}else if(v){throw new Error(`[crewx] Config file not found: ${t} (set via CREWX_CONFIG)`)}else{e=void 0}const g=e!==void 0?(0,o.dirname)(t):void 0;const c=process.env.CREWX_DB||(0,o.join)((0,x.homedir)(),".crewx","crewx.db");(0,n.mkdirSync)((0,o.dirname)(c),{recursive:true});const w=(0,l.openDrizzleDb)(c);try{(0,l.runMigrations)(w.db)}finally{w.close()}const r=await s.Crewx.loadYaml(e,{remoteFactory:C,inheritWorktreeOwner:true,additionalArgsProvider:(0,d.composeAdditionalArgsProviders)((0,d.createCodexWritableRootsProvider)(),(0,d.createCodexSkipGitRepoCheckProvider)(g))});(0,h.registerBuiltinToolsIfNeeded)(r);r.registerPromptListProvider(s.Crewx.createAgentListPromptResolver(e));r.registerPromptListProvider((0,y.createWorkflowListPromptResolver)(e));await r.use(new a.ConversationPlugin({dbPath:c}));await r.use(new a.FileLoggerPlugin({version:_.CLI_VERSION,workspaceRoot:u}));await r.use(new a.SqliteTracingPlugin({version:_.CLI_VERSION,runnerIdentity:(0,R.consumeInheritedRunnerIdentity)(),inheritWorktreeOwner:true}));const p=e!==void 0?(0,o.dirname)(e):u;const m=(0,s.normalizeWorkspacePath)(p);const i=(0,s.resolveWorkspaceOwnerPath)(p);if(i!==m&&((0,n.existsSync)((0,o.join)(i,"crewx.yaml"))||(0,n.existsSync)((0,o.join)(i,"crewx.yml")))){try{new l.WorkspaceRepository().registerWorkspace(i)}catch{}}return r}

package/dist/builtin.d.ts

@@ -12,4 +12,4 @@ export declare const BUILTIN_COMMANDS: Set<string>;
  * Falls back to direct main() call on any tracer failure.
  */
 export declare function wrapWithTracer(builtinName: string, main: (args?: string[]) => Promise<void>, args: string[]): Promise<void>;
-export declare function handleBuiltin(builtinName: string, args: string[]): Promise<void>;
+export declare function handleBuiltin(builtinName: string, args: string[], productPackageRoot?: string): Promise<void>;

package/dist/builtin.js

@@ -1,127 +1,5 @@
-"use strict";
-/**
- * Built-in tool router.
- *
- * Routes built-in commands (memory, search, doc, etc.) to their respective
- * @crewx/* package CLI entry points.
- *
- * Copied and adapted from packages/cli-bak/src/cli/builtin.handler.ts.
- */
-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.BUILTIN_COMMANDS = void 0;
-exports.wrapWithTracer = wrapWithTracer;
-exports.handleBuiltin = handleBuiltin;
-const BUILTIN_MAP = {
-    memory: () => Promise.resolve().then(() => __importStar(require('@crewx/memory/cli'))),
-    search: () => Promise.resolve().then(() => __importStar(require('@crewx/search/cli'))),
-    doc: () => Promise.resolve().then(() => __importStar(require('@crewx/doc/cli'))),
-    wbs: () => Promise.resolve().then(() => __importStar(require('@crewx/wbs/cli'))),
-    cron: () => Promise.resolve().then(() => __importStar(require('@crewx/cron/cli'))),
-    workflow: () => Promise.resolve().then(() => __importStar(require('@crewx/workflow/cli'))),
-    skill: () => Promise.resolve().then(() => __importStar(require('@crewx/skill/cli'))),
-    dreaming: () => Promise.resolve().then(() => __importStar(require('@crewx/dreaming/cli'))),
-    wi: () => Promise.resolve().then(() => __importStar(require('@crewx/wi/cli'))),
-    chromex: () => Promise.resolve().then(() => __importStar(require('@crewx/chromex/cli'))),
-};
-exports.BUILTIN_COMMANDS = new Set(Object.keys(BUILTIN_MAP));
-// Load skill-tracer for observability (graceful degradation if unavailable)
-async function loadTracer() {
-    try {
-        return await Promise.resolve().then(() => __importStar(require('@crewx/shared/skill-tracer')));
-    }
-    catch {
-        return null;
-    }
-}
-/**
- * Wrap main() with tracer.run() if tracer is available.
- * Falls back to direct main() call on any tracer failure.
- */
-async function wrapWithTracer(builtinName, main, args) {
-    let tracer = null;
-    try {
-        tracer = await loadTracer();
-    }
-    catch {
-        // tracer unavailable — proceed without it
-    }
-    if (tracer) {
-        let mainError = null;
-        let mainCompleted = false;
-        try {
-            await tracer.run(`crewx/${builtinName}`, async () => {
-                try {
-                    await main(args);
-                    mainCompleted = true;
-                }
-                catch (err) {
-                    mainError = err;
-                    throw err;
-                }
-            });
-            return;
-        }
-        catch {
-            if (mainError)
-                throw mainError;
-            if (mainCompleted)
-                return;
-            // tracer setup error — fall back
-        }
-    }
-    await main(args);
-}
-async function handleBuiltin(builtinName, args) {
-    const loader = BUILTIN_MAP[builtinName];
-    if (!loader) {
-        console.error(`Unknown built-in tool: ${builtinName}`);
-        process.exit(1);
-    }
-    try {
-        const mod = await loader();
-        await wrapWithTracer(builtinName, mod.main.bind(mod), args);
-    }
-    catch (err) {
-        const code = err.code;
-        if (code === 'MODULE_NOT_FOUND' || code === 'ERR_MODULE_NOT_FOUND') {
-            console.error(`\n  Built-in tool '${builtinName}' is not installed.\n`);
-            console.error(`  Install it with:\n`);
-            console.error(`    npm install @crewx/${builtinName}\n`);
-            process.exit(1);
-        }
-        throw err;
-    }
-}
+"use strict";var u=exports&&exports.__createBinding||(Object.create?(function(n,r,i,t){if(t===void 0)t=i;var e=Object.getOwnPropertyDescriptor(r,i);if(!e||("get"in e?!r.__esModule:e.writable||e.configurable)){e={enumerable:true,get:function(){return r[i]}}}Object.defineProperty(n,t,e)}):(function(n,r,i,t){if(t===void 0)t=i;n[t]=r[i]}));var f=exports&&exports.__setModuleDefault||(Object.create?(function(n,r){Object.defineProperty(n,"default",{enumerable:true,value:r})}):function(n,r){n["default"]=r});var o=exports&&exports.__importStar||(function(){var n=function(r){n=Object.getOwnPropertyNames||function(i){var t=[];for(var e in i)if(Object.prototype.hasOwnProperty.call(i,e))t[t.length]=e;return t};return n(r)};return function(r){if(r&&r.__esModule)return r;var i={};if(r!=null){for(var t=n(r),e=0;e<t.length;e++)if(t[e]!=="default")u(i,r,t[e])}f(i,r);return i}})();Object.defineProperty(exports,"__esModule",{value:true});exports.BUILTIN_COMMANDS=void 0;exports.wrapWithTracer=s;exports.handleBuiltin=w;const l={memory:()=>Promise.resolve().then(()=>o(require("@crewx/memory/cli"))),search:()=>Promise.resolve().then(()=>o(require("@crewx/search/cli"))),doc:()=>Promise.resolve().then(()=>o(require("@crewx/doc/cli"))),wbs:()=>Promise.resolve().then(()=>o(require("@crewx/wbs/cli"))),cron:()=>Promise.resolve().then(()=>o(require("@crewx/cron/cli"))),workflow:()=>Promise.resolve().then(()=>o(require("@crewx/workflow/cli"))),skill:()=>Promise.resolve().then(()=>o(require("@crewx/skill/cli"))),dreaming:()=>Promise.resolve().then(()=>o(require("@crewx/dreaming/cli"))),wi:()=>Promise.resolve().then(()=>o(require("@crewx/wi/cli"))),chromex:()=>Promise.resolve().then(()=>o(require("@crewx/chromex/cli"))),notify:()=>Promise.resolve().then(()=>o(require("@crewx/notify/cli"))),app:()=>Promise.resolve().then(()=>o(require("@crewx/app/cli")))};exports.BUILTIN_COMMANDS=new Set(Object.keys(l));async function h(){try{return await Promise.resolve().then(()=>o(require("@crewx/shared/skill-tracer")))}catch{return null}}async function s(n,r,i){let t=null;try{t=await h()}catch{}if(t){let e=null;let a=false;try{await t.run(`crewx/${n}`,async()=>{try{await r(i);a=true}catch(c){e=c;throw c}});return}catch{if(e)throw e;if(a)return}}await r(i)}async function w(n,r,i){const t=l[n];if(!t){console.error(`Unknown built-in tool: ${n}`);process.exit(1)}try{const e=await t();const a=n==="skill"?c=>e.main(c,{productPackageRoot:i}):e.main.bind(e);await s(n,a,r)}catch(e){const a=e.code;if(a==="MODULE_NOT_FOUND"||a==="ERR_MODULE_NOT_FOUND"){console.error(`
+  Built-in tool '${n}' is not installed.
+`);console.error(`  Install it with:
+`);console.error(`    npm install @crewx/${n}
+`);process.exit(1)}throw e}}

package/dist/commands/agent.js

@@ -1,225 +1,6 @@
-"use strict";
-/**
- * crewx agent handler.
- * Dispatches `crewx agent ls` and `crewx agent prompt` subcommands.
- */
-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.handleAgent = handleAgent;
-const path = __importStar(require("path"));
-const fs_1 = require("fs");
-const crewx_cli_1 = require("../bootstrap/crewx-cli");
-const sdk_1 = require("@crewx/sdk");
-const skill_1 = require("@crewx/skill");
-/**
- * Parse a flag from args array.
- * Supports both `--flag=value` and `--flag value` forms.
- * Returns undefined if flag is not present.
- */
-function parseFlag(args, flag) {
-    const prefix = `--${flag}=`;
-    for (let i = 0; i < args.length; i++) {
-        if (args[i].startsWith(prefix)) {
-            return args[i].slice(prefix.length);
-        }
-        if (args[i] === `--${flag}` && i + 1 < args.length) {
-            return args[i + 1];
-        }
-    }
-    return undefined;
-}
-/**
- * Format provider field for display.
- */
-function formatProvider(provider) {
-    return Array.isArray(provider) ? provider.join(', ') : provider;
-}
-/**
- * Print the agent list.
- */
-function printAgentList(agents, total, isFiltered) {
-    const configPath = process.env.CREWX_CONFIG ?? null;
-    if (agents.length === 0) {
-        console.log('WARNING: No agents configured.');
-        if (!configPath) {
-            console.log('Set CREWX_CONFIG to point to your crewx.yaml configuration file.');
-        }
-        return;
-    }
-    const headerCount = isFiltered ? `${agents.length} / ${total}` : `${total}`;
-    console.log(`Available Agents (${headerCount})\n`);
-    agents.forEach((agent, index) => {
-        const headerParts = [`@${agent.id}`];
-        if (agent.name && agent.name !== agent.id) {
-            headerParts.push(agent.name);
-        }
-        console.log(`${index + 1}. ${headerParts.join(' - ')}`);
-        console.log(`   Provider: ${formatProvider(agent.provider)}`);
-        const workDir = agent.working_directory ?? agent.workingDirectory ?? '.';
-        console.log(`   Working Dir: ${workDir}`);
-        if (agent.role) {
-            console.log(`   Role: ${agent.role}`);
-        }
-        if (agent.team) {
-            console.log(`   Team: ${agent.team}`);
-        }
-        if (agent.description) {
-            console.log(`   Description: ${agent.description}`);
-        }
-        if (index < agents.length - 1) {
-            console.log('');
-        }
-    });
-    const configSource = configPath ? 'External YAML file' : 'Default hardcoded values';
-    console.log(`\nConfiguration Source: ${configSource}`);
-    if (configPath) {
-        console.log(`Config Path: ${configPath}`);
-    }
-    else {
-        console.log('Tip: Set CREWX_CONFIG to point to your crewx.yaml file to customize agents.');
-    }
-}
-/**
- * Handle `crewx agent ls` — list agents with optional filters.
- */
-async function handleAgentList(crewx, args) {
-    const role = parseFlag(args, 'role');
-    const team = parseFlag(args, 'team');
-    const provider = parseFlag(args, 'provider');
-    const isFiltered = !!(role || team || provider);
-    const total = crewx.agents.size;
-    const filtered = crewx.filterAgents({ role, team, provider });
-    printAgentList(filtered, total, isFiltered);
-}
-/**
- * Handle `crewx agent prompt <agentId>` — print fully rendered system prompt.
- * Renders Handlebars template variables via Crewx.renderAgentPromptFull().
- */
-async function handleAgentPrompt(crewx, args) {
-    // Find the agent id argument (first non-flag arg after 'prompt')
-    const agentIdRaw = args.find(a => !a.startsWith('--'));
-    if (!agentIdRaw) {
-        console.error('Missing agent ID. Usage: crewx agent prompt @agent_name');
-        process.exit(1);
-    }
-    try {
-        const skills = loadAgentSkills();
-        const rendered = await crewx.renderAgentPromptFull(agentIdRaw, {
-            env: process.env,
-            session: { mode: 'query', platform: 'cli' },
-            skills,
-        });
-        const displayId = agentIdRaw.startsWith('@') ? agentIdRaw.slice(1) : agentIdRaw;
-        console.log(`\n🤖 **Rendered Prompt for Agent: ${displayId}**\n`);
-        console.log('--- BEGIN PROMPT ---');
-        console.log(rendered);
-        console.log('--- END PROMPT ---');
-    }
-    catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
-        console.error(`Failed to get agent prompt: ${message}`);
-        process.exit(1);
-    }
-}
-/**
- * Handle `crewx agent [subcommand] [options]`.
- *
- * Subcommands:
- *   ls | list | (none) — list agents (default)
- *   prompt <agentId>   — print rendered system prompt
- */
-async function handleAgent(args) {
-    const configPath = process.env.CREWX_CONFIG ?? 'crewx.yaml';
-    let crewx;
-    try {
-        crewx = await (0, crewx_cli_1.createCliCrewx)(configPath);
-    }
-    catch (err) {
-        if (err instanceof sdk_1.ConfigLoadError && !(0, fs_1.existsSync)(configPath)) {
-            const subcommand = (args[0] ?? '').toLowerCase();
-            if (!subcommand || subcommand === 'ls' || subcommand === 'list') {
-                console.log('WARNING: No agents configured.');
-                console.log(`No crewx.yaml found. Run 'crewx init' to create one.`);
-                return;
-            }
-        }
-        throw err;
-    }
-    const subcommand = (args[0] ?? '').toLowerCase();
-    switch (subcommand) {
-        case 'ls':
-        case 'list':
-            await handleAgentList(crewx, args.slice(1));
-            return;
-        case '':
-            // Default: no subcommand → ls
-            await handleAgentList(crewx, args.slice(1));
-            return;
-        case 'prompt':
-        case 'p':
-            await handleAgentPrompt(crewx, args.slice(1));
-            return;
-        default:
-            console.error(`Unknown agent subcommand: ${subcommand}`);
-            printAgentHelp();
-            process.exit(1);
-    }
-}
-/**
- * Discover available skills and convert to SkillEntry format for template rendering.
- * Searches skills/ and node_modules/@crewx directories.
- */
-function loadAgentSkills() {
-    try {
-        const engine = new skill_1.SkillEngine(process.cwd());
-        const discovered = engine.discover();
-        return discovered.map(s => ({
-            metadata: {
-                name: s.name,
-                version: s.version ?? '0.0.0',
-                description: s.description ?? '',
-            },
-            filePath: s.skillMdPath ?? path.join(s.dir, 'SKILL.md'),
-        }));
-    }
-    catch {
-        return [];
-    }
-}
-function printAgentHelp() {
-    console.log(`
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.handleAgent=f;const d=require("fs");const p=require("../bootstrap/crewx-cli");const c=require("@crewx/sdk");function a(t,r){const n=`--${r}=`;for(let e=0;e<t.length;e++){if(t[e].startsWith(n)){return t[e].slice(n.length)}if(t[e]===`--${r}`&&e+1<t.length){return t[e+1]}}return void 0}function u(t,r,n){console.log((0,c.formatAgentList)({agents:t,total:r,isFiltered:n,configPath:process.env.CREWX_CONFIG??null}))}async function l(t,r){const n=a(r,"role");const e=a(r,"team");const o=a(r,"provider");const s=!!(n||e||o);const i=t.agents.size;const g=t.filterAgents({role:n,team:e,provider:o});u(g,i,s)}async function m(t,r){const n=r.find(e=>!e.startsWith("--"));if(!n){console.error("Missing agent ID. Usage: crewx agent prompt @agent_name");process.exit(1)}try{const e=await t.renderAgentPromptFull(n,{env:process.env,session:{mode:"query",platform:"cli"}});const o=n.startsWith("@")?n.slice(1):n;console.log(`
+\u{1F916} **Rendered Prompt for Agent: ${o}**
+`);console.log("--- BEGIN PROMPT ---");console.log(e);console.log("--- END PROMPT ---")}catch(e){const o=e instanceof Error?e.message:String(e);console.error(`Failed to get agent prompt: ${o}`);process.exit(1)}}async function f(t){const r=process.env.CREWX_CONFIG??"crewx.yaml";let n;try{n=await(0,p.createCliCrewx)(r)}catch(o){if(o instanceof c.ConfigLoadError&&!(0,d.existsSync)(r)){const s=(t[0]??"").toLowerCase();if(!s||s==="ls"||s==="list"){console.log("WARNING: No agents configured.");console.log(`No crewx.yaml found. Run 'crewx init' to create one.`);return}}throw o}const e=(t[0]??"").toLowerCase();switch(e){case"ls":case"list":await l(n,t.slice(1));return;case"":await l(n,t.slice(1));return;case"prompt":case"p":await m(n,t.slice(1));return;default:console.error(`Unknown agent subcommand: ${e}`);w();process.exit(1)}}function w(){console.log(`
 CrewX Agent Management
 
 Usage:
@@ -242,5 +23,4 @@ Examples:
   crewx agent ls --role=PM --provider=claude
   crewx agent ls --role=PM,general
   CREWX_CONFIG=./crewx.yaml crewx agent list
-`.trim());
-}
+`.trim())}

package/dist/commands/cal.d.ts

@@ -0,0 +1,15 @@
+import type { ActionContext } from '@crewx/knowledge-core';
+/** Suggested wait rungs in seconds. 540 is the safe caller-harness cap. */
+export declare const WAIT_LADDER_SECONDS: readonly [60, 300, 540];
+export interface SuggestWaitSecondsOptions {
+    startedAt?: string | number | Date | null;
+    lastWaitSeconds?: number;
+    now?: number;
+}
+/**
+ * Select the next safe result wait based on task runtime without stepping
+ * down from the wait value the caller just used.
+ */
+export declare function suggestWaitSeconds(options: SuggestWaitSecondsOptions): number;
+/** Write a human-only CAL footer without contaminating command stdout. */
+export declare function writeCalFooter(context: ActionContext): void;

package/dist/commands/cal.js

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.WAIT_LADDER_SECONDS=void 0;exports.suggestWaitSeconds=D;exports.writeCalFooter=a;const i=require("@crewx/knowledge-core");exports.WAIT_LADDER_SECONDS=[60,300,540];function d(e){if(e instanceof Date){return Number.isFinite(e.getTime())?e.getTime():void 0}if(typeof e==="number"){return Number.isFinite(e)?e:void 0}if(typeof e==="string"){const t=Date.parse(e);return Number.isFinite(t)?t:void 0}return void 0}function D(e){const t=Number.isFinite(e.now)?e.now:Date.now();const n=d(e.startedAt);const r=n===void 0?0:Math.max(0,(t-n)/1e3);const s=exports.WAIT_LADDER_SECONDS.find(c=>c>r)??exports.WAIT_LADDER_SECONDS[exports.WAIT_LADDER_SECONDS.length-1];const o=Number.isFinite(e.lastWaitSeconds)?Math.max(0,e.lastWaitSeconds):0;return Math.min(exports.WAIT_LADDER_SECONDS[exports.WAIT_LADDER_SECONDS.length-1],Math.max(s,o))}function a(e){const t=(0,i.formatActions)((0,i.generateNextActions)(e));if(t)process.stderr.write(`${t}
+`)}

package/dist/commands/db.d.ts

@@ -6,4 +6,7 @@
  *   crewx db push --force        Apply without confirmation + reset migration history
  *   crewx db push --dry-run      Show preview only, no changes
  */
+export declare const TASK_LOG_MIGRATION_HELP = "Usage:\n  crewx db migrate-task-logs --dry-run [--db PATH]\n  crewx db migrate-task-logs --apply [--db PATH] [--batch-tasks N]\n  crewx db migrate-task-logs --verify [--db PATH]\n\nModes:\n  --dry-run  Read and validate legacy blobs without writing or creating a backup.\n  --apply    Create a consistent SQLite backup, then migrate one task per transaction.\n  --verify   Check source invariants, event sequences, counts, and orphan rows.\n\nApply policy:\n  Only blob tasks with status success, failed, or completed are migrated.\n  pending, running, paused, and unknown statuses are deferred for a later run.\n  There is no --force or --include-active option. Apply requires the estimated\n  database/event growth plus a 10 GiB free-space reserve.\n\nExit codes:\n  0  Completed with no malformed rows or invariant failures.\n  1  Safe tasks completed but a row/invariant failed, or apply was blocked.\n  2  Invalid command-line arguments.\n\nThe command never runs automatically at server startup and never runs VACUUM.";
+export declare const REQUEST_LOG_MIGRATION_HELP = "Usage:\n  crewx db migrate-request-logs [--batch N] [--dry-run]\n\nMoves the request log rows still stored in crewx.db into logs.db, the file next\nto it. Each distinct request/response body is stored once in logs.db, keyed by\nits SHA-256; a row points to its bodies by hash, so nothing is dropped.\n\nOptions:\n  --batch N   Rows per batch (default 250; a batch is also capped at about 8 MB).\n  --dry-run   Count rows and distinct bodies without writing anything (logs.db is not created).\n\nSafe while crewx is running: each batch is committed to logs.db, verified there,\nand only then deleted from crewx.db in one short transaction. Interrupt it and run\nit again at any time. The database is chosen like everywhere else (CREWX_DB, else\n~/.crewx/crewx.db). No VACUUM and no DROP: crewx.db keeps its size until a later compaction.\n\nExit codes:\n  0  Every row is in logs.db and none is left in crewx.db (or the dry run finished).\n  1  Rows are still in crewx.db, or an error stopped the move (progress is kept).\n  2  Invalid command-line arguments.";
+export declare const USAGE_BACKFILL_HELP = "Usage:\n  crewx db backfill-usage [--dry-run|--apply|--verify] [--db PATH] [--backup PATH]\n  crewx db backfill-usage --restore SNAPSHOT [--db PATH]\n\nModes:\n  --dry-run  Show provider/reason recovery plans without changing the database (default).\n  --apply    Create a row-level undo snapshot, then account one task per transaction.\n  --verify   Recheck remaining targets and usageAccounting markers without changing the database.\n  --restore  Restore rows from SNAPSHOT when their current values still match the snapshot after-state.\n\nApply policy:\n  Only success, failed, and completed tasks with zero recorded usage are considered.\n  Workflow/MCP anchors and plugin/mock rows are excluded. Rows completed within 24 hours\n  are not marked unavailable when their logs do not contain usage.\n\nExit codes:\n  0  Completed successfully.\n  1  Apply was blocked or one or more task updates failed.\n  2  Invalid command-line arguments.";
 export declare function handleDb(args: string[]): Promise<void>;