sam/paperclip-harness
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Conversation and Author screens styled to match; glyph policy chosen from measurement

Browse Source
This commit is contained in:
Sam
2026-11-10 14:18:33 +11:00
parent 4e3c955350
commit 031073fc46
13 changed files with 755 additions and 240 deletions
Download Patch File Download Diff File Expand all files Collapse all files

37
.pi/memory-vault/packs/paperclip-harness/20-context/home.md
View File

@@ -168,3 +168,40 @@ I build the Board workspace first, and the visual language with it — frame, fo
- 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]]
---
## Update (2026-11-10 03:01:16)
Repo: /home/sam/paseo/projects/paperclip-harness, binary bin/harness.
Screens/workspaces and behavior:
- `-screen <name> -folder <dir>` launches a given screen against a project folder.
- A project folder carries project state under `.paperclip/`, including worktrees at `.paperclip/worktrees/<task-slug>/`, and the currently chosen task lives in `.harness/harness.toml`.
- The chosen task moves between tasks (e.g. AUD-160 -> AUD-165) when harness.toml changes; the Work panel re-reads harness.toml every 5 s.
- Board screen: three-column layout above 140 cols (tasks, chosen task, needs you/decisions/activity); two columns below 140.
- Work screen has tabs: runs, change, facts.
- runs: column table of every run (state, woken by, started, ended, took) plus activity list in local time.
- change: worktree, branch, base, commits, changed-file stats, then diff.
- facts: folder, branch, base, status and cost.
- Reply and new-task panels still use the older plain look and are the next piece to align (frame/tab bar/footer already exist).
- Repo also has its own `bin/harness -screen ... -folder /tmp/pc-sandbox-...` for sandbox runs.
Theme/styling conventions:
- Theme file lives at `~/.config/tuios/config.toml`; set `theme = 'catppuccin_mocha'`. (`tuios look` is a saved appearance bundle, unrelated to theme; "no look is applied" does not mean no theme.)
- Program supports `-theme light` (Catppuccin Latte variant).
- Catppuccin Mocha is default.
## Evidence
- Confidence: 80%
- Reason: Durable component overview evidenced by screen output and final answer.
## Related learned memories <!-- same-turn-2026-11-10 03:01:16 -->
- context: [[packs/paperclip-harness/20-context/home|paperclip-harness TUI harness]]
- observation: [[packs/paperclip-harness/60-observations/tmp-repository-structure-and-configuration-patterns|Harness pitfalls: git failure, styled-text padding, tuios set-config]]
- action: [[packs/paperclip-harness/40-actions/2026-11-10-wrote-docs-ui-layout-md-and-three-live-layout-mockups|Built Work workspace and polished Board styling (4e3c955)]]
- session: [[packs/paperclip-harness/80-sessions/rich-discovery-config-2026-11-10-03-01-16|Rich discovery: .config 2026-11-10 03:01:16]]
- context: [[packs/paperclip-harness/20-context/tmp|.config]]

83
.pi/memory-vault/packs/paperclip-harness/20-context/tmp.md
View File

@@ -92,3 +92,86 @@ Say which layout you want, and I will build it — starting with the width-drive
- session: [[packs/paperclip-harness/80-sessions/rich-discovery-tmp-2026-11-10-01-47-01|Rich discovery: tmp 2026-11-10 01:47:01]]
- context: [[packs/paperclip-harness/20-context/tmp|tmp]]
- observation: [[packs/paperclip-harness/60-observations/tmp-repository-structure-and-configuration-patterns|tmp repository structure and configuration patterns]]
---
## Update (2026-11-10 03:01:16)
## Rich discovery update (2026-11-10 03:01:16)
Three things answered, and the Work workspace is built.
## Vim keys: yes, as aliases
`j` and `k` now move in both the Board and Work screens, and `h` and `l` switch tabs. They are aliases, not the primary keys, because whether they reach the program depends on TUIOS's mode: in window-management mode TUIOS keeps `h j k l z n`, and in terminal mode the program gets them. Use whichever arrives, and the footer says `↑↓ or j k` so nobody has to guess. Arrow keys stay the primary path.
## The theme confusion, cleared up
You changed something and it worked; I checked the wrong thing. `tuios look` is a saved *appearance bundle*, and "no look is applied" says nothing about the theme. The real answer was in `~/.config/tuios/config.toml`:
```
theme = ''
```
So the config had no theme, which is why this session's chrome looked default. I have now set it:
```
theme = 'catppuccin_mocha'
```
New sessions pick it up. The running one needs a restart, and `tuios set-config theme catppuccin_mocha` refused with *"set_config came from host nixos-desktop and would change this machine, not the session"*, so I left that alone rather than fight it. Our program is drawn in Catppuccin Mocha with a Latte variant (`-theme light`), so once the session restarts the chrome and the panels will match.
## Styling changes
- The board now reads at a glance: group headings are a label, a rule and a count (`DONE───────── 6`), rows are two lines, content sits one column inside the frame.
- Three-column layout above 140 columns (tasks, chosen task, needs you), two columns below, so a wide terminal is used instead of wasted.
- The Work screen has a tab bar, coloured run states, and diff lines coloured by kind — additions green, deletions red, hunk headers blue.
- The footer shows only keys that apply in the current panel, and focus is a rounded bright edge plus `·focus·`.
## Work workspace
One screen, three tabs, tested on real data:
- **runs** — a column table of every run with what woke it, start, end and duration, then the activity list with times in local time.
- **change** — the task's worktree, branch, base, commits, changed-file counts, then the diff.
- **facts** — folder, branch, base, status and cost.
It follows the Board without being told: the chosen task lives in the project's `.harness/harness.toml`, and the Work panel re-reads it every five seconds. I watched it switch from `AUD-160` to `AUD-165` after only that file changed, then show `520bc2d AUD-165: add cleanup.sh` and the actual diff.
Two real bugs found by using it: a git that fails because the folder was removed now says *"the task's folder … no longer exists"* instead of a raw exit code, and a table whose columns were ragged because styled text was being padded by bytes — pad the plain text first, colour it second.
Screenshots: `/tmp/mockups/board-live.png` and `/tmp/mockups/work-live.png`. Committed as `4e3c955`.
## Still to do
The reply and new-task panels still use the older plain look — they need the same frame, tab bar and footer before the set is consistent. That is the next piece, and it is small because the frame already exists.
And the font rebuild is still yours to run:
```
sudo nixos-rebuild switch --flake /etc/nixos#nixos-desktop
```
## Source paths observed
- `home/sam/paseo/projects/paperclip-harness/bin/harness`
- `tmp/pc-sandbox-2026-11-10/.paperclip/worktrees/AUD-165-review-gate-pro`
- `tmp/pc-sandbox-2026-11-10/.paperclip/worktrees/AUD-165-review-gate-`
- `tmp/mockups/C.png`
- `tmp/mockups/work-live.png`
- `.config/tuios/config.toml`
- `tmp/mockups/board-live.png`
## Evidence
- Confidence: 84%
- Reason: Update component/repository context with detailed discovered structure and configuration
## Related learned memories <!-- same-turn-2026-11-10 03:01:16 -->
- context: [[packs/paperclip-harness/20-context/home|paperclip-harness TUI harness]]
- observation: [[packs/paperclip-harness/60-observations/tmp-repository-structure-and-configuration-patterns|Harness pitfalls: git failure, styled-text padding, tuios set-config]]
- action: [[packs/paperclip-harness/40-actions/2026-11-10-wrote-docs-ui-layout-md-and-three-live-layout-mockups|Built Work workspace and polished Board styling (4e3c955)]]
- session: [[packs/paperclip-harness/80-sessions/rich-discovery-config-2026-11-10-03-01-16|Rich discovery: .config 2026-11-10 03:01:16]]
- context: [[packs/paperclip-harness/20-context/tmp|.config]]

85
.pi/memory-vault/packs/paperclip-harness/40-actions/2026-11-10-wrote-docs-ui-layout-md-and-three-live-layout-mockups.md
View File

@@ -143,3 +143,88 @@ Follow-up: build the Board workspace and visual language first, have the user re
- 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]]
---
## Update (2026-11-10 03:01:16)
Delivered: Work workspace with tabs (runs/change/facts), responsive Board, theme config, and vim-key aliases in the harness TUI.
Artifacts:
- Commit 4e3c955: Work workspace with runs, change and facts tabs; vim keys; responsive Board; theme file.
- Theme applied by setting `theme = 'catppuccin_mocha'` in `~/.config/tuios/config.toml`.
- Verified on real data: the Work panel followed the chosen task from AUD-160 to AUD-165 after only `.harness/harness.toml` changed, then showed commit `520bc2d AUD-165: add cleanup.sh` and the diff.
- Screenshots at `/tmp/mockups/board-live.png` and `/tmp/mockups/work-live.png`.
Follow-ups:
- Next piece: align reply and new-task panels with the same frame, tab bar and footer; small because the frame exists.
- Still with the user: `sudo nixos-rebuild switch --flake /etc/nixos#nixos-desktop` for the font rebuild.
## Detailed deliverable from completed turn
Three things answered, and the Work workspace is built.
## Vim keys: yes, as aliases
`j` and `k` now move in both the Board and Work screens, and `h` and `l` switch tabs. They are aliases, not the primary keys, because whether they reach the program depends on TUIOS's mode: in window-management mode TUIOS keeps `h j k l z n`, and in terminal mode the program gets them. Use whichever arrives, and the footer says `↑↓ or j k` so nobody has to guess. Arrow keys stay the primary path.
## The theme confusion, cleared up
You changed something and it worked; I checked the wrong thing. `tuios look` is a saved *appearance bundle*, and "no look is applied" says nothing about the theme. The real answer was in `~/.config/tuios/config.toml`:
```
theme = ''
```
So the config had no theme, which is why this session's chrome looked default. I have now set it:
```
theme = 'catppuccin_mocha'
```
New sessions pick it up. The running one needs a restart, and `tuios set-config theme catppuccin_mocha` refused with *"set_config came from host nixos-desktop and would change this machine, not the session"*, so I left that alone rather than fight it. Our program is drawn in Catppuccin Mocha with a Latte variant (`-theme light`), so once the session restarts the chrome and the panels will match.
## Styling changes
- The board now reads at a glance: group headings are a label, a rule and a count (`DONE───────── 6`), rows are two lines, content sits one column inside the frame.
- Three-column layout above 140 columns (tasks, chosen task, needs you), two columns below, so a wide terminal is used instead of wasted.
- The Work screen has a tab bar, coloured run states, and diff lines coloured by kind — additions green, deletions red, hunk headers blue.
- The footer shows only keys that apply in the current panel, and focus is a rounded bright edge plus `·focus·`.
## Work workspace
One screen, three tabs, tested on real data:
- **runs** — a column table of every run with what woke it, start, end and duration, then the activity list with times in local time.
- **change** — the task's worktree, branch, base, commits, changed-file counts, then the diff.
- **facts** — folder, branch, base, status and cost.
It follows the Board without being told: the chosen task lives in the project's `.harness/harness.toml`, and the Work panel re-reads it every five seconds. I watched it switch from `AUD-160` to `AUD-165` after only that file changed, then show `520bc2d AUD-165: add cleanup.sh` and the actual diff.
Two real bugs found by using it: a git that fails because the folder was removed now says *"the task's folder … no longer exists"* instead of a raw exit code, and a table whose columns were ragged because styled text was being padded by bytes — pad the plain text first, colour it second.
Screenshots: `/tmp/mockups/board-live.png` and `/tmp/mockups/work-live.png`. Committed as `4e3c955`.
## Still to do
The reply and new-task panels still use the older plain look — they need the same frame, tab bar and footer before the set is consistent. That is the next piece, and it is small because the frame already exists.
And the font rebuild is still yours to run:
```
sudo nixos-rebuild switch --flake /etc/nixos#nixos-desktop
```
## Evidence
- Confidence: 80%
- Reason: Completed work with artifacts, validation and follow-up.; enriched with final-answer detail because persistence should be reusable
## Related learned memories <!-- same-turn-2026-11-10 03:01:16 -->
- context: [[packs/paperclip-harness/20-context/home|paperclip-harness TUI harness]]
- observation: [[packs/paperclip-harness/60-observations/tmp-repository-structure-and-configuration-patterns|Harness pitfalls: git failure, styled-text padding, tuios set-config]]
- action: [[packs/paperclip-harness/40-actions/2026-11-10-wrote-docs-ui-layout-md-and-three-live-layout-mockups|Built Work workspace and polished Board styling (4e3c955)]]
- session: [[packs/paperclip-harness/80-sessions/rich-discovery-config-2026-11-10-03-01-16|Rich discovery: .config 2026-11-10 03:01:16]]
- context: [[packs/paperclip-harness/20-context/tmp|.config]]

103
.pi/memory-vault/packs/paperclip-harness/60-observations/tmp-repository-structure-and-configuration-patterns.md
View File

@@ -246,3 +246,106 @@ I build the Board workspace first, and the visual language with it — frame, fo
- 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]]
---
## Update (2026-11-10 03:01:16)
Bugs found and fixed in paperclip-harness (committed 4e3c955):
- If the worktree folder was removed, `git rev-parse --abbrev-ref HEAD` returns exit status 128; the change tab now says "the task's folder … no longer exists" instead of showing raw exit code.
- Table columns looked ragged because styled text was being padded by bytes. Rule: pad plain text first, apply colour after.
Caution on tuios set-config: `tuios set-config theme catppuccin_mocha` fails with "set_config came from host nixos-desktop and would change this machine, not the session". Using it on the live session risks changing the machine config rather than the session. Set `theme` in `~/.config/tuios/config.toml` instead; new sessions pick it up, but the running session needs a restart.
Screenshots saved: `/tmp/mockups/board-live.png`, `/tmp/mockups/work-live.png`.
Other note: the font rebuild is still the user's to run: `sudo nixos-rebuild switch --flake /etc/nixos#nixos-desktop`.
## Evidence
- Confidence: 80%
- Reason: Concrete discoveries/pitfalls for future agents.
---
## Update (2026-11-10 03:01:16)
## Structural/configuration observations (2026-11-10 03:01:16)
Three things answered, and the Work workspace is built.
## Vim keys: yes, as aliases
`j` and `k` now move in both the Board and Work screens, and `h` and `l` switch tabs. They are aliases, not the primary keys, because whether they reach the program depends on TUIOS's mode: in window-management mode TUIOS keeps `h j k l z n`, and in terminal mode the program gets them. Use whichever arrives, and the footer says `↑↓ or j k` so nobody has to guess. Arrow keys stay the primary path.
## The theme confusion, cleared up
You changed something and it worked; I checked the wrong thing. `tuios look` is a saved *appearance bundle*, and "no look is applied" says nothing about the theme. The real answer was in `~/.config/tuios/config.toml`:
```
theme = ''
```
So the config had no theme, which is why this session's chrome looked default. I have now set it:
```
theme = 'catppuccin_mocha'
```
New sessions pick it up. The running one needs a restart, and `tuios set-config theme catppuccin_mocha` refused with *"set_config came from host nixos-desktop and would change this machine, not the session"*, so I left that alone rather than fight it. Our program is drawn in Catppuccin Mocha with a Latte variant (`-theme light`), so once the session restarts the chrome and the panels will match.
## Styling changes
- The board now reads at a glance: group headings are a label, a rule and a count (`DONE───────── 6`), rows are two lines, content sits one column inside the frame.
- Three-column layout above 140 columns (tasks, chosen task, needs you), two columns below, so a wide terminal is used instead of wasted.
- The Work screen has a tab bar, coloured run states, and diff lines coloured by kind — additions green, deletions red, hunk headers blue.
- The footer shows only keys that apply in the current panel, and focus is a rounded bright edge plus `·focus·`.
## Work workspace
One screen, three tabs, tested on real data:
- **runs** — a column table of every run with what woke it, start, end and duration, then the activity list with times in local time.
- **change** — the task's worktree, branch, base, commits, changed-file counts, then the diff.
- **facts** — folder, branch, base, status and cost.
It follows the Board without being told: the chosen task lives in the project's `.harness/harness.toml`, and the Work panel re-reads it every five seconds. I watched it switch from `AUD-160` to `AUD-165` after only that file changed, then show `520bc2d AUD-165: add cleanup.sh` and the actual diff.
Two real bugs found by using it: a git that fails because the folder was removed now says *"the task's folder … no longer exists"* instead of a raw exit code, and a table whose columns were ragged because styled text was being padded by bytes — pad the plain text first, colour it second.
Screenshots: `/tmp/mockups/board-live.png` and `/tmp/mockups/work-live.png`. Committed as `4e3c955`.
## Still to do
The reply and new-task panels still use the older plain look — they need the same frame, tab bar and footer before the set is consistent. That is the next piece, and it is small because the frame already exists.
And the font rebuild is still yours to run:
```
sudo nixos-rebuild switch --flake /etc/nixos#nixos-desktop
```
## Source paths observed
- `home/sam/paseo/projects/paperclip-harness/bin/harness`
- `tmp/pc-sandbox-2026-11-10/.paperclip/worktrees/AUD-165-review-gate-pro`
- `tmp/pc-sandbox-2026-11-10/.paperclip/worktrees/AUD-165-review-gate-`
- `tmp/mockups/C.png`
- `tmp/mockups/work-live.png`
- `.config/tuios/config.toml`
- `tmp/mockups/board-live.png`
## Evidence
- Confidence: 82%
- Reason: Captured factual repo structure/configuration patterns from rich discovery
## Related learned memories <!-- same-turn-2026-11-10 03:01:16 -->
- context: [[packs/paperclip-harness/20-context/home|paperclip-harness TUI harness]]
- observation: [[packs/paperclip-harness/60-observations/tmp-repository-structure-and-configuration-patterns|Harness pitfalls: git failure, styled-text padding, tuios set-config]]
- action: [[packs/paperclip-harness/40-actions/2026-11-10-wrote-docs-ui-layout-md-and-three-live-layout-mockups|Built Work workspace and polished Board styling (4e3c955)]]
- session: [[packs/paperclip-harness/80-sessions/rich-discovery-config-2026-11-10-03-01-16|Rich discovery: .config 2026-11-10 03:01:16]]
- context: [[packs/paperclip-harness/20-context/tmp|.config]]

102
.pi/memory-vault/packs/paperclip-harness/80-sessions/rich-discovery-config-2026-11-10-03-01-16.md Normal file
View File

@@ -0,0 +1,102 @@
---
type: session
id: session.paperclip-harness.rich-discovery-config-2026-11-10-03-01-16
title: Rich discovery: .config 2026-11-10 03:01:16
status: active
source_of_truth: false
freshness: current
last_reviewed: 2026-11-10
tags:
- pack/paperclip-harness
- agent-memory/session
- autolearn
- rich-discovery
- repo/config
---
# Rich discovery: .config 2026-11-10 03:01:16
Sanitized rich discovery snapshot captured automatically from the completed turn.
## Source paths observed
- `home/sam/paseo/projects/paperclip-harness/bin/harness`
- `tmp/pc-sandbox-2026-11-10/.paperclip/worktrees/AUD-165-review-gate-pro`
- `tmp/pc-sandbox-2026-11-10/.paperclip/worktrees/AUD-165-review-gate-`
- `tmp/mockups/C.png`
- `tmp/mockups/work-live.png`
- `.config/tuios/config.toml`
- `tmp/mockups/board-live.png`
## Final answer snapshot
Three things answered, and the Work workspace is built.
## Vim keys: yes, as aliases
`j` and `k` now move in both the Board and Work screens, and `h` and `l` switch tabs. They are aliases, not the primary keys, because whether they reach the program depends on TUIOS's mode: in window-management mode TUIOS keeps `h j k l z n`, and in terminal mode the program gets them. Use whichever arrives, and the footer says `↑↓ or j k` so nobody has to guess. Arrow keys stay the primary path.
## The theme confusion, cleared up
You changed something and it worked; I checked the wrong thing. `tuios look` is a saved *appearance bundle*, and "no look is applied" says nothing about the theme. The real answer was in `~/.config/tuios/config.toml`:
```
theme = ''
```
So the config had no theme, which is why this session's chrome looked default. I have now set it:
```
theme = 'catppuccin_mocha'
```
New sessions pick it up. The running one needs a restart, and `tuios set-config theme catppuccin_mocha` refused with *"set_config came from host nixos-desktop and would change this machine, not the session"*, so I left that alone rather than fight it. Our program is drawn in Catppuccin Mocha with a Latte variant (`-theme light`), so once the session restarts the chrome and the panels will match.
## Styling changes
- The board now reads at a glance: group headings are a label, a rule and a count (`DONE───────── 6`), rows are two lines, content sits one column inside the frame.
- Three-column layout above 140 columns (tasks, chosen task, needs you), two columns below, so a wide terminal is used instead of wasted.
- The Work screen has a tab bar, coloured run states, and diff lines coloured by kind — additions green, deletions red, hunk headers blue.
- The footer shows only keys that apply in the current panel, and focus is a rounded bright edge plus `·focus·`.
## Work workspace
One screen, three tabs, tested on real data:
- **runs** — a column table of every run with what woke it, start, end and duration, then the activity list with times in local time.
- **change** — the task's worktree, branch, base, commits, changed-file counts, then the diff.
- **facts** — folder, branch, base, status and cost.
It follows the Board without being told: the chosen task lives in the project's `.harness/harness.toml`, and the Work panel re-reads it every five seconds. I watched it switch from `AUD-160` to `AUD-165` after only that file changed, then show `520bc2d AUD-165: add cleanup.sh` and the actual diff.
Two real bugs found by using it: a git that fails because the folder was removed now says *"the task's folder … no longer exists"* instead of a raw exit code, and a table whose columns were ragged because styled text was being padded by bytes — pad the plain text first, colour it second.
Screenshots: `/tmp/mockups/board-live.png` and `/tmp/mockups/work-live.png`. Committed as `4e3c955`.
## Still to do
The reply and new-task panels still use the older plain look — they need the same frame, tab bar and footer before the set is consistent. That is the next piece, and it is small because the frame already exists.
And the font rebuild is still yours to run:
```
sudo nixos-rebuild switch --flake /etc/nixos#nixos-desktop
```
## 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 03:01:16 -->
- context: [[packs/paperclip-harness/20-context/home|paperclip-harness TUI harness]]
- observation: [[packs/paperclip-harness/60-observations/tmp-repository-structure-and-configuration-patterns|Harness pitfalls: git failure, styled-text padding, tuios set-config]]
- action: [[packs/paperclip-harness/40-actions/2026-11-10-wrote-docs-ui-layout-md-and-three-live-layout-mockups|Built Work workspace and polished Board styling (4e3c955)]]
- session: [[packs/paperclip-harness/80-sessions/rich-discovery-config-2026-11-10-03-01-16|Rich discovery: .config 2026-11-10 03:01:16]]
- context: [[packs/paperclip-harness/20-context/tmp|.config]]