wraith-cli 1.3.0

Sovereign Command Centre for a Ghost Stack

👻 Wraith-CLI

Sovereign Orchestration for the Ghost Stack

Wraith-CLI is the nervous system of the Ghost Stack. It bridges the gap between high-level container orchestration and bare-metal reality, providing the "Ghost Factory" for instant project scaffolding.

---

🏗️ The Ghost Factory (New)

The spawn command allows you to go from Idea to Code in under 5 seconds by bleaching a template and provisioning a private Gitea repository automatically.

wraith spawn my-new-api

1. 🧬 Clones your GHOST_TEMPLATE_URL.
2. 🧹 Bleaches all previous git history.
3. 🌐 Provisions a new private repo via the Gitea API.
4. 🚀 Pushes the clean stack to your Sovereign remote.

---

🛠️ Operational Manual

Command	Feature	Status
wraith spawn <name>	The Ghost Factory	🏗️ Scaffolds new repos via Gitea API.
wraith update	Global Update	🟢 PyPI-linked & uv powered.
wraith ps	Rich Observability	🟢 Sovereign Dark styling for Docker.
wraith tail <svc>	Flexible Logging	🟢 Supports --path & Env Vars.
wraith status	Heartbeat	🟢 Monitor OpenViking (Port 1933).
wraith runner-reset	Runner Defence	🟢 CI/CD maintenance & registration wipe.
wraith --version	Self-Identity	🟢 Eager callback for versioning.

---

🚀 Installation & Updates

Wraith-CLI is managed via uv for hermetic stability.

# Initial Installation
uv tool install wraith-cli

# Sovereign Update
wraith update

---

🔐 Environment Configuration

Defined in your .env or system environment. HTTPS is required for automated Gitea provisioning.

Variable	Purpose	Required For
GITEA_API_URL	Base URL (e.g., https://git.domain.com)	spawn
GITEA_TOKEN	Personal Access Token (PAT)	spawn
GITEA_TEMPLATE_URL	HTTPS URL of your base ghost-template	spawn
GITEA_COMPOSE_PATH	Path to Gitea Docker directory	runner-reset
VIKING_BASE_URL	API endpoint for heartbeat checks	status
WRAITH_COMPOSE_PATH	Default path for stack logs/ps	tail, ps

---

🧪 Developer Quality Gate

We use uv for hermetic environment management and maintain a strict >80% coverage requirement.

# Initialise the Environment
uv sync --all-extras
uv run pre-commit install

# The Quality Gate
uv run pytest --cov=src

---

📜 Sovereign Principles

1. Distributed Sovereignty: Available on PyPI for the world, but optimised for local-first, private-registry mirrors.
2. Atomic Execution: Use uv run to ensure consistency across the stack.
3. Hardware First: Prioritise bare-metal health and container stability over abstraction.