@bitcobblers/wod-wiki-tools 0.53.2203 → 0.53.2204

package/dist/index.mjs

@@ -1,6 +1,6 @@
 import { createRequire } from 'module';
-export { PackLoadError, ParseSyntaxError, WqlSyntaxError, cliMain, formatExecutionOutput, formatParseOutput, formatQueryOutput, loadCliEnvironment, loadLanguagePack, loadQueryData, parseCliArgs, readStdin, resolveDatabaseConfig, runExecution, runParse, runQueryCli } from './chunk-LWW4HK4G.mjs';
-import './chunk-ES4ZZ447.mjs';
+export { PackLoadError, ParseSyntaxError, WqlSyntaxError, cliMain, formatExecutionOutput, formatParseOutput, formatQueryOutput, loadCliEnvironment, loadLanguagePack, loadQueryData, parseCliArgs, readStdin, resolveDatabaseConfig, runExecution, runParse, runQueryCli } from './chunk-SLCRIGUR.mjs';
+import './chunk-5NNSHRMZ.mjs';
 import './chunk-KGP6STLY.mjs';
 export { runCliServer } from './chunk-LNBKPHEP.mjs';
 import './chunk-2EWCEE6N.mjs';

package/dist/{scaffoldFeed-OS5HGYG4.mjs → scaffoldFeed-TCRNXYQU.mjs}

@@ -1,5 +1,5 @@
 import { createRequire } from 'module';
-import { VERSION } from './chunk-ES4ZZ447.mjs';
+import { VERSION } from './chunk-5NNSHRMZ.mjs';
 import './chunk-QUUX6NX2.mjs';
 import { mkdirSync, writeFileSync, rmSync } from 'fs';
 import { resolve, join, dirname } from 'path';
@@ -201,5 +201,5 @@ function scaffoldFeed(name, opts = {}) {
 }
 
 export { scaffoldFeed, validateFeedName };
-//# sourceMappingURL=scaffoldFeed-OS5HGYG4.mjs.map
-//# sourceMappingURL=scaffoldFeed-OS5HGYG4.mjs.map
+//# sourceMappingURL=scaffoldFeed-TCRNXYQU.mjs.map
+//# sourceMappingURL=scaffoldFeed-TCRNXYQU.mjs.map

package/dist/{scaffoldFeed-OS5HGYG4.mjs.map → scaffoldFeed-TCRNXYQU.mjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/cli/scaffoldFeed.ts"],"names":[],"mappings":"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","file":"scaffoldFeed-OS5HGYG4.mjs","sourcesContent":["/**\n * `wod init-feed <name>` — scaffold a ready-to-publish WOD Wiki feed\n * repository skeleton (the publisher-repository contract in\n * docs/adrs/0001-feed-seed-data-contract.md): a markdown notebooks example,\n * package.json, GitHub Actions Pages workflow, README. Creates a new\n * directory only; refuses an existing destination without touching it.\n *\n * Lazily imported by cli/runner.ts (dynamic import), so static node:fs/node:path\n * imports stay out of browser bundles.\n */\nimport { mkdirSync, rmSync, writeFileSync } from 'node:fs';\nimport { dirname, join, resolve } from 'node:path';\nimport { VERSION } from '../version';\n\nexport interface ScaffoldFeedResult {\n  /** Absolute path of the created feed root. */\n  dir: string;\n  /** Created files, POSIX-relative to the feed root. */\n  files: string[];\n}\n\n/** npm package name + single-directory-segment validation for `<name>`. */\nexport function validateFeedName(name: string): string {\n  if (name.length === 0 || name === '.' || name === '..') {\n    throw new Error('Feed name must be a single non-empty directory name');\n  }\n  if (name.includes('/') || name.includes('\\\\') || name.includes('\\0')) {\n    throw new Error(`Invalid feed name '${name}': must be a single directory name (no path separators or traversal)`);\n  }\n  if (/^(?:[A-Za-z]:)?[/\\\\]/.test(name)) {\n    throw new Error(`Invalid feed name '${name}': absolute paths are not allowed`);\n  }\n  if (name.length > 214 || !/^[a-z0-9][a-z0-9._-]*$/.test(name)) {\n    throw new Error(\n      `Invalid feed name '${name}': must be a valid npm package name ` +\n      '(lowercase letters, digits, dots, hyphens, underscores; no leading dot/hyphen)',\n    );\n  }\n  return name;\n}\n\nconst publishWorkflow = (): string => `name: Publish feed\n\n# Compile the feed with the wod CLI and deploy dist/ to GitHub Pages.\n# Requires Pages enabled: repo Settings → Pages → Source: \"GitHub Actions\".\n\non:\n  push:\n    branches: [main]\n  workflow_dispatch:\n\npermissions:\n  contents: read\n  pages: write\n  id-token: write\n\nconcurrency:\n  group: pages\n  cancel-in-progress: true\n\njobs:\n  publish:\n    runs-on: ubuntu-latest\n    environment:\n      name: github-pages\n      url: \\${{ steps.deployment.outputs.page_url }}\n    steps:\n      - uses: actions/checkout@v4\n        with:\n          # Full history: seed manifest version stamps derive from git commit count.\n          fetch-depth: 0\n\n      - name: Set up Bun\n        uses: oven-sh/setup-bun@v2\n        with:\n          bun-version: 1.4.x\n\n      - name: Install dependencies\n        run: bun install\n\n      - name: Build seed\n        run: bunx wod build . --output dist\n\n      - uses: actions/configure-pages@v5\n\n      - name: Upload dist\n        uses: actions/upload-pages-artifact@v3\n        with:\n          path: dist\n\n      - id: deployment\n        uses: actions/deploy-pages@v4\n`;\n\nconst feedReadme = (name: string): string => `# ${name}\n\nExample benchmark notebook. Each \\`.md\\` file in this directory becomes part of\nthe \\`example\\` notebook chunk; \\`README.md\\` is the notebook's landing page.\n\nAdd one file per workout:\n\n\\`\\`\\`\\`markdown\n---\ntitle: My workout\ndate: 2026-01-01\n---\n\n# My workout\n\n\\`\\`\\`time\n(21-15-9)\n  Thrusters @95lb\n  Pull-ups\n\\`\\`\\`\n\\`\\`\\`\\`\n\nThe \\`date:\\` frontmatter field sets the workout's chronological placement\n(regardless of filename or directory).\n`;\n\nconst exampleWorkout = (date: string): string => `---\ntitle: Morning session\ndate: ${date}\n---\n\n# Morning session\n\n\\`\\`\\`time\n(21-15-9)\n  Thrusters @95lb\n  Pull-ups\n\\`\\`\\`\n`;\n\nconst repoReadme = (name: string): string => `# ${name}\n\nA [WOD Wiki](https://github.com/bitcobblers/wod-wiki) workout feed: plain\nMarkdown workouts compiled to static, version-stamped seed chunks and published\nvia GitHub Pages.\n\n## Develop\n\n\\`\\`\\`sh\nbun install\nbunx wod build . --output dist\n\\`\\`\\`\n\nWorkouts live under \\`markdown/\\` — this scaffold starts with one example\nfeed. Validate everything with \\`bunx wod build\\`: it gates every file on\nthe Whiteboard grammar and corpus layout before writing \\`dist/\\`.\n\n## Publish\n\nPush to GitHub and enable Pages (**Settings → Pages → Source: GitHub\nActions**). The bundled workflow (\\`.github/workflows/publish-feed.yml\\`)\nbuilds the feed on every push to \\`main\\` and deploys \\`dist/\\`.\n\n## Share\n\nOnce published, anyone can subscribe to this feed from a WOD Wiki instance\nat:\n\n\\`\\`\\`\n<app-url>/subscribe?source=<url-encoded published feed URL>\n\\`\\`\\`\n\nFor \\`owner\\`/\\`repo\\` on GitHub Pages the feed URL is the deployed\ndirectory, \\`https://owner.github.io/repo/\\`, e.g.\n\\`/subscribe?source=https%3A%2F%2Fowner.github.io%2Frepo%2F\\`.\n`;\n\n/**\n * Scaffold a new feed repository at `<cwd>/<name>`. Throws when the name is\n * invalid or the destination already exists; partial failure removes created files.\n */\nexport function scaffoldFeed(name: string, opts: { cwd?: string } = {}): ScaffoldFeedResult {\n  validateFeedName(name);\n  const dir = resolve(opts.cwd ?? process.cwd(), name);\n  // Atomic acquire: EEXIST is the refusal signal — no exists-check/create race,\n  // and an existing destination is never removed or written.\n  try {\n    mkdirSync(dir);\n  } catch (error) {\n    if ((error as NodeJS.ErrnoException).code === 'EEXIST') {\n      throw new Error(`Refusing to overwrite '${dir}': destination already exists`, { cause: error });\n    }\n    throw error;\n  }\n\n  const date = new Date().toISOString().slice(0, 10);\n  const files: Array<[rel: string, content: string]> = [\n    ['package.json', `${JSON.stringify(\n      {\n        name,\n        version: '0.1.0',\n        private: true,\n        type: 'module',\n        description: `WOD Wiki workout feed: ${name}`,\n        scripts: {\n          build: 'wod build . --output dist',\n        },\n        devDependencies: {\n          '@bitcobblers/wod-wiki-tools': `^${VERSION}`,\n        },\n      },\n      null,\n      2,\n    )}\\n`],\n    ['.gitignore', 'node_modules/\\ndist/\\n'],\n    ['.github/workflows/publish-feed.yml', publishWorkflow()],\n    ['markdown/notebooks/example/README.md', feedReadme(name)],\n    [`markdown/notebooks/example/morning-session.md`, exampleWorkout(date)],\n    ['README.md', repoReadme(name)],\n  ];\n\n  try {\n    for (const [rel, content] of files) {\n      const target = join(dir, rel);\n      mkdirSync(dirname(target), { recursive: true });\n      writeFileSync(target, content, 'utf-8');\n    }\n  } catch (error) {\n    rmSync(dir, { recursive: true, force: true });\n    throw error;\n  }\n  return { dir, files: files.map(([rel]) => rel) };\n}\n"]}
+{"version":3,"sources":["../src/cli/scaffoldFeed.ts"],"names":[],"mappings":";;;;;;;;;AAsBO,SAAS,iBAAiB,IAAA,EAAsB;AACrD,EAAA,IAAI,KAAK,MAAA,KAAW,CAAA,IAAK,IAAA,KAAS,GAAA,IAAO,SAAS,IAAA,EAAM;AACtD,IAAA,MAAM,IAAI,MAAM,qDAAqD,CAAA;AAAA,EACvE;AACA,EAAA,IAAI,IAAA,CAAK,QAAA,CAAS,GAAG,CAAA,IAAK,IAAA,CAAK,QAAA,CAAS,IAAI,CAAA,IAAK,IAAA,CAAK,QAAA,CAAS,IAAI,CAAA,EAAG;AACpE,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,mBAAA,EAAsB,IAAI,CAAA,oEAAA,CAAsE,CAAA;AAAA,EAClH;AACA,EAAA,IAAI,sBAAA,CAAuB,IAAA,CAAK,IAAI,CAAA,EAAG;AACrC,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,mBAAA,EAAsB,IAAI,CAAA,iCAAA,CAAmC,CAAA;AAAA,EAC/E;AACA,EAAA,IAAI,KAAK,MAAA,GAAS,GAAA,IAAO,CAAC,wBAAA,CAAyB,IAAA,CAAK,IAAI,CAAA,EAAG;AAC7D,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,sBAAsB,IAAI,CAAA,kHAAA;AAAA,KAE5B;AAAA,EACF;AACA,EAAA,OAAO,IAAA;AACT;AAEA,IAAM,kBAAkB,MAAc,CAAA;;AAAA;AAAA;;AAAA;AAAA;AAAA;AAAA;;AAAA;AAAA;AAAA;AAAA;;AAAA;AAAA;AAAA;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;AAAA;AAAA;AAAA;AAAA;;AAAA;AAAA;;AAAA;AAAA;;AAAA;;AAAA;AAAA;AAAA;AAAA;;AAAA;AAAA;AAAA,CAAA;AAqDtC,IAAM,UAAA,GAAa,CAAC,IAAA,KAAyB,CAAA,EAAA,EAAK,IAAI;;AAAA;AAAA;;AAAA;;AAAA;AAAA;AAAA;AAAA;AAAA;;AAAA;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;AAAA;AAAA;AAAA,CAAA;AA0BtD,IAAM,cAAA,GAAiB,CAAC,IAAA,KAAyB,CAAA;AAAA;AAAA,MAAA,EAEzC,IAAI;AAAA;;AAAA;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,CAAA;AAYZ,IAAM,UAAA,GAAa,CAAC,IAAA,KAAyB,CAAA,EAAA,EAAK,IAAI;;AAAA;AAAA;AAAA;;AAAA;;AAAA;AAAA;AAAA;AAAA;;AAAA;AAAA;AAAA;;AAAA;;AAAA;AAAA;AAAA;;AAAA;;AAAA;AAAA;;AAAA;AAAA;AAAA;;AAAA;AAAA;AAAA;AAAA,CAAA;AAyC/C,SAAS,YAAA,CAAa,IAAA,EAAc,IAAA,GAAyB,EAAC,EAAuB;AAC1F,EAAA,gBAAA,CAAiB,IAAI,CAAA;AACrB,EAAA,MAAM,MAAM,OAAA,CAAQ,IAAA,CAAK,OAAO,OAAA,CAAQ,GAAA,IAAO,IAAI,CAAA;AAGnD,EAAA,IAAI;AACF,IAAA,SAAA,CAAU,GAAG,CAAA;AAAA,EACf,SAAS,KAAA,EAAO;AACd,IAAA,IAAK,KAAA,CAAgC,SAAS,QAAA,EAAU;AACtD,MAAA,MAAM,IAAI,MAAM,CAAA,uBAAA,EAA0B,GAAG,iCAAiC,EAAE,KAAA,EAAO,OAAO,CAAA;AAAA,IAChG;AACA,IAAA,MAAM,KAAA;AAAA,EACR;AAEA,EAAA,MAAM,IAAA,GAAA,qBAAW,IAAA,EAAK,EAAE,aAAY,CAAE,KAAA,CAAM,GAAG,EAAE,CAAA;AACjD,EAAA,MAAM,KAAA,GAA+C;AAAA,IACnD,CAAC,cAAA,EAAgB,CAAA,EAAG,IAAA,CAAK,SAAA;AAAA,MACvB;AAAA,QACE,IAAA;AAAA,QACA,OAAA,EAAS,OAAA;AAAA,QACT,OAAA,EAAS,IAAA;AAAA,QACT,IAAA,EAAM,QAAA;AAAA,QACN,WAAA,EAAa,0BAA0B,IAAI,CAAA,CAAA;AAAA,QAC3C,OAAA,EAAS;AAAA,UACP,KAAA,EAAO;AAAA,SACT;AAAA,QACA,eAAA,EAAiB;AAAA,UACf,6BAAA,EAA+B,IAAI,OAAO,CAAA;AAAA;AAC5C,OACF;AAAA,MACA,IAAA;AAAA,MACA;AAAA,KACD;AAAA,CAAI,CAAA;AAAA,IACL,CAAC,cAAc,wBAAwB,CAAA;AAAA,IACvC,CAAC,oCAAA,EAAsC,eAAA,EAAiB,CAAA;AAAA,IACxD,CAAC,sCAAA,EAAwC,UAAA,CAAW,IAAI,CAAC,CAAA;AAAA,IACzD,CAAC,CAAA,6CAAA,CAAA,EAAiD,cAAA,CAAe,IAAI,CAAC,CAAA;AAAA,IACtE,CAAC,WAAA,EAAa,UAAA,CAAW,IAAI,CAAC;AAAA,GAChC;AAEA,EAAA,IAAI;AACF,IAAA,KAAA,MAAW,CAAC,GAAA,EAAK,OAAO,CAAA,IAAK,KAAA,EAAO;AAClC,MAAA,MAAM,MAAA,GAAS,IAAA,CAAK,GAAA,EAAK,GAAG,CAAA;AAC5B,MAAA,SAAA,CAAU,QAAQ,MAAM,CAAA,EAAG,EAAE,SAAA,EAAW,MAAM,CAAA;AAC9C,MAAA,aAAA,CAAc,MAAA,EAAQ,SAAS,OAAO,CAAA;AAAA,IACxC;AAAA,EACF,SAAS,KAAA,EAAO;AACd,IAAA,MAAA,CAAO,KAAK,EAAE,SAAA,EAAW,IAAA,EAAM,KAAA,EAAO,MAAM,CAAA;AAC5C,IAAA,MAAM,KAAA;AAAA,EACR;AACA,EAAA,OAAO,EAAE,GAAA,EAAK,KAAA,EAAO,KAAA,CAAM,GAAA,CAAI,CAAC,CAAC,GAAG,CAAA,KAAM,GAAG,CAAA,EAAE;AACjD","file":"scaffoldFeed-TCRNXYQU.mjs","sourcesContent":["/**\n * `wod init-feed <name>` — scaffold a ready-to-publish WOD Wiki feed\n * repository skeleton (the publisher-repository contract in\n * docs/adrs/0001-feed-seed-data-contract.md): a markdown notebooks example,\n * package.json, GitHub Actions Pages workflow, README. Creates a new\n * directory only; refuses an existing destination without touching it.\n *\n * Lazily imported by cli/runner.ts (dynamic import), so static node:fs/node:path\n * imports stay out of browser bundles.\n */\nimport { mkdirSync, rmSync, writeFileSync } from 'node:fs';\nimport { dirname, join, resolve } from 'node:path';\nimport { VERSION } from '../version';\n\nexport interface ScaffoldFeedResult {\n  /** Absolute path of the created feed root. */\n  dir: string;\n  /** Created files, POSIX-relative to the feed root. */\n  files: string[];\n}\n\n/** npm package name + single-directory-segment validation for `<name>`. */\nexport function validateFeedName(name: string): string {\n  if (name.length === 0 || name === '.' || name === '..') {\n    throw new Error('Feed name must be a single non-empty directory name');\n  }\n  if (name.includes('/') || name.includes('\\\\') || name.includes('\\0')) {\n    throw new Error(`Invalid feed name '${name}': must be a single directory name (no path separators or traversal)`);\n  }\n  if (/^(?:[A-Za-z]:)?[/\\\\]/.test(name)) {\n    throw new Error(`Invalid feed name '${name}': absolute paths are not allowed`);\n  }\n  if (name.length > 214 || !/^[a-z0-9][a-z0-9._-]*$/.test(name)) {\n    throw new Error(\n      `Invalid feed name '${name}': must be a valid npm package name ` +\n      '(lowercase letters, digits, dots, hyphens, underscores; no leading dot/hyphen)',\n    );\n  }\n  return name;\n}\n\nconst publishWorkflow = (): string => `name: Publish feed\n\n# Compile the feed with the wod CLI and deploy dist/ to GitHub Pages.\n# Requires Pages enabled: repo Settings → Pages → Source: \"GitHub Actions\".\n\non:\n  push:\n    branches: [main]\n  workflow_dispatch:\n\npermissions:\n  contents: read\n  pages: write\n  id-token: write\n\nconcurrency:\n  group: pages\n  cancel-in-progress: true\n\njobs:\n  publish:\n    runs-on: ubuntu-latest\n    environment:\n      name: github-pages\n      url: \\${{ steps.deployment.outputs.page_url }}\n    steps:\n      - uses: actions/checkout@v4\n        with:\n          # Full history: seed manifest version stamps derive from git commit count.\n          fetch-depth: 0\n\n      - name: Set up Bun\n        uses: oven-sh/setup-bun@v2\n        with:\n          bun-version: 1.4.x\n\n      - name: Install dependencies\n        run: bun install\n\n      - name: Build seed\n        run: bunx wod build . --output dist\n\n      - uses: actions/configure-pages@v5\n\n      - name: Upload dist\n        uses: actions/upload-pages-artifact@v3\n        with:\n          path: dist\n\n      - id: deployment\n        uses: actions/deploy-pages@v4\n`;\n\nconst feedReadme = (name: string): string => `# ${name}\n\nExample benchmark notebook. Each \\`.md\\` file in this directory becomes part of\nthe \\`example\\` notebook chunk; \\`README.md\\` is the notebook's landing page.\n\nAdd one file per workout:\n\n\\`\\`\\`\\`markdown\n---\ntitle: My workout\ndate: 2026-01-01\n---\n\n# My workout\n\n\\`\\`\\`time\n(21-15-9)\n  Thrusters @95lb\n  Pull-ups\n\\`\\`\\`\n\\`\\`\\`\\`\n\nThe \\`date:\\` frontmatter field sets the workout's chronological placement\n(regardless of filename or directory).\n`;\n\nconst exampleWorkout = (date: string): string => `---\ntitle: Morning session\ndate: ${date}\n---\n\n# Morning session\n\n\\`\\`\\`time\n(21-15-9)\n  Thrusters @95lb\n  Pull-ups\n\\`\\`\\`\n`;\n\nconst repoReadme = (name: string): string => `# ${name}\n\nA [WOD Wiki](https://github.com/bitcobblers/wod-wiki) workout feed: plain\nMarkdown workouts compiled to static, version-stamped seed chunks and published\nvia GitHub Pages.\n\n## Develop\n\n\\`\\`\\`sh\nbun install\nbunx wod build . --output dist\n\\`\\`\\`\n\nWorkouts live under \\`markdown/\\` — this scaffold starts with one example\nfeed. Validate everything with \\`bunx wod build\\`: it gates every file on\nthe Whiteboard grammar and corpus layout before writing \\`dist/\\`.\n\n## Publish\n\nPush to GitHub and enable Pages (**Settings → Pages → Source: GitHub\nActions**). The bundled workflow (\\`.github/workflows/publish-feed.yml\\`)\nbuilds the feed on every push to \\`main\\` and deploys \\`dist/\\`.\n\n## Share\n\nOnce published, anyone can subscribe to this feed from a WOD Wiki instance\nat:\n\n\\`\\`\\`\n<app-url>/subscribe?source=<url-encoded published feed URL>\n\\`\\`\\`\n\nFor \\`owner\\`/\\`repo\\` on GitHub Pages the feed URL is the deployed\ndirectory, \\`https://owner.github.io/repo/\\`, e.g.\n\\`/subscribe?source=https%3A%2F%2Fowner.github.io%2Frepo%2F\\`.\n`;\n\n/**\n * Scaffold a new feed repository at `<cwd>/<name>`. Throws when the name is\n * invalid or the destination already exists; partial failure removes created files.\n */\nexport function scaffoldFeed(name: string, opts: { cwd?: string } = {}): ScaffoldFeedResult {\n  validateFeedName(name);\n  const dir = resolve(opts.cwd ?? process.cwd(), name);\n  // Atomic acquire: EEXIST is the refusal signal — no exists-check/create race,\n  // and an existing destination is never removed or written.\n  try {\n    mkdirSync(dir);\n  } catch (error) {\n    if ((error as NodeJS.ErrnoException).code === 'EEXIST') {\n      throw new Error(`Refusing to overwrite '${dir}': destination already exists`, { cause: error });\n    }\n    throw error;\n  }\n\n  const date = new Date().toISOString().slice(0, 10);\n  const files: Array<[rel: string, content: string]> = [\n    ['package.json', `${JSON.stringify(\n      {\n        name,\n        version: '0.1.0',\n        private: true,\n        type: 'module',\n        description: `WOD Wiki workout feed: ${name}`,\n        scripts: {\n          build: 'wod build . --output dist',\n        },\n        devDependencies: {\n          '@bitcobblers/wod-wiki-tools': `^${VERSION}`,\n        },\n      },\n      null,\n      2,\n    )}\\n`],\n    ['.gitignore', 'node_modules/\\ndist/\\n'],\n    ['.github/workflows/publish-feed.yml', publishWorkflow()],\n    ['markdown/notebooks/example/README.md', feedReadme(name)],\n    [`markdown/notebooks/example/morning-session.md`, exampleWorkout(date)],\n    ['README.md', repoReadme(name)],\n  ];\n\n  try {\n    for (const [rel, content] of files) {\n      const target = join(dir, rel);\n      mkdirSync(dirname(target), { recursive: true });\n      writeFileSync(target, content, 'utf-8');\n    }\n  } catch (error) {\n    rmSync(dir, { recursive: true, force: true });\n    throw error;\n  }\n  return { dir, files: files.map(([rel]) => rel) };\n}\n"]}

package/dist/skills/README.md

@@ -6,10 +6,8 @@ Agent skills shipped with the WOD Wiki toolchain. One directory per skill:
 skills/<name>/SKILL.md      # frontmatter: name, description (agentskills.io format)
 ```
 
-`wod-extraction` is the parsing skill: it teaches an agent to read a workout
-description in any form and write correct Whiteboard Script (which metrics a
-workout implies, the collectible `?` placeholders, statement structure).
-
+- `wod-extraction` — the parsing skill: teaches an agent to read a workout description in any form and write Whiteboard Script (which metrics a workout implies, the collectible `?` placeholders, statement structure).
+- `wod-wiki-testing` — the 3-tier repo testing skill: routes agents across Tier 1 domain scenarios (`@bitcobblers/wod-wiki-core/testing` + `DomainScenarioHarness`), Tier 2 Storybook `parameters.domainState` + `storyActions` and Playground `@/testing/host`, and Tier 3 two-level Markdown specs (`e2e/specs/`) + Playwright `PlaygroundTestActor` (`e2e/fixtures/playgroundActor.ts`), mirrored into `.agents/skills/wod-wiki-testing/`.
 ## Install
 
 | Path | Command | Result |

package/dist/skills/wod-wiki-testing/SKILL.md

@@ -0,0 +1,45 @@
+---
+name: wod-wiki-testing
+description: Use when writing, debugging, or updating tests in wod-wiki across domain logic, Playground UI, Storybook states and play() scripts, or Markdown specs and Playwright E2E journeys.
+---
+
+# WOD Wiki testing
+
+Pick the lowest tier that exercises the behavior, then compose the existing module for that tier from [`references/catalog.md`](references/catalog.md). Read `docs/development/validation.md` for merge and preview gates.
+
+## 1. Pick the tier
+
+| Behavior under test | Tier | Seam to compose | Runner |
+|---|---|---|---|
+| Parsing, `Metric Shake-Out Queue`, `Scoped Property Override` precedence, `Session` intake, `Note Provenance`, WQL `Entity Scope`, `Feed` and `Seed` round-trips | **Tier 1: Domain scenario** | `DomainScenarioHarness` (`packages/engine/tests/harness/DomainScenarioHarness.ts`) + `@bitcobblers/wod-wiki-core/testing` + `.md` scenario tables | `bun run test:package` |
+| Isolated UI rendering, empty/populated/override/diagnostic/`Feed` states, dialog/sheet/widget interactions | **Tier 2: Storybook state + `play()`** | `parameters.domainState` + `storyActions` (`apps/storybook/src/testing/storyActions.ts`) | `bun run test:storybook` |
+| Playground route/hook integration in memory without a browser | **Tier 2b: Playground host** | `renderWithPlaygroundHost` / `setupPlaygroundTestHost` (`apps/playground/src/testing/host.tsx`) | `bun run test:playground:unit` |
+| Multi-route user journeys, URL survival, persistence across reloads, desktop + 375x812 layout gates | **Tier 3: Markdown journey + Playwright** | `e2e/specs/<domain>/<journey>.md` + `PlaygroundTestActor` (`e2e/fixtures/playgroundActor.ts`) | `bun x playwright test --config playwright.journal.config.ts <spec>` |
+
+## 2. Authoring workflow by tier
+
+### Tier 1: Business-language domain scenarios
+
+1. Add a pure Markdown fixture when testing WQL (`packages/wql/tests/fixtures/scenarios/`) or parser snapshots (`packages/lang/tests/fixtures/`); zero TypeScript changes needed.
+2. For cross-domain flows (`Note` -> `Property Note` -> `Metric Shake-Out Queue` -> `Session` -> WQL -> `Feed`), instantiate `DomainScenarioHarness.create()` in `packages/engine/tests/domain/` and call `afterEach(() => harness.dispose())`.
+3. Build fixtures through `buildTestNote`, `buildPropertyNote`, `buildTestSession`, and `buildDomainWorld` from `@bitcobblers/wod-wiki-core/testing` (`packages/core/src/testing.ts`).
+4. For low-level runtime block or JIT strategy checks inside `packages/engine`, use `BehaviorTestHarness`, `MockBlock`, and `ExecutionContextTestHarness` from `packages/engine/tests/harness/`.
+
+### Tier 2: Storybook states and Playground host tests
+
+1. In `apps/storybook/src/`, set `parameters: { domainState: '<preset>' }` (`empty`, `populatedJournal`, `activeSession`, `scopedPropertyOverride`, `skippedDependencyDiagnostic`, or `readOnlyFeedNote`) or pass a custom `DomainWorldInput` (`apps/storybook/src/testing/domainStates.tsx`). Reserve `parameters: { database: true }` strictly for `apps/storybook/src/database/Database.stories.tsx` and the live IndexedDB workbench pages.
+2. Script isolated interactions in `play({ canvasElement })` using `storyActions` (`apps/storybook/src/testing/storyActions.ts`) and `TEST_IDS` (`apps/playground/src/lib/testIds.ts`).
+3. In `apps/playground`, mount UI and hooks through `renderWithPlaygroundHost` or `setupPlaygroundTestHost` (`apps/playground/src/testing/host.tsx`). Inject optional `deps` or adapter props on external SDKs (`ChromecastBackend`, `AudioProvider`) rather than global module mocks so the warm Vitest worker pool stays clean.
+
+### Tier 3: Two-level Markdown journeys and Playwright
+
+1. Write or update `e2e/specs/<domain>/<journey>.md` first (`journal`, `notebooks`, `runtime`, `properties`, `analytics`, `feeds`): YAML frontmatter (`domain`, `specFile`, `routes`, `personas`, `viewports`, `priority`), `### Scenario N: <title>` headings, `Given <GLOSSARY.md world setup>:`, numbered user steps, and `- expect:` outcome bullets.
+2. Start `e2e/live-app/<journey>.e2e.ts` with `// spec: e2e/specs/<domain>/<journey>.md` and import `{ test, expect, TEST_IDS } from '../fixtures/playgroundActor'`.
+3. Drive all seeding, navigation, editing, timer advancement, WQL queries, and Feed operations through the 8 actor namespaces (`app.seed`, `app.journal`, `app.notebooks`, `app.properties`, `app.editor`, `app.runtime`, `app.wql`, `app.feeds`) backed by `TEST_IDS`.
+4. Verify 1:1 bidirectional spec parity with `bun scripts/check-e2e-specs.ts`.
+
+## 3. Token-lean execution and log watching
+
+- Look up exact builder, state-preset, and actor method signatures in [`references/catalog.md`](references/catalog.md) instead of scanning `e2e/live-app/` or `apps/playground/` for examples.
+- Delegate test suite runs and log inspection to a low-reasoning flash subagent (`sonic`): redirect suite output to `/tmp/<run>.log`, verify exit status, and return only pass/fail totals, warnings, and failing stack excerpts.
+- Always pass `--noEmit` when invoking `tsc` directly.

package/dist/skills/wod-wiki-testing/references/catalog.md

@@ -0,0 +1,81 @@
+# WOD Wiki test module catalog
+
+Copy-ready imports and interfaces across all three tiers.
+
+## 1. Canonical domain builders (`@bitcobblers/wod-wiki-core/testing`)
+
+Source: `packages/core/src/testing.ts`
+
+```ts
+import {
+  buildTestNote,
+  buildPropertyNote,
+  buildTestSession,
+  buildDomainWorld,
+  resetTestingVocabulary,
+} from '@bitcobblers/wod-wiki-core/testing';
+```
+
+- `buildTestNote({ id?, title?, rawContent, type?, date?, tags?, notebookId?, notebookIds?, seedOrigin?, feedOrigin?, feedSourceId?, sourceId?, sourcePath?, provenance?, priorBlocks? })` -> `{ note, revisions, blockIndex, blockEfforts, blockEquipment, tags, noteTags, notebookLinks }`
+- `buildPropertyNote({ id?, kind: 'effort' | 'equipment' | 'tag' | 'tag-type', slug, label, notebookId?, aliases?, metrics?, summaries?, baseAttributes?, body?, asOverride?, feedSourceId? })` -> `{ note, override? }`
+- `buildTestSession({ id?, noteId, blockId?, blockVersion?, startedAt?, completedAt?, durationMs?, origin?, isPublic?, notebookIds?, events? })` -> `{ session, events, notebookLinks }`
+- `buildDomainWorld({ notes?, propertyNotes?, sessions?, pages?, pageNotes? })` -> `DomainWorld`
+
+## 2. Engine domain scenario harness (`packages/engine/tests/harness/DomainScenarioHarness.ts`)
+
+```ts
+import { DomainScenarioHarness } from '../harness/DomainScenarioHarness';
+```
+
+- `await DomainScenarioHarness.create(initialWorld?)` -> live `SqlStorage(':memory:')` + `QueryService`
+- `await harness.authorNote(input)` / `await harness.definePropertyNote(input)` / `await harness.saveScopedOverride(input)` / `await harness.promoteNote({ noteId, notebookIds, sessionIds?, shareSessionsPublicly? })`
+- `await harness.evaluateShakeOut({ metrics, stage?: 'plan' | 'log', elapsedMs?, sources?, scope?, mode?: 'source-first' | 'custom-runtime' })` -> `{ container, result, diagnostics, values }`
+- `await harness.prepareAndRunSession({ noteId, blockId?, sessionId?, journalDate?, startedAt?, advances?, maxNexts? })` -> `{ sessionId, noteId, session, outputs, events, clonedFromReadOnly, provenance, upstream }`
+- `await harness.queryWql(wql, options?)` / `harness.resolveEntityScope(entity)`
+- `await harness.publishFeed(options?)` -> `{ tree, report }` / `await harness.importFeedIntoFreshHarness(tree, sourceId?)`
+- `await harness.dispose()`
+
+## 3. Playground in-memory host (`apps/playground/src/testing/host.tsx`)
+
+```ts
+import {
+  hydratePlaygroundStorage,
+  setupPlaygroundTestHost,
+  renderWithPlaygroundHost,
+  PlaygroundProviderTree,
+} from '@/testing/host';
+```
+
+- `await setupPlaygroundTestHost({ world?, storage?, localStorageEntries? })` -> `{ world, storage, storageService, queryService, notePersistence, notebookService, cleanup }`
+- `await renderWithPlaygroundHost(ui, { world?, route?, routePath?, searchParams?, theme?, panelSize? })` -> `{ rendered, world, storage, storageService, queryService, getLocation, urlUpdates, cleanup }`
+
+## 4. Storybook domain states & actions (`apps/storybook/src/testing/storyActions.ts`)
+
+State presets live in `apps/storybook/src/testing/domainStates.tsx`:
+
+```ts
+import { storyActions } from './testing/storyActions';
+```
+
+- `parameters.domainState`: `'empty'` | `'populatedJournal'` | `'activeSession'` | `'scopedPropertyOverride'` | `'skippedDependencyDiagnostic'` | `'readOnlyFeedNote'` | `DomainWorldInput`
+- `storyActions`: `withinStory(canvasElement)`, `waitForHydrated(canvasElement)`, `selectOverrideScope(canvasOrBody, targetNotebookId)`, `toggleNotebookPromotion(canvasOrBody, notebookId)`, `toggleNotebookPublic(canvasOrBody, slugOrNotebookId?)`, `toggleSessionPublic(canvasOrBody, sessionId)`, `selectSessionRow(canvas, titleOrId)`
+
+## 5. Playwright domain actor (`e2e/fixtures/playgroundActor.ts`)
+
+Canonical `data-testid` contract: `apps/playground/src/lib/testIds.ts` (re-exported at `e2e/contracts/TestIdContract.ts`).
+
+```ts
+// spec: e2e/specs/<domain>/<journey>.md
+import { test, expect, TEST_IDS } from '../fixtures/playgroundActor';
+```
+
+- `await app.goto(path)` (navigates and awaits `waitForFeedReady`)
+- `app.seed`: `world(input)`, `journalNote(date, markdown, opts?)`, `note(noteId, markdown, opts?)`, `notebook(slug, opts?)`, `propertyOverride(input)`, `completedSessions(noteId, sessions)`, `bundledEquipment()`, `bundledEfforts()`, `mockPeerFeed(baseUrl, spec)`
+- `app.journal`: `openStream(query?)`, `openDate(date)`, `clearDate(date)`, `expectNotePersisted(routeId, expectedSubstring)`
+- `app.notebooks`: `openLibrary(query?)`, `openNotebook(slug, target?)`, `create(name, description?)`, `rename(slug, newName)`, `delete(slug)`, `promoteNote(notebookIds)`, `setNotebookPublic(slugOrId, isPublic)`
+- `app.properties`: `openEffort(slug?)`, `openEquipment(slug?)`, `openTags(category?, slug?)`, `saveScopedOverride(targetNotebookId)`
+- `app.editor`: `openNote(noteId)`, `replaceDocument(markdown)`, `readDocument()`, `typeLine(text)`, `readStoredContent(routeId)`
+- `app.runtime`: `useFastClock(speedFactor?)`, `startWorkout()`, `advance(steps?)`, `stopSession()`, `wallClock()`
+- `app.wql`: `openExplorer(query?)`, `openDashboard(slug)`, `queryStream(route, wql)`, `fillStreamQueryBar(wql)`, `setStreamLayout(route, layout)`, `expectStreamContains(text)`, `expectStreamExcludes(text)`
+- `app.feeds`: `waitForReady()`, `openFeeds()`, `syncNow(feedId)`, `openPromotionPopover()`, `closePromotionPopover()`, `setSessionPublic(sessionId, isPublic)`, `expectPublicationVisibility(expected)`, `exportPortable('feed-repo-zip')`
+- `app.assertCleanConsole()`