fluxflow-cli 1.0.3 → 1.0.5

package/README.md

@@ -3,7 +3,7 @@
 
 ### *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 frontier models. Designed for developers who demand a premium UI/UX while managing complex file-system tasks, web research, and autonomous workflows.
+**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.
 
 ---
 
@@ -49,6 +49,7 @@ While you move at high speed, the Janitor follows behind—refining session titl
 ## 🛠️ 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.
 - **Persistent Memory**: The agent learns from your preferences and project requirements across sessions.
 
 ---
@@ -65,4 +66,4 @@ Type `/settings` in-app to live-configure:
 MIT © 2026 Flux Flow Team.
 
 ---
-*Forged with ⚡ and 🧬. Welcome to the Flow.*
+*Forged with ⚡ and 🧬. Welcome to the FluxFlow.*

package/dist/fluxflow.js

@@ -417,13 +417,22 @@ ${userMemories}
 ` : ""}${isMemoryEnabled ? `${tempMemoriesStr}
 
 ` : ""}--- START SYSTEM INSTRUCTION ---
-You are Flux Flow. A CLI AI Agent. Your tone will be friendly, warm, sassy, approchable, respectable, NO ROMANTIC OR FLIRTY WORDS. Dont mention modes if not explicitly asked. ${mode === "Flux" ? "You are currently operating in FLUX (dev) mode. Keep your agentic approach goal oriented. Use provided tools when needed. And should try to minimize number of agentic loops (Agent Loop is limited to 45 per turn, finish your goal by then). Analyze user prompt and project requirements, then plan your approach." : "You are currently operating in Flow (chat) mode. Focus more on conversation quality and user experience. Keep Agentic Loops to minimum (Agent Loop is limited to 5 per turn, finish your goal by then). You will get access to Web Tools only in this mode."}
+You are Flux Flow. A CLI AI Agent. Your tone will be friendly, warm, sassy, approchable, respectable, NO ROMANTIC OR FLIRTY WORDS. Dont mention modes unless explicitly asked. ${mode === "Flux" ? "You are currently operating in FLUX (dev) mode. Keep your agentic approach goal oriented. Use provided tools when needed. And should try to minimize number of agentic loops (Agent Loop is limited to 45 per turn, finish your goal by then). Analyze user prompt and project requirements, then plan your approach." : "You are currently operating in Flow (chat) mode. Focus more on conversation quality and user experience. Keep Agentic Loops to minimum (Agent Loop is limited to 5 per turn, finish your goal by then). You will get access to Web Tools only in this mode."}
 CURRENT_WORKING_DIRECTORY: ${cwdStr}.
 ${nameStr}${nicknameStr}${userInstrStr}
 
 ${thinkingConfig}
 
 ${TOOL_PROTOCOL(mode)}
+${mode === "Flux" ? `
+-- START PROJECT SPECIFIC INSTRUCTIONS --
+1. README.md (If exists): Reference this for high-level goals and project context to ensure your work aligns with the user's objectives.
+2. Agent.md (If exists): This is your technical "Operating Manual". Follow the coding standards, directory structures, and tech stack constraints defined here without deviation.
+3. Skills.md (If exists): Use this for complex workflows. If a task matches a "Skill" defined in this file, execute the documented step-by-step instructions exactly as written.
+4. Fluxflow.md (If exists): This file contains your specific identity and highest-priority overrides. Instructions in Fluxflow.md supersede all other files if a conflict occurs.
+
+Before starting any task, check for these files and treat them as your primary source of truth, overriding your general training data to remain consistent with this specific project's environment.
+-- END PROJECT SPECIFIC INSTRUCTIONS --` : ""}
 
 -- START MEMORY INSTRUCTIONS --
 ${isMemoryEnabled ? "You have a internal memory system. Data is saved by a background model working in parallel. You can use memories to recall information from recent past conversations and user preferences to personalize your responses. Dont over mention about memory, keep it light and contexual." : "Memory Features are currently turned off by user. You can ask them to enable it /settings."}
@@ -581,6 +590,7 @@ var getTruncatedHistory = (history, exchangesToRemove = 4) => {
 
 // src/utils/usage.js
 import fs4 from "fs-extra";
+import path5 from "path";
 var getDailyUsage = async () => {
   const today = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
   try {
@@ -594,6 +604,7 @@ var getDailyUsage = async () => {
     console.error("Failed to read usage:", err);
   }
   const defaultStats = { agent: 0, background: 0, search: 0 };
+  await fs4.ensureDir(path5.dirname(USAGE_FILE));
   await fs4.writeJson(USAGE_FILE, { date: today, stats: defaultStats }, { spaces: 2 });
   return defaultStats;
 };
@@ -606,6 +617,7 @@ var incrementUsage = async (key) => {
   }
   if (data.stats[key] !== void 0) {
     data.stats[key]++;
+    await fs4.ensureDir(path5.dirname(USAGE_FILE));
     await fs4.writeJson(USAGE_FILE, data, { spaces: 2 });
   }
 };
@@ -656,7 +668,7 @@ var parseArgs = (argsString) => {
 
 // src/tools/web_search.js
 import fs5 from "fs";
-import path5 from "path";
+import path6 from "path";
 var web_search = async (argsString) => {
   const { query, limit = 10 } = parseArgs(argsString);
   if (!query) return 'ERROR: Missing "query" argument for web_search.';
@@ -684,11 +696,11 @@ Source: ${url}
 Snippet: ${snippet}`);
       count++;
     }
-    const toolLogDir = path5.join(LOGS_DIR, "tools");
+    const toolLogDir = path6.join(LOGS_DIR, "tools");
     if (!fs5.existsSync(toolLogDir)) {
       fs5.mkdirSync(toolLogDir, { recursive: true });
     }
-    fs5.appendFileSync(path5.join(toolLogDir, "search-results.log"), `RESULTS ${(/* @__PURE__ */ new Date()).toISOString()} - 
+    fs5.appendFileSync(path6.join(toolLogDir, "search-results.log"), `RESULTS ${(/* @__PURE__ */ new Date()).toISOString()} - 
 Query: [${query}]. Results Count: ${results.length}.
 Results: ${results}
 
@@ -696,11 +708,11 @@ Results: ${results}
 `);
     if (results.length === 0) {
       if (html.includes("anomaly")) {
-        const toolErrDir = path5.join(LOGS_DIR, "tools");
+        const toolErrDir = path6.join(LOGS_DIR, "tools");
         if (!fs5.existsSync(toolErrDir)) {
           fs5.mkdirSync(toolErrDir, { recursive: true });
         }
-        fs5.appendFileSync(path5.join(toolErrDir, "error.log"), `ERROR ${(/* @__PURE__ */ new Date()).toISOString()} - DDG detected unusual activity. Cuimp impersonation might need adjustment.
+        fs5.appendFileSync(path6.join(toolErrDir, "error.log"), `ERROR ${(/* @__PURE__ */ new Date()).toISOString()} - DDG detected unusual activity. Cuimp impersonation might need adjustment.
 `);
         throw new Error("DDG detected unusual activity. Cuimp impersonation might need adjustment.");
       }
@@ -717,7 +729,7 @@ ${finalResults}`;
 
 // src/tools/web_scrape.js
 import fs6 from "fs";
-import path6 from "path";
+import path7 from "path";
 import * as cuimp2 from "cuimp";
 var web_scrape = async (args) => {
   const urlMatch = args.match(/url\s*=\s*["'](.*)["']/);
@@ -739,11 +751,11 @@ var web_scrape = async (args) => {
     html = html.replace(/<header\b[^<]*(?:(?!<\/header>)<[^<]*)*<\/header>/gi, "");
     let text = html.replace(/<[^>]+>/g, " ").replace(/\s+/g, " ").trim();
     const finalContent = text.substring(0, 2e4);
-    const toolLogDir = path6.join(LOGS_DIR, "tools");
+    const toolLogDir = path7.join(LOGS_DIR, "tools");
     if (!fs6.existsSync(toolLogDir)) {
       fs6.mkdirSync(toolLogDir, { recursive: true });
     }
-    fs6.appendFileSync(path6.join(toolLogDir, "search-scraped.log"), `RESULTS ${(/* @__PURE__ */ new Date()).toISOString()} - 
+    fs6.appendFileSync(path7.join(toolLogDir, "search-scraped.log"), `RESULTS ${(/* @__PURE__ */ new Date()).toISOString()} - 
 Query: [${url}].
 Results: ${finalContent}
 
@@ -879,10 +891,10 @@ var summary = async (rawArgs, context = {}) => {
 
 // src/tools/list_files.js
 import fs7 from "fs";
-import path7 from "path";
+import path8 from "path";
 var list_files = async (args) => {
   const { path: targetPath = "." } = parseArgs(args);
-  const absolutePath = path7.resolve(process.cwd(), targetPath);
+  const absolutePath = path8.resolve(process.cwd(), targetPath);
   try {
     if (!fs7.existsSync(absolutePath)) {
       return `ERROR: Path [${targetPath}] does not exist.`;
@@ -899,7 +911,7 @@ var list_files = async (args) => {
     const maxDisplay = 100;
     const displayFiles = files2.slice(0, maxDisplay);
     const list = displayFiles.map((file) => {
-      const fPath = path7.join(absolutePath, file);
+      const fPath = path8.join(absolutePath, file);
       let indicator = "\u{1F4C4}";
       let metaPart = "";
       try {
@@ -934,11 +946,11 @@ ${list}${footer}`;
 
 // src/tools/view_file.js
 import fs8 from "fs";
-import path8 from "path";
+import path9 from "path";
 var view_file = async (args) => {
   const { path: targetPath, start_line = 1, end_line = 500 } = parseArgs(args);
   if (!targetPath) return 'ERROR: Missing "path" argument for view_file.';
-  const absolutePath = path8.resolve(process.cwd(), targetPath);
+  const absolutePath = path9.resolve(process.cwd(), targetPath);
   try {
     if (!fs8.existsSync(absolutePath)) {
       return `ERROR: File [${targetPath}] does not exist.`;
@@ -965,14 +977,14 @@ ${code}`;
 
 // src/tools/write_file.js
 import fs9 from "fs";
-import path9 from "path";
+import path10 from "path";
 var write_file = async (args) => {
   let { path: targetPath, content } = parseArgs(args);
   if (!targetPath) return 'ERROR: Missing "path" argument for write_file.';
   if (content === void 0) return 'ERROR: Missing "content" argument for write_file.';
   content = content.replace(/^```[\w]*\n?/, "").replace(/```\s*$/, "").trim();
-  const absolutePath = path9.resolve(process.cwd(), targetPath);
-  const parentDir = path9.dirname(absolutePath);
+  const absolutePath = path10.resolve(process.cwd(), targetPath);
+  const parentDir = path10.dirname(absolutePath);
   try {
     if (!fs9.existsSync(parentDir)) {
       fs9.mkdirSync(parentDir, { recursive: true });
@@ -1013,7 +1025,7 @@ ${snippet}`;
 
 // src/tools/update_file.js
 import fs10 from "fs";
-import path10 from "path";
+import path11 from "path";
 var update_file = async (args) => {
   let { path: targetPath, content_to_replace, content_to_add } = parseArgs(args);
   if (!targetPath) return 'ERROR: Missing "path" argument for update_file.';
@@ -1022,7 +1034,7 @@ var update_file = async (args) => {
   const strip = (t) => t.replace(/^```[\w]*\n?/, "").replace(/```\s*$/, "").trim();
   content_to_replace = strip(content_to_replace);
   content_to_add = strip(content_to_add);
-  const absolutePath = path10.resolve(process.cwd(), targetPath);
+  const absolutePath = path11.resolve(process.cwd(), targetPath);
   try {
     if (!fs10.existsSync(absolutePath)) {
       return `ERROR: File [${targetPath}] does not exist. Use write_file instead.`;
@@ -1115,10 +1127,10 @@ ${finalOutput}`);
 
 // src/tools/read_folder.js
 import fs11 from "fs";
-import path11 from "path";
+import path12 from "path";
 var read_folder = async (args) => {
   const { path: targetPath = "." } = parseArgs(args);
-  const absolutePath = path11.resolve(process.cwd(), targetPath);
+  const absolutePath = path12.resolve(process.cwd(), targetPath);
   try {
     if (!fs11.existsSync(absolutePath)) {
       return `ERROR: Path [${targetPath}] does not exist.`;
@@ -1132,7 +1144,7 @@ var read_folder = async (args) => {
     const displayItems = files.slice(0, maxDisplay);
     const folderData = [];
     for (const file of displayItems) {
-      const fPath = path11.join(absolutePath, file);
+      const fPath = path12.join(absolutePath, file);
       let indicator = "\u{1F4C4}";
       let info = { name: file, type: "unknown", size: "N/A", mtime: "N/A" };
       try {
@@ -1202,7 +1214,7 @@ var dispatchTool = async (toolName, args, context = {}) => {
 };
 
 // src/utils/ai.js
-import path12 from "path";
+import path13 from "path";
 import fs12 from "fs";
 var client = null;
 var TERMINATION_SIGNAL = false;
@@ -1317,11 +1329,11 @@ USER_PROMPT: ${agentText}`.trim();
       } catch (err) {
         const errMsg = err.message || String(err);
         const date = (/* @__PURE__ */ new Date()).toISOString().slice(0, 19).replace("T", " ");
-        const agentErrDir = path12.join(LOGS_DIR, "agent");
+        const agentErrDir = path13.join(LOGS_DIR, "agent");
         if (!fs12.existsSync(agentErrDir)) {
           fs12.mkdirSync(agentErrDir, { recursive: true });
         }
-        fs12.appendFileSync(path12.join(agentErrDir, "error.log"), `ERROR [${date}]: ${errMsg}
+        fs12.appendFileSync(path13.join(agentErrDir, "error.log"), `ERROR [${date}]: ${errMsg}
 `);
         const isRetryable = errMsg.includes("429") || errMsg.includes("503") || errMsg.includes("overloaded") || errMsg.includes("deadline");
         if (isRetryable && retryCount < MAX_RETRIES) {
@@ -1370,7 +1382,7 @@ USER_PROMPT: ${agentText}`.trim();
           const { path: targetPath2, start_line = 1, end_line = 500 } = parseArgs(toolCall.args);
           let totalLines = "...";
           try {
-            const absPath = path12.resolve(process.cwd(), targetPath2);
+            const absPath = path13.resolve(process.cwd(), targetPath2);
             if (fs12.existsSync(absPath)) {
               const content = fs12.readFileSync(absPath, "utf8");
               totalLines = content.split("\n").length;
@@ -1418,7 +1430,7 @@ ${boxBottom}
               /\/usr\//
               // Sensitive Linux paths
             ];
-            const currentDrive = path12.resolve(process.cwd()).substring(0, 3).toLowerCase();
+            const currentDrive = path13.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);
@@ -1440,8 +1452,8 @@ ${boxBottom}
         const targetPath = parsedArgs.path || parsedArgs.targetPath || null;
         if (targetPath) {
           const isExternalOff = settings.systemSettings && settings.systemSettings.allowExternalAccess === false;
-          const absoluteTarget = path12.resolve(targetPath);
-          const absoluteCwd = path12.resolve(process.cwd());
+          const absoluteTarget = path13.resolve(targetPath);
+          const absoluteCwd = path13.resolve(process.cwd());
           if (isExternalOff && !absoluteTarget.startsWith(absoluteCwd)) {
             const denyMsg = `Access Denied. You are not allowed to access files outside the current workspace. To enable this, ask the user to turn on "External Workspace Access" in /settings.`;
             toolResults.push(`[TOOL_RESULT]: ERROR: ${denyMsg}`);
@@ -1480,11 +1492,11 @@ ${boxBottom}
           const timestamp = (/* @__PURE__ */ new Date()).toISOString().slice(0, 19).replace("T", " ");
           const isErr = result.startsWith("ERROR:");
           const logStatus = isErr ? result.trim() : "SUCCESS";
-          const toolHistDir = path12.join(LOGS_DIR, "tools");
+          const toolHistDir = path13.join(LOGS_DIR, "tools");
           if (!fs12.existsSync(toolHistDir)) {
             fs12.mkdirSync(toolHistDir, { recursive: true });
           }
-          fs12.appendFileSync(path12.join(toolHistDir, "history.log"), `HISTORY [${timestamp}]: ${toolCall.toolName} [${logStatus}]
+          fs12.appendFileSync(path13.join(toolHistDir, "history.log"), `HISTORY [${timestamp}]: ${toolCall.toolName} [${logStatus}]
 `);
         } catch (logErr) {
         }
@@ -1538,11 +1550,11 @@ ${boxBottom}
         if (parts && parts[1]?.text) {
           finalSynthesis = parts[1].text;
           const date = (/* @__PURE__ */ new Date()).toISOString().slice(0, 19).replace("T", " ");
-          const janitorLogDir = path12.join(LOGS_DIR, "janitor");
+          const janitorLogDir = path13.join(LOGS_DIR, "janitor");
           if (!fs12.existsSync(janitorLogDir)) {
             fs12.mkdirSync(janitorLogDir, { recursive: true });
           }
-          fs12.appendFileSync(path12.join(janitorLogDir, "debug.log"), `DEBUG [${date}]: ${finalSynthesis}
+          fs12.appendFileSync(path13.join(janitorLogDir, "debug.log"), `DEBUG [${date}]: ${finalSynthesis}
 `);
         } else if (parts && parts[0]?.text) finalSynthesis = parts[0].text;
         else if (janitorResult.response && janitorResult.response.text) finalSynthesis = janitorResult.response.text();
@@ -1554,8 +1566,8 @@ ${boxBottom}
           const toolContext = { chatId, sessionId: chatId, history };
           const result = await dispatchTool(janitorToolCall.toolName, janitorToolCall.args, toolContext);
           const date = (/* @__PURE__ */ new Date()).toISOString().slice(0, 19).replace("T", " ");
-          const janitorLogDir = path12.join(LOGS_DIR, "janitor");
-          fs12.appendFileSync(path12.join(janitorLogDir, "debug.log"), `DEBUG [${date}]: RESULT [${janitorToolCall.toolName}]: ${result}
+          const janitorLogDir = path13.join(LOGS_DIR, "janitor");
+          fs12.appendFileSync(path13.join(janitorLogDir, "debug.log"), `DEBUG [${date}]: RESULT [${janitorToolCall.toolName}]: ${result}
 `);
           if (janitorToolCall.toolName === "memory" && !janitorToolCall.args.includes("action='temp'")) {
             yield { type: "memory_updated" };
@@ -1563,11 +1575,11 @@ ${boxBottom}
         }
       } catch (janitorErr) {
         const date = (/* @__PURE__ */ new Date()).toISOString().slice(0, 19).replace("T", " ");
-        const janitorErrDir = path12.join(LOGS_DIR, "janitor");
+        const janitorErrDir = path13.join(LOGS_DIR, "janitor");
         if (!fs12.existsSync(janitorErrDir)) {
           fs12.mkdirSync(janitorErrDir, { recursive: true });
         }
-        fs12.appendFileSync(path12.join(janitorErrDir, "error.log"), `ERROR [${date}]: ${janitorErr.message}
+        fs12.appendFileSync(path13.join(janitorErrDir, "error.log"), `ERROR [${date}]: ${janitorErr.message}
 `);
         console.error("Janitor Background Tasks Failed:", janitorErr.message);
       }
@@ -1595,6 +1607,7 @@ ${timestamp}`;
 
 // src/utils/settings.js
 import fs13 from "fs-extra";
+import path14 from "path";
 var DEFAULT_SETTINGS = {
   mode: "Flux",
   thinkingLevel: "Medium",
@@ -1642,6 +1655,7 @@ var saveSettings = async (settings) => {
   try {
     const current = await loadSettings();
     const updated = { ...current, ...settings };
+    await fs13.ensureDir(path14.dirname(SETTINGS_FILE));
     await fs13.writeJson(SETTINGS_FILE, updated, { spaces: 2 });
     return true;
   } catch (err) {
@@ -1691,8 +1705,8 @@ function ResumeModal({ onSelect, onDelete, onClose }) {
 // src/components/MemoryModal.jsx
 import React7, { useState as useState3, useEffect as useEffect2 } from "react";
 import { Box as Box7, Text as Text7, useInput as useInput2 } from "ink";
-import path13 from "path";
-var MEMORIES_PATH = path13.join(process.cwd(), "secret", "memories.json");
+import path15 from "path";
+var MEMORIES_PATH = path15.join(process.cwd(), "secret", "memories.json");
 function MemoryModal({ onClose }) {
   const [memories, setMemories] = useState3([]);
   const [selectedIndex, setSelectedIndex] = useState3(0);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "fluxflow-cli",
-	"version": "1.0.3",
+	"version": "1.0.5",
 	"description": "A high-fidelity agentic terminal assistant for the Flux Era.",
 	"keywords": [
 		"ai",