shapewall 0.2.2 → 0.2.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (49) hide show
  1. package/CHANGELOG.md +22 -0
  2. package/dist/agent/package-lock.json +2 -2
  3. package/dist/client/assets/BoardChat-C0a3DDjv.js +28 -0
  4. package/dist/client/assets/{BuzzDialog-HWXBy52W.js → BuzzDialog-CZdwIQLF.js} +1 -1
  5. package/dist/client/assets/ChecksPanel-BHWgwJWO.js +1 -0
  6. package/dist/client/assets/{History-CEv6b-av.js → History-C01qLFpP.js} +1 -1
  7. package/dist/client/assets/LocalSettings-B5gtfKEl.js +1 -0
  8. package/dist/client/assets/{Management-DCfhcEUY.js → Management-BxEUZAmI.js} +1 -1
  9. package/dist/client/assets/QuickConnect-BzTM3UNO.js +1 -0
  10. package/dist/client/assets/{ShareDialog-C_plIto0.js → ShareDialog-CdVAreaw.js} +1 -1
  11. package/dist/client/assets/{app-update-dialog-2hPz_N9G.js → app-update-dialog-BONq9YFp.js} +1 -1
  12. package/dist/client/assets/{circle-x-BZMPi8Zf.js → circle-x-BmT6vHKl.js} +1 -1
  13. package/dist/client/assets/index-C1IsGdGs.js +29 -0
  14. package/dist/client/assets/index-DnsWelgZ.css +2 -0
  15. package/dist/client/assets/{refresh-cw-CRow0Nbq.js → refresh-cw-ugt3cWKH.js} +1 -1
  16. package/dist/client/assets/{square-A8EnIYLR.js → square-_KG6tM5A.js} +1 -1
  17. package/dist/client/assets/{ui-CLbws0rx.js → ui-BAGBTB_P.js} +1 -1
  18. package/dist/client/build-info.json +1 -1
  19. package/dist/client/index.html +3 -3
  20. package/dist/client/sw.js +2 -2
  21. package/dist/console/assets/LocalAccountsApp-DtfTDbQg.js +1 -0
  22. package/dist/console/assets/LocalConsole-BPpsxDq_.js +1 -0
  23. package/dist/console/assets/app-update-dialog-o4QY_jL9.js +1 -0
  24. package/dist/console/assets/console-DeOji9Zv.css +2 -0
  25. package/dist/console/assets/console-MvFrlUCC.js +51 -0
  26. package/dist/console/build-info.json +1 -1
  27. package/dist/console/console.html +2 -2
  28. package/docs/agents.md +61 -35
  29. package/docs/design-system.md +23 -12
  30. package/docs/journeys.md +13 -1
  31. package/package.json +1 -1
  32. package/src/agent/backends/acp.js +229 -41
  33. package/src/agent/manage.js +1 -1
  34. package/src/agent/options-cache.js +52 -0
  35. package/src/agent/routes.js +171 -6
  36. package/src/agent/run.js +20 -1
  37. package/src/agent/settings-events.js +103 -0
  38. package/src/agent/settings-routes.js +24 -2
  39. package/dist/client/assets/BoardChat-D5SFd8HE.js +0 -28
  40. package/dist/client/assets/ChecksPanel-DTdImWoD.js +0 -1
  41. package/dist/client/assets/LocalSettings-C4vriEVQ.js +0 -1
  42. package/dist/client/assets/QuickConnect-DQGgUsl1.js +0 -1
  43. package/dist/client/assets/index-ByQRKVit.css +0 -2
  44. package/dist/client/assets/index-DweQ8Qtu.js +0 -29
  45. package/dist/console/assets/LocalAccountsApp-BQCcmj3x.js +0 -1
  46. package/dist/console/assets/LocalConsole-Bb2FUDs7.js +0 -1
  47. package/dist/console/assets/app-update-dialog-DIeYepLZ.js +0 -1
  48. package/dist/console/assets/console-C7uJLLOn.js +0 -51
  49. package/dist/console/assets/console-R8IBY3Am.css +0 -2
@@ -1 +1 @@
1
- {"version":"0.2.2","revision":"0466d34bde6c8476e21feb70924c8bf383f357d5"}
1
+ {"version":"0.2.4","revision":"ba73528d10c3efa024fe504c3620ceb48e06012f"}
@@ -12,8 +12,8 @@
12
12
  <title>Shapewall</title>
13
13
  <!-- Saved light/dark mode and theme, before the first paint (see src/lib/theme.js). -->
14
14
  <script src="/_console/theme-boot.js"></script>
15
- <script type="module" crossorigin src="/_console/assets/console-C7uJLLOn.js"></script>
16
- <link rel="stylesheet" crossorigin href="/_console/assets/console-R8IBY3Am.css">
15
+ <script type="module" crossorigin src="/_console/assets/console-MvFrlUCC.js"></script>
16
+ <link rel="stylesheet" crossorigin href="/_console/assets/console-DeOji9Zv.css">
17
17
  </head>
18
18
  <body>
19
19
  <div id="root"></div>
package/docs/agents.md CHANGED
@@ -67,8 +67,8 @@ stop another instance's work. Overlapping connection tests in the same managemen
67
67
 
68
68
  ## Several native agents, one choice per thread
69
69
 
70
- The home for your agents is the **Agents** card in the local Workspace Console (**Workspace > Settings**, `/console?section=settings`;
71
- [Agents in Workspace settings](#agents-in-workspace-settings)). Connect Claude Code, Codex, goose, or Gemini CLI from the CLIs found on
70
+ The home for your agents is the **Agents** page in the local Workspace Console (**Workspace > Agents**, `/console?section=agents`;
71
+ [Agents in the Workspace Console](#agents-in-the-workspace-console)). Connect Claude Code, Codex, goose, or Gemini CLI from the CLIs found on
72
72
  this server's `PATH`. Each Connect shows the exact fixed command for confirmation, saves it in your private agent settings file, and
73
73
  tests an ACP handshake. A failed handshake restores the previous settings. It does not send a prompt or verify your provider login. No
74
74
  CLI, adapter, subscription, or background service is installed for you.
@@ -102,11 +102,14 @@ project's answer limit, rate limits, and ACP process budget; opening another pro
102
102
  Each profile starts its own agent session on the Shapewall computer. To message agents that already run in a Buzz chat channel
103
103
  instead, see the optional [Buzz bridge](buzz.md).
104
104
 
105
- ## Agents in Workspace settings
105
+ ## Agents in the Workspace Console
106
106
 
107
- The local Workspace Console's **Settings** page (`/console?section=settings`, **Workspace** in the board's sidebar) has an **Agents**
108
- card, the one place to manage agents. The chat's agent dialog (**Connect another agent...**) and the host-only settings window
109
- (`shapewall settings`) show the same card; the board's general **Settings > Agent** tab links to it.
107
+ The local Workspace Console's **Agents** page (`/console?section=agents`, **Workspace** in the board's sidebar, listed before **Agent
108
+ feedback** and **Settings**) is the one place for everything about agents: the **Connected agents** card to manage them, and below it
109
+ the connection details and the OpenAI-compatible endpoint form. The console's **Settings** page keeps only this browser's appearance and
110
+ the installation details. An old `/console?section=settings#agents` link opens **Agents**. The chat's agent dialog (**Connect another
111
+ agent...**) and the host-only settings window (`shapewall settings`) show the same card; the board's general **Settings > Agent** tab and
112
+ the agent picker's **Agent settings** item link to the Agents page.
110
113
 
111
114
  - **Every agent Shapewall knows how to run** (Claude Code, Codex, goose, Gemini CLI) with its state on this machine: **Connected**
112
115
  (with its state, **Test connection** and **Remove**, and how to sign in when it is not signed in); **Found, not connected**
@@ -122,11 +125,12 @@ card, the one place to manage agents. The chat's agent dialog (**Connect another
122
125
 
123
126
  Connecting, removing, testing and choosing the default run commands as the machine's owner, so they need the settings token (the owner
124
127
  link `shapewall serve` prints). Without it the card is read-only and says how to open that link; it asks nothing of the agent routes.
125
- Self-hosted multiplayer (`shapewall hosted`) has its own workspace Settings (project agent tokens), which does not show this card.
128
+ Self-hosted multiplayer (`shapewall hosted`) has its own workspace Settings (project agent tokens) and no Agents page. The public demo
129
+ shows the card read-only on its console's Agents page.
126
130
 
127
131
  ## Source folder and agent sign-in
128
132
 
129
- **Settings > Agent** shows **Source folder on the Shapewall computer**. That is the real directory containing this project's config,
133
+ **Settings > Agent** (and the console's **Agents** page) shows **Source folder on the Shapewall computer**. That is the real directory containing this project's config,
130
134
  fixed by the server; the browser cannot choose another working directory. Native agents use that folder for every board in this project.
131
135
  The **Allow this?** connection card repeats **Source folder for every board in this project** before you confirm the command.
132
136
  Capturing a website gives the agent no access to its source: the agent edits the folder the config is in, nothing else.
@@ -691,12 +695,33 @@ What the bridge protects against, and what it does not:
691
695
  - **Suggested next steps.** After a complete answer, 2 or 3 chips offer a next step; a tap sends it. The agent is asked to end with a
692
696
  `<next-steps>` block, which Shapewall strips from the answer and checks (short plain lines, no links or markup). Without one, the
693
697
  chips are a few fixed ones that fit (fix a comment the answer named, what is still open). None after a stopped or failed answer.
694
- - **Model and effort.** When the agent offers a choice, a compact button in the composer's footer switches this chat's model and
695
- reasoning effort: an ACP agent's own session options (only its `model` and `thought_level` lists, never its permission modes), or the
696
- model list an OpenAI-compatible endpoint reports at `/models`. Owner only, between answers, for this thread while its session or
697
- this server runs. The configured default never changes. Hidden when there is nothing to choose. An endpoint's list (and the demo's)
698
- is known before the first message, so a new chat can set both first; an ACP agent's shows once its session has started. The list
699
- stays open while you pick, and the arrow keys move through it.
698
+ - **Model, thinking and more.** The composer's footer has a quiet button per option the agent offers: **Model** (the current model
699
+ and a chevron; its menu lists each model with a line about it and a check on the current one), the agent's thinking level under its
700
+ own name (**Effort**, **Thinking**), and anything else it offers (a mode such as Ask or Plan) under **More options**. When the panel
701
+ is too narrow for them, one control holds every option in sections. They come from an ACP agent's own session (`session/new`
702
+ config options and its older modes), or the model list an OpenAI-compatible endpoint reports at `/models`. Never a permission or
703
+ sandbox setting, and never a mode that acts without asking (bypass, auto, yolo and the like), so the agent still asks before it
704
+ changes files or runs commands. Values show the agent's real names: a value that is just the agent's default says **Default
705
+ model**, or the model it says it currently is. The keyboard works as in any menu: the current choice has the focus when it opens,
706
+ the arrows and Home and End move, Escape closes it back to its button.
707
+ - **Options before the first message.** As soon as the panel is open and on screen for the owner, a new chat (New chat included)
708
+ asks the server for its options (`POST .../prepare`), and the footer says **Loading options** meanwhile; typing and sending never
709
+ wait for it. For an ACP agent that starts the chat's own session the way its first message would (the first turn then reuses it),
710
+ within the same process pool, which a look never makes room in: when the pool is full it shows nothing yet and the first message
711
+ starts the session as before. An unused session stops after the idle time like any other. What a profile offers is then kept on
712
+ the server for 10 minutes (60 seconds for an agent that could not start), so the next new chat shows its options without starting
713
+ anything; saving or connecting the agent again forgets it. Nothing starts for a viewer who cannot chat, for a hidden panel, or
714
+ while the agent is busy; a failure falls back quietly to the old way (options once the first message started the session). An
715
+ agent that is not signed in shows the sign-in card on the first message instead (below).
716
+ - **Choices are kept per chat.** A pick applies from the next message (straight away when the session runs, or sent with the
717
+ first message), and is kept in this browser per chat; the last used values per agent are where a new chat starts. Owner only.
718
+ While an answer runs the buttons stay focusable but do not open, and say "Wait for the answer to finish to change this". The
719
+ configured default never changes.
720
+ - **What an answer ran with.** Under "Worked for 59s, 12 steps" a quiet line names the model and level the turn used, for example
721
+ "Sonnet 5.5 · Medium". Older answers' "Configured model" notes show the same way.
722
+ - **Not signed in.** When a native agent's CLI is not signed in, the answer is a short card: "Claude Code is not signed in", the
723
+ command that signs it in to copy (`claude auth login`, `codex login`, `goose configure`), **Check again** (starts the agent afresh
724
+ and sends the message again once it is signed in), **Try with** another agent, and **Edit and retry**.
700
725
  - **Usage.** When the agent reports it, a small ring shows how full the context window is, and its popover the last answer's tokens
701
726
  (in and out). ACP agents report it through `usage_update`; endpoints are asked with `stream_options.include_usage` (an endpoint that
702
727
  refuses that is asked again without). Hidden when nothing is reported. Shapewall does not bill or limit tokens.
@@ -839,27 +864,28 @@ its variable name are never sent to the browser; the endpoint's host is shown so
839
864
 
840
865
  The panel uses `/api/agent/*` on the local server: JSON in, server-sent events out.
841
866
 
842
- | Route | What it does |
843
- | ----------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
844
- | `GET /api/agent/status` | `{ configured, backend, label, model, host, local, vision, problem, docsUrl }` |
845
- | `GET /api/agent/boards/:id/threads` | Your threads with messages, newest first (`?q=` searches them): `{ threads: [{ id, kind, commentId?, title, count, createdAt, updatedAt, archived, shared, match? }] }` |
846
- | `GET /api/agent/boards/:id/threads/:thread` | `{ id, messages, kind, title, archived, shared, versions, running, ratings, options? }`; `:thread` is `board`, `comment-<id>` or `chat-<16 letters or digits>` |
847
- | `POST /api/agent/boards/:id/threads/:thread/messages` | `{ text, attachments?, mentions?, files?, editOf? }` or `{ regenerate: <answer id> }`; answers with an event stream (below). `editOf`: the id of your earlier message this one replaces; `regenerate`: the latest answer, asked again |
848
- | `PATCH /api/agent/boards/:id/threads/:thread` | `{ title?, archived? }`: rename (an empty title goes back to the first question) and archive |
849
- | `POST /api/agent/boards/:id/threads/:thread/versions/:version` | Brings back an earlier version (`versions[messageId].previous` or `.next`) |
850
- | `POST /api/agent/boards/:id/threads/:thread/messages/:message/rating` | `{ rating: "up" or "down", reasons?, note? }`; your rating of an answer |
851
- | `DELETE /api/agent/boards/:id/threads/:thread/messages/:message/rating` | Takes your rating back |
852
- | `GET /api/agent/feedback` | Owner only: `?rating=up\|down&days=30&board=<id>`; summary and newest ratings |
853
- | `GET /api/agent/feedback/export` | Owner only: every rating as one JSON file |
854
- | `POST /api/agent/boards/:id/threads/:thread/stop` | Stops the answer being written |
855
- | `POST /api/agent/boards/:id/threads/:thread/options` | `{ configId, value }`: this thread's model or effort (owner only, not mid-answer) |
856
- | `POST /api/agent/boards/:id/threads/:thread/messages/:message/undo` | Undoes what that answer's turn changed (owner only): `{ ok, message }` |
857
- | `POST /api/agent/boards/:id/threads/:thread/permissions/:permission` | `{ optionId }` answers an agent's permission card; `{ optionId: null }` denies |
858
- | `DELETE /api/agent/boards/:id/threads/:thread` | Clears the thread and its images (a New chat thread is deleted) |
859
- | `GET /api/agent/boards/:id/files/:file` | An attached image |
860
- | `GET /api/agent/settings` | Settings > Agent: saved and effective settings, where each comes from |
861
- | `POST /api/agent/settings` | `{ settings, confirm }`; `{ confirm: [...], confirmHash }` when a dialog is needed |
862
- | `POST /api/agent/settings/test` | Test connection: `{ ok, backend, host, sendsKey, message, details }` |
867
+ | Route | What it does |
868
+ | ----------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
869
+ | `GET /api/agent/status` | `{ configured, backend, label, model, host, local, vision, problem, docsUrl }` |
870
+ | `GET /api/agent/boards/:id/threads` | Your threads with messages, newest first (`?q=` searches them): `{ threads: [{ id, kind, commentId?, title, count, createdAt, updatedAt, archived, shared, match? }] }` |
871
+ | `GET /api/agent/boards/:id/threads/:thread` | `{ id, messages, kind, title, archived, shared, versions, running, ratings, options? }`; `:thread` is `board`, `comment-<id>` or `chat-<16 letters or digits>` |
872
+ | `POST /api/agent/boards/:id/threads/:thread/messages` | `{ text, attachments?, mentions?, files?, editOf?, options? }` or `{ regenerate: <answer id> }`; answers with an event stream (below). `editOf`: the id of your earlier message this one replaces; `regenerate`: the latest answer, asked again; `options`: this chat's choices `{ configId: value }` |
873
+ | `PATCH /api/agent/boards/:id/threads/:thread` | `{ title?, archived? }`: rename (an empty title goes back to the first question) and archive |
874
+ | `POST /api/agent/boards/:id/threads/:thread/versions/:version` | Brings back an earlier version (`versions[messageId].previous` or `.next`) |
875
+ | `POST /api/agent/boards/:id/threads/:thread/messages/:message/rating` | `{ rating: "up" or "down", reasons?, note? }`; your rating of an answer |
876
+ | `DELETE /api/agent/boards/:id/threads/:thread/messages/:message/rating` | Takes your rating back |
877
+ | `GET /api/agent/feedback` | Owner only: `?rating=up\|down&days=30&board=<id>`; summary and newest ratings |
878
+ | `GET /api/agent/feedback/export` | Owner only: every rating as one JSON file |
879
+ | `POST /api/agent/boards/:id/threads/:thread/stop` | Stops the answer being written |
880
+ | `POST /api/agent/boards/:id/threads/:thread/options` | `{ configId, value }`: this thread's model or effort (owner only, not mid-answer) |
881
+ | `POST /api/agent/boards/:id/threads/:thread/prepare` | `{ choices?, force? }`: the options a chat starts with, before its first message (owner only, same origin); `{ options, cached? }`, `{ options: null }` when there are none yet, or `{ options: null, error }` for an agent that is not signed in |
882
+ | `POST /api/agent/boards/:id/threads/:thread/messages/:message/undo` | Undoes what that answer's turn changed (owner only): `{ ok, message }` |
883
+ | `POST /api/agent/boards/:id/threads/:thread/permissions/:permission` | `{ optionId }` answers an agent's permission card; `{ optionId: null }` denies |
884
+ | `DELETE /api/agent/boards/:id/threads/:thread` | Clears the thread and its images (a New chat thread is deleted) |
885
+ | `GET /api/agent/boards/:id/files/:file` | An attached image |
886
+ | `GET /api/agent/settings` | Settings > Agent: saved and effective settings, where each comes from |
887
+ | `POST /api/agent/settings` | `{ settings, confirm }`; `{ confirm: [...], confirmHash }` when a dialog is needed |
888
+ | `POST /api/agent/settings/test` | Test connection: `{ ok, backend, host, sendsKey, message, details }` |
863
889
 
864
890
  `versions` maps the id of each edited user message on screen to `{ position, total, previous, next }` (version ids, or null). Another
865
891
  person's `chat-*` thread answers 404 on every route ([Chat history](#chat-history)).
@@ -85,7 +85,7 @@ colours meet WCAG AA on `surface` and `surface-2` (7:1 for High contrast), in li
85
85
 
86
86
  | Component | Notes |
87
87
  | ----------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
88
- | `Button` | `variant`: default, secondary, ghost, danger, link, inverse (on a filled chip). `size`: xs, sm, md, touch, icon-xs, icon-sm, icon. `asChild` for links. |
88
+ | `Button` | `variant`: default, soft (the primary action at rest: accent text on a light tint, same box as default), secondary, ghost, danger, link, inverse (on a filled chip). `size`: xs, sm, md, touch, icon-xs, icon-sm, icon. `asChild` for links. |
89
89
  | `IconButton` | Icon-only `Button` with `label` (its `aria-label`) shown as a tooltip; `tooltip` overrides the tip text. |
90
90
  | `Tooltip`, `TooltipProvider` | `<Tooltip content="...">` around any kit control. One provider at the app root. Mouse and keyboard only. |
91
91
  | `Select` (+ Trigger, Value, Content, Item, Group, Label, Separator) | A popover list on every screen, never the OS picker. Items cannot be `""`: use `placeholder` with `value=""`, or a sentinel. `SelectTrigger` takes `size` (xs, sm, touch) and `tone` (default, active). |
@@ -96,7 +96,7 @@ colours meet WCAG AA on `surface` and `surface-2` (7:1 for High contrast), in li
96
96
  | `Dialog` | `open`, `onClose`, `title`, `description` (one line; `wrapDescription` for a full sentence), `footer`, `size` (sm, md, lg). A bottom sheet on phones, centered from `sm` up. Focuses the first field, or the element marked `data-autofocus`. |
97
97
  | `Tabs` (+ List, Trigger, Content) | A choice that swaps the panel below (before/after on phones). `TabsList variant`: segmented (default) or underline (text-width tabs on a hairline, the active one underlined, the row scrolls sideways when it does not fit; every choice inside Checks uses it). |
98
98
  | `ToggleGroup` | One value out of a few (`options: [{ id, label, count? }]`); replaces the old `Segmented`. `variant`: segmented (default) or underline, the same two looks as `Tabs`. |
99
- | `Toggle` | An on/off chip (`pressed`, `onPressedChange`); `variant` outline or pill. |
99
+ | `Toggle` | An on/off chip (`pressed`, `onPressedChange`); `variant` outline, pill or flat (a borderless toolbar button, pressed = the selected chip). |
100
100
  | `Input`, `Textarea` | `size` xs, sm, touch (16 px text on touch, so iOS does not zoom). `Input` takes an `icon`. |
101
101
  | `Badge`, `CommentDot` | Chips and counters: `tone` neutral, accent, ok, warn, bad, solid; `shape` chip, count, tag. |
102
102
  | `Kbd`, `Separator`, `Spinner` | Small pieces. |
@@ -105,20 +105,24 @@ colours meet WCAG AA on `surface` and `surface-2` (7:1 for High contrast), in li
105
105
  | `Skeleton` | A loading placeholder shaped like what is coming (`className` sets the size). `aria-hidden`; give the screen one `role="status"` label. |
106
106
 
107
107
  Local installations offer **Workspace Console** from the board profile menu, including when no agent is connected or the agent owner key is absent.
108
- The local Console uses the hosted Console's header, sidebar and card layout with real boards from this installation. Its **Settings** section
109
- covers this browser's appearance, installation details and updates. Agent configuration keeps its existing owner permissions; opening
110
- Console or General settings does not unlock it. Hosted boards also label their workspace-management link **Workspace Console**. Local Console does
111
- not create hosted accounts, workspaces or memberships. Inside Console, Projects and Settings stay in the sidebar; the profile menu
108
+ The local Console uses the hosted Console's header, sidebar and card layout with real boards from this installation. Its **Agents** section
109
+ holds everything about agents (the Agents card, the connection details and the endpoint form); its **Settings** section covers this
110
+ browser's appearance, installation details and updates. Agent configuration keeps its existing owner permissions; opening Console,
111
+ Agents or General settings does not unlock it. Hosted boards also label their workspace-management link **Workspace Console**. Local Console does
112
+ not create hosted accounts, workspaces or memberships. Inside Console, Projects, Agents and Settings stay in the sidebar; the profile menu
112
113
  contains identity and appearance rather than duplicate workspace navigation. The earlier `?settings=general` board link remains supported.
113
114
 
114
115
  The app sidebar (`AppRail`, `components/app-rail.jsx`) is a labelled menu when expanded and a rail of icons when collapsed. Collapsed,
115
- an icon with more behind it (the board's pages tree, the sections of the workspace or account you are in) opens a flyout beside the
116
+ an icon with more behind it (the board's Pages and Journeys, the sections of the workspace or account you are in) opens a flyout beside the
116
117
  rail instead of expanding the sidebar: on hover after 150 ms, closing 250 ms after the pointer leaves both the icon and the panel, so
117
118
  you can move into it; a click, tap, Enter, Space or ArrowRight opens it pinned and moves focus in. A choice in it, Escape (focus back on
118
119
  the icon), a click outside or Tab past its end closes it. It is a non-modal `role="dialog"` named after its icon, the expanded
119
120
  sidebar's width, on the Chrome layer (above the canvas and the comment thread, below dialogs and menus). Icons with nothing behind them
120
121
  keep their tooltip. Only the panel button and Ctrl/Cmd+B expand the sidebar. The hover timing and height rules are in
121
- `components/rail-flyout.js`.
122
+ `components/rail-flyout.js`. A rail icon can carry a dot (`dot`): the Journeys icon has one while a journey is open. On the board the
123
+ expanded sidebar puts a segmented `Tabs` switch, "Pages 26 | Journeys 6" with the counts as quiet text, where a single heading would
124
+ be, and shows the page tree (filter "Filter pages") or the journeys list (filter "Filter journeys", only past eight); the tab is
125
+ kept per browser (`board/SidebarNav.jsx`).
122
126
 
123
127
  App-level pieces outside the kit, in `client/src/components/`: `ProfileMenu` (the avatar menu: account items, the console's workspace
124
128
  switcher, View as in the demo, Appearance, and About Shapewall and updates) and `DemoBanner` (the demo's "viewing as" strip with Reset; in the console header a chip whose Reset is desktop only, on phones Reset the demo is in the profile menu).
@@ -129,12 +133,19 @@ scrolling keeps momentum and `scrollIntoView` on phones).
129
133
  ## The board toolbar
130
134
 
131
135
  On desktop the toolbar has three zones, the way canvas tools lay it out. Left, where you are and how you look at it: the board
132
- switcher, the screen-size toggle, View options and, on a local board, Capture with its status (otherwise the status dot sits by the
136
+ switcher, the screen-size toggle, Views (the journeys and what the canvas shows; an open journey's name and a clear button take
137
+ its place on the button) and, on a local board, Capture with its status (otherwise the status dot sits by the
133
138
  name). Centre, find: the "Go to page or journey" box, centred on the toolbar itself, 240 to 320 px wide. Right, act and open panels:
134
- the viewer note, Comment (the one filled button), the Comments, Agent and Checks toggles as one tight group, then Agent settings. Zones
139
+ the viewer note, Comment (the primary action: `soft` while comment mode is off, filled `default` with `aria-pressed="true"`
140
+ while it is on, agreeing with the comment-mode banner), the Comments, Agent and Checks toggles as one tight group (`Toggle variant="flat"`:
141
+ the open panel's toggle takes the selected chip look, none while the panel is closed), then Agent settings. Zones
135
142
  are 20 px apart, controls inside a zone 6 px, with no dividers. When it gets narrow, `client/src/board/toolbarFit.js` drops words in a
136
- fixed order (search to an icon, the panel toggles, View, then the screen-size toggle to icons with tooltips) and the board name
137
- truncates a little at each step, never below about 8 characters. Accessible names, shortcuts and tooltips never change.
143
+ fixed order (search to an icon, the panel toggles, Views (an open journey's name shortens first), then the screen-size toggle to icons with tooltips) and the board name
144
+ truncates a little at each step, never below about 8 characters. With a journey open its name matters more than the search: the
145
+ search is an icon from the start and the name takes the left zone's room, in full up to about 280 px; the icon leaves the centre line
146
+ before the name truncates, and only when the zones no longer fit side by side do the steps go on (the name keeps at least 128 px, then
147
+ 96, then Views becomes an icon). Its full name is the button's accessible name and is in its tooltip. Accessible names, shortcuts and
148
+ tooltips never change.
138
149
  `test/toolbar-fit.test.js` checks the order and that nothing overlaps from a 1024 px window with the widest sidebar up. The phone
139
150
  toolbar is a separate compact bar. `ToggleGroup` options take a `tooltip` for icon-only labels.
140
151
 
package/docs/journeys.md CHANGED
@@ -91,7 +91,7 @@ page id, any step after a page can be a fork:
91
91
 
92
92
  ## Journeys made on the board
93
93
 
94
- Pick **New journey** in the journey picker (on a phone: the **...** menu), then click pages in the order people visit them. Name the
94
+ Pick **New journey** in the toolbar's **Views** menu or the command palette (on a phone: the **...** menu), then click pages in the order people visit them. Name the
95
95
  journey and save. Journeys made this way are stored in `.shapewall/<board>/journeys.json`, with the same atomic writes and file lock as
96
96
  comments, and can be edited or deleted from the journey bar. If a page leaves the config, its steps drop out of the journey (a fork left
97
97
  with one branch becomes that branch's steps).
@@ -117,6 +117,18 @@ The same structure is in `shapewall journeys --json`, the MCP tool `list_journey
117
117
 
118
118
  ## Stepping through
119
119
 
120
+ Open a journey from any of these; they all show the same one:
121
+
122
+ - **Views** in the toolbar: its **Journeys** group lists every journey with its steps (or paths), and **None** shows all pages again.
123
+ With more than eight, the list scrolls and has a filter. While a journey is open the button shows its name, and its **x** leaves it.
124
+ - The sidebar: expanded, its **Pages | Journeys** switch; the **Journeys** tab lists **None** (show all pages) and every journey with
125
+ its steps, the open one highlighted, a filter past eight and **New journey** where you can make one. The tab you chose is kept in this
126
+ browser; opening a journey elsewhere does not switch it, but the **Journeys** tab shows a dot while one is open. Collapsed, the
127
+ **Journeys** icon (with the same dot) opens that list beside the rail.
128
+ - The command palette (Ctrl/Cmd+K): type the journey's name.
129
+ - **J** opens the next journey, **Shift+J** the previous one; past the last one the board shows all pages again.
130
+ - On a phone: the **...** menu's **Journeys** group.
131
+
120
132
  Selecting a journey highlights its pages with numbered badges, draws arrows between consecutive steps and fades everything else. The
121
133
  journey bar steps through it:
122
134
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "shapewall",
3
- "version": "0.2.2",
3
+ "version": "0.2.4",
4
4
  "description": "Every page of your site on one zoomable wall: desktop and phone captures, sandboxed live HTML, and element-anchored comments your coding agent can read.",
5
5
  "license": "Apache-2.0 AND FSL-1.1-ALv2",
6
6
  "author": "Dan Baruch",