project-compass 4.1.8 → 4.2.0

package/AGENTS.md

@@ -3,34 +3,32 @@
 Welcome to Project Compass. This file provides context for AI agents (Clawdy, Claude, Copilot, etc.) working on this repository.
 
 ## Overview
-Project Compass is a futuristic project navigator and runner designed for modern polyglot development (Node.js, Python, Rust, Go). It provides a high-fidelity terminal UI (using Ink) to manage complex workspaces.
+Project Compass is a futuristic project navigator and runner designed for modern polyglot development. It provides a high-fidelity terminal UI (using Ink) to manage complex workspaces with integrated Agentic AI intelligence.
 
 ## Project Structure
-- `src/cli.js`: Entry point. Handles argument parsing and the main Ink UI loop.
-- `src/projectDetection.js`: Logic for identifying projects and their frameworks.
+- `src/cli.js`: Entry point. Handles argument parsing, global input, and the main Ink UI loop.
+- `src/projectDetection.js`: Orchestrator for identifying projects.
+- `src/detectors/`: Modular detection logic for Node, Python, Rust, Go, Java, PHP, Ruby, and .NET.
 - `src/components/`: React/Ink components for the TUI.
+  - `AIHorizon.js`: [NEW] Agentic AI intelligence suite (OpenRouter, Gemini, Claude, Ollama).
+  - `Navigator.js`: Paginated project navigator with strict boundary guards.
   - `TaskManager.js`: Orbit Task Manager (background processes).
-  - `PackageRegistry.js`: Dependency management interface.
+  - `PackageRegistry.js`: Native dependency management interface.
   - `ProjectArchitect.js`: Scaffolding and templates.
-  - `Studio.js`: Omni-Studio health audit.
-- `assets/`: UI-related assets (screenshots, etc.).
+- `assets/`: UI-related screenshots and branding.
 
 ## Tech Stack
 - **Runtime:** Node.js (ESM)
 - **UI Framework:** [Ink](https://github.com/vadimdemedes/ink) (React for CLI)
-- **Styling:** `kleur` (Note: Use `kleur.bold(kleur.magenta('text'))` instead of chained `.magenta.bold`)
+- **Styling:** `kleur`
 - **Execution:** `execa` for robust subprocess management.
+- **Intelligence:** Native `fetch` for agentic API handshakes.
 
 ## Development Rules
 1. **Zero Mock Data:** Always aim for live system/project data.
-2. **ESM Only:** The project uses `"type": "module"`. Use `import/export`.
-3. **UI Consistency:** Keep the "Futuristic Cockpit" aesthetic (use symbols, borders, and dim colors where appropriate).
-4. **Performance:** Heavy operations (like workspace-wide globbing) should be optimized or backgrounded.
-
-## Common Tasks
-- `npm start`: Launch the navigator.
-- `npm run lint`: Check code style.
-- `npm version <patch|minor|major>`: Update version and sync with npm.
+2. **ESM Only:** Use `import/export`.
+3. **Paging Rules:** Use the hard-coded `maxVisibleProjects` (current default: 3) for navigation logic.
+4. **Port Logic:** Respect `projectMeta` in `config.json` for manual port assignments.
 
 ---
 *Created for the CrimsonDevil333333 Ecosystem.*

package/ARCHITECTURE.md

@@ -4,9 +4,9 @@ This document describes the high-level architecture of Project Compass.
 
 ## Data Flow
 1.  **Initialization:** `cli.js` resolves the working directory (defaults to current folder).
-2.  **Discovery:** `projectDetection.js` performs a high-speed glob search for common manifest files (`package.json`, `cargo.toml`, `go.mod`, etc.).
+2.  **Discovery:** `projectDetection.js` orchestrates modular detectors in `src/detectors/` to perform a high-speed glob search for common manifest files (`package.json`, `cargo.toml`, `go.mod`, etc.).
 3.  **State Management:** The discovered projects and their metadata (frameworks, scripts, dependencies) are passed into an Ink React tree.
-4.  **Rendering:** Components in `src/components` handle specific views (Task Manager, Architect, etc.) based on user keypresses.
+4.  **Rendering:** Components in `src/components` handle specific views (Task Manager, Architect, AI Horizon, etc.) based on user keypresses.
 5.  **Execution:** User-triggered scripts (like running `npm test`) are managed by `TaskManager.js` using `execa` with streaming logs.
 
 ## Design Patterns

package/CONTRIBUTING.md

@@ -13,7 +13,7 @@ This repository is "AI-First." Always update `AGENTS.md` after making structural
 ## Workflow
 1.  **Fork and Branch:** Create a branch for your feature or fix.
 2.  **Code Style:** Follow the existing ESM pattern.
-3.  **Testing:** Run `npm start` in a large workspace (like a multi-repo folder) to ensure the UI remains performant.
+3.  **Testing:** Run `npm start` and verify AI Horizon (`Shift+O`) and Port Config (`Shift+R`) functionality. (like a multi-repo folder) to ensure the UI remains performant.
 4.  **Commits:** Use conventional commits (`feat:`, `fix:`, `docs:`, `refactor:`).
 
 ## Deployment

package/package.json

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