@bitcobblers/wod-wiki-tools 0.50.2186 → 0.50.2188

package/dist/index.mjs

@@ -1,7 +1,7 @@
 import { createRequire } from 'module';
-export { PackLoadError, ParseSyntaxError, WqlSyntaxError, cliMain, formatExecutionOutput, formatParseOutput, formatQueryOutput, loadCliEnvironment, loadLanguagePack, loadQueryData, parseCliArgs, readStdin, resolveDatabaseConfig, runExecution, runParse, runQueryCli } from './chunk-OJUR7URM.mjs';
+export { PackLoadError, ParseSyntaxError, WqlSyntaxError, cliMain, formatExecutionOutput, formatParseOutput, formatQueryOutput, loadCliEnvironment, loadLanguagePack, loadQueryData, parseCliArgs, readStdin, resolveDatabaseConfig, runExecution, runParse, runQueryCli } from './chunk-BJCJ5EKB.mjs';
 import './chunk-MKGVKC2X.mjs';
-import './chunk-5USOYO6L.mjs';
+import './chunk-DGVIILUP.mjs';
 export { runCliServer } from './chunk-Z2IQPTDI.mjs';
 export { openCliDb } from './chunk-ZUZMRH3G.mjs';
 import './chunk-V23POHG2.mjs';

package/dist/{scaffoldFeed-EXE5W7TU.mjs → scaffoldFeed-3XWNVDZV.mjs}

@@ -1,5 +1,5 @@
 import { createRequire } from 'module';
-import { VERSION } from './chunk-5USOYO6L.mjs';
+import { VERSION } from './chunk-DGVIILUP.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-EXE5W7TU.mjs.map
-//# sourceMappingURL=scaffoldFeed-EXE5W7TU.mjs.map
+//# sourceMappingURL=scaffoldFeed-3XWNVDZV.mjs.map
+//# sourceMappingURL=scaffoldFeed-3XWNVDZV.mjs.map

package/dist/{scaffoldFeed-EXE5W7TU.mjs.map → scaffoldFeed-3XWNVDZV.mjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/cli/scaffoldFeed.ts"],"names":[],"mappings":"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","file":"scaffoldFeed-EXE5W7TU.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":"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","file":"scaffoldFeed-3XWNVDZV.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"]}