Implement circuit component and vm

.github/workflows/ci.yml

@@ -70,8 +70,10 @@ jobs:
         run: cargo test -p ppvm-stim --features rayon
 
   # Cross-compile the whole workspace for browser wasm so a wasm regression
-  # surfaces in CI. `ppvm-python-native` is a CPython extension (never a wasm
-  # target) and is excluded. Native-only acceleration deps (gxhash, dashmap →
+  # surfaces in CI. `ppvm-python-native` (a CPython extension) and `ppvm-cli`
+  # (a terminal binary using clap/rustyline) are never browser-wasm targets and
+  # are excluded; the reusable engine lives in the library crates, which stay
+  # covered. Native-only acceleration deps (gxhash, dashmap →
   # rayon, ahash) are pruned automatically by the `cfg(not(target_arch =
   # "wasm32"))` dependency tables, and `rand`'s entropy uses the getrandom
   # `wasm_js` backend wired in `.cargo/config.toml` — so no extra flags here.
@@ -89,7 +91,7 @@ jobs:
       - uses: Swatinem/rust-cache@v2
 
       - name: Build workspace for wasm32-unknown-unknown
-        run: cargo build --target wasm32-unknown-unknown --workspace --exclude ppvm-python-native
+        run: cargo build --target wasm32-unknown-unknown --workspace --exclude ppvm-python-native --exclude ppvm-cli
 
   python-tests:
     name: Python tests

.gitignore

@@ -6,6 +6,7 @@
 .uv/
 *__pycache__*
 profile.json.gz
+debug/
 
 # mkdocs build output and cache
 ppvm-python/site/

AGENTS.md

@@ -24,9 +24,10 @@ ion add QuEraComputing/ppvm/skills/ppvm-usage
 
 The skill (`skills/ppvm-usage/SKILL.md` in this repo) covers the Heisenberg /
 Schrödinger gate-order trap, `Config`-generic `PauliSum` usage, truncation
-strategies, and Python / Rust call sites for both backends. Read it before
-the Developer Guide if your task is *using* ppvm rather than modifying its
-internals.
+strategies, Python / Rust call sites for both backends, and the `.sst`
+textual program format run by `ppvm-cli` (backend selection, multi-term
+observables, `gate trace` / `gate truncate`). Read it before the Developer
+Guide if your task is *using* ppvm rather than modifying its internals.
 
 ## TL;DR for agents