docs: appendix — divergence catalogue and gaps reconciled with the refactored specs

[JarbasAl]

Brings the non-normative appendix in line with the refactored spec bodies:

divergences.md

• §5.2: records the <skill_id>:common_query → <skill_id>.common_query.request rename — the full-answer request is an addressed message, not a dispatch, so it moves off the colon shape MSG-1 §2.1.1 reserves for dispatch topics.
• §5.4: records STOP-1's no-escalation-on-silence behavior — a silent stoppability poll falls back to the recency-selected active_handlers target instead of escalating to a global stop.
• §5.4: records the TRANSFORM-1 priority-convention divergence — the reference implementation sorts descending (reverse=True), the exact inverse of the spec's ascending convention; inverse-convention assignments must be renumbered or the chain executes backwards.

gaps.md

• Drops the "per-plugin behavioural specs" gap — fallback, ocp, and persona now have their own specs (FALLBACK-1, OCP-1, PERSONA-1), closing the candidate list.
• persona_id removed from the unclaimed-session-fields list (claimed by OVOS-PERSONA-1).
• The bridge audio-over-bus gap is narrowed to what is still open: the outbound leg is covered by OVOS-AUDIO-1 (ovos.utterance.speak.b64 → ovos.audio.speech, base64 payloads on ovos.audio.queue/play_sound); only inbound satellite-to-hub raw-audio transport remains undefined.

reference.md / rationale.md

• Fixes the "OVOS-MSG-1 v2 §2.1.2" mislabels — the topic conventions live under MSG-1 §2.1, and MSG-1 is not cited by a v2 class.

No appendix page describes SYSTEM_confirm/SYSTEM_select or the player time convention, so no reconciliation was needed there; the appendix banners (non-normative headers) are untouched. Non-normative — no CHANGELOG entry.

🤖 Generated with Claude Code

[coderabbitai]

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: f78b5079-8ba8-4484-8bc9-fe5f65fdd2b1

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/appendix-reconcile

---

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.}