nwave-ai v3.13.0

nWave Framework v3.13.0

Release Date: 2026-04-28

Promoted from: v3.13.0rc1

Full Changelog: v3.12.2...v3.13.0

Installation

pipx install nwave-ai

Features

• feat(des): l1 token instrumentation captures Anthropic usage in audit log (#13) (d6cdb672)
• feat(install): cap backup retention to prevent silent disk consumption (#12) (9e7c427b)

Bug Fixes

• fix(test): prevent host git pollution from subprocess git tests (#14) (d06fc414)
• fix(docs): strip trailing whitespace in archived RCA blocking PR CI (357d3404)

Other Changes

• docs(backlog): track CRITICAL test pollution bug discovered today (d5814d14)
• docs(backlog): track Lean Wave Documentation epic (L6+L7+L8) (dcc8f482)
• chore(docs): archive 5 R-3 analysis docs + promote SSOT spec to architecture (8a77b4ba)
• docs(backlog): track post-DISTILL findings for backup-retention-policy (101fe4db)

nwave-ai v3.12.2

nWave Framework v3.12.2

Release Date: 2026-04-27

Promoted from: v3.12.2rc1

Full Changelog: v3.12.1...v3.12.2

Installation

pipx install nwave-ai

Bug Fixes

• fix(test): align pytest module attributes for xdist parallel safety (16695a14)
• fix(doctor): remove stale commands/ requirement (post-v2.8.0) (52b3369c)
• fix(install): per-component breakdown in sync mismatch error (1676aa96)
• fix(install): script/tmpl verifier accepts zero-expected as success (88e2d53a)
• fix(packaging): include utility scripts in PyPI wheel (585ace87)

Other Changes

• docs(backlog): track v3.13 install-test-coverage epic from ATD audit (d20cf70e)
• test(e2e): add PyPI-shape install chain regression guard (8c59738b)
• perf(test): parallelize pre-push e2e suite via xdist loadfile (60092320)
• docs(backlog): track skill resolution v2 design + nix flake feature requests (72d85277)

nwave-ai v3.12.1

nWave Framework v3.12.1

Release Date: 2026-04-26

Promoted from: v3.12.1rc3

Full Changelog: v3.12.0...v3.12.1

Installation

pipx install nwave-ai

Bug Fixes

• fix(packaging): include nwave_ai package in dev/RC wheels (92007e88)
• fix(tests,scripts): add tomllib Python 3.10 fallback for 3 bare imports (5197815a)
• fix(des): conditional typing.Self import for Python 3.10 compatibility (b5acfdb5)
• fix(packaging): restore nwave-ai console script entry point (d8317ea0)
• fix(attribution): use --git-common-dir for hooks resolution (54caac80)
• fix(test): isolate installer/uninstaller fixtures from ~/.config/opencode/ (a3208250)

Other Changes

• ci(release): unblock pypi-publish on floor-smoke-test design flaw (6e2d16c3)
• ci: assert interpreter matches matrix.python-version axis (bbbd385f)
• ci(release): add Python 3.10 floor smoke test before PyPI publish (2ca8826d)
• chore(lint): add _compat shim for typing-3.11+ backports (504b27ac)
• ci: bind cross-platform-tests pipenv to matrix python-version (c57aba5e)
• ci(release): add nwave-ai console script smoke check to validate jobs (9931987c)
• test(release): assert nwave-ai postcondition in patch_pyproject test (db17b0bd)
• test(packaging): add dedicated regression assertion for issue #41 (4d9f54e4)
• ci: add git_topology matrix axis to cross-platform-tests (959e92ce)
• refactor(attribution): extract git_hooks_paths helper + remove stale duplicate (644384ed)
• chore(evolution): archive dockerfile-to-testcontainers-migration + reduce-wheel-bloat-p1 (beb1c4c4)

nwave-ai v3.12.0

nWave Framework v3.12.0

Release Date: 2026-04-24

Promoted from: v3.12.0rc7

Full Changelog: v3.11.0...v3.12.0

Installation

pipx install nwave-ai

Features

• feat(build): offline install bundle builder (871903f9)
• feat(hooks): sessionStart emits substrate probe advisory (629de7d2)
• feat(hooks): substrate probe module wrapping run_doctor (8d9d7f24)
• feat(cli): register nwave-ai doctor subcommand (99df2e97)
• feat(doctor): wire 7 checks into runner and implement formatters (6304b30d)
• feat(doctor): implement 7 diagnostic checks for nwave-ai doctor (1f15a524)
• feat(doctor): scaffold nwave_ai.doctor module with DoctorContext (6b211e00)
• feat(installer): tool-aware remediation for VirtualEnvironmentCheck (a7692b83)
• feat(installer): detect uv and pipx tool venvs in is_virtual_environment (1fa5e90f)
• feat(installer): install DES shims to ~/.claude/bin and prepend PATH (36d06554)
• feat(des): add 5 Python shim source files for DES CLI (5dd9d4bf)
• feat(packaging): expose 5 DES CLI console scripts (4d1068b2)

Bug Fixes

• fix(test): restore PYTHONPATH=/src in pypi_install_container fixture (421dca68)
• fix(des_plugin): soft-skip config migration on read-only project dir (8647a8cc)
• fix(des_plugin): soft-skip bootstrap when project dir is read-only (010535c1)
• fix(release): pypi-publish (RC) needs pre-build DES step too (8d145228)
• fix(test): skip shim install assertion when ~/.claude/bin/ absent (7dc3a1b2)
• fix(ci): exclude e2e from CI test job — gated in release pipeline (68a3f65d)
• fix(test): correct PYTHONPATH in cross-platform portability tests (715e80cc)
• fix(release): unblock ci-gate + add validate-stable job (480da288)
• fix(release): correct force-include destination for pre-built DES tree (a71d68f2)
• fix(release): stop leaking src/des and scripts/ into public nwave-ai wheel (306884ec)
• fix(test): capture full installer stdout in e2e fixture (2ffff5d8)
• fix(test): restore phase 4 assertion invariants (wheel privacy scope + opencode markers) (0eb8effc)
• fix(test): section 7 build_dist uses writable copy of source (51ab458e)
• fix: substrate_probe coupling + test-install-matrix migration errors (aeafce89)
• fix: resolve 3 E2E failures blocking PyPI release (dad956b4)
• fix(doctor): eliminate false positives in des_module and hook_python_path (55e6a693)
• fix(hooks): issue #37 hook skills reminder points at real path (b9fd4c3e)
• fix(des): p1 wave-agnostic execution-log resolution in hooks (6a4b448f)
• fix(installer): p0 resolve /home/alexd in settings.json env.PATH (74bee03a)
• fix(build): apply feature f retrospective review concerns plus nits (6ac9d62a)
• fix(installer): p0 restore system paths when env.PATH empty at install (76f0fcc8)
• fix(doctor): frameworkFilesCheck handles realistic install layout (2fcc525b)
• fix(installer): add reopen Claude Code banner to install success (f1c9cd82)
• fix(installer): dependencyCheck remediation references current install path (f1d52115)
• fix(skills): replace PYTHONPATH invocations with DES shim names (6890bf84)
• fix(tests): opencode write guard test isolation (P0) (8a63f5a8)
• fix(installer): isolate attribution plugin tests via module-scope autouse fixture (f386e81d)

Other Changes

• test(wheel): remove xfails — fixed wheel is now on PyPI (3.12.0rc7) (e8b422a1)
• style(lint): use Path.chmod in des_plugin read-only regression test (158184ac)
• ci(release): clean dist/ before wheel build to avoid PyPI action reject (a24c9b35)
• ci(release): pypi-publish needs pyyaml for patch_pyproject.py (cfdc6d57)
• ci(release): grant actions:read to release workflows for ci-gate (89eea0e0)
• ci(release): ci-gate uses GITHUB_TOKEN, not App token (46513802)
• ci(release): migrate GH_TOKEN PAT to GitHub App token (0cdd916e)
• style(lint): clear 102 ruff errors blocking ci pipeline (8c340d01)
• test(infra): pin installer/uninstaller TUI tests to one xdist group (becbad6f)
• test(infra): xdist_group git_hooks marker on attribution tests (8913b171)
• ci(test): tier-aware pre-push with xdist parallelization (3 hooks fail-fast) (fab0096b)
• style(docs): strip trailing whitespace from analysis + rca docs (a215ace5)
• style(docs): strip trailing whitespace from fix-subagent-stop rca (a59a20f4)
• ci(hooks): pre-push runs full test suite instead of fast_gate + e2e only (1919556e)
• test(bugs): remove 7 stale @failing tags from bug-3 import-paths feature (d4bf3a89)
• test(e2e): phase 5 retire 17 Dockerfiles + wire e2e CI gate (95abd122)
• refactor(feature): rename fix-wheel-leaks-des-config-p0 to reduce-wheel-bloat-p1 (0900fce5)
• docs(claude): document repo topology and public/private channel matrix (ff18b421)
• docs(bugfix): fix-wheel-leaks 01-01 — investigation identifies root cause (223d42f6)
• docs(feature): open fix-wheel-leaks-des-config-p0 bugfix (RCA + roadmap) (06b6e696)
• chore(des): fix 01-03 outcome field to literal PASS in execution logs (9e6004d6)
• test(e2e): phase 4 migrate 6 complex Dockerfiles to testcontainers (5974984b)
• chore(des): sync deliver execution-log with bugfix log for step 01-02 (99c84384)
• test(e2e): phase 3 migrate 6 Dockerfiles to testcontainers (db50a232)
• test(e2e): phase 2 migrate verify-install + windows smoke (50a34991)
• chore(des): sync deliver log with step 01-02 phases for test-pyramid-rigor (200a7bfd)
• chore(evolution): archive test-pyramid-rigor (452b2f60)
• test(acceptance): add runtime-grade sibling assertions to top-2 Category A files (2367883b)
• test(acceptance): make Category D files hermetic; add meta-guard (1f73790f)
• test(meta): fast-gate source + CLI --help contracts (8edfe97f)
• chore(des): sync step 01-06 phases to deliver log for fix-prod-release-readiness (910fdd81)
• chore(des): sync step 01-06 execution log for fix-prod-release-readiness (66d8e5ba)
• test(e2e): complete testcontainers matrix for install verification (f24ba397)
• chore(des): sync deliver execution-log with 01-05 phases (08944053)
• refactor: apply Phase 4 review nits (C1 C2 C3) (c90cb1a9)
• refactor: rPP L1-L6 pass on fix-prod-release-readiness code (b60326a8)
• chore(evolution): archive fix-prod-release-readiness (c57d69e7)
• chore(des): sync deliver execution-log for step 01-03 GREEN+COMMIT (cf627575)
• test(e2e): runtime-grade regression via testcontainers scaffold (168983af)
• chore(des): add deliver execution-log.json for fix-prod-release-readiness step 01-01 (111d40ee)
• chore(evolution): archive fix-installer-home-not-expanded-p0 (74b81446)
• chore(evolution): archive fix-subagent-stop-hardcoded-deliver-p1 (d7aee2d8)
• chore(des): sync deliver stub log with actual bugfix execution (ec0244b7)
• chore(des): add deliver execution-log.json for p0 fix step 01-01 (64dcfd7b)
• refactor(installer): apply L1-L2 cleanup on feature B additions (0344d701)
• chore(evolution): archive retrospective rigor pass + P0 deviation (5d6a4ffd)
• docs: apply feature e retrospective review nits (dce5608a)
• refactor(des): apply feature d retrospective review nits (a87774c6)
• chore(evolution): archive fix-installer-path-overwrite-p0 (68589807)
• chore(evolution): archive offline-install (Feature F) (3e339d41)
• docs(guides): offline install guide for air-gapped environments (cea93a7c)
• chore(evolution): archive onboarding-docs (Feature E) (dad35dc2)
• docs(readme): progressive disclosure rewrite + team rollout guide (98daff5c)
• chore(evolution): archive install-substrate-probe (12220237)
• chore(evolution): archive nwave-doctor + apply review nits (f6b6962c)
• test(doctor): e2E regression tests for nwave-ai doctor (33fb2ddf)
• chore(evolution): archive install-uv-primary (221cd41e)
• docs(readme): elevate uv to primary install path (16ab218a)
• test(installer): regression tests for uv tool env detection (1176d717)
• chore(evolution): archive install-ux-quick-wins + apply review nits (19407f61)
• chore(evolution): archive fix-permission-prompts-des-cli (71fab149)
• refactor(des): apply Phase 4 review nits for fix-permission-prompts (0f6c0616)
• test(bugs): remove xfail marker after integration gate passes (362c24a5)
• refactor(des): main() accepts optional argv parameter (d5faf2e2)
• test(bugs): regression test for issue #36 permission prompts (bab81e5a)

nwave-ai v3.11.0

nWave Framework v3.11.0

Release Date: 2026-04-16

Promoted from: v3.11.0rc2

Full Changelog: v3.10.1...v3.11.0

Installation

pipx install nwave-ai

Features

• feat(des): session_start_handler applies pending update before other steps (7696c7bf)
• feat(des): uvPackageManagerAdapter using tool install --force @latest (9150f044)
• feat(des): pipxPackageManagerAdapter (6ff1f043)
• feat(des): apply() error paths — invalid version, partial failure (b8cb0f3e)
• feat(des): apply() error paths — network, binary missing, unknown PM (69278602)
• feat(des): observability banners on apply() start/success/failure (64940a98)
• feat(des): attempt cap state machine + property test (4d8c970a)
• feat(commands): add /nw-update slash command (auto-update-deferred 02-03) (1af6c368)
• feat(des): add package manager detector (pipx/uv/unknown) (f0b7cc7f)
• feat(des): walking skeleton acceptance tests for auto-update deferred (e578a4a9)
• feat(des): add PendingUpdateService + DESConfig flag I/O (4f4f3dde)
• feat(des): add PackageManagerPort + FakePackageManager (60ad1009)
• feat(des): add PendingUpdateFlag domain schema (0d4f46e5)
• feat(skills): elevator pitch test + demo command gate (70b9703d)
• feat(skills): spike probe→walking-skeleton two-phase flow (89c29d23)

Bug Fixes

• fix(commands): migrate /nw-update from tasks/nw to skills/nw-update (ff98c81f)
• fix(installer): remove interactive prompt from install flow (#fabio-rca) (a5496692)
• fix(ci): trailing newlines on deliver JSON artifacts (bba0ea76)
• fix(des): align /nw-update frontmatter with catalog + correct step 03-05 log (a62ce0d0)
• fix(tests): guard .git/hooks/ with session-scoped snapshot + restore (8dc7c4b2)

Other Changes

• docs(evolution): archive auto-update-deferred feature (07312a0a)
• refactor(des): address post-review findings — null PM, logged fail-open (a184415c)
• docs(des): auto-update-deferred coverage audit (06-01 + 06-02) (1ef8efd7)
• test(des): pATH-safety acceptance scenario (d782f285)
• test(des): add integration tests for flag file round-trip and atomic removal (a18ed3e3)
• test(des): add apply happy-path acceptance tests (pipx, uv, no-flag) (baa5073e)
• test(des): add request_update acceptance tests (pipx + uv) (6996c138)
• docs(readme): demote plugin marketplace, add uv install path (df1f8651)
• refactor(skills): revert hardening naming + kill duplicate distill docs (8316a242)

nwave-ai v3.10.1

nWave Framework v3.10.1

Release Date: 2026-04-15

Promoted from: v3.10.1rc1

Full Changelog: v3.10.0...v3.10.1

Installation

pipx install nwave-ai

Bug Fixes

• fix(des): ensure .nwave/.gitignore created on all runtime paths (6b241087)

Other Changes

• docs(opencode): rewrite design+distill feature docs for full enforcement (8a5539e2)

nwave-ai v3.10.0

nWave Framework v3.10.0

Release Date: 2026-04-15

Promoted from: v3.10.0rc1

Full Changelog: v3.9.0...v3.10.0

Installation

pipx install nwave-ai

Features

• feat(opencode): remove degraded mode from DES shim per ADR-OC-004 (de00c2b8)
• feat(e2e): opencode sub-agent hook regression smoke test (e18fb8f5)
• feat(docs): aDR-OC-004 full DES enforcement on OpenCode (b424b25a)
• feat(research): empirical probe of OpenCode sub-agent hook behavior (e1c96378)

Bug Fixes

• fix(opencode): migrate DES installer to forward-slash absolute paths (a5ee3c97)

Other Changes

• docs(opencode): annotate design docs as partially outdated by ADR-OC-004 (45ea7539)
• refactor(install_paths): remove dead .venv branch from resolve_python_command (e10c6218)
• ci(e2e): register opencode sub-agent hook smoke test (8421dcd7)
• chore(e2e): install nwave-ai from local source in smoke test (2d049c78)
• chore(pre-commit): move linting hooks from pre-commit to pre-push (f8e6b0c2)
• docs(research): add cross-platform dimension to python path spike (0c0f4687)
• docs(research): python path resolution pattern spike (7d50ebe6)
• docs(research): mark opencode-hook-bypass-status-2026-03 as superseded (95312c61)

nwave-ai v3.9.0

nWave Framework v3.9.0

Release Date: 2026-04-15

Promoted from: v3.9.0rc1

Full Changelog: v3.8.2...v3.9.0

Installation

pipx install nwave-ai

Features

• feat(release): attribute public-sync commits with all contributors (6dc7d6bd)
• feat(release): support appending co-author trailers to trace message (5e840f22)
• feat(release): add co-author collector for release-train sync commits (1f884ac9)
• feat(agents): add Earned Trust as core principle to architects (883f1e28)
• feat(discuss): elephant carpaccio discipline mandatory in Phase 2.5 (a64d4ab9)

Bug Fixes

• fix(agents): nw-solution-architect import-linter propagation drift (26d32ddb)
• fix(report): shard gh search by date so long-tail adopters aren't buried (87da00e8)
• fix(skills): f-1/F-2/F-3 process fixes + driving port boundary check (7e0cf82a)
• fix(finalize): preserve docs/feature/ directory (matrix depends on it) (97861fda)

nwave-ai v3.8.2

nWave Framework v3.8.2

Release Date: 2026-04-10

Promoted from: v3.8.2rc1

Full Changelog: v3.8.1...v3.8.2

Installation

pipx install nwave-ai

Bug Fixes

• fix(distill): restore Driving Adapter Verification (lost in SPIKE merge) (222673e2)
• fix(methodology): normalize docs/feature/ singular + add SPIKE wave (94e7bad9)

nwave-ai v3.8.1

nWave Framework v3.8.1

Release Date: 2026-04-10

Promoted from: v3.8.1rc1

Full Changelog: v3.8.0...v3.8.1

Installation

pipx install nwave-ai

Bug Fixes

• fix(distill): add Driving Adapter Verification section (RCA P1+P4) (45b27cf0)