@travisennis/acai 0.0.6 → 0.0.8

package/dist/commands/{generate-rules-command.js → generate-rules/index.js}

@@ -1,69 +1,16 @@
 import { generateText } from "ai";
-import { config } from "../config.js";
-import { logger } from "../logger.js"; // Import logger
-import { createUserMessage } from "../messages.js";
-import { systemPrompt } from "../prompts.js";
-import { checkbox } from "../terminal/checkbox-prompt.js";
-import { getTerminalSize } from "../terminal/formatting.js";
-import style from "../terminal/style.js";
-import { Container, Input, Spacer, Text, } from "../tui/index.js";
-async function _processAndSaveRules(newRules, terminal, config) {
-    if (!newRules || newRules.length === 0) {
-        terminal.warn("No new generalizable rules were identified.");
-        return;
-    }
-    terminal.info("Generated potential rules:");
-    terminal.lineBreak();
-    const rulesToKeep = await checkbox({
-        message: "Select the rules you want to keep:",
-        choices: newRules.map((rule) => ({ name: rule, value: rule })),
-    });
-    if (rulesToKeep.length === 0) {
-        terminal.warn("No rules selected to save.");
-        return;
-    }
-    terminal.info("Saving selected rules...");
-    const existingRules = await config.readProjectLearnedRulesFile();
-    const rulesToAdd = rulesToKeep.join("\n");
-    const updatedProjectRules = existingRules.endsWith("\n") || existingRules.length === 0
-        ? `${existingRules}${rulesToAdd}`
-        : `${existingRules}\n${rulesToAdd}`;
-    await config.writeProjectLearnedRulesFile(updatedProjectRules);
-    terminal.success("Selected rules saved to project learned rules.");
-    terminal.lineBreak();
-    terminal.display(rulesToAdd); // Display only the saved rules
-}
-export const generateRulesCommand = ({ terminal, messageHistory, modelManager, tokenTracker, config, // This is the config module from CommandOptions
- }) => {
+import { logger } from "../../logger.js";
+import { systemPrompt } from "../../prompts.js";
+import { createUserMessage } from "../../sessions/manager.js";
+import { getTerminalSize, isArrowDown, isArrowUp, isEnter, isEscape, } from "../../terminal/control.js";
+import style from "../../terminal/style.js";
+import { Container, Input, Spacer, Text, } from "../../tui/index.js";
+import { hideRuleSelector } from "./utils.js";
+export const generateRulesCommand = ({ sessionManager: messageHistory, modelManager, tokenTracker, config, workspace, }) => {
     return {
         command: "/generate-rules",
         description: "Analyzes the current conversation to generate and save new interaction rules, then displays them.",
         getSubCommands: () => Promise.resolve([]),
-        execute: async () => {
-            if (messageHistory.isEmpty()) {
-                terminal.writeln("Cannot generate rules from an empty conversation.");
-                return "continue";
-            }
-            terminal.lineBreak();
-            terminal.info("Analyzing conversation to generate rules...");
-            try {
-                const newRules = await analyzeConversation({
-                    modelManager,
-                    messages: messageHistory.get(),
-                    tokenTracker,
-                    terminal,
-                });
-                // Pass the config object available in CommandOptions scope
-                await _processAndSaveRules(newRules, terminal, config);
-            }
-            catch (error) {
-                const errorMessage = error instanceof Error ? error.message : String(error);
-                terminal.error(`Error generating rules: ${errorMessage}`);
-                logger.error(error, "Error during rule generation:");
-                return "continue";
-            }
-            return "continue";
-        },
         async handle(_args, { tui, container, inputContainer, editor, }) {
             if (messageHistory.isEmpty()) {
                 container.addChild(new Text(style.yellow("Cannot generate rules from an empty conversation."), 1, 0));
@@ -78,17 +25,16 @@ export const generateRulesCommand = ({ terminal, messageHistory, modelManager, t
                     modelManager,
                     messages: messageHistory.get(),
                     tokenTracker,
-                    terminal,
+                    config,
+                    workspace,
                 });
-                if (!newRules || newRules.length === 0) {
+                if (newRules == null || newRules.length === 0) {
                     container.addChild(new Text(style.yellow("No new generalizable rules were identified."), 2, 0));
                     tui.requestRender();
                     editor.setText("");
                     return "continue";
                 }
-                // Create rule selector for TUI mode
                 const ruleSelector = new RuleSelectorComponent(newRules, async (selectedRules) => {
-                    // Handle rule selection
                     if (selectedRules.length === 0) {
                         container.addChild(new Text(style.yellow("No rules selected to save."), 2, 0));
                     }
@@ -110,15 +56,12 @@ export const generateRulesCommand = ({ terminal, messageHistory, modelManager, t
                             container.addChild(new Text(style.red(`Failed to save rules: ${error}`), 2, 0));
                         }
                     }
-                    // Hide selector and show editor again
                     hideRuleSelector(inputContainer, editor, tui);
                     tui.requestRender();
                 }, () => {
-                    // Cancel selection - just hide selector
                     hideRuleSelector(inputContainer, editor, tui);
                     tui.requestRender();
                 });
-                // Replace editor with rule selector
                 inputContainer.clear();
                 inputContainer.addChild(ruleSelector);
                 tui.setFocus(ruleSelector);
@@ -136,8 +79,55 @@ export const generateRulesCommand = ({ terminal, messageHistory, modelManager, t
         },
     };
 };
-// Modified System Prompt
-const system = async () => `You are an expert analyst reviewing conversations between a coding agent and a software engineer. Your goal is to identify instances where the engineer corrected the agent's approach or understanding in a way that reveals a *generalizable principle* for improving the agent's future behavior across *different* tasks.
+async function analyzeConversation({ modelManager, messages, tokenTracker, config: configManager, workspace, }) {
+    const learnedRules = await configManager.readCachedLearnedRulesFile();
+    messages.push(createUserMessage([
+        `Analyze this conversation based on the system instructions. Identify points where the user made significant corrections revealing general principles for agent improvement. Infer concise, broadly applicable rules (Always/Never) based *only* on these corrections.
+
+**Key Requirements:**
+- Focus on *generalizable* rules applicable to future, different tasks.
+- Avoid rules tied to the specifics of *this* conversation.
+- Ensure rules don't already exist in <existing-rules>.
+- If no *new, general* rules can be inferred, return an empty list or response.
+- Return *only* the Markdown list of rules, with no preamble or explanation.
+
+<existing-rules>
+${learnedRules}
+</existing-rules>`,
+    ]));
+    const systemPromptText = await createSystemPrompt(configManager, workspace);
+    const { text, usage } = await generateText({
+        model: modelManager.getModel("conversation-analyzer"),
+        maxOutputTokens: 8192,
+        system: systemPromptText,
+        messages: messages,
+    });
+    tokenTracker.trackUsage("conversation-analyzer", usage);
+    const potentialRulesText = text.trim();
+    if (!potentialRulesText || potentialRulesText.length === 0) {
+        return [];
+    }
+    const potentialRulesList = potentialRulesText
+        .split("\n")
+        .map((rule) => rule.trim())
+        .filter((rule) => rule.length > 0);
+    if (potentialRulesList.length === 0) {
+        return [];
+    }
+    const updatedRules = learnedRules.endsWith("\n") || learnedRules.length === 0
+        ? `${learnedRules}${potentialRulesList.join("\n")}`
+        : `${learnedRules}\n${potentialRulesList.join("\n")}`;
+    await configManager.writeCachedLearnedRulesFile(updatedRules);
+    return potentialRulesList;
+}
+async function createSystemPrompt(configManager, workspace) {
+    const projectConfig = await configManager.getConfig();
+    const sys = await systemPrompt({
+        activeTools: projectConfig.tools.activeTools,
+        includeRules: true,
+        allowedDirs: workspace.allowedDirs,
+    });
+    return `You are an expert analyst reviewing conversations between a coding agent and a software engineer. Your goal is to identify instances where the engineer corrected the agent's approach or understanding in a way that reveals a *generalizable principle* for improving the agent's future behavior across *different* tasks.
 
 **Your Task:**
 1. Analyze the conversation provided.
@@ -171,64 +161,9 @@ const system = async () => `You are an expert analyst reviewing conversations be
 
 This is the original system prompt the agent operated under:
 <systemPrompt>
-${await systemPrompt()}
+${sys}
 </systemPrompt>`;
-async function analyzeConversation({ modelManager, messages, tokenTracker, }) {
-    const learnedRules = await config.readCachedLearnedRulesFile();
-    // Modified User Message within analyzeConversation
-    messages.push(createUserMessage([
-        `Analyze this conversation based on the system instructions. Identify points where the user made significant corrections revealing general principles for agent improvement. Infer concise, broadly applicable rules (Always/Never) based *only* on these corrections.
-
-**Key Requirements:**
-- Focus on *generalizable* rules applicable to future, different tasks.
-- Avoid rules tied to the specifics of *this* conversation.
-- Ensure rules don't already exist in <existing-rules>.
-- If no *new, general* rules can be inferred, return an empty list or response.
-- Return *only* the Markdown list of rules, with no preamble or explanation.
-
-<existing-rules>
-${learnedRules}
-</existing-rules>`,
-    ]));
-    const { text, usage } = await generateText({
-        model: modelManager.getModel("conversation-analyzer"),
-        maxOutputTokens: 8192,
-        system: await system(),
-        messages: messages,
-    });
-    tokenTracker.trackUsage("conversation-analyzer", usage);
-    // Trim whitespace and check if the response is effectively empty or just whitespace
-    const potentialRulesText = text.trim();
-    // Basic check to prevent adding empty lines or just formatting
-    if (!potentialRulesText || potentialRulesText.length === 0) {
-        return []; // Return empty array if no valid rules generated
-    }
-    // Split into individual rules, filter out empty lines
-    const potentialRulesList = potentialRulesText
-        .split("\n")
-        .map((rule) => rule.trim())
-        .filter((rule) => rule.length > 0);
-    if (potentialRulesList.length === 0) {
-        return []; // Return empty array if splitting results in no rules
-    }
-    // Further validation could be added here (e.g., check if it starts with '- ', etc.)
-    // before writing to the file.
-    // Append only if there are non-empty potential rules
-    const updatedRules = learnedRules.endsWith("\n") || learnedRules.length === 0
-        ? `${learnedRules}${potentialRulesList.join("\n")}`
-        : `${learnedRules}\n${potentialRulesList.join("\n")}`;
-    await config.writeCachedLearnedRulesFile(updatedRules);
-    return potentialRulesList; // Return the list of rules that were added
-}
-function hideRuleSelector(editorContainer, editor, tui) {
-    // Replace selector with editor in the container
-    editorContainer.clear();
-    editorContainer.addChild(editor);
-    tui.setFocus(editor);
 }
-/**
- * Component that renders a rule selector with search and multi-selection
- */
 class RuleSelectorComponent extends Container {
     searchInput;
     listContainer;
@@ -242,31 +177,23 @@ class RuleSelectorComponent extends Container {
         super();
         this.onSelectCallback = onSelect;
         this.onCancelCallback = onCancel;
-        // Load all rules
         this.allRules = rules;
         this.filteredRules = rules;
         const { columns } = getTerminalSize();
-        // Add top border
         this.addChild(new Text(style.blue("─".repeat(columns)), 0, 0));
         this.addChild(new Spacer(1));
-        // Create search input
         this.searchInput = new Input();
         this.searchInput.onSubmit = () => {
-            // Enter on search input toggles selection of current item
             this.toggleSelection(this.selectedIndex);
         };
         this.addChild(this.searchInput);
         this.addChild(new Spacer(1));
-        // Create list container
         this.listContainer = new Container();
         this.addChild(this.listContainer);
         this.addChild(new Spacer(1));
-        // Add instructions
         this.addChild(new Text(style.dim("Space: toggle selection, Enter: confirm, Escape: cancel"), 0, 0));
         this.addChild(new Spacer(1));
-        // Add bottom border
         this.addChild(new Text(style.blue("─".repeat(columns)), 0, 0));
-        // Initial render
         this.updateList();
     }
     filterRules(query) {
@@ -291,7 +218,6 @@ class RuleSelectorComponent extends Container {
         const maxVisible = 10;
         const startIndex = Math.max(0, Math.min(this.selectedIndex - Math.floor(maxVisible / 2), this.filteredRules.length - maxVisible));
         const endIndex = Math.min(startIndex + maxVisible, this.filteredRules.length);
-        // Show visible slice of filtered rules
         for (let i = startIndex; i < endIndex; i++) {
             const rule = this.filteredRules[i];
             if (!rule)
@@ -312,40 +238,32 @@ class RuleSelectorComponent extends Container {
             }
             this.listContainer.addChild(new Text(line, 0, 0));
         }
-        // Add scroll indicator if needed
         if (startIndex > 0 || endIndex < this.filteredRules.length) {
             const scrollInfo = style.gray(`  (${this.selectedIndex + 1}/${this.filteredRules.length})`);
             this.listContainer.addChild(new Text(scrollInfo, 0, 0));
         }
-        // Show "no results" if empty
         if (this.filteredRules.length === 0) {
             this.listContainer.addChild(new Text(style.gray("  No matching rules"), 0, 0));
         }
     }
     handleInput(keyData) {
-        // Up arrow
-        if (keyData === "\x1b[A") {
+        if (isArrowUp(keyData)) {
             this.selectedIndex = Math.max(0, this.selectedIndex - 1);
             this.updateList();
         }
-        // Down arrow
-        else if (keyData === "\x1b[B") {
+        else if (isArrowDown(keyData)) {
             this.selectedIndex = Math.min(this.filteredRules.length - 1, this.selectedIndex + 1);
             this.updateList();
         }
-        // Space - toggle selection
         else if (keyData === " ") {
             this.toggleSelection(this.selectedIndex);
         }
-        // Enter - confirm selection
-        else if (keyData === "\r") {
+        else if (isEnter(keyData)) {
             this.handleConfirm();
         }
-        // Escape
-        else if (keyData === "\x1b") {
+        else if (isEscape(keyData)) {
             this.onCancelCallback();
         }
-        // Pass everything else to search input
         else {
             this.searchInput.handleInput(keyData);
             this.filterRules(this.searchInput.getValue());

package/dist/commands/generate-rules/utils.d.ts

@@ -0,0 +1,5 @@
+import type { Container, Editor, TUI } from "../../tui/index.ts";
+export declare function hideRuleSelector(editorContainer: Container, editor: Editor, tui: TUI): void;
+export declare function parseRulesText(text: string): string[];
+export declare function formatRulesForStorage(existingRules: string, newRules: string[]): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/commands/generate-rules/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../source/commands/generate-rules/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAEjE,wBAAgB,gBAAgB,CAC9B,eAAe,EAAE,SAAS,EAC1B,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,GAAG,GACP,IAAI,CAIN;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAUrD;AAED,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,EAAE,GACjB,MAAM,CAUR"}

package/dist/commands/generate-rules/utils.js

@@ -0,0 +1,25 @@
+export function hideRuleSelector(editorContainer, editor, tui) {
+    editorContainer.clear();
+    editorContainer.addChild(editor);
+    tui.setFocus(editor);
+}
+export function parseRulesText(text) {
+    const trimmed = text.trim();
+    if (!trimmed || trimmed.length === 0) {
+        return [];
+    }
+    return trimmed
+        .split("\n")
+        .map((rule) => rule.trim())
+        .filter((rule) => rule.length > 0);
+}
+export function formatRulesForStorage(existingRules, newRules) {
+    if (newRules.length === 0) {
+        return existingRules;
+    }
+    const rulesToAdd = newRules.join("\n");
+    if (existingRules.endsWith("\n") || existingRules.length === 0) {
+        return `${existingRules}${rulesToAdd}`;
+    }
+    return `${existingRules}\n${rulesToAdd}`;
+}

package/dist/commands/handoff/index.d.ts

@@ -0,0 +1,3 @@
+import type { CommandOptions, ReplCommand } from "../types.ts";
+export declare const handoffCommand: (options: CommandOptions) => ReplCommand;
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/handoff/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../source/commands/handoff/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAO/D,eAAO,MAAM,cAAc,GAAI,SAAS,cAAc,KAAG,WA2DxD,CAAC"}

package/dist/commands/handoff/index.js

@@ -0,0 +1,97 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import { generateText } from "ai";
+import { AiConfig } from "../../models/ai-config.js";
+import style from "../../terminal/style.js";
+import { Spacer, Text } from "../../tui/index.js";
+import { generateHandoffFilename, generateHandoffSlug, handoffPrompt, } from "./utils.js";
+export const handoffCommand = (options) => {
+    return {
+        command: "/handoff",
+        description: "Creates a detailed handoff plan of the conversation for continuing the work in a new session. Usage: /handoff <the purpose of the handoff>",
+        getSubCommands: () => Promise.resolve([]),
+        async handle(args, { tui, container, editor, }) {
+            const purpose = args.join(" ").trim();
+            if (!purpose) {
+                container.addChild(new Text(style.red("Please provide a purpose for the handoff. Usage: /handoff <the purpose of the handoff>"), 1, 0));
+                tui.requestRender();
+                editor.setText("");
+                return "continue";
+            }
+            container.addChild(new Spacer(1));
+            container.addChild(new Text(`Creating handoff document for purpose: ${style.blue(purpose)}`, 1, 0));
+            tui.requestRender();
+            const filename = await createHandoffDocument(options, purpose);
+            container.addChild(new Text(style.green(`Handoff document created: ${filename}`), 2, 0));
+            container.addChild(new Text(`Use /pickup ${filename.replace(".md", "")} to continue this work.`, 3, 0));
+            tui.requestRender();
+            editor.setText("");
+            return "continue";
+        },
+    };
+};
+async function createHandoffDocument({ modelManager, tokenTracker, sessionManager: messageHistory, }, purpose) {
+    const app = "handoff-agent";
+    const model = modelManager.getModel(app);
+    const modelConfig = modelManager.getModelMetadata(app);
+    const messages = messageHistory.get();
+    const conversationText = messages
+        .map((msg) => {
+        let content = "";
+        if (Array.isArray(msg.content)) {
+            content = msg.content
+                .filter((part) => part.type === "text")
+                .map((part) => part.text)
+                .join("\n");
+        }
+        else if (typeof msg.content === "string") {
+            content = msg.content;
+        }
+        return `${msg.role}: ${content}`;
+    })
+        .filter((text) => text?.trim())
+        .join("\n\n");
+    const fullPrompt = `${handoffPrompt(purpose)}\n\n## Conversation History\n\n${conversationText}`;
+    const aiConfig = new AiConfig({
+        modelMetadata: modelConfig,
+        prompt: fullPrompt,
+    });
+    let result;
+    try {
+        result = await generateText({
+            model,
+            maxOutputTokens: aiConfig.maxOutputTokens(),
+            system: "You are a helpful AI assistant tasked with creating detailed handoff summaries for coding agents. Focus on technical accuracy and completeness so that another agent can seamlessly continue the work.",
+            prompt: fullPrompt,
+            temperature: aiConfig.temperature(),
+            topP: aiConfig.topP(),
+            providerOptions: aiConfig.providerOptions(),
+        });
+    }
+    catch (error) {
+        console.error(`Error generating handoff text: ${error}`);
+        throw new Error(`Failed to generate handoff summary: ${error.message}`);
+    }
+    const { text, usage } = result;
+    tokenTracker.trackUsage(app, usage);
+    if (!text || text.trim().length === 0) {
+        throw new Error("AI returned empty response");
+    }
+    const slug = generateHandoffSlug(purpose);
+    const filename = generateHandoffFilename(slug);
+    const handoffsDir = ".acai/handoffs";
+    const filepath = `${handoffsDir}/${filename}`;
+    const handoffDocument = `${text}
+
+---
+*Generated on ${new Date().toISOString()} for purpose: ${purpose}*
+*This handoff file can be used to continue the work using the /pickup command*`;
+    try {
+        await mkdir(handoffsDir, { recursive: true });
+        await writeFile(filepath, handoffDocument, "utf-8");
+        return filename;
+    }
+    catch (error) {
+        console.error(`Failed to save handoff file: ${error}`);
+        throw new Error(`Failed to save handoff file: ${error.message}`);
+    }
+}

package/dist/commands/handoff/utils.d.ts

@@ -0,0 +1,4 @@
+export declare const handoffPrompt: (purpose: string) => string;
+export declare const generateHandoffSlug: (purpose: string, maxLength?: number) => string;
+export declare const generateHandoffFilename: (slug: string) => string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/commands/handoff/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../source/commands/handoff/utils.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,GAAI,SAAS,MAAM,KAAG,MAqG/C,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAC9B,SAAS,MAAM,EACf,kBAAc,KACb,MAmBF,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAAI,MAAM,MAAM,KAAG,MAItD,CAAC"}

package/dist/commands/handoff/utils.js

@@ -0,0 +1,123 @@
+export const handoffPrompt = (purpose) => {
+    return `Creates a detailed handoff plan of the conversation for continuing the work in a new session.
+
+The user specified purpose:
+
+<purpose>${purpose}</purpose>
+
+You are creating a summary specifically so that it can be continued by another agent.  For this to work you MUST have a purpose.  If no specified purpose was provided in the \`<purpose>...</purpose>\` tag you must STOP IMMEDIATELY and ask the user what the purpose is.
+
+Do not continue before asking for the purpose as you will otherwise not understand the instructions and do not assume a purpose!
+
+## Goal
+
+Your task is to create a detailed summary of the conversation so far, paying close attention to the user's explicit purpose for the next steps.
+This handoff plan should be thorough in capturing technical details, code patterns, and architectural decisions that will be essential for continuing development work without losing context.
+
+## Process
+
+Before providing your final plan, wrap your analysis in <analysis> tags to organize your thoughts and ensure you've covered all necessary points. In your analysis process:
+
+1. Chronologically analyze each message and section of the conversation. For each section thoroughly identify:
+   - The user's explicit requests and intents
+   - Your approach to addressing the user's requests
+   - Key decisions, technical concepts and code patterns
+   - Specific details like file names, full code snippets, function signatures, file edits, etc
+2. Double-check for technical accuracy and completeness, addressing each required element thoroughly.
+
+Your plan should include the following sections:
+
+1. **Primary Request and Intent**: Capture all of the user's explicit requests and intents in detail
+2. **Key Technical Concepts**: List all important technical concepts, technologies, and frameworks discussed.
+3. **Files and Code Sections**: Enumerate specific files and code sections examined, modified, or created. Pay special attention to the most recent messages and include full code snippets where applicable and include a summary of why this file read or edit is important.
+4. **Problem Solving**: Document problems solved and any ongoing troubleshooting efforts.
+5. **Pending Tasks**: Outline any pending tasks that you have explicitly been asked to work on.
+6. **Current Work**: Describe in detail precisely what was being worked on immediately before this handoff request, paying special attention to the most recent messages from both user and assistant. Include file names and code snippets where applicable.
+7. **Optional Next Step**: List the next step that you will take that is related to the most recent work you were doing. IMPORTANT: ensure that this step is DIRECTLY in line with the user's explicit requests, and the task you were working on immediately before this handoff request. If your last task was concluded, then only list next steps if they are explicitly in line with the users request. Do not start on tangential requests without confirming with the user first.
+
+Additionally create a "slug" for this handoff.  The "slug" is how we will refer to it later in a few places.  Examples:
+
+* current-user-api-handler
+* implement-auth
+* fix-issue-42
+
+Together with the slug create a "Readable Summary".  Examples:
+
+* Implement Currnet User API Handler
+* Implement Authentication
+* Fix Issue #42
+
+## Output Structure
+
+Here's an example of how your output should be structured:
+
+\`\`\` markdown
+# Readable Summary
+
+<analysis>
+[Your thought process, ensuring all points are covered thoroughly and accurately]
+</analysis>
+
+<plan>
+# Session Handoff Plan
+
+## 1. Primary Request and Intent
+[Detailed description of all user requests and intents]
+
+## 2. Key Technical Concepts
+- [Concept 1]
+- [Concept 2]
+- [...]
+
+## 3. Files and Code Sections
+### [File Name 1]
+- **Why important**: [Summary of why this file is important]
+- **Changes made**: [Summary of the changes made to this file, if any]
+- **Code snippet**:
+\`\`\` language
+[Important Code Snippet]
+\`\`\`
+
+### [File Name 2]
+- **Code snippet**:
+\`\`\` language
+[Important Code Snippet]
+\`\`\`
+
+[...]
+
+## 4. Problem Solving
+[Description of solved problems and ongoing troubleshooting]
+
+## 5. Next Step
+[Required next step to take, directly aligned with user's explicit handoff purpose]
+</plan>
+\`\`\`
+
+## Final Step
+
+Provide your complete handoff summary with all the sections above. The system will save it to a file automatically.
+
+Make sure to include both the slug and readable summary in your response as described.`;
+};
+export const generateHandoffSlug = (purpose, maxLength = 20) => {
+    let slug = purpose
+        .toLowerCase()
+        .replace(/[^a-z0-9\s-]/g, "")
+        .replace(/\s+/g, "-")
+        .replace(/-+/g, "-")
+        .trim();
+    // Remove leading and trailing hyphens
+    slug = slug.replace(/^-+|-+$/g, "");
+    // Apply maxLength after trimming hyphens
+    slug = slug.slice(0, maxLength);
+    if (!slug) {
+        slug = "session";
+    }
+    return slug;
+};
+export const generateHandoffFilename = (slug) => {
+    const now = new Date();
+    const timestamp = now.toISOString().split("T")[0];
+    return `${timestamp}-${slug}.md`;
+};

package/dist/commands/health/index.d.ts

@@ -0,0 +1,3 @@
+import type { CommandOptions, ReplCommand } from "../types.ts";
+export declare function healthCommand(_options: CommandOptions): ReplCommand;
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/health/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../source/commands/health/index.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAQ/D,wBAAgB,aAAa,CAAC,QAAQ,EAAE,cAAc,GAAG,WAAW,CA6FnE"}

package/dist/commands/health/index.js

@@ -0,0 +1,56 @@
+import { Container, Modal, ModalText, TableComponent, } from "../../tui/index.js";
+import { checkEnvironmentVariables, checkTools, formatEnvStatus, formatToolStatus, } from "./utils.js";
+export function healthCommand(_options) {
+    return {
+        command: "/health",
+        description: "Show application health status and environment variables",
+        getSubCommands: () => Promise.resolve([]),
+        async handle(_args, { tui, editor }) {
+            const envStatus = checkEnvironmentVariables();
+            const toolStatus = checkTools();
+            const setCount = envStatus.filter((row) => row[1] === "✓ Set").length;
+            const totalCount = envStatus.length;
+            const installedCount = toolStatus.filter((row) => row[1] === "✓ Installed").length;
+            const totalTools = toolStatus.length;
+            const usage = process.memoryUsage().rss;
+            const modalContent = new Container();
+            modalContent.addChild(new ModalText("Environment Variables Status:", 0, 1));
+            modalContent.addChild(new TableComponent(formatEnvStatus(envStatus), {
+                headers: ["Variable", "Status", "Description"],
+            }));
+            const envSummary = `Summary: ${setCount}/${totalCount} environment variables are set`;
+            modalContent.addChild(new ModalText(envSummary, 0, 1));
+            if (setCount === 0) {
+                modalContent.addChild(new ModalText("⚠️  No AI provider API keys are configured. The app may not function properly.", 0, 1));
+            }
+            else {
+                modalContent.addChild(new ModalText("✓ At least one AI provider is configured.", 0, 1));
+            }
+            modalContent.addChild(new ModalText("", 0, 1));
+            modalContent.addChild(new ModalText("Bash Tools Status:", 0, 1));
+            modalContent.addChild(new TableComponent(formatToolStatus(toolStatus), {
+                headers: ["Tool", "Status"],
+            }));
+            const toolSummary = `Tool Summary: ${installedCount}/${totalTools} tools are installed.`;
+            modalContent.addChild(new ModalText(toolSummary, 0, 1));
+            if (installedCount < totalTools) {
+                modalContent.addChild(new ModalText("⚠️  Some tools are missing. Install them for full functionality.", 0, 1));
+            }
+            else {
+                modalContent.addChild(new ModalText("✓ All required tools are installed.", 0, 1));
+            }
+            modalContent.addChild(new ModalText("", 0, 1));
+            modalContent.addChild(new ModalText("Current Process:", 0, 1));
+            const { formatMemoryUsage } = await import("../../formatting.js");
+            const formattedUsage = formatMemoryUsage(usage);
+            const memoryText = `Memory Usage: ${formattedUsage}`;
+            modalContent.addChild(new ModalText(memoryText, 0, 1));
+            const modal = new Modal("Health Status", modalContent, true, () => {
+                editor.setText("");
+                tui.requestRender();
+            });
+            tui.showModal(modal);
+            return "continue";
+        },
+    };
+}