@bitcobblers/wod-wiki-tools 0.36.2135 → 0.37.2137

package/dist/index.cjs

@@ -160,7 +160,7 @@ function sqliteEventStore(db) {
     getEventsByTimeRange: async (start, end) => (await all()).filter((r) => r.timestamp >= start && r.timestamp <= end),
     getEventsByResult: async (resultId) => (await all()).filter((r) => r.resultId === resultId),
     getEventsForNote: async (noteId) => (await all()).filter((r) => r.noteId === noteId),
-    getEventsByContent: async (blockContentId4) => (await all()).filter((r) => r.blockContentId === blockContentId4),
+    getEventsByContent: async (blockContentId5) => (await all()).filter((r) => r.blockContentId === blockContentId5),
     scanAll: all,
     appendEvents: async (appended) => {
       const sql = await loadSql();
@@ -613,6 +613,31 @@ var init_report = __esm({
   "src/seedbuild/report.ts"() {
   }
 });
+function object(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function nonnegative(value) {
+  return typeof value === "number" && Number.isSafeInteger(value) && value >= 0;
+}
+function assertSeedManifest2(value) {
+  if (!object(value) || value.schema !== SEED_SCHEMA2) throw new Error("Incompatible seed schema; rebuild seed artifacts");
+  if (!nonnegative(value.version) || typeof value.builtAt !== "string" || !Number.isFinite(Date.parse(value.builtAt)) || !Array.isArray(value.chunks)) throw new Error("seed manifest failed shape validation");
+  for (const key of ["versionLabel", "commit", "name", "description"]) if (value[key] !== void 0 && typeof value[key] !== "string") throw new Error("invalid seed manifest metadata");
+  if (value.repositoryUrl !== void 0 && (typeof value.repositoryUrl !== "string" || !/^https:\/\//.test(value.repositoryUrl) || new URL(value.repositoryUrl).username || new URL(value.repositoryUrl).password)) throw new Error("invalid seed repository URL");
+  if (value.dirty !== void 0 && typeof value.dirty !== "boolean") throw new Error("invalid seed manifest metadata");
+  const ids = /* @__PURE__ */ new Set(), paths = /* @__PURE__ */ new Set();
+  for (const chunk of value.chunks) {
+    if (!object(chunk) || typeof chunk.id !== "string" || !chunk.id || typeof chunk.path !== "string" || !/^chunks\/[a-zA-Z0-9._-]+\.json$/.test(chunk.path) || typeof chunk.sha256 !== "string" || !/^[0-9a-f]{64}$/.test(chunk.sha256) || !nonnegative(chunk.bytes) || !nonnegative(chunk.count) || chunk.kind !== void 0 && chunk.kind !== "notes" || ids.has(chunk.id) || paths.has(chunk.path)) throw new Error("seed manifest failed shape validation");
+    ids.add(chunk.id);
+    paths.add(chunk.path);
+  }
+  return value;
+}
+var init_validation = __esm({
+  "src/seedbuild/validation.ts"() {
+    init_contract();
+  }
+});
 
 // src/seedbuild/compiler.ts
 var compiler_exports = {};
@@ -624,6 +649,7 @@ __export(compiler_exports, {
   compileSeedRow: () => compileSeedRow,
   discoverUncatalogedEfforts: () => discoverUncatalogedEfforts,
   feedDateToCreatedAt: () => feedDateToCreatedAt,
+  frontmatterDateToCreatedAt: () => frontmatterDateToCreatedAt,
   generateSeed: () => generateSeed,
   loadExistingEffortMap: () => loadExistingEffortMap,
   partitionIntoChunks: () => partitionIntoChunks,
@@ -725,6 +751,18 @@ function getFileCreatedAt(file, repoRoot) {
     return 0;
   }
 }
+function frontmatterDateToCreatedAt(raw, path) {
+  const value = getScalar(parseFrontmatter(raw).meta, "date");
+  if (value === void 0 || value === "") return void 0;
+  const text = String(value);
+  const parts = text.match(/^(\d{4})-(\d{2})-(\d{2})$/);
+  const ts = parts ? Date.parse(`${text}T12:00:00Z`) : NaN;
+  const valid = !!parts && Number.isFinite(ts) && new Date(ts).getUTCMonth() === Number(parts[2]) - 1 && new Date(ts).getUTCDate() === Number(parts[3]);
+  if (!valid) {
+    throw new Error(`[wod build] invalid frontmatter date '${text}' in '${path}' \u2014 expected a real calendar day (YYYY-MM-DD)`);
+  }
+  return ts;
+}
 function feedDateToCreatedAt(dateKey) {
   if (!/^\d{4}-\d{2}-\d{2}$/.test(dateKey)) return 0;
   const ts = Date.parse(`${dateKey}T00:00:00Z`);
@@ -752,7 +790,7 @@ function buildBlockIndexRows(markdownDir, corpusRoot) {
     const catalog = parts[2];
     const routeId = chunkId === "canvas" ? canvasRouteSlug(content) ?? void 0 : chunkId.startsWith("collection.") ? stem.toLowerCase() === "readme" ? catalog : `${catalog}/${stem}` : chunkId.startsWith("feed.") ? parts.slice(1).join("/").replace(/\.md$/, "") : void 0;
     const sourceId = seedNoteSourceId(path$1, content, chunkId);
-    const createdAt = chunkId.startsWith("feed.") ? feedDateToCreatedAt(parts.at(-2) ?? "") : getFileCreatedAt(path$1, corpusRoot);
+    const createdAt = frontmatterDateToCreatedAt(content, path$1) ?? (chunkId.startsWith("feed.") ? feedDateToCreatedAt(parts.at(-2) ?? "") : getFileCreatedAt(path$1, corpusRoot));
     rows.push(...compileSeedRow(path$1, content, { routeId, sourceId, createdAt }).blockIndex);
   }
   return rows;
@@ -912,6 +950,13 @@ function generateSeed(options = {}) {
   const markdownDir = options.markdownDir ?? path.join(corpusRoot, "markdown");
   const outDir = options.outDir ?? path.join(corpusRoot, "dist");
   const gitVersion = options.version !== void 0 ? { ...resolveGitVersion(corpusRoot), version: options.version } : resolveGitVersion(corpusRoot);
+  const packageFile = path.join(corpusRoot, "package.json");
+  const packageMetadata = fs.existsSync(packageFile) ? JSON.parse(fs.readFileSync(packageFile, "utf8")) : {};
+  const metadata = packageMetadata && typeof packageMetadata === "object" ? packageMetadata : {};
+  const repository = "repository" in metadata ? metadata.repository : void 0;
+  const repositoryUrl = typeof repository === "string" ? repository : repository && typeof repository === "object" && "url" in repository && typeof repository.url === "string" ? repository.url : void 0;
+  const webRepositoryUrl = repositoryUrl?.replace(/^git\+/, "").replace(/\.git$/, "");
+  const repositoryLink = webRepositoryUrl && URL.canParse(webRepositoryUrl) ? new URL(webRepositoryUrl) : void 0;
   if (options.scaffoldDiscoveredEfforts) {
     const discovered = discoverUncatalogedEfforts(markdownDir, corpusRoot);
     if (discovered.length > 0) {
@@ -980,6 +1025,9 @@ ${shown}${more}`);
   }
   passMs.write = Date.now() - tWrite;
   const manifest = {
+    name: "name" in metadata && typeof metadata.name === "string" ? metadata.name : void 0,
+    description: "description" in metadata && typeof metadata.description === "string" ? metadata.description : void 0,
+    repositoryUrl: repositoryLink?.protocol === "https:" && !repositoryLink.username && !repositoryLink.password ? repositoryLink.href : void 0,
     schema: SEED_SCHEMA2,
     version: gitVersion.version,
     versionLabel: gitVersion.versionLabel,
@@ -988,6 +1036,7 @@ ${shown}${more}`);
     builtAt: (/* @__PURE__ */ new Date()).toISOString(),
     chunks: manifestChunks
   };
+  assertSeedManifest2(manifest);
   fs.writeFileSync(path.join(outDir, "manifest.json"), JSON.stringify(manifest, null, 2) + "\n");
   const reportPath = writeBuildReport(outDir, {
     manifest,
@@ -1006,6 +1055,7 @@ var init_compiler = __esm({
     init_git_version();
     init_report();
     init_frontmatter();
+    init_validation();
     NON_EFFORT_SLUGS = {
       "amrap": true,
       "emom": true,
@@ -1055,6 +1105,219 @@ var init_compiler = __esm({
   }
 });
 
+// src/version.ts
+var VERSION;
+var init_version = __esm({
+  "src/version.ts"() {
+    VERSION = "0.37.2137";
+  }
+});
+
+// src/cli/scaffoldCatalog.ts
+var scaffoldCatalog_exports = {};
+__export(scaffoldCatalog_exports, {
+  scaffoldCatalog: () => scaffoldCatalog,
+  validateCatalogName: () => validateCatalogName
+});
+function validateCatalogName(name) {
+  if (name.length === 0 || name === "." || name === "..") {
+    throw new Error("Catalog name must be a single non-empty directory name");
+  }
+  if (name.includes("/") || name.includes("\\") || name.includes("\0")) {
+    throw new Error(`Invalid catalog name '${name}': must be a single directory name (no path separators or traversal)`);
+  }
+  if (/^(?:[A-Za-z]:)?[/\\]/.test(name)) {
+    throw new Error(`Invalid catalog name '${name}': absolute paths are not allowed`);
+  }
+  if (name.length > 214 || !/^[a-z0-9][a-z0-9._-]*$/.test(name)) {
+    throw new Error(
+      `Invalid catalog name '${name}': must be a valid npm package name (lowercase letters, digits, dots, hyphens, underscores; no leading dot/hyphen)`
+    );
+  }
+  return name;
+}
+function scaffoldCatalog(name, opts = {}) {
+  validateCatalogName(name);
+  const dir = path.resolve(opts.cwd ?? process.cwd(), name);
+  try {
+    fs.mkdirSync(dir);
+  } catch (error) {
+    if (error.code === "EEXIST") {
+      throw new Error(`Refusing to overwrite '${dir}': destination already exists`, { cause: error });
+    }
+    throw error;
+  }
+  const date = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+  const files = [
+    ["package.json", `${JSON.stringify(
+      {
+        name,
+        version: "0.1.0",
+        private: true,
+        type: "module",
+        description: `WOD Wiki workout catalog: ${name}`,
+        scripts: {
+          build: "wod build . --output dist"
+        },
+        devDependencies: {
+          "@bitcobblers/wod-wiki-tools": `^${VERSION}`
+        }
+      },
+      null,
+      2
+    )}
+`],
+    [".gitignore", "node_modules/\ndist/\n"],
+    [".github/workflows/publish-catalog.yml", publishWorkflow()],
+    ["markdown/collections/example/README.md", collectionReadme(name)],
+    [`markdown/collections/example/morning-session.md`, exampleWorkout(date)],
+    ["README.md", catalogReadme(name)]
+  ];
+  try {
+    for (const [rel, content] of files) {
+      const target = path.join(dir, rel);
+      fs.mkdirSync(path.dirname(target), { recursive: true });
+      fs.writeFileSync(target, content, "utf-8");
+    }
+  } catch (error) {
+    fs.rmSync(dir, { recursive: true, force: true });
+    throw error;
+  }
+  return { dir, files: files.map(([rel]) => rel) };
+}
+var publishWorkflow, collectionReadme, exampleWorkout, catalogReadme;
+var init_scaffoldCatalog = __esm({
+  "src/cli/scaffoldCatalog.ts"() {
+    init_version();
+    publishWorkflow = () => `name: Publish catalog
+
+# Compile the catalog with the wod CLI and deploy dist/ to GitHub Pages.
+# Requires Pages enabled: repo Settings \u2192 Pages \u2192 Source: "GitHub Actions".
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: true
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: \${{ steps.deployment.outputs.page_url }}
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          # Full history: seed manifest version stamps derive from git commit count.
+          fetch-depth: 0
+
+      - name: Set up Bun
+        uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: 1.4.x
+
+      - name: Install dependencies
+        run: bun install
+
+      - name: Build seed
+        run: bunx wod build . --output dist
+
+      - uses: actions/configure-pages@v5
+
+      - name: Upload dist
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: dist
+
+      - id: deployment
+        uses: actions/deploy-pages@v4
+`;
+    collectionReadme = (name) => `# ${name}
+
+Example benchmark collection. Each \`.md\` file in this directory becomes part of
+the \`example\` collection chunk; \`README.md\` is the collection's landing page.
+
+Add one file per workout:
+
+\`\`\`\`markdown
+---
+title: My workout
+date: 2026-01-01
+---
+
+# My workout
+
+\`\`\`time
+(21-15-9)
+  Thrusters @95lb
+  Pull-ups
+\`\`\`
+\`\`\`\`
+
+The \`date:\` frontmatter field sets the workout's chronological placement
+(regardless of filename or directory).
+`;
+    exampleWorkout = (date) => `---
+title: Morning session
+date: ${date}
+---
+
+# Morning session
+
+\`\`\`time
+(21-15-9)
+  Thrusters @95lb
+  Pull-ups
+\`\`\`
+`;
+    catalogReadme = (name) => `# ${name}
+
+A [WOD Wiki](https://github.com/bitcobblers/wod-wiki) workout catalog: plain
+Markdown workouts compiled to static, version-stamped seed chunks and published
+via GitHub Pages.
+
+## Develop
+
+\`\`\`sh
+bun install
+bunx wod build . --output dist
+\`\`\`
+
+Workouts live under \`markdown/\` \u2014 this scaffold starts with one example
+collection. Validate everything with \`bunx wod build\`: it gates every file on
+the Whiteboard grammar and corpus layout before writing \`dist/\`.
+
+## Publish
+
+Push to GitHub and enable Pages (**Settings \u2192 Pages \u2192 Source: GitHub
+Actions**). The bundled workflow (\`.github/workflows/publish-catalog.yml\`)
+builds the catalog on every push to \`main\` and deploys \`dist/\`.
+
+## Share
+
+Once published, anyone can subscribe to this catalog from a WOD Wiki instance
+at:
+
+\`\`\`
+<app-url>/subscribe?source=<url-encoded published catalog URL>
+\`\`\`
+
+For \`owner\`/\`repo\` on GitHub Pages the catalog URL is the deployed
+directory, \`https://owner.github.io/repo/\`, e.g.
+\`/subscribe?source=https%3A%2F%2Fowner.github.io%2Frepo%2F\`.
+`;
+  }
+});
+
 // src/server/errors.ts
 var HttpError;
 var init_errors = __esm({
@@ -1358,13 +1621,13 @@ __export(server_exports, {
   runCliServer: () => runCliServer
 });
 function withResolvers() {
-  let resolve2;
+  let resolve3;
   let reject;
   const promise = new Promise((res, rej) => {
-    resolve2 = res;
+    resolve3 = res;
     reject = rej;
   });
-  return { promise, resolve: resolve2, reject };
+  return { promise, resolve: resolve3, reject };
 }
 function startHttpServer(handler, host, port) {
   const b = globalThis.Bun;
@@ -1372,7 +1635,7 @@ function startHttpServer(handler, host, port) {
     const s = b.serve({ port, hostname: host, fetch: handler });
     return Promise.resolve({ stop: () => s.stop() });
   }
-  const { promise, resolve: resolve2, reject } = withResolvers();
+  const { promise, resolve: resolve3, reject } = withResolvers();
   const server = http__default.default.createServer(async (req, res) => {
     try {
       const url = new URL(req.url || "/", `http://${req.headers.host || `${host}:${port}`}`);
@@ -1397,7 +1660,7 @@ function startHttpServer(handler, host, port) {
   });
   server.once("error", reject);
   server.listen(port, host, () => {
-    resolve2({
+    resolve3({
       stop: () => {
         const close = withResolvers();
         server.close(() => close.resolve());
@@ -1873,8 +2136,8 @@ async function loadLanguagePack(moduleSpec) {
   try {
     let importPath = moduleSpec;
     if (moduleSpec.startsWith(".") || moduleSpec.startsWith("/") || moduleSpec.includes("\\") || moduleSpec.endsWith(".ts") || moduleSpec.endsWith(".js") || moduleSpec.endsWith(".mjs")) {
-      const { resolve: resolve2, pathToFileURL } = getPathUtils();
-      const resolved = resolve2(process.cwd(), moduleSpec);
+      const { resolve: resolve3, pathToFileURL } = getPathUtils();
+      const resolved = resolve3(process.cwd(), moduleSpec);
       importPath = pathToFileURL(resolved).href;
     }
     const imported = await import(
@@ -2551,7 +2814,9 @@ async function publishCatalogSeed(db, options) {
       })) : compileSeedRow(notePath, note.rawContent, {
         routeId: `${catalogName}/${stem}`,
         sourceId: `collection:${catalogName}/${stem}`,
-        createdAt: note.createdAt,
+        // Authored frontmatter date first — exports keep the post's own
+        // day, never the import/publish time.
+        createdAt: note.date ?? note.createdAt,
         noteTitle: note.title
       }).blockIndex;
       const blockEfforts = noteBlockEfforts.map((e) => ({
@@ -2893,10 +3158,8 @@ ${escapeCsvField(data.parsed.metric)},${data.scalar},${escapeCsvField(data.unit
   return lines.join("\n");
 }
 
-// src/version.ts
-var VERSION = "0.36.2135";
-
 // src/cli/runner.ts
+init_version();
 function getFs2() {
   if (typeof globalThis.process?.versions?.node === "undefined" && typeof globalThis.Bun === "undefined") {
     throw new Error("File system operations are only supported in Node / Bun environments");
@@ -3048,7 +3311,7 @@ function parseCliArgs(args) {
       if (Number.isSafeInteger(v) && v >= 0) result.seedVersion = v;
       i++;
     } else if (!result.subcommand) {
-      if (arg === "parse" || arg === "run" || arg === "query" || arg === "download" || arg === "export" || arg === "import" || arg === "publish" || arg === "build" || arg === "seed" || arg === "reset" || arg === "init" || arg === "server" || arg === "serve" || arg === "playground" || arg === "help" || arg === "version") {
+      if (arg === "parse" || arg === "run" || arg === "query" || arg === "download" || arg === "export" || arg === "import" || arg === "publish" || arg === "build" || arg === "seed" || arg === "reset" || arg === "init" || arg === "server" || arg === "serve" || arg === "playground" || arg === "init-catalog" || arg === "help" || arg === "version") {
         result.subcommand = arg;
       } else {
         result.target = arg;
@@ -3088,13 +3351,13 @@ function readBunStdinText() {
 async function readStdin() {
   const bunText = readBunStdinText();
   if (bunText) return bunText();
-  return new Promise((resolve2, reject) => {
+  return new Promise((resolve3, reject) => {
     const chunks = [];
     process.stdin.on("data", (chunk) => {
       chunks.push(typeof chunk === "string" ? Buffer.from(chunk) : chunk);
     });
     process.stdin.on("end", () => {
-      resolve2(Buffer.concat(chunks).toString("utf-8"));
+      resolve3(Buffer.concat(chunks).toString("utf-8"));
     });
     process.stdin.on("error", (err) => {
       reject(err);
@@ -3114,6 +3377,10 @@ USAGE:
   wod import <note|playground|session|effort|equipment> <file> [options]
   wod publish [catalog] [options]
   wod build [dir] [options]
+  wod init-catalog <name>
+                      Scaffold a new catalog repository (package.json, example
+                      collection, GitHub Actions Pages workflow). Refuses an
+                      existing destination.
   wod seed [options]
   wod reset [options]
   wod init            Initialize the configured database (idempotent)
@@ -3316,6 +3583,22 @@ async function cliMain(argv = process.argv.slice(2), io = {}) {
     }
   };
   try {
+    if (parsed.subcommand === "init-catalog") {
+      if (!parsed.target) {
+        writeErr("[wod init-catalog] Error: Missing catalog name (a single new directory name)");
+        return 1;
+      }
+      const { scaffoldCatalog: scaffoldCatalog2 } = await Promise.resolve().then(() => (init_scaffoldCatalog(), scaffoldCatalog_exports));
+      try {
+        const result = scaffoldCatalog2(parsed.target);
+        writeOut(`[wod init-catalog] Created ${result.dir} (${result.files.length} files)`);
+        writeOut(`Next: cd ${parsed.target} && bun install && bunx wod build . --output dist`);
+        return 0;
+      } catch (error) {
+        writeErr(`[wod init-catalog] ${error.message}`);
+        return 1;
+      }
+    }
     if (parsed.subcommand === "parse") {
       if (!parsed.target) {
         writeErr('[wod parse] Error: Missing input file or "-" for stdin');