@bitcobblers/wod-wiki-tools 0.36.2136 → 0.37.2139

package/dist/bin/wod.cjs

@@ -161,7 +161,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();
@@ -267,6 +267,11 @@ async function getEffortBySlug(db, slug) {
   const efforts = await allRows(sql, db, "efforts");
   return efforts.find((e) => e.slug === slug);
 }
+async function getEquipmentBySlug(db, slug) {
+  const sql = await loadSql();
+  const equipment = await allRows(sql, db, "equipment");
+  return equipment.find((e) => e.slug === slug);
+}
 async function listTagsByType(db, type) {
   const sql = await loadSql();
   const tags = await allRows(sql, db, "tags");
@@ -297,6 +302,7 @@ function seedNoteSourceId(path, content, chunkId) {
   if (chunkId === CANVAS_CHUNK_ID2) return `guides:${canvasRouteSlug(content) ?? under}`;
   if (chunkId === DASHBOARDS_CHUNK_ID) return "dashboards";
   if (chunkId === EFFORTS_CHUNK_ID) return "efforts";
+  if (chunkId === EQUIPMENT_CHUNK_ID) return "equipment";
   if (chunkId === TEMPLATE_CHUNK_ID) return "playground";
   if (chunkId.startsWith("collection.")) {
     const catalog = catalogForChunkId(chunkId);
@@ -305,40 +311,19 @@ function seedNoteSourceId(path, content, chunkId) {
   if (chunkId.startsWith("feed.")) return `feed:feeds/${under}`;
   return void 0;
 }
-var SEED_SCHEMA2, SEED_REGISTERED_WIDGETS, EFFORTS_CHUNK_ID, CANVAS_CHUNK_ID2, DASHBOARDS_CHUNK_ID, TEMPLATE_CHUNK_ID;
+var SEED_SCHEMA2, SEED_REGISTERED_WIDGETS, EFFORTS_CHUNK_ID, EQUIPMENT_CHUNK_ID, CANVAS_CHUNK_ID2, DASHBOARDS_CHUNK_ID, TEMPLATE_CHUNK_ID;
 var init_contract = __esm({
   "src/seedbuild/contract.ts"() {
-    SEED_SCHEMA2 = 8;
+    SEED_SCHEMA2 = 9;
     SEED_REGISTERED_WIDGETS = wodWikiCore.KNOWN_SECTION_WIDGETS;
     EFFORTS_CHUNK_ID = "efforts";
+    EQUIPMENT_CHUNK_ID = "equipment";
     CANVAS_CHUNK_ID2 = "canvas";
     DASHBOARDS_CHUNK_ID = "dashboards";
     TEMPLATE_CHUNK_ID = "template";
   }
 });
 
-// src/seedbuild/effort-slugs.ts
-function extractEffortSlugs2(statements) {
-  const slugs = /* @__PURE__ */ new Set();
-  for (const statement of statements) {
-    if (statement.exerciseId) {
-      slugs.add(statement.exerciseId);
-    } else {
-      const effortMetric = statement.metrics?.getMetric?.("effort");
-      const effort = effortMetric && typeof effortMetric.value === "string" ? effortMetric.value : void 0;
-      if (effort) {
-        const slug = effort.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
-        if (slug) slugs.add(slug);
-      }
-    }
-  }
-  return Array.from(slugs);
-}
-var init_effort_slugs = __esm({
-  "src/seedbuild/effort-slugs.ts"() {
-  }
-});
-
 // src/seedbuild/filename.ts
 function fileToDisplayName(filename) {
   const base = filename.replace(/\.md$/, "");
@@ -384,149 +369,6 @@ var init_filename = __esm({
     };
   }
 });
-
-// src/seedbuild/frontmatter.ts
-function unquote(value) {
-  return value.replace(
-    /^(['"])(.*)\1$/,
-    (_match, quote, inner) => quote === '"' ? inner.replace(/\\(["\\])/g, "$1") : inner
-  );
-}
-function parseFrontmatter(raw) {
-  const match = raw.match(FRONTMATTER_RE);
-  if (!match) return { meta: {}, body: raw };
-  return { meta: parseMetaLines(match[1].split(/\r?\n/)), body: raw.slice(match[0].length) };
-}
-function parseMetaLines(lines) {
-  const meta = {};
-  for (let i = 0; i < lines.length; i++) {
-    const keyMatch = lines[i].match(/^([A-Za-z][\w.-]*)\s*:(.*)$/);
-    if (!keyMatch) continue;
-    const key = keyMatch[1];
-    const rawVal = keyMatch[2].trim();
-    if (rawVal === "") {
-      const items = [];
-      while (i + 1 < lines.length) {
-        const itemMatch = lines[i + 1].match(/^\s+-\s+(.+)$/);
-        if (!itemMatch) break;
-        items.push(itemMatch[1].trim());
-        i++;
-      }
-      meta[key] = items.length > 0 ? items : "";
-    } else {
-      const wasQuoted = /^(['"])(.*)\1$/.test(rawVal);
-      const value = unquote(rawVal);
-      const num = Number(value);
-      meta[key] = !wasQuoted && value !== "" && !isNaN(num) ? num : value;
-    }
-  }
-  return meta;
-}
-function getScalar(meta, key) {
-  const value = meta[key];
-  return typeof value === "string" || typeof value === "number" ? value : void 0;
-}
-function getList(meta, key) {
-  const value = meta[key];
-  return Array.isArray(value) ? value : [];
-}
-var FRONTMATTER_RE;
-var init_frontmatter = __esm({
-  "src/seedbuild/frontmatter.ts"() {
-    FRONTMATTER_RE = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?/;
-  }
-});
-function parseDiscipline(val) {
-  if (!val) return void 0;
-  const normalized = unquoteYaml(val.trim()).toLowerCase();
-  if (wodWikiLang.isEffortDiscipline(normalized)) return normalized;
-  console.warn(`[effort-file] unknown discipline '${val}' \u2014 treating as unset`);
-  return void 0;
-}
-function unquoteYaml(val) {
-  if (val.startsWith('"') && val.endsWith('"')) {
-    return val.slice(1, -1).replace(/\\(["\\])/g, "$1");
-  }
-  if (val.startsWith("'") && val.endsWith("'")) {
-    return val.slice(1, -1).replace(/\\'/g, "'");
-  }
-  return val;
-}
-function coerceNestedScalar(raw) {
-  if (raw === "true") return true;
-  if (raw === "false") return false;
-  if (raw !== "" && !Number.isNaN(Number(raw))) return Number(raw);
-  return raw;
-}
-function readNestedSection(lines, key) {
-  const start = lines.findIndex((l) => new RegExp(`^${key}:\\s*$`).test(l));
-  if (start === -1) return void 0;
-  const result = {};
-  let subKey = null;
-  for (let i = start + 1; i < lines.length; i++) {
-    const line = lines[i];
-    if (/^\S/.test(line)) break;
-    const trimmed = line.trim();
-    if (!trimmed || trimmed.startsWith("#")) continue;
-    const indent = line.length - line.trimStart().length;
-    const m = trimmed.match(/^([\w.-]+):\s*(.*)$/);
-    if (!m) continue;
-    const [, k, rawVal] = m;
-    if (indent === 2) {
-      if (rawVal === "") {
-        subKey = k;
-        result[k] = {};
-      } else {
-        subKey = null;
-        result[k] = coerceNestedScalar(rawVal);
-      }
-    } else if (indent >= 4 && subKey !== null) {
-      result[subKey][k] = coerceNestedScalar(rawVal);
-    }
-  }
-  return Object.keys(result).length > 0 ? result : void 0;
-}
-function parseEffortFile(raw) {
-  const blockMatch = raw.match(/^---\r?\n([\s\S]*?)\r?\n---/);
-  if (!blockMatch) return null;
-  const { meta, body } = parseFrontmatter(raw);
-  const innerLines = blockMatch[1].split(/\r?\n/);
-  const id = getScalar(meta, "id");
-  const slug = getScalar(meta, "slug");
-  const label = getScalar(meta, "label");
-  const aliases = getList(meta, "aliases");
-  const baseAttrs = readNestedSection(innerLines, "baseAttributes");
-  const hints = readNestedSection(innerLines, "hints");
-  const derivation = readNestedSection(innerLines, "derivation");
-  const metRaw = baseAttrs?.met;
-  const met = typeof metRaw === "number" ? metRaw : Number(metRaw);
-  if (!id || !slug || !label || metRaw === void 0 || Number.isNaN(met)) return null;
-  const discipline = parseDiscipline(
-    typeof baseAttrs?.discipline === "string" ? baseAttrs.discipline : void 0
-  );
-  const intensityTier = baseAttrs?.intensityTier;
-  const trimmedBody = body.trim();
-  return {
-    id: String(id),
-    slug: String(slug),
-    label: String(label),
-    aliases,
-    baseAttributes: {
-      met,
-      ...discipline ? { discipline } : {},
-      ...intensityTier ? { intensityTier } : {}
-    },
-    registrySource: "bundled",
-    ...trimmedBody ? { body: trimmedBody } : {},
-    ...hints ? { hints } : {},
-    ...derivation ? { derivation } : {}
-  };
-}
-var init_effort_file = __esm({
-  "src/seedbuild/effort-file.ts"() {
-    init_frontmatter();
-  }
-});
 function resolveGitVersion(repoRoot) {
   try {
     const run = (args) => child_process.execSync(`git ${args}`, { cwd: repoRoot, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim();
@@ -615,18 +457,93 @@ var init_report = __esm({
   }
 });
 
+// src/seedbuild/frontmatter.ts
+function unquote(value) {
+  return value.replace(
+    /^(['"])(.*)\1$/,
+    (_match, quote, inner) => quote === '"' ? inner.replace(/\\(["\\])/g, "$1") : inner
+  );
+}
+function parseFrontmatter(raw) {
+  const match = raw.match(FRONTMATTER_RE);
+  if (!match) return { meta: {}, body: raw };
+  return { meta: parseMetaLines(match[1].split(/\r?\n/)), body: raw.slice(match[0].length) };
+}
+function parseMetaLines(lines) {
+  const meta = {};
+  for (let i = 0; i < lines.length; i++) {
+    const keyMatch = lines[i].match(/^([A-Za-z][\w.-]*)\s*:(.*)$/);
+    if (!keyMatch) continue;
+    const key = keyMatch[1];
+    const rawVal = keyMatch[2].trim();
+    if (rawVal === "") {
+      const items = [];
+      while (i + 1 < lines.length) {
+        const itemMatch = lines[i + 1].match(/^\s+-\s+(.+)$/);
+        if (!itemMatch) break;
+        items.push(itemMatch[1].trim());
+        i++;
+      }
+      meta[key] = items.length > 0 ? items : "";
+    } else {
+      const wasQuoted = /^(['"])(.*)\1$/.test(rawVal);
+      const value = unquote(rawVal);
+      const num = Number(value);
+      meta[key] = !wasQuoted && value !== "" && !isNaN(num) ? num : value;
+    }
+  }
+  return meta;
+}
+function getScalar(meta, key) {
+  const value = meta[key];
+  return typeof value === "string" || typeof value === "number" ? value : void 0;
+}
+var FRONTMATTER_RE;
+var init_frontmatter = __esm({
+  "src/seedbuild/frontmatter.ts"() {
+    FRONTMATTER_RE = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?/;
+  }
+});
+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 = {};
 __export(compiler_exports, {
   buildBlockEffortRows: () => buildBlockEffortRows,
+  buildBlockEquipmentRows: () => buildBlockEquipmentRows,
   buildBlockIndexRows: () => buildBlockIndexRows,
   chunkIdFor: () => chunkIdFor,
   collectCorpusMarkdown: () => collectCorpusMarkdown,
   compileSeedRow: () => compileSeedRow,
   discoverUncatalogedEfforts: () => discoverUncatalogedEfforts,
   feedDateToCreatedAt: () => feedDateToCreatedAt,
+  frontmatterDateToCreatedAt: () => frontmatterDateToCreatedAt,
   generateSeed: () => generateSeed,
-  loadExistingEffortMap: () => loadExistingEffortMap,
+  loadCorpusReferenceCatalog: () => loadCorpusReferenceCatalog,
   partitionIntoChunks: () => partitionIntoChunks,
   scaffoldDiscoveredEfforts: () => scaffoldDiscoveredEfforts,
   validateDashboardNote: () => validateDashboardNote,
@@ -652,6 +569,7 @@ function chunkIdFor(relPath) {
     case "canvas":
     case "dashboards":
     case "efforts":
+    case "equipment":
       return corpus;
     case "collections":
       return parts.length === 3 ? `collection._root` : `collection.${slug}`;
@@ -670,7 +588,7 @@ function partitionIntoChunks(paths) {
     const id = chunkIdFor(p);
     if (id === null) {
       throw new Error(
-        `[generate-seed] Parity failure: '${p}' is not part of any known corpus (canvas | dashboards | efforts | collections | feeds). Extend chunkIdFor() if this is a new corpus.`
+        `[generate-seed] Parity failure: '${p}' is not part of any known corpus (canvas | dashboards | efforts | equipment | collections | feeds). Extend chunkIdFor() if this is a new corpus.`
       );
     }
     const list = byId.get(id);
@@ -726,6 +644,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`);
@@ -740,7 +670,7 @@ function compileSeedRow(path, content, metadata = {}) {
     const section = sections.find((section2) => section2.from === block.from && section2.to === block.to);
     return { id: `${noteId}:${block.id}`, noteId, blockId: block.id, blockVersion: 1, sourceRevision: 1, from: block.from, to: block.to, position, dataType: block.kind, ...block.kind === "wod" ? { blockContentId: wodWikiCore.blockContentId(section?.scriptBlock?.content ?? content.slice(block.from, block.to)) } : {}, rawContent: content.slice(block.from, block.to), noteTitle: metadata.noteTitle ?? fileToDisplayName(path.split("/").at(-1) ?? path), createdAt: metadata.createdAt ?? 0, isStatic: true, sourceId: metadata.sourceId, sourcePath: path, routeId: metadata.routeId };
   });
-  return { path, content, blocks, blockIndex, blockEfforts: [] };
+  return { path, content, blocks, blockIndex, blockEfforts: [], blockEquipment: [] };
 }
 function buildBlockIndexRows(markdownDir, corpusRoot) {
   const rows = [];
@@ -753,7 +683,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;
@@ -790,41 +720,37 @@ function formatDiscoveredLabel(raw) {
   const clean = raw.replace(/[-_]+/g, " ").trim();
   return clean.split(/\s+/).map((w) => w.charAt(0).toUpperCase() + w.slice(1).toLowerCase()).join(" ");
 }
-function loadExistingEffortMap(markdownDir) {
-  const slugs = /* @__PURE__ */ new Set();
-  const aliasToCanonical = /* @__PURE__ */ new Map();
+function loadCorpusReferenceCatalog(markdownDir) {
+  const efforts = [];
+  const equipment = [];
   const effortsDir = path.join(markdownDir, "efforts");
   for (const file of listMarkdownFiles(effortsDir)) {
-    const raw = fs.readFileSync(path.join(effortsDir, file), "utf8");
-    const parsed = parseEffortFile(raw);
-    if (!parsed) continue;
-    slugs.add(parsed.slug);
-    aliasToCanonical.set(parsed.slug, parsed.slug);
-    aliasToCanonical.set(parsed.label.toLowerCase(), parsed.slug);
-    aliasToCanonical.set(parsed.slug.replace(/-/g, " "), parsed.slug);
-    for (const alias of parsed.aliases) {
-      aliasToCanonical.set(alias.toLowerCase(), parsed.slug);
-      aliasToCanonical.set(alias.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/(^-|-$)/g, ""), parsed.slug);
-    }
+    const parsed = wodWikiLang.parseEffortFile(fs.readFileSync(path.join(effortsDir, file), "utf8"));
+    if (parsed) efforts.push(parsed);
+  }
+  const equipmentDir = path.join(markdownDir, "equipment");
+  for (const file of listMarkdownFiles(equipmentDir)) {
+    const parsed = wodWikiLang.parseEquipmentFile(fs.readFileSync(path.join(equipmentDir, file), "utf8"));
+    if (parsed) equipment.push(parsed);
   }
-  return { slugs, aliasToCanonical };
+  return { efforts, equipment };
 }
 function discoverUncatalogedEfforts(markdownDir, corpusRoot) {
-  const { slugs, aliasToCanonical } = loadExistingEffortMap(markdownDir);
+  const catalog = loadCorpusReferenceCatalog(markdownDir);
+  const index = wodWikiLang.createReferenceIndex(catalog);
   const blocks = buildBlockIndexRows(markdownDir, corpusRoot);
   const discovered = /* @__PURE__ */ new Map();
   for (const block of blocks) {
     if (block.dataType !== "wod" || !block.rawContent) continue;
     const section = wodWikiCore.parseDocumentSections(block.rawContent, { registeredWidgets: SEED_REGISTERED_WIDGETS }).find((section2) => section2.scriptBlock);
-    const script = wodWikiLang.parseScript(section?.scriptBlock?.content ?? block.rawContent);
+    const script = wodWikiLang.parseScript(section?.scriptBlock?.content ?? block.rawContent, { references: index });
     for (const statement of script.statements) {
       const effortMetric = statement.metrics?.getMetric?.("effort");
       const effortLabel = (effortMetric && typeof effortMetric.value === "string" ? effortMetric.value : void 0) ?? statement.exerciseId;
       if (!effortLabel) continue;
-      const slugified = effortLabel.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/(^-|-$)/g, "");
+      const slugified = wodWikiLang.slugifyRefLabel(effortLabel);
       if (!slugified || NON_EFFORT_SLUGS[slugified]) continue;
-      const canonical = aliasToCanonical.get(slugified) ?? aliasToCanonical.get(effortLabel.toLowerCase());
-      if (canonical && slugs.has(canonical)) continue;
+      if (index.resolveEffort(slugified) || index.resolveEffort(effortLabel)) continue;
       const existing = discovered.get(slugified);
       if (existing) {
         existing.rawLabels.add(effortLabel);
@@ -874,17 +800,16 @@ ${aliases.join("\n")}` : "aliases: []",
 }
 function buildBlockEffortRows(markdownDir, corpusRoot, blocks = buildBlockIndexRows(markdownDir, corpusRoot)) {
   const efforts = [];
-  const { aliasToCanonical } = loadExistingEffortMap(markdownDir);
+  const index = wodWikiLang.createReferenceIndex(loadCorpusReferenceCatalog(markdownDir));
   for (const block of blocks) {
     if (block.dataType !== "wod" || !block.rawContent) continue;
     const section = wodWikiCore.parseDocumentSections(block.rawContent, { registeredWidgets: SEED_REGISTERED_WIDGETS }).find((section2) => section2.scriptBlock);
-    const script = wodWikiLang.parseScript(section?.scriptBlock?.content ?? block.rawContent);
-    const effortSlugs = extractEffortSlugs2(script.statements);
+    const script = wodWikiLang.parseScript(section?.scriptBlock?.content ?? block.rawContent, { references: index });
     const linked = /* @__PURE__ */ new Set();
-    for (const rawSlug of effortSlugs) {
-      const norm = rawSlug.toLowerCase().trim();
-      const canonicalSlug = aliasToCanonical.get(norm) ?? aliasToCanonical.get(norm.replace(/[^a-z0-9]+/g, "-").replace(/(^-|-$)/g, "")) ?? norm.replace(/[^a-z0-9]+/g, "-").replace(/(^-|-$)/g, "");
-      if (!canonicalSlug || NON_EFFORT_SLUGS[canonicalSlug] || NON_EFFORT_SLUGS[norm]) {
+    for (const rawSlug of wodWikiLang.extractStatementRefs(script.statements).efforts) {
+      const canonical = index.resolveEffort(rawSlug);
+      const canonicalSlug = canonical?.slug;
+      if (!canonicalSlug || NON_EFFORT_SLUGS[canonicalSlug] || NON_EFFORT_SLUGS[rawSlug]) {
         continue;
       }
       if (linked.has(canonicalSlug)) continue;
@@ -903,6 +828,32 @@ function buildBlockEffortRows(markdownDir, corpusRoot, blocks = buildBlockIndexR
   }
   return efforts;
 }
+function buildBlockEquipmentRows(markdownDir, corpusRoot, blocks = buildBlockIndexRows(markdownDir, corpusRoot)) {
+  const links = [];
+  const index = wodWikiLang.createReferenceIndex(loadCorpusReferenceCatalog(markdownDir));
+  for (const block of blocks) {
+    if (block.dataType !== "wod" || !block.rawContent) continue;
+    const section = wodWikiCore.parseDocumentSections(block.rawContent, { registeredWidgets: SEED_REGISTERED_WIDGETS }).find((s) => s.scriptBlock);
+    const script = wodWikiLang.parseScript(section?.scriptBlock?.content ?? block.rawContent, { references: index });
+    const linked = /* @__PURE__ */ new Set();
+    for (const rawSlug of wodWikiLang.extractStatementRefs(script.statements).equipment) {
+      const canonicalSlug = index.resolveEquipment(rawSlug)?.slug;
+      if (!canonicalSlug || linked.has(canonicalSlug)) continue;
+      linked.add(canonicalSlug);
+      links.push({
+        id: `${block.id}:${canonicalSlug}`,
+        noteId: block.noteId,
+        blockId: block.blockId,
+        blockContentId: block.blockContentId,
+        equipmentSlug: canonicalSlug,
+        isStatic: block.isStatic,
+        sourcePath: block.sourcePath,
+        createdAt: block.createdAt
+      });
+    }
+  }
+  return links;
+}
 function sha256Hex(data) {
   return crypto.createHash("sha256").update(data).digest("hex");
 }
@@ -913,6 +864,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) {
@@ -947,9 +905,11 @@ ${shown}${more}`);
   const manifestChunks = [];
   const tBlockEfforts = Date.now();
   const effortRows = buildBlockEffortRows(markdownDir, corpusRoot, blockRows);
+  const equipmentRows = buildBlockEquipmentRows(markdownDir, corpusRoot, blockRows);
   passMs.blockEfforts = Date.now() - tBlockEfforts;
   const blocksByPath = /* @__PURE__ */ new Map();
   const effortsByPath = /* @__PURE__ */ new Map();
+  const equipmentByPath = /* @__PURE__ */ new Map();
   for (const row of blockRows) {
     const rows = blocksByPath.get(row.sourcePath) ?? [];
     rows.push(row);
@@ -960,6 +920,11 @@ ${shown}${more}`);
     rows.push(row);
     effortsByPath.set(row.sourcePath, rows);
   }
+  for (const row of equipmentRows) {
+    const rows = equipmentByPath.get(row.sourcePath) ?? [];
+    rows.push(row);
+    equipmentByPath.set(row.sourcePath, rows);
+  }
   let totalFiles = 0;
   const tWrite = Date.now();
   for (const { id, files } of groups) {
@@ -970,6 +935,7 @@ ${shown}${more}`);
       const compiled = compileSeedRow(p, content);
       compiled.blockIndex = blocksByPath.get(p) ?? compiled.blockIndex;
       compiled.blockEfforts = effortsByPath.get(p) ?? [];
+      compiled.blockEquipment = equipmentByPath.get(p) ?? [];
       return compiled;
     });
     const bytes = Buffer.from(JSON.stringify(rows), "utf8");
@@ -981,6 +947,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,
@@ -989,6 +958,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,
@@ -1001,12 +971,11 @@ var NON_EFFORT_SLUGS;
 var init_compiler = __esm({
   "src/seedbuild/compiler.ts"() {
     init_contract();
-    init_effort_slugs();
     init_filename();
-    init_effort_file();
     init_git_version();
     init_report();
     init_frontmatter();
+    init_validation();
     NON_EFFORT_SLUGS = {
       "amrap": true,
       "emom": true,
@@ -1056,6 +1025,219 @@ var init_compiler = __esm({
   }
 });
 
+// src/version.ts
+var VERSION;
+var init_version = __esm({
+  "src/version.ts"() {
+    VERSION = "0.37.2139";
+  }
+});
+
+// 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({
@@ -1359,13 +1541,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;
@@ -1373,7 +1555,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}`}`);
@@ -1398,7 +1580,7 @@ function startHttpServer(handler, host, port) {
   });
   server.once("error", reject);
   server.listen(port, host, () => {
-    resolve2({
+    resolve3({
       stop: () => {
         const close = withResolvers();
         server.close(() => close.resolve());
@@ -1542,8 +1724,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(
@@ -2145,23 +2327,7 @@ function resolveDatabaseConfig(options = {}, env) {
 // src/cli/persist.ts
 init_db();
 var registeredWidgets = wodWikiCore.KNOWN_SECTION_WIDGETS;
-var saveStores = ["notes", "block_revisions", "block_index", "block_efforts", "tags", "note_tags", "sessions"];
-function extractEffortSlugs(statements) {
-  const slugs = /* @__PURE__ */ new Set();
-  for (const statement of statements) {
-    if (statement.exerciseId) {
-      slugs.add(statement.exerciseId);
-    } else {
-      const effortMetric = statement.metrics?.getMetric?.("effort");
-      const effort = effortMetric && "effort" in effortMetric ? effortMetric.effort : void 0;
-      if (typeof effort === "string") {
-        const slug = effort.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
-        if (slug) slugs.add(slug);
-      }
-    }
-  }
-  return [...slugs];
-}
+var saveStores = ["notes", "block_revisions", "block_index", "block_efforts", "block_equipment", "efforts", "equipment", "tags", "note_tags", "sessions"];
 function titleFromLabel(sourceLabel) {
   if (!sourceLabel || sourceLabel === "-") return "stdin";
   const stem = sourceLabel.split("/").pop() ?? sourceLabel;
@@ -2233,9 +2399,19 @@ async function saveSource(db, options, startTime) {
     };
     const priorRows = await tx.readonly("block_index").getAllFromIndex("by-note", noteId);
     const priorEfforts = await tx.readonly("block_efforts").getAllFromIndex("by-note", noteId);
+    const priorEquipment = await tx.readonly("block_equipment").getAllFromIndex("by-note", noteId);
+    const storedEfforts = await tx.readonly("efforts").getAll();
+    const effortsBySlug = /* @__PURE__ */ new Map();
+    for (const effort of wodWikiLang.bundledEfforts) effortsBySlug.set(effort.slug, effort);
+    for (const effort of storedEfforts) effortsBySlug.set(effort.slug, effort);
+    const referenceIndex = wodWikiLang.createReferenceIndex({
+      efforts: [...effortsBySlug.values()],
+      equipment: await tx.readonly("equipment").getAll()
+    });
     const priorById = new Map(priorRows.map((row) => [row.id, row]));
     const nextRows = [];
     const nextEfforts = [];
+    const nextEquipment = [];
     for (const [position, block] of Object.values(blocks).sort((a, b) => a.from - b.from).entries()) {
       const id = `${noteId}:${block.id}`;
       const prior = priorById.get(id);
@@ -2261,7 +2437,20 @@ async function saveSource(db, options, startTime) {
         ...note.sourceId ? { sourceId: note.sourceId } : {}
       });
       if (block.kind === "wod") {
-        for (const effortSlug of extractEffortSlugs(wodWikiLang.parseScript(body, { sport: block.sport, dialect: block.dialect }).statements)) {
+        const statements = wodWikiLang.parseScript(body, { sport: block.sport, dialect: block.dialect, references: referenceIndex }).statements;
+        const refs = wodWikiLang.extractStatementRefs(statements);
+        const effortSlugs = new Set(refs.efforts);
+        if (effortSlugs.size === 0) {
+          for (const s of statements) {
+            const m = s.metrics?.getMetric?.(wodWikiCore.MetricType.Effort);
+            const val = typeof m?.value === "string" ? m.value : m && "effort" in m ? String(m.effort) : "";
+            const slug = val.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
+            if (slug && !["rest", "amrap", "emom", "tabata", "for-time"].includes(slug)) {
+              effortSlugs.add(slug);
+            }
+          }
+        }
+        for (const effortSlug of effortSlugs) {
           const effortId = `${noteId}:${block.id}:${effortSlug}`;
           const previous = priorEfforts.find((row) => row.id === effortId);
           nextEfforts.push({
@@ -2274,12 +2463,26 @@ async function saveSource(db, options, startTime) {
             createdAt: previous?.createdAt ?? now
           });
         }
+        for (const equipmentSlug of refs.equipment) {
+          const equipmentId = `${noteId}:${block.id}:${equipmentSlug}`;
+          const previous = priorEquipment.find((row) => row.id === equipmentId);
+          nextEquipment.push({
+            ...previous,
+            id: equipmentId,
+            noteId,
+            blockId: block.id,
+            blockContentId: fingerprint,
+            equipmentSlug,
+            createdAt: previous?.createdAt ?? now
+          });
+        }
       }
     }
     if (!wodWikiStorage.rowsEqual(existing, note)) await tx.readwrite("notes").put(note);
     if (revisions.length) await tx.readwrite("block_revisions").putMany(revisions);
     await diffProjection(tx, "block_index", priorRows, nextRows);
     await diffProjection(tx, "block_efforts", priorEfforts, nextEfforts);
+    await diffProjection(tx, "block_equipment", priorEquipment, nextEquipment);
     const tags = await saveTags(tx, noteId, options.tags, now);
     let session;
     let revision;
@@ -2315,6 +2518,7 @@ async function diffProjection(tx, store, previous, next) {
     if (!wodWikiStorage.rowsEqual(old.get(row.id), row)) {
       if (store === "block_index" && "blockVersion" in row) await tx.readwrite("block_index").put(row);
       if (store === "block_efforts" && "effortSlug" in row) await tx.readwrite("block_efforts").put(row);
+      if (store === "block_equipment" && "equipmentSlug" in row) await tx.readwrite("block_equipment").put(row);
     }
   }
 }
@@ -2406,6 +2610,12 @@ async function persistEffort(db, effort) {
     await sql.putRow(tx, sql.storeDefinition("efforts"), effort);
   });
 }
+async function persistEquipment(db, equipment) {
+  const sql = await loadSql();
+  await db.db.transaction(async (tx) => {
+    await sql.putRow(tx, sql.storeDefinition("equipment"), equipment);
+  });
+}
 async function persistTypedTags(db, labels, type) {
   return db.storage.transaction(["tags"], "readwrite", async (tx) => {
     let added = 0;
@@ -2431,17 +2641,18 @@ async function importSeedDir(db, dir, sourceId) {
   const source = sourceId || path.basename(dir);
   const manifest = wodWikiEngine.assertSeedManifest(JSON.parse(fs.readFileSync(path.resolve(dir, "manifest.json"), "utf-8")));
   const key = wodWikiEngine.seedMetaKey(source);
-  let expected = await db.storage.readonly("meta").get(key);
-  if (expected && expected.schema !== wodWikiEngine.SEED_SCHEMA) throw new Error("Incompatible seed checkpoint; recreate storage");
+  const stored = await db.storage.readonly("meta").get(key);
+  let expected = stored?.schema === wodWikiEngine.SEED_SCHEMA ? stored : void 0;
   let meta = expected ?? wodWikiEngine.emptySeedMeta(key);
   if (manifest.version < meta.seedVersion) throw new Error("Seed manifest is older than stored checkpoint");
-  const summary = { sourceId: source, version: manifest.version, notes: 0, efforts: 0, blocks: 0, blockEfforts: 0, deleted: 0, skippedUserOwned: 0 };
+  const summary = { sourceId: source, version: manifest.version, notes: 0, efforts: 0, equipment: 0, blocks: 0, blockEfforts: 0, deleted: 0, skippedUserOwned: 0 };
   const metadataChanged = manifest.version !== meta.seedVersion || manifest.builtAt !== meta.builtAt;
   const plan = manifest.chunks.filter((c) => metadataChanged || meta.chunks[c.id]?.sha256 !== c.sha256);
   plan.sort((a, b) => Number(b.id === wodWikiEngine.CANVAS_CHUNK_ID) - Number(a.id === wodWikiEngine.CANVAS_CHUNK_ID));
   const accumulate = (result) => {
     summary.notes += result.totalNotes;
     summary.efforts += result.totalEfforts;
+    summary.equipment += result.totalEquipment;
     summary.blocks += result.totalBlocks;
     summary.deleted += result.deleted;
     summary.skippedUserOwned += result.skippedUserOwned;
@@ -2517,6 +2728,7 @@ async function publishCatalogSeed(db, options) {
   }
   const allIndexRows = await db.storage.readonly("block_index").getAll();
   const allEffortRows = await db.storage.readonly("block_efforts").getAll();
+  const allEquipmentRows = await db.storage.readonly("block_equipment").getAll();
   const indexByNote = /* @__PURE__ */ new Map();
   for (const row of allIndexRows) {
     const list = indexByNote.get(row.noteId) ?? [];
@@ -2529,6 +2741,12 @@ async function publishCatalogSeed(db, options) {
     list.push(row);
     effortsByNote.set(row.noteId, list);
   }
+  const equipmentByNote = /* @__PURE__ */ new Map();
+  for (const row of allEquipmentRows) {
+    const list = equipmentByNote.get(row.noteId) ?? [];
+    list.push(row);
+    equipmentByNote.set(row.noteId, list);
+  }
   const outDir = path.resolve(process.cwd(), options.outDir);
   const chunksDir = path.join(outDir, "chunks");
   fs.mkdirSync(chunksDir, { recursive: true });
@@ -2543,6 +2761,7 @@ async function publishCatalogSeed(db, options) {
       const notePath = note.sourcePath ?? `markdown/collections/${catalogName}/${stem}.md`;
       const noteBlockIndex = indexByNote.get(note.id) ?? [];
       const noteBlockEfforts = effortsByNote.get(note.id) ?? [];
+      const noteBlockEquipment = equipmentByNote.get(note.id) ?? [];
       const blockIndex = noteBlockIndex.length > 0 ? noteBlockIndex.map((b) => ({
         ...b,
         isStatic: true,
@@ -2552,7 +2771,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) => ({
@@ -2560,12 +2781,18 @@ async function publishCatalogSeed(db, options) {
         isStatic: true,
         sourcePath: e.sourcePath ?? notePath
       }));
+      const blockEquipment = noteBlockEquipment.map((e) => ({
+        ...e,
+        isStatic: true,
+        sourcePath: e.sourcePath ?? notePath
+      }));
       chunkRows.push({
         path: notePath,
         content: note.rawContent,
         blocks: note.blocks,
         blockIndex,
-        blockEfforts
+        blockEfforts,
+        blockEquipment
       });
     }
     const chunkId = `collection.${catalogName}`;
@@ -2894,10 +3121,8 @@ ${escapeCsvField(data.parsed.metric)},${data.scalar},${escapeCsvField(data.unit
   return lines.join("\n");
 }
 
-// src/version.ts
-var VERSION = "0.36.2136";
-
 // 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");
@@ -3049,7 +3274,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;
@@ -3089,13 +3314,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);
@@ -3115,6 +3340,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)
@@ -3317,6 +3546,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');
@@ -3517,7 +3762,9 @@ async function cliMain(argv = process.argv.slice(2), io = {}) {
             writeErr(`[wod ${verb}] Effort not found in ${db.path}: ${id}`);
             return 1;
           }
-          const markdown = wodWikiEngine.effortToMarkdown(effort);
+          const ownerNoteId = typeof effort.ownerNoteId === "string" ? effort.ownerNoteId : `effort/${effort.slug}`;
+          const owner = await db.storage.readonly("notes").get(ownerNoteId);
+          const markdown = owner?.rawContent ?? wodWikiEngine.effortToMarkdown(effort);
           const target = parsed.output && parsed.output !== "-" ? parsed.output : `${id}.md`;
           if (parsed.output === "-") {
             writeOut(markdown);
@@ -3526,15 +3773,29 @@ async function cliMain(argv = process.argv.slice(2), io = {}) {
           }
           writeOut(`[wod ${verb}] effort ${id} \u2192 ${target}`);
         } else {
-          const labels = (await listTagsByType(db.db, "equipment")).map((t) => t.label).sort();
-          const csv = wodWikiEngine.equipmentToCsv(labels);
-          const target = parsed.output && parsed.output !== "-" ? parsed.output : "equipment.csv";
-          if (parsed.output === "-") {
-            writeOut(csv);
+          const equipment = id ? await getEquipmentBySlug(db.db, targetId) : void 0;
+          if (equipment) {
+            const ownerNoteId = typeof equipment.ownerNoteId === "string" ? equipment.ownerNoteId : `equipment/${equipment.slug}`;
+            const owner = await db.storage.readonly("notes").get(ownerNoteId);
+            const markdown = owner?.rawContent ?? wodWikiEngine.equipmentToMarkdown(equipment);
+            const target = parsed.output && parsed.output !== "-" ? parsed.output : `${id}.md`;
+            if (parsed.output === "-") {
+              writeOut(markdown);
+            } else {
+              nodeFs().writeFileSync(target, markdown, "utf-8");
+            }
+            writeOut(`[wod ${verb}] equipment ${id} \u2192 ${target}`);
           } else {
-            nodeFs().writeFileSync(target, csv, "utf-8");
+            const labels = (await listTagsByType(db.db, "equipment")).map((t) => t.label).sort();
+            const csv = wodWikiEngine.equipmentToCsv(labels);
+            const target = parsed.output && parsed.output !== "-" ? parsed.output : "equipment.csv";
+            if (parsed.output === "-") {
+              writeOut(csv);
+            } else {
+              nodeFs().writeFileSync(target, csv, "utf-8");
+            }
+            writeOut(`[wod ${verb}] equipment \u2192 ${target} (${labels.length} labels)`);
           }
-          writeOut(`[wod ${verb}] equipment \u2192 ${target} (${labels.length} labels)`);
         }
       } finally {
         await db.close();
@@ -3576,7 +3837,7 @@ async function cliMain(argv = process.argv.slice(2), io = {}) {
         return 0;
       }
       if (kind === "effort") {
-        const effort = wodWikiEngine.markdownToEffort(fs.readFileSync(file, "utf-8"));
+        const effort = wodWikiLang.parseEffortFile(fs.readFileSync(file, "utf-8"));
         if (!effort) {
           writeErr(`[wod import] Unparseable effort file (need frontmatter id/slug/label + numeric baseAttributes.met): ${file}`);
           return 1;
@@ -3590,6 +3851,21 @@ async function cliMain(argv = process.argv.slice(2), io = {}) {
         }
         return 0;
       }
+      if (kind === "equipment" && /\.md$/i.test(file)) {
+        const equipment = wodWikiLang.parseEquipmentFile(fs.readFileSync(file, "utf-8"));
+        if (!equipment) {
+          writeErr(`[wod import] Unparseable equipment file (need frontmatter type: equipment + id/slug/label): ${file}`);
+          return 1;
+        }
+        const db2 = await openCliDb(cliDb());
+        try {
+          await persistEquipment(db2, { ...equipment, registrySource: "user" });
+          writeOut(`[wod import] equipment ${equipment.slug} \u2014 ${equipment.label} \u2192 ${db2.path}`);
+        } finally {
+          await db2.close();
+        }
+        return 0;
+      }
       if (kind === "equipment") {
         const labels = wodWikiEngine.csvToEquipmentLabels(fs.readFileSync(file, "utf-8"));
         if (labels.length === 0) {