mayhem-cli 0.6.2__tar.gz → 0.9.0__tar.gz

mayhem_cli-0.9.0/.github/workflows/ci.yml

@@ -0,0 +1,146 @@
+name: CI
+
+on:
+  push:
+    branches: [v0.9.0, main, master]
+  pull_request:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ci-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  unit:
+    name: unit
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4.4.0
+      - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5.6.0
+        with:
+          python-version: "3.12"
+      - name: Install uv
+        run: python -m pip install --quiet uv
+      - run: uv sync --group dev
+      - run: uv run pytest tests/unit
+
+  integration:
+    name: integration
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4.4.0
+      - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5.6.0
+        with:
+          python-version: "3.12"
+      - name: Install uv
+        run: python -m pip install --quiet uv
+      - run: uv sync --group dev
+      - run: uv run pytest tests/integration
+
+  e2e:
+    name: e2e (in-process)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4.4.0
+      - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5.6.0
+        with:
+          python-version: "3.12"
+      - name: Install uv
+        run: python -m pip install --quiet uv
+      - run: uv sync --group dev
+      - run: uv run pytest tests/e2e
+
+  schema:
+    name: schema
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4.4.0
+      - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5.6.0
+        with:
+          python-version: "3.12"
+      - run: python -c "import json; json.load(open('src/mayhem/schemas/output_v1.json'))"
+
+  ruff-fatal:
+    name: ruff (fatal subset)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4.4.0
+      - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5.6.0
+        with:
+          python-version: "3.12"
+      - name: Install uv
+        run: python -m pip install --quiet uv
+      - run: uv sync --group dev
+      - run: uv run ruff check --select E9,F63,F7,F82,F821,F811 src/ tests/
+
+  package-build:
+    name: package build
+    runs-on: ubuntu-latest
+    needs: [unit, integration, e2e, ruff-fatal]
+    steps:
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4.4.0
+        with:
+          fetch-depth: 0
+      - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5.6.0
+        with:
+          python-version: "3.12"
+      - name: Install build tooling
+        run: python -m pip install --upgrade build
+      - run: python -m build --sdist --wheel
+      - uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4.6.2
+        with:
+          name: dist
+          path: dist/
+          if-no-files-found: error
+
+  wheel-smoke:
+    name: wheel install smoke
+    runs-on: ubuntu-latest
+    needs: package-build
+    steps:
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4.4.0
+      - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5.6.0
+        with:
+          python-version: "3.12"
+      - name: Install uv
+        run: python -m pip install --quiet uv
+      - uses: actions/download-artifact@634f93cb2916e3fdff6788551b99b062d0335ce0 # v5.0.0
+        with:
+          name: dist
+          path: dist
+      - name: Run wheel smoke test
+        run: MAYHEM_PACKAGE_SMOKE=1 uv run pytest tests/package -q -rs
+
+  verify-artifacts:
+    name: verify release artifacts
+    runs-on: ubuntu-latest
+    needs: package-build
+    steps:
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4.4.0
+      - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5.6.0
+        with:
+          python-version: "3.12"
+      - uses: actions/download-artifact@634f93cb2916e3fdff6788551b99b062d0335ce0 # v5.0.0
+        with:
+          name: dist
+          path: dist
+      - run: python scripts/verify_release_artifacts.py dist
+
+  advisory:
+    name: advisory quality checks
+    runs-on: ubuntu-latest
+    continue-on-error: true
+    steps:
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4.4.0
+      - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5.6.0
+        with:
+          python-version: "3.12"
+      - name: Install uv
+        run: python -m pip install --quiet uv
+      - run: uv sync --group dev
+      - run: uv run ruff check src/ tests/
+      - run: uv run mypy src/mayhem
+      - run: uv run lint-imports

mayhem_cli-0.9.0/.github/workflows/conformance.yml

@@ -0,0 +1,34 @@
+name: Live Conformance
+
+on:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  live-conformance:
+    name: live conformance (manual)
+    runs-on: ubuntu-latest
+    if: github.event_name == 'workflow_dispatch'
+    steps:
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4.4.0
+      - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5.6.0
+        with:
+          python-version: "3.12"
+      - name: Install uv
+        run: python -m pip install --quiet uv
+      - run: uv sync --group dev
+      - name: Record conformance environment
+        run: |
+          date -u +%Y-%m-%dT%H:%M:%SZ > conformance-environment.txt
+          uname -a >> conformance-environment.txt
+          docker version --format '{{.Server.Version}}' >> conformance-environment.txt 2>&1 || true
+          kubectl version -o json >> conformance-environment.txt 2>&1 || true
+      - name: Run unit conformance profile
+        run: uv run pytest tests/unit -m nightly -q
+      - uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4.6.2
+        with:
+          name: conformance-environment
+          path: conformance-environment.txt
+          if-no-files-found: error

{mayhem_cli-0.6.2 → mayhem_cli-0.9.0}/.github/workflows/release.yml

@@ -25,14 +25,14 @@ jobs:
         run: python -m pip install --quiet uv
       - name: Sync dev dependencies
         run: uv sync --group dev
-      - name: Run tests
-        run: uv run pytest tests/unit tests/integration
+      - name: Run unit tests
+        run: uv run pytest tests/unit
+      - name: Run integration tests
+        run: uv run pytest tests/integration
       # NOTE: `ruff check src/` is NOT gated here — the repository's committed
       # ruff config currently reports 30-49 pre-existing violations under every
       # ruff generation (0.8-0.16); the project has no lint-green baseline in
       # its history. Land a lint-cleanup first, then re-add `ruff check src/`.
-      - name: Architectural contracts
-        run: uv run lint-imports
 
   build-and-publish:
     name: Build and publish to PyPI

{mayhem_cli-0.6.2 → mayhem_cli-0.9.0}/CHANGELOG.md

@@ -7,6 +7,256 @@ This changelog is generated from the project's git history by
 **drill phase** that produced them (Explore / Expert / Coverage / Next) and
 by conventional-commit type — see the phase map below.
 
+## [unreleased]
+
+
+
+### 📚 Documentation
+
+- Add v0.9.0 roadmap and implementation plans
+
+- Establish the v0.9.0 release truth baseline: checked command inventory, install
+  dependency contract, version metadata, and Justfile recipe paths
+
+
+## 0.8.0 - 2026-09-25
+
+
+
+### 🚀 Features
+
+- Kubernetes targeting system
+
+- Refined target.py
+
+- Kube topology structure
+
+- Kube topology for cli
+
+- **k8s**: K-plan-3 container-level signal execution
+
+- Update executors.py
+
+- Update k8s_resolve.py
+
+- Update lease_client.py
+
+- Update campaign.py
+
+- Update lifecycle.py
+
+- Update services.py
+
+- Update config.py
+
+- Update cell_runner.py
+
+- Update executor.py
+
+- Update k8s_runtime.py
+
+- Update safety.py
+
+- Update leases.py
+
+- Update resolution.py
+
+- Update lease_repository.py
+
+- Extend executor agents with K8s runtime support
+
+- Add K8s control plane agent
+
+- Update CLI app for K8s executor integration
+
+- Update coverage command for K8s runtime
+
+- Update explore command for K8s runtime
+
+- Update next command for K8s runtime
+
+- Update services command for K8s runtime
+
+- Update toolkit for K8s runtime
+
+- Update topology for K8s runtime
+
+- Update controller executor for K8s runtime
+
+- Extend K8s runtime with execution support
+
+- Extend fault catalog with K8s faults
+
+- Update K8s example spec
+
+- Update executor agents
+
+- Update dependencies for K8s runtime
+
+- Update K8s control agent
+
+- Update lifecycle CLI for K8s
+
+- Update services CLI for K8s
+
+- Update K8s runtime controller
+
+- Update planner for K8s runtime
+
+- Extend fault catalog
+
+- Update common domain for K8s
+
+- Add K8s adapter domain
+
+- Update maniac domain for K8s
+
+- Add runtime adapter for K8s
+
+- Update target selector for K8s
+
+- Add K8s manifest topology provider
+
+- Add policy, evidence, provider, and schema foundations
+
+- Expand agent and controller execution flows
+
+- Expand CLI commands and output handling
+
+- Finalize active CLI workflow surface
+
+
+
+### 🐛 Bug Fixes
+
+- Release.yml
+
+- Initialize slotted CLI exceptions safely
+
+
+
+### 💼 Other
+
+- Update docs/adr-adr-m7-1-k8s-executor-flip.md
+
+- Delete docs/features.md
+
+- Delete docs/k-plan-1.md
+
+
+
+### 🚜 Refactor
+
+- Format and ruff-fix
+
+
+
+### 📚 Documentation
+
+- Enhance readme file, removed dev version stuff
+
+- Kubernetes plans/spec/adrs
+
+- Update README.md
+
+- Update adr-m7-1-k8s-executor.md
+
+- Update config.md
+
+- Update drill-spec.md
+
+- Remove k-plan-2.md
+
+- Remove k-plan-3-implementation-subplans.md
+
+- Remove k-plan-3-sub-plans-k8s-executor-flip.md
+
+- Remove k-plan-3-sub-plans.md
+
+- Remove k-plan-3.md
+
+- Remove k-plan-4-sub-plans.md
+
+- Remove k-plan-4.md
+
+- Remove k-plan-5.md
+
+- Add k8s-plan-1.md
+
+- Add k8s-plan-2.md
+
+- Update architecture and reference documentation
+
+- Clarify the default installation bundle
+
+
+
+### 🎨 Styling
+
+- Remove obsolete noqa suppressions
+
+
+
+### 🧪 Testing
+
+- Add tests for kube
+
+- Update test_kplan3_runtime.py
+
+- Update test_m7_k8s.py
+
+- Update test_safety.py
+
+- Add test_kplan5_runtime.py
+
+- Update CLI tests for K8s runtime
+
+- Update container fault matrix tests for K8s
+
+- Update example specs YAML tests for K8s
+
+- Update fault catalog tests for K8s faults
+
+- Update K8s plan-3 runtime tests
+
+- Update K8s plan-5 runtime tests
+
+- Add K8s plan-6 runtime tests
+
+- Update CLI tests for K8s runtime
+
+- Update K8s plan-6 runtime tests
+
+- Add K8s manifest topology tests
+
+- Expand runtime, CLI, provider, and policy coverage
+
+- Add exhaustive CLI and runtime coverage
+
+- Pin compose topology discovery runtime
+
+
+
+### ⚙️ Miscellaneous Tasks
+
+- Update development tooling and package metadata
+
+- Add provider and container examples
+
+- **release**: Bundle Kubernetes and parallelize unit tests
+
+- Remove broken architecture gate from release
+
+
+## 0.6.2 - 2026-09-11
+
+
+
+### 🐛 Bug Fixes
+
+- ApiVersion was not added to tests
+
+
 ## 0.6.0 - 2026-09-11
 
 

{mayhem_cli-0.6.2 → mayhem_cli-0.9.0}/Justfile

@@ -9,9 +9,10 @@ set shell := ["bash", "-euo", "pipefail", "-c"]
 
 _testcase  := "examples/testCase"
 _compose   := _testcase / "docker-compose.yml"
-_config    := _testcase / "mayhem.yml"
+_config    := _testcase / "mayhem.yaml"
 _spec      := _testcase / "mayhem.yaml"
 _db        := ".mayhem/e2e.db"
+_workers   := "5"
 
 # ── setup ────────────────────────────────────────────────────────────────────
 
@@ -26,33 +27,33 @@ setup:
 # Discover topology from compose + live runtime (containers, processes, services)
 topology:
     @echo "=== topology discover ==="
-    mayhem topology discover --compose {{ _compose }} | python3 -m json.tool > /dev/null
+    mayhem discover topology --compose {{ _compose }} | python3 -m json.tool > /dev/null
     @echo "✓ topology discover"
 
 # Topology with prefix shorthand
 topology-prefix:
     @echo "=== topology prefix ==="
-    mayhem top d --compose {{ _compose }} | python3 -m json.tool > /dev/null
+    mayhem disc topo --compose {{ _compose }} | python3 -m json.tool > /dev/null
     @echo "✓ topology prefix"
 
 # ── toolkit ──────────────────────────────────────────────────────────────────
 
-# List available faults and capabilities
+# List available faults and capabilities (`mayhem discover`)
 toolkit:
     @echo "=== toolkit ==="
-    mayhem toolkit faults
-    mayhem toolkit list --json | python3 -m json.tool > /dev/null
+    mayhem discover faults
+    mayhem discover capabilities --json | python3 -m json.tool > /dev/null
     @echo "✓ toolkit"
 
 # ── config ───────────────────────────────────────────────────────────────────
 
-# Show and validate effective config (default + testCase)
+# Show and validate effective config (default + testCase) via `mayhem prepare config`
 config:
     @echo "=== config ==="
-    mayhem config show --json | python3 -m json.tool > /dev/null
-    mayhem --config {{ _config }} config show --json | python3 -m json.tool > /dev/null
-    mayhem config validate
-    mayhem --config {{ _config }} config validate
+    mayhem prepare config show --json | python3 -m json.tool > /dev/null
+    mayhem --config {{ _config }} prepare config show --json | python3 -m json.tool > /dev/null
+    mayhem prepare config validate
+    mayhem --config {{ _config }} prepare config validate
     @echo "✓ config"
 
 # ── experiment ───────────────────────────────────────────────────────────────
@@ -66,58 +67,57 @@ experiment:
 
 # ── lifecycle: validate → plan → run → status → history → recover ────────────
 
-# Validate spec against live topology
+# Validate spec against live topology (`mayhem prepare validate`)
 validate: setup
     @echo "=== validate ==="
-    mayhem --db {{ _db }} validate {{ _spec }} --compose {{ _compose }}
+    mayhem --db {{ _db }} prepare validate {{ _spec }} --compose {{ _compose }}
     @echo "✓ validate"
 
-# Validate with explicit process topology (no compose auto-detect)
-validate-process:
-    @echo "=== validate --process ==="
-    mayhem validate {{ _spec }} \
-        --process "download-1=10001" --process "download-2=10002"
-    @echo "✓ validate --process"
-
-# Plan the experiment
+# Plan the experiment (`mayhem prepare plan`)
 plan:
     @echo "=== plan ==="
-    mayhem plan {{ _spec }} --compose {{ _compose }}
+    mayhem prepare plan {{ _spec }} --compose {{ _compose }}
     @echo "✓ plan"
 
 # Full run: inject faults, record events, compensate
 run: setup
     @echo "=== run ==="
-    mayhem --db {{ _db }} run {{ _spec }} --compose {{ _compose }}
+    mayhem --db {{ _db }} run {{ _spec }} --compose {{ _compose }} --execute
     @echo "✓ run"
 
-# Show run status (JSON + text)
+# Show run status (text + JSON) via `mayhem inspect runs`
 status: setup
     @echo "=== status ==="
-    mayhem --db {{ _db }} status
+    mayhem --db {{ _db }} inspect runs
+    mayhem --db {{ _db }} inspect runs --json | python3 -m json.tool > /dev/null
     @echo "✓ status"
 
-# Show detailed run history (JSON + text)
+# Show detailed run history (text + JSON) via `mayhem inspect history`
 history:
     @echo "=== history ==="
     @run_id=$$(sqlite3 {{ _db }} "SELECT id FROM runs ORDER BY rowid DESC LIMIT 1" 2>/dev/null || echo ""); \
     if [ -z "$$run_id" ]; then \
         echo "⚠ no runs in DB — skipping history"; \
     else \
-        mayhem --db {{ _db }} history "$$run_id"; \
+        mayhem --db {{ _db }} inspect history "$$run_id"; \
         echo "✓ history"; \
     fi
 
-# Recovery sweep (orphaned fault leases)
-recover: setup
+# Recovery sweep (orphaned fault leases for the most recent run)
+recover:
     @echo "=== recover ==="
-    mayhem --db {{ _db }} recover
+    @run_id=$$(sqlite3 {{ _db }} "SELECT id FROM runs ORDER BY rowid DESC LIMIT 1" 2>/dev/null || echo ""); \
+    if [ -z "$$run_id" ]; then \
+        echo "⚠ no runs in DB — skipping recover"; \
+    else \
+        mayhem --db {{ _db }} recover execute "$$run_id"; \
+    fi
     @echo "✓ recover"
 
 # Janitor sweep (stale runs / resources)
 janitor: setup
     @echo "=== janitor ==="
-    mayhem --db {{ _db }} janitor sweep
+    mayhem --db {{ _db }} janitor
     @echo "✓ janitor"
 
 # ── campaign CRUD ────────────────────────────────────────────────────────────
@@ -125,14 +125,16 @@ janitor: setup
 # Create, list, show, start, abort, delete a campaign
 campaign: setup
     @echo "=== campaign ==="
-    mayhem --db {{ _db }} campaign create --name "e2e-campaign" --hypothesis "stack survives chaos"
+    mayhem --db {{ _db }} campaign create "e2e-campaign" --hypothesis "stack survives chaos"
     mayhem --db {{ _db }} campaign list
-    @cid=$$(sqlite3 {{ _db }} "SELECT id FROM campaigns ORDER BY rowid DESC LIMIT 1"); \
+    @cid=$$(sqlite3 {{ _db }} "SELECT id FROM campaigns WHERE name = 'e2e-campaign' ORDER BY rowid DESC LIMIT 1"); \
     mayhem --db {{ _db }} campaign show "$$cid"; \
     mayhem --db {{ _db }} campaign status "$$cid"; \
     mayhem --db {{ _db }} campaign start "$$cid" || true; \
-    mayhem --db {{ _db }} campaign abort "$$cid" || true; \
-    mayhem --db {{ _db }} campaign delete "$$cid"
+    mayhem --db {{ _db }} campaign abort "$$cid" || true
+    mayhem --db {{ _db }} campaign create "e2e-delete-campaign"
+    @delete_cid=$$(sqlite3 {{ _db }} "SELECT id FROM campaigns WHERE name = 'e2e-delete-campaign' ORDER BY rowid DESC LIMIT 1"); \
+    mayhem --db {{ _db }} campaign delete --yes "$$delete_cid"
     @echo "✓ campaign"
 
 # ── full round-trip ─────────────────────────────────────────────────────────
@@ -140,13 +142,13 @@ campaign: setup
 # Full lifecycle: validate → plan → run → status → history → recover
 full: setup
     @echo "=== full round-trip ==="
-    mayhem --db {{ _db }} validate {{ _spec }} --compose {{ _compose }}
-    mayhem --db {{ _db }} plan {{ _spec }} --compose {{ _compose }}
-    mayhem --db {{ _db }} run {{ _spec }} --compose {{ _compose }}
-    mayhem --db {{ _db }} status
+    mayhem --db {{ _db }} prepare validate {{ _spec }} --compose {{ _compose }}
+    mayhem --db {{ _db }} prepare plan {{ _spec }} --compose {{ _compose }}
+    mayhem --db {{ _db }} run {{ _spec }} --compose {{ _compose }} --execute
+    mayhem --db {{ _db }} inspect runs
     @run_id=$$(sqlite3 {{ _db }} "SELECT id FROM runs ORDER BY rowid DESC LIMIT 1"); \
-    mayhem --db {{ _db }} history "$$run_id"
-    mayhem --db {{ _db }} recover
+    mayhem --db {{ _db }} inspect history "$$run_id"; \
+    mayhem --db {{ _db }} recover execute "$$run_id"
     @echo "✓ full round-trip"
 
 # ── stack management ─────────────────────────────────────────────────────────
@@ -169,7 +171,7 @@ stack-down:
 # Run unit tests
 test-unit:
     @echo "=== unit tests ==="
-    python3 -m pytest tests/unit/ -v --tb=short
+    python3 -m pytest tests/unit/ -n {{ _workers }} --dist loadfile -v --tb=short
     @echo "✓ unit tests"
 
 # Run e2e tests (in-process, no containers needed)
@@ -190,6 +192,18 @@ lint:
     ruff check src/ tests/
     @echo "✓ lint"
 
+# Check the release truth baseline (docs/Justfile/packaging vs. the source)
+contract:
+    @echo "=== release contract ==="
+    python3 -m pytest tests/unit/test_release_contract.py -v --tb=short
+    @echo "✓ release contract"
+
+# Build the sdist and wheel
+build:
+    @echo "=== build ==="
+    python3 -m build --sdist --wheel
+    @echo "✓ build"
+
 # ── aggregate targets ────────────────────────────────────────────────────────
 
 # Quick smoke: topology + toolkit + config + experiment + validate + plan