pulseed 0.4.16 → 0.4.18

package/dist/interface/chat/tend-command.js

@@ -1,183 +0,0 @@
-// --- TendCommand ---
-//
-// Implements the /tend slash command for chat mode.
-// Summarizes chat history via LLM, generates a structured goal,
-// confirms with the user, then starts a daemon to work on it autonomously.
-// --- Constants ---
-const MAX_HISTORY_MESSAGES = 20;
-const SUMMARY_PROMPT = `You are analyzing a developer's chat conversation to extract their main objective.
-Summarize what the user wants to achieve in 1-3 sentences. Focus on concrete, measurable outcomes.
-Be specific -- mention file names, metrics, or technical goals if present.
-Output only the summary, no preamble.`;
-// --- TendCommand ---
-export class TendCommand {
-    /**
-     * Main entry point for /tend.
-     * Parses args, optionally generates a goal from chat history,
-     * and starts the daemon.
-     */
-    async execute(args, deps) {
-        const { goalId, maxIterations } = parseArgs(args);
-        // Path A: existing goal-id provided -- skip generation
-        if (goalId) {
-            return this.tendExistingGoal(goalId, maxIterations, deps);
-        }
-        // Path B: no chat history to work from
-        if (deps.chatHistory.length === 0) {
-            return {
-                success: false,
-                message: "No conversation yet. Chat first to describe what you want, then use /tend.",
-            };
-        }
-        // Path C: auto-generate goal from chat history
-        return this.tendFromChat(maxIterations, deps);
-    }
-    /**
-     * Summarize recent chat messages into a concise objective string.
-     */
-    async summarizeChat(history, llmClient) {
-        const recent = history.slice(-MAX_HISTORY_MESSAGES);
-        const transcript = recent
-            .map((m) => `${m.role === "user" ? "User" : "Assistant"}: ${m.content}`)
-            .join("\n");
-        const prompt = `${SUMMARY_PROMPT}\n\nConversation:\n${transcript}`;
-        try {
-            const response = await llmClient.sendMessage([{ role: "user", content: prompt }], { max_tokens: 200, model_tier: "light" });
-            return response.content.trim();
-        }
-        catch (err) {
-            const msg = err instanceof Error ? err.message : String(err);
-            throw new Error(`Failed to summarize chat: ${msg}`);
-        }
-    }
-    /**
-     * Generate a structured Goal from a plain-text summary via GoalNegotiator.
-     */
-    async generateGoal(summary, goalNegotiator) {
-        const result = await goalNegotiator.negotiate(summary, {
-            constraints: ["source: tend (auto-generated from chat)"],
-        });
-        return result.goal;
-    }
-    /**
-     * Format a goal for the confirmation prompt shown to the user before daemon start.
-     * Prefixed with the seedling symbol per design spec.
-     */
-    formatConfirmation(goal) {
-        const lines = [
-            "🌱 Tend to this goal?",
-            "",
-            `  Title: ${goal.title}`,
-        ];
-        if (goal.dimensions.length > 0) {
-            lines.push("  Dimensions:");
-            for (const dim of goal.dimensions) {
-                const t = dim.threshold;
-                let thresholdStr = "";
-                if (t.type === "min")
-                    thresholdStr = `min ${t.value}`;
-                else if (t.type === "max")
-                    thresholdStr = `max ${t.value}`;
-                else if (t.type === "range")
-                    thresholdStr = `${t.low}–${t.high}`;
-                else if (t.type === "present")
-                    thresholdStr = "present";
-                else if (t.type === "match")
-                    thresholdStr = `match: ${t.value}`;
-                lines.push(`    - ${dim.name}: ${thresholdStr}`);
-            }
-        }
-        if (goal.constraints && goal.constraints.length > 0) {
-            lines.push("  Constraints:");
-            for (const c of goal.constraints) {
-                lines.push(`    - ${c}`);
-            }
-        }
-        lines.push("");
-        lines.push("  [Y/n]");
-        return lines.join("\n");
-    }
-    // --- Private helpers ---
-    async tendExistingGoal(goalId, maxIterations, deps) {
-        const goal = await deps.stateManager.loadGoal(goalId);
-        if (!goal) {
-            return {
-                success: false,
-                message: `Goal not found: ${goalId}`,
-            };
-        }
-        return this.startDaemon(goal, maxIterations, deps.daemonClient);
-    }
-    async tendFromChat(maxIterations, deps) {
-        let summary;
-        try {
-            summary = await this.summarizeChat(deps.chatHistory, deps.llmClient);
-        }
-        catch (err) {
-            const msg = err instanceof Error ? err.message : String(err);
-            return {
-                success: false,
-                message: `Could not summarize chat: ${msg}. Try /track or create a goal manually with 'pulseed add'.`,
-            };
-        }
-        let goal;
-        try {
-            goal = await this.generateGoal(summary, deps.goalNegotiator);
-        }
-        catch (err) {
-            const msg = err instanceof Error ? err.message : String(err);
-            return {
-                success: false,
-                message: `Could not generate goal: ${msg}. Try describing your goal more specifically and retry /tend.`,
-            };
-        }
-        const confirmation = this.formatConfirmation(goal);
-        return {
-            success: true,
-            goalId: goal.id,
-            goalTitle: goal.title,
-            maxIterations,
-            message: "Generated goal from conversation.",
-            confirmation,
-            needsConfirmation: true,
-        };
-    }
-    async startDaemon(goal, maxIterations, daemonClient) {
-        try {
-            await daemonClient.startGoal(goal.id);
-            const iterNote = maxIterations !== undefined ? ` (max ${maxIterations} iterations)` : "";
-            return {
-                success: true,
-                goalId: goal.id,
-                goalTitle: goal.title,
-                message: `🌱 [tend] ${goal.id}: Started — "${goal.title}"${iterNote}\nRun 'pulseed status' to check progress.`,
-            };
-        }
-        catch (err) {
-            const msg = err instanceof Error ? err.message : String(err);
-            return {
-                success: false,
-                message: `Daemon unavailable: ${msg}. Start the daemon with 'pulseed daemon start' first.`,
-            };
-        }
-    }
-}
-// --- Arg parsing ---
-function parseArgs(args) {
-    const parts = args.trim().split(/\s+/).filter(Boolean);
-    let goalId;
-    let maxIterations;
-    for (let i = 0; i < parts.length; i++) {
-        if (parts[i] === "--max" && parts[i + 1]) {
-            const n = parseInt(parts[i + 1], 10);
-            if (!isNaN(n) && n > 0)
-                maxIterations = n;
-            i++;
-        }
-        else if (!parts[i].startsWith("--")) {
-            goalId = parts[i];
-        }
-    }
-    return { goalId, maxIterations };
-}
-//# sourceMappingURL=tend-command.js.map

package/dist/interface/chat/tend-command.js.map

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

package/dist/interface/cli/cli-command-registry.d.ts

@@ -1,16 +0,0 @@
-import { StateManager } from "../../base/state/state-manager.js";
-import { CharacterConfigManager } from "../../platform/traits/character-config.js";
-import type { CoreLoop } from "../../orchestrator/loop/core-loop.js";
-/**
- * @description Dispatches a PulSeed CLI subcommand and returns an exit code.
- * @param {string[]} argv Filtered arguments (--yes/-y already removed), first element is the subcommand.
- * @param {boolean} globalYes Whether --yes/-y was present globally.
- * @param {StateManager} stateManager Initialised state manager instance.
- * @param {CharacterConfigManager} characterConfigManager Character config manager instance.
- * @param {{ value: CoreLoop | null }} activeCoreLoopRef Mutable ref updated by cmdRun.
- * @returns {Promise<number>} Exit code: 0 for success, 1 for errors, 2 for stall escalation.
- */
-export declare function dispatchCommand(argv: string[], globalYes: boolean, stateManager: StateManager, characterConfigManager: CharacterConfigManager, activeCoreLoopRef: {
-    value: CoreLoop | null;
-}): Promise<number>;
-//# sourceMappingURL=cli-command-registry.d.ts.map

package/dist/interface/cli/cli-command-registry.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cli-command-registry.d.ts","sourceRoot":"","sources":["../../../src/interface/cli/cli-command-registry.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AACnF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sCAAsC,CAAC;AAgDrE;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EAAE,EACd,SAAS,EAAE,OAAO,EAClB,YAAY,EAAE,YAAY,EAC1B,sBAAsB,EAAE,sBAAsB,EAC9C,iBAAiB,EAAE;IAAE,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAA;CAAE,GAC5C,OAAO,CAAC,MAAM,CAAC,CA+ejB"}

package/dist/interface/cli/cli-command-registry.js

@@ -1,446 +0,0 @@
-// ─── CLI Command Registry ───
-//
-// Standalone command dispatch for PulSeed CLI subcommands.
-// Called by CLIRunner.run() after init and --yes flag extraction.
-import { parseArgs } from "node:util";
-import { getCliLogger } from "./cli-logger.js";
-// Commands
-import { cmdRun } from "./commands/run.js";
-import { cmdStatus, cmdLog, cmdCleanup } from "./commands/goal.js";
-import { dispatchGoalCommand } from "./commands/goal-dispatch.js";
-import { cmdPluginList, cmdPluginInstall, cmdPluginRemove, cmdPluginUpdate, cmdPluginSearch } from "./commands/plugin.js";
-import { cmdReport } from "./commands/report.js";
-import { cmdApprovalList } from "./commands/approval.js";
-import { cmdProvider, cmdConfigCharacter, cmdConfigShow, cmdConfigSet, cmdConfigGet, cmdDatasourceAdd, cmdDatasourceList, cmdDatasourceRemove, cmdDatasourceDedup, cmdCapabilityList, cmdCapabilityRemove, } from "./commands/config.js";
-import { cmdStart, cmdStop, cmdCron, cmdDaemonStatus, cmdDaemonPing } from "./commands/daemon.js";
-import { cmdSuggest, cmdImprove } from "./commands/suggest.js";
-import { cmdSetup } from "./commands/setup.js";
-import { cmdKnowledgeList, cmdKnowledgeSearch, cmdKnowledgeStats } from "./commands/knowledge.js";
-import { cmdTaskList, cmdTaskShow } from "./commands/task-read.js";
-import { cmdDoctor } from "./commands/doctor.js";
-import { cmdLogs } from "./commands/logs.js";
-import { cmdInstall, cmdUninstall } from "./commands/install.js";
-import { cmdNotify } from "./commands/notify.js";
-import { cmdTelegramSetup } from "./commands/telegram.js";
-import { cmdSchedule } from "./commands/schedule.js";
-import { cmdSkills } from "./commands/skills.js";
-import { printUsage, formatOperationError } from "./utils.js";
-import { ensureProviderConfig } from "./ensure-api-key.js";
-const logger = getCliLogger();
-function formatGoalRequiredError(command, usage) {
-    return `Error: --goal <id> is required for pulseed ${command}.\nUsage: ${usage}`;
-}
-function formatMultiGoalError(command, usage) {
-    return `Error: only one --goal is supported per pulseed ${command}. Run separately for each goal, or use --tree for tree traversal.\nUsage: ${usage}`;
-}
-/**
- * @description Dispatches a PulSeed CLI subcommand and returns an exit code.
- * @param {string[]} argv Filtered arguments (--yes/-y already removed), first element is the subcommand.
- * @param {boolean} globalYes Whether --yes/-y was present globally.
- * @param {StateManager} stateManager Initialised state manager instance.
- * @param {CharacterConfigManager} characterConfigManager Character config manager instance.
- * @param {{ value: CoreLoop | null }} activeCoreLoopRef Mutable ref updated by cmdRun.
- * @returns {Promise<number>} Exit code: 0 for success, 1 for errors, 2 for stall escalation.
- */
-export async function dispatchCommand(argv, globalYes, stateManager, characterConfigManager, activeCoreLoopRef) {
-    if (argv.length === 0) {
-        await ensureProviderConfig({ requireInteractiveSetup: true });
-        const { startTUI } = await import("../tui/entry.js");
-        await startTUI();
-        return 0;
-    }
-    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" },
-                    workspace: { type: "string" },
-                },
-                strict: false,
-            }));
-        }
-        catch (err) {
-            logger.error(formatOperationError("parse run command arguments", err));
-            values = {};
-        }
-        const goalIds = values.goal ?? [];
-        if (goalIds.length === 0) {
-            logger.error(formatGoalRequiredError("run", "pulseed run --goal <id> [--max-iterations <n>] [--adapter <type>] [--tree] [--workspace <path>] [--yes]"));
-            return 1;
-        }
-        if (goalIds.length > 1) {
-            logger.error(formatMultiGoalError("run", "pulseed run --goal <id> [--max-iterations <n>] [--adapter <type>] [--tree] [--workspace <path>] [--yes]"));
-            return 1;
-        }
-        const goalId = goalIds[0];
-        // Add workspace_path constraint to goal if --workspace is provided
-        let resolvedWorkspace = values.workspace;
-        if (resolvedWorkspace) {
-            const goal = await stateManager.loadGoal(goalId);
-            if (goal) {
-                const wpPrefix = "workspace_path:";
-                const existingIdx = goal.constraints.findIndex((c) => c.startsWith(wpPrefix));
-                if (existingIdx >= 0) {
-                    goal.constraints[existingIdx] = `${wpPrefix}${resolvedWorkspace}`;
-                }
-                else {
-                    goal.constraints.push(`${wpPrefix}${resolvedWorkspace}`);
-                }
-                await stateManager.saveGoal(goal);
-            }
-        }
-        else {
-            // No --workspace flag: auto-detect from cwd or use existing constraint
-            const goal = await stateManager.loadGoal(goalId);
-            if (goal) {
-                const wpPrefix = "workspace_path:";
-                const existing = goal.constraints.find((c) => c.startsWith(wpPrefix));
-                if (existing) {
-                    resolvedWorkspace = existing.slice(wpPrefix.length);
-                }
-                else {
-                    // Auto-add workspace_path from cwd so observation can read real files
-                    goal.constraints.push(`${wpPrefix}${process.cwd()}`);
-                    await stateManager.saveGoal(goal);
-                    resolvedWorkspace = process.cwd();
-                }
-            }
-        }
-        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 result = await cmdRun(stateManager, characterConfigManager, goalId, loopConfig, globalYes || values.yes, values.verbose, activeCoreLoopRef, resolvedWorkspace);
-        return result;
-    }
-    if (subcommand === "goal") {
-        return dispatchGoalCommand(argv[1], argv.slice(2), globalYes, stateManager, 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(formatGoalRequiredError("status", "pulseed status --goal <id>"));
-            return 1;
-        }
-        return cmdStatus(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(stateManager, goalId);
-    }
-    if (subcommand === "approval") {
-        const approvalSubcommand = argv[1];
-        if (!approvalSubcommand) {
-            logger.error("Error: approval subcommand required. Available: approval list");
-            return 1;
-        }
-        if (approvalSubcommand === "list") {
-            return await cmdApprovalList(stateManager, argv.slice(2));
-        }
-        logger.error(`Unknown approval subcommand: "${approvalSubcommand}"`);
-        logger.error("Available: approval list");
-        return 1;
-    }
-    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(stateManager, goalId);
-    }
-    if (subcommand === "start") {
-        await cmdStart(stateManager, characterConfigManager, argv.slice(1));
-        return 0;
-    }
-    if (subcommand === "daemon") {
-        const daemonSubcommand = argv[1];
-        if (daemonSubcommand === "start") {
-            await cmdStart(stateManager, characterConfigManager, argv.slice(2));
-            return 0;
-        }
-        if (daemonSubcommand === "stop") {
-            await cmdStop(argv.slice(2));
-            return 0;
-        }
-        if (daemonSubcommand === "status") {
-            await cmdDaemonStatus(argv.slice(2));
-            return 0;
-        }
-        if (daemonSubcommand === "ping") {
-            return await cmdDaemonPing(argv.slice(2));
-        }
-        if (daemonSubcommand === "cron") {
-            await cmdCron(argv.slice(2));
-            return 0;
-        }
-        logger.error(`Unknown daemon subcommand: "${daemonSubcommand ?? ""}"`);
-        logger.error("Available: daemon start, daemon stop, daemon status, daemon ping, daemon cron");
-        return 1;
-    }
-    if (subcommand === "stop") {
-        await cmdStop(argv.slice(1));
-        return 0;
-    }
-    if (subcommand === "cron") {
-        await cmdCron(argv.slice(1));
-        return 0;
-    }
-    if (subcommand === "schedule") {
-        await cmdSchedule(stateManager, argv.slice(1), characterConfigManager);
-        return 0;
-    }
-    if (subcommand === "skills" || subcommand === "skill") {
-        return await cmdSkills(argv.slice(1));
-    }
-    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(stateManager, argv.slice(2));
-        }
-        if (dsSubcommand === "list") {
-            return cmdDatasourceList(stateManager);
-        }
-        if (dsSubcommand === "remove") {
-            return cmdDatasourceRemove(stateManager, argv.slice(2));
-        }
-        if (dsSubcommand === "dedup") {
-            return cmdDatasourceDedup(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(stateManager);
-        }
-        if (capSubcommand === "remove") {
-            return await cmdCapabilityRemove(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(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 show, config set, config get, config character");
-            return 1;
-        }
-        if (configSubcommand === "show") {
-            return cmdConfigShow();
-        }
-        if (configSubcommand === "set") {
-            return cmdConfigSet(argv.slice(2));
-        }
-        if (configSubcommand === "get") {
-            return cmdConfigGet(argv.slice(2));
-        }
-        if (configSubcommand === "character") {
-            return cmdConfigCharacter(characterConfigManager, argv.slice(2));
-        }
-        logger.error(`Unknown config subcommand: "${configSubcommand}"`);
-        logger.error("Available: config show, config set, config get, config character");
-        return 1;
-    }
-    if (subcommand === "suggest") {
-        return await cmdSuggest(stateManager, characterConfigManager, argv.slice(1));
-    }
-    if (subcommand === "improve") {
-        const improveArgs = globalYes ? [...argv.slice(1), "--yes"] : argv.slice(1);
-        return await cmdImprove(stateManager, 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(stateManager);
-        }
-        if (knowledgeSubcommand === "search") {
-            return await cmdKnowledgeSearch(stateManager, argv.slice(2));
-        }
-        if (knowledgeSubcommand === "stats") {
-            return await cmdKnowledgeStats(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(stateManager, argv.slice(2));
-        }
-        if (taskSubcommand === "show") {
-            return await cmdTaskShow(stateManager, argv.slice(2));
-        }
-        logger.error(`Unknown task subcommand: "${taskSubcommand}"`);
-        logger.error("Available: task list, task show");
-        return 1;
-    }
-    if (subcommand === "mcp-server") {
-        const { startMCPServer } = await import("../mcp-server/index.js");
-        await startMCPServer({ stateManager, baseDir: stateManager.getBaseDir() });
-        return 0;
-    }
-    if (subcommand === "doctor") {
-        return await cmdDoctor(argv.slice(1));
-    }
-    if (subcommand === "logs") {
-        return await cmdLogs(argv.slice(1));
-    }
-    if (subcommand === "install") {
-        return await cmdInstall(argv.slice(1));
-    }
-    if (subcommand === "uninstall") {
-        return await cmdUninstall(argv.slice(1));
-    }
-    if (subcommand === "notify") {
-        return await cmdNotify(argv.slice(1));
-    }
-    if (subcommand === "telegram") {
-        const telegramSubcommand = argv[1];
-        if (telegramSubcommand === "setup") {
-            return await cmdTelegramSetup(argv.slice(2));
-        }
-        logger.error(`Unknown telegram subcommand: "${telegramSubcommand ?? ""}"`);
-        logger.error("Available: telegram setup");
-        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;
-}
-//# sourceMappingURL=cli-command-registry.js.map