project-compass 4.1.4 → 4.1.5

package/README.md

@@ -20,84 +20,48 @@ npm install -g project-compass
 
 ### 🌌 The Navigator (Main Interface)
 - **Automatic Discovery**: Instantly identifies **Node.js, Python, Rust, Go, Java, PHP, Ruby, .NET, and Shell/Make**.
-- **Paginated Control**: Optimized for massive workspaces. View projects in clean, manageable pages with **Page Up / Page Down** support.
-- **Configurable UI**: Customize your view with `maxVisibleProjects` and toggleable Art Boards and Help Cards.
+- **Paginated Control**: Optimized for massive workspaces. Jump through project pages with **Page Up / Page Down**.
+- **Configurable UI**: Customize your view with `maxVisibleProjects` (set to 2 or 3 for tight terminals).
 
-### 📦 Package Registry (`Shift+P`)
-- **Native Logic**: Automatically uses your project's preferred package manager (**npm, pnpm, yarn, bun, pip, cargo, composer, dotnet**). No more "command not found" errors.
-- **Internal Switcher**: Quick-swap between detected projects directly inside the registry.
+### 🤖 AI Horizon (`Shift+O` or `0`)
+- **Agentic Intelligence**: Real-world integration with **OpenRouter, Gemini, Claude, and Ollama**.
+- **DNA Mapping**: Automatically analyzes your project structure and **injects optimized BRIT commands** (Build, Run, Install, Test) into your config.
+- **Persistent Auth**: Save your API tokens once; Compass handles the secure handshake thereafter.
 
-### 🏗️ Project Architect (`Shift+N`)
-- **Modern Templates**: Scaffold high-performance projects with built-in support for **Bun, Next.js, Vite, Rust, and Django**.
+### 🔌 Infrastructure Control (`Shift+R`)
+- **Manual Port Mapping**: Directly assign specific ports to projects. Config is saved persistently to prevent conflicts.
+- **Metadata Awareness**: AI Horizon uses your manual port settings to suggest smarter deployment scripts.
 
-### 🔌 Manual Infrastructure
-- **Port Mapping**: Hit `Shift + R` in details to manually assign ports to projects. Settings are saved persistently.
+### 🛰️ Orbit Task Manager (`Shift+T`)
+- **Background Orchestration**: Keep tasks running while you navigate.
+- **Process Management**: Kill (`Shift+K`) or Rename (`Shift+R`) background tasks on the fly.
 
-### 🤖 AI Horizon (`Shift+O` or `0`)
-- **Intelligence Persistence**: Configure your provider (**OpenRouter, Gemini, Claude, Ollama**) once; Compass remembers your settings.
-- **Deep DNA Analysis**: Press `0` on any project to analyze its structure.
-- **Auto-Config (BRIT)**: AI automatically detects and configures missing **Build, Run, Install, and Test** commands, saving them directly to your `config.json`.
-- **Direct Access**: Launch straight into intelligence mode with `project-compass --ai`.
+### 📦 Package Registry (`Shift+P`)
+- **Context-Aware Management**: Automatically detects **npm, pnpm, yarn, bun, pip, cargo, composer, and dotnet**.
 
-## Command Reference
+### 🏗️ Project Architect (`Shift+N`)
+- **Rapid Scaffolding**: Create new projects from scratch using industry-standard templates.
+
+## ⌨️ Command Reference
 
 | Shortcut | Action |
 | :--- | :--- |
 | `↑ / ↓` | Move project focus |
+| `PgUp / PgDn`| Jump full project page |
 | `Enter` | Toggle project Detail View |
-| `B / T / R / I`| Macro: Build, Test, Run, **Install** |
+| `0` | Trigger **AI DNA Analysis** (Inside Details) |
+| `B / T / R / I`| Macro: Build, Test, Run, Install |
+| `Shift + R` | **Configure Port** (Inside Details) |
+| `Shift + O` | **AI Horizon** Dashboard |
 | `Shift + T` | **Orbit**: Task Manager |
 | `Shift + P` | **Registry**: Package Manager |
-| `Shift + N` | **Architect**: Project Creator |
-| `Shift + A` | **Studio**: Environment Health |
-| `Shift + B` | Toggle **Art Board** visibility |
-| `Shift + H` | Toggle **Help Cards** |
-| `Shift + S` | Toggle **Structure Guide** |
-| `Shift + Q` | Quit (with safe-exit confirmation) |
-| `?` | Toggle Help Overlay |
-
-### 🛡️ Safe Termination
-- **Process Protection**: Compass won't let you accidentally kill your work. If tasks are running, a dedicated confirmation dialog ensures you intended to quit.
-
-![Exit Confirmation](https://raw.githubusercontent.com/CrimsonDevil333333/project-compass/master/assets/screenshots/exit-confirm.jpg)
-
-## ⚙️ Configuration & Customization
-
-Project Compass is designed to be personalized. All settings and custom commands are stored in a local JSON file.
-
-- **Linux/macOS**: `~/.project-compass/config.json`
-- **Windows**: `C:\Users\<YourUser>\.project-compass\config.json`
-
-### 🛠️ Adding Custom Commands
-You can add your own project-specific commands directly within the app by pressing **Shift+C** in the Detail View. Use the format `Label|Command` (e.g., `Deploy|npm run deploy`).
-
-### 📁 Manual Config Structure
-If you prefer manual editing, the `config.json` follows this structure:
-
-```json
-{
-  "showArtBoard": true,
-  "showHelpCards": false,
-  "showStructureGuide": false,
-  "customCommands": {
-    "/path/to/your/project": [
-      {
-        "label": "Build Production",
-        "command": ["npm", "run", "build", "--prod"]
-      }
-    ]
-  }
-}
-```
+| `Shift + Q` | **Quit** (with terminal clear) |
 
-- `showArtBoard/HelpCards/Structure`: Persistence for your UI visibility preferences.
-- `customCommands`: A map of absolute project paths to arrays of command objects.
-
----
+## ⚙️ Configuration
 
-## 🚀 Vision
-Project Compass is designed to be the "Last Terminal Tool" you ever need to open. It bridges the gap between raw CLI commands and full IDEs, giving you a professional, reactive cockpit for all your development work.
+Edit `~/.project-compass/config.json` to customize:
+- `maxVisibleProjects`: How many rows per page.
+- `aiToken / aiModel`: Your intelligence credentials.
 
 ---
 **Crafted with ❤️ by Satyaa & Clawdy**
-*MIT License*

package/package.json

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

package/src/cli.js

@@ -482,25 +482,33 @@ function Compass({rootPath, initialView = 'navigator'}) {
     if (key.shift && key.upArrow) { scrollLogs(1); return; }
     if (key.shift && key.downArrow) { scrollLogs(-1); return; }
 
+    
     const pageLimit = config.maxVisibleProjects || 3;
-    const pageStep = Math.max(1, pageLimit);
+    const totalProjects = projects.length;
     
-    if (key.pageUp && projects.length > pageLimit) { 
-      console.clear(); 
+    if (key.pageUp && totalProjects > pageLimit) {
       setSelectedIndex((prev) => {
-        const next = prev - pageStep;
+        const next = prev - pageLimit;
         return next < 0 ? 0 : next;
-      }); 
-      return; 
+      });
+      console.clear();
+      return;
     }
-    if (key.pageDown && projects.length > pageLimit) { 
-      console.clear(); 
+    
+    if (key.pageDown && totalProjects > pageLimit) {
       setSelectedIndex((prev) => {
-        const next = prev + pageStep;
-        return next >= projects.length ? (Math.floor((projects.length - 1) / pageLimit) * pageLimit) : next;
-      }); 
-      return; 
+        const next = prev + pageLimit;
+        // If next jump exceeds project list, stay at the start of the last page
+        if (next >= totalProjects) {
+           const lastPageStart = Math.floor((totalProjects - 1) / pageLimit) * pageLimit;
+           return lastPageStart;
+        }
+        return next;
+      });
+      console.clear();
+      return;
     }
+    
 
     if (normalizedInput === '?') { console.clear(); setShowHelp((prev) => !prev); return; }
     if (shiftCombo('l') && lastCommandRef.current) { runProjectCommand(lastCommandRef.current.commandMeta, lastCommandRef.current.project); return; }