Release 1.6.7a1

.github/workflows/build-tests.yml

@@ -11,5 +11,5 @@ jobs:
     secrets: inherit
     with:
       python_versions: '["3.10", "3.11", "3.12", "3.13", "3.14"]'
-      install_extras: 'audio,pydantic,media,listener'
+      install_extras: 'audio,pydantic,media,listener,bench'
       test_path: 'test/unittests/'

.github/workflows/coverage.yml

@@ -13,5 +13,5 @@ jobs:
       python_version: '3.11'
       coverage_source: 'ovoscope'
       test_path: 'test/unittests/'
-      test_extras: 'audio,pydantic,media,listener'
+      test_extras: 'audio,pydantic,media,listener,bench'
       min_coverage: 0

CHANGELOG.md

@@ -1,228 +1,84 @@
 # Changelog
 
-## [1.5.0a1](https://github.com/OpenVoiceOS/ovoscope/tree/1.5.0a1) (2026-07-02)
+## [1.6.7a1](https://github.com/OpenVoiceOS/ovoscope/tree/1.6.7a1) (2026-08-13)
 
-[Full Changelog](https://github.com/OpenVoiceOS/ovoscope/compare/1.4.0a1...1.5.0a1)
+[Full Changelog](https://github.com/OpenVoiceOS/ovoscope/compare/1.6.6a1...1.6.7a1)
 
 **Merged pull requests:**
 
-- feat: add a pipeline\_id filter to End2EndTest [\#112](https://github.com/OpenVoiceOS/ovoscope/pull/112) ([JarbasAl](https://github.com/JarbasAl))
+- fix: accept canonical spec topics in captured-stream assertions [\#136](https://github.com/OpenVoiceOS/ovoscope/pull/136) ([JarbasAl](https://github.com/JarbasAl))
 
-## [1.4.0a1](https://github.com/OpenVoiceOS/ovoscope/tree/1.4.0a1) (2026-06-29)
+## [1.6.6a1](https://github.com/OpenVoiceOS/ovoscope/tree/1.6.6a1) (2026-08-11)
 
-[Full Changelog](https://github.com/OpenVoiceOS/ovoscope/compare/1.3.0a1...1.4.0a1)
+[Full Changelog](https://github.com/OpenVoiceOS/ovoscope/compare/1.6.5a1...1.6.6a1)
 
 **Merged pull requests:**
 
-- feat: skill\_id lifecycle filter + eof\_count for End2EndTest [\#110](https://github.com/OpenVoiceOS/ovoscope/pull/110) ([JarbasAl](https://github.com/JarbasAl))
+- fix: drain pyee listeners before teardown to avoid reentrant-\_\_del\_\_ deadlock [\#132](https://github.com/OpenVoiceOS/ovoscope/pull/132) ([JarbasAl](https://github.com/JarbasAl))
 
-## [1.3.0a1](https://github.com/OpenVoiceOS/ovoscope/tree/1.3.0a1) (2026-06-29)
+## [1.6.5a1](https://github.com/OpenVoiceOS/ovoscope/tree/1.6.5a1) (2026-08-11)
 
-[Full Changelog](https://github.com/OpenVoiceOS/ovoscope/compare/1.2.0a1...1.3.0a1)
+[Full Changelog](https://github.com/OpenVoiceOS/ovoscope/compare/1.6.4a1...1.6.5a1)
 
 **Merged pull requests:**
 
-- feat: emit recognizer\_loop:audio\_output\_start in \_mock\_tts alongside audio\_output\_end [\#108](https://github.com/OpenVoiceOS/ovoscope/pull/108) ([JarbasAl](https://github.com/JarbasAl))
+- fix: resolve unbounded get\_response\(\) hang on FakeBus [\#130](https://github.com/OpenVoiceOS/ovoscope/pull/130) ([JarbasAl](https://github.com/JarbasAl))
 
-## [1.2.0a1](https://github.com/OpenVoiceOS/ovoscope/tree/1.2.0a1) (2026-06-29)
+## [1.6.4a1](https://github.com/OpenVoiceOS/ovoscope/tree/1.6.4a1) (2026-08-02)
 
-[Full Changelog](https://github.com/OpenVoiceOS/ovoscope/compare/1.1.0a2...1.2.0a1)
+[Full Changelog](https://github.com/OpenVoiceOS/ovoscope/compare/1.6.3a2...1.6.4a1)
 
 **Merged pull requests:**
 
-- feat: MockTTS publishes audio\_output\_end via the full bus \(faithful\) [\#106](https://github.com/OpenVoiceOS/ovoscope/pull/106) ([JarbasAl](https://github.com/JarbasAl))
+- fix: MiniCroft boots against older ovos-core SkillManager \(backwards compat\) [\#128](https://github.com/OpenVoiceOS/ovoscope/pull/128) ([JarbasAl](https://github.com/JarbasAl))
 
-## [1.1.0a2](https://github.com/OpenVoiceOS/ovoscope/tree/1.1.0a2) (2026-06-29)
+## [1.6.3a2](https://github.com/OpenVoiceOS/ovoscope/tree/1.6.3a2) (2026-07-31)
 
-[Full Changelog](https://github.com/OpenVoiceOS/ovoscope/compare/1.1.0a1...1.1.0a2)
+[Full Changelog](https://github.com/OpenVoiceOS/ovoscope/compare/1.6.3a1...1.6.3a2)
 
 **Merged pull requests:**
 
-- docs: clarify MockTTS bus.ee.emit rationale [\#104](https://github.com/OpenVoiceOS/ovoscope/pull/104) ([JarbasAl](https://github.com/JarbasAl))
+- docs: gui-testing.md matches the exact-match assertion semantics [\#125](https://github.com/OpenVoiceOS/ovoscope/pull/125) ([JarbasAl](https://github.com/JarbasAl))
 
-## [1.1.0a1](https://github.com/OpenVoiceOS/ovoscope/tree/1.1.0a1) (2026-06-29)
+## [1.6.3a1](https://github.com/OpenVoiceOS/ovoscope/tree/1.6.3a1) (2026-07-31)
 
-[Full Changelog](https://github.com/OpenVoiceOS/ovoscope/compare/1.0.2a1...1.1.0a1)
+[Full Changelog](https://github.com/OpenVoiceOS/ovoscope/compare/1.6.2a2...1.6.3a1)
 
 **Merged pull requests:**
 
-- feat: MockTTS — emit audio\_output\_end on delay for speak\_dialog\(wait=True\) [\#102](https://github.com/OpenVoiceOS/ovoscope/pull/102) ([JarbasAl](https://github.com/JarbasAl))
+- fix: Han audit round 2 — SkillApi retention, accuracy gate, false-green assertions, race windows [\#123](https://github.com/OpenVoiceOS/ovoscope/pull/123) ([JarbasAl](https://github.com/JarbasAl))
 
-## [1.0.2a1](https://github.com/OpenVoiceOS/ovoscope/tree/1.0.2a1) (2026-06-27)
+## [1.6.2a2](https://github.com/OpenVoiceOS/ovoscope/tree/1.6.2a2) (2026-07-31)
 
-[Full Changelog](https://github.com/OpenVoiceOS/ovoscope/compare/1.0.1a1...1.0.2a1)
+[Full Changelog](https://github.com/OpenVoiceOS/ovoscope/compare/1.6.2a1...1.6.2a2)
 
 **Merged pull requests:**
 
-- fix: MockTTS destructor must not stop the shared playback thread [\#100](https://github.com/OpenVoiceOS/ovoscope/pull/100) ([JarbasAl](https://github.com/JarbasAl))
+- docs: close the documentation audit gaps \(Han audit round 1\) [\#121](https://github.com/OpenVoiceOS/ovoscope/pull/121) ([JarbasAl](https://github.com/JarbasAl))
 
-## [1.0.1a1](https://github.com/OpenVoiceOS/ovoscope/tree/1.0.1a1) (2026-06-27)
+## [1.6.2a1](https://github.com/OpenVoiceOS/ovoscope/tree/1.6.2a1) (2026-07-31)
 
-[Full Changelog](https://github.com/OpenVoiceOS/ovoscope/compare/1.0.0a1...1.0.1a1)
+[Full Changelog](https://github.com/OpenVoiceOS/ovoscope/compare/1.6.1a1...1.6.2a1)
 
 **Merged pull requests:**
 
-- fix: guard None blacklisted\_skills/intents in final-session check [\#98](https://github.com/OpenVoiceOS/ovoscope/pull/98) ([JarbasAl](https://github.com/JarbasAl))
+- fix: Han audit round 1 — teardown safety, session isolation, harness lifecycle [\#118](https://github.com/OpenVoiceOS/ovoscope/pull/118) ([JarbasAl](https://github.com/JarbasAl))
 
-## [1.0.0a1](https://github.com/OpenVoiceOS/ovoscope/tree/1.0.0a1) (2026-06-25)
+## [1.6.1a1](https://github.com/OpenVoiceOS/ovoscope/tree/1.6.1a1) (2026-07-24)
 
-[Full Changelog](https://github.com/OpenVoiceOS/ovoscope/compare/0.22.1a1...1.0.0a1)
-
-**Breaking changes:**
-
-- feat!: audio harness on OVOS spec bus namespace [\#92](https://github.com/OpenVoiceOS/ovoscope/pull/92) ([JarbasAl](https://github.com/JarbasAl))
-
-## [0.22.1a1](https://github.com/OpenVoiceOS/ovoscope/tree/0.22.1a1) (2026-06-25)
-
-[Full Changelog](https://github.com/OpenVoiceOS/ovoscope/compare/0.22.0a1...0.22.1a1)
-
-**Merged pull requests:**
-
-- fix: pytest 9 compatibility for the pytest11 plugin [\#88](https://github.com/OpenVoiceOS/ovoscope/pull/88) ([JarbasAl](https://github.com/JarbasAl))
-
-## [0.22.0a1](https://github.com/OpenVoiceOS/ovoscope/tree/0.22.0a1) (2026-06-25)
-
-[Full Changelog](https://github.com/OpenVoiceOS/ovoscope/compare/0.21.1a1...0.22.0a1)
-
-**Merged pull requests:**
-
-- feat: stream audio frames through MiniListener for multi-frame decoders [\#86](https://github.com/OpenVoiceOS/ovoscope/pull/86) ([JarbasAl](https://github.com/JarbasAl))
-
-## [0.21.1a1](https://github.com/OpenVoiceOS/ovoscope/tree/0.21.1a1) (2026-06-25)
-
-[Full Changelog](https://github.com/OpenVoiceOS/ovoscope/compare/0.21.0a1...0.21.1a1)
-
-**Merged pull requests:**
-
-- fix: repair ovoscope record in-process path \(default\_pipeline kwarg + from\_message skill\_ids\) [\#85](https://github.com/OpenVoiceOS/ovoscope/pull/85) ([JarbasAl](https://github.com/JarbasAl))
-
-## [0.21.0a1](https://github.com/OpenVoiceOS/ovoscope/tree/0.21.0a1) (2026-06-25)
-
-[Full Changelog](https://github.com/OpenVoiceOS/ovoscope/compare/0.20.0a1...0.21.0a1)
-
-**Merged pull requests:**
-
-- feat: export ovos-media OCP harness from the package + add \[media\] extra [\#89](https://github.com/OpenVoiceOS/ovoscope/pull/89) ([JarbasAl](https://github.com/JarbasAl))
-
-## [0.20.0a1](https://github.com/OpenVoiceOS/ovoscope/tree/0.20.0a1) (2026-06-24)
-
-[Full Changelog](https://github.com/OpenVoiceOS/ovoscope/compare/0.19.4a1...0.20.0a1)
-
-**Merged pull requests:**
-
-- feat: assert\_template\_shown for SYSTEM\_\* GUI templates [\#83](https://github.com/OpenVoiceOS/ovoscope/pull/83) ([JarbasAl](https://github.com/JarbasAl))
-
-## [0.19.4a1](https://github.com/OpenVoiceOS/ovoscope/tree/0.19.4a1) (2026-06-17)
-
-[Full Changelog](https://github.com/OpenVoiceOS/ovoscope/compare/0.19.3a1...0.19.4a1)
-
-**Merged pull requests:**
-
-- fix\(tts-intelligibility\): normalise rendered audio to 16kHz mono before STT [\#81](https://github.com/OpenVoiceOS/ovoscope/pull/81) ([JarbasAl](https://github.com/JarbasAl))
-
-## [0.19.3a1](https://github.com/OpenVoiceOS/ovoscope/tree/0.19.3a1) (2026-06-17)
-
-[Full Changelog](https://github.com/OpenVoiceOS/ovoscope/compare/0.19.2a1...0.19.3a1)
-
-**Merged pull requests:**
-
-- fix\(tts-intelligibility\): transcode non-WAV engine output before scoring [\#79](https://github.com/OpenVoiceOS/ovoscope/pull/79) ([JarbasAl](https://github.com/JarbasAl))
-
-## [0.19.2a1](https://github.com/OpenVoiceOS/ovoscope/tree/0.19.2a1) (2026-06-16)
-
-[Full Changelog](https://github.com/OpenVoiceOS/ovoscope/compare/0.19.1a2...0.19.2a1)
-
-**Merged pull requests:**
-
-- fix\(tts-intelligibility\): score synthesis failures as total miss, not abort [\#77](https://github.com/OpenVoiceOS/ovoscope/pull/77) ([JarbasAl](https://github.com/JarbasAl))
-
-## [0.19.1a2](https://github.com/OpenVoiceOS/ovoscope/tree/0.19.1a2) (2026-06-15)
-
-[Full Changelog](https://github.com/OpenVoiceOS/ovoscope/compare/0.19.1a1...0.19.1a2)
-
-**Merged pull requests:**
-
-- feat: TTS end-to-end intelligibility harness [\#75](https://github.com/OpenVoiceOS/ovoscope/pull/75) ([JarbasAl](https://github.com/JarbasAl))
-
-## [0.19.1a1](https://github.com/OpenVoiceOS/ovoscope/tree/0.19.1a1) (2026-06-14)
-
-[Full Changelog](https://github.com/OpenVoiceOS/ovoscope/compare/0.19.0a3...0.19.1a1)
-
-**Merged pull requests:**
-
-- fix: drop removed 'path' arg from pytest\_pycollect\_makemodule hook \(pytest\>=8 compat\) [\#73](https://github.com/OpenVoiceOS/ovoscope/pull/73) ([JarbasAl](https://github.com/JarbasAl))
-
-## [0.19.0a3](https://github.com/OpenVoiceOS/ovoscope/tree/0.19.0a3) (2026-06-13)
-
-[Full Changelog](https://github.com/OpenVoiceOS/ovoscope/compare/0.19.0a2...0.19.0a3)
-
-**Merged pull requests:**
-
-- chore: remove agent-audit scratch files [\#71](https://github.com/OpenVoiceOS/ovoscope/pull/71) ([JarbasAl](https://github.com/JarbasAl))
-
-## [0.19.0a2](https://github.com/OpenVoiceOS/ovoscope/tree/0.19.0a2) (2026-06-13)
-
-[Full Changelog](https://github.com/OpenVoiceOS/ovoscope/compare/0.19.0a1...0.19.0a2)
-
-**Merged pull requests:**
-
-- docs: standardize NGI0 Commons Fund attribution [\#69](https://github.com/OpenVoiceOS/ovoscope/pull/69) ([JarbasAl](https://github.com/JarbasAl))
-
-## [0.19.0a1](https://github.com/OpenVoiceOS/ovoscope/tree/0.19.0a1) (2026-06-12)
-
-[Full Changelog](https://github.com/OpenVoiceOS/ovoscope/compare/0.18.0a1...0.19.0a1)
-
-**Merged pull requests:**
-
-- feat: MiniVoiceLoop + simple/classic listener bus-sequence harnesses [\#67](https://github.com/OpenVoiceOS/ovoscope/pull/67) ([JarbasAl](https://github.com/JarbasAl))
-
-## [0.18.0a1](https://github.com/OpenVoiceOS/ovoscope/tree/0.18.0a1) (2026-06-10)
-
-[Full Changelog](https://github.com/OpenVoiceOS/ovoscope/compare/0.17.1a1...0.18.0a1)
-
-**Merged pull requests:**
-
-- feat\(phal\): plugin\_factories for MiniPHAL and PHALTest [\#65](https://github.com/OpenVoiceOS/ovoscope/pull/65) ([JarbasAl](https://github.com/JarbasAl))
-
-## [0.17.1a1](https://github.com/OpenVoiceOS/ovoscope/tree/0.17.1a1) (2026-05-20)
-
-[Full Changelog](https://github.com/OpenVoiceOS/ovoscope/compare/0.17.0a1...0.17.1a1)
-
-**Merged pull requests:**
-
-- fix\(pipeline-harness\): default \_SinkSkill bus to FakeBus [\#62](https://github.com/OpenVoiceOS/ovoscope/pull/62) ([JarbasAl](https://github.com/JarbasAl))
-
-## [0.17.0a1](https://github.com/OpenVoiceOS/ovoscope/tree/0.17.0a1) (2026-05-14)
-
-[Full Changelog](https://github.com/OpenVoiceOS/ovoscope/compare/0.16.0a1...0.17.0a1)
-
-**Merged pull requests:**
-
-- feat\(intent-cases\): markdown reporter, baseline diff, auto-discovery, deterministic m2v warmup [\#60](https://github.com/OpenVoiceOS/ovoscope/pull/60) ([JarbasAl](https://github.com/JarbasAl))
-
-## [0.16.0a1](https://github.com/OpenVoiceOS/ovoscope/tree/0.16.0a1) (2026-05-14)
-
-[Full Changelog](https://github.com/OpenVoiceOS/ovoscope/compare/0.15.0a1...0.16.0a1)
-
-**Merged pull requests:**
-
-- feat\(intent-cases\): file-based intent test layout + pytest accuracy gate [\#58](https://github.com/OpenVoiceOS/ovoscope/pull/58) ([JarbasAl](https://github.com/JarbasAl))
-
-## [0.15.0a1](https://github.com/OpenVoiceOS/ovoscope/tree/0.15.0a1) (2026-05-14)
-
-[Full Changelog](https://github.com/OpenVoiceOS/ovoscope/compare/0.14.0a1...0.15.0a1)
+[Full Changelog](https://github.com/OpenVoiceOS/ovoscope/compare/1.6.0a1...1.6.1a1)
 
 **Merged pull requests:**
 
-- feat\(e2e\): reusable harness, bus helpers, and intent-registration shims [\#55](https://github.com/OpenVoiceOS/ovoscope/pull/55) ([JarbasAl](https://github.com/JarbasAl))
+- fix: restore SessionManager.bus when MiniCroft stops [\#116](https://github.com/OpenVoiceOS/ovoscope/pull/116) ([JarbasAl](https://github.com/JarbasAl))
 
-## [0.14.0a1](https://github.com/OpenVoiceOS/ovoscope/tree/0.14.0a1) (2026-05-14)
+## [1.6.0a1](https://github.com/OpenVoiceOS/ovoscope/tree/1.6.0a1) (2026-07-16)
 
-[Full Changelog](https://github.com/OpenVoiceOS/ovoscope/compare/0.13.1...0.14.0a1)
+[Full Changelog](https://github.com/OpenVoiceOS/ovoscope/compare/1.5.0...1.6.0a1)
 
 **Merged pull requests:**
 
-- feat: add NEBULENTO\_PIPELINE and PALAVREADO\_PIPELINE stage groups [\#54](https://github.com/OpenVoiceOS/ovoscope/pull/54) ([JarbasAl](https://github.com/JarbasAl))
+- feat: per-clip WakeWordProbe for benchmark/test harnesses [\#97](https://github.com/OpenVoiceOS/ovoscope/pull/97) ([JarbasAl](https://github.com/JarbasAl))
 
 
 

CONTRIBUTING.md

@@ -0,0 +1,35 @@
+# Contributing
+
+## Dev setup
+
+```bash
+git clone https://github.com/TigreGotico/ovoscope
+cd ovoscope
+pip install -e ".[pydantic]"
+```
+
+## Running tests
+
+```bash
+pytest test/unittests -q
+```
+
+The full suite (including live OVOS integration tests) is slower and more
+sensitive to the local environment; CI is the source of truth for whether a
+change is green.
+
+## Submitting a change
+
+- Branch off `dev`, not `master`.
+- Open a **draft** pull request into `dev`. The maintainer merges when it is
+  ready — do not merge your own PR.
+- Use [Conventional Commits](https://www.conventionalcommits.org/) for
+  commit messages (`feat:`, `fix:`, `docs:`, `refactor:`, `test:`, `chore:`).
+- Keep documentation in `docs/` and `README.md` in sync with any behaviour
+  change in the same PR.
+- Add or update tests for the behaviour you change.
+
+## License
+
+By contributing, you agree your contribution is licensed under the
+[Apache 2.0 License](LICENSE) that covers this project.

FAQ.md

@@ -0,0 +1,39 @@
+# FAQ
+
+Common questions and gotchas when using OvoScope.
+
+## Does OvoScope need a real OVOS install running?
+No. `MiniCroft` runs the skill manager and intent pipeline in-process on a
+`FakeBus` — there is no WebSocket server, no PulseAudio/audio stack, and no
+network access required for `record`/`run`/`diff`/`validate`. See
+[docs/index.md](docs/index.md) for what the in-process harness does and does
+not cover, and [docs/phal.md](docs/phal.md) / [docs/audio-testing.md](docs/audio-testing.md)
+for the separate PHAL and audio harnesses.
+
+## Why did my test fail with extra/missing messages I didn't expect?
+Only the keys you specify in `expected.data` and `expected.context` are
+checked — extra keys in the received message are ignored. If a message you
+didn't list is showing up as unexpected, check `ignore_messages` (see
+[docs/end2end-test.md](docs/end2end-test.md)) — some message types (e.g.
+`speak`, `ovos.skills.settings_changed`) are noisy or non-deterministic and
+are commonly filtered out.
+
+## My fixture recording is flaky / times out.
+Increase `--timeout` on `ovoscope record`, or the `timeout` kwarg on
+`End2EndTest.from_message`. If the skill under test depends on plugins that
+take time to warm up (e.g. `ovos-m2v-pipeline` syncing its label index),
+see `m2v_warmup` in [docs/intent-cases.md](docs/intent-cases.md) for how
+`ovoscope.intent_cases` handles that deterministically.
+
+## How do I test a skill that isn't installed as a plugin yet?
+Pass it via `extra_skills={"my-skill.test": MySkillClass}` to `MiniCroft` /
+`get_minicroft()` instead of `skill_ids`. See
+[docs/minicroft.md](docs/minicroft.md).
+
+## How do I test multiple languages?
+Pass `secondary_langs=[...]` to `get_minicroft()` so Adapt/Padatious
+register vocab for each locale. See "Multilingual Testing" in
+[docs/minicroft.md](docs/minicroft.md).
+
+## Where do I report a bug or ask something not covered here?
+Open an issue on [GitHub](https://github.com/TigreGotico/ovoscope/issues).

README.md

@@ -120,7 +120,10 @@ stages and deliberately excludes persona, Ollama, OCP, and m2v plugins.
 | [docs/minicroft.md](docs/minicroft.md) | `MiniCroft` and `get_minicroft()` reference |
 | [docs/capture-session.md](docs/capture-session.md) | `CaptureSession` internals |
 | [docs/end2end-test.md](docs/end2end-test.md) | `End2EndTest` full parameter reference |
+| [docs/e2e-pipeline-harness.md](docs/e2e-pipeline-harness.md) | `E2EPipelineHarness` — testing a single pipeline plugin against raw bus messages |
+| [docs/intent-cases.md](docs/intent-cases.md) | File-based intent test cases (`.intent.test`) via `register_intent_case_tests` |
 | [docs/pydantic-integration.md](docs/pydantic-integration.md) | Typed message models with `ovos-pydantic-models` |
+| [docs/cli.md](docs/cli.md) | `ovoscope` CLI — record/run/diff/validate/coverage/bus-coverage, plus `ovoscope-setup` |
 | [FAQ.md](FAQ.md) | Common questions and gotchas |
 ---
 
@@ -142,20 +145,21 @@ under grant agreement No [101135429](https://cordis.europa.eu/project/id/1011354
 ---
 
 ## License
+
 [Apache 2.0](LICENSE)
+
 ---
+
 ## Contributing
+
 PRs are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
 ---
+
 ## AI Disclosure
-Parts of this project are developed with the assistance of AI tools.
-In the interest of transparency, two files are maintained as a public record of AI involvement:
-- **[FAQ.md](FAQ.md)** — Frequently asked questions that emerged from real development sessions,
-  including design rationale, gotchas, and usage patterns. Many entries were authored or
-  refined with AI assistance during the process of building and testing this framework.
-- **[MAINTENANCE_REPORT.md](MAINTENANCE_REPORT.md)** — A chronological log of changes made to
-  this repository. Each entry records what was changed, why, which AI model was involved, what
-  actions it took, and what human oversight was applied. This log is updated after every
-  significant AI-assisted session.
-These files are intentionally published so that contributors and users can understand how the
-project evolves and where AI assistance has been applied.
+
+Parts of this project — including code, tests, and documentation — are developed with the
+assistance of AI coding agents, under human review before merge. Commit messages and pull
+request descriptions in the [git history](https://github.com/TigreGotico/ovoscope/commits/dev)
+and [CHANGELOG.md](CHANGELOG.md) note when a change originated from an AI-assisted session, so
+contributors and users can see where AI assistance has been applied.

docs/bus-coverage.md

@@ -174,4 +174,4 @@ If you are building custom tooling, you can access these values via `SkillBusCov
 *   `observed_emitter_pct`: `(observed_emitters / total_emitters) * 100`
 *   `asserted_emitter_pct`: `(asserted_emitters / total_emitters) * 100`
 
-Source: `SkillBusCoverage` — `ovoscope/bus_coverage.py:118`
+Source: `SkillBusCoverage` — `ovoscope/bus_coverage.py`