wraith-cli 1.0.0__py3-none-any.whl

wraith_cli/main.py

@@ -0,0 +1,89 @@
+import os
+import subprocess
+from pathlib import Path
+
+import requests
+import typer
+from dotenv import load_dotenv
+
+load_dotenv()
+
+app = typer.Typer(help="Wraith Sovereign CLI", rich_markup_mode="rich")
+
+# --- Sanitised Configuration ---
+VIKING_URL = os.getenv("VIKING_BASE_URL", "http://127.0.0.1:1933/api/v1")
+VIKING_URL = VIKING_URL.rstrip("/")
+GITEA_PATH = os.getenv("GITEA_COMPOSE_PATH")
+
+
+@app.command()
+def status():
+    """Check the heartbeat of the OpenViking Stack."""
+    url = f"{VIKING_URL}/health"
+    try:
+        response = requests.get(url, timeout=3)
+        if response.status_code == 200:
+            typer.secho("🟢 OpenViking: Online", fg=typer.colors.GREEN)
+        else:
+            typer.secho(
+                f"🟡 OpenViking: Warning ({response.status_code})",
+                fg=typer.colors.YELLOW,
+            )
+    except Exception:
+        # Reverted to match your test expectations: " OpenViking: Offline"
+        typer.secho("🔴 OpenViking: Offline", fg=typer.colors.RED)
+
+
+@app.command()
+def ps(
+    simple: bool = typer.Option(False, "--simple", "-s"),
+    all: bool = typer.Option(False, "--all", "-a"),
+):
+    """View Docker process list."""
+    cmd = ["docker", "ps"]
+    if all:
+        cmd.append("-a")
+
+    if simple:
+        # Multi-line string to satisfy Ruff E501
+        fmt = (
+            "table {{.Names}}\t{{.Status}}\t"
+            '{{.Label "com.docker.compose.project"}}'
+        )
+    else:
+        fmt = "table {{.Names}}\t{{.Image}}\t{{.Status}}\t{{.Ports}}"
+
+    cmd.extend(["--format", fmt])
+    subprocess.run(cmd)
+
+
+@app.command()
+def runner_reset():
+    """Resets the Gitea Action Runner."""
+    if not GITEA_PATH:
+        msg = "❌ Error: GITEA_COMPOSE_PATH not set in .env"
+        typer.secho(msg, fg=typer.colors.RED)
+        raise typer.Exit(1)
+
+    compose_path = Path(GITEA_PATH)
+    docker_file = compose_path / "docker-compose.yml"
+    runner_data = compose_path / "data/act_runner/.runner"
+
+    if not docker_file.exists():
+        typer.secho(f"❌ Compose file not found at: {docker_file}", fg="red")
+        raise typer.Exit(1)
+
+    typer.echo("👻 Wraith-CLI: Killing Gitea Runner...")
+    subprocess.run(["docker", "compose", "-f", str(docker_file), "stop"])
+
+    if runner_data.exists():
+        typer.echo(f"🧹 Wiping registration: {runner_data}")
+        subprocess.run(["sudo", "rm", "-f", str(runner_data)])
+
+    typer.echo("🚀 Restarting Runner...")
+    subprocess.run(["docker", "compose", "-f", str(docker_file), "up", "-d"])
+    typer.secho("✅ Runner state reset.", fg=typer.colors.GREEN, bold=True)
+
+
+if __name__ == "__main__":
+    app()

wraith_cli-1.0.0.dist-info/METADATA

@@ -0,0 +1,124 @@
+Metadata-Version: 2.4
+Name: wraith-cli
+Version: 1.0.0
+Summary: Sovereign Command Centre for a Ghost Stack
+Project-URL: Homepage, https://git.thomaspeoples.com/thomaspeoples/wraith-cli
+Project-URL: Documentation, https://www.thomaspeoples.com/gitea-repos/wraith-cli/
+Project-URL: Repository, https://git.thomaspeoples.com/thomaspeoples/wraith-cli.git
+Project-URL: Issues, https://git.thomaspeoples.com/thomaspeoples/wraith-cli/issues
+Author-email: Thomas Peoples <junk@thomaspeoples.com>
+License: Copyright © `2026` `Thomas Peoples`
+        
+        Permission is hereby granted, free of charge, to any person
+        obtaining a copy of this software and associated documentation
+        files (the “Software”), to deal in the Software without
+        restriction, including without limitation the rights to use,
+        copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the
+        Software is furnished to do so, subject to the following
+        conditions:
+        
+        The above copyright notice and this permission notice shall be
+        included in all copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON INFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+License-File: LICENSE
+Keywords: automation,cli,ghost-stack,gitea,sovereign
+Classifier: Environment :: Console
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.12
+Requires-Dist: python-dotenv
+Requires-Dist: requests
+Requires-Dist: rich>=13.0.0
+Requires-Dist: typer>=0.9.0
+Provides-Extra: dev
+Requires-Dist: commitizen; extra == 'dev'
+Requires-Dist: genbadge[coverage]>=1.1.1; extra == 'dev'
+Requires-Dist: mkdocs-material>=9.5.0; extra == 'dev'
+Requires-Dist: mkdocs>=1.6.0; extra == 'dev'
+Requires-Dist: pre-commit; extra == 'dev'
+Requires-Dist: pymdown-extensions>=10.7.0; extra == 'dev'
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: pytest-cov; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Description-Content-Type: text/markdown
+
+[![Documentation](https://img.shields.io/badge/docs-live-brightgreen)](https://www.thomaspeoples.com/gitea-repos/wraith-cli/)
+![PyPI - Version](https://img.shields.io/pypi/v/wraith-cli)
+![PyPI - License](https://img.shields.io/pypi/l/wraith-cli)
+![PyPI - Python Version](https://img.shields.io/pypi/pyversions/wraith-cli)
+
+
+# 👻 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 containers and bare-metal reality.
+
+---
+
+## 🚀 Installation
+
+**Wraith-CLI** can be installed via `uv` (recommended) or `pip`:
+
+```bash
+# Recommended for CLI tools
+uv tool install wraith-cli
+
+# Standard pip
+pip install wraith-cli
+```
+
+> **Note:** Ensure ~/.local/bin is in your $PATH.
+
+---
+
+## 🛠️ Operational Manual
+
+| Command | Description |
+| :--- | :--- |
+| wraith ps | Shows all Docker processes in a neat table |
+| wraith status | Heartbeat check for OpenViking (Port 1933). |
+| wraith runner-reset | Wipes and re-registers the Gitea Action Runner. |
+| wraith --help | View the full manifest of available commands. |
+
+---
+
+## 🏗️ Developer Workspace
+
+We use uv for hermetic environment management.
+
+```bash
+### 1. Initialise the Environment
+uv sync --all-extras
+uv run pre-commit install
+
+### 2. The Quality Gate
+uv run pytest
+
+### 3. Sovereign Deployment
+chmod +x bin/build.sh
+./bin/build.sh
+```
+
+---
+
+## 🔐 Environment Configuration
+
+Defined in `~/.bashrc` or `.env.private`:
+
+| Variable | Purpose | Default |
+| :--- | :--- | :--- |
+| VIKING_BASE_URL | The API endpoint for the heartbeat check. | http://127.0.0.1:1933/api/v1 |
+| GITEA_COMPOSE_PATH | Path to your Gitea Docker Compose directory. | Required for runner-reset |
+
+---
+
+## 📜 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.
+3. **Hardware First:** Prioritise bare-metal health and container stability.

wraith_cli-1.0.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+wraith_cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+wraith_cli/main.py,sha256=y2DfWXsy9COp-XGPLHrTg4iv1GIkohzQt-NaK7RTPy0,2637
+wraith_cli-1.0.0.dist-info/METADATA,sha256=Dzx-kaqns0FstFXP9yO19fST3a9IzNeEeuFz3FLZEOY,4746
+wraith_cli-1.0.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+wraith_cli-1.0.0.dist-info/entry_points.txt,sha256=EkRBpiOXRX2gjMnWP9OVUryXUbW293ZUv7dQ0oTa1QQ,47
+wraith_cli-1.0.0.dist-info/licenses/LICENSE,sha256=_F3WuwINEfCmsuq52tuGSIV955rgS05wv4ALwFVFOYc,1070
+wraith_cli-1.0.0.dist-info/RECORD,,

wraith_cli-1.0.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

wraith_cli-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+wraith = wraith_cli.main:app

wraith_cli-1.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,15 @@
+Copyright © `2026` `Thomas Peoples`
+
+Permission is hereby granted, free of charge, to any person
+obtaining a copy of this software and associated documentation
+files (the “Software”), to deal in the Software without
+restriction, including without limitation the rights to use,
+copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following
+conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON INFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.