Skip to content

id: design: graphical client & tooling surface — windowing, world inspector, debug UI #5782

Open

Description

@dezren39

Summary

Design the graphical client and tooling surface for ID as its own space: multi-world windowing, the world inspector, and the debug UI — the graphical layer beyond any single shell implementation.

Motivation

#788 designs one reference shell to prove the shell contract — a conformance artefact. That is a different job from designing the graphical surface people will actually work in. Nothing currently owns: what a multi-world graphical client looks like (windows, presence, several servers at once — the #790 topology made visible); the inspector (the journal, the triple graph, capability grants, and lease state as browsable, first-class objects); or debug tooling (event-stream tailing, replay scrubbing against the determinism infrastructure, fixture-replay results from #558's dev loop shown graphically instead of as terminal text). Every serious session with ID ends with someone wanting to see the journal and the graph; today the only windows are the terminal and the web Explorer, and neither was designed as an inspector.

Sketch

Open questions

  • Operator tooling vs shipped-to-everyone surface: is the inspector a mode, a separate app, or the same app with authority-gated panels?
  • How much graph visualisation is honest at world scale — where does the triple explorer stop helping?
  • Accessibility and keyboard-first operation as design constraints, not afterthoughts?
  • Does the inspector need write affordances (moderation actions per id(world): F14.6 builder and moderator authority through session frames (F12.3 remainder) #835) or is it read-only by design?

Relations

Parent: epic #2056. Relations: #788 (reference shell — implementation/conformance; this issue is the surface design it doesn't own), #790 (multi-world topology), #5545 (discovery + counted/uncounted rendering), #2819 (lease state display), #5684 (delegation legibility), #835 (moderation surface question), #558 (dev-loop results surface). Filed in the 2026-11-04 gap pass (WS-F) per Drew's order that the GUI gets its own design issue.

Activity

  1. added
    app/idPackage/app: id (pkgs/ or apps/ in this repo)
    on Nov 5, 2026
  2. developing-today commented on Nov 5, 2026

    @developing-today
    Contributor
  3. dezren39 commented on Nov 5, 2026

    @dezren39
    MemberAuthor

    Correction/link (WS-F): precursor found after filing. #1072 — "id: idea — native GUI client" (2026-10-27, from pkgs/id/TODO.md) is the idea-level seed for a native GUI: "the full end-user GUI app idea," explicitly distinct from #788, long-term / low priority, its acceptance centred on a GUI stack decision (Tauri/egui/Leptos/Dioxus/Iced/Bevy) including the Bevy-embedding consideration.

    Boundary: #1072 owns the end-user app idea and the stack decision; this issue (#5782) owns the graphical surface and tooling design — multi-world windowing, the world inspector, and the debug UI — which #1072 does not scope. The stack decision recorded on #1072 (and the framework record in #788) constrains this design; this design's requirements are inputs to it. Not a duplicate — a precursor, linked late because the pass's title-keyword search ("design") did not surface an "idea"-titled issue; the gap pass worklog records the miss.

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

Metadata

Metadata

Assignees

No one assigned

    Labels

    app/idPackage/app: id (pkgs/ or apps/ in this repo)

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions