mosaicstack/stack
25
0
Fork 1
Code Issues 371 Pull Requests 13 Actions Packages Projects Releases 15 Wiki Activity

docs(design): handoff package for implementing the design

Browse Source 
Jason accepted the draft 1 direction on 2026-10-10; the refined Relay
mark stays as a placeholder. Adds IMPLEMENTING.md (gap map against
row 40 and the bus/CLI modules, strings, boundaries, acceptance,
proposed rows for Sage), tokens.json and generated tokens.css using the
webui's existing names, icons.svg, and tools/build-tokens.mjs and
tools/check-design.mjs. Coverage statuses corrected against the code
(digest implemented; mosaic stop is row 41; priority and agent state
not in the bus reads). No packages/ change.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
This commit is contained in:
jason.woltje
2026-10-10 11:22:06 -05:00
co-authored by Claude Opus 5.5
parent d40a35393b
commit 811e7ba562
10 changed files with 2323 additions and 30 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/design/README.md
+39 -20
View File
@@ -1,7 +1,10 @@
# Mosaic Stack design, draft 1
- Status: draft 1, 2026-10-09. A design for review, not built software.
Nothing under `packages/` changed for it.
- Status: draft 1, 2026-10-09. A design, not built software. Nothing
under `packages/` changed for it.
- 2026-10-10: Jason accepted the direction. The mark stays the refined
Relay as a placeholder until he revises it. The defaults below are
provisional. Implementers start from `IMPLEMENTING.md`.
- Asked for by Jason: branding, WebUI page designs, a TUI design, and
every feature included.
- Preview: `mosaic-stack-design.html` in this directory. It is one
@@ -162,37 +165,53 @@ below).
## Coverage
The Coverage tab lists 39 features. Each row gives the requirement, the
The Coverage tab lists 41 features. Each row gives the requirement, the
web screen, the TUI screen and a status. The status describes the code
today, not these screens:
- **implemented**: exists in the code now (18 features);
- **implemented**: exists in the code now (20 features);
- **in progress**: has an open queue row (3);
- **planned**: in the PRD or a brief, with no code yet (3);
- **proposed**: new in this design (15).
- **planned**: in the PRD or a brief, with no code yet (1);
- **proposed**: new in this design (17).
- **In progress.** Talk to the stack-owned PM session (row 41), the
launch budget (row 41), and the trail filter chips (row 40).
- **Planned.** The 08:00 digest, `mosaic stop`, and the business file
view.
- **In progress.** All row 41 (S6): talk to the stack-owned PM
session, the launch budget, and `mosaic stop`.
- **Planned.** The business file view.
- **Proposed** (the larger items). The Inbox tabs, Seen for decisions,
the field-writer table on tasks, credential expiry, the command
palette, and the business, library, queue, runs and ledger views.
Also first-run setup and the five-state treatment on every view.
task priority and requirement columns, agent state per role, the
field-writer table on tasks, credential expiry, the command palette,
and the business, library, queue, runs and ledger views. Also
first-run setup and the five-state treatment on every view.
Corrections on 2026-10-10, checked against the code:
- the 08:00 digest is implemented (`packages/cli/src/notifier.mjs`);
- `mosaic stop` is row 41 work;
- task priority and agent state are not in the bus reads, so they
moved out of the implemented rows.
`IMPLEMENTING.md` has the gap map per view.
## Open decisions for Jason
1. **Default palette and mode.** Proposed: Harbor, following the system
setting, with Dim available.
2. **Final mark.** Proposed: refined Relay. The original stays usable
from 48 px.
1. **Default palette and mode.** Provisional: Harbor, following the
system setting, with Dim available.
2. **Final mark.** The refined Relay is the placeholder (Jason,
2026-10-10: "Use the design's logo for now and we will revise.").
3. **Resolving from the web.** The PRD rules it out (REQ-DEC-3).
Proposed: keep the Copy command through v1.
4. **One `mosaic` app.** Proposed: `mosaic` with no arguments opens the
full-screen app, and the verbs remain for scripts.
Provisional: keep the Copy command through v1.
4. **One `mosaic` app.** Provisional: `mosaic` with no arguments opens
the full-screen app, and the verbs remain for scripts.
5. **Decision Seen from the web.** It would give the browser a
human-authority write. Recommended: keep it in the terminal for
v1.
## Files
- `IMPLEMENTING.md`: the brief for implementing agents.
- `mosaic-stack-design.html`: the preview page. Its source is built from
a scratch file. Edit the HTML directly for draft 2.
- `tokens.json`, `tokens.css`: design values. `tokens.css` is
generated by `tools/build-tokens.mjs`.
- `icons.svg`: the icon sprite, plus the placeholder mark.
- `brand/relay-refined.svg`, `brand/relay-original.svg`: the mark in
Harbor action blue.
- `tools/check-design.mjs`: browser checks for the preview.