LearnNewsExamplesServices
Frontmatter
id14805
titleEpic: agentos design conformance — the live app must consume the token system it already loads
stateOpen
labels
epicdesignai
assignees[]
createdAt5:09 PM
updatedAt5:09 PM
githubUrlhttps://github.com/neomjs/neo/issues/14805
authorneo-fable
commentsCount0
parentIssuenull
subIssues[]
subIssuesCompleted0
subIssuesTotal0
contentTrust
projected
quarantined0
signals[]
blockedBy[]
blocking[]

Epic: agentos design conformance — the live app must consume the token system it already loads

Open Backlog/active-chunk-4 epicdesignai
neo-fable
neo-fable commented on 5:09 PM

Problem (operator escalation, 2026-07-04, with render evidence)

The live agentos app is visually the June post-mortem replaying: default-theme buttons (three of them colliding/overlapping in the Accounts toolbar), a bare default grid with truncated headers ("GitHub usernam…", "Lifecyc…"), default typography — nothing from the design SSOTs. And the sharpest part of the diagnosis: this is NOT a missing-design problem. apps/agentos/resources/tokens.css exists, extracted 1:1 from the SSOT with a written no-silent-drift contract, and is LOADED in index.htmlthe views just never consume it. The Accounts buttons carry cls: ['agent-button'] with no matching rule; the fleet grid binds zero --fm-* custom properties; the default neo theme wins everywhere. The bridge exists; nothing walks across it.

Every currently-shipped agentos surface predates or bypassed the SSOT-conformance machinery that now gates NEW view leaves — including the keeper create surface (its author says so himself: structurally SSOT-bound, visually default).

Intended solution

The consumption layer, surface by surface, against the loaded tokens — plus the gate that stops recurrence:

  • The component skin layer: agentos-components.css (sibling of the existing fleet-components.css, same contract header): the agent-button family styled per the SSOT's button spec (--fm-signal background, dark ink, 6px radius, 7px/13px padding, mono 12px) with hierarchy (primary/secondary/ghost — three same-weight blue slabs is how the toolbar got illegible); panel/card surfaces on --fm-panel/--fm-line; grid header + row density per the SSOT's table treatment; the truncation fixed by real column sizing, not clipping.
  • Per-surface conformance leaves (each: before/after screenshot in the PR, compared against the SSOT frame): (1) Accounts card + toolbar (incl. the collision layout defect — buttons overlap at the screenshot's viewport, a bug independent of styling); (2) the Fleet grid + Start/Stop/Restart bar; (3) the keeper create surface (the wedge — five states restyled onto the tokens); (4) the viewport chrome (header, the settings affordance).
  • The conformance gate: every agentos view PR ships a screenshot beside the relevant SSOT frame as PR-body evidence (the render-verify precedent, made mandatory for this app), and the design authority holds a standing review slot on this epic's leaves. Composes with the motion standards (#14780) as surfaces animate.

Constraints carried

Tokens stay the ONE source (the in-file contract: any delta = a recorded design decision, never silent drift) · light+dark readiness rides #14681 · prefers-reduced-motion per the tokens' own pulse note · core-idiom rules for any view-code touches (§9.6).

Evidence

The operator's live render (dev-server :8085, 2026-07-04 ~15:00Z): default buttons, collision, truncated grid — on record in the epic's provenance. The token/consumption gap V-B-A'd same hour: tokens.css loaded, agent-button unstyled, zero --fm-* bindings in Accounts/grid views.

Related

The SSOTs (apps/agentos/design/*.html — the drawn bars) · tokens.css (#14512/#14578 — the extracted vocabulary) · fleet-components.css (the pattern to extend) · #14780 (motion) · #14681 (theming) · the June post-mortem (the class this kills, second attempt).

Steward: claimable — Vega-shaped (cockpit owner, budget-safe, her fleet-components pattern extends); Grace holds design review per surface.

Origin Session ID: b9b95ac6-42f5-47a3-b58f-6071f79657e8 Retrieval Hint: "agentos design conformance consume loaded tokens agent-button collision grid default theme SSOT frames"

tobiu referenced in commit 5c804e0 - "feat(agentos): button-hierarchy consumption layer + toolbar collision fix (#14809) (#14810) on 6:14 PM