seosona-cli 2.0.0 → 2.1.0

package/README.md

@@ -0,0 +1,332 @@
+<div align="center">
+
+<img src="https://raw.githubusercontent.com/LongLeo287/SEOSONA-OS/main/assets/logo.svg" alt="SEOSONA OS" width="800">
+
+<br/>
+
+**The Universal AI Operating System for Senior Developers**
+
+[![NPM Version](https://img.shields.io/npm/v/seosona-cli.svg?style=flat-square&color=blue)](https://www.npmjs.com/package/seosona-cli)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://opensource.org/licenses/MIT)
+[![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey.svg?style=flat-square)](https://github.com/LongLeo287/SEOSONA-OS)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D16.0-brightgreen.svg?style=flat-square)](https://nodejs.org)
+[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](https://github.com/LongLeo287/SEOSONA-OS/pulls)
+
+*One setup. Every AI tool. Everywhere.*
+
+</div>
+
+---
+
+## 📑 Table of Contents
+- [What is SEOSONA OS?](#-what-is-seosona-os)
+- [Key Features](#-key-features)
+- [Tool Coverage](#️-tool-coverage)
+- [Installation](#-installation)
+- [Usage](#-usage)
+- [Repository Structure](#️-repository-structure)
+- [Skill Framework Library](#-skill-framework-library)
+- [How It Works — Under the Hood](#️-how-it-works--under-the-hood)
+- [Community & Standards](#-community--standards)
+- [Changelog](#-changelog)
+- [License](#-license)
+
+---
+
+## 🧠 What is SEOSONA OS?
+
+SEOSONA OS is a **Universal AI Operating System** — a self-installing, self-scanning environment that automatically detects every AI coding tool installed on your machine and injects a unified **Master Intelligence Layer** (your `SOUL.md`) into each one.
+
+No more copy-pasting system prompts. No more configuring each tool separately. No more AI that doesn't know who you are, how you work, or what rules you follow.
+
+**Run one command. Every AI on your machine becomes SEOSONA.**
+
+> *"You are not a simple chatbot; you are an end-to-end operational agent."* — SOUL.md, Prime Directive
+
+---
+
+## ✨ Key Features
+
+| Feature | Description |
+|---|---|
+| 🔍 **Omni-Scanner** | Auto-detects every installed IDE and CLI tool on your machine |
+| 🧬 **DNA Injection** | Injects full `SOUL.md` content (not just a pointer) directly into each tool |
+| 🌍 **Cross-Platform** | Works on Windows (PowerShell), macOS and Linux (Node.js CLI) |
+| 🔒 **Zero Hardcodes** | All paths are computed at runtime — portable across any machine |
+| ⚡ **1-Click Setup** | Run `npm install -g seosona-cli` |
+| 🧩 **Modular Skills** | 20+ skill frameworks covering SEO, Frontend, Security, Testing, and more |
+| 🧠 **MemPalace Architecture** | Structured spatial memory system for persistent AI context |
+| 🚨 **OmniClaw Protocol** | Zero-tolerance ruleset preventing AI from bypassing workflows |
+
+---
+
+## 🛠️ Tool Coverage
+
+SEOSONA OS automatically detects and configures the following tools:
+
+### 🖥️ IDEs
+| Tool | Injection Method | Config Target |
+|---|---|---|
+| **Cursor** | `settings.json` | `cursor.general.rules` |
+| **Windsurf** | `settings.json` | `windsurf.general.rules` |
+| **PearAI** | `settings.json` | `pearai.general.rules` |
+| **Trae** | `settings.json` | `trae.general.rules` |
+| **VSCode** | `settings.json` | `github.copilot.chat.*`, `cline.customInstructions`, `roo-cline.customInstructions` |
+| **VSCodium** | `settings.json` | Same as VSCode |
+
+### ⌨️ CLI Tools
+| Tool | Injection Method | Config Target |
+|---|---|---|
+| **Claude CLI** | PowerShell wrapper function | `--system-prompt` flag |
+| **Aider** | `~/.aider.conf.yml` | `system-prompt` field |
+| **OpenInterpreter** | `config.yaml` | `system_message` field |
+| **Codex** | `~/.codex/AGENTS.md` | Prepended content |
+| **SecureCoder** | `~/.securecoder/AGENTS.md` | Prepended content |
+| **Continue.dev** | `~/.continue/config.json` | `systemMessage` field |
+
+### 🤖 Environment Variables (Antigravity & Custom CLIs)
+| Variable | Purpose |
+|---|---|
+| `ANTIGRAVITY_SYSTEM_PROMPT` | Injects SOUL into Antigravity IDE |
+| `SEOSONA_MASTER_PROMPT` | Universal variable for any custom tool |
+| `AIDER_SYSTEM_PROMPT` | Backup injection for Aider |
+
+### 📁 Project-Local Files (`seosona-init`)
+When you run `seosona init` in a project folder, it generates only the files relevant to your installed tools:
+
+```
+.cursorrules              # Cursor IDE
+.windsurfrules            # Windsurf IDE
+.clauderules              # Claude CLI
+.clinerules               # Cline extension
+.roomodes                 # Roo Code extension
+.aider.conf.yml           # Aider CLI
+.antigravityrules         # Antigravity IDE
+.codexrules               # OpenAI Codex
+.securecoderrules         # SecureCoder
+.openinterpreter          # OpenInterpreter
+.github/copilot-instructions.md   # GitHub Copilot Enterprise
+.cody/prompt              # Sourcegraph Cody
+.bolt/prompt              # Bolt.new
+.lovable/prompt           # Lovable.dev
+```
+
+> **Smart Detection:** Files are only created for tools that are actually installed on your machine. No phantom files for tools you don't have.
+
+---
+
+## 🚀 Installation
+
+### Method 1: NPM (Recommended — Cross-Platform)
+
+```bash
+# Install the CLI globally via npm
+npm install -g seosona-cli
+
+# Run the global setup wizard
+seosona setup
+```
+
+### Method 2: Manual Clone & Run (Developers)
+
+```bash
+# Clone the repository
+git clone https://github.com/LongLeo287/SEOSONA-OS.git
+cd SEOSONA-OS/cli
+
+# Install globally from local source
+npm install -g .
+
+# Run setup
+seosona setup
+```
+
+---
+
+## 📖 Usage
+
+### For Non-Technical Users (Zero-Touch)
+
+Just run setup once. SEOSONA OS handles everything automatically. Every IDE you open from that point on will operate under SEOSONA rules.
+
+```bash
+seosona setup
+```
+
+### For Developers (Expert Mode)
+
+```bash
+# Global machine setup (run once per machine)
+seosona setup
+
+# Bind a project (run once per project folder)
+cd /path/to/your/project
+seosona init
+
+# Check what was injected
+seosona setup    # Re-run anytime to verify state
+```
+
+
+
+---
+
+## 🏗️ Repository Structure
+
+```
+SEOSONA OS/
+│
+├── 📂 1_CORE/                        # The Brain — Core intelligence layer
+│   ├── 🧠 SOUL.md                    # Master system prompt (9,400+ chars)
+│   └── 📂 rules/                     # Security, API, and interface rules
+│       ├── security_regex_rules.md
+│       ├── dependency_audit_rules.md
+│       └── interface_contract_validation.md
+│
+├── 📂 2_KNOWLEDGE/                   # The Skills — Modular capability library
+│   ├── 📋 SKILLS_ROUTER.md           # Index of all registered skills
+│   ├── 📂 sops/                      # Standard Operating Procedures
+│   │   ├── mempalace_sop.md          # Spatial memory architecture
+│   │   ├── context_cleaning_optimization.md
+│   │   └── omniclaw_blackboard_protocol.md
+│   └── 📂 frameworks/               # Domain-specific skill packs
+│       ├── core_system/             # Engineering rules, memory, security
+│       ├── seo_marketing/           # SEO, content, landing pages, LinkedIn
+│       ├── frontend_engineering/    # UI/UX, Hoversource, design tokens
+│       └── testing_automation/      # Playwright, test workflows
+│
+├── 📂 3_MEMORY/                      # The Memory — Persistent session storage
+│   ├── specs/                        # Architecture docs & technical specs
+│   ├── logs/                         # Chronological session logs
+│   ├── errors/                       # Error reports & debug records
+│   └── ingestion_zone/              # Staging area for new knowledge
+│
+
+├── 📂 cli/                           # Node.js CLI package
+│   ├── bin/seosona.js               # CLI entry point
+│   ├── src/
+│   │   ├── globalSetup.js           # Cross-platform Global Scanner
+│   │   ├── localInit.js             # Cross-platform Local Scanner
+│   │   └── utils.js                 # Shared utilities
+│   ├── scripts/bundle-soul.js       # Pre-build: bundles SOUL.md into package
+│   └── package.json                 # npm package definition
+│
+├── 📂 repos/                         # Tracked reference repositories
+
+└── 📖 README.md                      # You are here
+```
+
+---
+
+## 🧩 Skill Framework Library
+
+SEOSONA OS ships with 20+ modular skills across 5 domains:
+
+### 🔧 Core System
+- **Harness Engineering Machine** — End-to-end operational agent framework
+- **OmniClaw Blackboard Protocol** — Multi-agent coordination & CEO Rule
+- **MemPalace Architecture** — Spatial verbatim memory layout
+- **Post-Session Learning** — Auto-assimilation of new knowledge
+- **Security Scanning** — Pre-commit regex auditing & dependency checks
+
+### 🎨 Frontend Engineering
+- **UI/UX Pro Max Typography** — Design token standards
+- **Web Interface Compliance** — Accessibility & performance gates
+- **Tailwind Motion Design** — Animation system rules
+- **Hoversource Integration** — Component integration workflows
+
+### 📈 SEO & Marketing
+- **SEO/AEO Best Practices** — E-E-A-T, schema, Core Web Vitals
+- **Content Creator** — Brand voice, social optimization
+- **Landing Page Generator** — Conversion patterns & scaffolding
+- **LinkedIn Authority Builder** — B2B content framework
+- **SEO Migration Assistant** — Technical migration SOPs
+
+### 🧪 Testing & Automation
+- **Playwright Suite** — E2E testing workflows & CLI reference
+- **Swarms Auto-Research Loop** — Autonomous research agent patterns
+
+### 🤖 Ingested Intelligence
+- **Agentic OS Architecture** — Multi-agent system design
+- **LightRAG Graph Mapping** — Entity-relationship standards
+- **Context Cleaning Optimization** — Token efficiency rules
+- **Scrapling/Crawling DOM** — Web scraping best practices
+
+---
+
+## ⚙️ How It Works — Under the Hood
+
+### The Universal Anchor
+SEOSONA OS creates a filesystem junction at `~/.seosona` pointing to wherever the actual `SEOSONA OS` directory lives. This means:
+- All tools read from `~/.seosona` regardless of where you stored the files
+- Move the folder anywhere, re-run `seosona setup`, the anchor updates automatically
+- **Zero hardcoded paths anywhere in the system**
+
+### The Injection Chain
+
+```
+seosona setup (run once)
+    │
+    ├── Reads SOUL.md (9,400+ chars of pure intelligence)
+    │
+    ├── [Global Level] Writes to IDE settings.json files
+    │       Cursor → settings.json → cursor.general.rules
+    │       VSCode → settings.json → copilot/cline/roo keys
+    │       Aider  → ~/.aider.conf.yml → system-prompt
+    │       ...
+    │
+    ├── [OS Level] Sets Windows Environment Variables
+    │       ANTIGRAVITY_SYSTEM_PROMPT = <full SOUL.md content>
+    │       SEOSONA_MASTER_PROMPT     = <full SOUL.md content>
+    │
+    └── [Shell Level] Injects PowerShell profile wrappers
+            seosona-init → available globally in any terminal
+            seosona-claude → wraps Claude CLI with --system-prompt
+            git init → auto-calls seosona-init on new projects
+
+seosona-init (run per project)
+    │
+    ├── Detects installed tools on THIS machine
+    └── Drops ONLY relevant rule files into the project root
+            No phantom files for tools you don't have
+```
+
+### The SOUL.md — Master Intelligence
+The `SOUL.md` file contains the full cognitive blueprint of SEOSONA OS:
+- **Prime Directive** — The Evolution Mandate
+- **OmniClaw Protocol** — Zero-tolerance bypass rules
+- **Enforced SOPs** — Engineering standards, security rules, memory patterns
+- **Master Flow** — The 5-phase execution model for every task
+- **Sub-persona Activation** — Context-aware behavior switching
+
+---
+
+## 🤝 Community & Standards
+
+We welcome contributions from the community! To maintain a safe and productive environment, please review our community standards before participating:
+
+- **[Contributing Guidelines](CONTRIBUTING.md)**: Instructions on how to submit bug reports, feature requests, and Pull Requests (including adding new skills).
+- **[Code of Conduct](CODE_OF_CONDUCT.md)**: Our pledge to maintain a welcoming, inclusive, and harassment-free community.
+- **[Security Policy](SECURITY.md)**: Instructions for reporting security vulnerabilities safely.
+
+---
+
+## 📋 Changelog
+
+Please see our dedicated [CHANGELOG.md](CHANGELOG.md) file for a detailed history of all updates and releases.
+
+---
+
+## 📜 License
+
+MIT License — See [LICENSE](LICENSE) for details.
+
+---
+
+<div align="center">
+
+**Built by SEOSONA. Powered by the Prime Directive.**
+
+*"Always learning, upgrading, optimizing, automating, developing, improving... from new data, new information, new knowledge. Learn from mistakes to be better."*
+
+</div>

package/assets/SOUL.md

@@ -76,8 +76,8 @@ Do not summarize or paraphrase technical specifications or user guidelines. Main
 ## 4. The Master Flow Execution Enforcer
 
 For every task, execute using **The Master Flow** sequence:
-1.  **Intake & Scope:** Clean context, declare visual dials, set up `task.md` checklist. Consult the Orchestrator.
-2.  **Retrieve:** Query spatial directories, load `.aaak` closets (use MemPalace compressor tool or `context_compression` Engine if needed).
+1.  **Intake & Scope (Auto-Context Protocol):** Proactively infer the tech stack, problem domain, and required expertise at the start of every interaction without waiting for explicit keywords. Clean context, set up `task.md` checklist. Consult the Orchestrator.
+2.  **Semantic Retrieval:** Dynamically query spatial directories based on semantic intent, autonomously load relevant frameworks and skills.
 3.  **Execute & Auto-Heal:** Surgical style edits, compiler verification, autoresearch correction loop (2-Strike Rule limit).
 4.  **Deliver:** Switch sub-personas, produce raw outputs, await CEO approval. Ensure you output "TASK COMPLETED".
 
@@ -96,7 +96,7 @@ Memory synthesis is a continuous, dynamic background process ("Dreaming") rather
 ## 5. System Skills (The Arsenal)
 
 You have access to top-tier skills compressed as `.aaak` or `.md` inside `2_KNOWLEDGE/frameworks/`.
-Before executing specialized tasks (like Next.js routing, SEO tuning, UI/UX design, or Crawlee setups), you MUST load the corresponding files into your context.
+You MUST operate completely autonomously. Do NOT rely on the user to provide slash commands or exact keywords to trigger these skills. Automatically parse the user's intent and fetch the required files from the Semantic Capabilities Graph (`2_KNOWLEDGE/SKILLS_ROUTER.md`) before executing specialized tasks.
 - **Web**: `frontend_engineering/nextjs_app_router_patterns`, `frontend_engineering/react_best_practices`, `frontend_engineering/tailwind_design_system`.
 - **UI/UX**: `frontend_engineering/ui_ux_pro_max`, `frontend_engineering/frontend_ui_dark_ts`.
 - **SEO/Content**: `seo_marketing/claude_seo_framework` (NEW AI Search/E-E-A-T SOP), `seo_marketing/seo_aeo_best_practices`, `seo_marketing/landing_page_generator`.

package/package.json

@@ -1,11 +1,26 @@
 {
   "name": "seosona-cli",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "The Omni-Scanner Setup CLI for SEOSONA OS",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/LongLeo287/SEOSONA-OS.git"
+  },
+  "bugs": {
+    "url": "https://github.com/LongLeo287/SEOSONA-OS/issues"
+  },
+  "homepage": "https://github.com/LongLeo287/SEOSONA-OS#readme",
   "main": "src/index.js",
   "bin": {
     "seosona": "./bin/seosona.js"
   },
+  "files": [
+    "bin/",
+    "src/",
+    "scripts/",
+    "assets/",
+    "README.md"
+  ],
   "scripts": {
     "prebuild": "node scripts/bundle-soul.js",
     "prepack": "npm run prebuild",

package/scripts/bundle-soul.js

@@ -15,3 +15,10 @@ if (fs.existsSync(sourcePath)) {
 } else {
     console.warn(`[SEOSONA BUILD] Warning: Source SOUL.md not found at ${sourcePath}`);
 }
+
+const readmeSource = path.join(__dirname, '..', '..', 'README.md');
+const readmeDest = path.join(__dirname, '..', 'README.md');
+if (fs.existsSync(readmeSource)) {
+    fs.copyFileSync(readmeSource, readmeDest);
+    console.log(`[SEOSONA BUILD] Copied README.md into cli/`);
+}

package/src/localInit.js

@@ -4,9 +4,30 @@ const os = require('os');
 const { getSoulContent, getAppDataPath, colors } = require('./utils');
 
 function runInit() {
+    const cwd = process.cwd();
+
+    // ============================================================
+    // SELF-INJECTION GUARD
+    // Prevent running `seosona init` inside the SEOSONA OS source
+    // repo itself. This would create rule files in cli/, repos/, etc.
+    // ============================================================
+    const isSeosonaSourceRepo = fs.existsSync(path.join(cwd, '1_CORE', 'SOUL.md'));
+    if (isSeosonaSourceRepo) {
+        console.log("");
+        console.log(colors.yellow("[SEOSONA] WARNING: Self-injection detected and blocked."));
+        console.log(colors.yellow("          You are running `seosona init` inside the SEOSONA OS"));
+        console.log(colors.yellow("          source repository. This is not allowed."));
+        console.log("");
+        console.log("          Run `seosona init` inside your OWN project folder instead:");
+        console.log("          > cd /path/to/your-project");
+        console.log("          > seosona init");
+        console.log("");
+        return;
+    }
+
     console.log("");
     console.log(colors.cyan("[SEOSONA] Binding project to SEOSONA OS..."));
-    console.log(colors.cyan(`  Target : ${process.cwd()}`));
+    console.log(colors.cyan(`  Target : ${cwd}`));
 
     const soulContent = getSoulContent();
     const globalPrompt = `You are the SEOSONA Master System. Your core directives are below:\n\n${soulContent}`;
@@ -27,14 +48,13 @@ function runInit() {
         filesToCreate.push(".roomodes");
     }
 
-    // 3. CLIs (Since we can't easily check Get-Command in pure JS without child_process, we check known config paths or just inject if standard)
-    // We'll just assume they might have Aider if they have .aider.conf.yml globally
+    // 3. CLIs
     if (fs.existsSync(path.join(home, ".aider.conf.yml"))) filesToCreate.push(".aider.conf.yml");
     
     // 4. OpenInterpreter
     if (fs.existsSync(path.join(appData, "Open Interpreter"))) filesToCreate.push(".openinterpreter");
 
-    // 5. Antigravity IDE
+    // 5. Antigravity IDE (always inject)
     filesToCreate.push(".antigravityrules");
 
     // 6. Project-specific Subfolders
@@ -44,7 +64,7 @@ function runInit() {
     if (fs.existsSync(".lovable")) filesToCreate.push(path.join(".lovable", "prompt"));
 
     filesToCreate.forEach(file => {
-        const fullPath = path.join(process.cwd(), file);
+        const fullPath = path.join(cwd, file);
         const dir = path.dirname(fullPath);
         
         if (!fs.existsSync(dir)) {