Board workspace with real panels, tabs and theme; Nerd Font declared for all three machines
This commit is contained in:
Sam
@@ -0,0 +1,92 @@
|
||||
---
|
||||
type: session
|
||||
id: session.paperclip-harness.rich-discovery-etc-2026-11-10-02-26-18
|
||||
title: Rich discovery: etc 2026-11-10 02:26:18
|
||||
status: active
|
||||
source_of_truth: false
|
||||
freshness: current
|
||||
last_reviewed: 2026-11-10
|
||||
tags:
|
||||
- pack/paperclip-harness
|
||||
- agent-memory/session
|
||||
- autolearn
|
||||
- rich-discovery
|
||||
- repo/etc
|
||||
---
|
||||
|
||||
# Rich discovery: etc 2026-11-10 02:26:18
|
||||
|
||||
Sanitized rich discovery snapshot captured automatically from the completed turn.
|
||||
|
||||
|
||||
## Source paths observed
|
||||
|
||||
- `etc/profiles/per-user/sam/bin/hunk`
|
||||
- `run/current-system/sw/bin/lazygit`
|
||||
- `run/current-system/sw/bin/git`
|
||||
- `home/sam/.local/bin/ocr`
|
||||
- `etc/nixos/configuration.nix`
|
||||
- `etc/nixos/flake.nix`
|
||||
- `home/sam/.config/tuios/glyphs`
|
||||
|
||||
## Final answer snapshot
|
||||
|
||||
Taken, and folded into `docs/UI-LAYOUT.md` (now 440 lines, committed as `5b82900`).
|
||||
|
||||
## The four-panel rule is gone
|
||||
|
||||
A workspace holds what the work in it needs. Four side by side is a good default because more than four stops being readable, but a workspace that needs a fifth thing has three allowed answers — a tab, a tool panel that closes when done, or TUIOS's zoom. Tabs are specified as first-class: same frame, same footer, same focus marker, switched with `[` and `]` while the panel has focus, and named with words rather than numbers.
|
||||
|
||||
The only rule left is that everything in a workspace helps answer the same question. If it does not, it belongs in another workspace.
|
||||
|
||||
## Your first point, in plain words
|
||||
|
||||
I meant exactly what you said: **choosing a task changes what the other panels show.** Pick a task in the tree, and the summary, the thread, the run log, the diff and the worktree facts all switch to it. Nothing has to be typed twice.
|
||||
|
||||
The spec now leads with that sentence. The mechanism is described after it, in one short paragraph: the chosen task is remembered as one line in the project's own `.harness/harness.toml`, the other panels re-read when it changes, and the choice survives a restart or a lost pane. If a chosen task is deleted, the panels fall back to the most active task instead of showing an error.
|
||||
|
||||
## Glyphs: you are wrong about one thing, and it matters
|
||||
|
||||
Measured just now on this machine:
|
||||
|
||||
- `starship` is **not installed** and there is no `~/.config/starship.toml`.
|
||||
- No Nerd Font is present — `fc-list | grep -i nerd` returns nothing.
|
||||
- TUIOS offers four glyph sets: `ascii`, `default`, `heavy`, `unicode`. `default` is active and uses ordinary Unicode: `╭ ╮ ✕ ▎ ● › …`.
|
||||
|
||||
So Starship-style icons would draw empty boxes today. The spec says: use TUIOS's `default` set with `ascii` as the fallback, and if you want the Starship look, installing a Nerd Font is a system change to do deliberately first, then we pick a glyph set. Tell me if you want that and I will prepare it.
|
||||
|
||||
## Hunk and Lazygit: yes, and they are installed
|
||||
|
||||
They were already in your own product statement — "We need a page where we can interact with the Gitea and similar. Hunk, LazyGit etc." — and both are present: `lazygit` in the system packages, `hunk` as a flake input at `/etc/profiles/per-user/sam/bin/hunk`.
|
||||
|
||||
They are now specified as **tool panels**: opened with `t` in the current workspace, they take focus when they open, run the real program rather than a copy, and give focus back to exactly where it was when closed. Also available this way: a shell, `git log` and `git diff` for the task's branch, and the review as it runs.
|
||||
|
||||
## Two arrangements I added, because they are what you actually do
|
||||
|
||||
- **Reading a claim and its code** — task tree left, thread upper right, diff lower right. The only place a claim and the change behind it are on screen at once.
|
||||
- **Deciding** — Needs you on the left, the task it concerns beside it, so a decision and its evidence never sit on different workspaces.
|
||||
|
||||
Zoom stays TUIOS's own key; we rely on it rather than reimplementing it, and the same is true of switching workspaces.
|
||||
|
||||
## Next
|
||||
|
||||
I build the Board workspace first, and the visual language with it — frame, focus, tab strip, footer hints, stale marker, rows and badges — so the look is settled once instead of drifting screen by screen. Then I put it in your session and you look at it before I start the second workspace. Say go.
|
||||
|
||||
## Evidence
|
||||
|
||||
- Confidence: 86%
|
||||
- Reason: Preserve full sanitized discovery detail from a rich investigation turn
|
||||
|
||||
## Related
|
||||
|
||||
- [[packs/paperclip-harness/00-system/pi-agent/memory-manifest|Memory Manifest]]
|
||||
|
||||
## Related learned memories <!-- same-turn-2026-11-10 02:26:18 -->
|
||||
|
||||
- observation: [[packs/paperclip-harness/60-observations/environment-facts-starship-absent-no-nerd-font-tuios-glyph-s|Environment facts: starship absent, no Nerd Font, TUIOS glyph sets, hunk/lazygit installed]]
|
||||
- decision: [[packs/paperclip-harness/50-decisions/paperclip-harness-ui-six-workspaces-spec-first-four-panel-li|Panels grouped by shared question; tabs/zoom/closable tool panels instead of hard 4-panel cap]]
|
||||
- action: [[packs/paperclip-harness/40-actions/2026-11-10-wrote-docs-ui-layout-md-and-three-live-layout-mockups|Rewrote docs/UI-LAYOUT.md per user feedback; committed 5b82900]]
|
||||
- session: [[packs/paperclip-harness/80-sessions/tuios-paperclip-harness-ui-spec-workspaces-tool-panels-tab-z|TUIOS Paperclip harness UI spec: workspaces, tool panels, tab/zoom, glyphs]]
|
||||
- session: [[packs/paperclip-harness/80-sessions/rich-discovery-etc-2026-11-10-02-26-18|Rich discovery: etc 2026-11-10 02:26:18]]
|
||||
- context: [[packs/paperclip-harness/20-context/home|etc]]
|
||||
- observation: [[packs/paperclip-harness/60-observations/tmp-repository-structure-and-configuration-patterns|etc repository structure and configuration patterns]]
|
||||
@@ -0,0 +1,61 @@
|
||||
---
|
||||
type: session
|
||||
id: session.paperclip-harness.tuios-paperclip-harness-ui-spec-workspaces-tool-panels-tab-z
|
||||
title: TUIOS Paperclip harness UI spec: workspaces, tool panels, tab/zoom, glyphs
|
||||
status: active
|
||||
source_of_truth: false
|
||||
freshness: current
|
||||
last_reviewed: 2026-11-10
|
||||
tags:
|
||||
- pack/paperclip-harness
|
||||
- agent-memory/session
|
||||
- paperclip-harness
|
||||
- tuios
|
||||
- ui-spec
|
||||
- docs/UI-LAYOUT.md
|
||||
- workspaces
|
||||
- tabs
|
||||
- tool-panels
|
||||
---
|
||||
|
||||
# TUIOS Paperclip harness UI spec: workspaces, tool panels, tab/zoom, glyphs
|
||||
|
||||
Turn snapshot: revised UI specification for the Paperclip harness on TUIOS, written to docs/UI-LAYOUT.md (grown to ~440 lines; commit 5b82900 "Interface spec: workspaces grouped by question, tabs and tool panels, plain-language task selection").
|
||||
|
||||
User preferences expressed:
|
||||
- 4 panels was NOT a hard limit; more is fine via tabs, zoom, or closable tool panels. Priority is WELL GROUPED items that are meaningful to the work; usability/speed matters.
|
||||
- Dislikes esoteric/backend-derived terminology in UI copy (e.g. 'tree drives', 'Enter writes watching - AUD-163'); wants plain meaningful language.
|
||||
- Happy to switch between workspaces; logical workspaces matter more than count.
|
||||
- Mentioned Hunk and Lazygit as tools to integrate; opening a new panel inside a workspace is fine if easily closed; tabs are convenient.
|
||||
- Thought the UI glyphs were Starship glyphs (verified: starship is not installed).
|
||||
|
||||
Spec content settled this turn:
|
||||
- Workspaces grouped by the question they answer: Board (task tree + summary + Needs you), Work (run log + diff), Conversation (thread above composer + task header), Author (plan/task description writing), plus added arrangements 'Reading a claim and its code' (tree left, thread upper-right, diff lower-right) and 'Deciding' (Needs you left, related task beside it).
|
||||
- Only rule: everything in a workspace helps answer the same question; otherwise it belongs elsewhere.
|
||||
- Tabs are first-class: same frame/footer/focus marker, switched with '[' and ']' while panel focused, named with words not numbers.
|
||||
- Tool panels: opened with 't' in current workspace, take focus on open, run the real program (Hunk, Lazygit, shell, git log, git diff for task branch, review), restore focus on close.
|
||||
- Selecting a task in the tree updates all other panels (summary, thread, run log, diff, worktree facts). Mechanism: chosen task stored as 'watching' line in the project's .harness/harness.toml; other panels reread on change; survives restart/lost pane; deleted task falls back to most active task.
|
||||
- Responsive layout by terminal width: >=150 cols wide layouts; 110-149 two panels max with third as tab; 80-109 one panel per workspace in order Board, Work, Conversation, Author; <80x24 a single message.
|
||||
- Uses TUIOS's own zoom and workspace-switch keys rather than reimplementing.
|
||||
- Deliberately excluded: separate agent chat (Conversation is the chat), plan editor (plan = task description), second task board, per-panel colors (one theme, two variants), actionless dashboards.
|
||||
|
||||
Next step agreed: build the Board workspace first plus the visual language (frame, focus, tab strip, footer hints, stale marker, rows, badges); then show user before building second workspace.
|
||||
|
||||
## Evidence
|
||||
|
||||
- Confidence: 90%
|
||||
- Reason: Rich discovery/planning turn with durable UI conventions, user preferences, and committed artifact details.
|
||||
|
||||
## Related
|
||||
|
||||
- [[packs/paperclip-harness/00-system/pi-agent/memory-manifest|Memory Manifest]]
|
||||
|
||||
## Related learned memories <!-- same-turn-2026-11-10 02:26:18 -->
|
||||
|
||||
- observation: [[packs/paperclip-harness/60-observations/environment-facts-starship-absent-no-nerd-font-tuios-glyph-s|Environment facts: starship absent, no Nerd Font, TUIOS glyph sets, hunk/lazygit installed]]
|
||||
- decision: [[packs/paperclip-harness/50-decisions/paperclip-harness-ui-six-workspaces-spec-first-four-panel-li|Panels grouped by shared question; tabs/zoom/closable tool panels instead of hard 4-panel cap]]
|
||||
- action: [[packs/paperclip-harness/40-actions/2026-11-10-wrote-docs-ui-layout-md-and-three-live-layout-mockups|Rewrote docs/UI-LAYOUT.md per user feedback; committed 5b82900]]
|
||||
- session: [[packs/paperclip-harness/80-sessions/tuios-paperclip-harness-ui-spec-workspaces-tool-panels-tab-z|TUIOS Paperclip harness UI spec: workspaces, tool panels, tab/zoom, glyphs]]
|
||||
- session: [[packs/paperclip-harness/80-sessions/rich-discovery-etc-2026-11-10-02-26-18|Rich discovery: etc 2026-11-10 02:26:18]]
|
||||
- context: [[packs/paperclip-harness/20-context/home|etc]]
|
||||
- observation: [[packs/paperclip-harness/60-observations/tmp-repository-structure-and-configuration-patterns|etc repository structure and configuration patterns]]
|
||||
Reference in New Issue
Block a user