Project and Repair workspaces; adoption keeps the person's own pane; truncation fix

README.md

@@ -51,6 +51,21 @@ The project can be an id or its url key. Keys inside the program: arrows or Tab
 Shift-Tab move, `r` re-reads from Paperclip, `q` quits. A bare Esc is left free, because in
 TUIOS it has to close a box.
 
+## The six workspaces
+
+| workspace | shows | keys |
+|---|---|---|
+| shell | a prompt in the project folder | — |
+| board | tasks by group, the chosen task, what needs you | ↑↓ j k · enter (show everywhere) · a (assign) · tab |
+| work | runs, change, facts — tabs | [ ] tab · ↑↓ j k · r |
+| reply | the thread and a reply box | enter (write) · s (status to send) · esc |
+| new | the form that makes a task | tab · enter · esc |
+| project | folder, machine, session, costs, verify command | [ ] tab · ↑↓ j k |
+| repair | health checks and the live layout | [ ] tab · ↑↓ j k |
+
+Choosing a task on the board and pressing Enter writes it into the project's
+`.harness/harness.toml`, and every other workspace follows within a second.
+
 ## How an interface change is tested
 
 Not in a plain terminal, and not in tmux. TUIOS owns part of the keyboard and forwards
@@ -67,7 +82,7 @@ live.
 | `bin/project-reset <folder> [--dry-run] [--yes]` | close the pages, remove the worktrees and branches; keep the folder and every Paperclip record |
 | `bin/merge <task> [--check]` | rebase, verify, review with `ocr`, merge; a refusal is a decision for the person |
 | `bin/review <task> [--post]` | the same review on its own |
-| `bin/screen tree\|reply\|log\|new [task]` | open one page |
+| `bin/screen <screen> [task or project]` | open one page by name |
 
 ## Rules for this project