execweave 0.6.0__tar.gz

execweave-0.6.0/.github/workflows/ci.yml

@@ -0,0 +1,250 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+    tags: ["v*"]
+  pull_request:
+  workflow_dispatch:
+    inputs:
+      full_matrix:
+        description: Run the full 3-OS x Python 3.10/3.12 compatibility matrix
+        required: false
+        default: true
+        type: boolean
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ci-${{ github.ref }}
+  cancel-in-progress: ${{ github.event_name != 'workflow_dispatch' }}
+
+jobs:
+  plan:
+    runs-on: ubuntu-latest
+    outputs:
+      matrix: ${{ steps.matrix.outputs.matrix }}
+      mode: ${{ steps.matrix.outputs.mode }}
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - id: matrix
+        name: Choose CI matrix
+        shell: bash
+        env:
+          EVENT_NAME: ${{ github.event_name }}
+          REF_NAME: ${{ github.ref }}
+          BEFORE_SHA: ${{ github.event.before }}
+          BASE_SHA: ${{ github.event.pull_request.base.sha }}
+          CURRENT_SHA: ${{ github.sha }}
+          FULL_MATRIX: ${{ inputs.full_matrix }}
+        run: |
+          python - <<'PY'
+          import json
+          import os
+          import subprocess
+
+          event = os.environ.get("EVENT_NAME", "")
+          ref = os.environ.get("REF_NAME", "")
+          full_requested = os.environ.get("FULL_MATRIX", "").lower() == "true"
+
+          if ref.startswith("refs/tags/v") or (event == "workflow_dispatch" and full_requested):
+              mode = "full"
+              systems = ["ubuntu-latest", "macos-latest", "windows-latest"]
+              versions = ["3.10", "3.12"]
+          else:
+              before = os.environ.get("BEFORE_SHA", "")
+              base = os.environ.get("BASE_SHA", "")
+              current = os.environ.get("CURRENT_SHA", "HEAD")
+              if event == "pull_request" and base:
+                  diff_base = base
+              elif before and set(before) != {"0"}:
+                  diff_base = before
+              else:
+                  diff_base = f"{current}^"
+
+              try:
+                  output = subprocess.check_output(
+                      ["git", "diff", "--name-only", diff_base, current],
+                      text=True,
+                      stderr=subprocess.DEVNULL,
+                  )
+                  changed = [line.strip() for line in output.splitlines() if line.strip()]
+              except (subprocess.CalledProcessError, OSError):
+                  changed = ["src/"]
+
+              cross_platform_prefixes = (
+                  "src/",
+                  "tests/",
+                  "scripts/",
+                  ".github/workflows/",
+                  ".github/actions/",
+              )
+              cross_platform_files = {"pyproject.toml"}
+              cross_platform = any(
+                  path in cross_platform_files
+                  or any(path.startswith(prefix) for prefix in cross_platform_prefixes)
+                  for path in changed
+              )
+              mode = "cross-platform" if cross_platform else "quick"
+              systems = (
+                  ["ubuntu-latest", "macos-latest", "windows-latest"]
+                  if cross_platform
+                  else ["ubuntu-latest"]
+              )
+              versions = ["3.12"]
+
+          matrix = {
+              "include": [
+                  {"os": system, "python-version": version}
+                  for system in systems
+                  for version in versions
+              ]
+          }
+          print(f"CI mode: {mode}")
+          print(json.dumps(matrix, indent=2))
+          with open(os.environ["GITHUB_OUTPUT"], "a", encoding="utf-8") as handle:
+              handle.write(f"mode={mode}\n")
+              handle.write("matrix=" + json.dumps(matrix, separators=(",", ":")) + "\n")
+          PY
+
+  test:
+    needs: plan
+    name: test (${{ matrix.os }}, ${{ matrix.python-version }})
+    strategy:
+      fail-fast: false
+      matrix: ${{ fromJSON(needs.plan.outputs.matrix) }}
+    runs-on: ${{ matrix.os }}
+    timeout-minutes: 30
+
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: pip
+      - name: Install strace on Linux
+        if: runner.os == 'Linux'
+        run: command -v strace >/dev/null || (sudo apt-get update && sudo apt-get install -y strace)
+      - name: Install
+        run: python -m pip install -e ".[dev]"
+      - name: Ruff
+        run: ruff check .
+      - name: Tests
+        run: pytest -q
+      - name: Claude hook command smoke
+        run: python scripts/check_claude_hook.py
+      - name: Claude run-bound semantic and correlation smoke
+        run: execweave-claude-record --backend auto --no-files --no-network --output-dir claude-record-smoke -- python scripts/emit_claude_hook_smoke.py
+      - name: Validate Claude runtime stream
+        run: execweave validate claude-record-smoke/events.jsonl
+      - name: Validate Claude merged stream
+        run: execweave validate claude-record-smoke/events.semantic.jsonl
+      - name: Verify Claude semantic graph
+        run: python scripts/check_claude_record_graph.py claude-record-smoke/graph.semantic.json
+      - name: Validate automatic correlated stream
+        run: execweave validate claude-record-smoke/events.correlated.jsonl
+      - name: Verify automatic conservative correlation edge
+        run: python scripts/check_correlation_graph.py claude-record-smoke/graph.correlated.json
+      - name: Check correlated standalone viewer JavaScript syntax
+        run: python scripts/check_viewer_js.py claude-record-smoke/viewer.correlated.html --output claude-record-smoke/viewer.correlated.js
+      - name: Gemini run-bound semantic and correlation smoke
+        run: execweave-gemini-record --backend auto --no-files --no-network --output-dir gemini-record-smoke -- python scripts/emit_gemini_hook_smoke.py
+      - name: Validate Gemini runtime stream
+        run: execweave validate gemini-record-smoke/events.jsonl
+      - name: Validate Gemini merged stream
+        run: execweave validate gemini-record-smoke/events.semantic.jsonl
+      - name: Validate Gemini correlated stream
+        run: execweave validate gemini-record-smoke/events.correlated.jsonl
+      - name: Verify Gemini conservative correlation edge
+        run: python scripts/check_correlation_graph.py gemini-record-smoke/graph.correlated.json
+      - name: Check Gemini correlated viewer JavaScript syntax
+        run: python scripts/check_viewer_js.py gemini-record-smoke/viewer.correlated.html --output gemini-record-smoke/viewer.correlated.js
+      - name: Cursor run-bound semantic and correlation smoke
+        run: execweave-cursor-record --backend auto --no-files --no-network --output-dir cursor-record-smoke -- python scripts/emit_cursor_hook_smoke.py
+      - name: Validate Cursor runtime stream
+        run: execweave validate cursor-record-smoke/events.jsonl
+      - name: Validate Cursor merged stream
+        run: execweave validate cursor-record-smoke/events.semantic.jsonl
+      - name: Validate Cursor correlated stream
+        run: execweave validate cursor-record-smoke/events.correlated.jsonl
+      - name: Verify Cursor conservative correlation edge
+        run: python scripts/check_correlation_graph.py cursor-record-smoke/graph.correlated.json
+      - name: Check Cursor correlated viewer JavaScript syntax
+        run: python scripts/check_viewer_js.py cursor-record-smoke/viewer.correlated.html --output cursor-record-smoke/viewer.correlated.js
+      - name: OpenCode plugin installer smoke
+        run: execweave-opencode-plugin --install --root opencode-plugin-smoke
+      - name: OpenCode run-bound semantic and correlation smoke
+        run: execweave-opencode-record --backend auto --no-files --no-network --output-dir opencode-record-smoke -- python scripts/emit_opencode_plugin_smoke.py
+      - name: Validate OpenCode runtime stream
+        run: execweave validate opencode-record-smoke/events.jsonl
+      - name: Validate OpenCode merged stream
+        run: execweave validate opencode-record-smoke/events.semantic.jsonl
+      - name: Validate OpenCode correlated stream
+        run: execweave validate opencode-record-smoke/events.correlated.jsonl
+      - name: Verify OpenCode conservative correlation edge
+        run: python scripts/check_correlation_graph.py opencode-record-smoke/graph.correlated.json
+      - name: Check OpenCode correlated viewer JavaScript syntax
+        run: python scripts/check_viewer_js.py opencode-record-smoke/viewer.correlated.html --output opencode-record-smoke/viewer.correlated.js
+      - name: Model runtime CLI smoke
+        run: python scripts/check_model_runtime_cli.py
+      - name: Inference gateway CLI smoke
+        run: python scripts/check_inference_gateway_cli.py
+      - name: Collector diagnostics
+        run: execweave doctor
+      - name: Portable end-to-end smoke
+        run: execweave run --backend portable --no-files --no-network --output phase1-portable.jsonl -- python -c "print('execweave portable smoke')"
+      - name: Validate portable stream
+        run: execweave validate phase1-portable.jsonl
+      - name: Build semantic telemetry sidecar
+        run: python scripts/make_semantic_smoke.py phase1-portable.jsonl phase1-semantic.jsonl
+      - name: Merge semantic telemetry
+        run: execweave semantic-merge phase1-portable.jsonl phase1-semantic.jsonl --output phase1-semantic-merged.jsonl
+      - name: Validate semantic merged stream
+        run: execweave validate phase1-semantic-merged.jsonl
+      - name: Materialize semantic graph
+        run: execweave graph phase1-semantic-merged.jsonl --output phase1-semantic.graph.json
+      - name: Verify semantic graph relations
+        run: python scripts/check_semantic_graph.py phase1-semantic.graph.json
+      - name: Build semantic standalone viewer
+        run: execweave view phase1-semantic.graph.json --output phase1-semantic.html
+      - name: Materialize portable graph
+        run: execweave graph phase1-portable.jsonl --output phase1-portable.graph.json
+      - name: Build portable standalone viewer
+        run: execweave view phase1-portable.graph.json --output phase1-portable.html
+      - name: Check standalone viewer JavaScript syntax
+        run: python scripts/check_viewer_js.py phase1-portable.html --output phase1-portable.viewer.js
+      - name: Focus portable graph smoke
+        run: python -c "import json, subprocess; g=json.load(open('phase1-portable.graph.json', encoding='utf-8')); a=g['nodes'][0]['id']; subprocess.run(['execweave','graph-focus','phase1-portable.graph.json',a,'--hops','1','--output','phase1-portable.focus.graph.json'], check=True)"
+      - name: Build focused standalone viewer
+        run: execweave view phase1-portable.focus.graph.json --output phase1-portable.focus.html
+      - name: Condense portable graph smoke
+        run: execweave graph-condense phase1-portable.graph.json --output phase1-portable.compact.graph.json --threshold 2 --keep-expansion
+      - name: Build expandable condensed viewer
+        run: execweave view phase1-portable.compact.graph.json --output phase1-portable.compact.html
+      - name: Analyze portable graph smoke
+        run: execweave analyze phase1-portable.graph.json --output phase1-portable.analysis.json
+      - name: One-command record workflow smoke
+        run: execweave record --backend portable --no-files --no-network --output-dir record-smoke -- python -c "print('execweave record smoke')"
+      - name: Validate record workflow stream
+        run: execweave validate record-smoke/events.jsonl
+      - name: Live graph workflow smoke
+        run: execweave live --no-files --no-network --linger 0 --output-dir live-smoke -- python -c "import time; time.sleep(0.2)"
+      - name: Validate live workflow stream
+        run: execweave validate live-smoke/events.jsonl
+      - name: Summarize live workflow graph
+        run: execweave graph-summary live-smoke/graph.json
+      - name: Linux strace end-to-end smoke
+        if: runner.os == 'Linux'
+        run: execweave run --backend strace --no-network --output phase1-strace.jsonl -- python -c "from pathlib import Path; p=Path('ci-phase1.txt'); p.write_text('ok'); p.read_text(); p.unlink()"
+      - name: Validate Linux strace stream
+        if: runner.os == 'Linux'
+        run: execweave validate phase1-strace.jsonl
+      - name: Materialize Linux strace graph
+        if: runner.os == 'Linux'
+        run: execweave graph phase1-strace.jsonl --output phase1-strace.graph.json
+      - name: Phase 1 portable benchmark smoke test
+        if: runner.os == 'Linux' && matrix.python-version == '3.12'
+        run: execweave benchmark --backend portable --iterations 1

execweave-0.6.0/.github/workflows/package-benchmark.yml

@@ -0,0 +1,61 @@
+name: Package and reference benchmark
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - "pyproject.toml"
+      - "src/execweave/__init__.py"
+      - "src/execweave/overhead_benchmark.py"
+      - "tests/test_overhead_benchmark.py"
+      - ".github/workflows/package-benchmark.yml"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  package-benchmark:
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+          cache: pip
+      - name: Install build tooling and strace
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install build twine
+          command -v strace >/dev/null || (sudo apt-get update && sudo apt-get install -y strace)
+      - name: Build wheel and sdist
+        run: |
+          python -m build
+          python -m twine check dist/*
+          ls -lh dist/
+      - name: Install wheel in a clean environment
+        run: |
+          python -m venv .package-smoke
+          .package-smoke/bin/python -m pip install --upgrade pip
+          .package-smoke/bin/python -m pip install dist/*.whl
+          .package-smoke/bin/execweave --help >/dev/null
+          .package-smoke/bin/execweave-overhead --help >/dev/null
+      - name: Run reference overhead benchmark from installed wheel
+        run: |
+          .package-smoke/bin/execweave-overhead \
+            --iterations 7 \
+            --strace auto \
+            --output-json benchmark-results.json \
+            --output-svg benchmark-overhead.svg
+      - name: Upload package and benchmark artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: execweave-package-benchmark
+          path: |
+            dist/*
+            benchmark-results.json
+            benchmark-overhead.svg
+          if-no-files-found: error
+          retention-days: 30

execweave-0.6.0/.github/workflows/publish.yml

@@ -0,0 +1,61 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Verify release tag matches package version
+        env:
+          RELEASE_TAG: ${{ github.event.release.tag_name }}
+        run: |
+          python - <<'PY'
+          import os
+          import tomllib
+          from pathlib import Path
+
+          package_version = tomllib.loads(Path("pyproject.toml").read_text(encoding="utf-8"))["project"]["version"]
+          tag_version = os.environ["RELEASE_TAG"].removeprefix("v")
+          if tag_version != package_version:
+              raise SystemExit(
+                  f"release tag {tag_version!r} does not match package version {package_version!r}"
+              )
+          print(f"Publishing ExecWeave {package_version}")
+          PY
+      - name: Build and validate distributions
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install build twine
+          python -m build
+          python -m twine check dist/*
+      - uses: actions/upload-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+          if-no-files-found: error
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/execweave
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+      - name: Publish package distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

execweave-0.6.0/.gitignore

@@ -0,0 +1,10 @@
+__pycache__/
+*.py[cod]
+.pytest_cache/
+.ruff_cache/
+.venv/
+venv/
+dist/
+build/
+*.egg-info/
+.execweave/

execweave-0.6.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 GWW
+
+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 NONINFRINGEMENT. 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.