project-compass 1.0.8 → 1.0.10

package/README.md

@@ -7,7 +7,7 @@ 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+↑/↓ or mouse wheel scrolls logs, typing feeds stdin (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), L reruns the last command, H hides the cards, 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.
 - 🧠 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.
@@ -33,12 +33,12 @@ project-compass [--dir /path/to/workspace]
 | B / T / R | Run the workspace build/test/run shortcuts |
 | 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 (or use the mouse wheel) |
+| Shift ↑ / ↓ | Scroll the output buffer |
 | 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 |
-| Typing while running | Sends stdin to the running command (Enter submits, Ctrl+C aborts) |
+| 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 |
 
@@ -74,7 +74,7 @@ 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+↑/↓ 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; they start hidden by default—press H to reveal the cards and hide them again when you need more space. Press 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.
 
 ## Structure guide
 

package/package.json

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

@@ -840,7 +840,7 @@ function Compass({rootPath}) {
   const [customMode, setCustomMode] = useState(false);
   const [customInput, setCustomInput] = useState('');
   const [config, setConfig] = useState(() => loadConfig());
-  const [showHelpCards, setShowHelpCards] = useState(true);
+  const [showHelpCards, setShowHelpCards] = useState(false);
   const [showStructureGuide, setShowStructureGuide] = useState(false);
   const [stdinBuffer, setStdinBuffer] = useState('');
   const [showHelp, setShowHelp] = useState(false);
@@ -1244,27 +1244,25 @@ const projectRows = [];
     ? visibleLogs.map((line, index) => create(Text, {key: index}, line))
     : [create(Text, {dimColor: true}, 'Logs will appear here once you run a command.')];
 
-  
-  // Using global SCHEMA_GUIDE
-
-const helpCards = [
+  const helpCards = [
     {
       label: 'Navigation',
       color: 'magenta',
       body: [
-        '↑/↓ move projects, Enter toggles detail view',
-        'Shift+arrows scroll logs',
-        'H hides/shows cards, ? opens overlay'
+        '↑ / ↓ move the project focus',
+        'Enter toggles detail view',
+        'Shift + ↑ / ↓ scrolls the log buffer',
+        'H toggles cards, ? opens the overlay'
       ]
     },
     {
       label: 'Command flow',
       color: 'cyan',
       body: [
-        'B/T/R runs build/test/run quickly',
-        '1-9 execute detail commands',
-        'L reruns last command, Ctrl+C aborts',
-        'Type while running to feed stdin'
+        'B / T / R run build / test / run',
+        '1-9 execute the numbered detail commands',
+        'L reruns the last command',
+        'Ctrl+C aborts, typing feeds stdin (buffer mirrors text)'
       ]
     },
     {
@@ -1272,7 +1270,8 @@ const helpCards = [
       color: 'yellow',
       body: [
         recentRuns.length ? `${recentRuns.length} runs recorded` : 'No runs yet · start with B/T/R',
-        'Press S for structure guide when you doubt the project layout'
+        'Press S to show the structure guide',
+        'Save custom commands with C → label|cmd'
       ]
     }
   ];
@@ -1334,7 +1333,7 @@ const helpCards = [
         },
         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 (Enter submits, Ctrl+C aborts).'),
+        create(Text, null, 'Run commands and type to feed stdin (Enter submits, Ctrl+C aborts); the buffer shows what you type.'),
         create(Text, null, 'H hides/shows the navigation cards, S shows structure tips, and L reruns the previous command.'),
         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 S to toggle).')