@bitcobblers/wod-wiki-tools 0.43.2153 → 0.44.2156

package/dist/web/playground/seed/core/markdown/canvas/guide/structure.json

@@ -0,0 +1,335 @@
+{
+  "path": "markdown/canvas/guide/structure.md",
+  "content": "---\nsearch: hidden\ntemplate: canvas\nroute: /guide/structure\ntype: guide\ntitle: \"Structure & Rounds\"\ndescription: \"Rounds, sets, ladders, and rep schemes — indentation is the nesting mechanism, one thing per line.\"\n---\n\n```chapter\nid: structure\ntitle: Structure & Rounds\nbadge: blocks\nquests: structure-run, structure-rounds, structure-repscheme\nsections: []\n```\n\n```quest\nid: structure-run\nlabel: Run the First Example\nvalidation:\n  type: run-started\n```\n\n```quest\nid: structure-rounds\nlabel: Wrap movements in 2+ rounds\nvalidation:\n  type: min-rounds\n  count: 2\n```\n\n```quest\nid: structure-repscheme\nlabel: Write a rep scheme\nvalidation:\n  type: contains-token\n  value: 21-15-9\n```\n\n# Structure & Rounds {sticky dark full-bleed}\n\nA header in parentheses creates a **round behavior** that owns every indented line beneath it. Ownership is indentation; the runtime tracks which round you're in and advances automatically.\n\n```view\nname:    preview\nstate:   note\nsource:  wods/examples/syntax/groups-1.md\nruntime: in-memory\nlaunch:  host\nalign:   right\nwidth:   50%\n```\n\n## Rounds {#rounds}\n\n```time\n(3)\n  10 Pushups\n  15 Air Squats\n```\n\n`(3)`, `(3 Rounds)`, `(3 Rds)` — the label is optional. The clock executes pushups, air squats, then repeats until three rounds are done, showing the current round throughout.\n\n## Rep schemes {#rep-schemes}\n\n```button\nlabel:  Try it: Rep schemes\ntarget: preview\npipeline:\n  - set-source: wods/examples/syntax/groups-2.md\n```\n\nA dash-separated list creates one round per value, and **every movement in the block inherits the current round's value**:\n\n```time\n(21-15-9) Thruster / Pull-up\n```\n\nRound 1: 21 thrusters and 21 pull-ups. Round 2: 15 of each. Round 3: 9. Ladders like `(10-8-6-4-2)` work the same way. The slash between movements is choice notation — do the movements in either order (or alternate) each round.\n\n## Sets {#sets}\n\n```button\nlabel:  Try it: Sets\ntarget: preview\npipeline:\n  - set-source: wods/examples/syntax/multiple-sets.md\n```\n\n`(5 Sets)` repeats a block five times with equal reps per set — usually with rest inside:\n\n```time\n(5 Sets)\n  3 Back Squat 225lb\n  *2:00 Rest\n```\n\n## Nesting {#nesting}\n\n```button\nlabel:  Try it: Nesting\ntarget: preview\npipeline:\n  - set-source: wods/examples/syntax/groups-3.md\n```\n\nRounds nest inside rounds — supersets, alternating blocks, complex sessions:\n\n```time\n(5)\n  (3)\n    5 Deadlift\n    10 Pushups\n```\n\nFive outer rounds, each containing three inner sets: 5 × 3 × 5 = 75 deadlifts. The clock counts both levels and shows where you are.\n\n### Rep math {#rep-math}\n\nThe compiler derives totals — nothing is guessed or manually logged:\n\n| Structure | Math |\n|---|---|\n| `(3 Rounds) 10 Burpees` | 10 × 3 = 30 burpees |\n| `(21-15-9) Thruster` | 21 + 15 + 9 = 45 thrusters |\n| `(5) (3) 5 Deadlift` | 5 × 3 × 5 = 75 deadlifts |\n\nThese planned totals feed the review grid, and — combined with what the clock records — become the [recorded facts](/guide/metrics?h=planned-vs-recorded) that WQL aggregates.\n\n## Named sections {#named-sections}\n\n```button\nlabel:  Try it: Named sections\ntarget: preview\npipeline:\n  - set-source: wods/examples/syntax/named-groups.md\n```\n\nTwo legal ways to label a section of a session:\n\n- **`(Warmup)`** — a parenthesized label creates a named group node. Without a number it does not repeat; it organizes.\n- **`// Warmup`** — a comment line. Pure text: no group node, but it labels sections in every shipped session example.\n\n```time\n// Warmup\n  400m Run\n  10 Air Squats\n\n// Strength\n  (5 Sets)\n    3 Back Squat 225lb\n    *2:00 Rest\n\n// Conditioning\n  10:00 AMRAP\n    5 Pullups\n    10 Pushups\n\n// Cool-down\n  5:00 Walk\n```\n\nChain named groups to describe a full training session in one note; sections run sequentially and don't need to repeat to be useful. Use `(Label)` when you want a first-class group the runtime knows about; use `// Label` for pure organization. Full sessions like this one are [composed in the last chapter](/guide/sessions?h=full-session).\n\n## Try it {#try-it}\n\n```button\nlabel:  Try it: Full session\ntarget: preview\npipeline:\n  - set-source: wods/examples/syntax/complex-full-session.md\n```\n\n**Run** — run the four-section session above: each named section plays in order, the `(5 Sets)` block tracks set count and enforces required rest, and the AMRAP window counts its own rounds. **Observe** — the review grid at the end shows per-section and per-round splits. Runs save under the shared run contract, same as every chapter.\n\n```button\nlabel:  Run\ntarget: preview\nopen:   view\npipeline:\n  - set-state: track\n```\n\n",
+  "blocks": {
+    "seed:markdown/canvas/guide/structure.md:0": {
+      "id": "seed:markdown/canvas/guide/structure.md:0",
+      "kind": "wod",
+      "from": 1090,
+      "to": 1134,
+      "sourceRevision": 1,
+      "version": 1,
+      "dialect": "time"
+    },
+    "seed:markdown/canvas/guide/structure.md:1": {
+      "id": "seed:markdown/canvas/guide/structure.md:1",
+      "kind": "wod",
+      "from": 1586,
+      "to": 1626,
+      "sourceRevision": 1,
+      "version": 1,
+      "dialect": "time"
+    },
+    "seed:markdown/canvas/guide/structure.md:2": {
+      "id": "seed:markdown/canvas/guide/structure.md:2",
+      "kind": "wod",
+      "from": 2081,
+      "to": 2135,
+      "sourceRevision": 1,
+      "version": 1,
+      "dialect": "time"
+    },
+    "seed:markdown/canvas/guide/structure.md:3": {
+      "id": "seed:markdown/canvas/guide/structure.md:3",
+      "kind": "wod",
+      "from": 2352,
+      "to": 2403,
+      "sourceRevision": 1,
+      "version": 1,
+      "dialect": "time"
+    },
+    "seed:markdown/canvas/guide/structure.md:4": {
+      "id": "seed:markdown/canvas/guide/structure.md:4",
+      "kind": "wod",
+      "from": 3450,
+      "to": 3646,
+      "sourceRevision": 1,
+      "version": 1,
+      "dialect": "time"
+    }
+  },
+  "blockIndex": [
+    {
+      "id": "guide/structure:seed:markdown/canvas/guide/structure.md:0",
+      "noteId": "guide/structure",
+      "blockId": "seed:markdown/canvas/guide/structure.md:0",
+      "blockVersion": 1,
+      "sourceRevision": 1,
+      "from": 1090,
+      "to": 1134,
+      "position": 0,
+      "dataType": "wod",
+      "blockContentId": "bc-36c6b543",
+      "rawContent": "```time\n(3)\n  10 Pushups\n  15 Air Squats\n```",
+      "noteTitle": "Structure",
+      "createdAt": 1792874940000,
+      "isStatic": true,
+      "sourceId": "guides:guide/structure",
+      "sourcePath": "markdown/canvas/guide/structure.md",
+      "routeId": "guide/structure"
+    },
+    {
+      "id": "guide/structure:seed:markdown/canvas/guide/structure.md:1",
+      "noteId": "guide/structure",
+      "blockId": "seed:markdown/canvas/guide/structure.md:1",
+      "blockVersion": 1,
+      "sourceRevision": 1,
+      "from": 1586,
+      "to": 1626,
+      "position": 1,
+      "dataType": "wod",
+      "blockContentId": "bc-f3e49f1b",
+      "rawContent": "```time\n(21-15-9) Thruster / Pull-up\n```",
+      "noteTitle": "Structure",
+      "createdAt": 1792874940000,
+      "isStatic": true,
+      "sourceId": "guides:guide/structure",
+      "sourcePath": "markdown/canvas/guide/structure.md",
+      "routeId": "guide/structure"
+    },
+    {
+      "id": "guide/structure:seed:markdown/canvas/guide/structure.md:2",
+      "noteId": "guide/structure",
+      "blockId": "seed:markdown/canvas/guide/structure.md:2",
+      "blockVersion": 1,
+      "sourceRevision": 1,
+      "from": 2081,
+      "to": 2135,
+      "position": 2,
+      "dataType": "wod",
+      "blockContentId": "bc-aedf8ee3",
+      "rawContent": "```time\n(5 Sets)\n  3 Back Squat 225lb\n  *2:00 Rest\n```",
+      "noteTitle": "Structure",
+      "createdAt": 1792874940000,
+      "isStatic": true,
+      "sourceId": "guides:guide/structure",
+      "sourcePath": "markdown/canvas/guide/structure.md",
+      "routeId": "guide/structure"
+    },
+    {
+      "id": "guide/structure:seed:markdown/canvas/guide/structure.md:3",
+      "noteId": "guide/structure",
+      "blockId": "seed:markdown/canvas/guide/structure.md:3",
+      "blockVersion": 1,
+      "sourceRevision": 1,
+      "from": 2352,
+      "to": 2403,
+      "position": 3,
+      "dataType": "wod",
+      "blockContentId": "bc-9bba73a2",
+      "rawContent": "```time\n(5)\n  (3)\n    5 Deadlift\n    10 Pushups\n```",
+      "noteTitle": "Structure",
+      "createdAt": 1792874940000,
+      "isStatic": true,
+      "sourceId": "guides:guide/structure",
+      "sourcePath": "markdown/canvas/guide/structure.md",
+      "routeId": "guide/structure"
+    },
+    {
+      "id": "guide/structure:seed:markdown/canvas/guide/structure.md:4",
+      "noteId": "guide/structure",
+      "blockId": "seed:markdown/canvas/guide/structure.md:4",
+      "blockVersion": 1,
+      "sourceRevision": 1,
+      "from": 3450,
+      "to": 3646,
+      "position": 4,
+      "dataType": "wod",
+      "blockContentId": "bc-28a484de",
+      "rawContent": "```time\n// Warmup\n  400m Run\n  10 Air Squats\n\n// Strength\n  (5 Sets)\n    3 Back Squat 225lb\n    *2:00 Rest\n\n// Conditioning\n  10:00 AMRAP\n    5 Pullups\n    10 Pushups\n\n// Cool-down\n  5:00 Walk\n```",
+      "noteTitle": "Structure",
+      "createdAt": 1792874940000,
+      "isStatic": true,
+      "sourceId": "guides:guide/structure",
+      "sourcePath": "markdown/canvas/guide/structure.md",
+      "routeId": "guide/structure"
+    }
+  ],
+  "blockEfforts": [
+    {
+      "id": "guide/structure:seed:markdown/canvas/guide/structure.md:0:push-up",
+      "noteId": "guide/structure",
+      "blockId": "seed:markdown/canvas/guide/structure.md:0",
+      "blockContentId": "bc-36c6b543",
+      "effortSlug": "push-up",
+      "isStatic": true,
+      "sourcePath": "markdown/canvas/guide/structure.md",
+      "createdAt": 1792874940000
+    },
+    {
+      "id": "guide/structure:seed:markdown/canvas/guide/structure.md:0:air-squat",
+      "noteId": "guide/structure",
+      "blockId": "seed:markdown/canvas/guide/structure.md:0",
+      "blockContentId": "bc-36c6b543",
+      "effortSlug": "air-squat",
+      "isStatic": true,
+      "sourcePath": "markdown/canvas/guide/structure.md",
+      "createdAt": 1792874940000
+    },
+    {
+      "id": "guide/structure:seed:markdown/canvas/guide/structure.md:1:thruster",
+      "noteId": "guide/structure",
+      "blockId": "seed:markdown/canvas/guide/structure.md:1",
+      "blockContentId": "bc-f3e49f1b",
+      "effortSlug": "thruster",
+      "isStatic": true,
+      "sourcePath": "markdown/canvas/guide/structure.md",
+      "createdAt": 1792874940000
+    },
+    {
+      "id": "guide/structure:seed:markdown/canvas/guide/structure.md:1:pull-up",
+      "noteId": "guide/structure",
+      "blockId": "seed:markdown/canvas/guide/structure.md:1",
+      "blockContentId": "bc-f3e49f1b",
+      "effortSlug": "pull-up",
+      "isStatic": true,
+      "sourcePath": "markdown/canvas/guide/structure.md",
+      "createdAt": 1792874940000
+    },
+    {
+      "id": "guide/structure:seed:markdown/canvas/guide/structure.md:2:back-squat",
+      "noteId": "guide/structure",
+      "blockId": "seed:markdown/canvas/guide/structure.md:2",
+      "blockContentId": "bc-aedf8ee3",
+      "effortSlug": "back-squat",
+      "isStatic": true,
+      "sourcePath": "markdown/canvas/guide/structure.md",
+      "createdAt": 1792874940000
+    },
+    {
+      "id": "guide/structure:seed:markdown/canvas/guide/structure.md:3:deadlift",
+      "noteId": "guide/structure",
+      "blockId": "seed:markdown/canvas/guide/structure.md:3",
+      "blockContentId": "bc-9bba73a2",
+      "effortSlug": "deadlift",
+      "isStatic": true,
+      "sourcePath": "markdown/canvas/guide/structure.md",
+      "createdAt": 1792874940000
+    },
+    {
+      "id": "guide/structure:seed:markdown/canvas/guide/structure.md:3:push-up",
+      "noteId": "guide/structure",
+      "blockId": "seed:markdown/canvas/guide/structure.md:3",
+      "blockContentId": "bc-9bba73a2",
+      "effortSlug": "push-up",
+      "isStatic": true,
+      "sourcePath": "markdown/canvas/guide/structure.md",
+      "createdAt": 1792874940000
+    },
+    {
+      "id": "guide/structure:seed:markdown/canvas/guide/structure.md:4:air-squat",
+      "noteId": "guide/structure",
+      "blockId": "seed:markdown/canvas/guide/structure.md:4",
+      "blockContentId": "bc-28a484de",
+      "effortSlug": "air-squat",
+      "isStatic": true,
+      "sourcePath": "markdown/canvas/guide/structure.md",
+      "createdAt": 1792874940000
+    },
+    {
+      "id": "guide/structure:seed:markdown/canvas/guide/structure.md:4:back-squat",
+      "noteId": "guide/structure",
+      "blockId": "seed:markdown/canvas/guide/structure.md:4",
+      "blockContentId": "bc-28a484de",
+      "effortSlug": "back-squat",
+      "isStatic": true,
+      "sourcePath": "markdown/canvas/guide/structure.md",
+      "createdAt": 1792874940000
+    },
+    {
+      "id": "guide/structure:seed:markdown/canvas/guide/structure.md:4:pull-up",
+      "noteId": "guide/structure",
+      "blockId": "seed:markdown/canvas/guide/structure.md:4",
+      "blockContentId": "bc-28a484de",
+      "effortSlug": "pull-up",
+      "isStatic": true,
+      "sourcePath": "markdown/canvas/guide/structure.md",
+      "createdAt": 1792874940000
+    },
+    {
+      "id": "guide/structure:seed:markdown/canvas/guide/structure.md:4:push-up",
+      "noteId": "guide/structure",
+      "blockId": "seed:markdown/canvas/guide/structure.md:4",
+      "blockContentId": "bc-28a484de",
+      "effortSlug": "push-up",
+      "isStatic": true,
+      "sourcePath": "markdown/canvas/guide/structure.md",
+      "createdAt": 1792874940000
+    },
+    {
+      "id": "guide/structure:seed:markdown/canvas/guide/structure.md:4:walking-3-mph",
+      "noteId": "guide/structure",
+      "blockId": "seed:markdown/canvas/guide/structure.md:4",
+      "blockContentId": "bc-28a484de",
+      "effortSlug": "walking-3-mph",
+      "isStatic": true,
+      "sourcePath": "markdown/canvas/guide/structure.md",
+      "createdAt": 1792874940000
+    }
+  ],
+  "blockEquipment": [
+    {
+      "id": "guide/structure:seed:markdown/canvas/guide/structure.md:1:barbell",
+      "noteId": "guide/structure",
+      "blockId": "seed:markdown/canvas/guide/structure.md:1",
+      "blockContentId": "bc-f3e49f1b",
+      "equipmentSlug": "barbell",
+      "isStatic": true,
+      "sourcePath": "markdown/canvas/guide/structure.md",
+      "createdAt": 1792874940000
+    },
+    {
+      "id": "guide/structure:seed:markdown/canvas/guide/structure.md:1:pull-up-bar",
+      "noteId": "guide/structure",
+      "blockId": "seed:markdown/canvas/guide/structure.md:1",
+      "blockContentId": "bc-f3e49f1b",
+      "equipmentSlug": "pull-up-bar",
+      "isStatic": true,
+      "sourcePath": "markdown/canvas/guide/structure.md",
+      "createdAt": 1792874940000
+    },
+    {
+      "id": "guide/structure:seed:markdown/canvas/guide/structure.md:2:barbell",
+      "noteId": "guide/structure",
+      "blockId": "seed:markdown/canvas/guide/structure.md:2",
+      "blockContentId": "bc-aedf8ee3",
+      "equipmentSlug": "barbell",
+      "isStatic": true,
+      "sourcePath": "markdown/canvas/guide/structure.md",
+      "createdAt": 1792874940000
+    },
+    {
+      "id": "guide/structure:seed:markdown/canvas/guide/structure.md:3:barbell",
+      "noteId": "guide/structure",
+      "blockId": "seed:markdown/canvas/guide/structure.md:3",
+      "blockContentId": "bc-9bba73a2",
+      "equipmentSlug": "barbell",
+      "isStatic": true,
+      "sourcePath": "markdown/canvas/guide/structure.md",
+      "createdAt": 1792874940000
+    },
+    {
+      "id": "guide/structure:seed:markdown/canvas/guide/structure.md:4:barbell",
+      "noteId": "guide/structure",
+      "blockId": "seed:markdown/canvas/guide/structure.md:4",
+      "blockContentId": "bc-28a484de",
+      "equipmentSlug": "barbell",
+      "isStatic": true,
+      "sourcePath": "markdown/canvas/guide/structure.md",
+      "createdAt": 1792874940000
+    },
+    {
+      "id": "guide/structure:seed:markdown/canvas/guide/structure.md:4:pull-up-bar",
+      "noteId": "guide/structure",
+      "blockId": "seed:markdown/canvas/guide/structure.md:4",
+      "blockContentId": "bc-28a484de",
+      "equipmentSlug": "pull-up-bar",
+      "isStatic": true,
+      "sourcePath": "markdown/canvas/guide/structure.md",
+      "createdAt": 1792874940000
+    }
+  ],
+  "commit": "35e3c00d1c6fd092d35f4368f5d70ab6b98bc576",
+  "uuid": "35ed19b0-db3f-57bd-bb40-159337c801d0",
+  "version": 1
+}

package/dist/web/playground/seed/core/markdown/canvas/guide/wql.json

@@ -0,0 +1,117 @@
+{
+  "path": "markdown/canvas/guide/wql.md",
+  "content": "---\nsearch: hidden\ntemplate: canvas\nroute: /guide/wql\ntype: guide\ntitle: \"Query Your Training (WQL)\"\ndescription: \"The workout query language — aggregates, filters, rollups, and pipes to shape your training data.\"\n---\n\n# Query Your Training (WQL) {sticky dark full-bleed}\n\nWQL (Wod Query Language) queries your journal across two planes: numeric **facts** the clock recorded, and the markdown **content** those facts came from. The panel on the right is a live query sandbox: the ```query block renders real results, and editing the query line re-runs it as you type — switch presets with the tabs as each section loads them.\n\n```view\nname:    sandbox\nstate:   note\nsource:  wql-presets/aggregate-by-week.md\nruntime: in-memory\nlaunch:  host\nalign:   right\nwidth:   50%\n```\n\n```query\nsum:totalVolume{discipline:strength} by {week} last 6w\n```\n\nThree surfaces use the same language: the **Library** (zero-syntax tri-state browsing), the **Explorer** (`/dashboards` workbench), and **in-note ```query blocks** — the one this chapter focuses on, which [dashboards](/guide/dashboards) compose.\n\n## The two planes {#planes}\n\n| Plane | Shape | Searches | Example |\n|---|---|---|---|\n| **Metrics** | `agg:metric{filters} by {dim}` | the fact store | `sum:totalVolume{} by {week}` |\n| **Content** | `:target{filters,notebook:slug}` | notes, notebooks, blocks, efforts | `:note{effort:fran,notebook:journal} last 8w` |\n\n## Aggregate queries {#aggregate}\n\n```button\nlabel:  Try it: Weekly volume\ntarget: sandbox\npipeline:\n  - set-source: wql-presets/aggregate-by-week.md\n```\n\n```button\nlabel:  Try it: By effort\ntarget: sandbox\npipeline:\n  - set-source: wql-presets/aggregate-by-effort.md\n```\n\n```button\nlabel:  Try it: TIS trend\ntarget: sandbox\npipeline:\n  - set-source: wql-presets/tis-trend.md\n```\n\n```\n<aggregator>:<metric>{<filters>} by {<dimension>} last <window>\n```\n\n**Aggregators** — `sum`, `avg`, `min`, `max`, `count`, `last` (most recent value), `delta` (change across the window).\n\n**Metrics** — two tiers of stored facts, plus everything calculated:\n\n- Tier-2 aggregates: `totalVolume`, `totalReps`, `totalDistance`, `tis`, `sessionLoad`\n- Metric families: `reps`, `distance`, `resistance`, `elapsed`, `power`, `pace`\n- Calculated: the [`calc.*` list](/guide/metrics?h=calculated) (`calc.acwr`, `calc.e1rm`, `calc.readiness`, …)\n\n`avg:session-rpe{}` works too — [captured metrics](/guide/metrics?h=session-rpe) are facts like any other.\n\n```button\nlabel:  Try it: Session RPE\ntarget: sandbox\npipeline:\n  - set-source: wql-presets/session-rpe.md\n```\n\n**Dimensions** — time buckets `day`, `week`, `session`, `round`; metadata `effort`, `discipline`, `intensity`, `grade`; and any [custom property you authored](/guide/metrics?h=custom-metrics) (`by {coach}`).\n\n### Filters {#filters}\n\n```button\nlabel:  Try it: Filter combos\ntarget: sandbox\npipeline:\n  - set-source: wql-presets/filter-combos.md\n```\n\nInside the braces:\n\n| Filter | Meaning |\n|---|---|\n| `{effort:thruster}` | exact match |\n| `{!discipline:recovery}` | negation — exclude |\n| `{discipline:strength\\|gymnastics}` | OR |\n| `{text:fran}` | substring (content plane) |\n| `{intensity:high}` | intensity tier — one of `low`, `moderate`, `high` |\n| `{tags:benchmark}` | note tags |\n| `{notebook:crossfit-girls}` | notebook (`notebook/{slug}` or bare slug) |\n| `{coach:greg}` | your custom property |\n\n### Notebooks &amp; sources {#sources}\n\n```button\nlabel:  Try it: notebook:journal\ntarget: sandbox\npipeline:\n  - set-source: wql-presets/source-journal.md\n```\n\nEvery note belongs to a canonical `notebook/{slug}` container — including the built-in defaults `notebook/journal`, `notebook/playground`, and `notebook/guides`, user-created notebooks, and seed-delivered notebooks (such as `notebook/crossfit-girls`).\n\nFilter by notebook with `notebook:<slug>` (or `notebook:notebook/<slug>`), or by storage scope with `source:`:\n\n`journal` (your journal notes) · `feeds` / `notebooks` (notebook notes) · `guides` · `playground` (plus `dashboards`, `efforts`, `equipment`)\n\nOmitting `source:` and `notebook:` searches **all** notes — there is no `source:all` (the parser refuses it). Pin one notebook with `notebook:crossfit-girls` (or legacy `catalog:crossfit-girls`).\n\nJournal scope includes user-created clones whose `sourceId` points to the original note UUID or legacy `journal/YYYY-MM-DD` ID. Only user-created notes (`seedOrigin !== 'seed'`) are editable; seed-delivered notebook notes are read-only and can be cloned into your writable notebooks.\n\n### Windows {#windows}\n\nOne per query, at the end: relative — `last 7d`, `last 6w`, `last 12w` — or absolute — `from 2026-01-01 to 2026-03-31` (both dates included; drop `to …` to stay open). There is no `since:` keyword.\n\n### Grouping & rollups {#grouping-rollup}\n\n`by {week}` buckets; multiple dimensions group hierarchically — `by {intensity, week}`. Smooth weekly series with `.rollup(2w)` or `.rollup(4w)` (any multi-day/multi-week period; `.rollup(1w)` is refused — use `by {week}`).\n\n### Where joins {#joins}\n\n```button\nlabel:  Try it: Where join\ntarget: sandbox\npipeline:\n  - set-source: wql-presets/where-join.md\n```\n\nContent queries can require a numeric threshold computed over each result's linked workouts:\n\n```query\n:note{tags:pr,notebook:journal} last 8w where sum:totalVolume{} > 5000\n```\n\nKeep only journal notes tagged `pr` whose total volume exceeds 5,000 kg. Joins are supported on `:note` and `:block`; other targets report an advisory and ignore the clause. Joins lean on the **Block Content Id** — a content hash of each workout block, stable across reorders and preserved when you clone a catalog benchmark into your journal, so history aggregates across every note where that workout lives.\n\n## Content queries {#content}\n\n```button\nlabel:  Try it: fran\ntarget: sandbox\npipeline:\n  - set-source: wql-presets/content-fran.md\n```\n\n```query\n:block{text:fran,source:notebooks}\n```\n\nTargets: `:note` / `:notes` (whole notes), `:notebook` / `:notebooks` (notebooks), `:block` (addressable fenced blocks), `:effort` (registry entries, filterable by `effort`, `discipline`, `intensity`, `origin`, `text`), plus the advanced `:session`, `:segment`, `:event` for recorded results and raw rows. Content-only keys (`type`, `text`, `has`, `source`, `catalog`, `notebook`) are category errors on aggregates.\n\nThe search palette's FIND mode matches note titles and bodies within its selected scope and time window. Type plain text or a quoted phrase such as `\"workout in the park\"`; clearing the text restores the scope. WQL mode retains diagnostics for malformed queries. Freeform CONTAINS rows have no count badge; the results total reports matches.\n\n### Presentation pipes {#pipes}\n\n```button\nlabel:  Try it: limit 5\ntarget: sandbox\npipeline:\n  - set-source: wql-presets/pipes-limit.md\n```\n\nContent queries can end with pipes — `| select … | order by … | limit … [offset …]`:\n\n```query\n:note{tags:pr,notebook:journal} last 8w | limit 5\n```\n\n`order by <column> [asc|desc]` sorts by a field of the result rows; `select` picks columns (with `in kg`/`in lb` units). Pipes ride on content queries — aggregates don't take them — and some targets ignore a pipe and say so via advisory (`:session` always orders by completion time; `| select` only reshapes `:segment` and `:event`).\n\n## Try it {#try-it}\n\n**Run** — after running the kettlebell note a few times this week ([First Workout](/guide/start?h=try-it)), edit the sandbox query above: change `by {week}` to `by {effort}`, or swap `{discipline:strength}` for `{!discipline:recovery}` — results re-run as you type. **Observe** — sample fallbacks are always badged and never written as your results; this chapter only reads what runs saved. For the interactive workbench, open the [Explorer on the dashboards page](/dashboards).\n\n```button\nlabel:  Open the Explorer →\ntarget: preview\npipeline:\n  - navigate: /dashboards\n```\n\n",
+  "blocks": {
+    "seed:markdown/canvas/guide/wql.md:0": {
+      "id": "seed:markdown/canvas/guide/wql.md:0",
+      "kind": "query",
+      "from": 774,
+      "to": 841,
+      "sourceRevision": 1,
+      "version": 1
+    },
+    "seed:markdown/canvas/guide/wql.md:1": {
+      "id": "seed:markdown/canvas/guide/wql.md:1",
+      "kind": "query",
+      "from": 5232,
+      "to": 5315,
+      "sourceRevision": 1,
+      "version": 1
+    },
+    "seed:markdown/canvas/guide/wql.md:2": {
+      "id": "seed:markdown/canvas/guide/wql.md:2",
+      "kind": "query",
+      "from": 5865,
+      "to": 5912,
+      "sourceRevision": 1,
+      "version": 1
+    },
+    "seed:markdown/canvas/guide/wql.md:3": {
+      "id": "seed:markdown/canvas/guide/wql.md:3",
+      "kind": "query",
+      "from": 6901,
+      "to": 6963,
+      "sourceRevision": 1,
+      "version": 1
+    }
+  },
+  "blockIndex": [
+    {
+      "id": "guide/wql:seed:markdown/canvas/guide/wql.md:0",
+      "noteId": "guide/wql",
+      "blockId": "seed:markdown/canvas/guide/wql.md:0",
+      "blockVersion": 1,
+      "sourceRevision": 1,
+      "from": 774,
+      "to": 841,
+      "position": 0,
+      "dataType": "query",
+      "rawContent": "```query\nsum:totalVolume{discipline:strength} by {week} last 6w\n```",
+      "noteTitle": "Wql",
+      "createdAt": 1792874940000,
+      "isStatic": true,
+      "sourceId": "guides:guide/wql",
+      "sourcePath": "markdown/canvas/guide/wql.md",
+      "routeId": "guide/wql"
+    },
+    {
+      "id": "guide/wql:seed:markdown/canvas/guide/wql.md:1",
+      "noteId": "guide/wql",
+      "blockId": "seed:markdown/canvas/guide/wql.md:1",
+      "blockVersion": 1,
+      "sourceRevision": 1,
+      "from": 5232,
+      "to": 5315,
+      "position": 1,
+      "dataType": "query",
+      "rawContent": "```query\n:note{tags:pr,notebook:journal} last 8w where sum:totalVolume{} > 5000\n```",
+      "noteTitle": "Wql",
+      "createdAt": 1792874940000,
+      "isStatic": true,
+      "sourceId": "guides:guide/wql",
+      "sourcePath": "markdown/canvas/guide/wql.md",
+      "routeId": "guide/wql"
+    },
+    {
+      "id": "guide/wql:seed:markdown/canvas/guide/wql.md:2",
+      "noteId": "guide/wql",
+      "blockId": "seed:markdown/canvas/guide/wql.md:2",
+      "blockVersion": 1,
+      "sourceRevision": 1,
+      "from": 5865,
+      "to": 5912,
+      "position": 2,
+      "dataType": "query",
+      "rawContent": "```query\n:block{text:fran,source:notebooks}\n```",
+      "noteTitle": "Wql",
+      "createdAt": 1792874940000,
+      "isStatic": true,
+      "sourceId": "guides:guide/wql",
+      "sourcePath": "markdown/canvas/guide/wql.md",
+      "routeId": "guide/wql"
+    },
+    {
+      "id": "guide/wql:seed:markdown/canvas/guide/wql.md:3",
+      "noteId": "guide/wql",
+      "blockId": "seed:markdown/canvas/guide/wql.md:3",
+      "blockVersion": 1,
+      "sourceRevision": 1,
+      "from": 6901,
+      "to": 6963,
+      "position": 3,
+      "dataType": "query",
+      "rawContent": "```query\n:note{tags:pr,notebook:journal} last 8w | limit 5\n```",
+      "noteTitle": "Wql",
+      "createdAt": 1792874940000,
+      "isStatic": true,
+      "sourceId": "guides:guide/wql",
+      "sourcePath": "markdown/canvas/guide/wql.md",
+      "routeId": "guide/wql"
+    }
+  ],
+  "blockEfforts": [],
+  "blockEquipment": [],
+  "commit": "35e3c00d1c6fd092d35f4368f5d70ab6b98bc576",
+  "uuid": "94fe48ef-d71a-5120-9c65-0f91c176e0f8",
+  "version": 1
+}

package/dist/web/playground/seed/core/markdown/canvas/home/README.json

@@ -0,0 +1,11 @@
+{
+  "path": "markdown/canvas/home/README.md",
+  "content": "---\nsearch: hidden\ntemplate: canvas\nroute: /\ntype: home\n---\n```scroll:chapters\nrunway: 720vh\nscreen: editor\ntypewriter: true\nstages:\n  - id: basics\n    range: [0.0, 0.166]\n    screen: editor\n    source: wods/examples/syntax/single-movement.md\n    caption: \"Basics. Statements and metrics — how a workout line reads, from rounds to reps.\"\n    ring:\n      tag: Basics example\n  - id: protocols\n    range: [0.166, 0.333]\n    screen: editor\n    source: wods/examples/syntax/timers-rest.md\n    caption: \"Protocols. Countdowns, AMRAPs, EMOMs — the timing protocols that pace a workout.\"\n    ring:\n      tag: Protocols example\n  - id: structure\n    range: [0.333, 0.5]\n    screen: editor\n    source: wods/examples/syntax/groups-1.md\n    caption: \"Structure. Rounds, groups, and nesting — how blocks compose a workout.\"\n    ring:\n      tag: Structure example\n  - id: custom-metrics\n    range: [0.5, 0.666]\n    screen: editor\n    source: wods/syntax/custom-metrics-1.md\n    caption: \"Custom Metrics. Reps, loads, and custom metrics — what gets tracked per movement.\"\n    ring:\n      tag: Custom Metrics example\n  - id: dialects\n    range: [0.666, 0.833]\n    screen: editor\n    source: wods/examples/syntax/dialect-climb-bouldering.md\n    caption: \"Dialects. Run, climb, strength — dialect tags that specialize a block.\"\n    ring:\n      tag: Dialects example\n  - id: complex\n    range: [0.833, 1.0]\n    screen: editor\n    source: wods/examples/syntax/complex-swimming.md\n    caption: \"Complex Workouts. Multi-set swimming intervals with rest recovery.\"\n    ring:\n      tag: Complex example\n```\n\n\n```chapter\nid: home-tour\ntitle: Take the Tour\nbadge: play\nquests: qs-arrive, qs-edit, qs-run, qs-tour-timer, qs-tour-analytics\nsections: []\n```\n\n```chapter\nid: basics\ntitle: Basics\nbadge: trophy\nquests: basics-run, basics-movement, basics-reps, basics-load\nsections: []\n```\n\n```chapter\nid: protocols\ntitle: Protocols\nbadge: timer\nquests: protocols-run, protocols-timer, protocols-rounds, protocols-tag\nsections: []\n```\n\n```chapter\nid: structure\ntitle: Structure\nbadge: blocks\nquests: structure-run, structure-rounds, structure-repscheme\nsections: []\n```\n\n```chapter\nid: custom-metrics\ntitle: Custom Metrics\nbadge: activity\nquests: custom-metrics-run, metrics-custom, metrics-calc\nsections: []\n```\n\n```chapter\nid: dialects\ntitle: Dialects\nbadge: file-text\nquests: dialects-run, dialects-log, dialects-climb\nsections: []\n```\n\n```chapter\nid: complex\ntitle: Complex Workouts\nbadge: puzzle\nquests: complex-run, complex-time, complex-rounds\nsections: []\n```\n\n```quest\nid: qs-arrive\nlabel: Welcome to WOD Wiki\ndesc: You landed on the playground dashboard.\n```\n\n```quest\nid: qs-tour-timer\nlabel: See the timer run it\ndesc: Run the workout — the timer starts in the fullscreen clock.\nvalidation:\n  type: run-started\n```\n\n```quest\nid: qs-tour-analytics\nlabel: Review the session\ndesc: Scroll to the session insights section of the home page.\n```\n\n```quest\nid: qs-edit\nlabel: Change the workout\ndesc: Make any edit to the demo script.\n```\n\n```quest\nid: qs-run\nlabel: Run it to the finish\ndesc: Press Run and let the workout complete.\nvalidation:\n  type: workout-complete\n```\n\n```quest\nid: basics-run\nlabel: Run the First Example\nvalidation:\n  type: run-started\n```\n\n```quest\nid: protocols-run\nlabel: Run the First Example\nvalidation:\n  type: run-started\n```\n\n```quest\nid: structure-run\nlabel: Run the First Example\nvalidation:\n  type: run-started\n```\n\n```quest\nid: custom-metrics-run\nlabel: Run the First Example\nvalidation:\n  type: run-started\n```\n\n```quest\nid: dialects-run\nlabel: Run the First Example\nvalidation:\n  type: run-started\n```\n\n```quest\nid: complex-run\nlabel: Run the First Example\nvalidation:\n  type: run-started\n```\n",
+  "blocks": {},
+  "blockIndex": [],
+  "blockEfforts": [],
+  "blockEquipment": [],
+  "commit": "35e3c00d1c6fd092d35f4368f5d70ab6b98bc576",
+  "uuid": "13fb658b-d799-5d16-81e0-d95820983175",
+  "version": 1
+}

package/dist/web/playground/seed/core/markdown/canvas/home/sample-script.json

@@ -0,0 +1,62 @@
+{
+  "path": "markdown/canvas/home/sample-script.md",
+  "content": "# Edit Me: Morning Strength\n\nChange the reps, movements, or rest below and see the workout update live.\n\n```time\n(3)\n  10 Kettlebell Swings 24kg\n  *:30 Rest\n```",
+  "blocks": {
+    "seed:markdown/canvas/home/sample-script.md:0": {
+      "id": "seed:markdown/canvas/home/sample-script.md:0",
+      "kind": "wod",
+      "from": 105,
+      "to": 160,
+      "sourceRevision": 1,
+      "version": 1,
+      "dialect": "time"
+    }
+  },
+  "blockIndex": [
+    {
+      "id": "markdown/canvas/home/sample-script.md:seed:markdown/canvas/home/sample-script.md:0",
+      "noteId": "markdown/canvas/home/sample-script.md",
+      "blockId": "seed:markdown/canvas/home/sample-script.md:0",
+      "blockVersion": 1,
+      "sourceRevision": 1,
+      "from": 105,
+      "to": 160,
+      "position": 0,
+      "dataType": "wod",
+      "blockContentId": "bc-86bf9888",
+      "rawContent": "```time\n(3)\n  10 Kettlebell Swings 24kg\n  *:30 Rest\n```",
+      "noteTitle": "Sample Script",
+      "createdAt": 1792874940000,
+      "isStatic": true,
+      "sourceId": "guides:home/sample-script",
+      "sourcePath": "markdown/canvas/home/sample-script.md"
+    }
+  ],
+  "blockEfforts": [
+    {
+      "id": "markdown/canvas/home/sample-script.md:seed:markdown/canvas/home/sample-script.md:0:kettlebell-swing",
+      "noteId": "markdown/canvas/home/sample-script.md",
+      "blockId": "seed:markdown/canvas/home/sample-script.md:0",
+      "blockContentId": "bc-86bf9888",
+      "effortSlug": "kettlebell-swing",
+      "isStatic": true,
+      "sourcePath": "markdown/canvas/home/sample-script.md",
+      "createdAt": 1792874940000
+    }
+  ],
+  "blockEquipment": [
+    {
+      "id": "markdown/canvas/home/sample-script.md:seed:markdown/canvas/home/sample-script.md:0:kettlebell",
+      "noteId": "markdown/canvas/home/sample-script.md",
+      "blockId": "seed:markdown/canvas/home/sample-script.md:0",
+      "blockContentId": "bc-86bf9888",
+      "equipmentSlug": "kettlebell",
+      "isStatic": true,
+      "sourcePath": "markdown/canvas/home/sample-script.md",
+      "createdAt": 1792874940000
+    }
+  ],
+  "commit": "35e3c00d1c6fd092d35f4368f5d70ab6b98bc576",
+  "uuid": "cb3bc875-7dcd-5f3c-a6d2-30fec1367be2",
+  "version": 1
+}

package/dist/web/playground/seed/core/markdown/canvas/home/welcome-1.json

@@ -0,0 +1,40 @@
+{
+  "path": "markdown/canvas/home/welcome-1.md",
+  "content": "---\nsearch: hidden\ntitle: \"Welcome\"\nsubtitle: \"Edit this, then hit Run\"\nsection: home\norder: 1\n---\nBelow is a time block, give it a try and click \"Run\" and see the timer come to life.\n\n```time\n0:03 Count Down\n// click \"Next\"\n```",
+  "blocks": {
+    "seed:markdown/canvas/home/welcome-1.md:0": {
+      "id": "seed:markdown/canvas/home/welcome-1.md:0",
+      "kind": "wod",
+      "from": 185,
+      "to": 228,
+      "sourceRevision": 1,
+      "version": 1,
+      "dialect": "time"
+    }
+  },
+  "blockIndex": [
+    {
+      "id": "markdown/canvas/home/welcome-1.md:seed:markdown/canvas/home/welcome-1.md:0",
+      "noteId": "markdown/canvas/home/welcome-1.md",
+      "blockId": "seed:markdown/canvas/home/welcome-1.md:0",
+      "blockVersion": 1,
+      "sourceRevision": 1,
+      "from": 185,
+      "to": 228,
+      "position": 0,
+      "dataType": "wod",
+      "blockContentId": "bc-3dbe7544",
+      "rawContent": "```time\n0:03 Count Down\n// click \"Next\"\n```",
+      "noteTitle": "Welcome 1",
+      "createdAt": 1792874940000,
+      "isStatic": true,
+      "sourceId": "guides:home/welcome-1",
+      "sourcePath": "markdown/canvas/home/welcome-1.md"
+    }
+  ],
+  "blockEfforts": [],
+  "blockEquipment": [],
+  "commit": "35e3c00d1c6fd092d35f4368f5d70ab6b98bc576",
+  "uuid": "45ebe165-cc08-57f0-a3ba-f0c8dc6c9f4c",
+  "version": 1
+}

package/dist/web/playground/seed/core/markdown/canvas/syntax/actions-comments.json

@@ -0,0 +1,62 @@
+{
+  "path": "markdown/canvas/syntax/actions-comments.md",
+  "content": "---\nsearch: hidden\ntitle: \"Actions & Comments\"\nsubtitle: \"Use (parentheses) for actions and // for notes\"\nsection: basics\norder: 5\n---\n```time\n(Setup Barbell)\n5 Back Squat ?lb\n// Add weight each set\n```\n",
+  "blocks": {
+    "seed:markdown/canvas/syntax/actions-comments.md:0": {
+      "id": "seed:markdown/canvas/syntax/actions-comments.md:0",
+      "kind": "wod",
+      "from": 135,
+      "to": 202,
+      "sourceRevision": 1,
+      "version": 1,
+      "dialect": "time"
+    }
+  },
+  "blockIndex": [
+    {
+      "id": "markdown/canvas/syntax/actions-comments.md:seed:markdown/canvas/syntax/actions-comments.md:0",
+      "noteId": "markdown/canvas/syntax/actions-comments.md",
+      "blockId": "seed:markdown/canvas/syntax/actions-comments.md:0",
+      "blockVersion": 1,
+      "sourceRevision": 1,
+      "from": 135,
+      "to": 202,
+      "position": 0,
+      "dataType": "wod",
+      "blockContentId": "bc-d7cb4396",
+      "rawContent": "```time\n(Setup Barbell)\n5 Back Squat ?lb\n// Add weight each set\n```",
+      "noteTitle": "Actions Comments",
+      "createdAt": 1792874940000,
+      "isStatic": true,
+      "sourceId": "guides:syntax/actions-comments",
+      "sourcePath": "markdown/canvas/syntax/actions-comments.md"
+    }
+  ],
+  "blockEfforts": [
+    {
+      "id": "markdown/canvas/syntax/actions-comments.md:seed:markdown/canvas/syntax/actions-comments.md:0:back-squat",
+      "noteId": "markdown/canvas/syntax/actions-comments.md",
+      "blockId": "seed:markdown/canvas/syntax/actions-comments.md:0",
+      "blockContentId": "bc-d7cb4396",
+      "effortSlug": "back-squat",
+      "isStatic": true,
+      "sourcePath": "markdown/canvas/syntax/actions-comments.md",
+      "createdAt": 1792874940000
+    }
+  ],
+  "blockEquipment": [
+    {
+      "id": "markdown/canvas/syntax/actions-comments.md:seed:markdown/canvas/syntax/actions-comments.md:0:barbell",
+      "noteId": "markdown/canvas/syntax/actions-comments.md",
+      "blockId": "seed:markdown/canvas/syntax/actions-comments.md:0",
+      "blockContentId": "bc-d7cb4396",
+      "equipmentSlug": "barbell",
+      "isStatic": true,
+      "sourcePath": "markdown/canvas/syntax/actions-comments.md",
+      "createdAt": 1792874940000
+    }
+  ],
+  "commit": "35e3c00d1c6fd092d35f4368f5d70ab6b98bc576",
+  "uuid": "4381fef3-ff9c-5577-be55-da1e763b1043",
+  "version": 1
+}