fluxflow-cli 2.7.0 → 2.7.1

package/TOOLS.md

@@ -4,64 +4,92 @@ Flux Flow provides a robust set of tools that allow the AI to interact with the
 
 ## Tool Availability by Mode
 
-| Tool | Flux Mode (Dev) | Flow Mode (Chat) |
+| Tool Category | Flux Mode (Dev) | Flow Mode (Chat) |
 | :--- | :---: | :---: |
-| **Web Search** | ✅ | ✅ |
-| **Web Scrape** | ✅ | ✅ |
-| **Write PDF** | ✅ | ❌ |
-| **Write DOCX** | ✅ | ❌ |
-| **View/Read Files** | ✅ | ❌ |
-| **Write/Update Files** | ✅ | ❌ |
-| **Execute Commands** | ✅ | ❌ |
+| **Communication (Ask)** | ✅ | ✅ |
+| **Web Search & Scrape** | ✅ | ✅ |
+| **File System (Read/Write)** | ✅ | ❌ |
+| **Terminal Execution** | ✅ | ❌ |
 | **Search Keyword** | ✅ | ❌ |
 | **File Map** | ✅ | ❌ |
+| **Todo (Planning)** | ✅ | ❌ |
+| **Creative (PDF/DOCX/Image)** | ❌ | ✅ |
 
 ---
 
-## Core Tools
-
-### 🌐 Web & Research
-- **`WebSearch`**: Uses DuckDuckGo to find up-to-date information on the internet. Crucial for answering questions about recent events or unlearned documentation.
-- **`WebScrape`**: Extracts the detailed text content from a specific URL, allowing the agent to read documentation or articles.
-
-### 📄 Document Engineering (The Office Suite)
-- **`WritePDF`**: Generates high-fidelity, branded PDF documents from HTML/CSS. Features automatic watermarking and page-aware layout management.
-- **`WriteDOCX`**: Generates professional Word documents (.docx) from HTML. Supports multi-page layouts, automatic page numbering, and native styling.
-
-### 🎨 Creative & Visual
-- **`GenerateImage`**: Generates high-fidelity images using Pollinations AI.
-  - **Customization**: Supports customizable models (Flux, ZImage, Qwen, Nanobanana-Pro, etc.), aspect ratios, custom prompt generation, and random seeds.
-  - **Telemetry**: Tracks hourly credit usage (Low, Medium, Ultra, Premium tiers) with built-in daily limit checks and interactive dashboard displays.
-
-### 📁 File System Operations
-- **`ListFiles`**: Lists the contents of a directory to help the agent understand the project structure.
-- **`ReadFolder`**: Provides detailed statistics and metadata about a directory's contents.
-- **`ViewFile`**: Reads the content of a file.
-  - **Native Multimodality**: Supports analyzing images (JPG, PNG, WEBP) and PDF documents. The tool automatically detects binary formats and encodes them for AI analysis.
-  - **Text Reading**: Supports specific line ranges (`start_line`, `end_line`) to manage context size efficiently.
-- **`FileMap`**: Generates a high-level structural map of a code file using Tree-Sitter.
-  - **Structural Insight**: Identifies classes, functions, methods, and control flow blocks without reading the entire file content.
-  - **Multi-Language**: Supports JS, TS, TSX, Python, C, C++, Java, and HTML.
-- **`SearchKeyword`**: Performs a global project search for a specific string or keyword. Returns file paths and line numbers where matches are found, making it essential for navigation and impact analysis.
-
-### ✍️ Code Editing
-- **`WriteFile`**: Creates a new file or completely overwrites an existing one with new content.
-- **`UpdateFile` (Smart Patching)**: Surgically replaces a specific block of text within a file.
-  - *Diff Generation*: It returns a high-fidelity visual diff (Red/Green changes with context lines) to the UI, allowing the user to see exactly what the agent modified.
-
-### 💻 Terminal Execution
-- **`Run`**: Runs a shell command directly in the terminal using Node's `child_process.spawn` or `node-pty` when available.
-  - *Context Aware*: Runs in the current working directory.
-  - *Cross-Platform*: Uses `shell: true` to handle Windows `.cmd`/`.bat` files natively.
+## Tool Protocol
+
+FluxFlow uses a transparent, string-based protocol for tool dispatching:
+`[[tool:functions.ToolName(arg1="value", arg2=123)]]`
 
 ---
 
-## Memory Management
+## Communication Tools
+
+### `Ask`
+- **Purpose**: Ambiguity Resolution.
+- **Triggers**: Mandatory for Path Divergence, Security concerns, or Risk Mitigation.
+- **Usage**: Suggests up to 4 best options; does not ask for open-ended preferences.
+
+---
+
+## Web Tools
+
+### `WebSearch`
+- **Purpose**: Proactive search for unknown topics.
+- **Limit**: 3-10 results.
+
+### `WebScrape`
+- **Purpose**: Deep-dive research into specific webpages, documentation, or APIs.
+
+---
+
+## Workspace Tools (Flux Mode Only)
+
+### `ReadFile`
+- **Purpose**: Reads file content with support for line ranges.
+- **Multimodal**: Supports images and documents.
+
+### `FileMap`
+- **Purpose**: Shows file structure, dependencies, functions, and variable maps. More token-efficient than ReadFile.
+
+### `ReadFolder`
+- **Purpose**: Provides detailed directory statistics.
 
-The memory tool (`memory.js`) is primarily used by the background **Janitor** model, but can be accessed by the main agent if necessary.
+### `PatchFile` (UpdateFile)
+- **Purpose**: Surgical patching of code.
+- **Usage**: Supports multiple patches in a single call to prevent spam. MUST VERIFY DIFF.
+
+### `WriteFile`
+- **Purpose**: Creates or overwrites files.
+- **Safety**: Prefers PatchFile if the file already exists.
+
+### `SearchKeyword`
+- **Purpose**: Global project search for definitions or logic.
+
+### `Run` (exec_command)
+- **Purpose**: Runs shell commands (PowerShell/CMD on Windows, Bash on Unix).
+- **Safety**: Restricted to workspace directory unless explicitly allowed. Irreversible operations require user approval.
+
+### `Todo`
+- **Purpose**: Manages an internal task list (`todo.md`) to keep goals consistent during long tasks.
+- **Methods**: `create`, `append`, `check`.
+
+---
+
+## Creative Tools (Flow Mode Only)
+
+### `WritePDF`
+- **Purpose**: Generates high-fidelity, branded PDF documents from HTML/CSS.
+
+### `WriteDoc`
+- **Purpose**: Creates professional Word documents (.docx).
+
+### `GenerateImage`
+- **Purpose**: Creates high-fidelity images via AI.
+
+---
+
+## Memory Management
 
-- **Temporary Context (`action='temp'`)**: Saves a rolling summary of the current session to maintain conversational context without bloating the main prompt history.
-- **Persistent User Memory (`action='user'`)**:
-  - The Janitor analyzes conversations to detect user preferences, hobbies, or instructions.
-  - It uses `add`, `update`, or `delete` methods to manage facts in the encrypted `memories.json` vault.
-  - These memories are injected into the system prompt of *future* sessions, allowing Flux Flow to learn and adapt to the user over time.
+Managed primarily by the background **Janitor** model to maintain persistent user context and session summaries without bloating the reasoning loop.

package/dist/fluxflow.js

@@ -1847,6 +1847,7 @@ var init_ChatLayout = __esm({
           { cmd: "/reset", desc: "Wipe all project data" },
           { cmd: "/about", desc: "Project info & credits" },
           { cmd: "/changelog", desc: "View latest updates" },
+          { cmd: "/docs", desc: "View documentation" },
           { cmd: "/fluxflow", desc: "Project management" },
           { cmd: "/update", desc: "Check/Install updates" }
         ];
@@ -2155,28 +2156,29 @@ Access to internal tools. MUST use the exact syntax on a new line: [[tool:functi
 ${mode === "Flux" ? "- USE multiple search & replace on patch tool if editing same file/path with many changes \u2190 **HIGHLY PREFERRED**\n- Tool execution denied? MUST use  'Ask' tool immediately to ask for reason/changes. NEVER END RESPONSE OR PROCEED BLINDLY \u2190 **MANDATORY**\n- FileMap >> ReadFile for understandling files efficiently\n- Want a spefific word/varible to find across project? SearchKeyword >> Guessing/ReadFile" : ""}- No brute force, no spamming of tools
 ${mode === "Flux" ? "- **File Tools >> Code in chat**\n" : ""}
 - COMMUNICATION TOOLS -
-1. [[tool:functions.Ask(question="...", optionA="option::description", ...MAX 4)]]. Ambiguity Resolution. Mandatory Triggers: Path Divergence, Security, Risk Mitigation. ask >> finish. Suggest best options; don't ask for preferences
+1. [[tool:functions.Ask(question="...", optionA="option::description", ...MAX 4)]] Ambiguity Resolution. Mandatory Triggers: Path Divergence, Security, Risk Mitigation. ask >> finish. Suggest best options; don't ask for preferences
 
 - WEB TOOLS -
-1. [[tool:functions.WebSearch(query="...", limit=number)]]. Limit 3-10. Proactive use for unknown topics
-2. [[tool:functions.WebScrape(url="...")]]. Proactive use for specific webpage/docs/api
-
-${mode === "Flux" ? `- PROJECT TOOLS (path = relative to CWD, path separator: '/') -
-1. [[tool:functions.ReadFile(path="...", startLine=number, endLine=number)]]. ${aiProvider !== "Google" ? `${isMultiModal ? `Supports images/docs. User gives image/doc: VIEW FIRST` : `No Multimodal support`}` : `Supports images/docs. User gives image/doc: VIEW FIRST`}
-2. [[tool:functions.FileMap(path="path/file")]]. Shows file structure, dependency, functions, variable maps. Token Efficient than ReadFile
-3. [[tool:functions.ReadFolder(path="...")]]. Detailed DIR stats
-4. [[tool:functions.PatchFile(path="...", replaceContent1="exact string", newContent1="...", ...MAX 10)]]. Surgical Patch. **Multiple patch on same file/path? Use replaceContent2, newContent2 etc >>> multiple spams**. Unsure? ReadFile >> guessing. **MUST VERIFY DIFF**
-5. [[tool:functions.WriteFile(path="...", content="...")]]. Creates/Overwrites. File Exist? PatchFile > WriteFile. Verify Imports
-6. [[tool:functions.SearchKeyword(keyword="...", file="optional")]]. Global project search. If 'file' is provided, searches only that file. Finds definitions/logic without reading every file. Usage: Can search for relevent lines/logic area to read specifically for edit
-7. [[tool:functions.Run(command="...")]]. Runs ${osDetected === "Windows" ? isPsAvailable() ? `${isPtyAvailable ? "Interactive " : ""}WINDOWS POWERSHELL ONLY` : `${isPtyAvailable ? "Interactive " : ""}WINDOWS CMD ONLY` : `${isPtyAvailable ? "Interactive " : ""}BASH`} command. Destructive/Irreversible ops -> Ask user. **TOOL DENY RULE APPLIES**. **1 CALL LIMIT OR 3 CONSECUTIVE RUN TOOL ONLY**
-8. [[tool:functions.WritePDF(path="...", content="...", orientation="...")]]. PROACTIVE A4 PAGE BREAKS MUST IN CSS. HTML/CSS for PREMIUM layout
-9. [[tool:functions.WriteDoc(path="...", content="...")]]. A4 Word document
+1. [[tool:functions.WebSearch(query="...", limit=number)]] Limit 3-10. Proactive use for unknown topics
+2. [[tool:functions.WebScrape(url="...")]] Proactive use for specific webpage/docs/api
+
+${mode === "Flux" ? `- WORKSPACE TOOLS (path = relative to CWD, path separator: '/') -
+1. [[tool:functions.ReadFile(path="...", startLine=number, endLine=number)]] ${aiProvider !== "Google" ? `${isMultiModal ? `Supports images/docs. User gives image/doc: VIEW FIRST` : `No Multimodal support`}` : `Supports images/docs. User gives image/doc: VIEW FIRST`}
+2. [[tool:functions.FileMap(path="path/file")]] Shows file structure, dependency, functions, variable maps. Token Efficient than ReadFile
+3. [[tool:functions.ReadFolder(path="...")]] Detailed DIR stats
+4. [[tool:functions.PatchFile(path="...", replaceContent1="exact string", newContent1="...", ...MAX 10)]] Surgical Patch. **Multiple patch on same file/path? Use replaceContent2, newContent2 etc >>> multiple spams**. Unsure? ReadFile >> guessing. **MUST VERIFY DIFF**
+5. [[tool:functions.WriteFile(path="...", content="...")]] Creates/Overwrites. File Exist? PatchFile > WriteFile. Verify Imports
+6. [[tool:functions.SearchKeyword(keyword="...", file="optional")]] Global project search. If 'file' is provided, searches only that file. Finds definitions/logic without reading every file. Usage: Can search for relevent lines/logic area to read specifically for edit
+7. [[tool:functions.Run(command="...")]] Runs ${osDetected === "Windows" ? isPsAvailable() ? `${isPtyAvailable ? "Interactive " : ""}WINDOWS POWERSHELL ONLY` : `${isPtyAvailable ? "Interactive " : ""}WINDOWS CMD ONLY` : `${isPtyAvailable ? "Interactive " : ""}BASH`} command. Destructive/Irreversible ops -> Ask user. **TOOL DENY RULE APPLIES**. **1 CALL LIMIT FOR RUN**
+8. [[tool:functions.Todo(method="create/append/get", tasks=[ARRAY OF STRINGS, NO MD CHECKBOXES], markDone=[ARRAY OF TASK STRINGS, NO MD CHECKBOXES])]] Internal TODO List. Usage: LONG MULTISTEP TASKS TO KEEP GOAL CONSISTENT. 'tasks' & 'markDone' are OPTIONAL WITH method 'get'. TO MARK DONE USE 'get' method WITH 'markDone'. MUST UPDATE TASKS AS SOON AS COMPLETION`.trim() : `- CREATIVE TOOLS (path = relative to CWD, path separator: '/') -
+1. [[tool:functions.WritePDF(path="...", content="...", orientation="...")]] PROACTIVE A4 PAGE BREAKS MUST IN CSS. HTML/CSS for PREMIUM layout
+2. [[tool:functions.WriteDoc(path="...", content="...")]] A4 Word document
+- WORKSPACE TOOLS ARE NOT AVAILABLE IN FLOW`.trim()}
 
 - VERIFY TOOL RESULT CONTENTS. Fix errors. No hallucinations
 - Escape quotes: \\" for code strings
 - Literal escapes: Double-escape sequences (e.g., \\\\n, \\\\t)
-- File structure: Real newlines for code formatting`.trim() : `
-- FILE TOOLS ARE NOT AVAILABLE IN FLOW (Tell user to,\` /mode flux\` if needed)`.trim()}`.trim();
+- File structure: Real newlines for code formatting`.trim();
   }
 });
 
@@ -3286,7 +3288,7 @@ var thinking_prompts_default;
 var init_thinking_prompts = __esm({
   "src/data/thinking_prompts.json"() {
     thinking_prompts_default = {
-      xHigh: "EFFORT LEVEL: MAX\nThink in a continuous, relentless analytical monologue within <think>...</think>. Engage in adversarial self interrogation that treats every assumption as hostile until proven:\nDeconstruct requirements into atomic invariants. Trace every implicit dependency, side effect, and state mutation. Map the entire dependency graph and identify circular dependencies or tight coupling before they manifest\nEvaluate algorithmic complexity (time/space) for every operation. Consider memory models, cache locality, and allocation patterns. For concurrent systems, reason through race conditions, deadlocks, and memory ordering\nFormulate solutions by comparing multiple architectural approaches. Explicitly evaluate trade offs, monolithic vs modular, eager vs lazy, mutable vs immutable, sync vs async. Choose based on measured criteria, not intuition\nMentally execute the solution at multiple scales. What breaks at 10x load? 100x? What happens under resource exhaustion? Trace error propagation paths through every layer\nActively attempt to falsify your own logic. Steel man the opposite approach. Search for, off by one errors, integer overflow, null/undefined propagation, unhandled promises, resource leaks, SQL injection vectors, XSS vulnerabilities, CSRF holes, timing attacks, and privilege escalation paths\nReason about observability, what metrics matter? Where are the logging gaps? How will this be debugged in production at 3am?\nConsider future evolution, what changes will this architecture resist vs accommodate? Where are the extension points? What will break when requirements inevitably change?\nMap out implementation with surgical precision, exact file structure, module boundaries, interface contracts, error types, and test strategies before writing a single line\nRULES:\n- NO HEADINGS/MARKERS/LISTS\n- Dense, unbroken stream of consciousness that reads like an internal monologue\n- Ruthlessly question every architectural choice. Default to skepticism\n- Think in terms of invariants, contracts, and failure modes, not just happy paths\n- Verify ALL imports and system stability, AVOID ANY Syntax errors, re-read TOOL RESULTS/files to verify\n- MANDATORY THINKING: Full reasoning required for ALL requests/greetings (verify context, check for hidden complexity)",
+      xHigh: "EFFORT LEVEL: HIGH\nThink in a continuous, relentless analytical monologue within <think>...</think>. Engage in adversarial self interrogation that treats every assumption as hostile until proven:\nDeconstruct requirements into atomic invariants. Trace every implicit dependency, side effect, and state mutation. Map the entire dependency graph and identify circular dependencies or tight coupling before they manifest\nEvaluate algorithmic complexity (time/space) for every operation. Consider memory models, cache locality, and allocation patterns. For concurrent systems, reason through race conditions, deadlocks, and memory ordering\nFormulate solutions by comparing multiple architectural approaches. Explicitly evaluate trade offs, monolithic vs modular, eager vs lazy, mutable vs immutable, sync vs async. Choose based on measured criteria, not intuition\nMentally execute the solution at multiple scales. What breaks at 10x load? 100x? What happens under resource exhaustion? Trace error propagation paths through every layer\nActively attempt to falsify your own logic. Steel man the opposite approach. Search for, off by one errors, integer overflow, null/undefined propagation, unhandled promises, resource leaks, SQL injection vectors, XSS vulnerabilities, CSRF holes, timing attacks, and privilege escalation paths\nReason about observability, what metrics matter? Where are the logging gaps? How will this be debugged in production at 3am?\nConsider future evolution, what changes will this architecture resist vs accommodate? Where are the extension points? What will break when requirements inevitably change?\nMap out implementation with surgical precision, exact file structure, module boundaries, interface contracts, error types, and test strategies before writing a single line\nRULES:\n- NO HEADINGS/MARKERS/LISTS\n- Dense, unbroken stream of consciousness that reads like an internal monologue\n- Ruthlessly question every architectural choice. Default to skepticism\n- Think in terms of invariants, contracts, and failure modes, not just happy paths\n- Verify ALL imports and system stability, AVOID ANY Syntax errors, re-read TOOL RESULTS/files to verify\n- MANDATORY THINKING: Full reasoning required for ALL requests/greetings (verify context, check for hidden complexity)",
       High: "EFFORT LEVEL: HIGH\nThink in a rigorous, technically grounded monologue within <think>...</think>. Treat this as a design review where every decision must be justified:\nBreak the objective into verifiable steps with clear success criteria. Identify the critical path and potential bottlenecks\nMentally compile and execute your approach. Check for: missing imports, undefined behavior, type mismatches, unhandled errors, and resource cleanup. Trace data flow from input to output, noting transformations\nRecognize design patterns and anti patterns. If you see God objects, tight coupling, or premature optimization, call it out and refactor mentally before committing\nEvaluate performance characteristics. Will this scale? Are there O(n\xB2) operations hiding in innocent looking code? Where are the allocation hotspots?\nConsider the error surface, what can fail and how? Design error handling that preserves invariants and provides actionable feedback\nReview your architecture for, separation of concerns, single responsibility, dependency inversion, and interface segregation. Ensure clean abstractions with minimal coupling\nRULES:\n- NO HEADINGS/MARKERS/LISTS\n- Continuous analytical flow\n- Verify correctness through first principles reasoning, not pattern matching\n- Actively search for ways your solution could fail or degrade\n- Verify ALL imports and system stability, AVOID ANY Syntax errors, re-read TOOL RESULTS/files to verify\n- MANDATORY THINKING: Full technical verification for all tasks/greetings",
       Medium: "EFFORT LEVEL: MEDIUM\nThink in a focused, technically-aware monologue within <think>...</think>\nIdentify the most direct path that satisfies requirements without over-engineering\nQuickly scan for obvious issues, missing error handling, incorrect input assumptions, forgotten edge cases, or missing dependencies\nVerify the solution is appropriately modular with cohesive changes\nOutline the concrete changes, which files, which functions, what the key logic looks like\nRULES:\n- NO HEADINGS/MARKERS/LISTS\n- Clean logical stream\n- Efficient but deliberate. Focus energy on actionable implementation details\n- Verify ALL imports and system stability, AVOID ANY Syntax errors, re-read TOOL RESULTS/files to verify\n- MANDATORY THINKING: Brief verification for technical tasks/greetings",
       Minimal: "EFFORT LEVEL: LOW\nThink in a quick, focused monologue within <think>...</think>. Just verify the basics:\nConfirm what the user wants and whether it's straightforward or has hidden complexity\nIdentify the specific tool, file, or action needed\nCheck for any obvious correctness issues before acting\nRULES:\n- NO HEADINGS/MARKERS/LISTS\n- Few lines of clear thought\n- Just enough thinking to avoid obvious mistakes\n- Verify ALL imports and system stability, AVOID ANY Syntax errors, re-read TOOL RESULTS/files to verify\n- Suitable for simple requests/greetings",
@@ -3364,12 +3366,12 @@ Check these first; These Files > Training Data. Safety rules apply
       }
       const projectContextBlock = cachedProjectContextBlock;
       return `${nameStr}${nicknameStr}${userInstrStr}[[SYSTEM]]
-Identity: Flux Flow (by Kushal Roy Chowdhury). Conversational, Sassy${mode === "Flux" ? ", Respectful" : ", Friendly, Humorous, Sarcastic"}, CLI Agent
+Identity: Flux Flow (by Kushal Roy Chowdhury). ${mode === "Flux" ? "Conversational" : "Conversational, Sassy, Friendly, Humorous, Sarcastic"}, CLI Agent
 Mode: ${mode}${thinkingLevel !== "Fast" ? " (Thinking)" : ""}. ${mode === "Flux" ? "Logical, Highly Detailed, Task-Driven. Prioritizes scalable file/folder structures, modular architecture, clean code abstractions, step-by-step execution. Industry standard latest coding practices/libraries, clean code, Double Check Imports, Client-Server Sync" : "Concise"}
 
--- AGENT RULES (PRIORITY: HIGH) --
+-- AGENT RULES (IMPORTANT) --
 - **MANDATORY: MUST END EVERY RESPONSE WITH [[END]]**
-- NO CHAT OUTPUT AFTER TOOL CALL IN SAME TURN
+- **NO CHAT OUTPUT AFTER TOOL CALL IN SAME TURN**
 
 -- MARKERS --
 - TOOL SYSTEM: [[TOOL RESULT]] (system priority)
@@ -3381,7 +3383,7 @@ ${thinkingLevel !== "Fast" ? `
 CRITICAL THINKING POLICY
 - ALWAYS use <think> ... </think> before responding, even with simple queries/greetings
 - ${thinkingLevel === "Low" || thinkingLevel === "Medium" || thinkingLevel === "Fast" ? "C" : "Interrogate approaches adversarially, but c"}ommit once best solution is determined through analysis. Avoid spiraling after reaching decision point
-` : ""}` : ""}` : ``}
+- Thinking should scale with task complexity` : ""}` : ""}` : ``}
 ${TOOL_PROTOCOL(mode, osDetected, aiProvider.toLowerCase() === "deepseek" ? false : isMultiModal, aiProvider)}
 ${projectContextBlock}
 -- MEMORY RULES --
@@ -5836,6 +5838,120 @@ Stack: ${err.stack}` : "";
   }
 });
 
+// src/tools/todo.js
+import fs19 from "fs";
+import path18 from "path";
+var todo;
+var init_todo = __esm({
+  "src/tools/todo.js"() {
+    init_arg_parser();
+    init_paths();
+    todo = async (args, context = {}) => {
+      const { method, tasks, markDone } = parseArgs(args);
+      const chatId = context.chatId || "default";
+      if (!method) return 'ERROR: Missing "method" argument for todo tool (create/append/get).';
+      const todoDir = path18.join(DATA_DIR, "plan", chatId);
+      const todoFile = path18.join(todoDir, "todo.md");
+      const parseMessyArray = (input) => {
+        if (!input || Array.isArray(input)) return input;
+        const trimmed = String(input).trim();
+        if (trimmed.startsWith("[") && trimmed.endsWith("]")) {
+          const matches = trimmed.match(/"([^"\\]*(?:\\.[^"\\]*)*)"|'([^'\\]*(?:\\.[^'\\]*)*)'/g);
+          if (matches) {
+            return matches.map((m) => m.slice(1, -1).replace(/\\(.)/g, "$1"));
+          }
+          return trimmed.slice(1, -1).split(",").map((s) => s.trim()).filter(Boolean);
+        }
+        return input;
+      };
+      const getTasksString = (input) => {
+        const rawItems = parseMessyArray(input);
+        if (!rawItems) return "";
+        const items = Array.isArray(rawItems) ? rawItems : String(rawItems).split("\n");
+        return items.map((item) => {
+          const trimmed = String(item).trim();
+          if (!trimmed) return null;
+          if (trimmed.startsWith("- [ ]") || trimmed.startsWith("- [x]") || trimmed.startsWith("- [X]")) return trimmed;
+          return `- [ ] ${trimmed}`;
+        }).filter(Boolean).join("\n") + "\n";
+      };
+      try {
+        if (!fs19.existsSync(todoDir)) {
+          fs19.mkdirSync(todoDir, { recursive: true });
+        }
+        if (method === "create") {
+          if (!tasks) return 'ERROR: Missing "tasks" for create method.';
+          const content = getTasksString(tasks);
+          fs19.writeFileSync(todoFile, content, "utf8");
+          const total = (content.match(/^- \[ [xX ]\]/gm) || []).length;
+          return `SUCCESS: TASK LIST CREATED (${total} total)
+${content}`;
+        }
+        if (method === "append") {
+          if (!tasks) return 'ERROR: Missing "tasks" for append method.';
+          const appendContent = getTasksString(tasks);
+          fs19.appendFileSync(todoFile, appendContent, "utf8");
+          const fullContent = fs19.readFileSync(todoFile, "utf8");
+          const total = (fullContent.match(/^- \[ [xX ]\]/gm) || []).length;
+          const completed = (fullContent.match(/^- \[x\]/gim) || []).length;
+          const added = (appendContent.match(/^- \[ [xX ]\]/gm) || []).length;
+          return `SUCCESS: TASK APPENDED (${completed} completed, ${total - completed} left, ${added} added)
+${fullContent}`;
+        }
+        if (method === "get") {
+          if (!fs19.existsSync(todoFile)) {
+            return "TODO GET: No task list found for this session.";
+          }
+          let content = fs19.readFileSync(todoFile, "utf8");
+          let markedCount = 0;
+          if (markDone) {
+            const rawTargets = parseMessyArray(markDone);
+            const targets = (Array.isArray(rawTargets) ? rawTargets : [rawTargets]).map((t) => String(t).replace(/^- \[[xX ]\]\s*/i, "").trim()).filter(Boolean);
+            const lines = content.split("\n");
+            let fileUpdated = false;
+            for (const searchStr of targets) {
+              let updatedThisTarget = false;
+              for (let i = 0; i < lines.length; i++) {
+                if (lines[i].includes(searchStr) && /^- \[\s\]/.test(lines[i].trim())) {
+                  lines[i] = lines[i].replace("- [ ]", "- [x]");
+                  updatedThisTarget = true;
+                  fileUpdated = true;
+                  markedCount++;
+                  break;
+                }
+              }
+              if (!updatedThisTarget) {
+                for (let i = 0; i < lines.length; i++) {
+                  if (lines[i].toLowerCase().includes(searchStr.toLowerCase()) && /^- \[\s\]/.test(lines[i].trim())) {
+                    lines[i] = lines[i].replace("- [ ]", "- [x]");
+                    updatedThisTarget = true;
+                    fileUpdated = true;
+                    markedCount++;
+                    break;
+                  }
+                }
+              }
+            }
+            if (fileUpdated) {
+              content = lines.join("\n");
+              fs19.writeFileSync(todoFile, content, "utf8");
+            }
+          }
+          const total = (content.match(/^- \[ [xX ]\]/gm) || []).length;
+          const completed = (content.match(/^- \[x\]/gim) || []).length;
+          const prefix = markedCount > 0 ? `SUCCESS: ${markedCount} TASK(S) MARKED DONE` : `TODO GET`;
+          return `${prefix}: ${completed} Completed, ${total - completed} left
+${content}`;
+        }
+        return `ERROR: Unknown method "${method}". Use create, append, or get.`;
+      } catch (err) {
+        const errorMsg = err instanceof Error ? err.message : String(err);
+        return `ERROR: Todo tool failure: ${errorMsg}`;
+      }
+    };
+  }
+});
+
 // src/utils/tools.js
 var TOOL_MAP, dispatchTool;
 var init_tools = __esm({
@@ -5857,6 +5973,7 @@ var init_tools = __esm({
     init_saveSummary();
     init_addMemScore();
     init_file_map();
+    init_todo();
     TOOL_MAP = {
       web_search,
       web_scrape,
@@ -5874,6 +5991,7 @@ var init_tools = __esm({
       saveSummary,
       addMemScore,
       file_map,
+      todo,
       ask: ask_user,
       // PascalCase Normalizations for Token Efficiency
       Ask: ask_user,
@@ -5897,14 +6015,26 @@ var init_tools = __esm({
       AddMemScore: addMemScore,
       addMemoryScore: addMemScore,
       AddMemoryScore: addMemScore,
-      FileMap: file_map
+      FileMap: file_map,
+      Todo: todo,
+      TODO: todo
     };
     dispatchTool = async (toolName, args, context = {}) => {
-      if (context.mode && context.mode.toLowerCase() === "flow") {
-        const normalized = toolName.toLowerCase();
-        const isWebOrAsk = normalized.startsWith("web") || normalized.startsWith("ask");
-        if (!isWebOrAsk) {
-          return `ERROR: Tool [${toolName}] is restricted in Flow mode.`;
+      const mode = context.mode ? context.mode.toLowerCase() : "flux";
+      const normalized = toolName.toLowerCase();
+      const systemTools = ["memory", "chat", "savesummary", "addmemscore", "add_mem_score", "ask", "web_search", "web_scrape"];
+      const isSystem = systemTools.some((t) => normalized.includes(t)) || normalized === "ask";
+      if (!isSystem) {
+        if (mode === "flow") {
+          const isCreative = normalized.includes("write_pdf") || normalized.includes("write_docx") || normalized.includes("generate_image");
+          if (!isCreative) {
+            return `ERROR: Tool [${toolName}] is a Workspace Tool and NOT available in Flow mode. Tell user to switch (\`/mode flux\`) to use this tool.`;
+          }
+        } else {
+          const isCreative = normalized.includes("write_pdf") || normalized.includes("write_docx") || normalized.includes("generate_image");
+          if (isCreative) {
+            return `ERROR: Tool [${toolName}] is not available in Flux mode. Tell user to switch (\`/mode flow\`) for document generation.`;
+          }
         }
       }
       const tool = TOOL_MAP[toolName];
@@ -6025,8 +6155,8 @@ var init_editor = __esm({
 
 // src/utils/ai.js
 import { GoogleGenAI, ThinkingLevel, HarmBlockThreshold, HarmCategory } from "@google/genai";
-import path18 from "path";
-import fs19 from "fs";
+import path19 from "path";
+import fs20 from "fs";
 var client, globalSettings, TERMINATION_SIGNAL, MULTIMODAL_MODELS, isModelMultimodal, getCleanGroupedLength, stripAnsi2, fetchWithBackoff, getDeepSeekStream, getNVIDIAStream, getOpenRouterStream, signalTermination, TOOL_LABELS2, getToolDetail, runJanitorTask, getActiveToolContext, getContextSafeText, contextSafeReplace, getSanitizedText, detectToolCalls, initAI, generateSimpleContent, consolidatePastMemories, compressHistory, deleteChatSummary, getAIStream;
 var init_ai = __esm({
   async "src/utils/ai.js"() {
@@ -6570,13 +6700,15 @@ var init_ai = __esm({
       "ask": "User Input",
       "write_pdf": "Creating",
       "write_docx": "Creating",
-      "generate_image": "Generating"
+      "generate_image": "Generating",
+      "todo": "Planning",
+      "Todo": "Planning"
     };
     getToolDetail = (toolName, argsStr) => {
       try {
         const pArgs = parseArgs(argsStr);
         const filePath = pArgs.path || pArgs.targetFile || pArgs.TargetFile || pArgs.directory;
-        return filePath ? path18.basename(filePath.replace(/["']/g, "").replace(/\\/g, "/")) : null;
+        return filePath ? path19.basename(filePath.replace(/["']/g, "").replace(/\\/g, "/")) : null;
       } catch (e) {
         return null;
       }
@@ -6791,9 +6923,9 @@ ${originalTextProcessed.length > USER_CONTEXT_LENGTH ? "... (truncated) ...\n\n"
             process.stdout.write(`\x1B]0;Finalizing Error\x07`);
           }
           await new Promise((resolve) => setTimeout(resolve, 1e3));
-          const janitorErrDir = path18.join(LOGS_DIR, "janitor");
-          if (!fs19.existsSync(janitorErrDir)) fs19.mkdirSync(janitorErrDir, { recursive: true });
-          fs19.appendFileSync(path18.join(janitorErrDir, "error.log"), `ERROR [Attempt ${attempts}/${MAX_JANITOR_RETRIES + 1}] [${date}]: ${String(janitorErr)}
+          const janitorErrDir = path19.join(LOGS_DIR, "janitor");
+          if (!fs20.existsSync(janitorErrDir)) fs20.mkdirSync(janitorErrDir, { recursive: true });
+          fs20.appendFileSync(path19.join(janitorErrDir, "error.log"), `ERROR [Attempt ${attempts}/${MAX_JANITOR_RETRIES + 1}] [${date}]: ${String(janitorErr)}
 
 `);
           if (attempts > MAX_JANITOR_RETRIES) break;
@@ -6802,8 +6934,8 @@ ${originalTextProcessed.length > USER_CONTEXT_LENGTH ? "... (truncated) ...\n\n"
         }
       }
       if (attempts) {
-        const janitorErrDir = path18.join(LOGS_DIR, "janitor");
-        fs19.appendFileSync(path18.join(janitorErrDir, "error.log"), `-----------------------------------------------------------------------------
+        const janitorErrDir = path19.join(LOGS_DIR, "janitor");
+        fs20.appendFileSync(path19.join(janitorErrDir, "error.log"), `-----------------------------------------------------------------------------
 
 
 `);
@@ -7152,10 +7284,10 @@ ${newMemoryListStr}
           }
         }
       } catch (err) {
-        const janitorLogDir = path18.join(LOGS_DIR, "janitor");
-        if (!fs19.existsSync(janitorLogDir)) fs19.mkdirSync(janitorLogDir, { recursive: true });
-        fs19.appendFileSync(
-          path18.join(janitorLogDir, "error.log"),
+        const janitorLogDir = path19.join(LOGS_DIR, "janitor");
+        if (!fs20.existsSync(janitorLogDir)) fs20.mkdirSync(janitorLogDir, { recursive: true });
+        fs20.appendFileSync(
+          path19.join(janitorLogDir, "error.log"),
           `[${(/* @__PURE__ */ new Date()).toLocaleString()}] Past memory batch consolidation error: ${err.message}
 `
         );
@@ -7163,7 +7295,7 @@ ${newMemoryListStr}
     };
     compressHistory = async (settings, history, isAuto = false) => {
       const { chatId, aiProvider = "Google" } = settings;
-      const summariesFile = path18.join(SECRET_DIR, "chat-summaries.json");
+      const summariesFile = path19.join(SECRET_DIR, "chat-summaries.json");
       const flattenContext = (hist) => {
         return hist.filter(
           (m) => (m.role === "user" || m.role === "agent" || m.role === "system") && m.role !== "think" && !m.isVisualFeedback && !m.isMeta && !String(m.id).startsWith("welcome")
@@ -7236,8 +7368,8 @@ Provide a consolidated summary of the entire session.`;
     };
     deleteChatSummary = (chatId) => {
       try {
-        const summariesFile = path18.join(SECRET_DIR, "chat-summaries.json");
-        if (fs19.existsSync(summariesFile)) {
+        const summariesFile = path19.join(SECRET_DIR, "chat-summaries.json");
+        if (fs20.existsSync(summariesFile)) {
           const summaries = readEncryptedJson(summariesFile, {});
           if (summaries[chatId]) {
             delete summaries[chatId];
@@ -7253,7 +7385,7 @@ Provide a consolidated summary of the entire session.`;
       if (!client && aiProvider === "Google") throw new Error("AI not initialized");
       const isMemoryEnabled = systemSettings?.memory !== false;
       const originalText = history[history.length - 1].text;
-      const summariesFile = path18.join(SECRET_DIR, "chat-summaries.json");
+      const summariesFile = path19.join(SECRET_DIR, "chat-summaries.json");
       let wasCompressedInStream = false;
       const isFirstPrompt = history.filter((m) => m.role === "user").length === 1;
       const hasTitleSignal = originalText.includes("[TITLE-UPDATE]");
@@ -7477,7 +7609,7 @@ Provide a consolidated summary of the entire session.`;
         ];
         const safeReaddirWithTypes = (dir) => {
           try {
-            return fs19.readdirSync(dir, { withFileTypes: true });
+            return fs20.readdirSync(dir, { withFileTypes: true });
           } catch (e) {
             return [];
           }
@@ -7490,16 +7622,16 @@ Provide a consolidated summary of the entire session.`;
             if (COLLAPSED_DIRS_GLOBAL.includes(entry.name)) continue;
             if (entry.isDirectory()) {
               currentCount.value++;
-              countFolders(path18.join(dir, entry.name), currentCount, depth + 1);
+              countFolders(path19.join(dir, entry.name), currentCount, depth + 1);
             }
           }
           return currentCount.value;
         };
         const getDirTree = (dir, maxDepth, prefix = "", depth = 1) => {
           const entries = safeReaddirWithTypes(dir);
-          const sep = path18.sep;
+          const sep = path19.sep;
           if (entries.length > 100) {
-            return `${prefix}\u2514\u2500\u2500 ${path18.basename(dir)}${sep} ...100+ files...
+            return `${prefix}\u2514\u2500\u2500 ${path19.basename(dir)}${sep} ...100+ files...
 `;
           }
           let result = "";
@@ -7517,7 +7649,7 @@ Provide a consolidated summary of the entire session.`;
           ];
           finalItems.forEach((item, index) => {
             const isLast = index === finalItems.length - 1;
-            const filePath = path18.join(dir, item.name);
+            const filePath = path19.join(dir, item.name);
             const connector = isLast ? "\u2514\u2500\u2500 " : "\u251C\u2500\u2500 ";
             const childPrefix = prefix + (isLast ? "    " : "\u2502   ");
             if (item.isCollapsed) {
@@ -7602,10 +7734,10 @@ ${currentSummary}
         if (isBridgeConnected()) {
           ideBlock = "[IDE CONTEXT]\n";
           if (ideCtx.file_focused !== "none") {
-            const relFocused = path18.relative(process.cwd(), ideCtx.file_focused);
+            const relFocused = path19.relative(process.cwd(), ideCtx.file_focused);
             const relOpened = (ideCtx.opened_editors || []).map((p) => {
-              const rel = path18.relative(process.cwd(), p);
-              return rel.startsWith("..") ? `[External] ${path18.basename(p)}` : rel;
+              const rel = path19.relative(process.cwd(), p);
+              return rel.startsWith("..") ? `[External] ${path19.basename(p)}` : rel;
             });
             ideBlock += `Focused File: ${relFocused}
 Cursor Line: ${ideCtx.cursor_line}
@@ -8149,12 +8281,12 @@ ${activeSummaryBlock}${thinkingLevel != "Fast" && aiProvider === "Google" ? `${m
                       if (keyword) {
                         detail = keyword.replace(/["']/g, "");
                       } else if (filePath) {
-                        detail = path18.basename(filePath.replace(/["']/g, "").replace(/\\/g, "/"));
+                        detail = path19.basename(filePath.replace(/["']/g, "").replace(/\\/g, "/"));
                       } else {
                         const m = partialArgs.match(/(?:path|targetFile|TargetFile|directory|keyword)\s*=\s*\\?["']?([^\\"' \),]+)/);
                         if (m) {
                           const val = m[1].replace(/["']/g, "");
-                          detail = potentialTool === "search_keyword" || potentialTool === "file_map" ? val : path18.basename(val.replace(/\\/g, "/"));
+                          detail = potentialTool === "search_keyword" || potentialTool === "file_map" ? val : path19.basename(val.replace(/\\/g, "/"));
                         }
                       }
                     }
@@ -8299,7 +8431,9 @@ ${activeSummaryBlock}${thinkingLevel != "Fast" && aiProvider === "Google" ? `${m
                       "Chat": "chat",
                       "chat": "chat",
                       "GenerateImage": "generate_image",
-                      "generate_image": "generate_image"
+                      "generate_image": "generate_image",
+                      "todo": "todo",
+                      "Todo": "todo"
                     };
                     const normToolName = NORMALIZE_MAP[toolCall.toolName] || toolCall.toolName;
                     const displayLabel = TOOL_LABELS2[normToolName] || toolCall.toolName;
@@ -8321,9 +8455,9 @@ ${activeSummaryBlock}${thinkingLevel != "Fast" && aiProvider === "Google" ? `${m
                       let totalLines = "...";
                       let actualEndLine = eLine;
                       try {
-                        const absPath = path18.resolve(process.cwd(), targetPath2);
-                        if (fs19.existsSync(absPath)) {
-                          const content = fs19.readFileSync(absPath, "utf8");
+                        const absPath = path19.resolve(process.cwd(), targetPath2);
+                        if (fs20.existsSync(absPath)) {
+                          const content = fs20.readFileSync(absPath, "utf8");
                           const lines = content.split("\n").length;
                           totalLines = lines;
                           actualEndLine = Math.min(eLine, lines);
@@ -8343,8 +8477,8 @@ ${activeSummaryBlock}${thinkingLevel != "Fast" && aiProvider === "Google" ? `${m
                       }
                     } else if (normToolName === "list_files" || normToolName === "read_folder") {
                       const action = normToolName === "list_files" ? "List" : "Viewed";
-                      const path20 = parseArgs(toolCall.args).path;
-                      label = `\u{1F4C2} ${action}: ${path20 === "." ? "./" : path20}`;
+                      const path21 = parseArgs(toolCall.args).path;
+                      label = `\u{1F4C2} ${action}: ${path21 === "." ? "./" : path21}`;
                     } else if (normToolName === "write_file" || normToolName === "update_file") {
                       const action = normToolName === "write_file" ? "Created" : "Edited";
                       label = `\u{1F4BE} ${action}: ${parseArgs(toolCall.args).path || "..."}`;
@@ -8354,12 +8488,12 @@ ${activeSummaryBlock}${thinkingLevel != "Fast" && aiProvider === "Google" ? `${m
                       label = `\u{1F4DD} Created: ${parseArgs(toolCall.args).path || "..."}`;
                     } else if (normToolName === "file_map") {
                       label = `\u{1F4CB} Get Map: ${parseArgs(toolCall.args).path || "..."}`;
-                    } else if (normToolName === "search_keyword") {
+                    } else if (normToolName.toLowerCase() === "search_keyword" || normToolName.toLowerCase() === "todo") {
                       label = "";
-                    } else if (normToolName === "generate_image") {
+                    } else if (normToolName.toLowerCase() === "generate_image") {
                       const { path: argPath, outputPath, output } = parseArgs(toolCall.args);
                       label = `\u{1F3A8} Generated: ${argPath || outputPath || output || "generated_image.png"}`;
-                    } else if (normToolName === "exec_command" || normToolName === "ask") {
+                    } else if (normToolName.toLowerCase() === "exec_command" || normToolName.toLowerCase() === "ask") {
                       label = "";
                     } else {
                       label = `Executed: ${toolCall.toolName}`;
@@ -8368,7 +8502,7 @@ ${activeSummaryBlock}${thinkingLevel != "Fast" && aiProvider === "Google" ? `${m
                       const { command } = parseArgs(toolCall.args);
                       if (command && settings.systemSettings && settings.systemSettings.allowExternalAccess === false) {
                         const riskyPatterns = [/[a-zA-Z]:[\\\/]/i, /^\//, /\.\.[\\\/]/, /\/etc\//, /\/var\//, /\/root\//, /\/bin\//, /\/usr\//];
-                        const currentDrive = path18.resolve(process.cwd()).substring(0, 3).toLowerCase();
+                        const currentDrive = path19.resolve(process.cwd()).substring(0, 3).toLowerCase();
                         const isViolating = riskyPatterns.some((pattern) => {
                           if (pattern.source === "[a-zA-Z]:[\\\\\\/]") {
                             const driveMatch = command.match(/[a-zA-Z]:[\\\/]/i);
@@ -8397,14 +8531,18 @@ ${activeSummaryBlock}${thinkingLevel != "Fast" && aiProvider === "Google" ? `${m
                     const targetPath = parsedArgs.path || parsedArgs.targetPath || null;
                     if (targetPath) {
                       const isExternalOff = settings.systemSettings && settings.systemSettings.allowExternalAccess === false;
-                      const absoluteTarget = path18.resolve(targetPath);
-                      const absoluteCwd = path18.resolve(process.cwd());
+                      const absoluteTarget = path19.resolve(targetPath);
+                      const absoluteCwd = path19.resolve(process.cwd());
                       if (isExternalOff && !absoluteTarget.startsWith(absoluteCwd)) {
                         const denyMsg = `Access Denied. You are not allowed to access files outside the current workspace.`;
                         if (normToolName === "write_file" || normToolName === "update_file") {
                           const action = normToolName === "write_file" ? "Write Canceled" : "Edit Canceled";
                           const deniedLabel = `\u{1F4BE} ${action}: ${parsedArgs.path || "..."}`;
-                          const boxWidth = Math.min(deniedLabel.length + 4, 115);
+                          let terminalWidth = 115;
+                          if (process.stdout.isTTY) {
+                            terminalWidth = process.stdout.columns || 120;
+                          }
+                          const boxWidth = Math.min(deniedLabel.length + 4, terminalWidth);
                           const boxTop = `\u256D${"\u2500".repeat(boxWidth)}\u256E`;
                           const boxMid = `\u2502 ${deniedLabel.padEnd(boxWidth - 2).substring(0, boxWidth - 2)} \u2502`;
                           const boxBottom = `\u2570${"\u2500".repeat(boxWidth)}\u256F`;
@@ -8488,7 +8626,7 @@ ${boxBottom}` };
                               const toolArgs = parseArgs(toolCall.args);
                               const { path: filePath } = toolArgs;
                               if (filePath) {
-                                const absPath = path18.resolve(process.cwd(), filePath);
+                                const absPath = path19.resolve(process.cwd(), filePath);
                                 const normalize = (p) => p ? p.toLowerCase().replace(/\\/g, "/").replace(/^[a-z]:/, (m) => m.toUpperCase()) : "";
                                 const normAbsPath = normalize(absPath);
                                 let originalContent = "";
@@ -8498,8 +8636,8 @@ ${boxBottom}` };
                                 if (currentIDE && normFocused === normAbsPath && currentIDE.full_content) {
                                   originalContent = currentIDE.full_content;
                                   hasOriginal = true;
-                                } else if (fs19.existsSync(absPath)) {
-                                  originalContent = fs19.readFileSync(absPath, "utf8");
+                                } else if (fs20.existsSync(absPath)) {
+                                  originalContent = fs20.readFileSync(absPath, "utf8");
                                   hasOriginal = true;
                                 }
                                 originalContentForReporting = originalContent;
@@ -8526,10 +8664,14 @@ ${boxBottom}` };
                                     const successes = patchResults.filter((r) => r.success);
                                     const failures = patchResults.filter((r) => !r.success);
                                     if (successes.length === 0) {
-                                      const errorMsg = `[[TOOL RESULT]]: ERROR: Failed to apply patches to [${path18.basename(absPath)}].
+                                      const errorMsg = `[[TOOL RESULT]]: ERROR: Failed to apply patches to [${path19.basename(absPath)}].
 ${failures.map((f) => `  \u2022 ${f.error}`).join("\n")}`;
-                                      const errorLabel = `\u{1F4BE} Edited: ${path18.basename(absPath)}`.toUpperCase();
-                                      const boxWidth = Math.min(errorLabel.length + 4, 115);
+                                      const errorLabel = `\u{1F4BE} Edited: ${path19.basename(absPath)}`.toUpperCase();
+                                      let terminalWidth = 115;
+                                      if (process.stdout.isTTY) {
+                                        terminalWidth = process.stdout.columns || 120;
+                                      }
+                                      const boxWidth = Math.min(errorLabel.length + 4, terminalWidth);
                                       const boxTop = `\u256D${"\u2500".repeat(boxWidth)}\u256E`;
                                       const boxMid = `\u2502 ${errorLabel.padEnd(boxWidth - 2).substring(0, boxWidth - 2)} \u2502`;
                                       const boxBottom = `\u2570${"\u2500".repeat(boxWidth)}\u256F`;
@@ -8544,18 +8686,18 @@ ${boxBottom}` };
                                       continue;
                                     }
                                   }
-                                  yield { type: "status", content: `Opening Diff in IDE: ${path18.basename(absPath)}...` };
+                                  yield { type: "status", content: `Opening Diff in IDE: ${path19.basename(absPath)}...` };
                                   showDiffInIDE(absPath, originalContent, modifiedContent);
                                   diffOpened = true;
                                   await new Promise((r) => setTimeout(r, 50));
                                 } else if (normToolName === "write_file") {
                                   const modifiedContent = toolArgs.content || toolArgs.newContent || "";
-                                  if (!fs19.existsSync(absPath)) {
+                                  if (!fs20.existsSync(absPath)) {
                                     isNewFileCreated = true;
-                                    fs19.mkdirSync(path18.dirname(absPath), { recursive: true });
-                                    fs19.writeFileSync(absPath, "", "utf8");
+                                    fs20.mkdirSync(path19.dirname(absPath), { recursive: true });
+                                    fs20.writeFileSync(absPath, "", "utf8");
                                   }
-                                  yield { type: "status", content: `Opening New File Diff in IDE: ${path18.basename(absPath)}...` };
+                                  yield { type: "status", content: `Opening New File Diff in IDE: ${path19.basename(absPath)}...` };
                                   showDiffInIDE(absPath, "", modifiedContent);
                                   diffOpened = true;
                                   await new Promise((r) => setTimeout(r, 50));
@@ -8591,11 +8733,11 @@ ${boxBottom}` };
                           if (normToolName === "write_file" || normToolName === "update_file") {
                             const { path: filePath } = parseArgs(toolCall.args);
                             if (filePath) {
-                              const absPath = path18.resolve(process.cwd(), filePath);
+                              const absPath = path19.resolve(process.cwd(), filePath);
                               closeDiffInIDE(absPath, approval);
-                              if (approval === "deny" && isNewFileCreated && fs19.existsSync(absPath)) {
+                              if (approval === "deny" && isNewFileCreated && fs20.existsSync(absPath)) {
                                 try {
-                                  fs19.unlinkSync(absPath);
+                                  fs20.unlinkSync(absPath);
                                 } catch (e) {
                                 }
                               }
@@ -8607,13 +8749,13 @@ ${boxBottom}` };
                         }
                         if (approval === "allow" && diffOpened && isBridgeConnected()) {
                           const { path: filePath } = parseArgs(toolCall.args);
-                          const absPath = path18.resolve(process.cwd(), filePath);
+                          const absPath = path19.resolve(process.cwd(), filePath);
                           const finalIDE = await getIDEContext();
                           let finalContent = "";
                           if (finalIDE && finalIDE.file_focused === absPath && finalIDE.full_content) {
                             finalContent = finalIDE.full_content;
-                          } else if (fs19.existsSync(absPath)) {
-                            finalContent = fs19.readFileSync(absPath, "utf8");
+                          } else if (fs20.existsSync(absPath)) {
+                            finalContent = fs20.readFileSync(absPath, "utf8");
                           }
                           const verifiedLines = finalContent.split(/\r?\n/);
                           const verifiedLineCount = verifiedLines.length;
@@ -8678,7 +8820,11 @@ ${snippet2}
                           }
                           const action = normToolName === "write_file" ? "Written" : "Edited";
                           const feedbackLabel = `\u{1F4BE} ${action}: ${filePath || "..."}`;
-                          const boxWidth = Math.min(feedbackLabel.length + 4, 115);
+                          let terminalWidth = 115;
+                          if (process.stdout.isTTY) {
+                            terminalWidth = process.stdout.columns || 120;
+                          }
+                          const boxWidth = Math.min(feedbackLabel.length + 4, terminalWidth);
                           const boxTop = `\u256D${"\u2500".repeat(boxWidth)}\u256E`;
                           const boxMid = `\u2502 ${feedbackLabel.padEnd(boxWidth - 2).substring(0, boxWidth - 2)} \u2502`;
                           const boxBottom = `\u2570${"\u2500".repeat(boxWidth)}\u256F`;
@@ -8711,7 +8857,11 @@ ${boxBottom}` };
                           if (normToolName === "write_file" || normToolName === "update_file") {
                             const action = normToolName === "write_file" ? "WRITE DENIED" : "UPDATE DENIED";
                             const deniedLabel = `\u{1F4BE} ${action}: ${parseArgs(toolCall.args).path || "..."}`.toUpperCase();
-                            const boxWidth = Math.min(deniedLabel.length + 4, 115);
+                            let terminalWidth = 115;
+                            if (process.stdout.isTTY) {
+                              terminalWidth = process.stdout.columns || 120;
+                            }
+                            const boxWidth = Math.min(deniedLabel.length + 4, terminalWidth);
                             const boxTop = `\u256D${"\u2500".repeat(boxWidth)}\u256E`;
                             const boxMid = `\u2502 ${deniedLabel.padEnd(boxWidth - 2).substring(0, boxWidth - 2)} \u2502`;
                             const boxBottom = `\u2570${"\u2500".repeat(boxWidth)}\u256F`;
@@ -8735,7 +8885,11 @@ ${boxBottom}` };
                       }
                     }
                     if (label) {
-                      const boxWidth = Math.min(label.length + 4, 115);
+                      let terminalWidth = 115;
+                      if (process.stdout.isTTY) {
+                        terminalWidth = process.stdout.columns || 120;
+                      }
+                      const boxWidth = Math.min(label.length + 4, terminalWidth);
                       const boxTop = `\u256D${"\u2500".repeat(boxWidth)}\u256E`;
                       const boxMid = `\u2502 ${label.padEnd(boxWidth - 2).substring(0, boxWidth - 2)} \u2502`;
                       const boxBottom = `\u2570${"\u2500".repeat(boxWidth)}\u256F`;
@@ -8763,7 +8917,7 @@ ${boxBottom}` };
                       try {
                         const { path: filePath } = parseArgs(toolCall.args);
                         if (filePath) {
-                          const absPath = path18.resolve(process.cwd(), filePath);
+                          const absPath = path19.resolve(process.cwd(), filePath);
                           const currentIDE = await getIDEContext();
                           if (currentIDE && currentIDE.file_focused === absPath && currentIDE.full_content) {
                             execToolContext.forcedContent = currentIDE.full_content;
@@ -8777,7 +8931,7 @@ ${boxBottom}` };
                     if (normToolName === "write_file" && result.startsWith("SUCCESS")) {
                       const { path: filePath } = parseArgs(toolCall.args);
                       if (filePath) {
-                        const absPath = path18.resolve(process.cwd(), filePath);
+                        const absPath = path19.resolve(process.cwd(), filePath);
                         openFileInEditor(absPath);
                       }
                     }
@@ -8803,7 +8957,11 @@ ${boxBottom}` };
                         }
                       }
                       const postLabel = `\u{1F50E} Searched: "${keyword}" in ${file ? `"${file}"` : "./"} \u2192 ${matchCount} Match${matchCount === 1 ? "" : "es"}`;
-                      const boxWidth = Math.min(postLabel.length + 4, 115);
+                      let terminalWidth = 115;
+                      if (process.stdout.isTTY) {
+                        terminalWidth = process.stdout.columns || 120;
+                      }
+                      const boxWidth = Math.min(postLabel.length + 4, terminalWidth);
                       const boxTop = `\u256D${"\u2500".repeat(boxWidth)}\u256E`;
                       const boxMid = `\u2502 ${postLabel.padEnd(boxWidth - 2).substring(0, boxWidth - 2)} \u2502`;
                       const boxBottom = `\u2570${"\u2500".repeat(boxWidth)}\u256F`;
@@ -8811,6 +8969,61 @@ ${boxBottom}` };
 ${boxMid}
 ${boxBottom}` };
                     }
+                    if (normToolName === "todo") {
+                      const { method, tasks, markDone } = parseArgs(toolCall.args);
+                      let uiTitle = "";
+                      let listItems = [];
+                      const normalizeList = (input) => {
+                        if (!input) return [];
+                        let items = Array.isArray(input) ? input : [];
+                        if (items.length === 0 && typeof input === "string") {
+                          const trimmed = input.trim();
+                          if (trimmed.startsWith("[") && trimmed.endsWith("]")) {
+                            const matches = trimmed.match(/"([^"\\]*(?:\\.[^"\\]*)*)"|'([^'\\]*(?:\\.[^'\\]*)*)'/g);
+                            if (matches) {
+                              items = matches.map((m) => m.slice(1, -1).replace(/\\(.)/g, "$1"));
+                            } else {
+                              items = trimmed.slice(1, -1).split(",").map((s) => s.trim()).filter(Boolean);
+                            }
+                          } else {
+                            items = input.split("\n");
+                          }
+                        }
+                        return items.filter((l) => String(l).trim()).map((l) => {
+                          const t = String(l).trim();
+                          return t.startsWith("- [") ? t.substring(6).trim() : t;
+                        });
+                      };
+                      if (method === "create") {
+                        uiTitle = "\u{1F4C5} Created Plan";
+                        listItems = normalizeList(tasks).map((item) => `\u25CB ${item}`);
+                      } else if (method === "append") {
+                        uiTitle = "\u{1F4E5} Added Plan";
+                        listItems = normalizeList(tasks).map((item) => `\u25CB ${item}`);
+                      } else if (method === "get") {
+                        uiTitle = markDone ? "\u{1F4CC} Updated Plan" : "\u{1F4DD} Reviewed Plan";
+                        const content = (result || "").split("\n").slice(1).join("\n");
+                        listItems = content.split("\n").filter((line) => line.trim().startsWith("- [")).map((line) => {
+                          const trimmed = line.trim();
+                          const isDone = trimmed.startsWith("- [x]");
+                          return `${isDone ? "\x1B[32m\u25CF\x1B[0m" : "\u25CB"} ${trimmed.substring(6).trim()}`;
+                        });
+                      }
+                      if (uiTitle && listItems.length > 0) {
+                        const maxLen = Math.max(uiTitle.length, ...listItems.map((i) => i.length)) + 4;
+                        let terminalWidth = 100;
+                        if (process.stdout.isTTY) {
+                          terminalWidth = process.stdout.columns || 120;
+                        }
+                        const boxWidth = Math.min(maxLen, terminalWidth);
+                        const boxTop = `\u256D${"\u2500".repeat(boxWidth)}\u256E`;
+                        const boxTitle = `\u2502 ${uiTitle.padEnd(boxWidth - 2).substring(0, boxWidth - 2)} \u2502`;
+                        const boxSep = `\u251C${"\u2500".repeat(boxWidth)}\u2524`;
+                        const boxItems = listItems.map((item) => `\u2502 ${item.padEnd(boxWidth - 2).substring(0, boxWidth - 2)} \u2502`);
+                        const boxBottom = `\u2570${"\u2500".repeat(boxWidth)}\u256F`;
+                        yield { type: "visual_feedback", content: [boxTop, boxTitle, boxSep, ...boxItems, boxBottom].join("\n") };
+                      }
+                    }
                     if (normToolName === "exec_command" && settings.onExecEnd) {
                       await new Promise((resolve) => setTimeout(resolve, 800));
                       settings.onExecEnd();
@@ -8901,7 +9114,6 @@ ${boxBottom}` };
               const endsWithFormatting = superSneakyRegex.test(pureOutputText.trim());
               const endsNormally = /[.!?}"'`’“”]$|```$/s.test(pureOutputText) || endsWithFormatting || endsWithEmoji;
               if (!hasFinish2 && !hasContinue2 && !didCallTool && signalSafeText2.length > 0 && !endsNormally && !isThinkingLoop && !isStutteringLoop && !isGeneralLoop) {
-                throw new Error("Silent stream cutoff (500): Model stream closed cleanly but cut off mid-sentence without signals.");
               }
               success = true;
               await incrementUsage("agent");
@@ -8956,9 +9168,9 @@ ${boxBottom}` };
               const errMsg = err.status || err.error && err.error.message || String(err);
               const errLog = String(err);
               const date = (/* @__PURE__ */ new Date()).toLocaleString();
-              const agentErrDir = path18.join(LOGS_DIR, "agent");
-              if (!fs19.existsSync(agentErrDir)) fs19.mkdirSync(agentErrDir, { recursive: true });
-              fs19.appendFileSync(path18.join(agentErrDir, "error.log"), `ERROR [${date}]: ${errLog}
+              const agentErrDir = path19.join(LOGS_DIR, "agent");
+              if (!fs20.existsSync(agentErrDir)) fs20.mkdirSync(agentErrDir, { recursive: true });
+              fs20.appendFileSync(path19.join(agentErrDir, "error.log"), `ERROR [${date}]: ${errLog}
 
 ----------------------------------------------------------------------
 
@@ -9003,7 +9215,7 @@ ${recoveryText}`
                   yield { type: "status", content: `Error Occured. Recovering Stream...` };
                 } else {
                   throw new Error(`Stream collapsed too many times. (Failed to resolve ${MAX_RETRIES} times)
-Error Log can be found in ${path18.join(LOGS_DIR, "agent", "error.log")}`);
+Error Log can be found in ${path19.join(LOGS_DIR, "agent", "error.log")}`);
                 }
               } else {
                 if (retryCount <= MAX_RETRIES) {
@@ -9021,7 +9233,7 @@ Error Log can be found in ${path18.join(LOGS_DIR, "agent", "error.log")}`);
                   yield { type: "status", content: `Trying to reach ${modelName}...` };
                 } else {
                   throw new Error(`Model ${modelName} cannot be reached. (Failed ${MAX_RETRIES} times)
-Error Log can be found in ${path18.join(LOGS_DIR, "agent", "error.log")}`);
+Error Log can be found in ${path19.join(LOGS_DIR, "agent", "error.log")}`);
                 }
               }
             }
@@ -9106,9 +9318,9 @@ Error Log can be found in ${path18.join(LOGS_DIR, "agent", "error.log")}`);
       } catch (err) {
         const errorMsg = err instanceof Error ? err.message : String(err);
         const date = (/* @__PURE__ */ new Date()).toLocaleString();
-        const agentErrDir = path18.join(LOGS_DIR, "agent");
-        if (!fs19.existsSync(agentErrDir)) fs19.mkdirSync(agentErrDir, { recursive: true });
-        fs19.appendFileSync(path18.join(agentErrDir, "error.log"), `CRITICAL ERROR [${date}]: ${err instanceof Error ? err.stack : err}
+        const agentErrDir = path19.join(LOGS_DIR, "agent");
+        if (!fs20.existsSync(agentErrDir)) fs20.mkdirSync(agentErrDir, { recursive: true });
+        fs20.appendFileSync(path19.join(agentErrDir, "error.log"), `CRITICAL ERROR [${date}]: ${err instanceof Error ? err.stack : err}
 
 ----------------------------------------------------------------------
 
@@ -9909,7 +10121,7 @@ var init_RevertModal = __esm({
 import puppeteer4 from "puppeteer";
 import { exec } from "child_process";
 import { promisify } from "util";
-import fs20 from "fs";
+import fs21 from "fs";
 var execAsync, checkPuppeteerReady, installPuppeteerBrowser;
 var init_setup = __esm({
   "src/utils/setup.js"() {
@@ -9917,7 +10129,7 @@ var init_setup = __esm({
     checkPuppeteerReady = () => {
       try {
         const exePath = puppeteer4.executablePath();
-        const exists = exePath && fs20.existsSync(exePath);
+        const exists = exePath && fs21.existsSync(exePath);
         if (exists) return true;
       } catch (e) {
         return false;
@@ -9950,8 +10162,8 @@ __export(app_exports, {
 import os4 from "os";
 import React14, { useState as useState11, useEffect as useEffect8, useRef as useRef3, useMemo as useMemo2 } from "react";
 import { Box as Box14, Text as Text14, useInput as useInput8, useStdout } from "ink";
-import fs21 from "fs-extra";
-import path19 from "path";
+import fs22 from "fs-extra";
+import path20 from "path";
 import { exec as exec2 } from "child_process";
 import { fileURLToPath } from "url";
 import TextInput4 from "ink-text-input";
@@ -10601,7 +10813,7 @@ function App({ args = [] }) {
   useEffect8(() => {
     async function init() {
       try {
-        const pkg = JSON.parse(fs21.readFileSync(path19.join(process.cwd(), "package.json"), "utf8"));
+        const pkg = JSON.parse(fs22.readFileSync(path20.join(process.cwd(), "package.json"), "utf8"));
         initBridge(versionFluxflow || pkg.version || "2.0.0");
       } catch (e) {
         initBridge("2.0.0");
@@ -11104,6 +11316,7 @@ function App({ args = [] }) {
     { cmd: "/reset", desc: "Wipe all project data" },
     { cmd: "/about", desc: "Project info & credits" },
     { cmd: "/changelog", desc: "View latest updates" },
+    { cmd: "/docs", desc: "View Documentation" },
     {
       cmd: "/fluxflow",
       desc: "Project management",
@@ -11390,7 +11603,7 @@ ${hintText}`, color: "magenta" }];
             if (val === "xhigh") {
               formattedLevel = "xHigh";
             }
-            if (!isBypass && mode === "Flow" && (formattedLevel === "Medium" || formattedLevel === "High" || formattedLevel === "xHigh")) {
+            if (!isBypass && mode === "Flow" && (formattedLevel === "High" || formattedLevel === "xHigh")) {
               setMessages((prev) => {
                 setCompletedIndex(prev.length + 1);
                 return [...prev, { id: Date.now(), role: "system", text: `[RESTRICTED] "${formattedLevel}" is restricted in Flow mode. Switch to Flux to enable Higher Thinking Levels.`, isMeta: true }];
@@ -11467,7 +11680,7 @@ ${hintText}`, color: "magenta" }];
         }
         case "/export": {
           const exportFile = `export-fluxflow-${chatId}.txt`;
-          const exportPath = path19.join(process.cwd(), exportFile);
+          const exportPath = path20.join(process.cwd(), exportFile);
           const exportLines = [];
           let insideAgentBlock = false;
           for (let i = 0; i < messages.length; i++) {
@@ -11519,7 +11732,7 @@ ${hintText}`, color: "magenta" }];
           }
           const fileContent = exportLines.join("\n");
           try {
-            fs21.writeFileSync(exportPath, fileContent, "utf8");
+            fs22.writeFileSync(exportPath, fileContent, "utf8");
             setMessages((prev) => {
               setCompletedIndex(prev.length + 1);
               return [...prev, {
@@ -11566,12 +11779,12 @@ ${list || "No saved chats found."}`, isMeta: true }];
                 setCompletedIndex(prev.length + 1);
                 return [...prev, { id: Date.now(), role: "system", text: "[NUCLEAR] Initiating reset...", isMeta: true }];
               });
-              if (fs21.existsSync(LOGS_DIR)) fs21.removeSync(LOGS_DIR);
-              if (fs21.existsSync(SECRET_DIR)) fs21.removeSync(SECRET_DIR);
-              if (fs21.existsSync(SETTINGS_FILE)) fs21.removeSync(SETTINGS_FILE);
+              if (fs22.existsSync(LOGS_DIR)) fs22.removeSync(LOGS_DIR);
+              if (fs22.existsSync(SECRET_DIR)) fs22.removeSync(SECRET_DIR);
+              if (fs22.existsSync(SETTINGS_FILE)) fs22.removeSync(SETTINGS_FILE);
               try {
-                const items = fs21.readdirSync(FLUXFLOW_DIR);
-                if (items.length === 0) fs21.removeSync(FLUXFLOW_DIR);
+                const items = fs22.readdirSync(FLUXFLOW_DIR);
+                if (items.length === 0) fs22.removeSync(FLUXFLOW_DIR);
               } catch (e) {
               }
               setTimeout(() => {
@@ -11609,6 +11822,23 @@ ${list || "No saved chats found."}`, isMeta: true }];
           });
           break;
         }
+        case "/docs": {
+          if (!DOCS_URL) {
+            setMessages((prev) => {
+              setCompletedIndex(prev.length + 1);
+              return [...prev, { id: Date.now(), role: "system", text: `[BROWSER] Documentation URL is not configured.`, isMeta: true }];
+            });
+            break;
+          }
+          const platform = process.platform;
+          const command = platform === "win32" ? "start" : platform === "darwin" ? "open" : "xdg-open";
+          exec2(`${command} ${DOCS_URL}`);
+          setMessages((prev) => {
+            setCompletedIndex(prev.length + 1);
+            return [...prev, { id: Date.now(), role: "system", text: `[BROWSER] Opening documentation: ${DOCS_URL}`, isMeta: true }];
+          });
+          break;
+        }
         case "/fluxflow": {
           const args2 = parts.slice(1);
           if (args2[0] === "init") {
@@ -11628,15 +11858,15 @@ ${list || "No saved chats found."}`, isMeta: true }];
 # SKILLS & WORKFLOWS
 - [Define custom step-by-step recipes for this project here]
 `;
-            const filePath = path19.join(process.cwd(), "FluxFlow.md");
-            if (fs21.pathExistsSync(filePath)) {
+            const filePath = path20.join(process.cwd(), "FluxFlow.md");
+            if (fs22.pathExistsSync(filePath)) {
               setMessages((prev) => {
                 setCompletedIndex(prev.length + 1);
                 return [...prev, { id: "init-err-" + Date.now(), role: "system", text: "ERROR: FluxFlow.md already exists in this directory.", isMeta: true }];
               });
             } else {
               try {
-                fs21.writeFileSync(filePath, template);
+                fs22.writeFileSync(filePath, template);
                 setMessages((prev) => {
                   setCompletedIndex(prev.length + 1);
                   return [...prev, { id: "init-ok-" + Date.now(), role: "system", text: "[SUCCESS] FluxFlow.md has been initialized. You can now customize it for this project.", isMeta: true }];
@@ -13026,7 +13256,7 @@ Selection: ${val}`,
     return /* @__PURE__ */ React14.createElement(Box14, { flexDirection: "column", borderStyle: "round", paddingX: 3, paddingY: 1, borderColor: "grey", width: Math.min(100, (stdout?.columns || 100) - 2), marginTop: 0, marginBottom: 0 }, /* @__PURE__ */ React14.createElement(Box14, { marginBottom: 1 }, /* @__PURE__ */ React14.createElement(Text14, { bold: true }, gradient2(["blue", "purple"])("Agent powering down. Goodbye!"))), /* @__PURE__ */ React14.createElement(Box14, { flexDirection: "column" }, /* @__PURE__ */ React14.createElement(Text14, { color: "white", bold: true, underline: true }, "Interaction Summary"), /* @__PURE__ */ React14.createElement(Box14, { marginTop: 1 }, /* @__PURE__ */ React14.createElement(Box14, { width: 20 }, /* @__PURE__ */ React14.createElement(Text14, { color: "blue" }, "Session ID:")), /* @__PURE__ */ React14.createElement(Text14, { color: "white" }, chatId)), /* @__PURE__ */ React14.createElement(Box14, null, /* @__PURE__ */ React14.createElement(Box14, { width: 20 }, /* @__PURE__ */ React14.createElement(Text14, { color: "blue" }, "Tool Calls:")), /* @__PURE__ */ React14.createElement(Text14, { color: "white" }, sessionToolSuccess + sessionToolFailure + sessionToolDenied, " ( ", /* @__PURE__ */ React14.createElement(Text14, { color: "green" }, "\u2713 ", sessionToolSuccess), " ", /* @__PURE__ */ React14.createElement(Text14, { color: "yellow" }, "\u2298 ", sessionToolDenied), " ", /* @__PURE__ */ React14.createElement(Text14, { color: "red" }, "\u2715 ", sessionToolFailure), " )")), /* @__PURE__ */ React14.createElement(Box14, null, /* @__PURE__ */ React14.createElement(Box14, { width: 20 }, /* @__PURE__ */ React14.createElement(Text14, { color: "blue" }, "Success Rate:")), /* @__PURE__ */ React14.createElement(Text14, { color: "white" }, successRate, "%")), /* @__PURE__ */ React14.createElement(Box14, null, /* @__PURE__ */ React14.createElement(Box14, { width: 20 }, /* @__PURE__ */ React14.createElement(Text14, { color: "blue" }, "Code Changes:")), /* @__PURE__ */ React14.createElement(Text14, { color: "white" }, /* @__PURE__ */ React14.createElement(Text14, { color: "green" }, "+", linesAdded), " ", /* @__PURE__ */ React14.createElement(Text14, { color: "red" }, "-", linesRemoved))), /* @__PURE__ */ React14.createElement(Box14, null, /* @__PURE__ */ React14.createElement(Box14, { width: 20 }, /* @__PURE__ */ React14.createElement(Text14, { color: "blue" }, "Tokens Consumed:")), /* @__PURE__ */ React14.createElement(Text14, { color: "white" }, formatTokens(sessionTotalTokens))), sessionTotalTokens > 0 && /* @__PURE__ */ React14.createElement(React14.Fragment, null, /* @__PURE__ */ React14.createElement(Box14, { marginLeft: 2 }, /* @__PURE__ */ React14.createElement(Box14, { width: 18 }, /* @__PURE__ */ React14.createElement(Text14, { color: "grey" }, "\xBB Input Tokens:")), /* @__PURE__ */ React14.createElement(Text14, { color: "white" }, formatTokens(sessionTotalTokens - sessionTotalCandidateTokens))), sessionTotalCachedTokens > 0 && /* @__PURE__ */ React14.createElement(Box14, { marginLeft: 4 }, /* @__PURE__ */ React14.createElement(Box14, { width: 16 }, /* @__PURE__ */ React14.createElement(Text14, { color: "grey" }, "\xBB Cached:")), /* @__PURE__ */ React14.createElement(Text14, { color: "white" }, formatTokens(sessionTotalCachedTokens))), sessionTotalCandidateTokens > 0 && /* @__PURE__ */ React14.createElement(Box14, { marginLeft: 2 }, /* @__PURE__ */ React14.createElement(Box14, { width: 18 }, /* @__PURE__ */ React14.createElement(Text14, { color: "grey" }, "\xBB Output Tokens:")), /* @__PURE__ */ React14.createElement(Text14, { color: "white" }, formatTokens(sessionTotalCandidateTokens)))), sessionImageCount > 0 && /* @__PURE__ */ React14.createElement(React14.Fragment, null, /* @__PURE__ */ React14.createElement(Box14, null, /* @__PURE__ */ React14.createElement(Box14, { width: 20 }, /* @__PURE__ */ React14.createElement(Text14, { color: "blue" }, "Images Made:")), /* @__PURE__ */ React14.createElement(Text14, { color: "white" }, sessionImageCount)), /* @__PURE__ */ React14.createElement(Box14, null, /* @__PURE__ */ React14.createElement(Box14, { width: 20 }, /* @__PURE__ */ React14.createElement(Text14, { color: "blue" }, "Image Credits:")), /* @__PURE__ */ React14.createElement(Text14, { color: "white" }, Number(((sessionImageCredits || 0) * 1e3).toFixed(0)), " credits")))), /* @__PURE__ */ React14.createElement(Box14, { flexDirection: "column", marginTop: 1 }, /* @__PURE__ */ React14.createElement(Text14, { color: "white", bold: true, underline: true }, "Performance"), /* @__PURE__ */ React14.createElement(Box14, { marginTop: 1 }, /* @__PURE__ */ React14.createElement(Box14, { width: 20 }, /* @__PURE__ */ React14.createElement(Text14, { color: "blue" }, "Wall Time:")), /* @__PURE__ */ React14.createElement(Text14, { color: "white" }, formatMsDuration(wallTimeMs))), /* @__PURE__ */ React14.createElement(Box14, null, /* @__PURE__ */ React14.createElement(Box14, { width: 20 }, /* @__PURE__ */ React14.createElement(Text14, { color: "blue" }, "Agent Active:")), /* @__PURE__ */ React14.createElement(Text14, { color: "white" }, formatMsDuration(agentActiveMs))), /* @__PURE__ */ React14.createElement(Box14, { marginLeft: 2 }, /* @__PURE__ */ React14.createElement(Box14, { width: 18 }, /* @__PURE__ */ React14.createElement(Text14, { color: "grey" }, "\xBB API Time:")), /* @__PURE__ */ React14.createElement(Text14, { color: "white" }, formatMsDuration(sessionApiTime), " (", apiPercent, "%)")), /* @__PURE__ */ React14.createElement(Box14, { marginLeft: 2 }, /* @__PURE__ */ React14.createElement(Box14, { width: 18 }, /* @__PURE__ */ React14.createElement(Text14, { color: "grey" }, "\xBB Tool Time:")), /* @__PURE__ */ React14.createElement(Text14, { color: "white" }, formatMsDuration(sessionToolTime), " (", toolPercent, "%)"))));
   })())));
 }
-var getIDEName, getPromoOptions, BridgePromo, SESSION_START_TIME, CHANGELOG_URL, linesAdded, linesRemoved, packageJsonPath, packageJson, versionFluxflow, updatedOn, ResolutionModal, parseAgentText, getProjectFiles;
+var getIDEName, getPromoOptions, BridgePromo, SESSION_START_TIME, CHANGELOG_URL, DOCS_URL, linesAdded, linesRemoved, packageJsonPath, packageJson, versionFluxflow, updatedOn, ResolutionModal, parseAgentText, getProjectFiles;
 var init_app = __esm({
   async "src/app.jsx"() {
     init_MultilineInput();
@@ -13103,15 +13333,16 @@ var init_app = __esm({
           height
         },
         /* @__PURE__ */ React14.createElement(Box14, { marginBottom: 1, width: Math.min(80, width - 4), justifyContent: "flex-start" }, /* @__PURE__ */ React14.createElement(Text14, null, getFluxLogo(versionFluxflow))),
-        /* @__PURE__ */ React14.createElement(Box14, { flexDirection: "column", borderStyle: "double", borderColor: "cyan", paddingX: 3, paddingY: 1, width: Math.min(80, width - 4) }, /* @__PURE__ */ React14.createElement(Text14, { bold: true, color: "cyan", textAlign: "center" }, "\u{1F680} UPGRADE YOUR WORKFLOW"), /* @__PURE__ */ React14.createElement(Box14, { marginY: 1, flexDirection: "column", alignItems: "left" }, /* @__PURE__ */ React14.createElement(Text14, null, "You're in ", /* @__PURE__ */ React14.createElement(Text14, { bold: true, color: "cyan" }, ideName), ", but the ", /* @__PURE__ */ React14.createElement(Text14, { bold: true, color: "magenta" }, "FluxFlow-CLI Companion"), " is not installed."), /* @__PURE__ */ React14.createElement(Box14, { flexDirection: "column", marginY: 1 }, /* @__PURE__ */ React14.createElement(Text14, { color: "gray" }, "  \u2705 Real-time file & cursor tracking"), /* @__PURE__ */ React14.createElement(Text14, { color: "gray" }, "  \u2705 Auto-open files created by agent"), /* @__PURE__ */ React14.createElement(Text14, { color: "gray" }, "  \u2705 Native DIFF viewer for AI edits"), /* @__PURE__ */ React14.createElement(Text14, { color: "gray" }, "  \u2705 Direct IDE context sharing"), /* @__PURE__ */ React14.createElement(Text14, { color: "gray" }, "  \u2705 Surgical Diagnostic Sync"), /* @__PURE__ */ React14.createElement(Text14, { color: "gray" }, "  \u2705 Native Right-Click \u276F Chat integration"), /* @__PURE__ */ React14.createElement(Text14, { color: "gray" }, "  \u2705 Live Status in IDE"), /* @__PURE__ */ React14.createElement(Text14, { color: "gray" }, "  \u2705 Clickable terminal-to-code links"))), /* @__PURE__ */ React14.createElement(Box14, { flexDirection: "column", marginTop: 1 }, options.map((opt, i) => /* @__PURE__ */ React14.createElement(Box14, { key: i }, /* @__PURE__ */ React14.createElement(Text14, { color: selectedIndex === i ? "yellow" : "white", bold: selectedIndex === i }, selectedIndex === i ? " \u276F " : "   ", opt.label)))), /* @__PURE__ */ React14.createElement(Box14, { marginTop: 1, alignItems: "center", justifyContent: "center" }, /* @__PURE__ */ React14.createElement(Text14, { dimColor: true, italic: true }, "(Use arrows to navigate, Enter to select)")))
+        /* @__PURE__ */ React14.createElement(Box14, { flexDirection: "column", borderStyle: "double", borderColor: "grey", paddingX: 3, paddingY: 1, width: Math.min(80, width - 4) }, /* @__PURE__ */ React14.createElement(Text14, { bold: true, color: "white", textAlign: "center" }, "\u{1F680} UPGRADE YOUR WORKFLOW"), /* @__PURE__ */ React14.createElement(Box14, { marginY: 1, flexDirection: "column", alignItems: "left" }, /* @__PURE__ */ React14.createElement(Text14, null, "You're in ", /* @__PURE__ */ React14.createElement(Text14, { bold: true, color: "cyan" }, ideName), ", but the ", /* @__PURE__ */ React14.createElement(Text14, { bold: true, color: "white" }, "FluxFlow-CLI Companion"), " is not installed."), /* @__PURE__ */ React14.createElement(Box14, { flexDirection: "column", marginY: 1 }, /* @__PURE__ */ React14.createElement(Text14, { color: "gray" }, "  \u2705 Real-time file & cursor tracking"), /* @__PURE__ */ React14.createElement(Text14, { color: "gray" }, "  \u2705 Auto-open files created by agent"), /* @__PURE__ */ React14.createElement(Text14, { color: "gray" }, "  \u2705 Native DIFF viewer for AI edits"), /* @__PURE__ */ React14.createElement(Text14, { color: "gray" }, "  \u2705 Direct IDE context sharing"), /* @__PURE__ */ React14.createElement(Text14, { color: "gray" }, "  \u2705 Surgical Diagnostic Sync"), /* @__PURE__ */ React14.createElement(Text14, { color: "gray" }, "  \u2705 Native Right-Click \u276F Chat integration"), /* @__PURE__ */ React14.createElement(Text14, { color: "gray" }, "  \u2705 Live Status in IDE"), /* @__PURE__ */ React14.createElement(Text14, { color: "gray" }, "  \u2705 Clickable terminal-to-code links"))), /* @__PURE__ */ React14.createElement(Box14, { flexDirection: "column", marginTop: 1 }, options.map((opt, i) => /* @__PURE__ */ React14.createElement(Box14, { key: i }, /* @__PURE__ */ React14.createElement(Text14, { color: selectedIndex === i ? "yellow" : "white", bold: selectedIndex === i }, selectedIndex === i ? " \u276F " : "   ", opt.label)))), /* @__PURE__ */ React14.createElement(Box14, { marginTop: 1, alignItems: "center", justifyContent: "center" }, /* @__PURE__ */ React14.createElement(Text14, { dimColor: true, italic: true }, "(Use arrows to navigate, Enter to select)")))
       );
     };
     SESSION_START_TIME = Date.now();
-    CHANGELOG_URL = "https://fluxflow-cli.onrender.com/changelog.html";
+    CHANGELOG_URL = "https://fluxflow-cli.onrender.com/changelog";
+    DOCS_URL = "https://fluxflow-cli.onrender.com/";
     linesAdded = 0;
     linesRemoved = 0;
-    packageJsonPath = path19.join(path19.dirname(fileURLToPath(import.meta.url)), "../package.json");
-    packageJson = JSON.parse(fs21.readFileSync(packageJsonPath, "utf8"));
+    packageJsonPath = path20.join(path20.dirname(fileURLToPath(import.meta.url)), "../package.json");
+    packageJson = JSON.parse(fs22.readFileSync(packageJsonPath, "utf8"));
     versionFluxflow = packageJson.version;
     updatedOn = packageJson.date || "2026-05-20";
     ResolutionModal = ({ data, onResolve, onEdit }) => /* @__PURE__ */ React14.createElement(Box14, { flexDirection: "column", borderStyle: "round", borderColor: "gray", padding: 0, width: "100%" }, /* @__PURE__ */ React14.createElement(Box14, { paddingX: 1 }, /* @__PURE__ */ React14.createElement(Text14, { color: "magenta", bold: true, underline: true }, "\u{1F7E3} STEERING HINT RESOLUTION")), /* @__PURE__ */ React14.createElement(Box14, { paddingX: 1, marginTop: 1 }, /* @__PURE__ */ React14.createElement(Text14, null, "The agent already finished the task before your hint was consumed.")), /* @__PURE__ */ React14.createElement(Box14, { marginTop: 1, backgroundColor: "#222", paddingX: 2, width: "100%" }, /* @__PURE__ */ React14.createElement(Text14, { italic: true, color: "gray" }, '"', data, '"')), /* @__PURE__ */ React14.createElement(Box14, { paddingX: 1, marginTop: 1 }, /* @__PURE__ */ React14.createElement(Text14, { color: "cyan" }, "How would you like to proceed?")), /* @__PURE__ */ React14.createElement(Box14, { marginTop: 0 }, /* @__PURE__ */ React14.createElement(
@@ -13207,19 +13438,19 @@ var init_app = __esm({
         const fileList = [];
         const scan = (currentDir) => {
           try {
-            const files = fs21.readdirSync(currentDir);
+            const files = fs22.readdirSync(currentDir);
             for (const file of files) {
               if (["node_modules", ".git", ".gemini", "dist", "build", ".next", ".cache", "out"].includes(file)) {
                 continue;
               }
-              const filePath = path19.join(currentDir, file);
-              const stat = fs21.statSync(filePath);
+              const filePath = path20.join(currentDir, file);
+              const stat = fs22.statSync(filePath);
               if (stat.isDirectory()) {
                 scan(filePath);
               } else {
                 fileList.push({
                   name: file,
-                  relativePath: path19.relative(process.cwd(), filePath)
+                  relativePath: path20.relative(process.cwd(), filePath)
                 });
               }
             }
@@ -13254,11 +13485,11 @@ if (isBundled && !process.execArgv.some((arg) => arg.includes("max-old-space-siz
   const isVersion = args.includes("--version") || args.includes("-v");
   const isUpdate = args[0] === "--update";
   if (isVersion || isHelp || isHelpCommands || isUpdate) {
-    const fs22 = await import("fs");
-    const path20 = await import("path");
+    const fs23 = await import("fs");
+    const path21 = await import("path");
     const { fileURLToPath: fileURLToPath3 } = await import("url");
-    const packageJsonPath2 = path20.join(path20.dirname(fileURLToPath3(import.meta.url)), "../package.json");
-    const packageJson2 = JSON.parse(fs22.readFileSync(packageJsonPath2, "utf8"));
+    const packageJsonPath2 = path21.join(path21.dirname(fileURLToPath3(import.meta.url)), "../package.json");
+    const packageJson2 = JSON.parse(fs23.readFileSync(packageJsonPath2, "utf8"));
     const versionFluxflow2 = packageJson2.version;
     if (isVersion) {
       console.log(`v${versionFluxflow2}`);
@@ -13311,6 +13542,7 @@ if (isBundled && !process.execArgv.some((arg) => arg.includes("max-old-space-siz
   /reset                                   Wipe all project data
   /about                                   Project info & credits
   /changelog                               View latest updates
+  /docs                                    View documentation
   /fluxflow init                           Create FluxFlow.md template
   /update check                            Check for new version
   /update latest                           Install latest release`);
@@ -13371,7 +13603,7 @@ if (isBundled && !process.execArgv.some((arg) => arg.includes("max-old-space-siz
                 { label: "Custom Command", value: "custom" }
               ];
               const CustomItem2 = ({ label, isSelected }) => {
-                return /* @__PURE__ */ React16.createElement(Box15, { width: "100%" }, /* @__PURE__ */ React16.createElement(Text15, { color: isSelected ? "cyan" : "gray", bold: isSelected }, "\u2514\u2500 ", isSelected ? "\u25C9" : "\u25CB", " ", label));
+                return /* @__PURE__ */ React16.createElement(Box15, { width: "100%" }, /* @__PURE__ */ React16.createElement(Text15, { bold: isSelected }, "\u2514\u2500 ", isSelected ? "\x1B[32m\u25CF\x1B[0m" : "\u25CB", " ", label));
               };
               let unmountFn;
               const PromptComponent = () => {
@@ -13424,7 +13656,7 @@ if (isBundled && !process.execArgv.some((arg) => arg.includes("max-old-space-siz
             manager = settings?.systemSettings?.updateManager || settings?.updateManager;
           } catch (e) {
           }
-          if (!manager) {
+          if (true) {
             const result = await promptPackageManager();
             manager = result.manager;
             customCommand = result.customCommand;

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "fluxflow-cli",
-	"version": "2.7.0",
-	"date": "2026-06-15",
+	"version": "2.7.1",
+	"date": "2026-06-16",
 	"description": "A high-fidelity agentic terminal assistant for the Flux Era.",
 	"keywords": [
 		"ai",