project-compass 4.0.3 → 4.0.4

package/commands.md

@@ -92,3 +92,10 @@ Compass scans for the following manifests and requires their binaries in your PA
     - Go (mod init)
 - **Enter**: Confirm selection and move to next step.
 - **Esc / Shift+N**: Exit architect mode.
+
+## Advanced Configuration
+
+You can manually edit the config file to change defaults:
+- **Location**: `~/.project-compass/config.json`
+- **maxVisibleProjects**: Adjust how many projects appear per page (default: 3).
+- **aiProvider / aiModel / aiToken**: Change your AI intelligence settings.

package/package.json

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

package/src/cli.js

@@ -294,7 +294,7 @@ function Compass({rootPath, initialView = 'navigator'}) {
 
     useInput((input, key) => {
     if (quitConfirm) {
-      if (input?.toLowerCase() === 'y') { killAllTasks(); console.clear(); exit(); return; }
+      if (input?.toLowerCase() === 'y') { killAllTasks(); process.stdout.write('\x1b[2J\x1b[0;0H'); exit(); return; }
       if (input?.toLowerCase() === 'n' || key.escape) { setQuitConfirm(false); return; }
       return;
     }
@@ -468,7 +468,7 @@ function Compass({rootPath, initialView = 'navigator'}) {
       return;
     }
     if (shiftCombo('q') || isCtrlC) {
-      if (hasRunningTasks) setQuitConfirm(true); else { console.clear(); exit(); }
+      if (hasRunningTasks) setQuitConfirm(true); else { process.stdout.write('\x1b[2J\x1b[0;0H'); exit(); }
       return;
     }
     
@@ -581,9 +581,9 @@ function Compass({rootPath, initialView = 'navigator'}) {
             create(Footer, {toggleHint, running, stdinBuffer, stdinCursor, CursorText})
           ),
           config.showHelpCards && create(Box, {key: 'help-cards', marginTop: 1, flexDirection: 'row', justifyContent: 'space-between', flexWrap: 'wrap'}, [
-            {label: 'Navigation', color: 'magenta', body: ['↑ / ↓ move focus, Enter: details', 'Shift+↑ / ↓ scroll output', 'Shift+H toggle help cards', 'Shift+D detach from task']},
+            {label: 'Navigation', color: 'magenta', body: ['↑/↓: focus, PgUp/Dn: Page, Enter: Details', 'Shift+↑ / ↓ scroll output', 'Shift+H toggle help cards', 'Shift+D detach from task']},
             {label: 'Management', color: 'cyan', body: ['Shift+P Package Registry', 'Shift+N Project Architect', 'Shift+X clear / Shift+E export']},
-            {label: 'Orbit & AI', color: 'yellow', body: ['Shift+T task manager', 'Shift+A studio / Shift+O AI Horizon', 'Shift+S structure / Shift+Q quit']}
+            {label: 'Orbit & AI', color: 'yellow', body: ['Shift+T: Tasks, Shift+O: AI, 0: Analyze', 'Shift+A studio / Shift+O AI Horizon', 'Shift+S structure / Shift+Q quit']}
           ].map((card, idx) => create(Box, {key: card.label, flexGrow: 1, flexBasis: 0, minWidth: HELP_CARD_MIN_WIDTH, marginRight: idx < 2 ? 1 : 0, marginBottom: 1, borderStyle: 'round', borderColor: card.color, padding: 1, flexDirection: 'column'}, create(Text, {color: card.color, bold: true, marginBottom: 1}, card.label), ...card.body.map((line, lidx) => create(Text, {key: lidx, dimColor: card.color === 'yellow'}, line))))),
           config.showStructureGuide && create(Box, {key: 'structure', flexDirection: 'column', borderStyle: 'round', borderColor: 'blue', marginTop: 1, padding: 1}, create(Text, {color: 'cyan', bold: true}, 'Structure guide · press Shift+S to hide'), ...SCHEMA_GUIDE.map(e => create(Text, {key: e.type, dimColor: true}, `• ${e.icon} ${e.label}: ${e.files.join(', ')}`))),
           showHelp && create(Box, {key: 'overlay', flexDirection: 'column', borderStyle: 'double', borderColor: 'cyan', marginTop: 1, padding: 1}, create(Text, {color: 'cyan', bold: true}, 'Help overlay'), create(Text, null, 'Shift+↑/↓ scrolls logs; Shift+X clears; Shift+E exports; Shift+A Studio; Shift+T Tasks; Shift+D Detach; Shift+B Toggle Art Board; Shift+P Packages; Shift+N Creator; Shift+O AI Horizon.'))
@@ -622,7 +622,6 @@ async function main() {
     return;
   }
   if (args.help) {
-    console.clear();
     console.log(kleur.bold(kleur.magenta('🧭 Project Compass · Premium Developer Cockpit')));
     console.log(kleur.dim('───────────────────────────────────────────────────'));
     console.log('');

package/src/components/AIHorizon.js

@@ -5,10 +5,10 @@ import {Box, Text, useInput} from 'ink';
 const create = React.createElement;
 
 const AI_PROVIDERS = [
-  { id: 'openrouter', name: 'OpenRouter', endpoint: 'https://openrouter.ai/api/v1', keyEnv: 'OPENROUTER_API_KEY' },
-  { id: 'gemini', name: 'Google Gemini', endpoint: 'https://generativelanguage.googleapis.com', keyEnv: 'GEMINI_API_KEY' },
-  { id: 'claude', name: 'Anthropic Claude', endpoint: 'https://api.anthropic.com', keyEnv: 'ANTHROPIC_API_KEY' },
-  { id: 'ollama', name: 'Ollama (Local)', endpoint: 'http://localhost:11434', keyEnv: 'NONE' }
+  { id: 'openrouter', name: 'OpenRouter', endpoint: 'https://openrouter.ai/api/v1' },
+  { id: 'gemini', name: 'Google Gemini', endpoint: 'https://generativelanguage.googleapis.com' },
+  { id: 'claude', name: 'Anthropic Claude', endpoint: 'https://api.anthropic.com' },
+  { id: 'ollama', name: 'Ollama (Local)', endpoint: 'http://localhost:11434' }
 ];
 
 const AIHorizon = memo(({selectedProject, CursorText, config, setConfig, saveConfig}) => {
@@ -18,6 +18,7 @@ const AIHorizon = memo(({selectedProject, CursorText, config, setConfig, saveCon
   const [token, setToken] = useState(config?.aiToken || '');
   const [cursor, setCursor] = useState(0);
   const [status, setStatus] = useState('ready');
+  const [suggestions, setSuggestions] = useState([]);
 
   useInput((input, key) => {
     if (step === 'provider') {
@@ -25,18 +26,14 @@ const AIHorizon = memo(({selectedProject, CursorText, config, setConfig, saveCon
       if (key.downArrow) setProviderIdx(p => (p + 1) % AI_PROVIDERS.length);
       if (key.return) {
         const nextConfig = { ...config, aiProvider: AI_PROVIDERS[providerIdx].id };
-        if (setConfig) setConfig(nextConfig);
-        if (saveConfig) saveConfig(nextConfig);
-        setStep('model');
-        setCursor(model.length);
+        setConfig(nextConfig); saveConfig(nextConfig);
+        setStep('model'); setCursor(model.length);
       }
     } else if (step === 'model') {
       if (key.return) {
         const nextConfig = { ...config, aiModel: model };
-        if (setConfig) setConfig(nextConfig);
-        if (saveConfig) saveConfig(nextConfig);
-        setStep('token');
-        setCursor(token.length);
+        setConfig(nextConfig); saveConfig(nextConfig);
+        setStep('token'); setCursor(token.length);
       }
       if (key.escape) setStep('provider');
       if (key.backspace || key.delete) {
@@ -47,8 +44,7 @@ const AIHorizon = memo(({selectedProject, CursorText, config, setConfig, saveCon
     } else if (step === 'token') {
       if (key.return) {
         const nextConfig = { ...config, aiToken: token };
-        if (setConfig) setConfig(nextConfig);
-        if (saveConfig) saveConfig(nextConfig);
+        setConfig(nextConfig); saveConfig(nextConfig);
         setStep('analyze');
       }
       if (key.escape) setStep('model');
@@ -61,31 +57,39 @@ const AIHorizon = memo(({selectedProject, CursorText, config, setConfig, saveCon
       if (key.return && status === 'ready' && selectedProject) {
         setStatus('busy');
         setTimeout(() => {
+          // REAL DNA MAPPING: Check project scripts and suggest real matches
+          const scripts = selectedProject.metadata?.scripts || {};
+          const suggested = [];
+          
+          if (scripts.build) suggested.push({ label: 'AI Build', command: ['npm', 'run', 'build'] });
+          if (scripts.start || scripts.dev) suggested.push({ label: 'AI Run', command: ['npm', 'run', scripts.dev ? 'dev' : 'start'] });
+          if (scripts.test) suggested.push({ label: 'AI Test', command: ['npm', 'test'] });
+          
+          // If no scripts found, suggest generic ones based on type
+          if (suggested.length === 0) {
+             if (selectedProject.type === 'Node.js') suggested.push({ label: 'AI Init', command: ['npm', 'install'] });
+             else if (selectedProject.type === 'Python') suggested.push({ label: 'AI Run', command: ['python', 'main.py'] });
+          }
+
+          setSuggestions(suggested);
           const projectKey = selectedProject.path;
           const currentCustom = config.customCommands?.[projectKey] || [];
           const nextConfig = { 
             ...config, 
-            customCommands: { 
-              ...config.customCommands, 
-              [projectKey]: [...currentCustom, { label: 'AI: Optimized Run', command: ['npm', 'run', 'dev'] }] 
-            } 
+            customCommands: { ...config.customCommands, [projectKey]: [...currentCustom, ...suggested] } 
           };
-          if (setConfig) setConfig(nextConfig);
-          if (saveConfig) saveConfig(nextConfig);
+          setConfig(nextConfig); saveConfig(nextConfig);
           setStatus('done');
-        }, 1000);
+        }, 1200);
       }
       if (input === 'r') {
-        const resetConfig = { ...config, aiToken: '' };
-        if (setConfig) setConfig(resetConfig);
-        if (saveConfig) saveConfig(resetConfig);
+        const nextConfig = { ...config, aiToken: '' };
+        setConfig(nextConfig); saveConfig(nextConfig);
         setStep('provider');
       }
     }
   });
 
-  const currentProvider = AI_PROVIDERS[providerIdx];
-
   return create(
     Box,
     {flexDirection: 'column', borderStyle: 'double', borderColor: 'magenta', padding: 1, width: '100%'},
@@ -95,7 +99,7 @@ const AIHorizon = memo(({selectedProject, CursorText, config, setConfig, saveCon
       Box,
       {flexDirection: 'column'},
       create(Text, {bold: true, marginBottom: 1}, 'Step 1: Select AI Infrastructure'),
-      ...AI_PROVIDERS.map((p, i) => create(Text, {key: p.id, color: i === providerIdx ? 'cyan' : 'white'}, (i === providerIdx ? '→ ' : '  ') + p.name + ' (' + p.endpoint + ')')),
+      ...AI_PROVIDERS.map((p, i) => create(Text, {key: p.id, color: i === providerIdx ? 'cyan' : 'white'}, (i === providerIdx ? '→ ' : '  ') + p.name)),
       create(Text, {dimColor: true, marginTop: 1}, 'Enter: Save & Next')
     ),
 
@@ -107,36 +111,36 @@ const AIHorizon = memo(({selectedProject, CursorText, config, setConfig, saveCon
         create(Text, null, 'Model ID: '),
         create(CursorText, {value: model, cursorIndex: cursor})
       ),
-      create(Text, {dimColor: true, marginTop: 1}, 'Enter: Save, Esc: Back')
+      create(Text, {dimColor: true, marginTop: 1}, 'Enter: Save Model, Esc: Back')
     ),
 
     step === 'token' && create(
       Box,
       {flexDirection: 'column'},
-      create(Text, {bold: true, color: 'red', marginBottom: 1}, 'Step 3: Secure API Authorization'),
-      create(Text, {dimColor: true}, 'Token required for ' + (currentProvider?.name || 'Provider')),
-      create(Box, {flexDirection: 'row', marginTop: 1},
-        create(Text, null, 'API Token: '),
+      create(Text, {bold: true, color: 'red', marginBottom: 1}, 'Step 3: API Token Authorization'),
+      create(Box, {flexDirection: 'row'},
+        create(Text, null, 'Token: '),
         create(CursorText, {value: '*'.repeat(token.length), cursorIndex: cursor})
       ),
-      create(Text, {dimColor: true, marginTop: 1}, 'Enter: Encrypt & Save, Esc: Back')
+      create(Text, {dimColor: true, marginTop: 1}, 'Enter: Save Token, Esc: Back')
     ),
 
     step === 'analyze' && create(
       Box,
       {flexDirection: 'column'},
-      create(Text, {bold: true, color: 'cyan', marginBottom: 1}, 'Intelligence Active: ' + (selectedProject ? selectedProject.name : 'Current Workspace')),
-      create(Text, {dimColor: true}, 'Provider: ' + (config.aiProvider || 'N/A') + ' | Model: ' + (config.aiModel || 'N/A')),
+      create(Text, {bold: true, color: 'cyan', marginBottom: 1}, 'Ready to analyze: ' + (selectedProject ? selectedProject.name : 'No project selected')),
+      create(Text, {dimColor: true}, 'Active: ' + config.aiProvider + ' (' + config.aiModel + ')'),
+      
       create(Box, {marginTop: 1, flexDirection: 'column'},
-        status === 'ready' && create(Text, null, 'Press Enter to perform DNA analysis and auto-configure BRIT commands.'),
-        status === 'busy' && create(Text, {color: 'yellow'}, ' ⏳ Accessing AI... Mapping manifests...'),
+        status === 'ready' && create(Text, null, 'Press Enter to map project DNA and auto-configure macros.'),
+        status === 'busy' && create(Text, {color: 'yellow'}, ' ⏳ Reading manifests... identifying build patterns...'),
         status === 'done' && create(Box, {flexDirection: 'column'},
           create(Text, {color: 'green', bold: true}, ' ✅ DNA Mapped!'),
-          create(Text, null, ' Intelligence has successfully injected optimized commands into your project config.'),
-          create(Text, {dimColor: true, marginTop: 1}, 'Press Esc to return to the Navigator.')
+          create(Text, null, ' Identified ' + suggestions.length + ' valid commands based on your workspace structure.'),
+          create(Text, {dimColor: true, marginTop: 1}, 'Return to Navigator to use BRIT shortcuts.')
         )
       ),
-      create(Text, {dimColor: true, marginTop: 1}, 'Esc: Back, R: Reset Credentials')
+      create(Text, {dimColor: true, marginTop: 1}, 'Esc: Return, R: Reset Credentials')
     )
   );
 });