project-compass 3.5.6 → 3.5.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "project-compass",
-  "version": "3.5.6",
+  "version": "3.5.8",
   "description": "Futuristic project navigator and runner for Node, Python, Rust, and Go",
   "main": "src/cli.js",
   "bin": {

package/src/cli.js

@@ -366,15 +366,15 @@ function Compass({rootPath, initialView = 'navigator'}) {
       setShowHelp(false);
     };
     
-    if (shiftCombo('h')) { setConfig(prev => { const next = {...prev, showHelpCards: !prev.showHelpCards}; saveConfig(next); return next; }); return; }
-    if (shiftCombo('s')) { setConfig(prev => { const next = {...prev, showStructureGuide: !prev.showStructureGuide}; saveConfig(next); return next; }); return; }
+    if (shiftCombo('h')) { console.clear(); setConfig(prev => { const next = {...prev, showHelpCards: !prev.showHelpCards}; saveConfig(next); return next; }); return; }
+    if (shiftCombo('s')) { console.clear(); setConfig(prev => { const next = {...prev, showStructureGuide: !prev.showStructureGuide}; saveConfig(next); return next; }); return; }
     if (shiftCombo('a')) { clearAndSwitch(mainView === 'navigator' ? 'studio' : 'navigator'); return; }
     if (shiftCombo('p')) { clearAndSwitch(mainView === 'navigator' ? 'registry' : 'navigator'); return; }
     if (shiftCombo('n')) { clearAndSwitch(mainView === 'navigator' ? 'architect' : 'navigator'); return; }
-    if (shiftCombo('x')) { setTasks(prev => prev.map(t => t.id === activeTaskId ? {...t, logs: []} : t)); setLogOffset(0); return; }
+    if (shiftCombo('x')) { console.clear(); setTasks(prev => prev.map(t => t.id === activeTaskId ? {...t, logs: []} : t)); setLogOffset(0); return; }
     if (shiftCombo('e')) { exportLogs(); return; }
-    if (shiftCombo('d')) { setActiveTaskId(null); return; }
-    if (shiftCombo('b')) { setConfig(prev => { const next = {...prev, showArtBoard: !prev.showArtBoard}; saveConfig(next); return next; }); return; }
+    if (shiftCombo('d')) { console.clear(); setActiveTaskId(null); return; }
+    if (shiftCombo('b')) { console.clear(); setConfig(prev => { const next = {...prev, showArtBoard: !prev.showArtBoard}; saveConfig(next); return next; }); return; }
     
     if (shiftCombo('t')) { 
       setMainView((prev) => {
@@ -444,11 +444,11 @@ function Compass({rootPath, initialView = 'navigator'}) {
     if (key.shift && key.upArrow) { scrollLogs(1); return; }
     if (key.shift && key.downArrow) { scrollLogs(-1); return; }
 
-    if (normalizedInput === '?') { setShowHelp((prev) => !prev); return; }
+    if (normalizedInput === '?') { console.clear(); setShowHelp((prev) => !prev); return; }
     if (shiftCombo('l') && lastCommandRef.current) { runProjectCommand(lastCommandRef.current.commandMeta, lastCommandRef.current.project); return; }
 
-    if (key.upArrow && !key.shift && projects.length > 0) { setSelectedIndex((prev) => (prev - 1 + projects.length) % projects.length); return; }
-    if (key.downArrow && !key.shift && projects.length > 0) { setSelectedIndex((prev) => (prev + 1) % projects.length); return; }
+    if (key.upArrow && !key.shift && projects.length > 0) { console.clear(); setSelectedIndex((prev) => (prev - 1 + projects.length) % projects.length); return; }
+    if (key.downArrow && !key.shift && projects.length > 0) { console.clear(); setSelectedIndex((prev) => (prev + 1) % projects.length); return; }
     if (key.return) {
       if (!selectedProject) return;
       console.clear();
@@ -629,43 +629,40 @@ async function main() {
     return;
   }
   if (args.help) {
-    console.log(kleur.cyan('Project Compass · Ink project navigator/runner'));
+    console.clear();
+    console.log(kleur.magenta.bold('🧭 Project Compass · Premium Developer Cockpit'));
+    console.log(kleur.dim('───────────────────────────────────────────────────'));
     console.log('');
     console.log(kleur.bold('Usage:'));
     console.log('  project-compass [--dir <path>] [--studio]');
     console.log('');
-    console.log(kleur.bold('Arguments:'));
-    console.log('  --dir, --path <path>  Specify root workspace directory to scan');
-    console.log('  --studio              Launch directly into Omni-Studio mode');
-    console.log('  --help, -h            Show this help menu');
+    console.log(kleur.cyan.bold('🌌 Core Views:'));
+    console.log('  Shift+T  ' + kleur.bold('Orbit Task Manager') + '  - Manage background processes & stream logs');
+    console.log('  Shift+P  ' + kleur.bold('Package Registry') + '    - Direct dependency management (add/remove)');
+    console.log('  Shift+N  ' + kleur.bold('Project Architect') + '   - Scaffold new projects from templates');
+    console.log('  Shift+A  ' + kleur.bold('Omni-Studio') + '         - Environment & runtime health audit');
     console.log('');
-    console.log(kleur.bold('Core Keybinds:'));
-    console.log('  ↑ / ↓                 Move project focus');
-    console.log('  Enter                 Toggle detail view for selected project');
-    console.log('  Shift+A               Switch to Omni-Studio (Environment Health)');
-    console.log('  Shift+T               Open Orbit Task Manager (Manage background processes)');
-    console.log('  Shift+P               Open Package Registry (Add/Remove packages)');
-    console.log('  Shift+N               Open Project Architect (Scaffold new projects)');
-    console.log('  Shift+D               Detach from active task (Keep it running in background)');
-    console.log('  Shift+B               Toggle Art Board visibility');
-    console.log('  Shift+H               Toggle Help Cards visibility');
-    console.log('  Shift+S               Toggle Structure Guide visibility');
-    console.log('  Shift+X               Clear active task output log');
-    console.log('  Shift+E               Export current logs to a .txt file');
-    console.log('  Shift+↑ / ↓           Scroll the output logs');
-    console.log('  Shift+Q               Quit application (with confirmation if tasks run)');
+    console.log(kleur.yellow.bold('🎮 Navigation & Details:'));
+    console.log('  ↑ / ↓    Move focus through discovered projects');
+    console.log('  Enter    Toggle deep detail view (manifests, scripts, frameworks)');
+    console.log('  Shift+C  Add a persistent custom command to the focused project');
+    console.log('  1-9      Quick-run numbered scripts in detail view');
+    console.log('  B/T/R    Macro run: Build / Test / Run');
     console.log('');
-    console.log(kleur.bold('Task Manager (Shift+T):'));
-    console.log('  Shift+K               Kill active/selected task');
-    console.log('  Shift+R               Rename selected task');
+    console.log(kleur.green.bold('🛠️ Workspace Tools:'));
+    console.log('  Shift+B  Toggle Art-coded Build Atlas');
+    console.log('  Shift+S  Toggle Directory Structure Guide');
+    console.log('  Shift+H  Toggle Navigation Help Cards');
+    console.log('  Shift+↑/↓ Scroll the live output log window');
+    console.log('  Shift+X  Clear active log buffer');
+    console.log('  Shift+E  Export current session logs to .txt');
     console.log('');
-    console.log(kleur.bold('Execution shortcuts:'));
-    console.log('  B / T / R             Quick run: Build / Test / Run');
-    console.log('  1-9 / S+A-Z           Run numbered commands in detail view');
-    console.log('  Shift+L               Rerun the last executed command');
-    console.log('  Shift+C               Add a custom command (in detail view)');
+    console.log(kleur.red.bold('🚪 System:'));
+    console.log('  Shift+Q  Quit application (triggers confirmation if tasks are running)');
+    console.log('  Esc      Global "Back" key to return to Main Navigator');
     console.log('');
     console.log(kleur.dim('Documentation: https://github.com/CrimsonDevil333333/project-compass'));
+    console.log(kleur.magenta('Crafted for performance by Satyaa & Clawdy'));
     return;
   }
   const rootPath = args.root ? path.resolve(args.root) : process.cwd();