@staff0rd/assist 0.586.0 → 0.588.0

package/README.md

@@ -72,6 +72,7 @@ After installation, the `assist` command will be available globally. You can als
 - `/inspect` - Run .NET code inspections on changed files
 - `/screenshot` - Capture a screenshot of a running application window
 - `/raven` - Query and manage RavenDB connections and collections
+- `/miro [board url | extract name]` - Dump a Miro frame's raw `board_list_items` pages and extract its boxes as an ordered YAML list via `assist miro extract`
 - `/seq` - Query Seq logs from a URL or filter expression
 - `/sql` - Query a MSSQL database via assist sql
 - `/verify` - Run all verification commands in parallel
@@ -299,6 +300,7 @@ The Config tab of the sessions web dashboard never receives secret values: `GET
 
 - `assist netcap [-p, --port <port>] [-o, --out <dir>] [-f, --filter <pattern>]` - Capture browser network traffic to `capture.jsonl` under `--out` (default `~/.assist/netcap`), paired with the [netcap browser extension](#netcap-browser-extension)
 - `assist netcap extract-linkedin-posts [file]` - Parse a netcap capture into structured LinkedIn posts, written to `posts.json` beside the capture
+- `assist criteria-extension` - Print the directory to load the [acceptance criteria outliner extension](#acceptance-criteria-outliner-extension) unpacked from (copies to `C:\tools\criteria-extension` under WSL)
 - `assist screenshot <process>` - Capture a screenshot of a running application window (`screenshot.outputDir`, default `./screenshots`)
 - `assist handover save --summary <s>` - Save a session handover note (content from stdin), scoped by the repo's git origin
 - `assist handover list` - List unrecalled handovers for this repo, most recent first
@@ -420,6 +422,16 @@ Web server changes only need the `assist sessions` process restarted — session
 - `branch.prefix` — when set (e.g. `sw`), `assist branch <slug>` prepends `<prefix>/` to the branch name
 - `branch.defaultBranch` — override the base branch, which is otherwise resolved live from the remote (`git ls-remote --symref origin HEAD`), falling back to `main`
 
+## Acceptance criteria outliner extension
+
+`assist criteria-extension` prints the directory to load unpacked; nothing talks to assist at runtime. The extension is a single Manifest V3 content script scoped to `https://github.com/*`, built by `npm run build` from `src/commands/criteriaExtension/criteriaContentScript.tsx` into `criteria-extension/content.js` (gitignored). It adds an **Outline criteria** toggle to the markdown toolbar of an issue's body editor; pressing it hides the textarea and mounts the same `AcceptanceCriteriaOutline` control the web preview panel uses, in a shadow root with its own emotion cache and MUI theme. Each edit is written back through `writeAcceptanceCriteria` into the textarea and dispatched as an `input` event, so GitHub's own Save pushes it.
+
+1. Run `assist criteria-extension` — it prints the extension directory. Under WSL it copies the extension to `C:\tools\criteria-extension` and prints that Windows path instead; re-run and reload the extension after a rebuild.
+2. Load the unpacked extension:
+   - **Chrome**: open `chrome://extensions`, enable **Developer mode**, click **Load unpacked**, and select the extension directory.
+   - **Firefox**: open `about:debugging#/runtime/this-firefox` → **Load Temporary Add-on…** → pick `manifest.json` inside the printed extension directory.
+3. Open an issue, press **Edit** on the body, and press **Outline criteria**.
+
 ## netcap browser extension
 
 `assist netcap` only runs the receiver; the browser side is a raw Manifest V3 extension (no build step) under `netcap-extension/`. A MAIN-world content script patches `fetch`/`XMLHttpRequest` to capture `{url, method, status, requestBody, responseBody, timestamp}` and relays each entry to the background service worker, which POSTs it to the receiver. Forwarding happens in the background context, so the page's CSP (`connect-src`) never blocks it.

package/allowed.cli-reads

@@ -32,6 +32,7 @@ assist complexity
 assist config get
 assist config keys
 assist config list
+assist criteria-extension
 assist coverage
 assist daemon status
 assist dotnet
@@ -41,6 +42,7 @@ assist jira auth
 assist jira view
 assist list
 assist ls
+assist miro extract
 assist news
 assist prs list-comments
 assist ravendb auth list

package/claude/commands/miro.md

@@ -0,0 +1,46 @@
+---
+description: Dump a Miro frame and extract its boxes as an ordered YAML list
+allowed_args: "[board url | extract name]"
+---
+
+The user wants the text of every box inside a rectangle on a Miro board, in priority order. Fetching is your job; everything after the dump is `assist miro extract`.
+
+## Step 0: is this a saved extract?
+
+If `$ARGUMENTS` names a saved extract, or the user asks to refresh one they have picked before, do not re-pick anchors. Re-dump the frame over the extract's `items` file (step 2), then run `assist miro extract <name>`, which resolves board, frame, anchors, items, ignore and out from config. `assist config get miro.extracts` lists what is already saved.
+
+## Step 1: confirm the frame
+
+Run `context_explore` on the board URL and show the user the frames it returns. Confirm which frame is the target before dumping anything — a whole-board dump is large and usually wrong.
+
+## Step 2: dump the raw pages
+
+Call `board_list_items` with the board URL plus `?moveToWidget=<frame_id>` for the confirmed frame and `limit: 50`. Page with the returned `cursor` until `has_more` is false.
+
+Write the raw response pages to a file (e.g. `board-items.json`) **exactly as returned** — a JSON array of the page objects, or one page object per line. Do not rename, reshape, flatten, sort or filter anything: the CLI normalises centre-origin positions, `geometry` and the HTML in `data.content` itself, and it errors if the shape is wrong rather than guessing.
+
+## Step 3: extract
+
+- Already picked: `assist miro extract <name>`
+- Anchors known: `assist miro extract --items board-items.json --top-left <id|link> --bottom-right <id|link>`
+- First time: `assist miro extract --items board-items.json --save <name>`
+
+With no anchor flags the command renders the dump in the assist web UI preview pane, where the user clicks the top-left then the bottom-right box. **That needs the assist web UI running and this conversation attached to an assist session** — without one the command fails naming both flags rather than hanging. If it fails that way, tell the user to start the web UI (or supply the two ids).
+
+Pass `--save <name>` on a first-time run. The interactive "save this selection?" prompt only appears on a TTY, so an agent run that omits `--save` picks anchors and then discards them. Add `-g` (or `-g -r [repo]`) only if the user asks for a config level other than the project `assist.yml`; the command prints the file it wrote and, on later runs, the file the extract came from.
+
+Add `--ignore <file>` (a YAML list of box texts) to drop banners and containers, and `--out <file>` to write the YAML with a provenance header instead of printing it.
+
+## Anchor ids
+
+Anchors are chosen visually, in the picker. There is no reliable way to read them off the board by hand:
+
+- A per-item **Copy link to object** link gives `?moveToWidget=<id>`, which the command accepts verbatim as an anchor.
+- A multi-select share link gives an opaque `moveToWidgets=<token>` — the API cannot resolve it, so it is useless here. Do not try to pass one.
+- Nothing exposes the user's live Miro selection.
+
+The picker echoes `--top-left <id> --bottom-right <id>` to stdout; report that pair to the user so it can be reused as flags.
+
+## Reporting
+
+Show the extracted list. The order is leftmost box edge first, topmost edge breaking ties — a wide banner spanning the board sorts early by design, so suggest the ignore list rather than treating it as a bug.

package/claude/settings.json

@@ -96,6 +96,8 @@
 			"SlashCommand(/strip-code-comments)",
 			"Skill(subtask)",
 			"SlashCommand(/subtask)",
+			"Skill(miro)",
+			"SlashCommand(/miro)",
 			"Bash(git ls-files:*)",
 			"Bash(gh pr checks:*)",
 			"Bash(ls ~/.assist/pr-comments:*)",

package/dist/allowed.cli-reads

@@ -32,6 +32,7 @@ assist complexity
 assist config get
 assist config keys
 assist config list
+assist criteria-extension
 assist coverage
 assist daemon status
 assist dotnet
@@ -41,6 +42,7 @@ assist jira auth
 assist jira view
 assist list
 assist ls
+assist miro extract
 assist news
 assist prs list-comments
 assist ravendb auth list