fluxflow-cli 1.8.2 → 1.8.3

package/README-npm.md

@@ -0,0 +1,84 @@
+# 🌌 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.*

package/dist/fluxflow.js

@@ -4809,7 +4809,7 @@ var init_app = __esm({
     init_text();
     SESSION_START_TIME = Date.now();
     CHANGELOG_URL = "https://fluxflow-cli.onrender.com/changelog.html";
-    versionFluxflow = "1.8.2";
+    versionFluxflow = "1.8.3";
     updatedOn = "2026-05-07";
     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.2",
+	"version": "1.8.3",
 	"description": "A high-fidelity agentic terminal assistant for the Flux Era.",
 	"keywords": [
 		"ai",
@@ -21,7 +21,7 @@
 	},
 	"files": [
 		"dist",
-		"README.md",
+		"README-npm.md",
 		"package.json",
 		"ARCHITECTURE.md",
 		"TOOLS.md",