fluxflow-cli 1.8.3 → 1.8.4

package/README.md

@@ -1,38 +1,14 @@
-# 🌊 Flux Flow
-![Flux Flow Hero](./fluxflow.png)
+# 🌌 Flux Flow (`fluxflow-cli`)
+![Flux Flow Logo](https://github.com/KushalRoyChowdhury/fluxflow-cli/blob/main/fluxflow.png)
 
-**A Beautiful, Autonomous Terminal AI Agent**
+### *The High-Fidelity Agentic Terminal for the Flux Era.*
 
-Flux Flow is an advanced, fully autonomous AI agent that lives directly in your terminal. Built with Node.js and [Ink](https://github.com/vadimdemedes/ink) (React for interactive command-line apps), it provides a highly responsive, component-based UI powered by a sophisticated dual-model AI architecture.
-
-Whether you need a conversational partner or an autonomous developer that can write code, run shell commands, and read your project files, Flux Flow adapts to your needs.
+**Flux Flow** is not just another CLI—it's a high-speed, sassy, and goal-oriented CLI AI Agent powered by the latest Gemini/Gemma frontier models. Designed for developers who demand a premium UI/UX while managing complex file-system tasks, web research, and autonomous workflows.
 
 ---
 
-## ✨ Features
-
-- **Native Multimodality**: Flux Flow can now see! Analyze images (JPG, PNG) and PDF documents natively through the `view_file` tool with high-fidelity context retention.
-- **Document Engineering Suite**: Generate professional, branded PDF, DOCX, and PPTX documents on the fly. Features native HTML-to-Office translation for selectable text, high-performance rendering, and automatic watermarking.
-- **External Data Sanctuary**: Redirect your logs, history, and memories to any external path for maximum portability and privacy.
-- **Responsive Terminal UI**: A gorgeous, reactive interface built with React and Ink, featuring multi-line input, status bars, modals, and diff views.
-- **Dual-Model Architecture**: A primary agent interacts with you and executes tasks, while a silent background "Janitor" model handles chat summarization and long-term memory extraction without blocking the main UI.
-- **Two Operating Modes**:
-  - **Flux (Dev Mode)**: Full system access. The agent can read/write files, execute shell commands, and run autonomous agentic loops (up to 45 iterations) to solve complex coding tasks.
-  - **Flow (Chat Mode)**: Focused on conversation and web research, with limited agentic loops for faster response times.
-- **Advanced Memory System**: Features both temporary session context and persistent, cross-session user memories encrypted locally on your machine.
-- **Agentic Tooling**: Built-in tools for smart file patching, web scraping, web searching, terminal execution and high-fidelity Office document generation (PDF/DOCX/PPTX).
-- **Autonomous Project Alignment**: Automatically detects and adheres to project-specific instructions in `Agent.md`, `Skills.md`, and `Fluxflow.md` for high-fidelity coding standards and complex workflows.
-- **Customizable "Thinking" Levels**: Adjust the depth of the model's reasoning process (from Minimal to Max).
-- **High-Reliability Fallback**: Automatic failover to a lighter, high-concurrency model (Gemini 3.1 Flash Lite) during peak traffic to ensure 100% session persistence.
-
-## 🚀 Quick Start
-
-### Prerequisites
-- [Node.js](https://nodejs.org/) (v18 or higher recommended)
-- `npm`, `yarn`, or `pnpm`
-
-### Via NPM (Global & Instant)
-You can run the agent instantly or install it globally for high-speed access:
+## 🚀 Instant Ignition (No Setup Required)
+You don't even need to install it. Just fire up your terminal and run:
 
 ```bash
 # Run instantly (Zero Setup)
@@ -40,45 +16,69 @@ npx fluxflow-cli
 
 # OR Install Globally
 npm install -g fluxflow-cli
-fluxflow
+fluxflow-cli
 ```
 
-### From Source (Local Development)
-1. Clone the repository and install dependencies:
-   ```bash
-   git clone <repository-url>
-   cd Flux-Flow
-   npm install
-   ```
+*The agent will prompt you for your Gemini API Key on the first run and store it securely in an XOR-encrypted vault.* Free API Key recomemded to use Gemma 4 (Default Model).
+
+---
+
+## ✨ Why Flux Flow?
+
+### 🎨 **Premium Visual Sovereignty**
+Experience a terminal UI that feels alive. Built with **Ink** and **React**, Flux Flow features:
+- **Dynamic Status Bar**: Real-time telemetry showing your "Neural Headroom" (token usage), Thinking Level, and Session ID.
 
-2. Start the agent:
-   ```bash
-   npm start
-   ```
+### 👁️ **Native Multimodality**
+Flux Flow can now see! Use the `view_file` tool to analyze images (JPG, PNG) or deep-dive into PDF technical papers. The agent extracts high-fidelity visual context natively, making it a true multimodal companion.
 
-## 📖 Documentation
+### 📑 **Document Engineering Suite**
+Need a report or a presentation? Just ask. Flux Flow features a high-fidelity "Printing Press" that generates professional, branded documents natively:
+- **PDF**: Branded documents from HTML/CSS with automatic watermarking.
+- **DOCX**: Native Word documents with multi-page support and automatic numbering.
+- **PPTX**: High-fidelity PowerPoint presentations using native elements (selectable text, shapes) translated directly from HTML.
 
-To keep this README concise, detailed information about specific components of Flux Flow has been split into separate documents:
+### 🚑 **Self-Healing Infrastructure**
+Zero setup means zero setup. On first run, Flux Flow performs an integrity check and autonomously installs its own Chromium engine if needed, ensuring features like PDF generation work 100% of the time without manual intervention.
 
-- **[Architecture & Design](./ARCHITECTURE.md)**: Deep dive into the React/Ink rendering, the Agentic Loop, and the Janitor background process.
-- **[Agent Tools & Capabilities](./TOOLS.md)**: A comprehensive list of the tools available to the agent (e.g., File I/O, Execution, Web tools).
-- **[UI & Interaction Features](./UI_FEATURES.md)**: Details on commands, thinking levels, and human-in-the-loop verification.
+- **Archived Terminal Flow**: See execution outputs transform from live elements into permanent conversation records.
+- **Rich Aesthetics**: High-contrast, sleek design with smooth transitions and micro-animations.
 
-## 🔒 Security & Privacy
+### 🧠 **The Dual-Intelligence System**
+- **Flux Mode (Dev)**: High-speed, agentic problem solving with a 50-turn persistent loop for massive coding tasks.
+- **Flow Mode (Chat)**: Optimized for deep research, high-quality conversation, and web-assisted reasoning.
 
-Flux Flow runs entirely locally on your machine.
-- **Global Storage**: All history, memories, and API keys are stored securely in your home directory at `~/.fluxflow`. Sensitive data is encrypted.
-- **Nuclear Reset**: Use the `/reset` command to instantly purge all logs, secrets, and settings from the global storage directory.
-- **Configurable Boundaries**: In Flux mode, file access can be strictly confined to the Current Working Directory, or expanded globally via settings.
-- **API Keys**: You supply your own Gemini/Google AI Studio API keys.
+### 🛡️ **Digital Fortress Governance**
+Security isn't an afterthought; it's a boundary.
+- **External Path Hardlock**: Restricts the agent to your Current Working Directory (CWD) unless you explicitly unlock it.
+- **Human-in-the-Loop (HITL)**: Every file write and terminal command requires your high-fidelity approval.
+- **XOR Vaulting**: All local session histories, memories, and API keys are obfuscated and encrypted at rest.
+- **Adaptive Failover**: Automatic multi-stage retry logic with high-concurrency fallback model switching (Gemini 3.1 Flash Lite) during peak API congestion.
 
-## 🛠️ Built With
+### 🧹 **The Background Janitor**
+While you move at high speed, the Janitor follows behind—refining session titles, compressing data, and ensuring your context window remains at absolute peak performance.
+
+---
+
+## 🛠️ Key Capabilities
+- **Deep File-System Interaction**: Edit, move, and refactor code across multiple files with atomic precision.
+- **Real-Time Web Intelligence**: Autonomous web-searching via DuckDuckGo for live news and technical research.
+- **Autonomous Project Alignment**: Automatically detects and adheres to project-specific instructions in `Agent.md`, `Skills.md`, and `Fluxflow.md` for high-fidelity alignment with your coding standards and custom workflows.
+- **High-Reliability Fallback**: Automatic failover to a lighter, high-concurrency model during peak traffic to ensure zero session loss.
+- **Persistent Memory**: The agent learns from your preferences and project requirements across sessions.
+
+---
+
+## ⚙️ Configuration
+Type `/settings` in-app to live-configure:
+- **Thinking Level**: Low, Medium, or High (Deep-Reasoning).
+- **Auto-Execution**: For ultimate high-speed flow (Advanced users only).
+- **Security Perimeter**: Toggle External Workspace access.
+
+---
 
-- **[React](https://react.dev/) & [Ink](https://github.com/vadimdemedes/ink)**: For the interactive CLI rendering.
-- **[@google/genai](https://www.npmjs.com/package/@google/genai)**: The core AI SDK powering the agent's intelligence.
-- **[chalk](https://www.npmjs.com/package/chalk) & [gradient-string](https://www.npmjs.com/package/gradient-string)**: For terminal styling and aesthetics.
-- **[fs-extra](https://www.npmjs.com/package/fs-extra)**: For robust file system operations.
-- **[pptxgenjs](https://www.npmjs.com/package/pptxgenjs) & [html-to-docx](https://www.npmjs.com/package/html-to-docx)**: For native Office document generation.
+## 🏁 License
+MIT © 2026 Flux Flow Team.
 
 ---
-*Created as a demonstration of highly capable AI tooling.*
+*Forged with ⚡ and 🧬. Welcome to the FluxFlow.*

package/dist/fluxflow.js

@@ -116,21 +116,9 @@ var init_ChatLayout = __esm({
     };
     formatThinkText = (cleaned, columns = 80) => {
       if (!cleaned) return null;
-      const lines = cleaned.split("\n");
       const availableWidth = columns - 10;
-      return lines.map((line, i) => {
-        const trimmed = line.trim();
-        if (!trimmed) return /* @__PURE__ */ React2.createElement(Box2, { key: i, height: 1 });
-        if (trimmed.startsWith("**") && trimmed.endsWith("**") || trimmed.startsWith("#")) {
-          const hText = trimmed.replace(/\*|#/g, "").trim();
-          return /* @__PURE__ */ React2.createElement(Box2, { key: i, marginTop: i === 0 ? 0 : 1, marginBottom: 0, width: "100%" }, /* @__PURE__ */ React2.createElement(Text2, { bold: true, color: "white" }, "\u25B8 ", wrapText(hText, availableWidth - 2)));
-        }
-        const isBullet = trimmed.startsWith("*");
-        const bulletPrefix = isBullet ? "\u2022 " : "";
-        const cleanText = trimmed.replace(/^\*|\s\*/g, "").trim();
-        const wrapped = wrapText(cleanText, availableWidth - (isBullet ? 2 : 0));
-        return /* @__PURE__ */ React2.createElement(Box2, { key: i, marginLeft: isBullet ? 2 : 0, width: "100%" }, /* @__PURE__ */ React2.createElement(Text2, { italic: true, color: "gray" }, bulletPrefix, wrapped.split("\n").join("\n" + " ".repeat(bulletPrefix.length))));
-      });
+      const wrapped = wrapText(cleaned.trim(), availableWidth);
+      return /* @__PURE__ */ React2.createElement(Box2, { width: "100%" }, /* @__PURE__ */ React2.createElement(Text2, { italic: true, color: "gray" }, wrapped));
     };
     parseMathSymbols = (content) => {
       return content.replace(/\\multiply|\\mul|\\times/g, "\xD7").replace(/\\div/g, "\xF7").replace(/\\cdot/g, "\u22C5").replace(/\\infty/g, "\u221E").replace(/\\pm/g, "\xB1").replace(/\\leq/g, "\u2264").replace(/\\geq/g, "\u2265").replace(/\\neq/g, "\u2260").replace(/\\sqrt\{?(.*?)\}?/g, (_, p1) => `\u221A(${p1})`).replace(/\\alpha/g, "\u03B1").replace(/\\beta/g, "\u03B2").replace(/\\theta/g, "\u03B8").replace(/\\pi/g, "\u03C0").replace(/\\approx/g, "\u2248").replace(/\\Delta/g, "\u0394").replace(/\\sigma/g, "\u03C3").replace(/\\sum/g, "\u03A3").replace(/\\prod/g, "\u03A0").replace(/\\rightarrow|\\to/g, "\u2192").replace(/\\leftarrow/g, "\u2190").replace(/\\leftrightarrow/g, "\u2194").replace(/\\left\(|\\right\)/g, (match) => match.includes("left") ? "(" : ")").replace(/\\left\[|\\right\]/g, (match) => match.includes("left") ? "[" : "]").replace(/\\\{|\\\}/g, (match) => match.includes("{") ? "{" : "}").replace(/\\text\{?(.*?)\}?/g, "$1");
@@ -395,14 +383,7 @@ var init_ChatLayout = __esm({
       }, [msg.id]);
       const finalContent = React2.useMemo(() => {
         if (msg.role === "think" && !showFullThinking) {
-          const lines = content.split("\n").filter((line) => {
-            const trimmed = line.trim();
-            const isHeading = trimmed.startsWith("# ");
-            const isActionStep = trimmed.startsWith("**") && trimmed.endsWith("**");
-            return isHeading || isActionStep;
-          });
-          if (lines.length === 0) return "*Reasoning...*";
-          return lines.join("\n");
+          return "Thinking...";
         }
         return content;
       }, [content, msg.role, showFullThinking]);
@@ -1809,15 +1790,20 @@ var init_update_file = __esm({
         let instances = 0;
         let startPos = -1;
         let matchRegex = null;
-        const escaped = content_to_replace.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+        const exactPattern = content_to_replace.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
         if (content_to_replace !== "" && currentContent.includes(content_to_replace)) {
-          matchRegex = new RegExp(escaped, "g");
+          matchRegex = new RegExp(exactPattern, "g");
         } else {
-          const fuzzyPattern = escaped.trim().replace(/\s+/g, "\\s*");
-          try {
-            matchRegex = new RegExp(fuzzyPattern, "g");
-          } catch (e) {
-            matchRegex = new RegExp(escaped, "g");
+          const fuzzyLines = content_to_replace.split("\n").map((line) => line.trim()).filter((line) => line.length > 0).map((line) => line.replace(/[.*+?^${}()|[\]\\]/g, "\\$&").replace(/\s+/g, "\\s*"));
+          if (fuzzyLines.length > 0) {
+            const fuzzyPattern = fuzzyLines.join("\\s*");
+            try {
+              matchRegex = new RegExp(fuzzyPattern, "g");
+            } catch (e) {
+              matchRegex = new RegExp(exactPattern, "g");
+            }
+          } else {
+            matchRegex = new RegExp(exactPattern, "g");
           }
         }
         const matches = matchRegex ? [...currentContent.matchAll(matchRegex)] : [];
@@ -4809,8 +4795,8 @@ var init_app = __esm({
     init_text();
     SESSION_START_TIME = Date.now();
     CHANGELOG_URL = "https://fluxflow-cli.onrender.com/changelog.html";
-    versionFluxflow = "1.8.3";
-    updatedOn = "2026-05-07";
+    versionFluxflow = "1.8.4";
+    updatedOn = "2026-05-08";
     ResolutionModal = ({ data, onResolve, onEdit }) => /* @__PURE__ */ React10.createElement(Box10, { flexDirection: "column", borderStyle: "round", borderColor: "magenta", paddingX: 2, paddingY: 1, width: "100%" }, /* @__PURE__ */ React10.createElement(Text10, { color: "magenta", bold: true, underline: true }, "\u{1F7E3} STEERING HINT RESOLUTION"), /* @__PURE__ */ React10.createElement(Text10, { marginTop: 1 }, "The agent already finished the task before your hint was consumed."), /* @__PURE__ */ React10.createElement(Box10, { marginTop: 1, backgroundColor: "#222", paddingX: 1, width: "100%" }, /* @__PURE__ */ React10.createElement(Text10, { italic: true, color: "gray" }, '"', data, '"')), /* @__PURE__ */ React10.createElement(Box10, { marginTop: 1 }, /* @__PURE__ */ React10.createElement(Text10, { color: "cyan" }, "How would you like to proceed?")), /* @__PURE__ */ React10.createElement(Box10, { marginTop: 1 }, /* @__PURE__ */ React10.createElement(
       CommandMenu,
       {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "fluxflow-cli",
-	"version": "1.8.3",
+	"version": "1.8.4",
 	"description": "A high-fidelity agentic terminal assistant for the Flux Era.",
 	"keywords": [
 		"ai",
@@ -21,7 +21,7 @@
 	},
 	"files": [
 		"dist",
-		"README-npm.md",
+		"README.md",
 		"package.json",
 		"ARCHITECTURE.md",
 		"TOOLS.md",

package/README-npm.md

@@ -1,84 +0,0 @@
-# 🌌 Flux Flow (`fluxflow-cli`)
-![Flux Flow Logo](https://github.com/KushalRoyChowdhury/fluxflow-cli/blob/main/fluxflow.png)
-
-### *The High-Fidelity Agentic Terminal for the Flux Era.*
-
-**Flux Flow** is not just another CLI—it's a high-speed, sassy, and goal-oriented CLI AI Agent powered by the latest Gemini/Gemma frontier models. Designed for developers who demand a premium UI/UX while managing complex file-system tasks, web research, and autonomous workflows.
-
----
-
-## 🚀 Instant Ignition (No Setup Required)
-You don't even need to install it. Just fire up your terminal and run:
-
-```bash
-# Run instantly (Zero Setup)
-npx fluxflow-cli
-
-# OR Install Globally
-npm install -g fluxflow-cli
-fluxflow-cli
-```
-
-*The agent will prompt you for your Gemini API Key on the first run and store it securely in an XOR-encrypted vault.* Free API Key recomemded to use Gemma 4 (Default Model).
-
----
-
-## ✨ Why Flux Flow?
-
-### 🎨 **Premium Visual Sovereignty**
-Experience a terminal UI that feels alive. Built with **Ink** and **React**, Flux Flow features:
-- **Dynamic Status Bar**: Real-time telemetry showing your "Neural Headroom" (token usage), Thinking Level, and Session ID.
-
-### 👁️ **Native Multimodality**
-Flux Flow can now see! Use the `view_file` tool to analyze images (JPG, PNG) or deep-dive into PDF technical papers. The agent extracts high-fidelity visual context natively, making it a true multimodal companion.
-
-### 📑 **Document Engineering Suite**
-Need a report or a presentation? Just ask. Flux Flow features a high-fidelity "Printing Press" that generates professional, branded documents natively:
-- **PDF**: Branded documents from HTML/CSS with automatic watermarking.
-- **DOCX**: Native Word documents with multi-page support and automatic numbering.
-- **PPTX**: High-fidelity PowerPoint presentations using native elements (selectable text, shapes) translated directly from HTML.
-
-### 🚑 **Self-Healing Infrastructure**
-Zero setup means zero setup. On first run, Flux Flow performs an integrity check and autonomously installs its own Chromium engine if needed, ensuring features like PDF generation work 100% of the time without manual intervention.
-
-- **Archived Terminal Flow**: See execution outputs transform from live elements into permanent conversation records.
-- **Rich Aesthetics**: High-contrast, sleek design with smooth transitions and micro-animations.
-
-### 🧠 **The Dual-Intelligence System**
-- **Flux Mode (Dev)**: High-speed, agentic problem solving with a 50-turn persistent loop for massive coding tasks.
-- **Flow Mode (Chat)**: Optimized for deep research, high-quality conversation, and web-assisted reasoning.
-
-### 🛡️ **Digital Fortress Governance**
-Security isn't an afterthought; it's a boundary.
-- **External Path Hardlock**: Restricts the agent to your Current Working Directory (CWD) unless you explicitly unlock it.
-- **Human-in-the-Loop (HITL)**: Every file write and terminal command requires your high-fidelity approval.
-- **XOR Vaulting**: All local session histories, memories, and API keys are obfuscated and encrypted at rest.
-- **Adaptive Failover**: Automatic multi-stage retry logic with high-concurrency fallback model switching (Gemini 3.1 Flash Lite) during peak API congestion.
-
-### 🧹 **The Background Janitor**
-While you move at high speed, the Janitor follows behind—refining session titles, compressing data, and ensuring your context window remains at absolute peak performance.
-
----
-
-## 🛠️ Key Capabilities
-- **Deep File-System Interaction**: Edit, move, and refactor code across multiple files with atomic precision.
-- **Real-Time Web Intelligence**: Autonomous web-searching via DuckDuckGo for live news and technical research.
-- **Autonomous Project Alignment**: Automatically detects and adheres to project-specific instructions in `Agent.md`, `Skills.md`, and `Fluxflow.md` for high-fidelity alignment with your coding standards and custom workflows.
-- **High-Reliability Fallback**: Automatic failover to a lighter, high-concurrency model during peak traffic to ensure zero session loss.
-- **Persistent Memory**: The agent learns from your preferences and project requirements across sessions.
-
----
-
-## ⚙️ Configuration
-Type `/settings` in-app to live-configure:
-- **Thinking Level**: Low, Medium, or High (Deep-Reasoning).
-- **Auto-Execution**: For ultimate high-speed flow (Advanced users only).
-- **Security Perimeter**: Toggle External Workspace access.
-
----
-
-## 🏁 License
-MIT © 2026 Flux Flow Team.
-
----
-*Forged with ⚡ and 🧬. Welcome to the FluxFlow.*