project-compass 2.3.1 → 2.4.0

package/README.md

@@ -1,4 +1,4 @@
-# Project Compass (v2.3.0)
+# Project Compass (v2.4.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,7 @@ 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.
 - 🔌 **Extensible**: Add custom commands with **Shift+C** and frameworks via `plugins.json`.
 
 ## Installation

package/package.json

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

@@ -363,17 +363,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 +391,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 +410,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) => {

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']
             }