project-compass 4.0.3 → 4.0.5

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.5",
   "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;
     }
@@ -451,10 +451,11 @@ function Compass({rootPath, initialView = 'navigator'}) {
     if (key.shift && key.upArrow) { scrollLogs(1); return; }
     if (key.shift && key.downArrow) { scrollLogs(-1); return; }
 
-    const pageStep = Math.max(1, config.maxVisibleProjects || 3);
+    const pageLimit = config.maxVisibleProjects || 3;
+    const pageStep = Math.max(1, pageLimit);
     const clampIndex = (value) => Math.max(0, Math.min(projects.length - 1, value));
-    if (key.pageUp && projects.length > 0) { console.clear(); setSelectedIndex((prev) => clampIndex(prev - pageStep)); return; }
-    if (key.pageDown && projects.length > 0) { console.clear(); setSelectedIndex((prev) => clampIndex(prev + pageStep)); return; }
+    if (key.pageUp && projects.length > pageLimit) { console.clear(); setSelectedIndex((prev) => clampIndex(prev - pageStep)); return; }
+    if (key.pageDown && projects.length > pageLimit) { console.clear(); setSelectedIndex((prev) => clampIndex(prev + pageStep)); return; }
 
     if (normalizedInput === '?') { console.clear(); setShowHelp((prev) => !prev); return; }
     if (shiftCombo('l') && lastCommandRef.current) { runProjectCommand(lastCommandRef.current.commandMeta, lastCommandRef.current.project); return; }
@@ -468,7 +469,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 +582,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 +623,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

@@ -1,14 +1,14 @@
-/* global setTimeout */
+/* global setTimeout, fetch */
 import React, {useState, memo} from 'react';
 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/chat/completions' },
+  { id: 'gemini', name: 'Google Gemini', endpoint: 'https://generativelanguage.googleapis.com/v1beta/models/{model}:generateContent' },
+  { id: 'claude', name: 'Anthropic Claude', endpoint: 'https://api.anthropic.com/v1/messages' },
+  { id: 'ollama', name: 'Ollama (Local)', endpoint: 'http://localhost:11434/api/generate' }
 ];
 
 const AIHorizon = memo(({selectedProject, CursorText, config, setConfig, saveConfig}) => {
@@ -18,6 +18,83 @@ 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 [error, setError] = useState(null);
+  const [suggestions, setSuggestions] = useState([]);
+
+  const runRealAnalysis = async () => {
+    setStatus('busy');
+    setError(null);
+    const provider = AI_PROVIDERS[providerIdx];
+    
+    try {
+      const projectData = JSON.stringify({
+        name: selectedProject.name,
+        type: selectedProject.type,
+        manifest: selectedProject.manifest,
+        scripts: selectedProject.metadata?.scripts || {},
+        dependencies: selectedProject.metadata?.dependencies || []
+      });
+
+      const prompt = `Analyze this project structure and suggest valid CLI commands for:
+1. Build
+2. Run
+3. Install
+4. Test
+
+Project Data: ${projectData}
+
+Return ONLY a JSON object with this structure: {"build": "cmd", "run": "cmd", "install": "cmd", "test": "cmd"}. 
+Use the project's detected type (${selectedProject.type}) to ensure commands are correct (e.g., npm, pip, cargo).`;
+
+      let response;
+      if (provider.id === 'openrouter') {
+        response = await fetch(provider.endpoint, {
+          method: 'POST',
+          headers: { 
+            'Authorization': `Bearer ${token}`,
+            'Content-Type': 'application/json',
+            'HTTP-Referer': 'https://github.com/CrimsonDevil333333/project-compass',
+            'X-Title': 'Project Compass'
+          },
+          body: JSON.stringify({
+            model: model,
+            messages: [{ role: 'user', content: prompt }]
+          })
+        });
+      } else {
+        // Fallback for others or throw unimplemented for now to avoid "fake" results
+        throw new Error(`Real-time agentic analysis for ${provider.name} is arriving in the next patch. Use OpenRouter for live testing now.`);
+      }
+
+      const data = await response.json();
+      if (!response.ok) throw new Error(data.error?.message || 'Authentication failed. Check your token.');
+
+      const aiText = data.choices[0].message.content;
+      const jsonMatch = aiText.match(/{.*?}/s);
+      if (!jsonMatch) throw new Error("AI returned invalid DNA mapping. Try a different model.");
+      
+      const parsed = JSON.parse(jsonMatch[0]);
+      const mapped = [
+        { label: 'AI Build', command: parsed.build.split(' ') },
+        { label: 'AI Run', command: parsed.run.split(' ') },
+        { label: 'AI Install', command: parsed.install.split(' ') },
+        { label: 'AI Test', command: parsed.test.split(' ') }
+      ];
+
+      setSuggestions(mapped);
+      const projectKey = selectedProject.path;
+      const currentCustom = config.customCommands?.[projectKey] || [];
+      const nextConfig = { 
+        ...config, 
+        customCommands: { ...config.customCommands, [projectKey]: [...currentCustom, ...mapped] } 
+      };
+      setConfig(nextConfig); saveConfig(nextConfig);
+      setStatus('done');
+    } catch (err) {
+      setError(err.message);
+      setStatus('ready');
+    }
+  };
 
   useInput((input, key) => {
     if (step === 'provider') {
@@ -25,18 +102,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 +120,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');
@@ -59,33 +131,16 @@ const AIHorizon = memo(({selectedProject, CursorText, config, setConfig, saveCon
       }
     } else if (step === 'analyze') {
       if (key.return && status === 'ready' && selectedProject) {
-        setStatus('busy');
-        setTimeout(() => {
-          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'] }] 
-            } 
-          };
-          if (setConfig) setConfig(nextConfig);
-          if (saveConfig) saveConfig(nextConfig);
-          setStatus('done');
-        }, 1000);
+        runRealAnalysis();
       }
       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 +150,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 +162,37 @@ 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 perform real agentic analysis and auto-configure macros.'),
+        status === 'busy' && create(Text, {color: 'yellow'}, ' ⏳ Contacting AI Agent... mapping project structure...'),
         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, {color: 'green', bold: true}, ' ✅ DNA Mapped via AI Agent!'),
+          create(Text, null, ' Successfully injected ' + suggestions.length + ' optimized commands into project config.'),
+          create(Text, {dimColor: true, marginTop: 1}, 'Return to Navigator to use BRIT shortcuts.')
+        ),
+        error && create(Text, {color: 'red', bold: true, marginTop: 1}, ' ✗ AI ERROR: ' + error)
       ),
-      create(Text, {dimColor: true, marginTop: 1}, 'Esc: Back, R: Reset Credentials')
+      create(Text, {dimColor: true, marginTop: 1}, 'Esc: Return, R: Reset Credentials')
     )
   );
 });