project-compass 2.5.1 → 2.7.0

package/README.md

@@ -1,4 +1,4 @@
-# Project Compass (v2.5.0)
+# Project Compass (v2.6.0)
 
 Project Compass is a futuristic CLI navigator built with [Ink](https://github.com/vadimdemedes/ink) that scans your current folder tree for familiar code projects and gives you one-keystroke access to build, test, or run them.
 
@@ -11,6 +11,7 @@ Project Compass is a futuristic CLI navigator built with [Ink](https://github.co
 - 🧠 **Smart Detection**: Support for 20+ frameworks including **Spring Boot** (Maven/Gradle), **ASP.NET Core**, **Rocket/Actix** (Rust), **Laravel** (PHP), **Vite**, **Prisma**, and more.
 - ⚠️ **Runtime Health**: Automatically checks if the required language/runtime (e.g., `node`, `python`, `cargo`) is installed and warns you if it's missing.
 - 💎 **Omni-Studio**: A new interactive environment intelligence mode to see all installed runtimes and versions.
+- 📂 **Log Management**: Clear output with **Shift+X** or export logs to a text file with **Shift+E**.
 - 🔌 **Extensible**: Add custom commands with **Shift+C** and frameworks via `plugins.json`.
 
 ## Installation
@@ -35,7 +36,8 @@ project-compass [--dir /path/to/workspace] [--studio]
 | **Shift+A** | Open **Omni-Studio** (Environment View) |
 | **Shift+C** | Add a custom command (`label|cmd`) |
 | **Shift+X** | **Clear output logs** |
-| **Shift ↑ / ↓** | Scroll output buffer |
+| **Shift+E** | **Export logs to .txt** |
+| **Shift ↑ / ↓** | Scroll output buffer (Intuitive Direction) |
 | **Shift+L** | Rerun last command |
 | **Shift+H** | Toggle help cards |
 | **Shift+S** | Toggle structure guide |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "project-compass",
-  "version": "2.5.1",
+  "version": "2.7.0",
   "description": "Ink-based project explorer that detects local repos and lets you build/test/run them without memorizing commands.",
   "main": "src/cli.js",
   "type": "module",

package/src/cli.js

@@ -152,6 +152,27 @@ function Studio() {
   );
 }
 
+function CursorText({value, cursorIndex, active = true}) {
+  const [visible, setVisible] = useState(true);
+  useEffect(() => {
+    if (!active) return;
+    const interval = setInterval(() => setVisible(v => !v), 500);
+    return () => clearInterval(interval);
+  }, [active]);
+
+  const before = value.slice(0, cursorIndex);
+  const charAt = value[cursorIndex] || ' ';
+  const after = value.slice(cursorIndex + 1);
+
+  return create(
+    Text,
+    null,
+    before,
+    active && visible ? create(Text, {backgroundColor: 'white', color: 'black'}, charAt) : charAt,
+    after
+  );
+}
+
 function Compass({rootPath, initialView = 'navigator'}) {
   const {exit} = useApp();
   const {projects, loading, error} = useScanner(rootPath);
@@ -164,10 +185,12 @@ function Compass({rootPath, initialView = 'navigator'}) {
   const [lastAction, setLastAction] = useState(null);
   const [customMode, setCustomMode] = useState(false);
   const [customInput, setCustomInput] = useState('');
+  const [customCursor, setCustomCursor] = useState(0);
   const [config, setConfig] = useState(() => loadConfig());
   const [showHelpCards, setShowHelpCards] = useState(false);
   const [showStructureGuide, setShowStructureGuide] = useState(false);
   const [stdinBuffer, setStdinBuffer] = useState('');
+  const [stdinCursor, setStdinCursor] = useState(0);
   const [showHelp, setShowHelp] = useState(false);
   const [recentRuns, setRecentRuns] = useState([]);
   const selectedProject = projects[selectedIndex] || null;
@@ -177,9 +200,9 @@ function Compass({rootPath, initialView = 'navigator'}) {
   const addLog = useCallback((line) => {
     setLogLines((prev) => {
       const normalized = typeof line === 'string' ? line : JSON.stringify(line);
-      const appended = [...prev, normalized];
-      const next = appended.length > 500 ? appended.slice(appended.length - 500) : appended;
-      return next;
+      const lines = normalized.split(/\r?\n/).filter(l => l.trim().length > 0);
+      const appended = [...prev, ...lines];
+      return appended.length > 500 ? appended.slice(appended.length - 500) : appended;
     });
   }, []);
 
@@ -228,10 +251,10 @@ function Compass({rootPath, initialView = 'navigator'}) {
       runningProcessRef.current = subprocess;
 
       subprocess.stdout?.on('data', (chunk) => {
-        addLog(chunk.toString().trimEnd());
+        addLog(chunk.toString());
       });
       subprocess.stderr?.on('data', (chunk) => {
-        addLog(kleur.red(chunk.toString().trimEnd()));
+        addLog(kleur.red(chunk.toString()));
       });
 
       await subprocess;
@@ -241,6 +264,7 @@ function Compass({rootPath, initialView = 'navigator'}) {
     } finally {
       setRunning(false);
       setStdinBuffer('');
+      setStdinCursor(0);
       runningProcessRef.current = null;
     }
   }, [addLog, running, selectedProject]);
@@ -276,6 +300,7 @@ function Compass({rootPath, initialView = 'navigator'}) {
       addLog(kleur.gray('Canceled custom command (empty).'));
       setCustomMode(false);
       setCustomInput('');
+      setCustomCursor(0);
       return;
     }
     const [labelPart, commandPart] = raw.split('|');
@@ -284,14 +309,29 @@ function Compass({rootPath, initialView = 'navigator'}) {
       addLog(kleur.red('Custom command needs at least one token.'));
       setCustomMode(false);
       setCustomInput('');
+      setCustomCursor(0);
       return;
     }
     const label = commandPart ? labelPart.trim() : `Custom ${selectedProject.name}`;
     handleAddCustomCommand(label || 'Custom', commandTokens);
     setCustomMode(false);
     setCustomInput('');
+    setCustomCursor(0);
   }, [customInput, selectedProject, handleAddCustomCommand, addLog]);
 
+  const exportLogs = useCallback(() => {
+    if (!logLines.length) {
+      return;
+    }
+    try {
+      const exportPath = path.resolve(process.cwd(), `compass-logs-${Date.now()}.txt`);
+      fs.writeFileSync(exportPath, logLines.join('\n'));
+      addLog(kleur.green(`✓ Logs exported to ${exportPath}`));
+    } catch (err) {
+      addLog(kleur.red(`✗ Export failed: ${err.message}`));
+    }
+  }, [logLines, addLog]);
+
     useInput((input, key) => {
     if (customMode) {
       if (key.return) {
@@ -301,14 +341,27 @@ function Compass({rootPath, initialView = 'navigator'}) {
       if (key.escape) {
         setCustomMode(false);
         setCustomInput('');
+        setCustomCursor(0);
+        return;
+      }
+      if (key.backspace || key.delete) {
+        if (customCursor > 0) {
+          setCustomInput((prev) => prev.slice(0, customCursor - 1) + prev.slice(customCursor));
+          setCustomCursor(c => Math.max(0, c - 1));
+        }
         return;
       }
-      if (key.backspace) {
-        setCustomInput((prev) => prev.slice(0, -1));
+      if (key.leftArrow) {
+        setCustomCursor(c => Math.max(0, c - 1));
+        return;
+      }
+      if (key.rightArrow) {
+        setCustomCursor(c => Math.min(customInput.length, c + 1));
         return;
       }
       if (input) {
-        setCustomInput((prev) => prev + input);
+        setCustomInput((prev) => prev.slice(0, customCursor) + input + prev.slice(customCursor));
+        setCustomCursor(c => c + input.length);
       }
       return;
     }
@@ -334,6 +387,10 @@ function Compass({rootPath, initialView = 'navigator'}) {
       setLogOffset(0);
       return;
     }
+    if (shiftCombo('e')) {
+      exportLogs();
+      return;
+    }
 
     const scrollLogs = (delta) => {
       setLogOffset((prev) => {
@@ -346,21 +403,33 @@ function Compass({rootPath, initialView = 'navigator'}) {
       if (key.ctrl && input === 'c') {
         runningProcessRef.current.kill('SIGINT');
         setStdinBuffer('');
+        setStdinCursor(0);
         return;
       }
       if (key.return) {
-        runningProcessRef.current.stdin?.write('\n');
+        runningProcessRef.current.stdin?.write(stdinBuffer + '\n');
         setStdinBuffer('');
+        setStdinCursor(0);
+        return;
+      }
+      if (key.backspace || key.delete) {
+        if (stdinCursor > 0) {
+          setStdinBuffer(prev => prev.slice(0, stdinCursor - 1) + prev.slice(stdinCursor));
+          setStdinCursor(c => Math.max(0, c - 1));
+        }
         return;
       }
-      if (key.backspace) {
-        runningProcessRef.current.stdin?.write('\x08');
-        setStdinBuffer((prev) => prev.slice(0, -1));
+      if (key.leftArrow) {
+        setStdinCursor(c => Math.max(0, c - 1));
+        return;
+      }
+      if (key.rightArrow) {
+        setStdinCursor(c => Math.min(stdinBuffer.length, c + 1));
         return;
       }
       if (input) {
-        runningProcessRef.current.stdin?.write(input);
-        setStdinBuffer((prev) => prev + input);
+        setStdinBuffer(prev => prev.slice(0, stdinCursor) + input + prev.slice(stdinCursor));
+        setStdinCursor(c => c + input.length);
       }
       return;
     }
@@ -405,6 +474,7 @@ function Compass({rootPath, initialView = 'navigator'}) {
     if (shiftCombo('c') && viewMode === 'detail' && selectedProject) {
       setCustomMode(true);
       setCustomInput('');
+      setCustomCursor(0);
       return;
     }
     const actionKey = normalizedInput && ACTION_MAP[normalizedInput];
@@ -512,7 +582,14 @@ function Compass({rootPath, initialView = 'navigator'}) {
   }
 
   if (customMode) {
-    detailContent.push(create(Text, {key: 'custom-input', color: 'cyan'}, `Type label|cmd (Enter to save, Esc to cancel): ${customInput}`));
+    detailContent.push(
+      create(
+        Box,
+        {key: 'custom-input-box', flexDirection: 'row'},
+        create(Text, {color: 'cyan'}, 'Type label|cmd (Enter: save, Esc: cancel): '),
+        create(CursorText, {value: customInput, cursorIndex: customCursor})
+      )
+    );
   }
 
   const artTileNodes = useMemo(() => {
@@ -618,7 +695,7 @@ function Compass({rootPath, initialView = 'navigator'}) {
         'B / T / R build/test/run',
         '1-9 run detail commands',
         'Shift+L rerun last command',
-        'Shift+X clear output logs'
+        'Shift+X clear / Shift+E export'
       ]
     },
     {
@@ -689,9 +766,9 @@ function Compass({rootPath, initialView = 'navigator'}) {
           padding: 1
         },
         create(Text, {color: 'cyan', bold: true}, 'Help overlay · press ? to hide'),
-        create(Text, null, 'Shift+↑/↓ scrolls the log buffer; Shift+X clears logs; Shift+A opens Omni-Studio.'),
-        create(Text, null, 'B/T/R run build/test/run; 1-9 executes detail commands; Shift+L reruns the previous command.'),
-        create(Text, null, 'Shift+H toggles help cards, Shift+S structure guide, ? overlay, Shift+Q quits.'),
+        create(Text, null, 'Shift+↑/↓ scrolls logs; Shift+X clears; Shift+E exports to file; Shift+A Omni-Studio.'),
+        create(Text, null, 'B/T/R run build/test/run; 1-9 detail commands; Shift+L reruns previous command.'),
+        create(Text, null, 'Shift+H help cards, Shift+S structure guide, ? overlay, Shift+Q quits.'),
         create(Text, null, 'Projects + Details stay paired while Output keeps its own full-width band.'),
         create(Text, null, 'Structure guide lists the manifests that trigger each language detection.')
       )
@@ -801,7 +878,7 @@ function Compass({rootPath, initialView = 'navigator'}) {
           paddingX: 1
         },
         create(Text, {bold: true, color: running ? 'green' : 'white'}, running ? ' Stdin buffer ' : ' Input ready '),
-        create(Text, {dimColor: true, marginLeft: 1}, running ? (stdinBuffer || '(type to send)') : 'Start a command to feed stdin')
+        create(Box, {marginLeft: 1}, create(CursorText, {value: stdinBuffer || (running ? '' : 'Start a command to feed stdin'), cursorIndex: stdinCursor, active: running}))
       )
     ),
     helpSection,
@@ -834,8 +911,32 @@ function parseArgs() {
 async function main() {
   const args = parseArgs();
   if (args.help) {
-    console.log('Project Compass · Ink project runner');
-    console.log('Usage: project-compass [--dir <path>] [--mode test] [--studio]');
+    console.log(kleur.cyan('Project Compass · Ink project navigator/runner'));
+    console.log('');
+    console.log(kleur.bold('Usage:'));
+    console.log('  project-compass [--dir <path>] [--studio]');
+    console.log('');
+    console.log(kleur.bold('Arguments:'));
+    console.log('  --dir, --path <path>  Specify root workspace directory to scan');
+    console.log('  --studio              Launch directly into Omni-Studio mode');
+    console.log('  --help, -h            Show this help menu');
+    console.log('');
+    console.log(kleur.bold('Core Keybinds:'));
+    console.log('  ↑ / ↓                 Move project focus');
+    console.log('  Enter                 Toggle detail view for selected project');
+    console.log('  Shift+A               Switch to Omni-Studio (Environment Health)');
+    console.log('  Shift+X               Clear the output log buffer');
+    console.log('  Shift+E               Export current logs to a .txt file');
+    console.log('  Shift+↑ / ↓           Scroll the output logs back/forward');
+    console.log('  Shift+Q               Quit application');
+    console.log('');
+    console.log(kleur.bold('Execution shortcuts:'));
+    console.log('  B / T / R             Quick run: Build / Test / Run');
+    console.log('  1-9                   Run numbered commands in detail view');
+    console.log('  Shift+L               Rerun the last executed command');
+    console.log('  Shift+C               Add a custom command (in detail view)');
+    console.log('');
+    console.log(kleur.dim('Documentation: https://github.com/CrimsonDevil333333/project-compass'));
     return;
   }
   const rootPath = args.root ? path.resolve(args.root) : process.cwd();