execweave 0.6.2__tar.gz → 0.6.4__tar.gz

execweave-0.6.4/.github/workflows/i18n.yml

@@ -0,0 +1,35 @@
+name: Documentation i18n
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [main]
+    paths:
+      - "README*.md"
+      - "docs/*.md"
+      - "scripts/audit_i18n_parity.py"
+      - "scripts/sync_i18n_nav.py"
+      - ".github/workflows/i18n.yml"
+  pull_request:
+    paths:
+      - "README*.md"
+      - "docs/*.md"
+      - "scripts/audit_i18n_parity.py"
+      - "scripts/sync_i18n_nav.py"
+      - ".github/workflows/i18n.yml"
+
+permissions:
+  contents: read
+
+jobs:
+  audit:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Check eight-language navigation and coverage
+        run: python scripts/sync_i18n_nav.py --check
+      - name: Check translation structural parity
+        run: python scripts/audit_i18n_parity.py --languages fr de ru

execweave-0.6.4/.github/workflows/package-smoke.yml

@@ -0,0 +1,42 @@
+name: Package Smoke
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - "pyproject.toml"
+      - "src/**"
+      - ".github/workflows/package-smoke.yml"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  wheel:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Build wheel and sdist
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install build twine
+          python -m build
+          python -m twine check dist/*
+      - name: Install clean wheel
+        shell: bash
+        run: |
+          wheel="$(ls dist/*.whl)"
+          python -m venv .wheel-smoke
+          .wheel-smoke/bin/python -m pip install --upgrade pip
+          .wheel-smoke/bin/python -m pip install "$wheel"
+      - name: Smoke installed entry points
+        shell: bash
+        run: |
+          .wheel-smoke/bin/execweave --help
+          .wheel-smoke/bin/execweave top --help
+          .wheel-smoke/bin/execweave-top --help
+          .wheel-smoke/bin/execweave-scalability --help

{execweave-0.6.2 → execweave-0.6.4}/.github/workflows/publish.yml

@@ -38,6 +38,8 @@ jobs:
           python -m pip install build twine
           python -m build
           python -m twine check dist/*
+      - name: Clean wheel install smoke
+        run: python scripts/check_wheel_install.py
       - uses: actions/upload-artifact@v4
         with:
           name: python-package-distributions
@@ -74,4 +76,4 @@ jobs:
         env:
           GH_TOKEN: ${{ github.token }}
           RELEASE_TAG: ${{ github.event.release.tag_name }}
-        run: gh release upload "$RELEASE_TAG" dist/* --clobber
+        run: gh release upload "$RELEASE_TAG" dist/* --clobber --repo "$GITHUB_REPOSITORY"

execweave-0.6.4/.github/workflows/scalability.yml

@@ -0,0 +1,54 @@
+name: Scalability Benchmark
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - "src/execweave/graph.py"
+      - "src/execweave/live.py"
+      - "src/execweave/scalability_benchmark.py"
+      - "pyproject.toml"
+      - ".github/workflows/scalability.yml"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  benchmark:
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Install package
+        run: python -m pip install -e .
+      - name: Run 10k / 100k / 1M benchmark
+        run: |
+          execweave-scalability \
+            --sizes 10000,100000,1000000 \
+            --resources 10000 \
+            --output-json scalability-results.json
+      - name: Validate benchmark invariants
+        run: |
+          python - <<'PY'
+          import json
+          from pathlib import Path
+
+          payload = json.loads(Path("scalability-results.json").read_text(encoding="utf-8"))
+          points = payload["points"]
+          assert [p["event_count"] for p in points] == [10_000, 100_000, 1_000_000]
+          assert all(p["retained_event_ids"] == 0 for p in points)
+          assert all(p["events_per_second"] > 0 for p in points)
+          assert all(p["snapshot_bytes"] > 0 for p in points)
+          assert points[-1]["node_count"] == 10_001
+          assert points[-1]["edge_count"] == 10_000
+          print(json.dumps(points, indent=2))
+          PY
+      - uses: actions/upload-artifact@v4
+        with:
+          name: execweave-scalability
+          path: scalability-results.json
+          if-no-files-found: error

execweave-0.6.4/.github/workflows/wheel-smoke.yml

@@ -0,0 +1,34 @@
+name: Wheel Install Smoke
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - "pyproject.toml"
+      - "src/execweave/**"
+      - "scripts/check_wheel_install.py"
+      - ".github/workflows/wheel-smoke.yml"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  wheel-smoke:
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+    runs-on: ${{ matrix.os }}
+    timeout-minutes: 15
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Build wheel
+        run: |
+          python -m pip install --upgrade build
+          python -m build --wheel
+      - name: Clean wheel install smoke
+        run: python scripts/check_wheel_install.py

{execweave-0.6.2 → execweave-0.6.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: execweave
-Version: 0.6.2
+Version: 0.6.4
 Summary: Turn AI-agent runtime behavior into a local interactive execution graph.
 Project-URL: Homepage, https://github.com/Irish-kw/ExecWeave
 Project-URL: Repository, https://github.com/Irish-kw/ExecWeave
@@ -56,13 +56,18 @@ Description-Content-Type: text/markdown
 
 # ExecWeave
 
+<!-- i18n-nav:start -->
 <p align="center">
   <strong>English</strong> |
   <a href="README.zh-TW.md">繁體中文</a> |
   <a href="README.zh-CN.md">简体中文</a> |
   <a href="README.ja.md">日本語</a> |
-  <a href="README.ko.md">한국어</a>
+  <a href="README.ko.md">한국어</a> |
+  <a href="README.fr.md">Français</a> |
+  <a href="README.de.md">Deutsch</a> |
+  <a href="README.ru.md">Русский</a>
 </p>
+<!-- i18n-nav:end -->
 
 **See what AI agents actually do on your machine.**
 
@@ -70,6 +75,31 @@ ExecWeave is an open-source, local-first observability project that turns AI-age
 
 > **Event is ground truth. The graph is a materialized view.**
 
+<p align="center">
+  <img src="docs/assets/execweave-launch-demo-v5-x.gif" alt="ExecWeave animated live demo" width="100%">
+</p>
+
+<!-- execweave-demo:start -->
+## Reproduce this demo
+
+The animation above is a real ExecWeave v0.6.3 live session. This workload deliberately creates enough activity to make the execution graph useful: multiple Python modules, JSON/CSV files, tests, file inspection, and outbound HTTP requests.
+
+Run a local Agent CLI under ExecWeave. For example:
+
+```bash
+execweave live --open -- claude
+```
+
+Then paste this workload prompt into the Agent:
+
+```text
+Create a small Python project in ./execweave-demo with 8 modules,
+generate sample JSON and CSV data, run the program and tests,
+inspect the generated files, and fetch example.com plus the GitHub API.
+```
+The same workload works with `codex`, `gemini`, `cursor`, or `opencode`. Exact node, edge, event, process, and endpoint counts vary by OS, Agent version, and environment. ExecWeave records observed runtime evidence; the animation is one concrete run, not a fixed expected graph.
+<!-- execweave-demo:end -->
+
 ## Install
 
 ExecWeave is published on PyPI as a standard Python wheel/sdist. Install the latest published release with:
@@ -92,19 +122,75 @@ cd ExecWeave
 python -m pip install -e ".[dev]"
 ```
 
-Watch Claude Code, OpenAI Codex, or Gemini CLI live:
+Live OS-runtime telemetry works with **any local command**. The names below are examples, not a whitelist:
 
 ```bash
-# Claude Code
+# Agent / IDE CLIs
 execweave live --open -- claude
-
-# OpenAI Codex
 execweave live --open -- codex
-
-# Gemini CLI
 execweave live --open -- gemini
+execweave live --open -- cursor
+execweave live --open -- opencode
+
+# Any local program
+execweave live --open -- python my_agent.py
+
+# A local model runtime launched under ExecWeave
+execweave live --open -- ollama serve
 ```
 
+`execweave live` streams process, file, and network evidence for the command tree it launches. In v0.6.4, configured Claude/Codex/Gemini/Cursor hooks and the OpenCode plugin automatically feed the per-run live sidecar. Ollama, llama.cpp, and vLLM server launches also receive automatic local model-catalog probes.
+
+#### Live capability matrix
+
+| Integration | Direct OS-runtime live | Specialized metadata | Automatically in Live Viewer |
+| --- | --- | --- | --- |
+| Claude Code | Yes | `execweave-claude-record` / hooks | Yes (configured hook/plugin) |
+| OpenAI Codex | Yes | `execweave-codex-record` / hooks | Yes (configured hook/plugin) |
+| Gemini CLI | Yes | `execweave-gemini-record` / hooks | Yes (configured hook/plugin) |
+| Cursor | Yes | `execweave-cursor-record` / hooks | Yes (configured hook/plugin) |
+| OpenCode | Yes | `execweave-opencode-record` / plugin | Yes (configured hook/plugin) |
+| Ollama | Yes, when launched under ExecWeave (for example `ollama serve`) | `execweave-model-runtime event/probe --runtime ollama` | Yes (automatic local probe) |
+| llama.cpp | Yes, when its local server is launched under ExecWeave | `execweave-model-runtime event/probe --runtime llamacpp` | Yes (automatic local probe) |
+| vLLM | Yes, when its local server is launched under ExecWeave | `execweave-model-runtime event/probe --runtime vllm` | Yes (automatic local probe) |
+| LM Studio | Yes only for a local process launched under ExecWeave; an already-running server is not attached | `execweave-model-runtime event/probe --runtime lmstudio` | Yes (automatic after successful `lms server start --port <port>`) |
+| LiteLLM Proxy | Yes, when the local proxy is launched under ExecWeave | `execweave-inference-gateway event --gateway litellm` / configured callback | Yes (configured callback) |
+| OpenRouter | No direct remote-service process; run the local client/Agent under `live` instead | `execweave-inference-gateway event/generation --gateway openrouter` | No |
+
+Agent rows marked **Yes** require the provider hook/plugin to be configured once; `execweave live` then supplies the per-run `EXECWEAVE_SEMANTIC_SIDECAR` automatically. Ollama, llama.cpp, and vLLM rows marked **Yes** use automatic loopback model-catalog probes only when ExecWeave launches the corresponding local server. LM Studio is also automatic for `lms server start` when an explicit `--port` is supplied, the compatible endpoint was absent before launch, and the launcher exits successfully. LiteLLM Proxy is **Yes** after its ExecWeave callback has been configured once and the proxy is launched inside the current `execweave live` environment. OpenRouter remains **No** because remote routing metadata is not available from OS/network observation alone.
+
+For an already-running Ollama server, use `execweave-model-runtime probe --runtime ollama` to snapshot loaded-model state. For OpenRouter, `live` can observe the local client and its network activity, while gateway routing/usage metadata remains a separate evidence layer.
+
+<!-- v0.6.4-live -->
+### v0.6.4 live observability
+
+`top` keeps the Agent fully interactive in the terminal where you launched it and opens the dashboard in a **separate terminal window**:
+
+```bash
+execweave top -- codex          # Agent here + detached Top dashboard
+execweave top --open -- codex   # Agent here + detached Top dashboard + Web Viewer
+```
+
+The detached dashboard is an attach-only client for the same localhost live session; it never launches a second Agent process. On Windows it uses a new console, on macOS it opens Terminal, and on desktop Linux it uses an available terminal emulator. In a headless environment, ExecWeave prints an attach command instead of taking over the Agent terminal.
+
+Live updates use incremental snapshots/deltas with bounded history instead of repeatedly rebuilding and transferring the full graph. Live and standalone viewers support a persistent Dark/Light theme switch. On Linux, very large recursive filesystem scopes are preflighted and automatically fall back from inotify to polling when needed, so an exhausted inotify watch pool does not abort the session.
+
+v0.6.4 gives each live run a shared specialized-evidence sidecar. Configured Claude Code, Codex, Gemini CLI, Cursor, and OpenCode integrations inherit that sidecar automatically, so their provider semantic evidence can appear incrementally beside OS-runtime evidence in the same live graph. This live normalization is provisional; after the command exits, the final graph is rebuilt from the canonical runtime + semantic merge. Missing specialized evidence is never invented.
+
+Run the reproducible graph scalability benchmark with `execweave-scalability`; CI covers 10k, 100k, and 1M synthetic events.
+
+#### Scalability benchmark
+
+Reference GitHub Actions result for the incremental `GraphAccumulator` synthetic workload (`retain_event_ids=False`):
+
+| Events | Apply time | Throughput | Nodes | Edges | Apply RSS Δ | Snapshot |
+| ---: | ---: | ---: | ---: | ---: | ---: | ---: |
+| 10k | 0.114 s | 87,681 ev/s | 10,001 | 10,000 | 35.9 MiB | 8.5 MiB |
+| 100k | 0.654 s | 152,816 ev/s | 10,001 | 10,000 | 25.8 MiB | 8.6 MiB |
+| **1M** | **6.087 s** | **164,273 ev/s** | **10,001** | **10,000** | **23.5 MiB** | **8.6 MiB** |
+
+At **1,000,000 events**, the incremental in-memory graph did not duplicate raw event IDs; raw evidence remains separate from the materialized graph. This benchmark measures graph accumulation and snapshot materialization, not end-to-end collector or browser throughput.
+
 Or build the full artifact pipeline:
 
 ```bash
@@ -279,9 +365,9 @@ Portable filesystem watching is session-correlated rather than process-causal, a
 
 Future native collectors remain planned for Linux eBPF, Windows ETW, and macOS Endpoint Security.
 
-## v0.6.2 safety patch
+## v0.6.3 safety patch
 
-v0.6.2 hardens long-running and high-cardinality sessions without changing evidence semantics or graph schema 0.1:
+v0.6.3 hardens long-running and high-cardinality sessions without changing evidence semantics or graph schema 0.1:
 
 - Broad recursive filesystem scopes such as a filesystem root, user home, or users-home parent are no longer recursively observed as-is; process, network, and semantic collection can continue.
 - Standalone and Live Viewers stop SVG materialization above the safety budget (1,500 nodes, 4,000 edges, or an estimated 5,000 SVG elements) instead of exhausting browser memory. The canonical `graph.json` evidence artifact remains complete.
@@ -342,9 +428,9 @@ Security findings remain explicit about evidence limits. A possible sensitive-fi
 
 ## Current status
 
-ExecWeave `main` is currently **v0.6.2** and under active development.
+ExecWeave `main` is currently **v0.6.4** and under active development.
 
-The baseline includes runtime collection, graph materialization/querying, standalone/live Viewer, Claude/Codex/Gemini/Cursor/OpenCode semantic integrations, conservative Tool → Process correlation, OpenRouter/LiteLLM gateway metadata, Ollama/llama.cpp/vLLM/LM Studio runtime metadata, exact Gateway ↔ Model Runtime request identity, published PyPI wheel/sdist packaging, reproducible overhead benchmarking, cross-platform command-launcher compatibility, large-graph browser safety guards, incremental Live JSONL tail/cache, and cross-platform CI on Python 3.10/3.12.
+The baseline includes runtime collection, graph materialization/querying, standalone/live Viewer, detached terminal Top dashboard, provisional multi-layer live evidence with canonical final semantic merge, Claude/Codex/Gemini/Cursor/OpenCode semantic integrations, conservative Tool → Process correlation, OpenRouter/LiteLLM gateway metadata, Ollama/llama.cpp/vLLM/LM Studio runtime metadata, exact Gateway ↔ Model Runtime request identity, published PyPI wheel/sdist packaging, reproducible overhead benchmarking, cross-platform command-launcher compatibility, large-graph browser safety guards, incremental Live JSONL tail/cache, and cross-platform CI on Python 3.10/3.12.
 
 ## Privacy
 
@@ -358,7 +444,7 @@ Review artifacts before sharing them.
 - [`Phase 2 — Execution Graph`](docs/phase-2-execution-graph.md)
 - [`Live Graph`](docs/live-graph.md)
 - [`Semantic Telemetry`](docs/semantic-telemetry.md)
-- [`Claude Code Hooks`](docs/claude-code-hooks.md)
+- [`Claude Code Hooks`](docs/claude-hooks.md)
 - [`OpenAI Codex Hooks`](docs/codex-hooks.md)
 - [`Gemini CLI Hooks`](docs/gemini-hooks.md)
 - [`Cursor Hooks`](docs/cursor-hooks.md)
@@ -374,4 +460,4 @@ Contributions are welcome, especially around native OS collectors, additional Ag
 
 ## License
 
-See [`LICENSE`](LICENSE).
+See [`LICENSE`](LICENSE).