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.
- package/CHANGELOG.md +22 -0
- package/dist/agent/package-lock.json +2 -2
- package/dist/client/assets/BoardChat-C0a3DDjv.js +28 -0
- package/dist/client/assets/{BuzzDialog-HWXBy52W.js → BuzzDialog-CZdwIQLF.js} +1 -1
- package/dist/client/assets/ChecksPanel-BHWgwJWO.js +1 -0
- package/dist/client/assets/{History-CEv6b-av.js → History-C01qLFpP.js} +1 -1
- package/dist/client/assets/LocalSettings-B5gtfKEl.js +1 -0
- package/dist/client/assets/{Management-DCfhcEUY.js → Management-BxEUZAmI.js} +1 -1
- package/dist/client/assets/QuickConnect-BzTM3UNO.js +1 -0
- package/dist/client/assets/{ShareDialog-C_plIto0.js → ShareDialog-CdVAreaw.js} +1 -1
- package/dist/client/assets/{app-update-dialog-2hPz_N9G.js → app-update-dialog-BONq9YFp.js} +1 -1
- package/dist/client/assets/{circle-x-BZMPi8Zf.js → circle-x-BmT6vHKl.js} +1 -1
- package/dist/client/assets/index-C1IsGdGs.js +29 -0
- package/dist/client/assets/index-DnsWelgZ.css +2 -0
- package/dist/client/assets/{refresh-cw-CRow0Nbq.js → refresh-cw-ugt3cWKH.js} +1 -1
- package/dist/client/assets/{square-A8EnIYLR.js → square-_KG6tM5A.js} +1 -1
- package/dist/client/assets/{ui-CLbws0rx.js → ui-BAGBTB_P.js} +1 -1
- package/dist/client/build-info.json +1 -1
- package/dist/client/index.html +3 -3
- package/dist/client/sw.js +2 -2
- package/dist/console/assets/LocalAccountsApp-DtfTDbQg.js +1 -0
- package/dist/console/assets/LocalConsole-BPpsxDq_.js +1 -0
- package/dist/console/assets/app-update-dialog-o4QY_jL9.js +1 -0
- package/dist/console/assets/console-DeOji9Zv.css +2 -0
- package/dist/console/assets/console-MvFrlUCC.js +51 -0
- package/dist/console/build-info.json +1 -1
- package/dist/console/console.html +2 -2
- package/docs/agents.md +61 -35
- package/docs/design-system.md +23 -12
- package/docs/journeys.md +13 -1
- package/package.json +1 -1
- package/src/agent/backends/acp.js +229 -41
- package/src/agent/manage.js +1 -1
- package/src/agent/options-cache.js +52 -0
- package/src/agent/routes.js +171 -6
- package/src/agent/run.js +20 -1
- package/src/agent/settings-events.js +103 -0
- package/src/agent/settings-routes.js +24 -2
- package/dist/client/assets/BoardChat-D5SFd8HE.js +0 -28
- package/dist/client/assets/ChecksPanel-DTdImWoD.js +0 -1
- package/dist/client/assets/LocalSettings-C4vriEVQ.js +0 -1
- package/dist/client/assets/QuickConnect-DQGgUsl1.js +0 -1
- package/dist/client/assets/index-ByQRKVit.css +0 -2
- package/dist/client/assets/index-DweQ8Qtu.js +0 -29
- package/dist/console/assets/LocalAccountsApp-BQCcmj3x.js +0 -1
- package/dist/console/assets/LocalConsole-Bb2FUDs7.js +0 -1
- package/dist/console/assets/app-update-dialog-DIeYepLZ.js +0 -1
- package/dist/console/assets/console-C7uJLLOn.js +0 -51
- package/dist/console/assets/console-R8IBY3Am.css +0 -2
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":"0.2.
|
|
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-
|
|
16
|
-
<link rel="stylesheet" crossorigin href="/_console/assets/console-
|
|
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**
|
|
71
|
-
[Agents in Workspace
|
|
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
|
|
105
|
+
## Agents in the Workspace Console
|
|
106
106
|
|
|
107
|
-
The local Workspace Console's **
|
|
108
|
-
|
|
109
|
-
|
|
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)
|
|
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
|
|
695
|
-
|
|
696
|
-
|
|
697
|
-
|
|
698
|
-
|
|
699
|
-
|
|
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/
|
|
857
|
-
| `POST /api/agent/boards/:id/threads/:thread/
|
|
858
|
-
| `
|
|
859
|
-
| `
|
|
860
|
-
| `GET /api/agent/
|
|
861
|
-
| `
|
|
862
|
-
| `POST /api/agent/settings
|
|
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)).
|
package/docs/design-system.md
CHANGED
|
@@ -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
|
|
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 **
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
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
|
|
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,
|
|
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
|
|
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,
|
|
137
|
-
truncates a little at each step, never below about 8 characters.
|
|
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
|
|
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.
|
|
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",
|