project-compass 1.0.9 → 2.0.0

package/README.md

@@ -7,8 +7,9 @@ Project Compass is a futuristic CLI navigator built with [Ink](https://github.co
 - 🔍 Scans directories for Node.js, Python, Rust, Go, Java, and Scala projects by looking at their manifest files.
 - 🎨 Combines the glyph-based art board with a Projects/Details row that keeps everything inside the viewport, while live stdout/stderr logs stay in their own band below.
 - 🚀 Press **Enter** on any project to open the detail view, where you can inspect the type, manifest, frameworks, commands, and save custom actions.
-- 💡 A dedicated output row with an interactive stdin buffer, plus help tiles that stay in their own band; Shift+↑/↓ scrolls the log window, typing feeds stdin (buffer shows what you type, Enter submits, Ctrl+C aborts), L reruns the last command, H hides the cards, S opens the structure guide, and `?` pops an overlay with quick tips.
+- 💡 A dedicated output row with an interactive stdin buffer, plus help tiles that stay in their own band; Shift+↑/↓ scrolls the log window, typing feeds stdin (buffer shows what you type, Enter submits, Ctrl+C aborts), Ctrl+L reruns the last command, Ctrl+H shows/hides the help cards, Ctrl+S opens the structure guide, and `?` pops an overlay with quick tips.
 - 🎯 Built-in shortcuts (B/T/R) run the canonical build/test/run workflow, while numeric hotkeys (1, 2, 3...) execute whichever command is listed in the detail view.
+- 🧠 Modular detection now scans for Node, Python, Rust, Go, Java, Scala, PHP, Ruby, .NET, shell/Makefile projects plus custom workspaces, and surface setup hints (npm install, pip install, cargo fetch, etc.).
 - 🧠 Add bespoke commands via **C** in detail view and store them globally (`~/.project-compass/config.json`) so every workspace remembers your favorite invocations.
 - 🔌 Extend detection via plugins (JSON specs under `~/.project-compass/plugins.json`) to teach Project Compass about extra frameworks or command sets.
 - 📦 Install globally and invoke `project-compass` from any folder to activate the UI instantly.
@@ -34,13 +35,13 @@ project-compass [--dir /path/to/workspace]
 | 1‑9 | Execute the numbered commands listed in detail view |
 | C | Add a custom command (`label|cmd`) that saves to `~/.project-compass/config.json` |
 | Shift ↑ / ↓ | Scroll the output buffer |
-| L | Rerun the most recent command |
+| Ctrl+L | Rerun the most recent command |
 | ? | Toggle the help overlay with navigation tips |
-| h | Hide/show the navigation/help cards beneath the logs |
-| s | Toggle the structure guide listing the manifests per language |
+| Ctrl+H | Show/hide the navigation/help cards beneath the logs |
+| Ctrl+S | Toggle the structure guide listing the manifests per language |
+| Ctrl+Q | Quit the app |
 | Typing while running | Sends stdin to the running command (buffer shows the text, Enter submits, Ctrl+C aborts) |
 | Ctrl+C | Interrupt a running command (works while streaming output) |
-| Q | Quit |
 
 ## Framework & plugin support
 
@@ -74,13 +75,18 @@ Project Compass now opens with a rounded art board that shuffles your glyph row
 
 ## Layout, output & help
 
-Projects and details now occupy the same row, while the output panel takes its own full-width band beneath so long logs no longer stretch the rest of the UI. The output pane scrolls independently (Shift+↑/↓ or mouse wheel), feeds keystrokes into stdin while a command runs (type like normal, Enter submits, Ctrl+C aborts), and the buffer below shows exactly what you are typing. A trio of help tiles highlights navigation cues, command flow, and recent runs; press H to hide/show those tiles if you need more space, S to open the structure guide that lists the manifest files for each language detection, `?` to open the overlay with extra tips, and L to rerun the previous command.
+Projects and details now occupy the same row, while the output panel takes its own full-width band beneath so long logs no longer stretch the rest of the UI. The output pane scrolls independently (Shift+↑/↓), feeds keystrokes into stdin while a command runs (type like normal, Enter submits, Ctrl+C aborts), and the buffer below shows exactly what you are typing. A trio of help tiles highlights navigation cues, command flow, and recent runs; they stay hidden by default—press Ctrl+H to reveal the cards, Ctrl+S to show the structure guide that lists the manifest files for each language detection, `?` to open the overlay with extra tips, Ctrl+L to rerun the previous command, and Ctrl+Q to quit.
 
 ## 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.
 
 
+## Project detection & setup hints
+
+Project Compass now points at a dedicated detection module (`src/projectDetection.js`). It runs a set of SCHEMAS that look for Node.js, Python, Rust, Go, Java, Scala, PHP, Ruby, .NET, and shell/Makefile projects (plus a generic fallback), and it discovers any plugins you drop under `~/.project-compass/plugins.json`. Each detected project carries `setupHints` (e.g., `npm install`, `pip install -r requirements.txt`, `cargo fetch`) so you know what to do before running the commands listed in the detail view.
+
+
 ## Developer notes
 
 - `npm start` launches the Ink UI in the current directory.

package/package.json

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