project-compass 2.4.0 → 2.5.1

package/README.md

@@ -1,4 +1,4 @@
-# Project Compass (v2.4.0)
+# Project Compass (v2.5.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.
 
@@ -10,6 +10,7 @@ Project Compass is a futuristic CLI navigator built with [Ink](https://github.co
 - 💡 **Refined Output**: Improved stdin buffer with proper spacing and reliable scrolling (Shift+↑/↓).
 - 🧠 **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.
 - 🔌 **Extensible**: Add custom commands with **Shift+C** and frameworks via `plugins.json`.
 
 ## Installation
@@ -21,7 +22,7 @@ npm install -g project-compass
 ## Usage
 
 ```bash
-project-compass [--dir /path/to/workspace]
+project-compass [--dir /path/to/workspace] [--studio]
 ```
 
 ### Keyboard Guide
@@ -31,7 +32,9 @@ project-compass [--dir /path/to/workspace]
 | ↑ / ↓ | Move focus, **Enter**: toggle details |
 | B / T / R | Build / Test / Run |
 | 1‑9 | Execute numbered detail commands |
+| **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+L** | Rerun last command |
 | **Shift+H** | Toggle help cards |
@@ -40,6 +43,10 @@ project-compass [--dir /path/to/workspace]
 | ? | Toggle help overlay |
 | Ctrl+C | Interrupt running command |
 
+## Omni-Studio
+
+Launch with `project-compass --studio` or press **Shift+A** inside the app. Omni-Studio provides real-time intelligence on your installed development environments, checking versions for Node, Python, Rust, Go, Java, and more. 
+
 ## Layout & UX
 
 Project Compass features a split layout where Projects and Details stay paired while Output takes a full-width band. The stdin buffer (at the bottom) now has a clear distinction between the label and your input for better readability. The help cards (Shift+H) have been refactored for a cleaner, more readable look.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "project-compass",
-  "version": "2.4.0",
+  "version": "2.5.1",
   "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

@@ -5,7 +5,7 @@ import path from 'path';
 import fs from 'fs';
 import kleur from 'kleur';
 import {execa} from 'execa';
-import {discoverProjects, SCHEMA_GUIDE} from './projectDetection.js';
+import {discoverProjects, SCHEMA_GUIDE, checkBinary} from './projectDetection.js';
 import {CONFIG_PATH, PLUGIN_FILE, ensureConfigDir} from './configPaths.js';
 
 const create = React.createElement;
@@ -95,11 +95,69 @@ function buildDetailCommands(project, config) {
   return [...builtins, ...custom];
 }
 
-function Compass({rootPath}) {
+function Studio() {
+  const [runtimes, setRuntimes] = useState([]);
+  const [loading, setLoading] = useState(true);
+
+  useEffect(() => {
+    const checks = [
+      {name: 'Node.js', binary: 'node', versionCmd: ['-v']},
+      {name: 'npm', binary: 'npm', versionCmd: ['-v']},
+      {name: 'Python', binary: process.platform === 'win32' ? 'python' : 'python3', versionCmd: ['--version']},
+      {name: 'Rust (Cargo)', binary: 'cargo', versionCmd: ['--version']},
+      {name: 'Go', binary: 'go', versionCmd: ['version']},
+      {name: 'Java', binary: 'java', versionCmd: ['-version']},
+      {name: 'PHP', binary: 'php', versionCmd: ['-v']},
+      {name: 'Ruby', binary: 'ruby', versionCmd: ['-v']},
+      {name: '.NET', binary: 'dotnet', versionCmd: ['--version']}
+    ];
+
+    (async () => {
+      const results = await Promise.all(checks.map(async (lang) => {
+        if (!checkBinary(lang.binary)) {
+          return {...lang, status: 'missing', version: 'not installed'};
+        }
+        try {
+          const {stdout, stderr} = await execa(lang.binary, lang.versionCmd);
+          const version = (stdout || stderr || '').split('\n')[0].trim();
+          return {...lang, status: 'ok', version};
+        } catch {
+          return {...lang, status: 'error', version: 'failed to check'};
+        }
+      }));
+      setRuntimes(results);
+      setLoading(false);
+    })();
+  }, []);
+
+  return create(
+    Box,
+    {flexDirection: 'column', borderStyle: 'double', borderColor: 'blue', padding: 1},
+    create(Text, {bold: true, color: 'blue'}, '💎 Omni-Studio | Environment Intelligence'),
+    create(Text, {dimColor: true, marginBottom: 1}, 'Overview of installed languages and build tools.'),
+    loading
+      ? create(Text, {dimColor: true}, 'Gathering intelligence...')
+      : create(
+          Box,
+          {flexDirection: 'column'},
+          ...runtimes.map(r => create(
+            Box,
+            {key: r.name, marginBottom: 1},
+            create(Text, {width: 15, color: r.status === 'ok' ? 'green' : 'red'}, `${r.status === 'ok' ? '✓' : '✗'} ${r.name}`),
+            create(Text, {dimColor: r.status !== 'ok'}, r.version)
+          )),
+          create(Text, {marginTop: 1, color: 'yellow'}, '🛠️ Interactive Project Creator coming soon in v3.0'),
+          create(Text, {dimColor: true}, 'Press Shift+A to return to Navigator.')
+        )
+  );
+}
+
+function Compass({rootPath, initialView = 'navigator'}) {
   const {exit} = useApp();
   const {projects, loading, error} = useScanner(rootPath);
   const [selectedIndex, setSelectedIndex] = useState(0);
   const [viewMode, setViewMode] = useState('list');
+  const [mainView, setMainView] = useState(initialView);
   const [logLines, setLogLines] = useState([]);
   const [logOffset, setLogOffset] = useState(0);
   const [running, setRunning] = useState(false);
@@ -120,7 +178,7 @@ function Compass({rootPath}) {
     setLogLines((prev) => {
       const normalized = typeof line === 'string' ? line : JSON.stringify(line);
       const appended = [...prev, normalized];
-      const next = appended.length > 250 ? appended.slice(appended.length - 250) : appended;
+      const next = appended.length > 500 ? appended.slice(appended.length - 500) : appended;
       return next;
     });
   }, []);
@@ -256,6 +314,7 @@ function Compass({rootPath}) {
     }
 
     const normalizedInput = input?.toLowerCase();
+    const ctrlCombo = (char) => key.ctrl && normalizedInput === char;
     const shiftCombo = (char) => key.shift && normalizedInput === char;
     const toggleShortcut = (char) => shiftCombo(char);
     if (toggleShortcut('h')) {
@@ -266,6 +325,15 @@ function Compass({rootPath}) {
       setShowStructureGuide((prev) => !prev);
       return;
     }
+    if (toggleShortcut('a')) {
+      setMainView((prev) => (prev === 'navigator' ? 'studio' : 'navigator'));
+      return;
+    }
+    if (toggleShortcut('x')) {
+      setLogLines([]);
+      setLogOffset(0);
+      return;
+    }
 
     const scrollLogs = (delta) => {
       setLogOffset((prev) => {
@@ -298,11 +366,11 @@ function Compass({rootPath}) {
     }
 
     if (key.shift && key.upArrow) {
-      scrollLogs(-1);
+      scrollLogs(1);
       return;
     }
     if (key.shift && key.downArrow) {
-      scrollLogs(1);
+      scrollLogs(-1);
       return;
     }
 
@@ -349,17 +417,19 @@ function Compass({rootPath}) {
       runProjectCommand(detailShortcutMap.get(normalizedInput), selectedProject);
     }
   });
-const projectRows = [];
+
+  const projectCountLabel = `${projects.length} project${projects.length === 1 ? '' : 's'}`;
+  const projectRows = [];
   if (loading) {
-    projectRows.push(create(Text, {dimColor: true}, 'Scanning projects…'));
+    projectRows.push(create(Text, {key: 'scanning', dimColor: true}, 'Scanning projects…'));
   }
   if (error) {
-    projectRows.push(create(Text, {color: 'red'}, `Unable to scan: ${error}`));
+    projectRows.push(create(Text, {key: 'error', color: 'red'}, `Unable to scan: ${error}`));
   }
   if (!loading && !error && projects.length === 0) {
-    projectRows.push(create(Text, {dimColor: true}, 'No recognizable project manifests found.'));
+    projectRows.push(create(Text, {key: 'empty', dimColor: true}, 'No recognizable project manifests found.'));
   }
-  if (!loading) {
+  if (!loading && mainView === 'navigator') {
     projects.forEach((project, index) => {
       const isSelected = index === selectedIndex;
       const frameworkBadges = (project.frameworks || []).map((frame) => `${frame.icon} ${frame.name}`).join(', ');
@@ -393,59 +463,58 @@ const projectRows = [];
     detailContent.push(
       create(
         Box,
-        {flexDirection: 'row'},
+        {key: 'title-row', flexDirection: 'row'},
         create(Text, {color: 'cyan', bold: true}, `${selectedProject.icon} ${selectedProject.name}`),
         selectedProject.missingBinaries && selectedProject.missingBinaries.length > 0 && create(Text, {color: 'red', bold: true}, '  ⚠️ MISSING RUNTIME')
       ),
-      create(Text, {dimColor: true}, `${selectedProject.type} · ${selectedProject.manifest || 'detected manifest'}`),
-      create(Text, {dimColor: true}, `Location: ${path.relative(rootPath, selectedProject.path) || '.'}`)
+      create(Text, {key: 'manifest', dimColor: true}, `${selectedProject.type} · ${selectedProject.manifest || 'detected manifest'}`),
+      create(Text, {key: 'loc', dimColor: true}, `Location: ${path.relative(rootPath, selectedProject.path) || '.'}`)
     );
     if (selectedProject.description) {
-      detailContent.push(create(Text, null, selectedProject.description));
+      detailContent.push(create(Text, {key: 'desc'}, selectedProject.description));
     }
     const frameworks = (selectedProject.frameworks || []).map((lib) => `${lib.icon} ${lib.name}`).join(', ');
     if (frameworks) {
-      detailContent.push(create(Text, {dimColor: true}, `Frameworks: ${frameworks}`));
+      detailContent.push(create(Text, {key: 'frames', dimColor: true}, `Frameworks: ${frameworks}`));
     }
     if (selectedProject.extra?.scripts && selectedProject.extra.scripts.length) {
-      detailContent.push(create(Text, {dimColor: true}, `Scripts: ${selectedProject.extra.scripts.join(', ')}`));
+      detailContent.push(create(Text, {key: 'scripts', dimColor: true}, `Scripts: ${selectedProject.extra.scripts.join(', ')}`));
     }
 
     if (selectedProject.missingBinaries && selectedProject.missingBinaries.length > 0) {
       detailContent.push(
-        create(Text, {color: 'red', bold: true, marginTop: 1}, 'MISSING BINARIES:'),
-        create(Text, {color: 'red'}, `Please install: ${selectedProject.missingBinaries.join(', ')}`),
-        create(Text, {dimColor: true}, 'Project commands may fail until these are in your PATH.')
+        create(Text, {key: 'missing-title', color: 'red', bold: true, marginTop: 1}, 'MISSING BINARIES:'),
+        create(Text, {key: 'missing-list', color: 'red'}, `Please install: ${selectedProject.missingBinaries.join(', ')}`),
+        create(Text, {key: 'missing-hint', dimColor: true}, 'Project commands may fail until these are in your PATH.')
       );
     }
 
-    detailContent.push(create(Text, {dimColor: true, marginTop: 1}, `Custom commands stored in ${CONFIG_PATH}`));
-    detailContent.push(create(Text, {dimColor: true, marginBottom: 1}, `Extend frameworks via ${PLUGIN_FILE}`));
-    detailContent.push(create(Text, {bold: true, marginTop: 1}, 'Commands'));
+    detailContent.push(create(Text, {key: 'config-path', dimColor: true, marginTop: 1}, `Custom commands stored in ${CONFIG_PATH}`));
+    detailContent.push(create(Text, {key: 'plugin-path', dimColor: true, marginBottom: 1}, `Extend frameworks via ${PLUGIN_FILE}`));
+    detailContent.push(create(Text, {key: 'cmd-header', bold: true, marginTop: 1}, 'Commands'));
     detailedIndexed.forEach((command) => {
       detailContent.push(
         create(Text, {key: `detail-${command.shortcut}-${command.label}`}, `${command.shortcut}. ${command.label} ${command.source === 'custom' ? kleur.magenta('(custom)') : command.source === 'framework' ? kleur.cyan('(framework)') : command.source === 'plugin' ? kleur.green('(plugin)') : ''}`)
       );
-      detailContent.push(create(Text, {dimColor: true}, `   ↳ ${command.command.join(' ')}`));
+      detailContent.push(create(Text, {key: `detail-line-${command.shortcut}-${command.label}`, dimColor: true}, `   ↳ ${command.command.join(' ')}`));
     });
     if (!detailedIndexed.length) {
-      detailContent.push(create(Text, {dimColor: true}, 'No built-in commands yet. Add a custom command with Shift+C.'));
+      detailContent.push(create(Text, {key: 'no-cmds', dimColor: true}, 'No built-in commands yet. Add a custom command with Shift+C.'));
     }
     const setupHints = selectedProject.extra?.setupHints || [];
     if (setupHints.length) {
-      detailContent.push(create(Text, {dimColor: true, marginTop: 1}, 'Setup hints:'));
-      setupHints.forEach((hint) => detailContent.push(create(Text, {dimColor: true}, `  • ${hint}`)));
+      detailContent.push(create(Text, {key: 'setup-header', dimColor: true, marginTop: 1}, 'Setup hints:'));
+      setupHints.forEach((hint, hidx) => detailContent.push(create(Text, {key: `hint-${hidx}`, dimColor: true}, `  • ${hint}`)));
     }
-    detailContent.push(create(Text, {dimColor: true}, 'Press Shift+C → label|cmd to save custom actions, Enter to close detail view.'));
+    detailContent.push(create(Text, {key: 'hint-line', dimColor: true}, 'Press Shift+C → label|cmd to save custom actions, Enter to close detail view.'));
   } else {
-    detailContent.push(create(Text, {dimColor: true}, 'Press Enter on a project to reveal details (icons, commands, frameworks, custom actions).'));
+    detailContent.push(create(Text, {key: 'enter-hint', dimColor: true}, 'Press Enter on a project to reveal details (icons, commands, frameworks, custom actions).'));
   }
 
   if (customMode) {
-    detailContent.push(create(Text, {color: 'cyan'}, `Type label|cmd (Enter to save, Esc to cancel): ${customInput}`));
+    detailContent.push(create(Text, {key: 'custom-input', color: 'cyan'}, `Type label|cmd (Enter to save, Esc to cancel): ${customInput}`));
   }
 
-  const projectCountLabel = `${projects.length} project${projects.length === 1 ? '' : 's'}`;
   const artTileNodes = useMemo(() => {
     const selectedName = selectedProject?.name || 'Awaiting selection';
     const selectedType = selectedProject?.type || 'Unknown stack';
@@ -529,7 +598,7 @@ const projectRows = [];
   const visibleLogs = logLines.slice(logWindowStart, logWindowEnd);
   const logNodes = visibleLogs.length
     ? visibleLogs.map((line, index) => create(Text, {key: index}, line))
-    : [create(Text, {dimColor: true}, 'Logs will appear here once you run a command.')];
+    : [create(Text, {key: 'no-logs', dimColor: true}, 'Logs will appear here once you run a command.')];
 
   const helpCards = [
     {
@@ -549,14 +618,14 @@ const projectRows = [];
         'B / T / R build/test/run',
         '1-9 run detail commands',
         'Shift+L rerun last command',
-        'Ctrl+C abort; type feeds stdin'
+        'Shift+X clear output logs'
       ]
     },
     {
-      label: 'Recent runs',
+      label: 'System & Studio',
       color: 'yellow',
       body: [
-        recentRuns.length ? `${recentRuns.length} runs recorded` : 'No runs yet · start with B/T/R',
+        'Shift+A open Omni-Studio',
         'Shift+S toggle structure guide',
         'Shift+C save custom action',
         'Shift+Q quit application'
@@ -589,7 +658,7 @@ const projectRows = [];
           )
         )
       )
-    : create(Text, {dimColor: true, marginTop: 1}, 'Help cards hidden · press Shift+H to show navigation, command flow, and recent runs.');
+    : create(Text, {key: 'help-hint', dimColor: true, marginTop: 1}, 'Help cards hidden · press Shift+H to show navigation, command flow, and recent runs.');
 
   const structureGuide = showStructureGuide
     ? create(
@@ -620,14 +689,18 @@ const projectRows = [];
           padding: 1
         },
         create(Text, {color: 'cyan', bold: true}, 'Help overlay · press ? to hide'),
-        create(Text, null, 'Shift+↑/↓ scrolls the log buffer while commands stream; type to feed stdin (Enter submits, Ctrl+C aborts).'),
+        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 these help cards, Shift+S toggles the structure guide, ? toggles this overlay, Shift+Q quits.'),
+        create(Text, null, 'Shift+H toggles 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 (Shift+S to toggle).')
+        create(Text, null, 'Structure guide lists the manifests that trigger each language detection.')
       )
     : null;
 
+  if (mainView === 'studio') {
+    return create(Studio);
+  }
+
   const toggleHint = showHelpCards ? 'Shift+H hides the help cards' : 'Shift+H shows the help cards';
   const headerHint = viewMode === 'detail'
     ? `Detail mode · 1-${Math.max(detailedIndexed.length, 1)} to execute, Shift+C: add custom commands, Enter: back to list, Shift+Q: quit · ${toggleHint}, Shift+S toggles structure guide`
@@ -751,6 +824,8 @@ function parseArgs() {
       i += 1;
     } else if (token === '--help' || token === '-h') {
       args.help = true;
+    } else if (token === '--studio') {
+      args.view = 'studio';
     }
   }
   return args;
@@ -760,7 +835,7 @@ 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]');
+    console.log('Usage: project-compass [--dir <path>] [--mode test] [--studio]');
     return;
   }
   const rootPath = args.root ? path.resolve(args.root) : process.cwd();
@@ -773,7 +848,7 @@ async function main() {
     return;
   }
 
-  render(create(Compass, {rootPath}));
+  render(create(Compass, {rootPath, initialView: args.view || 'navigator'}));
 }
 
 main().catch((error) => {

package/src/projectDetection.js

@@ -1098,4 +1098,4 @@ const SCHEMA_GUIDE = schemaRegistry.getSchemas().map((schema) => ({
   files: schema.files
 }));
 
-export {discoverProjects, SCHEMA_GUIDE};
+export {discoverProjects, SCHEMA_GUIDE, checkBinary};