wraith-cli 1.2.0__tar.gz → 1.4.0__tar.gz

{wraith_cli-1.2.0 → wraith_cli-1.4.0}/.env.example

@@ -9,3 +9,5 @@ GITEA_COMPOSE_PATH=/home/user/example/gitea
 GITEA_API_URL="http://your-gitea-instance:3000"
 GITEA_TOKEN="your_personal_access_token"
 GITEA_TEMPLATE_URL="https://gitea.domain.com/user/repo-template.git"
+
+SCRUTINY_URL=http://127.0.0.1:8090

{wraith_cli-1.2.0 → wraith_cli-1.4.0}/.gitea/workflows/pages.yml

@@ -1,5 +1,6 @@
 name: Deploy Gitea Pages
 on:
+  workflow_dispatch:
   push:
     branches:
       - main

{wraith_cli-1.2.0 → wraith_cli-1.4.0}/.gitignore

@@ -165,3 +165,4 @@ cython_debug/
 #  and can be added to the global gitignore or merged into this file.  For a more nuclear
 #  option (not recommended) you can uncomment the following to ignore the entire idea folder.
 #.idea/
+.aider*

wraith_cli-1.4.0/.pre-commit-config.yaml

@@ -0,0 +1,82 @@
+minimum_pre_commit_version: 4.0.0
+default_stages: [pre-commit, pre-push]
+
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+      - id: trailing-whitespace
+        args: [--markdown-linebreak-ext=md]
+        exclude: ^src/wraith_cli/assets\.py$
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-toml
+      - id: check-added-large-files
+      - id: check-case-conflict
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.15.9
+    hooks:
+      - id: ruff
+        args: ["--fix", "--exit-non-zero-on-fix"]
+      - id: ruff-format
+
+  - repo: https://github.com/codespell-project/codespell
+    rev: v2.4.2
+    hooks:
+      - id: codespell
+        types_or: [python, markdown, rst]
+
+  - repo: https://github.com/asottile/pyupgrade
+    rev: v3.21.2
+    hooks:
+      - id: pyupgrade
+        args: [--py312-plus]
+
+  - repo: https://github.com/shellcheck-py/shellcheck-py
+    rev: v0.11.0.1
+    hooks:
+      - id: shellcheck
+        args: ["--severity=warning"]
+
+  - repo: https://github.com/Yelp/detect-secrets
+    rev: v1.5.0
+    hooks:
+      - id: detect-secrets
+        args: ["--baseline", ".secrets.baseline"]
+        exclude: package-lock.json
+
+  - repo: local
+    hooks:
+      - id: generate-docs
+        name: Auto-generate CLI Documentation
+        entry: uv run typer src/wraith_cli/main.py utils docs --output docs/usage.md
+        language: system
+        pass_filenames: false
+        always_run: true
+
+      - id: no-raw-print
+        name: Ban raw print() in favor of typer.echo/rich
+        language: pygrep
+        entry: '(?<![\.a-zA-Z0-9_])print\('
+        types: [python]
+
+      - id: ty-check
+        name: ty check
+        entry: uv run ty check
+        language: system
+        types: [python]
+        pass_filenames: false
+
+      - id: pytest-coverage
+        name: pytest-coverage
+        entry: ./bin/run_tests.sh
+        language: system
+        pass_filenames: false
+        always_run: true
+
+      - id: commitizen
+        name: commitizen check
+        entry: uv run cz check --commit-msg-file
+        language: system
+        stages: [commit-msg]

{wraith_cli-1.2.0 → wraith_cli-1.4.0}/CHANGELOG.md

@@ -1,3 +1,7 @@
+## v1.4.0 (2026-04-05)
+
+## v1.3.0 (2026-04-04)
+
 ## v1.2.0 (2026-04-02)
 
 ## v1.1.0 (2026-03-31)

{wraith_cli-1.2.0 → wraith_cli-1.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: wraith-cli
-Version: 1.2.0
+Version: 1.4.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/
@@ -42,19 +42,19 @@ Requires-Dist: detect-secrets; extra == 'dev'
 Requires-Dist: genbadge[coverage]>=1.1.1; extra == 'dev'
 Requires-Dist: mkdocs-material<=10.0; extra == 'dev'
 Requires-Dist: mkdocs<=2.0; extra == 'dev'
-Requires-Dist: mypy; 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'
+Requires-Dist: ty; extra == 'dev'
 Requires-Dist: types-requests; 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)
+![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
@@ -64,35 +64,6 @@ Description-Content-Type: text/markdown
 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.
-
-```bash
-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.           |
 
 ---
 

{wraith_cli-1.2.0 → wraith_cli-1.4.0}/README.md

@@ -1,7 +1,7 @@
 [![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)
+![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
@@ -11,35 +11,6 @@
 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.
-
-```bash
-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.           |
 
 ---
 

wraith_cli-1.4.0/docs/usage.md

@@ -0,0 +1,208 @@
+# CLI
+
+Wraith Sovereign CLI: Ghost Stack Orchestrator
+
+**Usage**:
+
+```console
+$ [OPTIONS] COMMAND [ARGS]...
+```
+
+**Options**:
+
+* `--version`: Show version and exit.
+* `--install-completion`: Install completion for the current shell.
+* `--show-completion`: Show completion for the current shell, to copy it or customize the installation.
+* `--help`: Show this message and exit.
+
+**Commands**:
+
+* `status`: Check the heartbeat of the OpenViking Stack.
+* `update`: Sync Wraith with the latest PyPI release.
+* `ps`: List running containers with Sovereign...
+* `tail`: Stream live logs from a specific service.
+* `runner-reset`: Repair hung or offline Gitea Action Runners.
+* `spawn`: 🏭 Scaffold a new repository instantly.
+* `logs`: Unified hardware health and logging portal.
+* `mesh`: Map the Tailscale Ghost Mesh network.
+* `audit`: Execute a Sovereign security and...
+
+## `status`
+
+Check the heartbeat of the OpenViking Stack.
+
+ Polls the configured VIKING_BASE_URL health
+nendpoint to verify if the orchestrator API is responsive.
+
+**Usage**:
+
+```console
+$ status [OPTIONS]
+```
+
+**Options**:
+
+* `--help`: Show this message and exit.
+
+## `update`
+
+Sync Wraith with the latest PyPI release.
+
+Compares local versioning against the remote registry and
+automatically triggers an upgrade via 'uv tool' if a newer
+version is detected.
+
+**Usage**:
+
+```console
+$ update [OPTIONS]
+```
+
+**Options**:
+
+* `--help`: Show this message and exit.
+
+## `ps`
+
+List running containers with Sovereign styling.
+
+Wraps 'docker ps' to provide a high-contrast,
+readable table summarising service names,
+container status, and source images.
+
+**Usage**:
+
+```console
+$ ps [OPTIONS]
+```
+
+**Options**:
+
+* `-a, --all`: Show all containers
+* `--help`: Show this message and exit.
+
+## `tail`
+
+Stream live logs from a specific service.
+
+Connects to a running container to output real-time logs.
+Resolves Compose paths via CLI flags,
+environment variables, or local directory discovery.
+
+Priority:
+   1. Passed flag --path
+   2. Env Var WRAITH_COMPOSE_PATH
+   3. Current Directory
+
+**Usage**:
+
+```console
+$ tail [OPTIONS] SERVICE
+```
+
+**Arguments**:
+
+* `SERVICE`: Service name (e.g., ollama, gitea)  [required]
+
+**Options**:
+
+* `-p, --path PATH`: Path to directory with docker-compose.yml.  [env var: WRAITH_COMPOSE_PATH]
+* `--help`: Show this message and exit.
+
+## `runner-reset`
+
+Repair hung or offline Gitea Action Runners.
+
+Performs a nuclear reset: stops the container,
+purges the local registration data, and restarts
+the service to force a fresh handshake with Gitea.
+
+Requires GITEA_COMPOSE_PATH as an envelope variable
+
+**Usage**:
+
+```console
+$ runner-reset [OPTIONS]
+```
+
+**Options**:
+
+* `--help`: Show this message and exit.
+
+## `spawn`
+
+🏭 Scaffold a new repository instantly.
+
+Atomic scaffolding for new Ghost Stack repositories.
+Clones a template, bleaches git history,
+provisions a remote repository via API, and
+pushes the initial commit in one sequence.
+
+**Usage**:
+
+```console
+$ spawn [OPTIONS] REPO_NAME
+```
+
+**Arguments**:
+
+* `REPO_NAME`: Name of the new Ghost Stack repository  [required]
+
+**Options**:
+
+* `--help`: Show this message and exit.
+
+## `logs`
+
+Unified hardware health and logging portal.
+
+Default behavior provides log-tailing instructions.
+Using the --health flag triggers a deep-dive query
+into the Scrutiny API for SMART drive data and disk temps.
+
+**Usage**:
+
+```console
+$ logs [OPTIONS]
+```
+
+**Options**:
+
+* `--health`: Pull SMART data summary from Scrutiny API
+* `--help`: Show this message and exit.
+
+## `mesh`
+
+Map the Tailscale Ghost Mesh network.
+
+Interrogates the Tailscale daemon (local or containerised)
+to return a list of active peers, their internal IPs, and
+current online/offline status.
+
+**Usage**:
+
+```console
+$ mesh [OPTIONS]
+```
+
+**Options**:
+
+* `--help`: Show this message and exit.
+
+## `audit`
+
+Execute a Sovereign security and compliance scan.
+
+Audits the running stack for common vulnerabilities, including
+containers running with root privileges and exposed ports
+that deviate from the Registry Spec.
+
+**Usage**:
+
+```console
+$ audit [OPTIONS]
+```
+
+**Options**:
+
+* `--help`: Show this message and exit.

{wraith_cli-1.2.0 → wraith_cli-1.4.0}/mkdocs.yml

@@ -20,6 +20,8 @@ nav:
   - Home: index.md
   - Usage: usage.md
   - Technical Reference: reference.md
+  - Architecture Reference: architecture.md
+  - Security Statement: security.md
 
 plugins:
   - search

{wraith_cli-1.2.0 → wraith_cli-1.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "wraith-cli"
-version = "1.2.0"
+version = "1.4.0"
 description = "Sovereign Command Centre for a Ghost Stack"
 readme = "README.md"
 requires-python = ">=3.12"
@@ -41,11 +41,11 @@ wraith = "wraith_cli.main:app"
 [project.optional-dependencies]
 dev = [
     "ruff",
+    "ty",
     "pytest",
     "pytest-cov",
     "pre-commit",
     "commitizen",
-    "mypy",
     "types-requests",
     "detect-secrets",
     "mkdocs<=2.0",
@@ -56,34 +56,22 @@ dev = [
 
 [tool.pytest.ini_options]
 xfail_strict = true
-addopts = ["--cov=src", "--cov-report=term-missing", "--tb=short"]
+addopts = ["--cov=wraith_cli", "--cov-report=term-missing", "--tb=short"]
 pythonpath = ["src"]
 
 [tool.ruff]
 line-length = 79
 target-version = "py312"
+preview = true
 
 [tool.ruff.lint]
-select = ["E", "F", "I"]
+select = ["E", "F", "I", "N", "UP", "B"]
 ignore = []
 
 [tool.ruff.format]
 quote-style = "double"
 indent-style = "space"
 
-[tool.mypy]
-# The "Strict" setting enforces type hints everywhere
-strict = true
-python_version = "3.12"
-
-# Don't moan about missing stubs for libraries that don't have them
-ignore_missing_imports = true
-
-# Make sure we don't accidentally leave 'any' types in the code
-disallow_untyped_defs = true
-disallow_incomplete_defs = true
-warn_unused_ignores = true
-
 [tool.hatch.build.targets.wheel]
 packages = ["src/wraith_cli"]
 

wraith_cli-1.4.0/src/wraith_cli/assets.py

@@ -0,0 +1,10 @@
+# fmt: off
+# DO NOT EDIT: Trailing whitespace here is structural, 
+# not "useless" linting noise.
+WRAITH_LOGO = r"""
+ ▖  ▖▄▖▄▖▄▖▄▖▖▖  ▄▖▖ ▄▖    
+ ▌▞▖▌▙▘▌▌▐ ▐ ▙▌▄▖▌ ▌ ▐     
+ ▛ ▝▌▌▌▛▌▟▖▐ ▌▌  ▙▖▙▖▟▖    
+                           
+"""
+# fmt: on