wavepeek 3.0.0

Release Notes

Added

• Added repeated-option syntax to value --at and documented the existing append semantics of value --signals, change --signals, and extract generic --payload, including mixed comma-separated values, order, and duplicates (issue #124).
• Added a framework-free browser Playground at the GitHub Pages root with the native WavePeek parser and engine compiled to WebAssembly, a bundled AXI FST demo, local VCD/FST processing, Surfer handoff, and native/browser parity checks.
• Added flat trailing [msb:lsb] projections to value --signals, change --signals, and extract generic payloads, including source-file payloads, projected change detection, and ordered duplicate entries (issue #94).
• Added result completeness metadata to bounded JSON and JSONL output, plus --summary to suppress result rows while retaining available context and diagnostics (issue #92).
• Added exact scope context and scope-relative paths to scoped signal, value, change, and extract generic JSON and JSONL output while retaining canonical paths (issue #114).
• Added scope-relative paths to signal JSON and JSONL entries while retaining leaf names and canonical paths (issue #82).

Changed

• Replaced the bundled Wavepeek skill with the v3 package, including task-oriented guides, generated CLI reference, time helper scripts, protocol scoreboard examples, and an output-diff example (issue #83, pull request #123).
• Changed change to emit every selected event with full signal values by default, added independent --row-mode dense|sparse and --row-values full|delta controls, and provided the version 2 sparse/full row shape through --row-mode sparse --row-values full; sparse comparisons now use the previous selected sample rather than the preceding dump timestamp (issue #85).
• Normalized successful JSON and JSONL results so JSON data is always an array, protocol metadata uses context, and streamed rows match JSON data elements (issue #106).
• Replaced the overlapping embedded documentation surfaces with wavepeek skill <DIRECTORY>, which extracts a complete version-matched package containing SKILL.md, flat offline references with explicit navigation, an examples directory, and a provenance manifest (issue #77).
• Flattened maintainer and tracking documentation under docs/, with branch-local tracked artifacts under docs/wip/.

Fixed

• Included ancestor context up to the root in filtered human-readable scope trees.
• Kept handled fatal errors machine-readable in JSON and JSONL output (issue #104).
• Normalized scope-relative signal labels in human-readable value, change, and extract generic output regardless of input path spelling, while retaining canonical labels with --abs (issue #113).
• Improved missing-signal errors to distinguish invalid paths from signals absent from the dump (issue #84).
• Report malformed hexadecimal expression literals at their full token span instead of blaming balanced opening parentheses, and underline expression diagnostic spans (issue #103).
• Accepted mixed relative and in-scope canonical signal paths across scoped value, change, property, and generic extraction queries (issue #81).

Removed

• Removed warning diagnostics for explicitly unlimited bounds and valid empty results; machine summaries retain those states and human empty results use normal stdout output (issue #102).
• Removed the Codex Web environment bootstrap; the devcontainer is now the supported development environment (issue #93).
• Removed JSON Schema generation, validation, publication, and the schema command while retaining JSON, JSONL, and structured-input behavior (issue #89).
• Removed the embedded topic browsing, search, display, and export helper command family (issue #77).

Install wavepeek 3.0.0

macOS and Linux:

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/kleverhq/wavepeek/releases/download/v3.0.0/wavepeek-installer.sh | sh

Windows PowerShell:

powershell -ExecutionPolicy Bypass -c "irm https://github.com/kleverhq/wavepeek/releases/download/v3.0.0/wavepeek-installer.ps1 | iex"

The installer places wavepeek under the configured XDG-style user binary path and does not require a Rust toolchain.

Download wavepeek 3.0.0

Platform	Archive	Checksum
Linux x86_64	wavepeek-x86_64-unknown-linux-gnu.tar.gz	wavepeek-x86_64-unknown-linux-gnu.tar.gz.sha256
Linux arm64	wavepeek-aarch64-unknown-linux-gnu.tar.gz	wavepeek-aarch64-unknown-linux-gnu.tar.gz.sha256
macOS Intel	wavepeek-x86_64-apple-darwin.tar.gz	wavepeek-x86_64-apple-darwin.tar.gz.sha256
macOS Apple Silicon	wavepeek-aarch64-apple-darwin.tar.gz	wavepeek-aarch64-apple-darwin.tar.gz.sha256
Windows x86_64	wavepeek-x86_64-pc-windows-msvc.zip	wavepeek-x86_64-pc-windows-msvc.zip.sha256

Additional release assets include wavepeek-installer.sh, wavepeek-installer.ps1, dist-manifest.json, source.tar.gz, and checksum files generated by cargo-dist.

Verify checksums

Download sha256.sum and the artifact you want, then run:

sha256sum --check sha256.sum --ignore-missing

Per-artifact checksum files are also available. For example:

sha256sum --check wavepeek-x86_64-unknown-linux-gnu.tar.gz.sha256

Verify GitHub Artifact Attestations

Download an artifact and verify its GitHub attestation with:

gh attestation verify wavepeek-x86_64-unknown-linux-gnu.tar.gz --repo kleverhq/wavepeek

FSDB support

Prebuilt binaries are VCD/FST-only. FSDB support remains source-only and requires a Linux x86_64 host with a valid Synopsys Verdi / FSDB Reader SDK environment:

cargo install --locked wavepeek --version 3.0.0 --features fsdb

Cargo fallback

If a prebuilt artifact is not suitable for your platform, install from crates.io with Rust:

cargo install --locked wavepeek --version 3.0.0

Documentation

Versioned documentation: https://kleverhq.github.io/wavepeek/3.0.0/

Latest documentation and installer aliases: https://kleverhq.github.io/wavepeek/

crates.io

Crates.io publication is handled by a downstream workflow; check https://crates.io/crates/wavepeek for current status.