project-compass 2.0.1 → 2.0.2

package/README.md

@@ -79,7 +79,7 @@ Projects and details now occupy the same row, while the output panel takes its o
 
 ## Structure guide
 
-Press `S` to reveal the structure guide that lists which manifest files trigger each language detection (Node.js looks for `package.json`, Python looks for `pyproject.toml` or `requirements.txt`, Rust needs `Cargo.toml`, etc.). Use `H` to hide the help cards if you need every pixel for your output, then bring them back when you want a refresher.
+Press `Ctrl+S` to reveal the structure guide that lists which manifest files trigger each language detection (Node.js looks for `package.json`, Python looks for `pyproject.toml` or `requirements.txt`, Rust needs `Cargo.toml`, etc.). Use `Ctrl+H` to hide the help cards if you need every pixel for your output, then bring them back when you want a refresher.
 
 ## Detection & setup hints
 

package/package.json

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

@@ -524,9 +524,8 @@ const projectRows = [];
       label: 'Navigation',
       color: 'magenta',
       body: [
-        '↑ / ↓ move the project focus',
-        'Enter opens or closes details',
-        'Shift + ↑ / ↓ scrolls only the log buffer',
+        '↑ / ↓ move the project focus, Enter toggles details',
+        'Shift+↑ / Shift+↓ scroll only the output buffer',
         'Ctrl+H toggles cards, ? opens the overlay'
       ]
     },
@@ -534,10 +533,10 @@ const projectRows = [];
       label: 'Command flow',
       color: 'cyan',
       body: [
-        'B / T / R trigger build/test/run',
+        'B / T / R trigger build/test/run shortcuts',
         '1-9 execute detail commands in order',
         'Ctrl+L reruns the last command you launched',
-        'Ctrl+C aborts, typing feeds stdin (buffer mirrors it)'
+        'Ctrl+C aborts; typing feeds stdin (buffer mirrors it)'
       ]
     },
     {
@@ -545,8 +544,8 @@ const projectRows = [];
       color: 'yellow',
       body: [
         recentRuns.length ? `${recentRuns.length} runs recorded` : 'No runs yet · start with B/T/R',
-        'Ctrl+S shows the structure guide when unsure',
-        'Save custom commands with C → label|cmd'
+        'Ctrl+S toggles the structure guide when unsure',
+        'C → label|cmd saves a custom action'
       ]
     }
   ];
@@ -575,7 +574,7 @@ const projectRows = [];
           )
         )
       )
-    : create(Text, {dimColor: true, marginTop: 1}, 'Help cards hidden · press H to show navigation, command flow, and recent runs.');
+    : create(Text, {dimColor: true, marginTop: 1}, 'Help cards hidden · press Ctrl+H to show navigation, command flow, and recent runs.');
 
   const structureGuide = showStructureGuide
     ? create(
@@ -587,7 +586,7 @@ const projectRows = [];
           marginTop: 1,
           padding: 1
         },
-        create(Text, {color: 'cyan', bold: true}, 'Project structure guide · press S to hide'),
+        create(Text, {color: 'cyan', bold: true}, 'Project structure guide · press Ctrl+S to hide'),
         ...SCHEMA_GUIDE.map((entry) =>
           create(Text, {key: entry.type, dimColor: true}, `• ${entry.icon} ${entry.label}: ${entry.files.join(', ')}`)
         ),
@@ -606,18 +605,18 @@ const projectRows = [];
           padding: 1
         },
         create(Text, {color: 'cyan', bold: true}, 'Help overlay · press ? to hide'),
-        create(Text, null, 'Shift+arrows scroll the output buffer.'),
-        create(Text, null, 'Run commands and type to feed stdin (buffer mirrors your keystrokes, Enter submits, Ctrl+C aborts).'),
-        create(Text, null, 'Ctrl+H toggles the navigation cards, Ctrl+S shows structure tips, Ctrl+L reruns the previous command, Ctrl+Q quits.'),
-        create(Text, null, 'Projects + Details stay side-by-side while Output and the log buffer stay fixed in their own band.'),
-        create(Text, null, 'Structure guide lists the manifests that trigger each language detection (press Ctrl+S to toggle).')
+        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, '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).')
       )
     : null;
 
   const toggleHint = showHelpCards ? 'Ctrl+H hides the help cards' : 'Ctrl+H shows the help cards';
   const headerHint = viewMode === 'detail'
-    ? `Detail mode · 1-${Math.max(detailedIndexed.length, 1)} to execute, C: add custom commands, Enter: back to list, Ctrl+Q: quit · ${toggleHint}, Ctrl+S shows structure guide`
-    : `Quick run · B/T/R to build/test/run, Enter: view details, Ctrl+Q: quit · ${toggleHint}, Ctrl+S shows structure guide`;
+    ? `Detail mode · 1-${Math.max(detailedIndexed.length, 1)} to execute, C: add custom commands, Enter: back to list, Ctrl+Q: quit · ${toggleHint}, Ctrl+S toggles structure guide`
+    : `Quick run · B/T/R to build/test/run, Enter: view details, Ctrl+Q: quit · ${toggleHint}, Ctrl+S toggles structure guide`;
 
   return create(
     Box,
@@ -702,7 +701,7 @@ const projectRows = [];
         Box,
         {marginTop: 1, flexDirection: 'row', justifyContent: 'space-between'},
         create(Text, {dimColor: true}, running ? 'Type to feed stdin; Enter submits, Ctrl+C aborts.' : 'Run a command or press ? for extra help.'),
-        create(Text, {dimColor: true}, `${toggleHint}, S toggles the structure guide`)
+        create(Text, {dimColor: true}, `${toggleHint}, Ctrl+S toggles the structure guide`)
       ),
       create(
         Box,

package/src/projectDetection.js

@@ -5,6 +5,12 @@ import {ensureConfigDir, PLUGIN_FILE} from './configPaths.js';
 
 const IGNORE_PATTERNS = ['**/node_modules/**', '**/.git/**', '**/dist/**', '**/build/**', '**/target/**'];
 
+const PYTHON_ENTRY_FILES = ['main.py', 'app.py', 'src/main.py', 'src/app.py'];
+
+function findPythonEntry(projectPath) {
+  return PYTHON_ENTRY_FILES.find((file) => hasProjectFile(projectPath, file)) || null;
+}
+
 function hasProjectFile(projectPath, file) {
   return fs.existsSync(path.join(projectPath, file));
 }
@@ -316,10 +322,14 @@ const builtInFrameworks = [
     languages: ['Python'],
     priority: 105,
     match(project) {
-      return dependencyMatches(project, 'flask') || hasProjectFile(project.path, 'app.py');
+      const entry = findPythonEntry(project.path);
+      return Boolean(entry && dependencyMatches(project, 'flask'));
     },
     commands(project) {
-      const entry = hasProjectFile(project.path, 'app.py') ? 'app.py' : 'main.py';
+      const entry = findPythonEntry(project.path);
+      if (!entry) {
+        return {};
+      }
       return {
         run: {label: 'Flask app', command: ['python', entry], source: 'framework'},
         test: {label: 'Pytest', command: ['pytest'], source: 'framework'}
@@ -334,12 +344,17 @@ const builtInFrameworks = [
     languages: ['Python'],
     priority: 105,
     match(project) {
-      return dependencyMatches(project, 'fastapi');
+      const entry = findPythonEntry(project.path);
+      return Boolean(entry && dependencyMatches(project, 'fastapi'));
     },
     commands(project) {
-      const entry = hasProjectFile(project.path, 'main.py') ? 'main.py' : 'app.py';
+      const entry = findPythonEntry(project.path);
+      if (!entry) {
+        return {};
+      }
+      const moduleName = entry.split('.').slice(0, -1).join('.') || entry;
       return {
-        run: {label: 'Uvicorn reload', command: ['uvicorn', `${entry.split('.')[0]}:app`, '--reload'], source: 'framework'},
+        run: {label: 'Uvicorn reload', command: ['uvicorn', `${moduleName}:app`, '--reload'], source: 'framework'},
         test: {label: 'Pytest', command: ['pytest'], source: 'framework'}
       };
     }
@@ -458,7 +473,7 @@ class SchemaRegistry {
             commands.test = {label: 'Unittest', command: ['python', '-m', 'unittest', 'discover']};
           }
 
-          const entry = this.findPythonEntry(projectPath);
+          const entry = findPythonEntry(projectPath);
           if (entry) {
             commands.run = {label: 'Run', command: ['python', entry]};
           }
@@ -492,15 +507,6 @@ class SchemaRegistry {
             }
           };
         },
-        findPythonEntry(projectPath) {
-          const candidates = ['main.py', 'app.py', 'src/main.py', 'src/app.py'];
-          for (const candidate of candidates) {
-            if (hasProjectFile(projectPath, candidate)) {
-              return candidate;
-            }
-          }
-          return null;
-        }
       },
       {
         type: 'rust',