⚡ Sovereign-OS V17 — Pristine Agent Governance Architecture

Sovereign-OS is a hyper-minimalist meta-framework engineered for governing autonomous AI coding agents across projects. Operating strictly on the Ponytail Doctrine (deletion before addition, zero unearned complexity, concrete utility), it delivers single-instance OS mutex lock guarantees, dynamic asset discovery, and seamless submodule orchestration.

🌐 Documentation & Web Portal

Visit the redesigned GitHub Pages documentation portal: 👉 Sovereign-OS Interactive Documentation Hub

Documentation Navigation

🏛️ System Architecture — OS Mutex locking, topology & state synchronization.
📦 Submodules Reference — Specifications for all 7 decoupled submodules.
✂️ Agent Skills Guide — Deep dive into ponytail minimalism and agent-reach research.
📐 Types Reference — Type definitions across TypeScript, Go, and JSON schemas.
💻 CLI Reference — PowerShell orchestrator & CLI command parameters.
🔒 Security Policy — Zero-trust secret scanner & credential redaction rules.

🏛️ System Architecture

graph TD
    A[Sovereign Core - c:\Skills] --> B(sovereign.ps1 Orchestrator)
    A --> C(sovereign.config.json)
    
    B --> MTx[OS Mutex: Global\SovereignOSLock]
    
    subgraph Submodules [7 Git Submodules]
        D1(sovereign-cli - Go Cobra)
        D2(sovereign-ui - Next.js App Router)
        D3(no-mistakes - Pipeline Engine)
        D4(codebase-memory-mcp - Knowledge Graph)
        D5(sovereign-security - Secret Scanner)
        D6(sovereign-memory - Key-Value Ledger)
        D7(sovereign-adapt - Policy Engine)
    end
    
    subgraph Skills [2 Standing Skills]
        S1(ponytail - Philosophy)
        S2(agent-reach - Research)
    end

    B --> Submodules
    B --> Skills

📦 Submodules Matrix

Submodule	Category	Stack	Purpose
`sovereign-cli`	CLI	Go (Cobra / Viper / Zap)	Command-line control & system state querying
`sovereign-ui`	Frontend	Next.js 14 / TypeScript / Tailwind	Real-time web telemetry & agent status dashboard
`no-mistakes`	Pipeline	Go	Automated git safety, PR routing & verification gates
`codebase-memory-mcp`	Knowledge Graph	C / Node.js MCP	Semantic code search, Cypher graph & path tracing
`sovereign-security`	Security	Go	Zero-trust secret scanner & static security audit
`sovereign-memory`	State	Go	Key-value memory ledger & persistent execution store
`sovereign-adapt`	Policy	Go	Strategy tuning & auto-remediation policy engine

🚀 Quickstart

Run the single PowerShell orchestrator to perform OS mutex locking, dynamic module discovery, and telemetry logging:

# Execute the Sovereign-OS Orchestrator
powershell -ExecutionPolicy Bypass -File .\sovereign.ps1

Sample Terminal Output

[00:04:46] [INFO] [MUTEX] OS-Level Lock Acquired.
[00:04:46] [INFO] [INIT] Dynamic skill count: 2, Module count: 7
[00:04:46] [INFO] [COMPLETE] ALL PHASES PASSED
[00:04:46] [INFO] [MUTEX] Lock released.
[00:04:46] [INFO] [TELEMETRY] Execution finished in 178 ms.

📜 The Ponytail Doctrine

Deletion Before Addition: Unused code is technical debt. Prune dead code, unused dependencies, and speculative fallbacks.
Zero Unearned Complexity: Only build what is requested and currently useful.
Verifiable System State: Every capability must be backed by empirical test logs or build output.

⚖️ License & Governance

Bound by the Standing Directive at .agents/AGENTS.md and certified in AUDIT_LEDGER.md. Distributed under the MIT License.

Sovereign OS

At a glance

README