docs: add prerelease-quirks changelog since 0.8.5

[JarbasAl]

🤖 Auto-generated by Claude Fable 5 (claude-fable-5) via Claude Code — NOT human-reviewed. Verify before acting.

Adds docs/prerelease-quirks.md, a running changelog of user-visible behavior changes since the last stable release (0.8.5). This alpha train has run a long time without a stable cut, so the page covers 0.9.0a1 through current HEAD, newest first, and resets at the next stable release.

Covers the FakeBus intent-topic bridge and its capture-firehose semantics, the on()/once() registration-idempotency fix, the DNS-probe socket leak fix, and the earlier namespace-migration/AsyncFakeBus/ovos-spec-tools adoption stretch. Linked from README.md and docs/index.md.

Verified against current source: the FakeBus intent-topic bridge, the on()/once() dedup-wrapper reuse, and the DNS-probe socket fix, all read directly from ovos_utils/fakebus.py and network_utils.py. The earlier 0.13.0a1-0.13.9a1 entries come from CHANGELOG.md and commit messages and were not independently re-verified against source.

Test plan: docs-only change, no code touched; markdown links checked by hand.

Summary by CodeRabbit

• Documentation
  • Added prerelease documentation covering changes and known limitations from alpha releases through the current version.
  • Documented updates to networking, file watching, namespace behavior, asynchronous utilities, language tags, and dependency handling.
  • Added links to the prerelease notes from the README and documentation index.

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 75881a1b-3a0a-4628-b03e-30fd33860d08

📥 Commits

Reviewing files that changed from the base of the PR and between cc6660b and 897cbb4.

📒 Files selected for processing (3)

• README.md
• docs/index.md
• docs/prerelease-quirks.md

---

📝 Walkthrough

Walkthrough

Added a prerelease quirks page covering behavior changes from alpha releases through the current HEAD. Added links to the page in the README and documentation index.

Changes

Prerelease documentation

Layer / File(s)	Summary
Prerelease behavior reference docs/prerelease-quirks.md	Documents changes to DNS handling, FakeBus, file watching, Python compatibility, namespace migration, language tags, dependencies, and known residual warnings.
Documentation navigation README.md, docs/index.md	Links to the prerelease quirks page from the README and Further Reading section.

Estimated code review effort: 1 (Trivial) | ~5 minutes

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/prerelease-quirks

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[github-actions]

I've completed my sweep! Here's the situation. 🧹

I've aggregated the results of the automated checks for this PR below.

⚖️ License Check

I've checked the license history of this repo. 📜

✅ No license violations found.

Policy: Apache 2.0 (universal donor). StrongCopyleft / NetworkCopyleft / WeakCopyleft / Other / Error categories fail. MPL allowed.

📊 Coverage

Testing the limits! Here's the coverage breakdown. 📏

✅ 85.3% total coverage

Files below 80% coverage (5 files)

File	Coverage	Missing lines
ovos_utils/log_parser.py	48.4%	225
ovos_utils/__init__.py	63.6%	16
ovos_utils/file_utils.py	74.4%	56
ovos_utils/thread_utils.py	76.9%	12
ovos_utils/geolocation.py	78.4%	22

Full report: download the coverage-report artifact.

📋 Repo Health

Ensuring the repo's immune system is strong (aka security checks). 🛡️

✅ All required files present.

Latest Version: 0.13.12a1

✅ ovos_utils/version.py — Version file
✅ README.md — README
✅ LICENSE — License file
✅ pyproject.toml — pyproject.toml
⚠️ setup.py — setup.py
✅ CHANGELOG.md — Changelog
✅ ovos_utils/version.py has valid version block markers

🔒 Security (pip-audit)

Verifying the integrity of our digital supply chain. ⛓️

✅ No known vulnerabilities found (47 packages scanned).

🔍 Lint

I've finished the analysis you requested. 💡

❌ ruff: issues found — see job log

🏷️ Release Preview

Predicting the ripple effect of this release. 🌊

Current: 0.13.12a1 → Next: 0.13.12a2

Signal	Value
Label	(none)
PR title	docs: add prerelease-quirks changelog since 0.8.5
Bump	alpha

✅ PR title follows conventional commit format.

---

🚀 Release Channel Compatibility

Predicted next version: 0.13.12a2

Channel	Status	Note	Current Constraint
Stable	❌	Too new (must be <0.9.0)	ovos-utils>=0.8.1,<0.9.0
Testing	❌	Too new (must be <0.8.5)	ovos-utils>=0.8.4,<0.8.5
Alpha	✅	Compatible	ovos-utils>=0.13.10a2

🔨 Build Tests

Construction of your features is officially finished. 🏠

✅ All versions pass

Python	Build	Install	Tests
3.10	✅	✅	✅
3.11	✅	✅	✅
3.12	✅	✅	✅
3.13	✅	✅	✅
3.14	✅	✅	✅

---

Helping you push code with confidence 🚀