project-compass 3.6.5 → 3.6.7

package/AGENTS.md

@@ -0,0 +1,36 @@
+# AGENTS.md - Project Compass Workspace
+
+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 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/components/`: React/Ink components for the TUI.
+  - `TaskManager.js`: Orbit Task Manager (background processes).
+  - `PackageRegistry.js`: Dependency management interface.
+  - `ProjectArchitect.js`: Scaffolding and templates.
+  - `Studio.js`: Omni-Studio health audit.
+- `assets/`: UI-related assets (screenshots, etc.).
+
+## 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`)
+- **Execution:** `execa` for robust subprocess management.
+
+## 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.
+
+---
+*Created for the CrimsonDevil333333 Ecosystem.*

package/ARCHITECTURE.md

@@ -0,0 +1,21 @@
+# Project Compass Architecture
+
+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.).
+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.
+5.  **Execution:** User-triggered scripts (like running `npm test`) are managed by `TaskManager.js` using `execa` with streaming logs.
+
+## Design Patterns
+- **React-for-CLI:** Leveraging React's lifecycle and state management for a terminal environment.
+- **Component-Driven:** Each view is an isolated component in `src/components`.
+- **Async Execution:** Heavy lifting (globbing, command execution) is offloaded from the main render loop to prevent UI lag.
+
+## Security
+Project Compass respects workspace boundaries and does not execute arbitrary code unless explicitly requested by the user.
+
+---
+*Built for scale and precision.*

package/CONTRIBUTING.md

@@ -0,0 +1,23 @@
+# Contributing to Project Compass
+
+Thank you for your interest in helping to navigate the project universe! 🚀
+
+## Core Principles
+1.  **High Fidelity:** The UI should feel like a cockpit, not just a text list.
+2.  **Safety First:** Commands should be executed safely, and critical actions (like `rm` or `kill`) should have a confirmation gate.
+3.  **Speed:** Operations must be non-blocking. Use Ink's async components or background processes via `execa`.
+
+## Working with AI Agents
+This repository is "AI-First." Always update `AGENTS.md` after making structural changes to the code or adding new core components. This helps subsequent agents (and humans!) maintain high-velocity context.
+
+## 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.
+4.  **Commits:** Use conventional commits (`feat:`, `fix:`, `docs:`, `refactor:`).
+
+## Deployment
+All production versions are managed by Satyaa and the primary agent, Clawdy. Any `npm version` bump must include an update to `package-lock.json`.
+
+---
+*Navigate the future.*

package/package.json

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

package/src/cli.js

@@ -630,26 +630,26 @@ async function main() {
   }
   if (args.help) {
     console.clear();
-    console.log(kleur.magenta.bold('🧭 Project Compass · Premium Developer Cockpit'));
+    console.log(kleur.bold(kleur.magenta('🧭 Project Compass · Premium Developer Cockpit')));
     console.log(kleur.dim('───────────────────────────────────────────────────'));
     console.log('');
     console.log(kleur.bold('Usage:'));
     console.log('  project-compass [--dir <path>] [--studio]');
     console.log('');
-    console.log(kleur.cyan.bold('🌌 Core Views:'));
+    console.log(kleur.bold(kleur.cyan('🌌 Core Views:')));
     console.log('  Shift+T  ' + kleur.bold('Orbit Task Manager') + '  - Manage background processes & stream logs');
     console.log('  Shift+P  ' + kleur.bold('Package Registry') + '    - Direct dependency management (add/remove)');
     console.log('  Shift+N  ' + kleur.bold('Project Architect') + '   - Scaffold new projects from templates');
     console.log('  Shift+A  ' + kleur.bold('Omni-Studio') + '         - Environment & runtime health audit');
     console.log('');
-    console.log(kleur.yellow.bold('🎮 Navigation & Details:'));
+    console.log(kleur.bold(kleur.yellow('🎮 Navigation & Details:')));
     console.log('  ↑ / ↓    Move focus through discovered projects');
     console.log('  Enter    Toggle deep detail view (manifests, scripts, frameworks)');
     console.log('  Shift+C  Add a persistent custom command to the focused project');
     console.log('  1-9      Quick-run numbered scripts in detail view');
     console.log('  B/T/R    Macro run: Build / Test / Run');
     console.log('');
-    console.log(kleur.green.bold('🛠️ Workspace Tools:'));
+    console.log(kleur.bold(kleur.green('🛠️ Workspace Tools:')));
     console.log('  Shift+B  Toggle Art-coded Build Atlas');
     console.log('  Shift+S  Toggle Directory Structure Guide');
     console.log('  Shift+H  Toggle Navigation Help Cards');
@@ -657,7 +657,7 @@ async function main() {
     console.log('  Shift+X  Clear active log buffer');
     console.log('  Shift+E  Export current session logs to .txt');
     console.log('');
-    console.log(kleur.red.bold('🚪 System:'));
+    console.log(kleur.bold(kleur.red('🚪 System:')));
     console.log('  Shift+Q  Quit application (triggers confirmation if tasks are running)');
     console.log('  Esc      Global "Back" key to return to Main Navigator');
     console.log('');