execweave 0.6.2__tar.gz → 0.6.3__tar.gz

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

@@ -0,0 +1,34 @@
+name: Documentation i18n
+
+on:
+  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 German, French, and Russian structural parity
+        run: python scripts/audit_i18n_parity.py --languages fr de ru

execweave-0.6.3/.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.3}/.github/workflows/publish.yml

@@ -74,4 +74,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.3/.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.3/.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.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: execweave
-Version: 0.6.2
+Version: 0.6.3
 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,10 @@ 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-viewer.png" alt="ExecWeave Live execution graph" width="100%">
+</p>
+
 ## Install
 
 ExecWeave is published on PyPI as a standard Python wheel/sdist. Install the latest published release with:
@@ -92,19 +101,71 @@ 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. It does **not** automatically inject Agent semantic hooks, model-runtime API metadata, or inference-gateway routing metadata into the Live Viewer.
+
+#### Live capability matrix
+
+| Integration | Direct OS-runtime live | Specialized metadata | Automatically in Live Viewer |
+| --- | --- | --- | --- |
+| Claude Code | Yes | `execweave-claude-record` / hooks | No |
+| OpenAI Codex | Yes | `execweave-codex-record` / hooks | No |
+| Gemini CLI | Yes | `execweave-gemini-record` / hooks | No |
+| Cursor | Yes | `execweave-cursor-record` / hooks | No |
+| OpenCode | Yes | `execweave-opencode-record` / plugin | No |
+| Ollama | Yes, when launched under ExecWeave (for example `ollama serve`) | `execweave-model-runtime event/probe --runtime ollama` | No |
+| llama.cpp | Yes, when its local server is launched under ExecWeave | `execweave-model-runtime event/probe --runtime llamacpp` | No |
+| vLLM | Yes, when its local server is launched under ExecWeave | `execweave-model-runtime event/probe --runtime vllm` | No |
+| 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` | No |
+| LiteLLM Proxy | Yes, when the local proxy is launched under ExecWeave | `execweave-inference-gateway event --gateway litellm` | No |
+| OpenRouter | No direct remote-service process; run the local client/Agent under `live` instead | `execweave-inference-gateway event/generation --gateway openrouter` | No |
+
+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.3-live -->
+### v0.6.3 live observability
+
+Use the same live session in either the browser or terminal:
+
+```bash
+execweave top -- codex          # Terminal dashboard
+execweave top --open -- codex   # Terminal + Web Viewer
+```
+
+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.
+
+`live` is a generic OS-runtime view rather than an integration whitelist. Specialized Agent semantic, model-runtime, and gateway metadata remain separate evidence layers and are not automatically injected into the Live Viewer in v0.6.3.
+
+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 +340,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,7 +403,7 @@ 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.3** 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.
 
@@ -358,7 +419,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)