id: design: custom GUI rendering as first-class overrides (from #5679)

Summary

Follow-on design ticket from #5679 — its decomposition sketch names this as a separate design, and the parent's acceptance requires these tickets to be filed and linked. Filed in the 2026-11-04 gap pass (WS-F) so the design work exists and can be prioritised on its own merits; implementation timing is a separate decision, possibly months out.

What this design must settle

Wholly custom presentations — image buttons, drawn controls — as first-class overrides of the standard renderings, not hacks around them.

Context from the parent

The parent design fixes the semantic markup + style-assertion model by which programs-as-websites render across web, native, and custom targets. The parent issue carries the surrounding decisions this ticket must not re-decide; where this ticket's answer would change a parent decision, record that explicitly rather than silently forking it.

Decision record expected

Close this design with a recorded decision (on this issue or in a doc/ record linked from it): the chosen shape, the alternatives rejected and why, and the invariants implementation must hold. If the design splits further, file the splits and link them here rather than growing this issue.

Relations

Parent: #5679. Programme: epic #2056. Filed by WS-F (2026-11-04 ID design gap & expansion pass).

CODE-1536

Triage outcome — task 10256 (2026-11-05, lane code-p)

Verdict: CONFIRMED as a valid standalone design ticket — routed with its tier-2 dependency recorded. It should not be designed before the vocabulary tickets settle.

Fresh verification (2026-11-05): issue #5853 OPEN, labels task/triage + queue/queued + app/id — no hard-stop labels, no prior comments beyond the tracking link. Parent #5679 (Markup & styling model for programs-as-websites) is OPEN and was triaged today (task 10112, lane code-h): grandparent #2146 is CLOSED, the gap pass filed all seven children #5849–#5855, all OPEN. No doc/ record covers custom GUI rendering overrides (doc/ hits are a screen-render alignment feature note and a remote-GUI runbook — neither is this design), and no other issue covers it.

Ordering (from the parent triage, task 10112 — dependencies, not a schedule):

id: design: semantic markup vocabulary v1 (from #5679) #5849 (semantic markup vocabulary v1) + id: design: style assertion vocabulary (from #5679) #5850 (style assertion vocabulary) first — every rendering ticket maps from the settled vocabularies.
id: design: web rendering: assertion → Tailwind mapping (from #5679) #5851 / id: design: native rendering: assertion → OS-standard controls (from #5679) #5852 / id: design: custom GUI rendering as first-class overrides (from #5679) #5853 next, in parallel — each maps the vocabularies to one target class; this ticket is the custom-target one.
id: design: per-target customisation system (from #5679) #5854 (per-target customisation) after the rendering tickets; id: design: rendering pipeline & conformance suite (from #5679) #5855 (pipeline & conformance) last.

So #5853's design start is gated on the #5849/#5850 decision records existing — not on Drew, and not on its tier-2 siblings #5851/#5852.

Boundary discipline for the design:

Settle only: wholly custom presentations (image buttons, drawn controls) as FIRST-CLASS overrides of the standard renderings — the override mechanism, what a custom presentation declares, and how it composes with the parent's semantic markup + style-assertion model.
Do NOT re-decide the parent model; conflicts get recorded on id: design: Markup & styling model for programs-as-websites — semantic markup, style-override mapping #5679, not forked.
Do NOT swallow id: design: per-target customisation system (from #5679) #5854: override maps and asset substitution as a per-target customisation system are id: design: per-target customisation system (from #5679) #5854's scope, defined against the rendering tickets afterwards. This ticket settles the custom-presentation mechanism id: design: per-target customisation system (from #5679) #5854 will reference.
Deliverable is the ticket's own decision record (chosen shape, alternatives rejected and why, implementation invariants), on the issue or in a doc/ record linked from it. Implementation timing is a separate later decision.

Routing: follow-up design task enqueued with the tier-2 dependency stated in its packet (a worker claiming it early must check #5849/#5850 state first and park with that reason if the records do not yet exist).

agent-note:v1
{"kind": "triage", "task": 10256, "issue": 5853, "state": "done", "outcome": "confirmed_design_ticket_routed_tier2_dependency", "evidence": "parent #5679 triaged today (task 10112) with ordering #5849+#5850 first, #5851/#5852/#5853 parallel next; all children OPEN; no doc/ record for custom GUI overrides"}

🤖 Agent note · handed off

Agent: queue worker (repo-worker-code), lane code-v
Session / ID: task 10500
Found via: queue claim
Task: Design issue id: design: custom GUI rendering as first-class overrides (from #5679) #5853 (decision record) — assigned to the opencode execution lane; handed off to the laptop claimant, not worked by this lane.
Expectation: claimant launches the bound opencode session for task 10500.
Links: n/a

🤖 Agent note · handed off

Agent: queue worker (repo-worker-code), lane code-o
Session / ID: task 10500
Found via: queue claim
Task: Queue work for issue id: design: custom GUI rendering as first-class overrides (from #5679) #5853 assigned to the opencode execution lane — handing off, not working directly.
Expectation: The opencode-claimant launches a bound session for task 10500; issue id: design: custom GUI rendering as first-class overrides (from #5679) #5853 verified OPEN fresh (2026-11-05).
Links: issue id: design: custom GUI rendering as first-class overrides (from #5679) #5853

🤖 Agent note · handed off

Agent: queue worker (repo-worker-code), lane code-k
Session / ID: task 10500
Found via: queue claim
Task: Handing off task 10500 for issue id: design: custom GUI rendering as first-class overrides (from #5679) #5853 to the opencode execution lane; claimant launches the bound opencode session. Fresh re-check at handoff (2026-11-05T17:33:33Z): issue id: design: custom GUI rendering as first-class overrides (from #5679) #5853 OPEN, no hard-stop labels (held / user/owned / do-not-merge / do-not-auto-edit).
Expectation: opencode claimant session drives task 10500 to a terminal state.
Links: issue id: design: custom GUI rendering as first-class overrides (from #5679) #5853

🤖 Agent note · handed off

Agent: queue worker (repo-worker-code), lane code-l
Session / ID: task 10500
Found via: queue claim
Task: small_fix issue id: design: custom GUI rendering as first-class overrides (from #5679) #5853: id: design: custom GUI rendering as first-class overrides (from id: design: Markup & styling model for programs-as-websites — semantic markup, style-override mapping #5679) — execution lane assigned opencode; handing off to the laptop opencode claimant, which launches the bound session. Fresh check: issue id: design: custom GUI rendering as first-class overrides (from #5679) #5853 OPEN, no hard-stop labels.
Expectation: claimant's bound opencode session drives task 10500 to a terminal state; this lane does not work it directly.
Links: task 10500 · issue id: design: custom GUI rendering as first-class overrides (from #5679) #5853

🤖 Agent note · handed off

Agent: queue worker (repo-worker-code), lane code-h
Session / ID: task 10500
Found via: queue claim
Task: Handing off task 10500 for issue id: design: custom GUI rendering as first-class overrides (from #5679) #5853 to the opencode execution lane; claimant launches the bound opencode session. Fresh re-check at handoff: issue id: design: custom GUI rendering as first-class overrides (from #5679) #5853 OPEN, no hard-stop labels (held / user/owned / do-not-merge / do-not-auto-edit).
Expectation: opencode claimant session drives task 10500 to a terminal state.
Links: issue id: design: custom GUI rendering as first-class overrides (from #5679) #5853

🤖 Agent note · handed off

Agent: repo queue worker, lane code-v (repo-worker-code)
Session / ID: cron repo-queue-worker-shift-v run 2026-11-05; task 10500
Found via: claimed task 10500 this shift; execution-lane assignment returned opencode
Task: task 10500 for issue id: design: custom GUI rendering as first-class overrides (from #5679) #5853 (small_fix). Fresh check: issue id: design: custom GUI rendering as first-class overrides (from #5679) #5853 is OPEN, no hard-stop labels (held / user/owned / do-not-merge / do-not-auto-edit). Handed off to the opencode claimant — the claimant launches the bound opencode session; this lane does not work it directly.
Expectation: claimant session drives task 10500 to a terminal state.
Links: task 10500 · issue id: design: custom GUI rendering as first-class overrides (from #5679) #5853

🤖 Agent note · handed off

Agent: queue worker (repo-worker-code), lane code-w
Session / ID: task 10500
Found via: queue claim
Task: Small-fix for issue id: design: custom GUI rendering as first-class overrides (from #5679) #5853 handed off to the opencode claimant (assigned_lane=opencode, session unbound); claimant launches the bound opencode session.
Expectation: claimant drives task 10500 to a terminal state under this queue's worker id.
Links: issue id: design: custom GUI rendering as first-class overrides (from #5679) #5853

Agent note - handed off

Agent: opencode claimant (opencode-claimant)
Session / ID: queue task 10500; bound session ses_e5e52c11489ffeoCF7f8uajQi3
Found via: queue task handoff on the opencode execution lane
Task: Design id: design: custom GUI rendering as first-class overrides (from #5679) #5853: custom GUI rendering as first-class overrides — decision record (tier-2, after id: design: semantic markup vocabulary v1 (from #5679) #5849/id: design: style assertion vocabulary (from #5679) #5850)
Expectation: the bound worker session works task 10500 to a terminal queue state and must not claim another task. It revalidates the issue/PR before acting.
Links: id: design: custom GUI rendering as first-class overrides (from #5679) #5853

Navigation Menu

Repository navigation

id: design: custom GUI rendering as first-class overrides (from #5679) #5853

Summary

What this design must settle

Context from the parent

Decision record expected

Relations

Triage outcome — task 10256 (2026-11-05, lane code-p)

38 remaining items

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

id: design: custom GUI rendering as first-class overrides (from #5679) #5853

Description

Summary

What this design must settle

Context from the parent

Decision record expected

Relations

Activity

developing-today commented on Nov 5, 2026

dezren39 commented on Nov 5, 2026

Triage outcome — task 10256 (2026-11-05, lane code-p)

dezren39 commented on Nov 5, 2026

dezren39 commented on Nov 5, 2026

38 remaining items

dezren39 commented on Nov 5, 2026

dezren39 commented on Nov 5, 2026

dezren39 commented on Nov 5, 2026

developing-today commented on Nov 5, 2026

dezren39 commented on Nov 5, 2026

dezren39 commented on Nov 5, 2026

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions