@bitcobblers/wod-wiki-tools 0.53.2204 → 0.54.2205

package/dist/web/playground/seed/core/markdown/efforts/unconventional/macebell-360-swing.json

@@ -5,7 +5,7 @@
   "blockIndex": [],
   "blockEfforts": [],
   "blockEquipment": [],
-  "commit": "5497f334eaeb0230ab730ba472c1e9b598b6a312",
+  "commit": "1a0df570c7ae319006110948811cd714188687e8",
   "uuid": "84034d68-a313-53a8-8f0b-dd755e70311e",
   "version": 1
 }

package/dist/web/playground/seed/core/markdown/efforts/unconventional/macebell-barbarian-squat.json

@@ -5,7 +5,7 @@
   "blockIndex": [],
   "blockEfforts": [],
   "blockEquipment": [],
-  "commit": "5497f334eaeb0230ab730ba472c1e9b598b6a312",
+  "commit": "1a0df570c7ae319006110948811cd714188687e8",
   "uuid": "8191ab0d-1911-5b57-a841-989d34368416",
   "version": 1
 }

package/dist/web/playground/seed/core/markdown/efforts/unconventional/macebell-flow.json

@@ -5,7 +5,7 @@
   "blockIndex": [],
   "blockEfforts": [],
   "blockEquipment": [],
-  "commit": "5497f334eaeb0230ab730ba472c1e9b598b6a312",
+  "commit": "1a0df570c7ae319006110948811cd714188687e8",
   "uuid": "3626f1a0-5ac0-5f6b-b479-4ce716ab206d",
   "version": 1
 }

package/dist/web/playground/seed/core/markdown/efforts/unconventional/macebell-gravedigger.json

@@ -5,7 +5,7 @@
   "blockIndex": [],
   "blockEfforts": [],
   "blockEquipment": [],
-  "commit": "5497f334eaeb0230ab730ba472c1e9b598b6a312",
+  "commit": "1a0df570c7ae319006110948811cd714188687e8",
   "uuid": "4089fb14-36aa-5019-a98e-a2666cb42b36",
   "version": 1
 }

package/dist/web/playground/seed/core/markdown/efforts/unconventional/macebell-touchdown.json

@@ -5,7 +5,7 @@
   "blockIndex": [],
   "blockEfforts": [],
   "blockEquipment": [],
-  "commit": "5497f334eaeb0230ab730ba472c1e9b598b6a312",
+  "commit": "1a0df570c7ae319006110948811cd714188687e8",
   "uuid": "bfe01d2f-d415-51b5-809e-5d786b54898f",
   "version": 1
 }

package/dist/web/playground/seed/core/markdown/efforts/unconventional/sandbag-bear-hug-carry.json

@@ -5,7 +5,7 @@
   "blockIndex": [],
   "blockEfforts": [],
   "blockEquipment": [],
-  "commit": "5497f334eaeb0230ab730ba472c1e9b598b6a312",
+  "commit": "1a0df570c7ae319006110948811cd714188687e8",
   "uuid": "eace3f75-7a60-5e59-a873-91e1317b9d79",
   "version": 1
 }

package/dist/web/playground/seed/core/markdown/efforts/unconventional/sandbag-bear-hug-extension.json

@@ -5,7 +5,7 @@
   "blockIndex": [],
   "blockEfforts": [],
   "blockEquipment": [],
-  "commit": "5497f334eaeb0230ab730ba472c1e9b598b6a312",
+  "commit": "1a0df570c7ae319006110948811cd714188687e8",
   "uuid": "829da3e1-5f20-53d4-8a54-cdb94db4c951",
   "version": 1
 }

package/dist/web/playground/seed/core/markdown/efforts/unconventional/sandbag-over-shoulder.json

@@ -5,7 +5,7 @@
   "blockIndex": [],
   "blockEfforts": [],
   "blockEquipment": [],
-  "commit": "5497f334eaeb0230ab730ba472c1e9b598b6a312",
+  "commit": "1a0df570c7ae319006110948811cd714188687e8",
   "uuid": "ced86efd-b1fc-50aa-b734-bf9501d52160",
   "version": 1
 }

package/dist/web/playground/seed/core/markdown/efforts/walking/walking-3-mph.json

@@ -5,7 +5,7 @@
   "blockIndex": [],
   "blockEfforts": [],
   "blockEquipment": [],
-  "commit": "5497f334eaeb0230ab730ba472c1e9b598b6a312",
+  "commit": "1a0df570c7ae319006110948811cd714188687e8",
   "uuid": "721e31d9-2b44-5d6d-959c-5473aefe808d",
   "version": 1
 }

package/dist/web/playground/seed/core/markdown/equipment/air-bike.json

@@ -5,7 +5,7 @@
   "blockIndex": [],
   "blockEfforts": [],
   "blockEquipment": [],
-  "commit": "5497f334eaeb0230ab730ba472c1e9b598b6a312",
+  "commit": "1a0df570c7ae319006110948811cd714188687e8",
   "uuid": "eb26361e-fd14-50e5-94dc-5b860051203d",
   "version": 1
 }

package/dist/web/playground/seed/core/markdown/equipment/barbell.json

@@ -5,7 +5,7 @@
   "blockIndex": [],
   "blockEfforts": [],
   "blockEquipment": [],
-  "commit": "5497f334eaeb0230ab730ba472c1e9b598b6a312",
+  "commit": "1a0df570c7ae319006110948811cd714188687e8",
   "uuid": "9278cedb-7465-5085-8703-920cee21d84f",
   "version": 1
 }

package/dist/web/playground/seed/core/markdown/equipment/bench.json

@@ -5,7 +5,7 @@
   "blockIndex": [],
   "blockEfforts": [],
   "blockEquipment": [],
-  "commit": "5497f334eaeb0230ab730ba472c1e9b598b6a312",
+  "commit": "1a0df570c7ae319006110948811cd714188687e8",
   "uuid": "a1bfcd6f-74d0-52d8-8afd-108fd6b34d48",
   "version": 1
 }

package/dist/web/playground/seed/core/markdown/equipment/bike-erg.json

@@ -5,7 +5,7 @@
   "blockIndex": [],
   "blockEfforts": [],
   "blockEquipment": [],
-  "commit": "5497f334eaeb0230ab730ba472c1e9b598b6a312",
+  "commit": "1a0df570c7ae319006110948811cd714188687e8",
   "uuid": "b724b3cd-e1eb-52aa-a8d9-cf48718b0068",
   "version": 1
 }

package/dist/web/playground/seed/core/markdown/equipment/climbing-rope.json

@@ -5,7 +5,7 @@
   "blockIndex": [],
   "blockEfforts": [],
   "blockEquipment": [],
-  "commit": "5497f334eaeb0230ab730ba472c1e9b598b6a312",
+  "commit": "1a0df570c7ae319006110948811cd714188687e8",
   "uuid": "5ffcaf13-95d6-5efb-84ce-168f60b8bf52",
   "version": 1
 }

package/dist/web/playground/seed/core/markdown/equipment/clubs.json

@@ -5,7 +5,7 @@
   "blockIndex": [],
   "blockEfforts": [],
   "blockEquipment": [],
-  "commit": "5497f334eaeb0230ab730ba472c1e9b598b6a312",
+  "commit": "1a0df570c7ae319006110948811cd714188687e8",
   "uuid": "2a8fcae8-8e2f-5bd1-aa0e-6e0c6e577111",
   "version": 1
 }

package/dist/web/playground/seed/core/markdown/equipment/dumbbell.json

@@ -5,7 +5,7 @@
   "blockIndex": [],
   "blockEfforts": [],
   "blockEquipment": [],
-  "commit": "5497f334eaeb0230ab730ba472c1e9b598b6a312",
+  "commit": "1a0df570c7ae319006110948811cd714188687e8",
   "uuid": "297503ce-a9a0-5fcf-9016-2b5820bd5b25",
   "version": 1
 }

package/dist/web/playground/seed/core/markdown/equipment/ghd.json

@@ -5,7 +5,7 @@
   "blockIndex": [],
   "blockEfforts": [],
   "blockEquipment": [],
-  "commit": "5497f334eaeb0230ab730ba472c1e9b598b6a312",
+  "commit": "1a0df570c7ae319006110948811cd714188687e8",
   "uuid": "7d8d6ef9-22d6-5145-9d63-55f4ed0cd1df",
   "version": 1
 }

package/dist/web/playground/seed/core/markdown/equipment/gymnastic-rings.json

@@ -5,7 +5,7 @@
   "blockIndex": [],
   "blockEfforts": [],
   "blockEquipment": [],
-  "commit": "5497f334eaeb0230ab730ba472c1e9b598b6a312",
+  "commit": "1a0df570c7ae319006110948811cd714188687e8",
   "uuid": "71f9f6d5-fb47-596a-bca2-3c648bb8aad1",
   "version": 1
 }

package/dist/web/playground/seed/core/markdown/equipment/jump-rope.json

@@ -5,7 +5,7 @@
   "blockIndex": [],
   "blockEfforts": [],
   "blockEquipment": [],
-  "commit": "5497f334eaeb0230ab730ba472c1e9b598b6a312",
+  "commit": "1a0df570c7ae319006110948811cd714188687e8",
   "uuid": "f991b73a-f466-59e5-b318-e2362953b635",
   "version": 1
 }

package/dist/web/playground/seed/core/markdown/equipment/kettlebell.json

@@ -5,7 +5,7 @@
   "blockIndex": [],
   "blockEfforts": [],
   "blockEquipment": [],
-  "commit": "5497f334eaeb0230ab730ba472c1e9b598b6a312",
+  "commit": "1a0df570c7ae319006110948811cd714188687e8",
   "uuid": "4a4ab1ea-9510-5a11-b113-764b1d799d2c",
   "version": 1
 }

package/dist/web/playground/seed/core/markdown/equipment/macebell.json

@@ -5,7 +5,7 @@
   "blockIndex": [],
   "blockEfforts": [],
   "blockEquipment": [],
-  "commit": "5497f334eaeb0230ab730ba472c1e9b598b6a312",
+  "commit": "1a0df570c7ae319006110948811cd714188687e8",
   "uuid": "87fb4da5-0bec-58b8-b969-9caf3a991c7e",
   "version": 1
 }

package/dist/web/playground/seed/core/markdown/equipment/medicine-ball.json

@@ -5,7 +5,7 @@
   "blockIndex": [],
   "blockEfforts": [],
   "blockEquipment": [],
-  "commit": "5497f334eaeb0230ab730ba472c1e9b598b6a312",
+  "commit": "1a0df570c7ae319006110948811cd714188687e8",
   "uuid": "3300c680-ceff-5020-8594-272f6d13739e",
   "version": 1
 }

package/dist/web/playground/seed/core/markdown/equipment/parallettes.json

@@ -5,7 +5,7 @@
   "blockIndex": [],
   "blockEfforts": [],
   "blockEquipment": [],
-  "commit": "5497f334eaeb0230ab730ba472c1e9b598b6a312",
+  "commit": "1a0df570c7ae319006110948811cd714188687e8",
   "uuid": "cf1e38ba-2ef4-57e8-ba5e-3e69c2ebfeb4",
   "version": 1
 }

package/dist/web/playground/seed/core/markdown/equipment/plyo-box.json

@@ -5,7 +5,7 @@
   "blockIndex": [],
   "blockEfforts": [],
   "blockEquipment": [],
-  "commit": "5497f334eaeb0230ab730ba472c1e9b598b6a312",
+  "commit": "1a0df570c7ae319006110948811cd714188687e8",
   "uuid": "9c2dcbca-4ece-5198-9a30-54cd5020ec0a",
   "version": 1
 }

package/dist/web/playground/seed/core/markdown/equipment/pull-up-bar.json

@@ -5,7 +5,7 @@
   "blockIndex": [],
   "blockEfforts": [],
   "blockEquipment": [],
-  "commit": "5497f334eaeb0230ab730ba472c1e9b598b6a312",
+  "commit": "1a0df570c7ae319006110948811cd714188687e8",
   "uuid": "9eabd205-7f75-5c5c-af83-a96b2fad8e48",
   "version": 1
 }

package/dist/web/playground/seed/core/markdown/equipment/rower.json

@@ -5,7 +5,7 @@
   "blockIndex": [],
   "blockEfforts": [],
   "blockEquipment": [],
-  "commit": "5497f334eaeb0230ab730ba472c1e9b598b6a312",
+  "commit": "1a0df570c7ae319006110948811cd714188687e8",
   "uuid": "83c1db35-42f3-5fd2-aabc-79450b6326ee",
   "version": 1
 }

package/dist/web/playground/seed/core/markdown/equipment/sandbag.json

@@ -5,7 +5,7 @@
   "blockIndex": [],
   "blockEfforts": [],
   "blockEquipment": [],
-  "commit": "5497f334eaeb0230ab730ba472c1e9b598b6a312",
+  "commit": "1a0df570c7ae319006110948811cd714188687e8",
   "uuid": "37619ae9-d203-5a1c-b7a1-49598febd056",
   "version": 1
 }

package/dist/web/playground/seed/core/markdown/equipment/ski-erg.json

@@ -5,7 +5,7 @@
   "blockIndex": [],
   "blockEfforts": [],
   "blockEquipment": [],
-  "commit": "5497f334eaeb0230ab730ba472c1e9b598b6a312",
+  "commit": "1a0df570c7ae319006110948811cd714188687e8",
   "uuid": "bd36b2b4-30da-516b-9e9a-8084b995d602",
   "version": 1
 }

package/dist/web/playground/seed/core/markdown/equipment/slam-ball.json

@@ -5,7 +5,7 @@
   "blockIndex": [],
   "blockEfforts": [],
   "blockEquipment": [],
-  "commit": "5497f334eaeb0230ab730ba472c1e9b598b6a312",
+  "commit": "1a0df570c7ae319006110948811cd714188687e8",
   "uuid": "52785555-85fd-55bb-b102-8b99648c7a99",
   "version": 1
 }

package/dist/web/playground/seed/core/markdown/equipment/sled.json

@@ -5,7 +5,7 @@
   "blockIndex": [],
   "blockEfforts": [],
   "blockEquipment": [],
-  "commit": "5497f334eaeb0230ab730ba472c1e9b598b6a312",
+  "commit": "1a0df570c7ae319006110948811cd714188687e8",
   "uuid": "fa15a47a-f3d1-59bb-a36d-2081d0c79f3c",
   "version": 1
 }

package/dist/web/playground/seed/core/markdown/equipment/sledgehammer.json

@@ -5,7 +5,7 @@
   "blockIndex": [],
   "blockEfforts": [],
   "blockEquipment": [],
-  "commit": "5497f334eaeb0230ab730ba472c1e9b598b6a312",
+  "commit": "1a0df570c7ae319006110948811cd714188687e8",
   "uuid": "e866df40-1523-56a0-a8d3-b16e3eccd7b6",
   "version": 1
 }

package/dist/web/playground/seed/core/markdown/equipment/weight-vest.json

@@ -5,7 +5,7 @@
   "blockIndex": [],
   "blockEfforts": [],
   "blockEquipment": [],
-  "commit": "5497f334eaeb0230ab730ba472c1e9b598b6a312",
+  "commit": "1a0df570c7ae319006110948811cd714188687e8",
   "uuid": "4684877b-8752-582d-a45c-fff8982e8a0d",
   "version": 1
 }

package/dist/web/playground/seed/core/report.html

@@ -17,28 +17,28 @@
 <h1>Seed build report</h1>
 <h2>Version</h2>
 <dl>
-  <dt>version</dt><dd>1 <code>5497f33-dirty</code> <strong style="color:#b45309">(dirty working tree — not reproducible from <code>5497f334eaeb0230ab730ba472c1e9b598b6a312</code>)</strong></dd>
-  <dt>commit</dt><dd><code>5497f334eaeb0230ab730ba472c1e9b598b6a312</code></dd>
-  <dt>built at</dt><dd>2026-11-11T22:38:18.651Z</dd>
+  <dt>version</dt><dd>1 <code>1a0df57-dirty</code> <strong style="color:#b45309">(dirty working tree — not reproducible from <code>1a0df570c7ae319006110948811cd714188687e8</code>)</strong></dd>
+  <dt>commit</dt><dd><code>1a0df570c7ae319006110948811cd714188687e8</code></dd>
+  <dt>built at</dt><dd>2026-11-12T03:11:24.203Z</dd>
   <dt>schema</dt><dd>v9</dd>
 </dl>
 <h2>Benchmarks</h2>
 <dl>
-  <dt>total</dt><dd>706 ms</dd>
-  <dt>corpus scan + partition</dt><dd>12 ms (278 files)</dd>
-  <dt>block-index derivation</dt><dd>189 ms</dd>
-  <dt>block syntax gate</dt><dd>13 ms</dd>
-  <dt>block-efforts derivation</dt><dd>60 ms</dd>
-  <dt>chunk writes</dt><dd>363 ms</dd>
+  <dt>total</dt><dd>1850 ms</dd>
+  <dt>corpus scan + partition</dt><dd>24 ms (278 files)</dd>
+  <dt>block-index derivation</dt><dd>508 ms</dd>
+  <dt>block syntax gate</dt><dd>24 ms</dd>
+  <dt>block-efforts derivation</dt><dd>116 ms</dd>
+  <dt>chunk writes</dt><dd>1025 ms</dd>
 </dl>
 <h2>Chunks (4, 447 KB total)</h2>
 <table>
 <thead><tr><th>id</th><th>kind</th><th>rows</th><th>size</th><th>sha256</th></tr></thead>
 <tbody>
-<tr><td>canvas</td><td>notes</td><td>88</td><td>303.9 KB</td><td><code>deac64e3</code></td></tr>
-<tr><td>dashboards</td><td>notes</td><td>6</td><td>41.7 KB</td><td><code>08301ab4</code></td></tr>
-<tr><td>efforts</td><td>notes</td><td>161</td><td>86.5 KB</td><td><code>47f650fe</code></td></tr>
-<tr><td>equipment</td><td>notes</td><td>23</td><td>15.2 KB</td><td><code>79146d31</code></td></tr>
+<tr><td>canvas</td><td>notes</td><td>88</td><td>303.9 KB</td><td><code>b0bc465b</code></td></tr>
+<tr><td>dashboards</td><td>notes</td><td>6</td><td>41.7 KB</td><td><code>af9a29e4</code></td></tr>
+<tr><td>efforts</td><td>notes</td><td>161</td><td>86.5 KB</td><td><code>902271f9</code></td></tr>
+<tr><td>equipment</td><td>notes</td><td>23</td><td>15.2 KB</td><td><code>dbdc1af3</code></td></tr>
 </tbody>
 </table>
 </body>

package/dist/web/server/ai-skills/agent-parity.md

@@ -0,0 +1,41 @@
+---
+name: wod-agent-parity
+description: 'Enforce First-Class Agent Readiness & Action Parity whenever adding or modifying WOD Wiki features, routes, UI actions, domain services, or CLI commands across Playground WebMCP, wod server MCP, and the wod CLI.'
+license: MIT
+---
+
+# First-Class Agent Readiness & Action Parity (`wod-agent-parity`)
+
+## Core Mandate
+
+Every user-facing capability in WOD Wiki MUST maintain **Action Parity** between human-driven UI actions and AI-agent-driven actions across all applicable surfaces:
+
+1. **Portable Domain Mutations & Queries (`@bitcobblers/wod-wiki-engine/agent`)**:
+   - Any new domain read or write (Notes, Journal, Notebooks, Sessions, Catalog/Tags, WQL, Feeds, Portability) MUST be defined once as a typed `AgentToolSpec` in `packages/engine/src/agent/tools/` and exported in `packages/engine/src/agent/manifest.ts` (`DOMAIN_AGENT_TOOLS`).
+   - Because `PlaygroundAgentProvider` (`apps/playground/app/agent/PlaygroundAgentProvider.tsx`) and `createWodMcpServer` (`packages/tools/src/mcp/createWodMcpServer.ts`) both consume `DOMAIN_AGENT_TOOLS`, registering a domain tool there automatically exposes it to **Browser WebMCP (`navigator.modelContext`)** and **HTTP/Stdio MCP (`/api/mcp` & `wod mcp`)**.
+   - Wire the matching noun-verb CLI subcommand in `packages/tools/src/cli/agentCommands.ts` and `packages/tools/src/cli/runner.ts` (`--json` + `--server <url>`), and record the exact `cliEquivalent` on the `AgentToolSpec`.
+
+2. **Playground Live UI & Co-Driving Actions (`apps/playground/app/agent/`)**:
+   - Any interactive UI state in `apps/playground` that has no headless equivalent (new routes, view/layout toggles, live editor buffer controls, live workout clock commands, modals/drawers, Cast controls) MUST be exposed to browser agents via `@mcp-b/react-webmcp` (`useWebMCP()`):
+     - **Dynamic Lifecycle**: Register route- or surface-scoped UI tools inside a component that mounts *only* when that UI surface is active (e.g. `StreamAgentTools.tsx`, `EditorAgentTools.tsx`, `LiveClockAgentTools.tsx`) using the zero-dependency bridge in `apps/playground/src/agent/surfaceBridges.ts` so Storybook and the Chromecast receiver bundle (`apps/playground/app/receiver-rpc.tsx`) stay completely free of `@mcp-b/*`.
+     - **Post-Commit Synchronization**: Every UI-mutating WebMCP `execute` handler MUST `await waitForUiCommit()` (`apps/playground/app/agent/uiCommit.ts`) before returning so browser agents never read stale React state.
+     - **Manifest Registration**: Add the schema and `mountScope` entry to `apps/playground/app/agent/uiToolSpecs.ts` (`exportPlaygroundUiToolsManifest()`).
+
+3. **Safety & Risk Tier Discipline**:
+   - **Tier 0 (Read-only)**: Set `tier: 0` and `annotations: { readOnlyHint: true, destructiveHint: false, ... }`. Automatically allowed in `--mcp-readonly` mode.
+   - **Tier 1 (Reversible / Additive)**: Set `tier: 1` and `destructiveHint: false`.
+   - **Tier 2 (Irreversible / Destructive)**: Set `tier: 2` and `destructiveHint: true`, and gate execution with `requireDestructiveConfirmation(ctx, { action, targetId, summary }, args.confirmId)`:
+     - In **Playground WebMCP**, `AgentConfirmHost.tsx` automatically opens the Radix human-in-the-loop confirmation dialog (`data-testid="agent-confirm-dialog"`).
+     - In **CLI**, omitting `--yes <targetId>` automatically exits with code `4` (`CONFIRMATION_REQUIRED`).
+     - In **MCP**, omitting `confirmId` returns a structured confirmation error prompting explicit confirmation.
+
+4. **Deterministic DOM, URL State & Accessibility (Playground Layers 2–4)**:
+   - **Semantic Controls**: Interactive elements MUST be real `<button type="button">` / `<a>` / labeled `<input>` controls (never click-only `<div>`/`<span>` without `role`, `tabIndex`, and `Enter`/`Space` keyboard handlers) and carry `TEST_IDS` (`apps/playground/src/lib/testIds.ts`).
+   - **Loading & View State**: Async routes and streams MUST signal busy transitions via `setSurfaceBusy(loading)` (`apps/playground/src/agent/surfaceBridges.ts`) so `<main data-agent-status="loading|ready" aria-busy>` and `<script id="agent-view-state" type="application/json">` (`apps/playground/app/agent/AgentStateScript.tsx`) stay accurate.
+   - **URL Survival**: New routes go in `apps/playground/src/lib/routes.ts` (`ROUTE_PATTERNS`); meaningful view modes (e.g. `?layout=`, `?q=`, `?note=`) should survive page reload via URL search params.
+   - **Regenerate Discovery Files**: Whenever tools or routes change, run:
+     ```bash
+     bun run sync:agent-manifest
+     bun run sync:skills
+     bun run check:agent-parity
+     ```

package/dist/web/server/ai-skills/cli.md

@@ -0,0 +1,127 @@
+---
+name: wod-cli
+description: 'Drive WOD Wiki locally or against a running wod server using the wod CLI (--json), wod mcp (stdio), or /api/mcp (HTTP). Covers notes, journal scheduling, notebooks, headless workout sessions, WQL queries, catalog management, and exit code 4 confirmation gates.'
+license: MIT
+---
+
+# WOD CLI & MCP Agent Guide (`wod`)
+
+## Overview
+
+The `wod` CLI exposes every WOD Wiki domain capability with structured `--json` output, deterministic exit codes, and 1:1 parity with the `wod mcp` stdio server and `/api/mcp` HTTP MCP endpoint.
+
+## Quick Diagnostics
+
+```bash
+wod doctor --json
+wod tools list --json
+```
+
+If the local SQLite database is not initialized yet:
+```bash
+wod init --db ./wodwiki.db
+```
+
+To target a running `wod server` instance instead of a local database file, pass `--server <url>` to any noun-verb command:
+```bash
+wod note list --server http://127.0.0.1:3000 --json
+```
+
+---
+
+## Core Workflows
+
+### 1. Parse & Verify Whiteboard Script (Dry Run)
+Always validate authored workout syntax before saving when drafting from unstructured text:
+```bash
+printf "(21-15-9)\n  Thrusters @95lb\n  Pull-ups\n" | wod parse - --no-save --json
+```
+
+### 2. Author, Read, Clone, and Delete Notes
+```bash
+# List notes (optional filters: --notebook, --tag, --search, --limit)
+wod note list --limit 20 --json
+
+# Create a note from inline Markdown or stdin
+wod note create --title "Fran" --tags "benchmark,girl" --markdown $'# Fran\n\n```time\n(21-15-9)\n  Thrusters @95lb\n  Pull-ups\n```' --json
+
+# Read full note Markdown, blocks, and recent sessions
+wod note get <noteId> --json
+
+# Clone a template note onto a calendar date
+wod note clone <sourceNoteId> --date 2026-11-11 --notebook journal --json
+
+# Delete a note (Tier 2 — requires --yes <noteId>, exits 4 if omitted)
+wod note delete <noteId> --yes <noteId> --json
+```
+
+### 3. Schedule & Inspect the Daily Journal
+```bash
+# Read scheduled workouts + logged sessions for a date (YYYY-MM-DD or today)
+wod journal day today --json
+
+# Schedule a new workout or clone a template onto a date
+wod journal add today --source-note <templateNoteId> --json
+wod journal add 2026-11-12 --title "Morning 5K" --markdown $'```time\n5000m Run :?\n```' --json
+```
+
+### 4. Manage Notebooks
+```bash
+wod notebook list --json
+wod notebook save strength-cycle --title "Strength Cycle" --description "8-week squat block" --json
+wod notebook delete strength-cycle --yes strength-cycle --json
+```
+
+### 5. Execute Headless Sessions & Inspect Ledgers
+```bash
+# Run a saved note's workout block headlessly and record session + events
+wod session run --note <noteId> --json
+# Equivalent shorthand on legacy verb:
+wod run --note <noteId> --json
+
+# List and inspect recorded sessions
+wod session list --limit 10 --json
+wod session get <sessionId> --json
+
+# Delete a recorded session (Tier 2 — requires --yes <sessionId>)
+wod session delete <sessionId> --yes <sessionId> --json
+```
+
+### 6. Catalog & Tag Management
+```bash
+wod catalog lookup effort --search thruster --json
+wod catalog upsert effort "Dumbbell Snatch" --category weightlifting --tags dumbbell --json
+wod tag list --type equipment --json
+wod tag upsert kettlebell --type equipment --json
+```
+
+### 7. Feeds & Portability
+```bash
+wod feed list --json
+wod feed status --json
+wod export note <noteId> -o -
+```
+
+---
+
+## Exit Codes & Confirmation Safety
+
+| Exit Code | Meaning | Agent Recovery Action |
+|---|---|---|
+| `0` | Success | Parse JSON stdout (`{ "ok": true, "tool": "...", "data": ... }`). |
+| `1` | Runtime / IO / Missing Target | Inspect `error` field and verify IDs via `list` / `lookup`. |
+| `2` | Syntax Error (Whiteboard Script or WQL) | Fix script or query syntax using `wod parse --no-save` or `wod query --validate-only`. |
+| `3` | Language Pack Load Error | Check `--pack` module specifier. |
+| `4` | Tier 2 Confirmation Required | Destructive command lacked `--yes <targetId>`. Confirm intent with the user before re-running with `--yes <targetId>`. |
+
+---
+
+## Starting the Official MCP Server
+
+- **Stdio (Claude Code / Cursor / Codex)**:
+  ```bash
+  wod mcp --db ./wodwiki.db
+  wod mcp --readonly --db ./wodwiki.db
+  ```
+- **HTTP Streamable MCP**:
+  `wod server` automatically mounts `/api/mcp` (`POST`, `GET`, `DELETE`) and `/.well-known/agent-capabilities.json`. Set `WOD_MCP_READONLY=1` or `--mcp-readonly` to expose only Tier 0 read-only tools, and `WOD_MCP_TOKEN=<secret>` to require `Authorization: Bearer <secret>`.

package/dist/web/server/ai-skills/wql.md

@@ -0,0 +1,63 @@
+---
+name: wod-wql
+description: 'Write, validate, and execute WQL (Workout Query Language) find and aggregate queries against WOD Wiki notes, workout blocks, sessions, efforts, tags, and time windows.'
+license: MIT
+---
+
+# WQL (Workout Query Language) Agent Guide
+
+## Overview
+
+WQL queries structured workout notes, immutable block revisions, movement efforts, tags, and recorded execution sessions across all three WOD Wiki surfaces:
+- **CLI**: `wod query '<wql>' --format json` (dry-run syntax check: `wod query '<wql>' --validate-only --json`)
+- **MCP / WebMCP**: `wod_query_wql` and `wod_validate_wql`
+- **Browser Stream Views**: `ui_set_stream_query`
+
+---
+
+## Query Families
+
+### 1. Find Queries (`:<target>{...}`)
+Select entities matching structured filters:
+
+| Target | Purpose | Example |
+|---|---|---|
+| `:note` | Workout & journal notes | `:note{notebook:journal time:14d}` |
+| `:block` | Individual `time` / `log` workout blocks | `:block{effort:thrusters}` |
+| `:session` | Completed or logged workout sessions | `:session{time:30d}` |
+| `:effort` | Canonical movement / exercise definitions | `:effort{discipline:weightlifting}` |
+| `:notebook` | Local and subscribed notebooks | `:notebook{}` |
+| `:tag` | Tags across categories | `:tag{}` |
+| `:equipment` | Equipment definitions & tags | `:equipment{}` |
+
+Common filters inside `{...}`:
+- `notebook:<slug>` — filter notes in a notebook (`journal`, `benchmarks`, etc.)
+- `tags:<slug>` — filter by tag
+- `effort:<slug>` — filter notes/blocks/sessions involving a movement
+- `time:<window>` — relative time window (`7d`, `14d`, `30d`, `90d`, `1y`) or ISO date range
+
+### 2. Aggregate Queries (`:<agg>{...} [by {<dim>}]`)
+Roll up recorded workout metrics over time or movement dimensions:
+
+- **Aggregators**: `:sum`, `:count`, `:max`, `:min`, `:avg`
+- **Metric families**: `metric:reps`, `metric:weight`, `metric:distance`, `metric:time`, `metric:rounds`, `metric:volume`
+- **Grouping dimensions (`by {...}`)**: `day`, `week`, `month`, `effort`, `notebook`
+
+Examples:
+```wql
+:sum{metric:reps time:30d} by {week}
+:sum{metric:reps effort:pull-ups time:90d} by {week}
+:max{metric:weight effort:back-squat time:1y}
+:count{metric:rounds time:30d} by {effort}
+```
+
+---
+
+## Best Practices for Agents
+
+1. **Validate Before Running Unfamiliar Filters**:
+   Call `wod_validate_wql` (or `wod query '<wql>' --validate-only --json`) to inspect parsed AST and catch unknown filter keys (exit code `2` on invalid WQL).
+2. **Read Live Capabilities**:
+   Read MCP resource `wod://schema/wql` for the exact list of valid filter keys per target, aggregators, and virtual dimensions compiled into the current engine version.
+3. **Prefer Unbatched Data Tools Over UI Scraping**:
+   In the browser, `wod_query_wql` queries IndexedDB / `ApiStorage` directly without UI pagination limits, whereas `ui_set_stream_query` updates the visible stream for the human user.