execweave 0.6.1__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.1 → 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.1 → execweave-0.6.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: execweave
-Version: 0.6.1
+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,12 +75,22 @@ 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 v0.6.0 is packaged as a standard Python wheel/sdist. The repository is PyPI-ready; until the first Trusted Publisher release is made, install the package directly from GitHub:
+ExecWeave is published on PyPI as a standard Python wheel/sdist. Install the latest published release with:
+
+```bash
+python -m pip install -U execweave
+```
+
+The `main` branch may contain a newer patch than the current PyPI release. To test the latest mainline build directly:
 
 ```bash
-python -m pip install "execweave @ git+https://github.com/Irish-kw/ExecWeave.git@main"
+python -m pip install --upgrade --force-reinstall "execweave @ git+https://github.com/Irish-kw/ExecWeave.git@main"
 ```
 
 For development:
@@ -86,18 +101,71 @@ cd ExecWeave
 python -m pip install -e ".[dev]"
 ```
 
-Once the first PyPI release is published, installation becomes:
+Live OS-runtime telemetry works with **any local command**. The names below are examples, not a whitelist:
 
 ```bash
-python -m pip install execweave
+# Agent / IDE CLIs
+execweave live --open -- claude
+execweave live --open -- codex
+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
 ```
 
-Watch any command live:
+`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 live --open -- claude
+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
@@ -266,10 +334,24 @@ execweave run --backend portable -- your-command
 execweave run --backend strace -- your-command
 ```
 
+Since v0.6.1, child commands are resolved through a shared cross-platform launcher before execution. Linux and macOS retain normal PATH executable behavior. Windows resolves `.exe`, `.cmd`, and `.bat` launchers through PATH/PATHEXT, while an explicit `.ps1` launcher is invoked through PowerShell. Dedicated Windows CI exercises Codex and Cursor recorders from both `cmd.exe` and Windows PowerShell; the full Cursor semantic/correlation integration remains covered by the normal Windows, macOS, and Ubuntu matrix.
+
 Portable filesystem watching is session-correlated rather than process-causal, and short-lived processes can be missed between polling intervals. The Linux `strace` path captures process-attributed syscall evidence after the command exits.
 
 Future native collectors remain planned for Linux eBPF, Windows ETW, and macOS Endpoint Security.
 
+## v0.6.3 safety patch
+
+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.
+- Viewer layout/fit no longer spreads arbitrarily large arrays into `Math.min` / `Math.max`, and edge redraw during node dragging is animation-frame throttled.
+- The Live server tails only newly appended `events.jsonl` bytes from a byte offset and incrementally updates an in-memory `GraphAccumulator`. `/graph.json` polling no longer replays the full event history; an incomplete trailing JSONL line is buffered until its newline arrives.
+- Event-count or aggregate-count-only changes refresh Live stats/edge labels without a full topology redraw. After the Viewer budget is exceeded, live `/graph.json` switches to a counts-only compact payload while collection and the final canonical validation/full `graph.json` continue unchanged.
+
+This is a polling + incremental-ingestion safety patch, not an SSE, SQLite, Rust, or Canvas architecture migration.
+
 ## Layered artifacts
 
 A provider-integrated run can produce:
@@ -321,9 +403,9 @@ Security findings remain explicit about evidence limits. A possible sensitive-fi
 
 ## Current status
 
-ExecWeave is currently **v0.6.0** 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, PyPI-ready wheel/sdist packaging, reproducible overhead benchmarking, and cross-platform CI on Python 3.10/3.12.
+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.
 
 ## Privacy
 
@@ -337,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)
@@ -353,4 +435,4 @@ Contributions are welcome, especially around native OS collectors, additional Ag
 
 ## License
 
-See [`LICENSE`](LICENSE).
+See [`LICENSE`](LICENSE).