@a1knowhow/demo-maker 0.1.0

package/docs/url-capture.md

@@ -0,0 +1,75 @@
+# URL capture
+
+Purpose: Store path segments from the browser URL as `{{ variables }}` during a run.
+
+## What it does
+
+When the runner navigates (and after some steps), it can match the current page URL against regex rules. Each rule’s **first capturing group** is written to a named variable for later steps.
+
+Example: after opening `/projects/abc123/settings`, capture `project_id=abc123` and use `{{ project_id }}` in the next URL or fill.
+
+No rules by default — nothing is captured until you configure them.
+
+## Scenario YAML
+
+```yaml
+name: my-demo
+base_url: https://app.example/
+url_capture:
+  - variable: workspace_id
+    pattern: "/workspace/([^/]+)(?:/|$)"
+  - variable: document_id
+    pattern: "/workspace/[^/]+/doc/([^/]+)"
+steps:
+  - action: navigate
+    url: /workspace/…   # after load, workspace_id is set if the URL matches
+  - action: navigate
+    url: "/workspace/{{ workspace_id }}/doc/{{ document_id }}/edit"
+```
+
+`pattern` is a **RegExp source string** (not slash-wrapped YAML regex). Entry-file only (imports do not contribute `url_capture`).
+
+## CLI
+
+Repeatable flag:
+
+```bash
+npx demo-maker run demo.yaml \
+  --capture-from-url 'workspace_id=/workspace/([^/]+)(?:/|$)' \
+  --capture-from-url 'document_id=/workspace/[^/]+/doc/([^/]+)'
+```
+
+Or a JSON file:
+
+```json
+[
+  { "variable": "workspace_id", "pattern": "/workspace/([^/]+)(?:/|$)" },
+  { "variable": "document_id", "pattern": "/workspace/[^/]+/doc/([^/]+)" }
+]
+```
+
+```bash
+npx demo-maker run demo.yaml --url-capture-file=./url-capture.json
+```
+
+CLI rules are applied **after** scenario `url_capture` (same variable name overwrites when both match later).
+
+## Library
+
+```ts
+import { runScenario, createRegexUrlCapture } from "@a1knowhow/demo-maker";
+
+await runScenario(scenario, context, {
+  urlCaptureHooks: [
+    createRegexUrlCapture([
+      { variable: "org_id", pattern: String.raw`/orgs/([^/]+)` },
+    ]),
+  ],
+});
+```
+
+## Related
+
+- [Variables](./variables.md)
+- [CLI](./cli.md)
+- [Library API](./library-api.md)

package/docs/variables.md

@@ -0,0 +1,48 @@
+# Variables and templates
+
+Purpose: Runtime substitution in scenario strings.
+
+## `{{ placeholders }}`
+
+In `value:`, `url:`, string locator fields, and captions, use:
+
+```yaml
+value: "{{ auth.email }}"
+url: "{{ BASE_URL }}/settings"
+locator: { text: "{{ DEMO_WORKSPACE1 }}" }
+```
+
+Sources (later overrides earlier where applicable):
+
+- `--env-file` / `.env`-style file (all keys)
+- Shell `process.env` only for: auth env names, `BASE_URL`, and flat `{{ NAME }}` keys referenced in the scenario
+- Captured variables during the run (see [URL capture](./url-capture.md))
+- Built-in `auth.email` / `auth.password` from env names in `auth:` (or defaults `E2E_TEST_USER_EMAIL` / `E2E_TEST_USER_PASSWORD`)
+- Nested keys: `{{ auth.email }}`
+
+Prefer putting secrets and demo-specific values in `--env-file` rather than relying on the ambient shell environment.
+
+`BASE_URL` from the env file overrides scenario `base_url` unless `--base-url` is passed (CLI wins).
+
+**Regex locators are not interpolated** — see [Locators](./locators.md).
+
+## Template functions
+
+`[fnName:"arg"]` in supported string fields. Currently used in `video.filename`:
+
+| Syntax | Description |
+|--------|-------------|
+| `[date:"FORMAT"]` | Current local date/time |
+
+Tokens: `YYYY`, `MM`, `DD`, `HH`, `mm`.
+
+```yaml
+video:
+  enabled: true
+  dir: output/videos
+  filename: demo-[date:"YYYY-MM-DD-HHmm"].mp4
+```
+
+Produces e.g. `demo-2026-04-01-1432.mp4`.
+
+Implemented in `src/templates.ts`.

package/docs/video-and-pacing.md

@@ -0,0 +1,109 @@
+# Video and pacing
+
+Purpose: Recording quality, overlays, ffmpeg post-processing, and timing.
+
+Requires **ffmpeg** on `PATH` for `.mp4`, trim/splice (`start_step`/`end_step`, `cut_video`), and background audio.
+
+## Video config
+
+```yaml
+video:
+  enabled: true
+  dir: "output/videos"           # relative to process cwd
+  filename: "demo-[date:\"YYYY-MM-DD-HHmm\"].mp4"
+  size: { width: 1920, height: 1080 }      # final output
+  viewport: { width: 1440, height: 810 }   # browser render (optional)
+  start_step: 11                 # optional trim (1-based); needs ffmpeg
+  end_step: 40
+  caption_parallel: true         # optional
+  playback_speed: 1.25           # optional; .mp4 only
+```
+
+| Field | Notes |
+|-------|--------|
+| `enabled` | Must be `true` to record |
+| `dir` | Created if missing; relative to **cwd**, not the YAML path |
+| `filename` | Optional; `.mp4` triggers H.264 re-encode (CRF 18). Supports `[date:"…"]` |
+| `size` | Final resolution (YouTube-oriented default 1920×1080) |
+| `viewport` | Browser size; if smaller than `size`, ffmpeg upscales (lanczos). Use on laptops so headed Chrome fits the screen |
+| `start_step` / `end_step` | Trim saved video after full run |
+| `caption_parallel` | If true, caption overlay does not block the next step |
+| `playback_speed` | Speed final MP4 (`setpts`); chapters remapped; BGM stays normal tempo |
+
+Playwright records VP8 WebM internally; `.mp4` re-encodes to H.264 (`libx264`, `yuv420p`, `faststart`).
+
+## Captions
+
+Any step may set `caption:`. With video enabled, a bottom overlay is shown after the step. Default: wait ~2.5s before the next step. With `caption_parallel: true`, the caption fades on a timer while the next steps run.
+
+Optional `caption_style: chapter` — full-width bottom bar, larger type.
+
+Prefer few captions (scene intent), not every click. Supports `{{ ENV }}`.
+
+## Scene polish actions
+
+| Action | Role |
+|--------|------|
+| `title_card` | Full-screen chapter title (`text`, `hold_ms`, `fade_ms`) |
+| `transition` | Fade to black (`fade_ms`; optional `hold_ms` for outro) |
+| `cut_video` | Exclude nested duration from MP4; optional `title_card` placeholder |
+| `video_exclude: true` | Exclude a single step |
+
+## Background audio
+
+```yaml
+audio:
+  background: path/to/music.mp3
+```
+
+Mixed into the final MP4 via ffmpeg (when producing `.mp4`).
+
+## Timing and chapters
+
+On success with video, the runner writes `<basename>.timing.json` beside the video. Chapter timestamps remap after splice/speed.
+
+```bash
+demo-maker export-chapters output/videos/demo.timing.json
+demo-maker export-chapters output/videos
+```
+
+Use `action: log` with `── Scene N: Title` and/or `caption:` for chapter labels. Excluded (`cut_video`) steps are omitted from chapter export.
+
+## Pacing fields
+
+| Field | Role |
+|-------|------|
+| `step_delay_ms` | After each step |
+| `slow_mo_ms` | Playwright slowMo |
+| `typing_delay_ms` | Between keystrokes (`type`); per-step override OK |
+| `post_click_delay_ms` | After click settle |
+| `navigate_hold_ms` | After navigate settle |
+| `pre_action_delay_ms` | Before navigate/click |
+
+`--fast` disables pacing for smoke checks.
+
+Hold on a frame for video:
+
+```yaml
+- action: wait
+  timeout_ms: 4000
+```
+
+## Recommended YouTube settings (laptop)
+
+```yaml
+video:
+  enabled: true
+  dir: output/videos
+  filename: demo-[date:"YYYY-MM-DD-HHmm"].mp4
+  size: { width: 1920, height: 1080 }
+  viewport: { width: 1440, height: 810 }
+```
+
+On a large external display, omit `viewport` for native 1080p rendering.
+
+## Related
+
+- [Actions](./actions.md) (`title_card`, `cut_video`, `wait`)
+- [Variables](./variables.md) (filename templates)
+- [Getting started](./getting-started.md)

package/examples/demo1-introduction.yaml

@@ -0,0 +1,166 @@
+name: demo1-introduction
+title: "demo-maker — Getting started walkthrough"
+description: |
+  Public intro demo: open this repo on GitHub, walk getting-started.md
+  (install → YAML → env → video → record), then actions.md and locators.md
+  (including the accessibility tip). No auth required.
+base_url: https://github.com
+video:
+  enabled: true
+  dir: output/videos
+  filename: demo1-introduction-[date:"YYYY-MM-DD-HHmm"].mp4
+  size: { width: 1920, height: 1080 }
+  viewport: { width: 1440, height: 810 }
+  caption_parallel: true
+  playback_speed: 1.1
+# Optional BGM (bring your own royalty-free track; path relative to cwd):
+# audio:
+#   background: path/to/your-track.mp3
+step_delay_ms: 250
+slow_mo_ms: 50
+typing_delay_ms: 40
+post_click_delay_ms: 250
+navigate_hold_ms: 1000
+pre_action_delay_ms: 200
+action_timeout_ms: 30000
+
+steps:
+  - action: title_card
+    text: "From install to your first MP4"
+    hold_ms: 1400
+
+  - action: log
+    message: "── Scene 1: Repository home → Getting started"
+
+  - import: fragments/open-repository.yaml
+
+  - action: navigate
+    url: /a1knowhow/demo-maker/blob/main/docs/getting-started.md
+    caption: "Getting started"
+
+  - action: expect_visible
+    locator:
+      role: heading
+      name: Getting started
+
+  - action: log
+    message: "── Scene 2: Install"
+
+  - action: click
+    locator:
+      role: link
+      name: "Permalink: Step 1 — Install prerequisites"
+    caption: "Install"
+
+  - action: wait
+    timeout_ms: 900
+
+  - action: log
+    message: "── Scene 3: Create your YAML"
+
+  - action: click
+    locator:
+      role: link
+      name: "Permalink: Step 3 — Point at your app"
+
+  - action: click
+    locator:
+      text: "name: my-app-smoke"
+    caption: "Create your YAML file"
+
+  - action: wait
+    timeout_ms: 1000
+
+  - action: log
+    message: "── Scene 4: Env vars when needed"
+
+  - action: click
+    locator:
+      role: link
+      name: "Permalink: Step 4 — Env file and auth (when needed)"
+    caption: "Env vars when you need auth"
+
+  - action: wait
+    timeout_ms: 900
+
+  - action: log
+    message: "── Scene 5: Record video"
+
+  - action: click
+    locator:
+      role: link
+      name: "Permalink: Step 5 — Record a video (MP4)"
+    caption: "Enable video for MP4 output"
+
+  - action: wait
+    timeout_ms: 500
+
+  - action: log
+    message: "── Scene 6: Generate draft YAML"
+
+  - action: click
+    locator:
+      role: link
+      name: "Permalink: Step 6 — Record interactions instead of writing YAML by hand"
+    caption: "Generate draft YAML with demo-maker record"
+
+  - action: wait
+    timeout_ms: 1000
+
+  - action: log
+    message: "── Scene 7: Actions reference"
+
+  - action: click
+    locator:
+      role: link
+      name: "Permalink: Next reading"
+
+  - action: click
+    locator:
+      selector: '.markdown-body a[href$="actions.md"]'
+    settle_until:
+      locator:
+        role: heading
+        name: Actions
+    caption: "Browse every action"
+
+  - action: wait
+    timeout_ms: 800
+    caption: "navigate, click, type, expect_visible, …"
+
+  - action: log
+    message: "── Scene 8: Locators"
+
+  - action: click
+    locator:
+      role: link
+      name: "Permalink: Related"
+
+  - action: click
+    locator:
+      selector: '.markdown-body a[href$="locators.md"]'
+    settle_until:
+      locator:
+        role: heading
+        name: Locators
+    caption: "How to target UI elements"
+
+  - action: wait
+    timeout_ms: 800
+
+  - action: click
+    locator:
+      role: link
+      name: "Permalink: Accessibility tip (for app authors)"
+    caption: "Unique aria-labels keep demos stable"
+
+  - action: wait
+    timeout_ms: 1400
+
+  - action: transition
+    fade_ms: 400
+    hold_ms: 300
+
+  - action: title_card
+    text: "Try https://github.com/a1knowhow/demo-maker"
+    hold_ms: 1800

package/examples/demo2-github-actions.yaml

@@ -0,0 +1,109 @@
+name: demo2-github-actions
+title: "demo-maker — GitHub Actions walkthrough"
+description: |
+  Richer public example: open this repo on GitHub, open Actions, open the latest
+  successful run, and open the test job (green check-marks on each step).
+  No auth required for this walkthrough. Expanding step logs needs a signed-in
+  GitHub session (optional --storage-state); anonymously GitHub disables clicks
+  on log steps (pointer-events:none).
+base_url: https://github.com
+video:
+  enabled: true
+  dir: output/videos
+  filename: demo2-github-actions-[date:"YYYY-MM-DD-HHmm"].mp4
+  size: { width: 1920, height: 1080 }
+  viewport: { width: 1440, height: 810 }
+  caption_parallel: true
+  playback_speed: 1.25
+# Optional BGM (bring your own royalty-free track; path relative to cwd):
+# audio:
+#   background: path/to/your-track.mp3
+step_delay_ms: 400
+slow_mo_ms: 80
+typing_delay_ms: 40
+post_click_delay_ms: 350
+navigate_hold_ms: 1800
+pre_action_delay_ms: 350
+action_timeout_ms: 30000
+
+steps:
+  - action: title_card
+    text: "Demo videos as code"
+    hold_ms: 1600
+
+  - action: log
+    message: "── Scene 1: Repository home → Actions"
+
+  - import: fragments/open-repository.yaml
+
+  - action: click
+    locator:
+      role: link
+      name: Actions
+    settle_until:
+      locator:
+        role: combobox
+        name: Filter workflow runs
+    caption: "Open GitHub Actions"
+
+  - action: wait
+    timeout_ms: 1200
+    caption: "CI runs for this repo"
+
+  - action: log
+    message: "── Scene 2: Open the latest successful run"
+
+  - action: title_card
+    text: "Inspect a green CI run"
+    hold_ms: 1400
+
+  - action: click
+    locator:
+      role: link
+      name: /completed successfully:/i
+    settle_until:
+      locator:
+        role: link
+        name: test
+    caption: "Open the first successful workflow run"
+
+  - action: wait
+    timeout_ms: 1000
+
+  - action: log
+    message: "── Scene 3: Open the test job"
+
+  - action: click
+    locator:
+      role: link
+      name: test
+    settle_until:
+      text: Run npm test
+    caption: "Open the test job"
+
+  - action: expect_visible
+    locator:
+      text: Run npm test
+
+  - action: expect_visible
+    locator:
+      text: Run npm run typecheck
+
+  - action: wait
+    timeout_ms: 2800
+    caption: "Green checks on every step — re-run forever"
+
+  # Expanding a step log requires a signed-in GitHub session (anonymous UI uses
+  # pointer-events:none on <details>). With storage_state, you can add:
+  # - action: click
+  #   locator:
+  #     selector: 'summary.CheckStep-header:has-text("Run npm test")'
+  #   caption: "Expand the npm test step"
+
+  - action: transition
+    fade_ms: 500
+    hold_ms: 400
+
+  - action: title_card
+    text: "Try https://github.com/a1knowhow/demo-maker"
+    hold_ms: 2200

package/examples/files/demo1-introduction-run.log

@@ -0,0 +1,50 @@
+Base URL: https://github.com
+Running scenario: demo1-introduction (35/35 steps)
+10:35:58 - Step  1/35: title_card     - From install to your first MP4
+10:36:00 - Step  2/35: log            - ── Scene 1: Repository home → Getting started
+[log] ── Scene 1: Repository home → Getting started
+10:36:01 - Step  3/35: navigate       - Open the demo-maker repository
+10:36:04 - Step  4/35: expect_visible - link "demo-maker"
+10:36:04 - Step  5/35: wait           - 800ms
+10:36:05 - Step  6/35: navigate       - Getting started
+10:36:08 - Step  7/35: expect_visible - heading "Getting started"
+10:36:08 - Step  8/35: log            - ── Scene 2: Install
+[log] ── Scene 2: Install
+10:36:08 - Step  9/35: click          - Install
+10:36:10 - Step 10/35: wait           - 900ms
+10:36:11 - Step 11/35: log            - ── Scene 3: Create your YAML
+[log] ── Scene 3: Create your YAML
+10:36:12 - Step 12/35: click          - link "Permalink: Step 3 — Point at your app"
+10:36:13 - Step 13/35: click          - Create your YAML file
+10:36:14 - Step 14/35: wait           - 1000ms
+10:36:16 - Step 15/35: log            - ── Scene 4: Env vars when needed
+[log] ── Scene 4: Env vars when needed
+10:36:16 - Step 16/35: click          - Env vars when you need auth
+10:36:18 - Step 17/35: wait           - 900ms
+10:36:19 - Step 18/35: log            - ── Scene 5: Record video
+[log] ── Scene 5: Record video
+10:36:19 - Step 19/35: click          - Enable video for MP4 output
+10:36:21 - Step 20/35: wait           - 500ms
+10:36:21 - Step 21/35: log            - ── Scene 6: Generate draft YAML
+[log] ── Scene 6: Generate draft YAML
+10:36:22 - Step 22/35: click          - Generate draft YAML with demo-maker record
+10:36:23 - Step 23/35: wait           - 1000ms
+10:36:24 - Step 24/35: log            - ── Scene 7: Actions reference
+[log] ── Scene 7: Actions reference
+10:36:25 - Step 25/35: click          - link "Permalink: Next reading"
+10:36:26 - Step 26/35: click          - Browse every action
+10:36:28 - Step 27/35: wait           - navigate, click, type, expect_visible, …
+10:36:29 - Step 28/35: log            - ── Scene 8: Locators
+[log] ── Scene 8: Locators
+10:36:30 - Step 29/35: click          - link "Permalink: Related"
+10:36:31 - Step 30/35: click          - How to target UI elements
+10:36:33 - Step 31/35: wait           - 800ms
+10:36:34 - Step 32/35: click          - Unique aria-labels keep demos stable
+10:36:35 - Step 33/35: wait           - 1400ms
+10:36:37 - Step 34/35: transition     - fade 400ms
+10:36:38 - Step 35/35: title_card     - Try https://github.com/a1knowhow/demo-maker
+Re-encoded to H.264 MP4 (CRF 18). Playback speed 1.1×. Upscaled 1440x810 → 1920x1080.
+Timing saved: demo-maker/output/videos/demo1-introduction-2026-09-12-0735.timing.json
+Scenario completed successfully.
+Video saved: demo-maker/output/videos/demo1-introduction-2026-09-12-0735.mp4
+Timing saved: demo-maker/output/videos/demo1-introduction-2026-09-12-0735.timing.json

package/examples/fragments/open-repository.yaml

@@ -0,0 +1,15 @@
+name: open-repository
+description: Fragment — open the demo-maker repository home page
+base_url: https://github.com
+steps:
+  - action: navigate
+    url: /a1knowhow/demo-maker
+    caption: "Open the demo-maker repository"
+
+  - action: expect_visible
+    locator:
+      role: link
+      name: demo-maker
+
+  - action: wait
+    timeout_ms: 800

package/examples/smoke.yaml

@@ -0,0 +1,18 @@
+name: smoke
+description: Minimal public example — opens example.com (no auth)
+base_url: https://example.com
+video:
+  enabled: true
+  dir: output/videos
+  filename: smoke-[date:"YYYY-MM-DD-HHmm"].mp4
+  size: { width: 1920, height: 1080 }
+  viewport: { width: 1440, height: 810 }   # optional; fit laptop screen when headed
+steps:
+  - action: navigate
+    url: "/"
+    caption: "Example domain"
+  - action: expect_visible
+    locator:
+      text: Example Domain
+  - action: wait
+    timeout_ms: 800

package/llms.txt

@@ -0,0 +1,32 @@
+# demo-maker
+
+> Demo videos as code — YAML + Playwright → polished, consistent product feature videos. Configure once, re-run forever.
+
+Open-source CLI (`@a1knowhow/demo-maker`). Requires Node.js 20+, Playwright Chromium, and ffmpeg. Apache-2.0.
+
+Prefer markdown docs linked below over scraping HTML. Schema lives in source TypeScript.
+
+## Docs
+
+- [README](https://raw.githubusercontent.com/a1knowhow/demo-maker/main/README.md): Overview, install, quick start
+- [Getting started](https://raw.githubusercontent.com/a1knowhow/demo-maker/main/docs/getting-started.md): First scenario and MP4
+- [CLI](https://raw.githubusercontent.com/a1knowhow/demo-maker/main/docs/cli.md): Commands and flags
+- [Scenario schema](https://raw.githubusercontent.com/a1knowhow/demo-maker/main/docs/scenario-schema.md): YAML structure
+- [Actions](https://raw.githubusercontent.com/a1knowhow/demo-maker/main/docs/actions.md): Step actions
+- [Locators](https://raw.githubusercontent.com/a1knowhow/demo-maker/main/docs/locators.md): Targeting UI
+- [Video & pacing](https://raw.githubusercontent.com/a1knowhow/demo-maker/main/docs/video-and-pacing.md): Recording quality
+- [Recording](https://raw.githubusercontent.com/a1knowhow/demo-maker/main/docs/recording.md): Live record to YAML
+- [Repair](https://raw.githubusercontent.com/a1knowhow/demo-maker/main/docs/repairing-scenarios.md): Fix after UI changes
+
+## Optional
+
+- [Docs index](https://raw.githubusercontent.com/a1knowhow/demo-maker/main/docs/README.md)
+- [Imports & fragments](https://raw.githubusercontent.com/a1knowhow/demo-maker/main/docs/imports-and-fragments.md)
+- [Variables](https://raw.githubusercontent.com/a1knowhow/demo-maker/main/docs/variables.md)
+- [URL capture](https://raw.githubusercontent.com/a1knowhow/demo-maker/main/docs/url-capture.md)
+- [Library API](https://raw.githubusercontent.com/a1knowhow/demo-maker/main/docs/library-api.md)
+- [Types](https://raw.githubusercontent.com/a1knowhow/demo-maker/main/src/types.ts): Typed scenario schema
+- [Example scenario](https://raw.githubusercontent.com/a1knowhow/demo-maker/main/examples/smoke.yaml)
+- [Getting started walkthrough](https://raw.githubusercontent.com/a1knowhow/demo-maker/main/examples/demo1-introduction.yaml)
+- [GitHub Actions walkthrough](https://raw.githubusercontent.com/a1knowhow/demo-maker/main/examples/demo2-github-actions.yaml)
+- [Security policy](https://raw.githubusercontent.com/a1knowhow/demo-maker/main/SECURITY.md)

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@a1knowhow/demo-maker",
+  "version": "0.1.0",
+  "description": "Demo videos as code — configure once, re-run forever. YAML + Playwright → polished, consistent product feature videos.",
+  "license": "Apache-2.0",
+  "type": "module",
+  "bin": {
+    "demo-maker": "./bin/demo-maker.mjs"
+  },
+  "exports": {
+    ".": "./src/index.ts"
+  },
+  "files": [
+    "bin",
+    "src",
+    "examples",
+    "docs",
+    "LICENSE",
+    "README.md",
+    "SECURITY.md",
+    "llms.txt"
+  ],
+  "keywords": [
+    "automation",
+    "cli",
+    "demo",
+    "ffmpeg",
+    "playwright",
+    "product-demo",
+    "screen-recording",
+    "video",
+    "yaml"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/a1knowhow/demo-maker.git"
+  },
+  "homepage": "https://github.com/a1knowhow/demo-maker#readme",
+  "bugs": {
+    "url": "https://github.com/a1knowhow/demo-maker/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "demo-maker": "tsx src/main.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "pack:check": "npm pack --dry-run",
+    "prepublishOnly": "npm test && npm run typecheck"
+  },
+  "dependencies": {
+    "playwright": "^1.62.1",
+    "tsx": "^4.23.13",
+    "yaml": "^2.9.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.10",
+    "typescript": "^5.9.3",
+    "vitest": "^3.0.9"
+  }
+}