Skip to content

spec: gui-1.md — one player time convention; confirm/select reserved#108

Draft
JarbasAl wants to merge 1 commit into
devfrom
spec/gui-1
Draft

spec: gui-1.md — one player time convention; confirm/select reserved#108
JarbasAl wants to merge 1 commit into
devfrom
spec/gui-1

Conversation

@JarbasAl

@JarbasAl JarbasAl commented Jul 4, 2026

Copy link
Copy Markdown
Member

Refines OVOS-GUI-1 for internal purity.

Changes

  • One time convention across the player templates: SYSTEM_audio_player position/duration now count in milliseconds with -1 = unknown/live, matching SYSTEM_media_player. Two templates sharing one screen role must not disagree on units; a normative paragraph states the uniform convention.
  • SYSTEM_confirm / SYSTEM_select → reserved for a future version (§3.4, §7.2). Their display leg is trivial, but the reply leg (interaction event carrying the answer) has no specified topic or payload schema — an unspecified reply makes the templates unimplementable interoperably. Names stay reserved so applications cannot claim them; producers MUST NOT emit them in this version. Conformance items referencing the reply leg removed (§8.1, §8.5).
  • __idle: explicit false row; omitted-__idle deployment default now carries a RECOMMENDED value (30 s) instead of being fully unspecified — tuning value, so RECOMMENDED, not MUST.
  • Version 1 → 2: mandating ms where the pre-spec status quo used seconds is not backwards compatible (VERSIONING.md).
  • CHANGELOG entry appended under a new class-2 section.

🤖 Generated with Claude Code

Unify SYSTEM_audio_player on the SYSTEM_media_player convention:
position/duration in milliseconds, -1 = unknown/live — one convention
for one semantic pair of fields. Move SYSTEM_confirm / SYSTEM_select
to a reserved-for-future section: their reply leg has no specified
topic/payload, making them unimplementable interoperably; the names
stay reserved so applications cannot claim them. __idle gains an
explicit false row and a RECOMMENDED 30 s default for the omitted
case. Version bumps to 2 (incompatible with the pre-spec seconds
convention).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@coderabbitai

coderabbitai Bot commented Jul 4, 2026

Copy link
Copy Markdown

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: abb0dee3-19c5-4dbc-8c87-0ea0c421eabf

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

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

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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant