seosona-cli 2.0.0 → 2.0.1

package/README.md

@@ -0,0 +1,377 @@
+<div align="center">
+
+```
+███████╗███████╗ ██████╗ ███████╗ ██████╗ ███╗   ██╗ █████╗      ██████╗ ███████╗
+██╔════╝██╔════╝██╔═══██╗██╔════╝██╔═══██╗████╗  ██║██╔══██╗    ██╔═══██╗██╔════╝
+███████╗█████╗  ██║   ██║███████╗██║   ██║██╔██╗ ██║███████║    ██║   ██║███████╗
+╚════██║██╔══╝  ██║   ██║╚════██║██║   ██║██║╚██╗██║██╔══██║    ██║   ██║╚════██║
+███████║███████╗╚██████╔╝███████║╚██████╔╝██║ ╚████║██║  ██║    ╚██████╔╝███████║
+╚══════╝╚══════╝ ╚═════╝ ╚══════╝ ╚═════╝ ╚═╝  ╚═══╝╚═╝  ╚═╝     ╚═════╝ ╚══════╝
+```
+
+**The Universal AI Operating System for Senior Developers**
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Version](https://img.shields.io/badge/version-2.0.0-blue.svg)](https://github.com/LongLeo287/SEOSONA-OS)
+[![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey.svg)](https://github.com/LongLeo287/SEOSONA-OS)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D16.0-brightgreen.svg)](https://nodejs.org)
+[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/LongLeo287/SEOSONA-OS/pulls)
+
+*One setup. Every AI tool. Everywhere.*
+
+</div>
+
+---
+
+## 🧠 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** | Double-click `install.bat` or 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: Windows (PowerShell) — Recommended for Windows Users
+
+```bat
+# Double-click install.bat
+# OR run in PowerShell:
+powershell -ExecutionPolicy Bypass -File setup.ps1
+```
+
+### Method 2: Node.js CLI — Cross-Platform (Windows / macOS / Linux)
+
+```bash
+# Navigate to the cli/ folder
+cd cli
+
+# Install globally
+npm install -g .
+
+# Run setup
+seosona setup
+```
+
+### Method 3: Clone & Run (Any Platform)
+
+```bash
+# Clone the repository
+git clone https://github.com/LongLeo287/SEOSONA-OS.git
+
+# Windows
+cd SEOSONA-OS
+powershell -ExecutionPolicy Bypass -File setup.ps1
+
+# macOS / Linux
+cd SEOSONA-OS/cli
+npm install -g .
+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.
+
+```
+install.bat      ← Double-click. Done.
+```
+
+### 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
+```
+
+### Binding a New Project with PowerShell
+
+```powershell
+cd C:\your\project
+seosona-init
+```
+
+---
+
+## 🏗️ 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
+│
+├── 📂 scripts/                       # Automation scripts
+│   ├── seosona-init.ps1             # Local project binder (PowerShell)
+│   └── rebrand_seosona.ps1          # System maintenance scripts
+│
+├── 📂 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
+├── 🔧 setup.ps1                      # Universal Setup Engine v2.0.0
+├── 📄 install.bat                    # One-click Windows launcher
+└── 📖 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 `setup.ps1`, the anchor updates automatically
+- **Zero hardcoded paths anywhere in the system**
+
+### The Injection Chain
+
+```
+setup.ps1 (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
+
+---
+
+## 🔐 Security Notes
+
+- **Never commit your GitHub PAT** to this repository
+- The `SOUL.md` file may contain internal SOPs — review before making the repo public
+- Environment Variables set by this tool are scoped to the **current user only** (`[Environment]::SetEnvironmentVariable(..., "User")`)
+- Run `git status` and review diffs before every push
+
+---
+
+## 🤝 Contributing
+
+1. Fork this repository
+2. Create your feature branch: `git checkout -b feature/new-skill-pack`
+3. Commit your changes: `git commit -m 'Add new skill pack for X'`
+4. Push to the branch: `git push origin feature/new-skill-pack`
+5. Open a Pull Request
+
+### Adding a New Skill
+
+```
+2_KNOWLEDGE/frameworks/<domain>/<skill-name>/
+├── README.md         # Skill overview and usage
+├── SKILL.md          # Full skill prompt / SOP
+├── _DIR_IDENTITY.md  # Directory identity and scope
+├── schema.json       # Structured metadata
+└── references/       # Supporting reference files
+```
+
+---
+
+## 📋 Changelog
+
+### v2.0.0 — Omni-Scanner Release
+- ✅ Added smart detection for 14 IDE/CLI tools
+- ✅ Replaced path-pointer injection with full SOUL.md content injection
+- ✅ Built cross-platform Node.js CLI (`seosona setup`, `seosona init`)
+- ✅ Introduced `Inject-JsonSettings` generic function — eliminating 200+ lines of duplicated logic
+- ✅ Fixed `~/.git-templates` stale artifact from v1.x
+- ✅ Zero hardcoded paths — all paths computed at runtime
+- ✅ Added Antigravity IDE support via Environment Variables
+
+### v1.0.0 — Initial Release
+- ✅ PowerShell setup engine for Windows
+- ✅ Cursor, Codex, SecureCoder support
+- ✅ MemPalace spatial memory architecture
+- ✅ SOUL.md master system prompt
+
+---
+
+## 📜 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/package.json

@@ -1,7 +1,15 @@
 {
   "name": "seosona-cli",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "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"

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/`);
+}