docs(web): Add web console spec, design and tasks - #108
Merged
Merged
Conversation
Define phased requirements, architecture and implementation tasks for the local web console while preserving current terminal and batch contracts. Co-Authored-By: Codex <noreply@openai.com>
|
This was referenced Sep 23, 2026
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
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.



Planning artifacts for moving
setupandusageto the browser. No code changes; this PR isspec.md,design.mdandtasks.mdunder.specs/features/web-console/.What the spec commits to:
codedeck review, serving review, usage and setup.codedeck uiopens a home that links only to registered routes. The daemon stays HTTP-free.codedeck setupon an interactive terminal opens the web setup. The terminal wizard stays, frozen, behind--tui. Without a TTY,setupkeeps today's exit 1, so agents never block on a server.codedeck usage --webopens a usage page with the same filters as the CLI and every breakdown, includingbyOriginfrom feat(usage): Capture orchestrator usage through a source ledger #103.--json,usage <run-id>,--backfilland the statusline path keep their contracts.frame-ancestors 'none'.getBatchModels.node:vmtest that runs the inline script with an empty context, so there are no DOM dependencies.Decisions made while writing, open to change:
setupwithout a TTY keeps exit 1 instead of serving the web.Size: 93 requirements, 19 tasks, each with its own tests and a scoped gate command (no
npm test). A coverage matrix maps each code layer to its test file.Validation:
Two independent reviews ran against the code. The first found 14 issues, the largest being that the draft turned
setupwithout a TTY into a server that never exits. The second confirmed all 14 fixed and found 4 more, including a merge gate that could never pass because #103 landed as a squash. All are addressed in the last two commits.Out of scope: removing the TUI wizard or the usage TUI, HTTP in the daemon, remote access, profile management beyond
--profile, and any frontend tooling.