GUI-1: GUI display subsystem specification

[JarbasAl]

OVOS-GUI-1 — GUI Display Subsystem specification

Adds a formal, implementation-agnostic specification for the OVOS GUI display
subsystem, in the same style as the existing specs (MSG-1, SESSION-1/2, INTENT-*).

ovos-gui-1.md (OVOS-GUI-1, Draft) covers:

• Model — applications declare what to display (semantic templates), not how;
  the GUI service is a pure state-and-dispatch hub.
• Closed template vocabulary — a curated set of SYSTEM_* templates (consistency
  across a varying display surface), full catalogue of all 22 templates with normative
  session-data keys/types; raw-passthrough (SYSTEM_html/SYSTEM_url) marked discouraged.
• Wire protocol — gui.value.set / gui.page.show (page_names, index, __from,
  __idle), reserved-key stripping, namespace lifecycle (builds on MSG-1).
• Addressing — session_id only; shared/multi-room screens share a session_id;
  no separate location dimension (builds on SESSION-1/2).
• Adapter contract — entry-point discovery, additive multi-modal fan-out, capability
  • graceful-degradation table, exception-safe / non-blocking / no-shared-state.
• Interaction — media transport + confirm/select responses carrying the
  originating session_id.
• Conformance — MUST/SHOULD for producers, the GUI service, and adapters.

Also wires OVOS-GUI-1 into README.md (index), CHANGELOG.md, and GLOSSARY.md.
Normative text is implementation-agnostic; code/toolkit names appear only in the
non-normative example.

[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: bd774752-35c9-4af5-bf5a-6345927d2263

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 feat/gui-spec

---

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