shapewall 0.2.3 → 0.3.0
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 +48 -0
- package/README.md +35 -1
- package/dist/agent/package-lock.json +2 -2
- package/dist/client/assets/BoardChat-CupOxioV.js +27 -0
- package/dist/client/assets/{BuzzDialog-CZdwIQLF.js → BuzzDialog-Ds7Thpfe.js} +1 -1
- package/dist/client/assets/ChecksPanel-BqrS02Ih.js +1 -0
- package/dist/client/assets/History-CQG3NQOC.js +1 -0
- package/dist/client/assets/{LocalSettings-CvlVtNY_.js → LocalSettings-CSNMhNyV.js} +1 -1
- package/dist/client/assets/{Management-DOJkFY_o.js → Management-CJVNAqAW.js} +1 -1
- package/dist/client/assets/QuickConnect-B-4pUgXH.js +1 -0
- package/dist/client/assets/{ShareDialog-CdVAreaw.js → ShareDialog-BouvNraR.js} +2 -2
- package/dist/client/assets/{app-update-dialog-Dox9-LWv.js → app-update-dialog-rhaw0MRk.js} +1 -1
- package/dist/client/assets/{circle-x-BmT6vHKl.js → circle-x-PRxj7kPi.js} +1 -1
- package/dist/client/assets/index-CXtuJi1K.css +2 -0
- package/dist/client/assets/index-DKOCIQiq.js +37 -0
- package/dist/client/assets/{refresh-cw-ugt3cWKH.js → refresh-cw-aeOBDuGQ.js} +1 -1
- package/dist/client/assets/{square-_KG6tM5A.js → shield-check-DuPBJ6H_.js} +1 -1
- package/dist/client/assets/ui-Cg4TTrec.js +41 -0
- 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-DOKZI6Lt.js +1 -0
- package/dist/console/assets/LocalConsole-DXzldLW9.js +1 -0
- package/dist/console/assets/app-update-dialog-CrqIMEwN.js +1 -0
- package/dist/console/assets/console-76WovHlh.js +55 -0
- package/dist/console/assets/console-Fp4k9iyx.css +2 -0
- package/dist/console/build-info.json +1 -1
- package/dist/console/console.html +2 -2
- package/docs/agent-hardening.md +19 -0
- package/docs/agent-workflow.md +33 -0
- package/docs/agents.md +112 -0
- package/docs/config.md +41 -0
- package/docs/deployment.md +3 -0
- package/docs/design-system.md +13 -5
- package/docs/hosted.md +10 -0
- package/docs/journeys.md +13 -1
- package/docs/pull-requests.md +192 -0
- package/package.json +2 -1
- package/src/agent/backends/acp.js +35 -6
- package/src/agent/batch-fixes.js +45 -0
- package/src/agent/batch-queue.js +204 -0
- package/src/agent/branch-mode.js +753 -0
- package/src/agent/config.js +6 -0
- package/src/agent/fix-prompt.js +5 -0
- package/src/agent/manage.js +1 -1
- package/src/agent/routes.js +901 -186
- package/src/agent/run.js +8 -1
- package/src/agent/settings-events.js +103 -0
- package/src/agent/settings-routes.js +92 -2
- package/src/agent/starter/worktree.js +254 -25
- package/src/agent/threads.js +2 -7
- package/src/agent/tools.js +51 -0
- package/src/agent/user-settings.js +33 -2
- package/src/ci/capture.js +103 -0
- package/src/ci/compare.js +267 -0
- package/src/ci/github.js +307 -0
- package/src/ci/images.js +76 -0
- package/src/ci/settings.js +211 -0
- package/src/ci/start.js +148 -0
- package/src/ci/summary.js +262 -0
- package/src/ci/workflow.js +238 -0
- package/src/cli/args.js +24 -1
- package/src/cli/ci.js +229 -0
- package/src/cli/help.js +23 -1
- package/src/cli/init.js +33 -1
- package/src/cli.js +6 -2
- package/src/comment-drawing.js +161 -0
- package/src/comment-fields.js +51 -0
- package/src/comment-media.js +528 -0
- package/src/config.js +7 -0
- package/src/doctor.js +23 -0
- package/src/export.js +8 -0
- package/src/feedback.js +89 -12
- package/src/github.js +3 -3
- package/src/hosted/admin.js +36 -4
- package/src/hosted/app.js +5 -0
- package/src/hosted/board-routes.js +63 -7
- package/src/hosted/clean-worker.js +22 -4
- package/src/hosted/cleaner.js +4 -1
- package/src/hosted/comment-files.js +200 -0
- package/src/hosted/comments.js +68 -15
- package/src/hosted/db.js +32 -0
- package/src/hosted/guest-view.js +9 -0
- package/src/hosted/import.js +213 -18
- package/src/hosted/operator.js +3 -1
- package/src/hosted/projects.js +3 -2
- package/src/hosted/push.js +6 -3
- package/src/hosted/retention.js +18 -0
- package/src/hosted/tenancy.js +1 -0
- package/src/hosted/token-api.js +110 -9
- package/src/image-sniff.js +11 -0
- package/src/mcp.js +48 -3
- package/src/remote/remote-mcp.js +2 -2
- package/src/remote/remote.js +6 -2
- package/src/remote/share.js +77 -7
- package/src/server/app.js +18 -1
- package/src/store.js +119 -33
- package/src/watch.js +4 -0
- package/dist/client/assets/BoardChat-C88k4s-W.js +0 -28
- package/dist/client/assets/ChecksPanel-B54chcLA.js +0 -1
- package/dist/client/assets/History-CVVuuxUK.js +0 -1
- package/dist/client/assets/QuickConnect-D40mj4Ry.js +0 -1
- package/dist/client/assets/index-CwvFfwU0.js +0 -29
- package/dist/client/assets/index-UIYSPHoh.css +0 -2
- package/dist/client/assets/ui-BAGBTB_P.js +0 -41
- package/dist/console/assets/LocalAccountsApp-4MtW1QlZ.js +0 -1
- package/dist/console/assets/LocalConsole-CgKqYa8i.js +0 -1
- package/dist/console/assets/app-update-dialog-S2Yyc7Pw.js +0 -1
- package/dist/console/assets/console-BPmBRIoz.js +0 -51
- package/dist/console/assets/console-DgVrGRMD.css +0 -2
package/CHANGELOG.md
CHANGED
|
@@ -3,6 +3,54 @@
|
|
|
3
3
|
All notable changes to this project are documented here. The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
|
|
4
4
|
and the project uses [Semantic Versioning](https://semver.org/).
|
|
5
5
|
|
|
6
|
+
## 0.3.0 - 2026-11-10
|
|
7
|
+
|
|
8
|
+
- Agent works on a branch: an option, off by default, that runs an ACP agent's fixes and chat turns in a copy of your checkout and
|
|
9
|
+
commits them on a branch of their own. The comment reads "Fix ready on branch", and the chat offers Apply to my checkout, Open
|
|
10
|
+
folder, Copy branch name and Discard. Apply recaptures the page with before and after; a conflict changes nothing. See
|
|
11
|
+
"Work on a branch" in docs/agents.md.
|
|
12
|
+
- The Agents page of the Workspace Console has a How fixes run card: the Work on a branch switch with its branch prefix (the same
|
|
13
|
+
setting as the chat's switch), and the batch fixes switch with its limit. A change to either shows in every open view.
|
|
14
|
+
- Batch fixes: an option, off by default, to fix several open comments one after another. In the comments panel choose Select, tick
|
|
15
|
+
comments (or Select all, up to the limit) and Fix N with the agent; a dialog lists them first. Each comment is an ordinary fix with
|
|
16
|
+
its own thread, approvals, recapture and Undo, and in branch mode its own branch. A card in the chat and a strip in the comments
|
|
17
|
+
panel show "Fixing 2 of 5" and each comment's state, also after a reload. The batch waits for an approval, stops on Cancel and after
|
|
18
|
+
two failures in a row. Set `"agent": { "batchFixes": { "enabled": true, "max": 5 } }` (at most 20) or use the Agents page. Not on
|
|
19
|
+
the hosted server. See "Fix several comments at once" in docs/agents.md.
|
|
20
|
+
- `shapewall doctor` reports agent branches left in the project.
|
|
21
|
+
- Capture on pull requests: `shapewall init --ci` writes a GitHub Actions workflow that captures the base branch and the pull request,
|
|
22
|
+
compares every page and screen size with the pixel diff, and keeps one comment on the pull request up to date ("Shapewall: 4 of 23
|
|
23
|
+
pages changed") with the changed share and before, after and diff images. It builds and serves both sides from `ci.start` in the
|
|
24
|
+
config, or captures a deploy preview URL. Pull requests from forks get the summary in the job summary instead. Turn it off by
|
|
25
|
+
deleting the workflow, with `"ci": { "enabled": false }`, or with `[skip shapewall]` in the title. See docs/pull-requests.md.
|
|
26
|
+
- New commands: `shapewall ci capture-compare`, `ci capture`, `ci comment`, `ci enabled` and `ci wait`.
|
|
27
|
+
- Images on comments and replies: attach up to 4 (PNG, JPEG, WebP or GIF, 5 MB each) with a button, by pasting or by dropping them.
|
|
28
|
+
The server checks each image by its bytes, strips its metadata and serves it only as an image; the thread shows thumbnails that open
|
|
29
|
+
large. The comments list shows how many a thread has.
|
|
30
|
+
- Drawing on the page as part of a comment or reply: boxes, arrows and pen strokes in three inks, with Undo and Clear. The drawing
|
|
31
|
+
shows over the page while its thread is open, and over "before" once the page is recaptured. On a phone you draw on the page in a
|
|
32
|
+
full-screen sheet.
|
|
33
|
+
- Agents get the images and a picture of the drawing on its screenshot: in `comments --json` (`files.images`, `files.markup`), the MCP
|
|
34
|
+
`get_comment` tool, `watch --exec` and Fix with agent.
|
|
35
|
+
- Hosted boards keep comment images in the database, count them against the storage quota and include them in exports and in
|
|
36
|
+
`shapewall share`. Share link guests can draw but not attach images.
|
|
37
|
+
- The demo takes images and drawings in the browser and shows example comments with an image and a drawing, one of them with a fix
|
|
38
|
+
ready on a branch. Its Agents page has the How fixes run card, and its scripted agent runs batch fixes.
|
|
39
|
+
- While you draw on a page, the collapsed sidebar's flyouts stay closed and the journey bar is hidden, so nothing covers the drawing
|
|
40
|
+
bar.
|
|
41
|
+
|
|
42
|
+
## 0.2.4 - 2026-11-10
|
|
43
|
+
|
|
44
|
+
- The top bar's View button is now Views: pick a journey by name there, alongside links, compare and the minimap. An open journey
|
|
45
|
+
shows its name in the top bar with a button to leave it. J and Shift+J step through journeys.
|
|
46
|
+
- An open journey's name comes before the search box in the top bar: the search becomes an icon and the name shows in full up to
|
|
47
|
+
about 280 px.
|
|
48
|
+
- The sidebar has a Pages | Journeys switch, and collapsed, an icon for each; the Journeys icon shows a dot while a journey is open.
|
|
49
|
+
- Agent settings stay in sync everywhere: a change in another tab, the Agents page, `shapewall settings` or the agents file shows up
|
|
50
|
+
in every open view without a reload, and never over unsaved typing.
|
|
51
|
+
- The demo's Agents page is the full page, with sample agents in every state.
|
|
52
|
+
- Releases are published to npm from CI with provenance.
|
|
53
|
+
|
|
6
54
|
## 0.2.3 - 2026-11-10
|
|
7
55
|
|
|
8
56
|
- The agent's model and thinking level are shown on a new chat before the first message, each with its own menu in the composer
|
package/README.md
CHANGED
|
@@ -222,6 +222,8 @@ To close the loop without anyone typing a command:
|
|
|
222
222
|
- `shapewall watch --mention agent` only hands out comments that tag `@agent` (in the text or a reply), so people can talk first.
|
|
223
223
|
- Its status goes `queued`, `working`, then `done` or `needs-human`; a restart or a second watcher never hands one out twice.
|
|
224
224
|
- `shapewall mcp` is an MCP server with tools to list, read (with a crop of the screenshot), reply, set status, resolve and recapture.
|
|
225
|
+
- Comments can carry images and a drawing on the page; agents get both
|
|
226
|
+
([images and drawings on comments](docs/agent-workflow.md#images-and-drawings-on-comments)).
|
|
225
227
|
- With Shapewall installed in your project: `claude mcp add shapewall -- npx shapewall mcp`; Codex and other clients in
|
|
226
228
|
[docs/agent-workflow.md](docs/agent-workflow.md).
|
|
227
229
|
|
|
@@ -237,6 +239,14 @@ comment text, page URL, element, screenshot link and a link back to the board. P
|
|
|
237
239
|
`Fixes shapewall#12` (or close the comment's issue) are linked to it by `shapewall github sync` or a signed webhook, and when one merges,
|
|
238
240
|
the comment resolves with the PR as its fix. Details: [docs/github.md](docs/github.md).
|
|
239
241
|
|
|
242
|
+
### Capture on pull requests
|
|
243
|
+
|
|
244
|
+
`npx shapewall init --ci` writes a GitHub Actions workflow. Commit it, and every pull request gets one comment, updated on each push:
|
|
245
|
+
"Shapewall: 4 of 23 pages changed", with each changed page and screen size, the share of pixels that changed, and the before, after and
|
|
246
|
+
diff images as a workflow artifact. It builds and serves both branches (`ci.start` in the config) or captures your deploy preview, never
|
|
247
|
+
fails the pull request, and turns off with `"ci": { "enabled": false }` or `[skip shapewall]` in a title.
|
|
248
|
+
Details: [docs/pull-requests.md](docs/pull-requests.md).
|
|
249
|
+
|
|
240
250
|
Prompts that work, the data shapes, and how to keep it safe (comments are untrusted input): [docs/agent-workflow.md](docs/agent-workflow.md).
|
|
241
251
|
Copy-paste setups for Claude Code, Codex, goose, Ollama and chat bots: [docs/agent-recipes.md](docs/agent-recipes.md).
|
|
242
252
|
Optional integrations: [notifications](#notifications), GitHub connect above, and a [bridge to agents in a Buzz chat](docs/buzz.md).
|
|
@@ -249,7 +259,9 @@ one-time download of about 90 MB; the text never leaves the browser). Connect an
|
|
|
249
259
|
in `SHAPEWALL_AGENT_API_KEY` (OpenAI, DeepSeek, OpenRouter, or Ollama with no key), or an agent CLI on your machine over ACP with its
|
|
250
260
|
own subscription login: `shapewall serve --agent-acp "claude-agent-acp"` (also `codex-acp`, `goose acp`, `gemini --acp`). Or skip the
|
|
251
261
|
flags: open the board with `shapewall serve --open` and click **Connect** next to the agent CLI it found on your machine. Board text
|
|
252
|
-
goes to the agent as quoted data, never as instructions.
|
|
262
|
+
goes to the agent as quoted data, never as instructions. Optional, on the Agents page: an agent CLI can
|
|
263
|
+
[work on a branch](docs/agents.md#work-on-a-branch) instead of your checkout, and
|
|
264
|
+
[fix several comments at once](docs/agents.md#fix-several-comments-at-once), one after another. Details: [docs/agents.md](docs/agents.md).
|
|
253
265
|
|
|
254
266
|
### The sandboxed starter agent
|
|
255
267
|
|
|
@@ -380,6 +392,8 @@ Commands
|
|
|
380
392
|
(with --limit, --group, --exclude as for sitemap)
|
|
381
393
|
--no-discover do not look for pages: write the home page only
|
|
382
394
|
--force overwrite an existing config
|
|
395
|
+
--ci write .github/workflows/shapewall.yml (capture on every pull request) beside
|
|
396
|
+
the config; an existing config is kept, --force replaces only the workflow
|
|
383
397
|
sitemap [URL|FILE] add the pages of a sitemap.xml (or sitemap index) to the config
|
|
384
398
|
(default: the board's "sitemap" setting)
|
|
385
399
|
--limit N at most N new pages, the shallowest first (default 100)
|
|
@@ -507,6 +521,26 @@ Commands
|
|
|
507
521
|
github sync link pull requests that name a comment; resolve comments whose PR merged
|
|
508
522
|
(repo: "github.repo" in the config; token: $SHAPEWALL_GITHUB_TOKEN or $GITHUB_TOKEN,
|
|
509
523
|
else a signed-in GitHub CLI ("gh auth token"))
|
|
524
|
+
ci capture-compare capture before and after, compare every page and viewport, write a result
|
|
525
|
+
folder: summary.json, summary.md (the comment), images of changed shots
|
|
526
|
+
--base-url URL before (default: the board's baseUrl) --head-url URL after
|
|
527
|
+
--base-dir DIR or compare two capture folders --head-dir DIR
|
|
528
|
+
--out DIR the result folder (default shapewall-ci)
|
|
529
|
+
--threshold RATIO share of pixels below which a shot is unchanged (default ci.threshold, 0.001)
|
|
530
|
+
--max-pages N compare at most N pages (default ci.maxPages, 50)
|
|
531
|
+
--fail-on-change exit 3 when something changed (default: always 0, never fails the pull request)
|
|
532
|
+
ci capture --out DIR capture one side into a folder, from --url URL, or with --allow-start
|
|
533
|
+
--allow-start run ci.start (install, build, serve; argv arrays, no shell) in --checkout DIR
|
|
534
|
+
and capture its url; only inside a CI job (GITHUB_ACTIONS or CI is "true")
|
|
535
|
+
ci comment post or update the one pull request comment from a result folder
|
|
536
|
+
--dir DIR the result folder (default shapewall-ci)
|
|
537
|
+
--artifact-url URL link to the workflow artifact with the images
|
|
538
|
+
--repo OWNER/NAME | --pull N default: from the pull_request event
|
|
539
|
+
token: $GITHUB_TOKEN; a fork's pull request gets the job summary instead
|
|
540
|
+
ci enabled is it on for this pull request (ci.enabled, [skip shapewall] in the title)?
|
|
541
|
+
writes enabled=true|false to $GITHUB_OUTPUT
|
|
542
|
+
ci wait --url URL wait until a deploy preview answers [--timeout SECONDS (default 600)]
|
|
543
|
+
--board ID | --json (docs/pull-requests.md)
|
|
510
544
|
mcp MCP server on stdio for coding agents
|
|
511
545
|
--read-only | --no-capture
|
|
512
546
|
notify list notification channels, their events and what each still needs [--json]
|
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "shapewall",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.3.0",
|
|
4
4
|
"lockfileVersion": 3,
|
|
5
5
|
"requires": true,
|
|
6
6
|
"packages": {
|
|
7
7
|
"": {
|
|
8
8
|
"name": "shapewall",
|
|
9
|
-
"version": "0.
|
|
9
|
+
"version": "0.3.0",
|
|
10
10
|
"license": "Apache-2.0 AND FSL-1.1-ALv2",
|
|
11
11
|
"dependencies": {
|
|
12
12
|
"@agentclientprotocol/sdk": "2.4.0",
|