pulseed 0.1.4 → 0.2.0

package/dist/interface/chat/chat-runner.js

@@ -0,0 +1,282 @@
+// ─── ChatRunner ───
+//
+// Central coordinator for 1-shot chat execution (Tier 1).
+// Bypasses TaskLifecycle — calls adapter.execute() directly.
+import { execFile } from "node:child_process";
+import { ChatHistory } from "./chat-history.js";
+import { buildChatContext, resolveGitRoot } from "../../platform/observation/context-provider.js";
+import { buildSystemPrompt } from "./grounding.js";
+import { verifyChatAction } from "./chat-verifier.js";
+import { getSelfKnowledgeToolDefinitions, handleSelfKnowledgeToolCall } from "./self-knowledge-tools.js";
+import { getMutationToolDefinitions, handleMutationToolCall } from "./self-knowledge-mutation-tools.js";
+const DEFAULT_TIMEOUT_MS = 120_000;
+const MAX_VERIFY_RETRIES = 2;
+const MAX_TOOL_LOOPS = 5;
+// ─── Command help text ───
+const COMMAND_HELP = `Available commands:
+  /help    Show this help message
+  /clear   Clear conversation history
+  /exit    Exit chat mode
+  /track   Promote session to Tier 2 goal pursuit (not yet implemented)`;
+// ─── Helpers ───
+function checkGitChanges(cwd) {
+    return new Promise((resolve) => {
+        execFile("git", ["diff", "HEAD", "--stat"], { cwd, timeout: 5_000 }, (err, stdout, stderr) => {
+            resolve(err ? null : (stdout + stderr).trim());
+        });
+    });
+}
+// ─── ChatRunner ───
+export class ChatRunner {
+    deps;
+    history = null;
+    sessionCwd = null;
+    /** True when startSession() has been called — enables session persistence across execute() calls. */
+    sessionActive = false;
+    /** Cached system prompt — built once per session, reused across turns. */
+    cachedSystemPrompt = null;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /**
+     * Initialize a persistent session for interactive (multi-turn) mode.
+     * Must be called before the first execute() to share history across turns.
+     * If not called, execute() auto-creates a new session per call (Phase 1a behavior).
+     */
+    startSession(cwd) {
+        const gitRoot = resolveGitRoot(cwd);
+        const sessionId = crypto.randomUUID();
+        this.history = new ChatHistory(this.deps.stateManager, sessionId, gitRoot);
+        this.sessionCwd = gitRoot;
+        this.sessionActive = true;
+    }
+    async handleCommand(input) {
+        const trimmed = input.trim();
+        if (!trimmed.startsWith("/"))
+            return null;
+        const cmd = trimmed.toLowerCase().split(/\s+/)[0];
+        const start = Date.now();
+        if (cmd === "/help") {
+            return { success: true, output: COMMAND_HELP, elapsed_ms: Date.now() - start };
+        }
+        if (cmd === "/clear") {
+            this.history?.clear();
+            return { success: true, output: "Conversation history cleared.", elapsed_ms: Date.now() - start };
+        }
+        if (cmd === "/exit") {
+            return { success: true, output: "Exiting chat mode.", elapsed_ms: Date.now() - start };
+        }
+        if (cmd === "/track") {
+            return this.handleTrack(start);
+        }
+        return {
+            success: false,
+            output: `Unknown command: ${input.trim()}. Type /help for available commands.`,
+            elapsed_ms: Date.now() - start,
+        };
+    }
+    async handleTrack(start) {
+        if (!this.deps.escalationHandler) {
+            return {
+                success: false,
+                output: "Escalation not available — missing LLM configuration",
+                elapsed_ms: Date.now() - start,
+            };
+        }
+        if (!this.history || this.history.getMessages().length === 0) {
+            return {
+                success: false,
+                output: "No conversation to escalate. Chat first, then /track.",
+                elapsed_ms: Date.now() - start,
+            };
+        }
+        try {
+            const result = await this.deps.escalationHandler.escalateToGoal(this.history);
+            return {
+                success: true,
+                output: `Goal created: ${result.title} (ID: ${result.goalId})\nRun: pulseed run --goal ${result.goalId} --yes`,
+                elapsed_ms: Date.now() - start,
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                success: false,
+                output: `Escalation failed: ${message}`,
+                elapsed_ms: Date.now() - start,
+            };
+        }
+    }
+    /**
+     * Execute a single chat turn.
+     *
+     * Flow:
+     *  1. Intercept slash commands before adapter dispatch
+     *  2. Resolve git root → create ChatHistory
+     *  3. Build chat context and assemble prompt
+     *  4. Persist user message BEFORE calling adapter (crash-safe)
+     *  5. Execute via adapter
+     *  6. Verify changes (git diff + tests); retry up to MAX_VERIFY_RETRIES if tests fail
+     *  7. Persist assistant response (fire-and-forget)
+     */
+    async execute(input, cwd, timeoutMs = DEFAULT_TIMEOUT_MS) {
+        // Intercept commands before any adapter call
+        const commandResult = await this.handleCommand(input);
+        if (commandResult !== null) {
+            return commandResult;
+        }
+        // Reuse session (interactive mode) or create a fresh one per call (1-shot mode)
+        if (!this.sessionActive) {
+            const gitRoot = resolveGitRoot(cwd);
+            const sessionId = crypto.randomUUID();
+            this.history = new ChatHistory(this.deps.stateManager, sessionId, gitRoot);
+        }
+        const gitRoot = this.sessionCwd ?? resolveGitRoot(cwd);
+        // history is always assigned by this point (either by startSession or the block above)
+        const history = this.history;
+        // Persist-before-execute: user message written to disk first
+        await history.appendUserMessage(input);
+        // Build grounding system prompt on first turn, cache for session
+        if (this.cachedSystemPrompt === null) {
+            try {
+                this.cachedSystemPrompt = await buildSystemPrompt({ stateManager: this.deps.stateManager });
+            }
+            catch {
+                this.cachedSystemPrompt = "";
+            }
+        }
+        // Build conversation history from prior turns (last 10)
+        const messages = history.getMessages();
+        const priorTurns = messages.slice(0, -1).slice(-10);
+        let historyBlock = "";
+        if (priorTurns.length > 0) {
+            const lines = priorTurns.map((m) => `${m.role === "user" ? "User" : "Assistant"}: ${m.content}`).join("\n");
+            historyBlock = `Previous conversation:\n${lines}\n\nCurrent message:\n`;
+        }
+        const context = await buildChatContext(input, gitRoot);
+        const basePrompt = context ? `${context}\n\n${input}` : input;
+        const prompt = historyBlock ? `${historyBlock}${basePrompt}` : basePrompt;
+        const start = Date.now();
+        // Use llmClient with self-knowledge tools when available (function calling path)
+        // Skip executeWithTools for clients that don't support tool calling (e.g. CodexLLMClient)
+        if (this.deps.llmClient && this.deps.llmClient.supportsToolCalling?.() !== false) {
+            const toolResult = await this.executeWithTools(prompt, this.cachedSystemPrompt ?? undefined);
+            const elapsed_ms = Date.now() - start;
+            await history.appendAssistantMessage(toolResult);
+            return { success: true, output: toolResult, elapsed_ms };
+        }
+        const task = {
+            prompt,
+            timeout_ms: timeoutMs,
+            adapter_type: this.deps.adapter.adapterType,
+            cwd,
+            ...(this.cachedSystemPrompt ? { system_prompt: this.cachedSystemPrompt } : {}),
+        };
+        let result = await this.deps.adapter.execute(task);
+        const elapsed_ms = Date.now() - start;
+        // Verification loop: check if git has uncommitted changes; if so, run tests
+        const gitChanges = await checkGitChanges(gitRoot);
+        if (gitChanges !== null && gitChanges !== "") {
+            let retries = 0;
+            let verification = await verifyChatAction(gitRoot, this.deps.toolExecutor);
+            while (!verification.passed && retries < MAX_VERIFY_RETRIES) {
+                retries++;
+                const retryPrompt = `The previous changes caused test failures. Please fix them.\n\nTest output:\n${verification.testOutput ?? verification.errors.join("\n")}`;
+                const retryTask = { ...task, prompt: retryPrompt };
+                result = await this.deps.adapter.execute(retryTask);
+                verification = await verifyChatAction(gitRoot, this.deps.toolExecutor);
+            }
+            if (!verification.passed) {
+                // Fire-and-forget: persist assistant response
+                history.appendAssistantMessage(result.output);
+                return {
+                    success: false,
+                    output: `Changes applied but tests are still failing after ${MAX_VERIFY_RETRIES} retries. Please intervene manually.\n\nTest output:\n${verification.testOutput ?? verification.errors.join("\n")}`,
+                    elapsed_ms: Date.now() - start,
+                };
+            }
+        }
+        // Fire-and-forget: persist assistant response after completion
+        history.appendAssistantMessage(result.output);
+        return {
+            success: result.success,
+            output: result.output,
+            elapsed_ms,
+        };
+    }
+    /**
+     * Execute a chat turn using llmClient with self-knowledge tools (function calling).
+     * Loops up to MAX_TOOL_LOOPS times to resolve tool calls, then returns final text.
+     */
+    async executeWithTools(prompt, systemPrompt) {
+        const llmClient = this.deps.llmClient;
+        const tools = [...getSelfKnowledgeToolDefinitions(), ...getMutationToolDefinitions()];
+        const skDeps = this.buildSelfKnowledgeDeps();
+        const mutDeps = this.buildMutationToolDeps();
+        const messages = [{ role: "user", content: prompt }];
+        const mutationToolNames = new Set([
+            "set_goal", "update_goal", "archive_goal", "delete_goal",
+            "toggle_plugin", "update_config", "reset_trust",
+        ]);
+        for (let loop = 0; loop < MAX_TOOL_LOOPS; loop++) {
+            let response;
+            try {
+                response = await llmClient.sendMessage(messages, {
+                    tools,
+                    ...(systemPrompt ? { system: systemPrompt } : {}),
+                });
+            }
+            catch (err) {
+                console.error("[chat-runner] executeWithTools error:", err);
+                const hint = err instanceof Error ? `: ${err.message}` : "";
+                return `Sorry, I encountered an error processing your request${hint}.`;
+            }
+            // No tool calls — return the text content
+            if (!response.tool_calls || response.tool_calls.length === 0) {
+                return response.content || "(no response)";
+            }
+            // Append assistant message, then process tool calls
+            messages.push({ role: "assistant", content: response.content || "" });
+            for (const tc of response.tool_calls) {
+                let args = {};
+                try {
+                    args = JSON.parse(tc.function.arguments || "{}");
+                }
+                catch {
+                    // ignore parse errors, use empty args
+                }
+                const toolResult = mutationToolNames.has(tc.function.name)
+                    ? await handleMutationToolCall(tc.function.name, args, mutDeps)
+                    : await handleSelfKnowledgeToolCall(tc.function.name, args, skDeps);
+                messages.push({ role: "user", content: `Tool result for ${tc.function.name}:\n${toolResult}` });
+            }
+        }
+        // Max loops reached — return last assistant content or fallback
+        const lastAssistant = [...messages].reverse().find(m => m.role === "assistant");
+        return lastAssistant?.content || "I was unable to complete the request within the allowed tool call limit.";
+    }
+    /** Build SelfKnowledgeDeps from ChatRunnerDeps. */
+    buildSelfKnowledgeDeps() {
+        return {
+            stateManager: this.deps.stateManager,
+            trustManager: this.deps.trustManager,
+            pluginLoader: this.deps.pluginLoader,
+            homeDir: process.env.HOME ?? process.env.USERPROFILE ?? "/tmp",
+        };
+    }
+    /** Build MutationToolDeps from ChatRunnerDeps. */
+    buildMutationToolDeps() {
+        const tm = this.deps.trustManager;
+        const pl = this.deps.pluginLoader;
+        return {
+            stateManager: this.deps.stateManager,
+            trustManager: tm && "setOverride" in tm ? tm : undefined,
+            pluginLoader: pl && "getPluginState" in pl && "updatePluginState" in pl
+                ? pl
+                : undefined,
+            approvalFn: this.deps.approvalFn,
+            approvalConfig: this.deps.approvalConfig,
+        };
+    }
+}
+//# sourceMappingURL=chat-runner.js.map

package/dist/interface/chat/chat-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-runner.js","sourceRoot":"","sources":["../../../src/interface/chat/chat-runner.ts"],"names":[],"mappings":"AAAA,qBAAqB;AACrB,EAAE;AACF,0DAA0D;AAC1D,6DAA6D;AAE7D,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAI9C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,gDAAgD,CAAC;AAElG,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,+BAA+B,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AAEzG,OAAO,EAAE,0BAA0B,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAkCxG,MAAM,kBAAkB,GAAG,OAAO,CAAC;AACnC,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAC7B,MAAM,cAAc,GAAG,CAAC,CAAC;AAEzB,4BAA4B;AAE5B,MAAM,YAAY,GAAG;;;;wEAImD,CAAC;AAEzE,kBAAkB;AAElB,SAAS,eAAe,CAAC,GAAW;IAClC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,QAAQ,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;YAC3F,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACjD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,qBAAqB;AAErB,MAAM,OAAO,UAAU;IACJ,IAAI,CAAiB;IAC9B,OAAO,GAAuB,IAAI,CAAC;IACnC,UAAU,GAAkB,IAAI,CAAC;IACzC,qGAAqG;IAC7F,aAAa,GAAG,KAAK,CAAC;IAC9B,0EAA0E;IAClE,kBAAkB,GAAkB,IAAI,CAAC;IAEjD,YAAY,IAAoB;QAC9B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED;;;;OAIG;IACH,YAAY,CAAC,GAAW;QACtB,MAAM,OAAO,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;QACpC,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;QACtC,IAAI,CAAC,OAAO,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QAC3E,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC;QAC1B,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;IAC5B,CAAC;IAEO,KAAK,CAAC,aAAa,CAAC,KAAa;QACvC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QAC7B,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QAE1C,MAAM,GAAG,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAClD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEzB,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;YACpB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC;QACjF,CAAC;QACD,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;YACrB,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC;YACtB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,+BAA+B,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC;QACpG,CAAC;QACD,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;YACpB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,oBAAoB,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC;QACzF,CAAC;QACD,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;YACrB,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC;QAED,OAAO;YACL,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,oBAAoB,KAAK,CAAC,IAAI,EAAE,sCAAsC;YAC9E,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;SAC/B,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,WAAW,CAAC,KAAa;QACrC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACjC,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,sDAAsD;gBAC9D,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;aAC/B,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7D,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,uDAAuD;gBAC/D,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;aAC/B,CAAC;QACJ,CAAC;QACD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC9E,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,iBAAiB,MAAM,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,8BAA8B,MAAM,CAAC,MAAM,QAAQ;gBAC9G,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;aAC/B,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,sBAAsB,OAAO,EAAE;gBACvC,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;aAC/B,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,OAAO,CAAC,KAAa,EAAE,GAAW,EAAE,SAAS,GAAG,kBAAkB;QACtE,6CAA6C;QAC7C,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QACtD,IAAI,aAAa,KAAK,IAAI,EAAE,CAAC;YAC3B,OAAO,aAAa,CAAC;QACvB,CAAC;QAED,gFAAgF;QAChF,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,MAAM,OAAO,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;YACpC,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;YACtC,IAAI,CAAC,OAAO,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QAC7E,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,IAAI,cAAc,CAAC,GAAG,CAAC,CAAC;QAEvD,uFAAuF;QACvF,MAAM,OAAO,GAAG,IAAI,CAAC,OAAQ,CAAC;QAE9B,6DAA6D;QAC7D,MAAM,OAAO,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAEvC,iEAAiE;QACjE,IAAI,IAAI,CAAC,kBAAkB,KAAK,IAAI,EAAE,CAAC;YACrC,IAAI,CAAC;gBACH,IAAI,CAAC,kBAAkB,GAAG,MAAM,iBAAiB,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;YAC9F,CAAC;YAAC,MAAM,CAAC;gBACP,IAAI,CAAC,kBAAkB,GAAG,EAAE,CAAC;YAC/B,CAAC;QACH,CAAC;QAED,wDAAwD;QACxD,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;QACvC,MAAM,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;QACpD,IAAI,YAAY,GAAG,EAAE,CAAC;QACtB,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAoC,EAAE,EAAE,CACpE,GAAG,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,KAAK,CAAC,CAAC,OAAO,EAAE,CAC5D,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACb,YAAY,GAAG,2BAA2B,KAAK,wBAAwB,CAAC;QAC1E,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACvD,MAAM,UAAU,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;QAC9D,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,YAAY,GAAG,UAAU,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC;QAE1E,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEzB,iFAAiF;QACjF,0FAA0F;QAC1F,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,mBAAmB,EAAE,EAAE,KAAK,KAAK,EAAE,CAAC;YACjF,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,kBAAkB,IAAI,SAAS,CAAC,CAAC;YAC7F,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;YACtC,MAAM,OAAO,CAAC,sBAAsB,CAAC,UAAU,CAAC,CAAC;YACjD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC;QAC3D,CAAC;QAED,MAAM,IAAI,GAAc;YACtB,MAAM;YACN,UAAU,EAAE,SAAS;YACrB,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW;YAC3C,GAAG;YACH,GAAG,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,IAAI,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC/E,CAAC;QACF,IAAI,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACnD,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;QAEtC,4EAA4E;QAC5E,MAAM,UAAU,GAAG,MAAM,eAAe,CAAC,OAAO,CAAC,CAAC;QAClD,IAAI,UAAU,KAAK,IAAI,IAAI,UAAU,KAAK,EAAE,EAAE,CAAC;YAC7C,IAAI,OAAO,GAAG,CAAC,CAAC;YAChB,IAAI,YAAY,GAAG,MAAM,gBAAgB,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAE3E,OAAO,CAAC,YAAY,CAAC,MAAM,IAAI,OAAO,GAAG,kBAAkB,EAAE,CAAC;gBAC5D,OAAO,EAAE,CAAC;gBACV,MAAM,WAAW,GAAG,gFAAgF,YAAY,CAAC,UAAU,IAAI,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAChK,MAAM,SAAS,GAAc,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;gBAC9D,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;gBACpD,YAAY,GAAG,MAAM,gBAAgB,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACzE,CAAC;YAED,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC;gBACzB,8CAA8C;gBAC9C,OAAO,CAAC,sBAAsB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBAC9C,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,MAAM,EAAE,qDAAqD,kBAAkB,yDAAyD,YAAY,CAAC,UAAU,IAAI,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;oBACnM,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;iBAC/B,CAAC;YACJ,CAAC;QACH,CAAC;QAED,+DAA+D;QAC/D,OAAO,CAAC,sBAAsB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAE9C,OAAO;YACL,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,UAAU;SACX,CAAC;IACJ,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,gBAAgB,CAAC,MAAc,EAAE,YAAqB;QAClE,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,SAAU,CAAC;QACvC,MAAM,KAAK,GAAG,CAAC,GAAG,+BAA+B,EAAE,EAAE,GAAG,0BAA0B,EAAE,CAAC,CAAC;QACtF,MAAM,MAAM,GAAG,IAAI,CAAC,sBAAsB,EAAE,CAAC;QAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,qBAAqB,EAAE,CAAC;QAC7C,MAAM,QAAQ,GAAiB,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QACnE,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC;YAChC,UAAU,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa;YACxD,eAAe,EAAE,eAAe,EAAE,aAAa;SAChD,CAAC,CAAC;QAEH,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,cAAc,EAAE,IAAI,EAAE,EAAE,CAAC;YACjD,IAAI,QAAqB,CAAC;YAC1B,IAAI,CAAC;gBACH,QAAQ,GAAG,MAAM,SAAS,CAAC,WAAW,CAAC,QAAQ,EAAE;oBAC/C,KAAK;oBACL,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAClD,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,KAAK,CAAC,uCAAuC,EAAE,GAAG,CAAC,CAAC;gBAC5D,MAAM,IAAI,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC5D,OAAO,wDAAwD,IAAI,GAAG,CAAC;YACzE,CAAC;YAED,0CAA0C;YAC1C,IAAI,CAAC,QAAQ,CAAC,UAAU,IAAI,QAAQ,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC7D,OAAO,QAAQ,CAAC,OAAO,IAAI,eAAe,CAAC;YAC7C,CAAC;YAED,oDAAoD;YACpD,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC,CAAC;YAEtE,KAAK,MAAM,EAAE,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;gBACrC,IAAI,IAAI,GAA4B,EAAE,CAAC;gBACvC,IAAI,CAAC;oBACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,CAAC,SAAS,IAAI,IAAI,CAA4B,CAAC;gBAC9E,CAAC;gBAAC,MAAM,CAAC;oBACP,sCAAsC;gBACxC,CAAC;gBACD,MAAM,UAAU,GAAG,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC;oBACxD,CAAC,CAAC,MAAM,sBAAsB,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC;oBAC/D,CAAC,CAAC,MAAM,2BAA2B,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;gBACtE,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,EAAE,CAAC,QAAQ,CAAC,IAAI,MAAM,UAAU,EAAE,EAAE,CAAC,CAAC;YAClG,CAAC;QACH,CAAC;QAED,gEAAgE;QAChE,MAAM,aAAa,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC;QAChF,OAAO,aAAa,EAAE,OAAO,IAAI,0EAA0E,CAAC;IAC9G,CAAC;IAED,mDAAmD;IAC3C,sBAAsB;QAC5B,OAAO;YACL,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,YAAY;YACpC,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,YAAY;YACpC,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,YAAiD;YACzE,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,MAAM;SAC/D,CAAC;IACJ,CAAC;IAED,kDAAkD;IAC1C,qBAAqB;QAC3B,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC;QAClC,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC;QAClC,OAAO;YACL,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,YAAY;YACpC,YAAY,EAAE,EAAE,IAAI,aAAa,IAAI,EAAE,CAAC,CAAC,CAAE,EAAmB,CAAC,CAAC,CAAC,SAAS;YAC1E,YAAY,EAAE,EAAE,IAAI,gBAAgB,IAAI,EAAE,IAAI,mBAAmB,IAAI,EAAE;gBACrE,CAAC,CAAE,EAAmB;gBACtB,CAAC,CAAC,SAAS;YACb,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU;YAChC,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,cAAc;SACzC,CAAC;IACJ,CAAC;CACF"}

package/dist/interface/chat/chat-verifier.d.ts

@@ -0,0 +1,14 @@
+import type { ToolExecutor } from "../../tools/executor.js";
+export interface ChatVerificationResult {
+    passed: boolean;
+    errors: string[];
+    testOutput?: string;
+}
+/**
+ * Verify a chat-mode code action:
+ * 1. Check git diff HEAD — if no changes, skip.
+ * 2. Run vitest — return failure if tests break.
+ * Gracefully degrades (returns passed=true) if tools are unavailable.
+ */
+export declare function verifyChatAction(cwd: string, toolExecutor?: ToolExecutor): Promise<ChatVerificationResult>;
+//# sourceMappingURL=chat-verifier.d.ts.map

package/dist/interface/chat/chat-verifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-verifier.d.ts","sourceRoot":"","sources":["../../../src/interface/chat/chat-verifier.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAI5D,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAYD;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,MAAM,EACX,YAAY,CAAC,EAAE,YAAY,GAC1B,OAAO,CAAC,sBAAsB,CAAC,CAoCjC"}

package/dist/interface/chat/chat-verifier.js

@@ -0,0 +1,41 @@
+function makeContext(cwd) {
+    return {
+        cwd,
+        goalId: "chat-verify",
+        trustBalance: 50,
+        preApproved: true,
+        approvalFn: async () => true,
+    };
+}
+/**
+ * Verify a chat-mode code action:
+ * 1. Check git diff HEAD — if no changes, skip.
+ * 2. Run vitest — return failure if tests break.
+ * Gracefully degrades (returns passed=true) if tools are unavailable.
+ */
+export async function verifyChatAction(cwd, toolExecutor) {
+    if (!toolExecutor)
+        return { passed: true, errors: [] };
+    const ctx = makeContext(cwd);
+    // Step 1: Check for git changes (use HEAD comparison)
+    const diffResult = await toolExecutor.execute("git_diff", { target: "head", maxLines: 1 }, ctx).catch(() => null);
+    if (!diffResult || !diffResult.success)
+        return { passed: true, errors: [] };
+    if (!diffResult.data || diffResult.data.trim() === "") {
+        return { passed: true, errors: [] };
+    }
+    // Step 2: Run tests
+    const testResult = await toolExecutor.execute("test-runner", { command: "npx vitest run", timeout: 30_000 }, ctx).catch(() => null);
+    if (!testResult || !testResult.success)
+        return { passed: true, errors: [] };
+    const output = testResult.data;
+    if (!output.success) {
+        return {
+            passed: false,
+            errors: ["Tests failed after applying changes."],
+            testOutput: output.rawOutput.split("\n").slice(-30).join("\n"),
+        };
+    }
+    return { passed: true, errors: [] };
+}
+//# sourceMappingURL=chat-verifier.js.map

package/dist/interface/chat/chat-verifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-verifier.js","sourceRoot":"","sources":["../../../src/interface/chat/chat-verifier.ts"],"names":[],"mappings":"AAWA,SAAS,WAAW,CAAC,GAAW;IAC9B,OAAO;QACL,GAAG;QACH,MAAM,EAAE,aAAa;QACrB,YAAY,EAAE,EAAE;QAChB,WAAW,EAAE,IAAI;QACjB,UAAU,EAAE,KAAK,IAAI,EAAE,CAAC,IAAI;KAC7B,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,GAAW,EACX,YAA2B;IAE3B,IAAI,CAAC,YAAY;QAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAEvD,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAE7B,sDAAsD;IACtD,MAAM,UAAU,GAAG,MAAM,YAAY,CAAC,OAAO,CAC3C,UAAU,EACV,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,EAC/B,GAAG,CACJ,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IAEpB,IAAI,CAAC,UAAU,IAAI,CAAC,UAAU,CAAC,OAAO;QAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAC5E,IAAI,CAAC,UAAU,CAAC,IAAI,IAAK,UAAU,CAAC,IAAe,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAClE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACtC,CAAC;IAED,oBAAoB;IACpB,MAAM,UAAU,GAAG,MAAM,YAAY,CAAC,OAAO,CAC3C,aAAa,EACb,EAAE,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,EAAE,EAC9C,GAAG,CACJ,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IAEpB,IAAI,CAAC,UAAU,IAAI,CAAC,UAAU,CAAC,OAAO;QAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAE5E,MAAM,MAAM,GAAG,UAAU,CAAC,IAAwB,CAAC;IACnD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO;YACL,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,CAAC,sCAAsC,CAAC;YAChD,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;SAC/D,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;AACtC,CAAC"}

package/dist/interface/chat/escalation.d.ts

@@ -0,0 +1,30 @@
+import type { StateManager } from "../../base/state/state-manager.js";
+import type { ILLMClient } from "../../base/llm/llm-client.js";
+import type { GoalNegotiator } from "../../orchestrator/goal/goal-negotiator.js";
+import type { ChatHistory } from "./chat-history.js";
+export interface EscalationDeps {
+    stateManager: StateManager;
+    llmClient: ILLMClient;
+    goalNegotiator: GoalNegotiator;
+}
+export interface EscalationResult {
+    goalId: string;
+    title: string;
+    description: string;
+}
+export declare class EscalationHandler {
+    private readonly deps;
+    constructor(deps: EscalationDeps);
+    /**
+     * Convert conversation history to a tracked PulSeed Goal.
+     *
+     * Steps:
+     *  1. Build LLM messages from conversation history
+     *  2. Call LLM to extract goal description
+     *  3. GoalNegotiator.negotiate(description) — feasibility + threshold refinement
+     *  4. Goal is saved inside negotiate() — no separate saveGoal call needed
+     *  5. Return EscalationResult
+     */
+    escalateToGoal(history: ChatHistory): Promise<EscalationResult>;
+}
+//# sourceMappingURL=escalation.d.ts.map

package/dist/interface/chat/escalation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"escalation.d.ts","sourceRoot":"","sources":["../../../src/interface/chat/escalation.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4CAA4C,CAAC;AACjF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIrD,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,YAAY,CAAC;IAC3B,SAAS,EAAE,UAAU,CAAC;IACtB,cAAc,EAAE,cAAc,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AASD,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,cAAc;IAEjD;;;;;;;;;OASG;IACG,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAgCtE"}

package/dist/interface/chat/escalation.js

@@ -0,0 +1,53 @@
+// ─── EscalationHandler ───
+//
+// Handles /track command: converts conversation history to a PulSeed Goal (Tier 2 promotion).
+// Phase 1c: creates the Goal but does NOT auto-start CoreLoop.
+// User runs `pulseed run --goal <id>` to start the loop.
+const SYSTEM_PROMPT = "You are generating a PulSeed goal from a conversation. " +
+    "Extract a clear, actionable goal description from the conversation below. " +
+    "Return ONLY the goal description, nothing else.";
+// ─── EscalationHandler ───
+export class EscalationHandler {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /**
+     * Convert conversation history to a tracked PulSeed Goal.
+     *
+     * Steps:
+     *  1. Build LLM messages from conversation history
+     *  2. Call LLM to extract goal description
+     *  3. GoalNegotiator.negotiate(description) — feasibility + threshold refinement
+     *  4. Goal is saved inside negotiate() — no separate saveGoal call needed
+     *  5. Return EscalationResult
+     */
+    async escalateToGoal(history) {
+        const messages = history.getMessages();
+        if (messages.length === 0) {
+            throw new Error("No conversation history to escalate.");
+        }
+        // Step 1: Build messages array for LLM
+        const llmMessages = messages.map((m) => ({
+            role: m.role,
+            content: m.content,
+        }));
+        // Step 2: Call LLM to extract goal description
+        const response = await this.deps.llmClient.sendMessage(llmMessages, {
+            system: SYSTEM_PROMPT,
+        });
+        const goalDescription = response.content.trim();
+        if (!goalDescription) {
+            throw new Error("LLM returned empty goal description.");
+        }
+        // Step 3: Negotiate goal (also persists it internally)
+        const { goal } = await this.deps.goalNegotiator.negotiate(goalDescription);
+        // Step 4: Return result
+        return {
+            goalId: goal.id,
+            title: goal.title,
+            description: goal.description,
+        };
+    }
+}
+//# sourceMappingURL=escalation.js.map

package/dist/interface/chat/escalation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"escalation.js","sourceRoot":"","sources":["../../../src/interface/chat/escalation.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAC5B,EAAE;AACF,8FAA8F;AAC9F,+DAA+D;AAC/D,yDAAyD;AAqBzD,MAAM,aAAa,GACjB,yDAAyD;IACzD,4EAA4E;IAC5E,iDAAiD,CAAC;AAEpD,4BAA4B;AAE5B,MAAM,OAAO,iBAAiB;IACC;IAA7B,YAA6B,IAAoB;QAApB,SAAI,GAAJ,IAAI,CAAgB;IAAG,CAAC;IAErD;;;;;;;;;OASG;IACH,KAAK,CAAC,cAAc,CAAC,OAAoB;QACvC,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;QACvC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QAED,uCAAuC;QACvC,MAAM,WAAW,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACvC,IAAI,EAAE,CAAC,CAAC,IAA4B;YACpC,OAAO,EAAE,CAAC,CAAC,OAAO;SACnB,CAAC,CAAC,CAAC;QAEJ,+CAA+C;QAC/C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,WAAW,EAAE;YAClE,MAAM,EAAE,aAAa;SACtB,CAAC,CAAC;QACH,MAAM,eAAe,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAEhD,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QAED,uDAAuD;QACvD,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;QAE3E,wBAAwB;QACxB,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,EAAE;YACf,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,CAAC;IACJ,CAAC;CACF"}

package/dist/interface/chat/grounding.d.ts

@@ -0,0 +1,8 @@
+import type { StateManager } from "../../base/state/state-manager.js";
+export interface GroundingOptions {
+    stateManager: StateManager;
+    /** Base directory for PulSeed config files. Defaults to ~/.pulseed */
+    homeDir?: string;
+}
+export declare function buildSystemPrompt(options: GroundingOptions): Promise<string>;
+//# sourceMappingURL=grounding.d.ts.map

package/dist/interface/chat/grounding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grounding.d.ts","sourceRoot":"","sources":["../../../src/interface/chat/grounding.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAEtE,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,YAAY,CAAC;IAC3B,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA6CD,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CA2DlF"}

package/dist/interface/chat/grounding.js

@@ -0,0 +1,104 @@
+// ─── Chat Grounding ───
+//
+// Builds a system prompt that gives the LLM self-knowledge about PulSeed:
+// identity, available commands, current state (goals, plugins, provider).
+import * as fsp from "node:fs/promises";
+import * as path from "node:path";
+// ─── Helpers ───
+async function readPlugins(homeDir) {
+    const pluginsDir = path.join(homeDir, "plugins");
+    try {
+        const entries = await fsp.readdir(pluginsDir, { withFileTypes: true });
+        return entries.filter((e) => e.isDirectory()).map((e) => e.name);
+    }
+    catch {
+        return [];
+    }
+}
+async function readProvider(homeDir) {
+    const providerPath = path.join(homeDir, "provider.json");
+    try {
+        const raw = await fsp.readFile(providerPath, "utf-8");
+        const parsed = JSON.parse(raw);
+        const llm = typeof parsed.llm === "string" ? parsed.llm : null;
+        const adapter = typeof parsed.default_adapter === "string" ? parsed.default_adapter : null;
+        if (llm && adapter)
+            return `${llm} / ${adapter}`;
+        if (llm)
+            return llm;
+        return "not configured";
+    }
+    catch {
+        return "not configured";
+    }
+}
+async function buildGoalsBlock(stateManager) {
+    const ids = await stateManager.listGoalIds();
+    if (ids.length === 0)
+        return "No goals configured yet.";
+    const lines = [];
+    for (const id of ids) {
+        const goal = await stateManager.loadGoal(id);
+        if (!goal)
+            continue;
+        const status = goal.loop_status !== "idle" ? ` [${goal.loop_status}]` : "";
+        lines.push(`- ${goal.title} (${id})${status} — status: ${goal.status}`);
+    }
+    return lines.length > 0 ? lines.join("\n") : "No goals configured yet.";
+}
+// ─── Main export ───
+export async function buildSystemPrompt(options) {
+    const homeDir = options.homeDir ?? path.join(process.env["HOME"] ?? process.env["USERPROFILE"] ?? "/tmp", ".pulseed");
+    const [goalsBlock, plugins, provider] = await Promise.all([
+        buildGoalsBlock(options.stateManager),
+        readPlugins(homeDir),
+        readProvider(homeDir),
+    ]);
+    const pluginsLine = plugins.length > 0 ? plugins.join(", ") : "none";
+    return `
+You are PulSeed, an AI agent orchestrator. You help users manage goals, observe progress, and operate PulSeed.
+You are NOT a general-purpose assistant — you are PulSeed itself, talking to your operator.
+Your purpose: autonomously pursue goals by delegating to agents, observing results, and adjusting strategy.
+You do not execute tasks yourself — you orchestrate.
+
+## Available Commands
+- \`pulseed goal add "<description>"\`    Register a new goal (via GoalRefiner)
+- \`pulseed goal list\`                   List all registered goals
+- \`pulseed goal show <id>\`              Show goal details
+- \`pulseed goal reset <id>\`             Reset goal state for re-running
+- \`pulseed run --goal <id>\`             Start the orchestration loop for a goal
+- \`pulseed status --goal <id>\`          Show current progress
+- \`pulseed report --goal <id>\`          Show latest report
+- \`pulseed start --goal <id> -d\`        Start daemon mode (background)
+- \`pulseed stop\`                        Stop the running daemon
+- \`pulseed daemon status\`               Show daemon status
+- \`pulseed suggest "<context>"\`         Suggest new goals for a project
+- \`pulseed improve [path]\`              Analyze path and suggest improvement goals
+- \`pulseed tui\`                         Launch interactive TUI
+- \`pulseed setup\`                       Interactive first-time setup wizard
+- \`pulseed provider set\`                Set LLM provider and adapter
+- \`pulseed plugin list\`                 List installed plugins
+- \`pulseed logs\`                        View daemon logs
+- \`pulseed doctor\`                      Run health checks
+- \`pulseed chat\`                        This conversation
+- \`/track\`                              Promote this chat session to a tracked goal
+
+## Current State
+### Goals
+${goalsBlock}
+
+### Plugins
+Installed: ${pluginsLine}
+
+### Provider
+${provider}
+
+## How to Help
+- When the user asks to set something up, guide them step by step using specific commands above
+- Reference exact CLI commands with flags when applicable
+- If state is needed, tell the user which command to run rather than guessing
+- Use \`/track\` to convert this conversation into a persistent goal when the user defines an objective
+- Be concise and direct — you are a tool, not a conversationalist
+`.trim();
+}
+//# sourceMappingURL=grounding.js.map

package/dist/interface/chat/grounding.js.map

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

package/dist/interface/chat/mutation-tool-defs.d.ts

@@ -0,0 +1,19 @@
+import type { ToolDefinition } from "../../base/llm/llm-client.js";
+export type ApprovalLevel = "none" | "required";
+export declare const DEFAULT_APPROVAL: Record<string, ApprovalLevel>;
+import type { StateManager } from "../../base/state/state-manager.js";
+import type { TrustManager } from "../../platform/traits/trust-manager.js";
+import type { PluginLoader } from "../../runtime/plugin-loader.js";
+export interface MutationToolDeps {
+    stateManager: StateManager;
+    trustManager?: TrustManager;
+    pluginLoader?: PluginLoader;
+    approvalFn?: (description: string) => Promise<boolean>;
+    approvalConfig?: Record<string, ApprovalLevel>;
+}
+export declare function checkApproval(toolName: string, description: string, deps: MutationToolDeps): Promise<{
+    approved: boolean;
+    error?: string;
+}>;
+export declare function getMutationToolDefinitions(): ToolDefinition[];
+//# sourceMappingURL=mutation-tool-defs.d.ts.map

package/dist/interface/chat/mutation-tool-defs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutation-tool-defs.d.ts","sourceRoot":"","sources":["../../../src/interface/chat/mutation-tool-defs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAInE,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,UAAU,CAAC;AAEhD,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAQ1D,CAAC;AAIF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wCAAwC,CAAC;AAC3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAEnE,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,YAAY,CAAC;IAC3B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,UAAU,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACvD,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CAChD;AAID,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAqBhD;AAID,wBAAgB,0BAA0B,IAAI,cAAc,EAAE,CA2H7D"}