pulseed 0.4.17 → 0.4.19

package/dist/interface/chat/mutation-tool-defs.js

@@ -0,0 +1,149 @@
+import { buildConfigToolDescription, buildMutationToolDescription, } from "../../base/config/tool-metadata.js";
+const DEFAULT_APPROVAL_LEVELS = {
+    set_goal: "none",
+    update_goal: "none",
+    archive_goal: "required",
+    delete_goal: "required",
+    toggle_plugin: "required",
+    update_config: "required",
+    reset_trust: "required",
+};
+export async function checkApproval(toolName, description, deps) {
+    const level = deps.approvalConfig?.[toolName] ?? DEFAULT_APPROVAL_LEVELS[toolName] ?? "required";
+    if (level === "none") {
+        return { approved: true };
+    }
+    if (!deps.approvalFn) {
+        return {
+            approved: false,
+            error: "This operation requires approval but no approval handler is configured",
+        };
+    }
+    const approved = await deps.approvalFn(description);
+    return approved ? { approved: true } : { approved: false, error: "User denied the operation" };
+}
+/**
+ * @deprecated Use ToolRegistry.listAll() + toToolDefinitions() instead.
+ * This remains for older chat tests and external callers.
+ */
+export function getMutationToolDefinitions() {
+    return [
+        {
+            type: "function",
+            function: {
+                name: "set_goal",
+                description: "Create a new active goal from a user-provided description.",
+                parameters: {
+                    type: "object",
+                    properties: {
+                        description: {
+                            type: "string",
+                            description: "Goal description to create.",
+                        },
+                    },
+                    required: ["description"],
+                },
+            },
+        },
+        {
+            type: "function",
+            function: {
+                name: "update_goal",
+                description: "Update a goal description or status. Use archive_goal for archiving.",
+                parameters: {
+                    type: "object",
+                    properties: {
+                        goal_id: { type: "string", description: "Goal ID to update." },
+                        description: { type: "string", description: "Updated goal description." },
+                        status: {
+                            type: "string",
+                            enum: ["active", "paused", "completed"],
+                            description: "Updated goal status.",
+                        },
+                    },
+                    required: ["goal_id"],
+                },
+            },
+        },
+        {
+            type: "function",
+            function: {
+                name: "archive_goal",
+                description: "Archive an existing goal after user approval.",
+                parameters: {
+                    type: "object",
+                    properties: {
+                        goal_id: { type: "string", description: "Goal ID to archive." },
+                    },
+                    required: ["goal_id"],
+                },
+            },
+        },
+        {
+            type: "function",
+            function: {
+                name: "delete_goal",
+                description: buildMutationToolDescription("delete_goal"),
+                parameters: {
+                    type: "object",
+                    properties: {
+                        goal_id: { type: "string", description: "Goal ID to permanently delete." },
+                    },
+                    required: ["goal_id"],
+                },
+            },
+        },
+        {
+            type: "function",
+            function: {
+                name: "toggle_plugin",
+                description: "Enable or disable a plugin. This currently reports that chat-based plugin toggling is unsupported.",
+                parameters: {
+                    type: "object",
+                    properties: {
+                        plugin_name: { type: "string", description: "Plugin name." },
+                        enabled: { type: "boolean", description: "Whether the plugin should be enabled." },
+                    },
+                    required: ["plugin_name", "enabled"],
+                },
+            },
+        },
+        {
+            type: "function",
+            function: {
+                name: "update_config",
+                description: buildConfigToolDescription(),
+                parameters: {
+                    type: "object",
+                    properties: {
+                        key: { type: "string", description: "Configuration key to update." },
+                        value: { description: "New configuration value." },
+                    },
+                    required: ["key", "value"],
+                },
+            },
+        },
+        {
+            type: "function",
+            function: {
+                name: "reset_trust",
+                description: "Set a trust balance override for a domain after explicit user approval.",
+                parameters: {
+                    type: "object",
+                    properties: {
+                        domain: { type: "string", description: "Trust domain to override." },
+                        balance: {
+                            type: "number",
+                            minimum: -100,
+                            maximum: 100,
+                            description: "Trust balance from -100 to 100.",
+                        },
+                        reason: { type: "string", description: "Reason for the override." },
+                    },
+                    required: ["domain", "balance", "reason"],
+                },
+            },
+        },
+    ];
+}
+//# sourceMappingURL=mutation-tool-defs.js.map

package/dist/interface/chat/mutation-tool-defs.js.map

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

package/dist/interface/chat/tend-command.d.ts

@@ -0,0 +1,51 @@
+import type { ILLMClient } from "../../base/llm/llm-client.js";
+import type { GoalNegotiator } from "../../orchestrator/goal/goal-negotiator.js";
+import type { DaemonClient } from "../../runtime/daemon/client.js";
+import type { StateManager } from "../../base/state/state-manager.js";
+import type { Goal } from "../../base/types/goal.js";
+import type { ChatMessage } from "./chat-history.js";
+export interface TendDeps {
+    llmClient: ILLMClient;
+    goalNegotiator: GoalNegotiator;
+    daemonClient: DaemonClient;
+    stateManager: StateManager;
+    chatHistory: ChatMessage[];
+}
+export interface TendResult {
+    success: boolean;
+    goalId?: string;
+    goalTitle?: string;
+    /** maxIterations from parsed args, carried through confirmation flow. */
+    maxIterations?: number;
+    /** Formatted message for chat display. */
+    message: string;
+    /** Formatted confirmation prompt shown to user before daemon start. */
+    confirmation?: string;
+    /** True when execution is paused waiting for user confirmation. */
+    needsConfirmation?: boolean;
+}
+export declare class TendCommand {
+    /**
+     * Main entry point for /tend.
+     * Parses args, optionally generates a goal from chat history,
+     * and starts the daemon.
+     */
+    execute(args: string, deps: TendDeps): Promise<TendResult>;
+    /**
+     * Summarize recent chat messages into a concise objective string.
+     */
+    summarizeChat(history: ChatMessage[], llmClient: ILLMClient): Promise<string>;
+    /**
+     * Generate a structured Goal from a plain-text summary via GoalNegotiator.
+     */
+    generateGoal(summary: string, goalNegotiator: GoalNegotiator): Promise<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: Goal): string;
+    private tendExistingGoal;
+    private tendFromChat;
+    private startDaemon;
+}
+//# sourceMappingURL=tend-command.d.ts.map

package/dist/interface/chat/tend-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tend-command.d.ts","sourceRoot":"","sources":["../../../src/interface/chat/tend-command.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4CAA4C,CAAC;AACjF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,UAAU,CAAC;IACtB,cAAc,EAAE,cAAc,CAAC;IAC/B,YAAY,EAAE,YAAY,CAAC;IAC3B,YAAY,EAAE,YAAY,CAAC;IAC3B,WAAW,EAAE,WAAW,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mEAAmE;IACnE,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAYD,qBAAa,WAAW;IACtB;;;;OAIG;IACG,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC;IAoBhE;;OAEG;IACG,aAAa,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,SAAS,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAoBnF;;OAEG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAOlF;;;OAGG;IACH,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM;YAmCxB,gBAAgB;YAehB,YAAY;YAsCZ,WAAW;CAsB1B"}

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

@@ -0,0 +1,183 @@
+// --- 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

@@ -0,0 +1 @@
+{"version":3,"file":"tend-command.js","sourceRoot":"","sources":["../../../src/interface/chat/tend-command.ts"],"names":[],"mappings":"AAAA,sBAAsB;AACtB,EAAE;AACF,oDAAoD;AACpD,gEAAgE;AAChE,2EAA2E;AAiC3E,oBAAoB;AAEpB,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAChC,MAAM,cAAc,GAAG;;;sCAGe,CAAC;AAEvC,sBAAsB;AAEtB,MAAM,OAAO,WAAW;IACtB;;;;OAIG;IACH,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,IAAc;QACxC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAElD,uDAAuD;QACvD,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,CAAC,CAAC;QAC5D,CAAC;QAED,uCAAuC;QACvC,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClC,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,4EAA4E;aACtF,CAAC;QACJ,CAAC;QAED,+CAA+C;QAC/C,OAAO,IAAI,CAAC,YAAY,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;IAChD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CAAC,OAAsB,EAAE,SAAqB;QAC/D,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,oBAAoB,CAAC,CAAC;QACpD,MAAM,UAAU,GAAG,MAAM;aACtB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;aACvE,IAAI,CAAC,IAAI,CAAC,CAAC;QAEd,MAAM,MAAM,GAAG,GAAG,cAAc,sBAAsB,UAAU,EAAE,CAAC;QAEnE,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,WAAW,CAC1C,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,EACnC,EAAE,UAAU,EAAE,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,CACzC,CAAC;YACF,OAAO,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QACjC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,MAAM,IAAI,KAAK,CAAC,6BAA6B,GAAG,EAAE,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY,CAAC,OAAe,EAAE,cAA8B;QAChE,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,SAAS,CAAC,OAAO,EAAE;YACrD,WAAW,EAAE,CAAC,yCAAyC,CAAC;SACzD,CAAC,CAAC;QACH,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC;IAED;;;OAGG;IACH,kBAAkB,CAAC,IAAU;QAC3B,MAAM,KAAK,GAAa;YACtB,uBAAuB;YACvB,EAAE;YACF,YAAY,IAAI,CAAC,KAAK,EAAE;SACzB,CAAC;QAEF,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/B,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YAC5B,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBAClC,MAAM,CAAC,GAAG,GAAG,CAAC,SAAS,CAAC;gBACxB,IAAI,YAAY,GAAG,EAAE,CAAC;gBACtB,IAAI,CAAC,CAAC,IAAI,KAAK,KAAK;oBAAE,YAAY,GAAG,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC;qBACjD,IAAI,CAAC,CAAC,IAAI,KAAK,KAAK;oBAAE,YAAY,GAAG,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC;qBACtD,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO;oBAAE,YAAY,GAAG,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;qBAC5D,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS;oBAAE,YAAY,GAAG,SAAS,CAAC;qBACnD,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO;oBAAE,YAAY,GAAG,UAAU,CAAC,CAAC,KAAK,EAAE,CAAC;gBAChE,KAAK,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC,CAAC;YACnD,CAAC;QACH,CAAC;QAED,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpD,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;YAC7B,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACtB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,0BAA0B;IAElB,KAAK,CAAC,gBAAgB,CAC5B,MAAc,EACd,aAAiC,EACjC,IAAc;QAEd,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACtD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,mBAAmB,MAAM,EAAE;aACrC,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;IAClE,CAAC;IAEO,KAAK,CAAC,YAAY,CACxB,aAAiC,EACjC,IAAc;QAEd,IAAI,OAAe,CAAC;QACpB,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QACvE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,6BAA6B,GAAG,4DAA4D;aACtG,CAAC;QACJ,CAAC;QAED,IAAI,IAAU,CAAC;QACf,IAAI,CAAC;YACH,IAAI,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;QAC/D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,4BAA4B,GAAG,+DAA+D;aACxG,CAAC;QACJ,CAAC;QAED,MAAM,YAAY,GAAG,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;QACnD,OAAO;YACL,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,IAAI,CAAC,EAAE;YACf,SAAS,EAAE,IAAI,CAAC,KAAK;YACrB,aAAa;YACb,OAAO,EAAE,mCAAmC;YAC5C,YAAY;YACZ,iBAAiB,EAAE,IAAI;SACxB,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,WAAW,CACvB,IAAU,EACV,aAAiC,EACjC,YAA0B;QAE1B,IAAI,CAAC;YACH,MAAM,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACtC,MAAM,QAAQ,GAAG,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,aAAa,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;YACzF,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,IAAI,CAAC,EAAE;gBACf,SAAS,EAAE,IAAI,CAAC,KAAK;gBACrB,OAAO,EAAE,aAAa,IAAI,CAAC,EAAE,gBAAgB,IAAI,CAAC,KAAK,IAAI,QAAQ,2CAA2C;aAC/G,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,uBAAuB,GAAG,uDAAuD;aAC3F,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AAED,sBAAsB;AAEtB,SAAS,SAAS,CAAC,IAAY;IAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACvD,IAAI,MAA0B,CAAC;IAC/B,IAAI,aAAiC,CAAC;IAEtC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,OAAO,IAAI,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YACzC,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACrC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;gBAAE,aAAa,GAAG,CAAC,CAAC;YAC1C,CAAC,EAAE,CAAC;QACN,CAAC;aAAM,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACtC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;AACnC,CAAC"}

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

@@ -0,0 +1,16 @@
+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

@@ -0,0 +1 @@
+{"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;AAmDrE;;;;;;;;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,CA2fjB"}