# Gemini Sovereign Infrastructure Suite

This directory contains the core systems of the Gemini Sovereign Infrastructure, designed to systematize fleet operations, governance, and architectural integrity.

## Principles

1. **Systems, not Scripts**: We build frameworks that solve classes of problems, not one-off fixes.
2. **Sovereignty First**: All tools are designed to run locally or on owned VPSes. No cloud dependencies.
3. **Von Neumann as Code**: Infrastructure should be self-replicating and automated.
4. **Continuous Governance**: Quality is enforced by code (linters, gates), not just checklists.

## Tools

### [OPS] Provisioning & Fleet Management

- **`provision_wizard.py`**: Automates the creation of a new Wizard node from zero.
  - Creates DigitalOcean droplet.
  - Installs and builds `llama.cpp`.
  - Downloads GGUF models.
  - Sets up `systemd` services and health checks.
- **`fleet_llama.py`**: Unified management of `llama-server` instances across the fleet.
  - `status`: Real-time health and model monitoring.
  - `restart`: Remote service restart via SSH.
  - `swap`: Hot-swapping GGUF models on remote nodes.
- **`skill_installer.py`**: Packages and deploys Hermes skills to remote wizards.
- **`model_eval.py`**: Benchmarks GGUF models for speed and quality before deployment.
- **`phase_tracker.py`**: Tracks the fleet's progress through the Paperclips-inspired evolution arc.
- **`cross_repo_test.py`**: Verifies the fleet works as a system by running tests across all core repositories.
- **`self_healing.py`**: Auto-detects and fixes common failures across the fleet.
- **`agent_dispatch.py`**: Unified framework for tasking agents across the fleet.
- **`telemetry.py`**: Operational visibility without cloud dependencies.
- **`gitea_webhook_handler.py`**: Handles real-time events from Gitea to coordinate fleet actions.

### [ARCH] Governance & Architecture

- **`architecture_linter_v2.py`**: Automated enforcement of architectural boundaries.
  - Enforces sidecar boundaries (no sovereign code in `hermes-agent`).
  - Prevents hardcoded IPs and committed secrets.
  - Ensures `SOUL.md` and `README.md` standards.
- **`adr_manager.py`**: Streamlines the creation and tracking of Architecture Decision Records.
  - `new`: Scaffolds a new ADR from a template.
  - `list`: Provides a chronological view of architectural evolution.

## Usage

Most tools require `DIGITALOCEAN_TOKEN` and SSH access to the fleet.

```bash
# Provision a new node
python3 scripts/provision_wizard.py --name fenrir --model qwen2.5-coder-7b

# Check fleet status
python3 scripts/fleet_llama.py status

# Audit architectural integrity
python3 scripts/architecture_linter_v2.py
```

---
*Built by Gemini — The Builder, The Systematizer, The Force Multiplier.*
