project-compass 2.3.1 → 2.5.0

package/README.md

@@ -1,4 +1,4 @@
-# Project Compass (v2.3.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.
 
@@ -9,6 +9,8 @@ Project Compass is a futuristic CLI navigator built with [Ink](https://github.co
 - 🚀 **New Keyboard-Centric UX**: Shortcuts now use **Shift** instead of Ctrl to avoid terminal interference.
 - 💡 **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
@@ -20,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
@@ -30,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 |
@@ -39,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.3.1",
+  "version": "2.5.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

@@ -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) => {
@@ -349,6 +417,11 @@ function Compass({rootPath}) {
       runProjectCommand(detailShortcutMap.get(normalizedInput), selectedProject);
     }
   });
+
+  if (mainView === 'studio') {
+    return create(Studio);
+  }
+
 const projectRows = [];
   if (loading) {
     projectRows.push(create(Text, {dimColor: true}, 'Scanning projects…'));
@@ -363,17 +436,23 @@ const projectRows = [];
     projects.forEach((project, index) => {
       const isSelected = index === selectedIndex;
       const frameworkBadges = (project.frameworks || []).map((frame) => `${frame.icon} ${frame.name}`).join(', ');
+      const hasMissingRuntime = project.missingBinaries && project.missingBinaries.length > 0;
       projectRows.push(
         create(
           Box,
           {key: project.id, flexDirection: 'column', marginBottom: 1, padding: 1},
           create(
-            Text,
-            {
-              color: isSelected ? 'cyan' : 'white',
-              bold: isSelected
-            },
-            `${project.icon} ${project.name}`
+            Box,
+            {flexDirection: 'row'},
+            create(
+              Text,
+              {
+                color: isSelected ? 'cyan' : 'white',
+                bold: isSelected
+              },
+              `${project.icon} ${project.name}`
+            ),
+            hasMissingRuntime && create(Text, {color: 'red', bold: true}, '  ⚠️ Runtime missing')
           ),
           create(Text, {dimColor: true}, `  ${project.type} · ${path.relative(rootPath, project.path) || '.'}`),
           frameworkBadges && create(Text, {dimColor: true}, `   ${frameworkBadges}`)
@@ -385,7 +464,12 @@ const projectRows = [];
   const detailContent = [];
   if (viewMode === 'detail' && selectedProject) {
     detailContent.push(
-      create(Text, {color: 'cyan', bold: true}, `${selectedProject.icon} ${selectedProject.name}`),
+      create(
+        Box,
+        {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) || '.'}`)
     );
@@ -399,7 +483,16 @@ const projectRows = [];
     if (selectedProject.extra?.scripts && selectedProject.extra.scripts.length) {
       detailContent.push(create(Text, {dimColor: true}, `Scripts: ${selectedProject.extra.scripts.join(', ')}`));
     }
-    detailContent.push(create(Text, {dimColor: true}, `Custom commands stored in ${CONFIG_PATH}`));
+
+    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.')
+      );
+    }
+
+    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'));
     detailedIndexed.forEach((command) => {
@@ -529,14 +622,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'
@@ -600,11 +693,11 @@ 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;
 
@@ -731,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;
@@ -740,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();
@@ -753,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

@@ -1,5 +1,6 @@
 import fs from 'fs';
 import path from 'path';
+import {execSync} from 'child_process';
 import fastGlob from 'fast-glob';
 import {ensureConfigDir, PLUGIN_FILE} from './configPaths.js';
 
@@ -7,6 +8,16 @@ const IGNORE_PATTERNS = ['**/node_modules/**', '**/.git/**', '**/dist/**', '**/b
 
 const PYTHON_ENTRY_FILES = ['main.py', 'app.py', 'src/main.py', 'src/app.py'];
 
+function checkBinary(name) {
+  try {
+    const cmd = process.platform === 'win32' ? `where ${name}` : `which ${name}`;
+    execSync(cmd, {stdio: 'ignore'});
+    return true;
+  } catch {
+    return false;
+  }
+}
+
 function findPythonEntry(projectPath) {
   return PYTHON_ENTRY_FILES.find((file) => hasProjectFile(projectPath, file)) || null;
 }
@@ -538,7 +549,9 @@ class SchemaRegistry {
         icon: '🟢',
         priority: 100,
         files: ['package.json'],
+        binaries: ['node', 'npm'],
         async build(projectPath, manifest) {
+          const missingBinaries = this.binaries.filter(b => !checkBinary(b));
           const pkgPath = path.join(projectPath, 'package.json');
           if (!fs.existsSync(pkgPath)) {
             return null;
@@ -587,6 +600,7 @@ class SchemaRegistry {
             metadata,
             manifest: path.basename(manifest),
             description: pkg.description || '',
+            missingBinaries,
             extra: {
               scripts: Object.keys(scripts),
               setupHints
@@ -600,7 +614,9 @@ class SchemaRegistry {
         icon: '🐍',
         priority: 95,
         files: ['pyproject.toml', 'requirements.txt', 'setup.py', 'Pipfile'],
+        binaries: [process.platform === 'win32' ? 'python' : 'python3', 'pip'],
         async build(projectPath, manifest) {
+          const missingBinaries = this.binaries.filter(b => !checkBinary(b));
           const commands = {};
           if (hasProjectFile(projectPath, 'pyproject.toml')) {
             commands.test = {label: 'Pytest', command: ['pytest']};
@@ -636,6 +652,7 @@ class SchemaRegistry {
             metadata,
             manifest: path.basename(manifest),
             description: '',
+            missingBinaries,
             extra: {
               entry,
               setupHints
@@ -649,7 +666,9 @@ class SchemaRegistry {
         icon: '🦀',
         priority: 90,
         files: ['Cargo.toml'],
+        binaries: ['cargo', 'rustc'],
         async build(projectPath, manifest) {
+          const missingBinaries = this.binaries.filter(b => !checkBinary(b));
           return {
             id: `${projectPath}::rust`,
             path: projectPath,
@@ -665,6 +684,7 @@ class SchemaRegistry {
             metadata: {},
             manifest: path.basename(manifest),
             description: '',
+            missingBinaries,
             extra: {
               setupHints: ['cargo fetch', 'Run cargo build before releasing']
             }
@@ -677,7 +697,9 @@ class SchemaRegistry {
         icon: '🐹',
         priority: 85,
         files: ['go.mod'],
+        binaries: ['go'],
         async build(projectPath, manifest) {
+          const missingBinaries = this.binaries.filter(b => !checkBinary(b));
           return {
             id: `${projectPath}::go`,
             path: projectPath,
@@ -693,6 +715,7 @@ class SchemaRegistry {
             metadata: {},
             manifest: path.basename(manifest),
             description: '',
+            missingBinaries,
             extra: {
               setupHints: ['go mod tidy', 'Ensure Go toolchain is installed']
             }
@@ -705,7 +728,9 @@ class SchemaRegistry {
         icon: '☕️',
         priority: 80,
         files: ['pom.xml', 'build.gradle', 'build.gradle.kts'],
+        binaries: ['java', 'javac'],
         async build(projectPath, manifest) {
+          const missingBinaries = this.binaries.filter(b => !checkBinary(b));
           const hasMvnw = hasProjectFile(projectPath, 'mvnw');
           const hasGradlew = hasProjectFile(projectPath, 'gradlew');
           const commands = {};
@@ -731,6 +756,7 @@ class SchemaRegistry {
             metadata: {},
             manifest: path.basename(manifest),
             description: '',
+            missingBinaries,
             extra: {
               setupHints: ['Install JDK 17+ and run ./mvnw install or ./gradlew build']
             }
@@ -743,7 +769,9 @@ class SchemaRegistry {
         icon: '🔵',
         priority: 70,
         files: ['build.sbt'],
+        binaries: ['sbt', 'scala'],
         async build(projectPath, manifest) {
+          const missingBinaries = this.binaries.filter(b => !checkBinary(b));
           return {
             id: `${projectPath}::scala`,
             path: projectPath,
@@ -759,6 +787,7 @@ class SchemaRegistry {
             metadata: {},
             manifest: path.basename(manifest),
             description: '',
+            missingBinaries,
             extra: {
               setupHints: ['Ensure sbt is installed', 'Run sbt compile before running your app']
             }
@@ -771,7 +800,9 @@ class SchemaRegistry {
         icon: '🐘',
         priority: 65,
         files: ['composer.json'],
+        binaries: ['php', 'composer'],
         async build(projectPath, manifest) {
+          const missingBinaries = this.binaries.filter(b => !checkBinary(b));
           return {
             id: `${projectPath}::php`,
             path: projectPath,
@@ -785,6 +816,7 @@ class SchemaRegistry {
             metadata: {},
             manifest: path.basename(manifest),
             description: '',
+            missingBinaries,
             extra: {
               setupHints: ['composer install to install dependencies']
             }
@@ -797,7 +829,9 @@ class SchemaRegistry {
         icon: '💎',
         priority: 65,
         files: ['Gemfile'],
+        binaries: ['ruby', 'bundle'],
         async build(projectPath, manifest) {
+          const missingBinaries = this.binaries.filter(b => !checkBinary(b));
           return {
             id: `${projectPath}::ruby`,
             path: projectPath,
@@ -812,6 +846,7 @@ class SchemaRegistry {
             metadata: {},
             manifest: path.basename(manifest),
             description: '',
+            missingBinaries,
             extra: {
               setupHints: ['bundle install to ensure gems are present']
             }
@@ -824,7 +859,9 @@ class SchemaRegistry {
         icon: '🔷',
         priority: 65,
         files: ['*.csproj'],
+        binaries: ['dotnet'],
         async build(projectPath, manifest) {
+          const missingBinaries = this.binaries.filter(b => !checkBinary(b));
           return {
             id: `${projectPath}::dotnet`,
             path: projectPath,
@@ -840,6 +877,7 @@ class SchemaRegistry {
             metadata: {},
             manifest: path.basename(manifest),
             description: '',
+            missingBinaries,
             extra: {
               setupHints: ['Install .NET SDK 8+', 'dotnet restore before running']
             }
@@ -852,7 +890,9 @@ class SchemaRegistry {
         icon: '🐚',
         priority: 50,
         files: ['Makefile', 'build.sh'],
+        binaries: ['make', 'sh'],
         async build(projectPath, manifest) {
+          const missingBinaries = this.binaries.filter(b => !checkBinary(b));
           return {
             id: `${projectPath}::shell`,
             path: projectPath,
@@ -867,6 +907,7 @@ class SchemaRegistry {
             metadata: {},
             manifest: path.basename(manifest),
             description: '',
+            missingBinaries,
             extra: {
               setupHints: ['Run make install if available', 'Ensure shell scripts are executable']
             }
@@ -879,6 +920,7 @@ class SchemaRegistry {
         icon: '🧰',
         priority: 10,
         files: ['README.md'],
+        binaries: [],
         async build(projectPath, manifest) {
           return {
             id: `${projectPath}::generic`,
@@ -891,6 +933,7 @@ class SchemaRegistry {
             metadata: {},
             manifest: path.basename(manifest),
             description: 'Detected via README or Makefile layout.',
+            missingBinaries: [],
             extra: {
               setupHints: ['Read the README for custom build instructions']
             }
@@ -1055,4 +1098,4 @@ const SCHEMA_GUIDE = schemaRegistry.getSchemas().map((schema) => ({
   files: schema.files
 }));
 
-export {discoverProjects, SCHEMA_GUIDE};
+export {discoverProjects, SCHEMA_GUIDE, checkBinary};