pulseed 0.0.1 → 0.1.1

package/dist/cli/utils.js

@@ -0,0 +1,131 @@
+// ─── CLI Shared Utilities ───
+export async function promptYesNo(question) {
+    const readline = await import("node:readline");
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    return new Promise((resolve) => {
+        process.stdout.write(question);
+        rl.once("line", (answer) => {
+            rl.close();
+            resolve(answer.trim().toLowerCase() === "y");
+        });
+    });
+}
+export function formatOperationError(operation, err) {
+    if (err instanceof Error) {
+        return `Operation "${operation}" failed. Original error: ${err.name}: ${err.message}`;
+    }
+    return `Operation "${operation}" failed. Original error: ${String(err)}`;
+}
+export function printUsage() {
+    console.log(`
+PulSeed — AI agent orchestrator
+
+Usage:
+  pulseed run --goal <id>              Run CoreLoop for a goal
+  pulseed improve [path]               Analyze path, suggest goals, and optionally run improvement loop
+  pulseed suggest "<context>"          Suggest improvement goals for a project context
+  pulseed goal add --title "<t>" --dim "name:type:val"  Register a goal (raw mode, no LLM)
+  pulseed goal add "<description>"                      Register a goal via GoalRefiner (default)
+  pulseed goal add "<description>" --no-refine          Register a goal via legacy LLM negotiation
+  pulseed goal list                    List all registered goals
+  pulseed goal list --archived         Also list archived goals
+  pulseed goal archive <id>            Archive a completed goal (moves state to ~/.pulseed/archive/)
+  pulseed goal remove <id>             Remove a goal by ID
+  pulseed goal show <id>               Show goal details (dimensions, constraints, deadline)
+  pulseed goal reset <id>              Reset goal state for re-running
+  pulseed cleanup                      Archive all completed goals and remove stale data
+  pulseed status --goal <id>           Show current status and progress
+  pulseed report --goal <id>           Show latest report
+  pulseed log --goal <id>              View observation and gap history log
+  pulseed tui                          Launch the interactive TUI
+  pulseed start --goal <id>            Start daemon mode for one or more goals
+  pulseed stop                         Stop the running daemon
+  pulseed cron --goal <id>             Print crontab entry for a goal
+  pulseed config character             Show or update character configuration
+  pulseed datasource add <type>        Register a new data source (file | http_api)
+  pulseed datasource list              List all registered data sources
+  pulseed datasource remove <id>       Remove a data source by ID
+  pulseed capability list              List all registered capabilities
+  pulseed capability remove <name>     Remove a capability by name
+  pulseed knowledge list               List all shared knowledge entries
+  pulseed knowledge search <query>     Search knowledge entries by keyword
+  pulseed knowledge stats              Show knowledge base statistics
+  pulseed plugin list                  List installed plugins
+  pulseed plugin install <path>        Install a plugin from a local directory
+  pulseed plugin remove <name>         Remove an installed plugin
+  pulseed setup                        Interactive setup wizard (first-time configuration)
+  pulseed provider show                Show current provider config
+  pulseed provider set                 Set LLM provider and/or default adapter
+
+Options (pulseed run):
+  --goal <id>                         Goal ID to run (required)
+  --max-iterations <n>               Override max iterations (default: 100)
+  --adapter <type>                    Adapter: claude_api | claude_code_cli | github_issue (default: claude_api)
+  --tree                              Enable tree mode (iterate across all tree nodes)
+  --yes, -y                           Auto-approve all tasks (skip approval prompts)
+
+Options (pulseed improve):
+  --auto                              Full auto mode (select best suggestion, run loop)
+  --yes                               Auto-approve (select first suggestion, run loop)
+  --max, -n <n>                       Max suggestions (default: 3)
+
+Options (pulseed suggest):
+  --max, -n <n>                       Max number of suggestions (default: 5)
+  --path, -p <dir>                    Repo path to scan for additional context
+
+Options (pulseed goal add):
+  --title <title>                     Goal title (raw mode)
+  --dim <name:type:value>             Dimension spec, repeatable (raw mode, e.g. "tsc_error_count:min:0")
+  --no-refine                         Skip GoalRefiner, use legacy negotiate() instead
+  --negotiate                         Alias: same as default (refine mode)
+  --deadline <ISO-date>               Optional deadline (e.g. 2026-06-01)
+  --constraint <text>                 Optional constraint (repeatable)
+
+Options (pulseed config character):
+  --show                              Show current character config
+  --reset                             Reset to defaults
+  --caution-level <1-5>               Feasibility threshold (1=conservative, 5=ambitious)
+  --stall-flexibility <1-5>           Stall tolerance (1=pivot fast, 5=persistent)
+  --communication-directness <1-5>    Output style (1=considerate, 5=direct)
+  --proactivity-level <1-5>           Report verbosity (1=events-only, 5=always-detailed)
+
+Options (pulseed datasource add):
+  --name <name>                       Human-readable name for the data source
+  --path <path>                       File path (required for type=file)
+  --url <url>                         HTTP URL (required for type=http_api)
+
+Options (pulseed provider set):
+  --llm <provider>                    LLM provider: anthropic | openai | ollama | codex
+  --adapter <type>                    Default adapter: claude_code_cli | claude_api | openai_codex_cli | openai_api | github_issue
+
+Environment:
+  ANTHROPIC_API_KEY                   Required for LLM-powered commands
+  PULSEED_LLM_PROVIDER                 Override LLM provider (anthropic|openai|ollama|codex)
+
+Examples:
+  pulseed goal add --title "tsc zero" --dim "tsc_error_count:min:0"
+  pulseed goal add --title "clean code" --dim "todo_count:max:0" --dim "fixme_count:max:0"
+  pulseed goal add "Increase test coverage to 90%"
+  pulseed goal add "Increase test coverage to 90%" --no-refine
+  pulseed goal list
+  pulseed goal show <id>
+  pulseed goal reset <id>
+  pulseed run --goal <id>
+  pulseed status --goal <id>
+  pulseed report --goal <id>
+  pulseed log --goal <id>
+  pulseed config character --show
+  pulseed config character --caution-level 3
+  pulseed datasource add file --path /path/to/metrics.json --name "My Metrics"
+  pulseed datasource add http_api --url https://api.example.com/metrics --name "API"
+  pulseed datasource list
+  pulseed datasource remove ds_1234567890
+`.trim());
+}
+export function printCharacterConfig(config) {
+    console.log(`  caution_level:              ${config.caution_level}  (1=conservative, 5=ambitious)`);
+    console.log(`  stall_flexibility:          ${config.stall_flexibility}  (1=pivot fast, 5=persistent)`);
+    console.log(`  communication_directness:   ${config.communication_directness}  (1=considerate, 5=direct)`);
+    console.log(`  proactivity_level:          ${config.proactivity_level}  (1=events-only, 5=always-detailed)`);
+}
+//# sourceMappingURL=utils.js.map

package/dist/cli/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/cli/utils.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAE/B,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,QAAgB;IAChD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;IAC/C,MAAM,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACtF,OAAO,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,EAAE;QACtC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC/B,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE;YACzB,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,GAAG,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,SAAiB,EAAE,GAAY;IAClE,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACzB,OAAO,cAAc,SAAS,6BAA6B,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC;IACxF,CAAC;IACD,OAAO,cAAc,SAAS,6BAA6B,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuGb,CAAC,IAAI,EAAE,CAAC,CAAC;AACV,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAKpC;IACC,OAAO,CAAC,GAAG,CAAC,iCAAiC,MAAM,CAAC,aAAa,iCAAiC,CAAC,CAAC;IACpG,OAAO,CAAC,GAAG,CAAC,iCAAiC,MAAM,CAAC,iBAAiB,gCAAgC,CAAC,CAAC;IACvG,OAAO,CAAC,GAAG,CAAC,iCAAiC,MAAM,CAAC,wBAAwB,6BAA6B,CAAC,CAAC;IAC3G,OAAO,CAAC,GAAG,CAAC,iCAAiC,MAAM,CAAC,iBAAiB,sCAAsC,CAAC,CAAC;AAC/G,CAAC"}

package/dist/cli-runner.d.ts

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+/**
+ * @description Coordinates CLI argument parsing, dependency wiring, and subcommand execution for the PulSeed command-line interface.
+ */
+export declare class CLIRunner {
+    private readonly stateManager;
+    private readonly characterConfigManager;
+    private activeCoreLoop;
+    /**
+     * @description Creates a CLI runner with state and character configuration managers rooted at the optional base directory.
+     * @param {string} [baseDir] Optional base directory for PulSeed state storage.
+     * @returns {void} Does not return a value.
+     */
+    constructor(baseDir?: string);
+    /**
+     * @description Initialises the state directory structure. Must be awaited before issuing any subcommands.
+     * @returns {Promise<void>}
+     */
+    init(): Promise<void>;
+    /**
+     * @description Stops the active core loop if one is currently running. Safe to call before `run()` or when no loop is active.
+     * @returns {void} Does not return a value.
+     */
+    stop(): void;
+    /**
+     * @description Parses CLI arguments, dispatches the matching PulSeed subcommand, and returns the resulting exit code.
+     * @param {string[]} argv Raw subcommand arguments, excluding the `node` executable and script path.
+     * @returns {Promise<number>} A promise that resolves to `0` for success, `1` for errors, or `2` for stall escalation.
+     */
+    run(argv: string[]): Promise<number>;
+}
+//# sourceMappingURL=cli-runner.d.ts.map

package/dist/cli-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-runner.d.ts","sourceRoot":"","sources":["../src/cli-runner.ts"],"names":[],"mappings":";AA+DA;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAyB;IAChE,OAAO,CAAC,cAAc,CAAyB;IAE/C;;;;OAIG;gBACS,OAAO,CAAC,EAAE,MAAM;IAK5B;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B;;;OAGG;IACH,IAAI,IAAI,IAAI;IAQZ;;;;OAIG;IACG,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;CAkX3C"}

package/dist/cli-runner.js

@@ -0,0 +1,415 @@
+#!/usr/bin/env node
+// ─── CLIRunner ───
+//
+// PulSeed CLI entry point. Wires all dependencies and exposes subcommands:
+//   pulseed run --goal <id>            Run CoreLoop once for a given goal
+//   pulseed goal add "<description>"   Negotiate and register a new goal (interactive)
+//   pulseed goal list                  List all registered goals
+//   pulseed goal archive <id>          Archive a completed goal
+//   pulseed goal show <id>             Show goal details
+//   pulseed goal reset <id>            Reset goal state for re-running
+//   pulseed status --goal <id>         Show current progress report
+//   pulseed report --goal <id>         Show latest report
+//   pulseed log --goal <id>            View execution/observation log
+//   pulseed start --goal <id>          Start daemon mode for one or more goals
+//   pulseed stop                       Stop the running daemon
+//   pulseed cron --goal <id>           Print crontab entry for a goal
+//   pulseed cleanup                    Archive all completed goals and remove stale data
+//   pulseed improve [path]             Analyze, suggest goals, and run improvement loop
+//   pulseed suggest "<context>"        Suggest improvement goals for a project
+//   pulseed capability list            List all registered capabilities
+//   pulseed capability remove <name>   Remove a capability by name
+//   pulseed knowledge list             List all shared knowledge entries
+//   pulseed knowledge search <query>   Search knowledge entries by keyword
+//   pulseed knowledge stats            Show knowledge base statistics
+//   pulseed task list --goal <id>      List tasks for a goal
+//   pulseed task show <taskId> --goal <id>  Show task details
+import { parseArgs } from "node:util";
+import { getCliLogger } from "./cli/cli-logger.js";
+import { StateManager } from "./state-manager.js";
+import { CharacterConfigManager } from "./traits/character-config.js";
+// Commands
+import { cmdRun } from "./cli/commands/run.js";
+import { cmdStatus, cmdLog, cmdCleanup } from "./cli/commands/goal.js";
+import { dispatchGoalCommand } from "./cli/commands/goal-dispatch.js";
+import { cmdPluginList, cmdPluginInstall, cmdPluginRemove, cmdPluginUpdate, cmdPluginSearch } from "./cli/commands/plugin.js";
+import { cmdReport } from "./cli/commands/report.js";
+import { cmdProvider, cmdConfigCharacter, cmdDatasourceAdd, cmdDatasourceList, cmdDatasourceRemove, cmdDatasourceDedup, cmdCapabilityList, cmdCapabilityRemove, } from "./cli/commands/config.js";
+import { cmdStart, cmdStop, cmdCron } from "./cli/commands/daemon.js";
+import { cmdSuggest, cmdImprove } from "./cli/commands/suggest.js";
+import { cmdSetup } from "./cli/commands/setup.js";
+import { cmdKnowledgeList, cmdKnowledgeSearch, cmdKnowledgeStats } from "./cli/commands/knowledge.js";
+import { cmdTaskList, cmdTaskShow } from "./cli/commands/task-read.js";
+import { printUsage, formatOperationError } from "./cli/utils.js";
+import { ensureProviderConfig } from "./cli/ensure-api-key.js";
+const logger = getCliLogger();
+// ─── CLIRunner ───
+/**
+ * @description Coordinates CLI argument parsing, dependency wiring, and subcommand execution for the PulSeed command-line interface.
+ */
+export class CLIRunner {
+    stateManager;
+    characterConfigManager;
+    activeCoreLoop = null;
+    /**
+     * @description Creates a CLI runner with state and character configuration managers rooted at the optional base directory.
+     * @param {string} [baseDir] Optional base directory for PulSeed state storage.
+     * @returns {void} Does not return a value.
+     */
+    constructor(baseDir) {
+        this.stateManager = new StateManager(baseDir);
+        this.characterConfigManager = new CharacterConfigManager(this.stateManager);
+    }
+    /**
+     * @description Initialises the state directory structure. Must be awaited before issuing any subcommands.
+     * @returns {Promise<void>}
+     */
+    async init() {
+        await this.stateManager.init();
+    }
+    /**
+     * @description Stops the active core loop if one is currently running. Safe to call before `run()` or when no loop is active.
+     * @returns {void} Does not return a value.
+     */
+    stop() {
+        if (this.activeCoreLoop) {
+            this.activeCoreLoop.stop();
+        }
+    }
+    // ─── Main dispatch ───
+    /**
+     * @description Parses CLI arguments, dispatches the matching PulSeed subcommand, and returns the resulting exit code.
+     * @param {string[]} argv Raw subcommand arguments, excluding the `node` executable and script path.
+     * @returns {Promise<number>} A promise that resolves to `0` for success, `1` for errors, or `2` for stall escalation.
+     */
+    async run(argv) {
+        await this.init();
+        if (argv.length === 0) {
+            await ensureProviderConfig();
+            printUsage();
+            return 1;
+        }
+        // Extract --yes / -y globally so it works regardless of position
+        let globalYes = false;
+        const filteredArgv = [];
+        for (const arg of argv) {
+            if (arg === "--yes" || arg === "-y") {
+                globalYes = true;
+            }
+            else {
+                filteredArgv.push(arg);
+            }
+        }
+        argv = filteredArgv;
+        const subcommand = argv[0];
+        if (subcommand === "run") {
+            let values;
+            try {
+                ({ values } = parseArgs({
+                    args: argv.slice(1),
+                    options: {
+                        goal: { type: "string", multiple: true },
+                        "max-iterations": { type: "string" },
+                        adapter: { type: "string" },
+                        tree: { type: "boolean" },
+                        yes: { type: "boolean", short: "y" },
+                        verbose: { type: "boolean" },
+                    },
+                    strict: false,
+                }));
+            }
+            catch (err) {
+                logger.error(formatOperationError("parse run command arguments", err));
+                values = {};
+            }
+            const goalIds = values.goal ?? [];
+            if (goalIds.length === 0) {
+                logger.error("Error: --goal <id> is required for `pulseed run`.");
+                return 1;
+            }
+            if (goalIds.length > 1) {
+                logger.error("Error: only one --goal is supported per `pulseed run`. Run separately for each goal, or use --tree for tree traversal.");
+                return 1;
+            }
+            const goalId = goalIds[0];
+            const loopConfig = {};
+            if (values["max-iterations"] !== undefined) {
+                const parsed = parseInt(values["max-iterations"], 10);
+                if (!isNaN(parsed)) {
+                    loopConfig.maxIterations = parsed;
+                }
+            }
+            if (values.adapter !== undefined) {
+                loopConfig.adapterType = values.adapter;
+            }
+            if (values.tree) {
+                loopConfig.treeMode = true;
+            }
+            const activeCoreLoopRef = { value: this.activeCoreLoop };
+            const result = await cmdRun(this.stateManager, this.characterConfigManager, goalId, loopConfig, globalYes || values.yes, values.verbose, activeCoreLoopRef);
+            this.activeCoreLoop = activeCoreLoopRef.value;
+            return result;
+        }
+        if (subcommand === "goal") {
+            return dispatchGoalCommand(argv[1], argv.slice(2), globalYes, this.stateManager, this.characterConfigManager);
+        }
+        if (subcommand === "status") {
+            let values;
+            try {
+                ({ values } = parseArgs({
+                    args: argv.slice(1),
+                    options: {
+                        goal: { type: "string" },
+                    },
+                    strict: false,
+                }));
+            }
+            catch (err) {
+                logger.error(formatOperationError("parse status command arguments", err));
+                values = {};
+            }
+            const goalId = values.goal;
+            if (!goalId || typeof goalId !== "string") {
+                logger.error("Error: --goal <id> is required for `pulseed status`.");
+                return 1;
+            }
+            return cmdStatus(this.stateManager, goalId);
+        }
+        if (subcommand === "report") {
+            let values;
+            let reportPositionals = [];
+            try {
+                const parsed = parseArgs({
+                    args: argv.slice(1),
+                    options: {
+                        goal: { type: "string" },
+                    },
+                    allowPositionals: true,
+                    strict: false,
+                });
+                values = parsed.values;
+                reportPositionals = parsed.positionals;
+            }
+            catch (err) {
+                logger.error(formatOperationError("parse report command arguments", err));
+                values = {};
+            }
+            const goalId = values.goal ?? reportPositionals[0];
+            if (!goalId || typeof goalId !== "string") {
+                logger.error("Error: goal ID is required. Usage: pulseed report --goal <id>  or  pulseed report <id>");
+                return 1;
+            }
+            return cmdReport(this.stateManager, goalId);
+        }
+        if (subcommand === "log") {
+            let values;
+            let logPositionals = [];
+            try {
+                const parsed = parseArgs({
+                    args: argv.slice(1),
+                    options: {
+                        goal: { type: "string" },
+                    },
+                    allowPositionals: true,
+                    strict: false,
+                });
+                values = parsed.values;
+                logPositionals = parsed.positionals;
+            }
+            catch (err) {
+                logger.error(formatOperationError("parse log command arguments", err));
+                values = {};
+            }
+            const goalId = values.goal ?? logPositionals[0];
+            if (!goalId || typeof goalId !== "string") {
+                logger.error("Error: goal ID is required. Usage: pulseed log --goal <id>  or  pulseed log <id>");
+                return 1;
+            }
+            return await cmdLog(this.stateManager, goalId);
+        }
+        if (subcommand === "start") {
+            await cmdStart(this.stateManager, this.characterConfigManager, argv.slice(1));
+            return 0;
+        }
+        if (subcommand === "stop") {
+            await cmdStop(argv.slice(1));
+            return 0;
+        }
+        if (subcommand === "cron") {
+            await cmdCron(argv.slice(1));
+            return 0;
+        }
+        if (subcommand === "datasource") {
+            const dsSubcommand = argv[1];
+            if (!dsSubcommand) {
+                logger.error("Error: datasource subcommand required. Available: datasource add, datasource list, datasource remove, datasource dedup");
+                return 1;
+            }
+            if (dsSubcommand === "add") {
+                return await cmdDatasourceAdd(this.stateManager, argv.slice(2));
+            }
+            if (dsSubcommand === "list") {
+                return cmdDatasourceList(this.stateManager);
+            }
+            if (dsSubcommand === "remove") {
+                return cmdDatasourceRemove(this.stateManager, argv.slice(2));
+            }
+            if (dsSubcommand === "dedup") {
+                return cmdDatasourceDedup(this.stateManager);
+            }
+            logger.error(`Unknown datasource subcommand: "${dsSubcommand}"`);
+            logger.error("Available: datasource add, datasource list, datasource remove, datasource dedup");
+            return 1;
+        }
+        if (subcommand === "capability") {
+            const capSubcommand = argv[1];
+            if (!capSubcommand) {
+                logger.error("Error: capability subcommand required. Available: capability list, capability remove");
+                return 1;
+            }
+            if (capSubcommand === "list") {
+                return await cmdCapabilityList(this.stateManager);
+            }
+            if (capSubcommand === "remove") {
+                return await cmdCapabilityRemove(this.stateManager, argv.slice(2));
+            }
+            logger.error(`Unknown capability subcommand: "${capSubcommand}"`);
+            logger.error("Available: capability list, capability remove");
+            return 1;
+        }
+        if (subcommand === "plugin") {
+            const pluginSubcommand = argv[1];
+            if (!pluginSubcommand) {
+                logger.error("Error: plugin subcommand required. Available: plugin list, plugin install, plugin remove");
+                return 1;
+            }
+            if (pluginSubcommand === "list") {
+                return await cmdPluginList();
+            }
+            if (pluginSubcommand === "install") {
+                return await cmdPluginInstall(undefined, argv.slice(2));
+            }
+            if (pluginSubcommand === "remove") {
+                return await cmdPluginRemove(undefined, argv.slice(2));
+            }
+            if (pluginSubcommand === "update") {
+                return await cmdPluginUpdate(undefined, argv.slice(2));
+            }
+            if (pluginSubcommand === "search") {
+                return await cmdPluginSearch(undefined, argv.slice(2));
+            }
+            logger.error(`Unknown plugin subcommand: "${pluginSubcommand}"`);
+            logger.error("Available: plugin list, plugin install, plugin remove, plugin update, plugin search");
+            return 1;
+        }
+        if (subcommand === "cleanup") {
+            return cmdCleanup(this.stateManager);
+        }
+        if (subcommand === "provider") {
+            return cmdProvider(argv.slice(1));
+        }
+        if (subcommand === "config") {
+            const configSubcommand = argv[1];
+            if (!configSubcommand) {
+                logger.error("Error: config subcommand required. Available: config character");
+                return 1;
+            }
+            if (configSubcommand === "character") {
+                return cmdConfigCharacter(this.characterConfigManager, argv.slice(2));
+            }
+            logger.error(`Unknown config subcommand: "${configSubcommand}"`);
+            logger.error("Available: config character");
+            return 1;
+        }
+        if (subcommand === "suggest") {
+            return await cmdSuggest(this.stateManager, this.characterConfigManager, argv.slice(1));
+        }
+        if (subcommand === "improve") {
+            const improveArgs = globalYes ? [...argv.slice(1), "--yes"] : argv.slice(1);
+            return await cmdImprove(this.stateManager, this.characterConfigManager, improveArgs);
+        }
+        if (subcommand === "setup") {
+            return await cmdSetup(argv.slice(1));
+        }
+        if (subcommand === "knowledge") {
+            const knowledgeSubcommand = argv[1];
+            if (!knowledgeSubcommand) {
+                logger.error("Error: knowledge subcommand required. Available: knowledge list, knowledge search, knowledge stats");
+                return 1;
+            }
+            if (knowledgeSubcommand === "list") {
+                return await cmdKnowledgeList(this.stateManager);
+            }
+            if (knowledgeSubcommand === "search") {
+                return await cmdKnowledgeSearch(this.stateManager, argv.slice(2));
+            }
+            if (knowledgeSubcommand === "stats") {
+                return await cmdKnowledgeStats(this.stateManager);
+            }
+            logger.error(`Unknown knowledge subcommand: "${knowledgeSubcommand}"`);
+            logger.error("Available: knowledge list, knowledge search, knowledge stats");
+            return 1;
+        }
+        if (subcommand === "task") {
+            const taskSubcommand = argv[1];
+            if (!taskSubcommand) {
+                logger.error("Error: task subcommand required. Available: task list, task show");
+                return 1;
+            }
+            if (taskSubcommand === "list") {
+                return await cmdTaskList(this.stateManager, argv.slice(2));
+            }
+            if (taskSubcommand === "show") {
+                return await cmdTaskShow(this.stateManager, argv.slice(2));
+            }
+            logger.error(`Unknown task subcommand: "${taskSubcommand}"`);
+            logger.error("Available: task list, task show");
+            return 1;
+        }
+        if (subcommand === "tui") {
+            // Dynamically import to avoid bundling Ink into the CLI when not needed
+            const { startTUI } = await import("./tui/entry.js");
+            await startTUI();
+            return 0;
+        }
+        if (subcommand === "--help" || subcommand === "-h" || subcommand === "help") {
+            printUsage();
+            return 0;
+        }
+        logger.error(`Unknown subcommand: "${subcommand}"`);
+        printUsage();
+        return 1;
+    }
+}
+// ─── Entry point (when run directly as a binary) ───
+async function main() {
+    const argv = process.argv.slice(2);
+    const runner = new CLIRunner();
+    try {
+        const code = await runner.run(argv);
+        process.exit(code);
+    }
+    catch (err) {
+        logger.error(formatOperationError("execute CLI entry point", err));
+        process.exit(1);
+    }
+}
+import { fileURLToPath } from "node:url";
+import { realpathSync } from "node:fs";
+const isMain = (() => {
+    if (typeof process === "undefined" || !process.argv[1])
+        return false;
+    try {
+        const thisFile = realpathSync(fileURLToPath(import.meta.url));
+        const entryFile = realpathSync(process.argv[1]);
+        return thisFile === entryFile;
+    }
+    catch (err) {
+        logger.error(formatOperationError("resolve CLI entry point path", err));
+        return false;
+    }
+})();
+if (isMain) {
+    main();
+}
+//# sourceMappingURL=cli-runner.js.map

package/dist/cli-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-runner.js","sourceRoot":"","sources":["../src/cli-runner.ts"],"names":[],"mappings":"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"}

package/dist/codex-llm-client.d.ts

@@ -0,0 +1,47 @@
+import type { ZodSchema } from "zod";
+import { type ILLMClient, type LLMMessage, type LLMRequestOptions, type LLMResponse } from "./llm-client.js";
+export interface CodexLLMClientConfig {
+    /** Path to the codex CLI executable. Default: "codex" */
+    cliPath?: string;
+    /** Model to pass via --model flag. Default: uses codex's default (OPENAI_MODEL env or codex config) */
+    model?: string;
+    /** Repository path passed to Codex for workspace-aware execution. Default: "." */
+    repoPath?: string;
+    /** Timeout per call in milliseconds. Default: 120000 (2 minutes) */
+    timeoutMs?: number;
+}
+/**
+ * ILLMClient implementation that uses the `codex exec` CLI for LLM calls.
+ * Routes all Motiva internal LLM calls through the Codex CLI, which uses
+ * the ChatGPT subscription (no separate API key needed).
+ *
+ * Uses `codex exec --ephemeral --full-auto -o <tmpfile> "PROMPT"` per call.
+ * The -o flag writes the final response to a temp file for clean output.
+ * Usage stats are not available from the CLI and will always be 0.
+ *
+ * Set MOTIVA_LLM_PROVIDER=codex to activate via CLIRunner / provider-factory.
+ */
+export declare class CodexLLMClient implements ILLMClient {
+    private readonly cliPath;
+    private readonly model;
+    private readonly repoPath;
+    private readonly timeoutMs;
+    constructor(config?: CodexLLMClientConfig);
+    /**
+     * Send a message to the Codex CLI with retry logic.
+     * Retries up to MAX_RETRY_ATTEMPTS times with exponential backoff on spawn failures.
+     */
+    sendMessage(messages: LLMMessage[], options?: LLMRequestOptions): Promise<LLMResponse>;
+    /**
+     * Spawn `codex exec --ephemeral --full-auto [-o <tmpfile>] [--model <model>] "PROMPT"`
+     * and return the response content read from the temp output file.
+     */
+    private _spawnCodex;
+    /**
+     * Extract JSON from LLM response text (handles markdown code blocks)
+     * and validate against the given Zod schema.
+     * Throws on parse failure or schema validation failure.
+     */
+    parseJSON<T>(content: string, schema: ZodSchema<T>): T;
+}
+//# sourceMappingURL=codex-llm-client.d.ts.map