docs(design): cockpit UI split-cockpit visual spec (#354) - #367
Merged
Conversation
Graduate Variant C (split cockpit) into the committed visual spec for the runner-fleet cockpit browser UI over the #351-#353 FastAPI backend. Persistent fleet sidebar + Usage/Terminal/Logs main pane (terminal default). Every mandatory section filled (speclint pass); zero new tokens — reuses the smithy iron/ink/heat + success/error/claude vocabulary, with fleet binary-health mapped onto success/heat.cool/heat.alarm+error as a recorded deliberate reuse. Route-indexed the spec + the variants-354 mockups; docsync clean, verify green. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SATRHKa6mDHDuirhP6QuwL
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Graduates Variant C — split cockpit (owner pick) into the committed visual spec for the runner-fleet cockpit browser UI that renders the #351–#353 FastAPI/websocket cores (fleet · usage/cost · logs · PTY terminal), served by
forge-cockpitover127.0.0.1(ADR-0008, supersedes ADR-0006 Decision 1).docs/design/2026-08-03-cockpit-ui.md— persistent fleet sidebar (mini status cards + inline start/stop/restart) beside a Usage/Terminal/Logs main pane with Terminal as default. Fleet is always glance-away; the terminal is one click from anywhere.Scope
Refs #354 — part of #354, does NOT close it. This delivers the visual spec (a design phase). The UI implementation (a later forge:plan → execute) is what closes #354.
Notes / AC
plugin/templates/visual-spec.md; every mandatory section filled — speclint: pass (all sections present, no one-off hex values).iron.*/ink.*/heat.*+success/error/claudevocabulary. Recorded the one deliberate reuse: fleet binary-health (online/offline/mis-target) mapped ontosuccess/heat.cool/heat.alarm+error— a second consumer of the heat vocabulary, flagged as a precedent to revisit explicitly if the surfaces ever need independent scales.variants-354/mockups (kept as design-lane reference) indocs/README.md.Verification (honest)
2026-08-03-cockpit-ui.md: passdocsync.mjs: clean (56 docs indexed)pnpm verify: green — 692/692 tests, 58 files🤖 Generated with Claude Code
https://claude.ai/code/session_01SATRHKa6mDHDuirhP6QuwL