project-compass 3.5.7 → 3.5.9

package/commands.md

@@ -7,19 +7,22 @@ This document lists all supported languages, frameworks, and their built-in comm
 | Key | Action |
 | --- | --- |
 | ↑ / ↓ | Move project focus |
-| Enter | Toggle detail view for selected project / Switch back from Tasks |
-| **Shift+A** | Open **Omni-Studio** (Environment intelligence) |
-| **Shift+T** | Open **Orbit Task Manager** |
+| Enter | Toggle deep detail view / Switch back from sub-views |
+| **Esc** | **Global Back**: Return to Main Navigator from any view |
+| **Shift+A** | Open **Omni-Studio** (Environment & Runtime audit) |
+| **Shift+T** | Open **Orbit Task Manager** (Manage background processes) |
+| **Shift+P** | Open **Package Registry** (Manage dependencies) |
+| **Shift+N** | Open **Project Architect** (Scaffold new projects) |
 | **Shift+D** | **Detach** from active task (runs in background) |
-| **Shift+B** | Toggle **Art Board** visibility (Saved to config) |
-| **Shift+H** | Toggle **Help Cards** visibility (Saved to config) |
-| **Shift+S** | Toggle **Structure Guide** visibility (Saved to config) |
+| **Shift+B** | Toggle **Art Board** Build Atlas (Saved to config) |
+| **Shift+H** | Toggle **Help Cards** UI (Saved to config) |
+| **Shift+S** | Toggle **Structure Guide** (Saved to config) |
 | **Shift+X** | **Clear** active task output logs |
 | **Shift+E** | **Export** logs to a timestamped `.txt` file |
 | **Shift+L** | **Rerun** the last executed command |
 | **Shift+C** | Add a **Custom Command** (`label|cmd`) in detail view |
 | **Shift+Q** | **Quit** application (Confirms if tasks are running) |
-| Shift+↑ / ↓ | Scroll output logs (Intuitive direction) |
+| Shift+↑ / ↓ | Scroll output logs |
 | ? | Toggle help overlay |
 | Ctrl+C | Interrupt running command |
 
@@ -40,8 +43,6 @@ Compass scans for the following manifests and requires their binaries in your PA
 
 ## Built-in Framework Intelligence
 
-When a framework is detected, specialized commands are injected automatically:
-
 | Framework | Icon | Commands |
 | --- | --- | --- |
 | **Next.js** | 🧭 | install, dev, build, test, start |
@@ -64,9 +65,22 @@ When a framework is detected, specialized commands are injected automatically:
 | **Prisma** | ◮ | install, generate, studio |
 | **Tailwind** | 🎨 | install |
 
-## Task Manager Shortcuts (Shift+T)
+## Orbit Task Manager Shortcuts (Shift+T)
 
-- **Shift+K**: Kill a running process or remove a finished task from history.
+- **Shift+K**: Kill a running process or remove a finished task.
 - **Shift+R**: Rename a task for better organization.
 - **Arrows**: Move focus between tasks.
-- **Enter**: Jump to the selected task's logs in Navigator.
+- **Enter / Shift+T**: Return to Navigator.
+
+## Package Registry Shortcuts (Shift+P)
+
+- **A**: Add a new package to the project.
+- **R**: Remove an existing package.
+- **S**: **Internal Switcher**: Quick-swap between detected projects.
+- **Esc / Shift+P**: Return to Navigator.
+
+## Project Architect Shortcuts (Shift+N)
+
+- **↑ / ↓**: Select a project template (Next.js, Vite, Rust, Go, etc.).
+- **Enter**: Confirm selection and move to next step.
+- **Esc / Shift+N**: Exit architect mode.

package/package.json

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

package/src/cli.js

@@ -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();