project-compass 2.3.0 → 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.0",
+  "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

@@ -121,13 +121,6 @@ function Compass({rootPath}) {
       const normalized = typeof line === 'string' ? line : JSON.stringify(line);
       const appended = [...prev, normalized];
       const next = appended.length > 250 ? appended.slice(appended.length - 250) : appended;
-      setLogOffset((prevOffset) => {
-        const maxScroll = Math.max(0, next.length - OUTPUT_WINDOW_SIZE);
-        if (prevOffset === 0) {
-          return 0;
-        }
-        return Math.min(maxScroll, prevOffset + 1);
-      });
       return next;
     });
   }, []);
@@ -263,7 +256,6 @@ 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')) {
@@ -306,11 +298,11 @@ function Compass({rootPath}) {
     }
 
     if (key.shift && key.upArrow) {
-      scrollLogs(1);
+      scrollLogs(-1);
       return;
     }
     if (key.shift && key.downArrow) {
-      scrollLogs(-1);
+      scrollLogs(1);
       return;
     }
 
@@ -371,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}`)
@@ -393,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) || '.'}`)
     );
@@ -407,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) => {
@@ -524,20 +536,20 @@ const projectRows = [];
       label: 'Navigation',
       color: 'magenta',
       body: [
-        '↑ / ↓ move the project focus',
-        'Enter toggles details view',
-        'Shift+↑ / ↓ scroll output buffer',
-        'Shift+H toggles help cards'
+        '↑ / ↓ move focus, Enter: details',
+        'Shift+↑ / ↓ scroll output',
+        'Shift+H toggle help cards',
+        '? opens the overlay help'
       ]
     },
     {
       label: 'Command flow',
       color: 'cyan',
       body: [
-        'B / T / R run build/test/run',
-        '1-9 execute detail commands',
-        'Shift+L reruns last command',
-        'Ctrl+C aborts; type feeds stdin'
+        'B / T / R build/test/run',
+        '1-9 run detail commands',
+        'Shift+L rerun last command',
+        'Ctrl+C abort; type feeds stdin'
       ]
     },
     {
@@ -545,7 +557,7 @@ const projectRows = [];
       color: 'yellow',
       body: [
         recentRuns.length ? `${recentRuns.length} runs recorded` : 'No runs yet · start with B/T/R',
-        'Shift+S toggles structure guide',
+        'Shift+S toggle structure guide',
         'Shift+C save custom action',
         'Shift+Q quit application'
       ]
@@ -609,10 +621,10 @@ const projectRows = [];
         },
         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, 'B/T/R run build/test/run; 1-9 executes detail commands; Ctrl+L reruns the previous command.'),
-        create(Text, null, 'Ctrl+H toggles these help cards, Ctrl+S toggles the structure guide, ? toggles this overlay, Ctrl+Q quits.'),
+        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, '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 (Ctrl+S to toggle).')
+        create(Text, null, 'Structure guide lists the manifests that trigger each language detection (Shift+S to toggle).')
       )
     : null;
 

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