@bitcobblers/wod-wiki-tools 0.51.2195 → 0.52.2198

package/dist/bin/wod.cjs

@@ -3,9 +3,9 @@
 
 var wodWikiLang = require('@bitcobblers/wod-wiki-lang');
 var wod_wiki_engine_star = require('@bitcobblers/wod-wiki-engine');
-var child_process = require('child_process');
 var fs = require('fs');
 var path = require('path');
+var child_process = require('child_process');
 var wodWikiCore = require('@bitcobblers/wod-wiki-core');
 var wodWikiWql = require('@bitcobblers/wod-wiki-wql');
 var crypto = require('crypto');
@@ -316,82 +316,60 @@ var init_db = __esm({
     CLI_UUID_NAMESPACE = "c0ffee00-8b1a-4e2c-9d3f-5a6b7c8d9e0f";
   }
 });
-
-// src/seedbuild/contract.ts
-var contract_exports = {};
-var init_contract = __esm({
-  "src/seedbuild/contract.ts"() {
-    __reExport(contract_exports, wod_wiki_engine_star__namespace);
-  }
-});
-
-// src/seedbuild/filename.ts
-function fileToDisplayName(filename) {
-  const base = filename.replace(/\.md$/, "");
-  if (base.toUpperCase() === "README") return "Overview";
-  const cleaned = base.replace(/^day-\d+-/, "");
-  const tokens = cleaned.split(/[-_]/);
-  const titled = [];
-  for (let i = 0; i < tokens.length; i++) {
-    const token = tokens[i];
-    const next = tokens[i + 1];
-    const after = tokens[i + 2];
-    const prev = tokens[i - 1];
-    if (/^\d{1,2}$/.test(token) && /^\d{1,2}$/.test(next ?? "") && !/^\d+$/.test(prev ?? "") && !/^\d+$/.test(after ?? "")) {
-      titled.push(`${token}.${next}`);
-      i++;
-      continue;
-    }
-    if (titled.length > 0 && FILE_TITLE_STOP_WORDS[token.toLowerCase()]) {
-      titled.push(token.toLowerCase());
-      continue;
-    }
-    titled.push(token.charAt(0).toUpperCase() + token.slice(1));
-  }
-  return titled.join(" ");
-}
-var FILE_TITLE_STOP_WORDS;
-var init_filename = __esm({
-  "src/seedbuild/filename.ts"() {
-    FILE_TITLE_STOP_WORDS = {
-      and: true,
-      or: true,
-      of: true,
-      for: true,
-      to: true,
-      in: true,
-      on: true,
-      at: true,
-      by: true,
-      with: true,
-      the: true,
-      a: true,
-      an: true
-    };
-  }
-});
-function resolveGitVersion(repoRoot) {
-  try {
-    const run = (args) => child_process.execSync(`git ${args}`, { cwd: repoRoot, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim();
-    const count = Number(run("rev-list --count HEAD"));
-    return {
-      version: Number.isFinite(count) && count > 0 ? count : 0,
-      versionLabel: run("describe --tags --long --always --dirty"),
-      commit: run("rev-parse HEAD"),
-      dirty: run("status --porcelain") !== ""
-    };
-  } catch {
-    return UNKNOWN_GIT_VERSION;
-  }
-}
-var UNKNOWN_GIT_VERSION;
-var init_git_version = __esm({
-  "src/seedbuild/git-version.ts"() {
-    UNKNOWN_GIT_VERSION = {
-      version: 0,
-      versionLabel: "unknown",
-      commit: "",
-      dirty: false
+var NodeFsFeedTree;
+var init_nodeFeedTree = __esm({
+  "src/cli/nodeFeedTree.ts"() {
+    init_db();
+    NodeFsFeedTree = class {
+      rootDir;
+      constructor(rootDir) {
+        this.rootDir = nodePath().resolve(rootDir);
+      }
+      get root() {
+        return this.rootDir;
+      }
+      absPath(relPath) {
+        const clean = wod_wiki_engine_star.normalizeFeedTreePath(relPath);
+        const resolved = nodePath().resolve(this.rootDir, clean);
+        if (resolved !== this.rootDir && !resolved.startsWith(this.rootDir + "/") && !resolved.startsWith(this.rootDir + "\\")) {
+          throw new wod_wiki_engine_star.FeedTreeError("layout", `Path '${relPath}' escapes root '${this.rootDir}'`);
+        }
+        return resolved;
+      }
+      async read(path) {
+        const abs = this.absPath(path);
+        const fs = nodeFs();
+        if (!fs.existsSync(abs)) {
+          throw new wod_wiki_engine_star.FeedTreeError("not-found", `File not found: ${path}`);
+        }
+        return new Uint8Array(fs.readFileSync(abs));
+      }
+      async stat(path) {
+        try {
+          const bytes = await this.read(path);
+          return {
+            bytes: bytes.byteLength,
+            sha256: await wod_wiki_engine_star.sha256HexAsync(bytes)
+          };
+        } catch (err) {
+          if (err instanceof wod_wiki_engine_star.FeedTreeError && err.code === "not-found") return void 0;
+          throw err;
+        }
+      }
+      async write(path, bytes) {
+        const abs = this.absPath(path);
+        const p = nodePath();
+        const fs = nodeFs();
+        fs.mkdirSync(p.dirname(abs), { recursive: true });
+        fs.writeFileSync(abs, bytes);
+      }
+      async delete(path) {
+        const abs = this.absPath(path);
+        const fs = nodeFs();
+        if (fs.existsSync(abs)) {
+          fs.unlinkSync(abs);
+        }
+      }
     };
   }
 });
@@ -457,283 +435,663 @@ var init_report = __esm({
   "src/seedbuild/report.ts"() {
   }
 });
-var init_frontmatter = __esm({
-  "src/seedbuild/frontmatter.ts"() {
-  }
-});
 
-// src/seedbuild/validation.ts
-var validation_exports = {};
-var init_validation = __esm({
-  "src/seedbuild/validation.ts"() {
-    __reExport(validation_exports, wod_wiki_engine_star__namespace);
+// src/version.ts
+var VERSION;
+var init_version = __esm({
+  "src/version.ts"() {
+    VERSION = "0.52.2198";
   }
 });
 
-// src/seedbuild/compiler.ts
-var compiler_exports = {};
-__export(compiler_exports, {
-  buildBlockEffortRows: () => buildBlockEffortRows,
-  buildBlockEquipmentRows: () => buildBlockEquipmentRows,
-  buildBlockIndexRows: () => buildBlockIndexRows,
-  chunkIdFor: () => chunkIdFor,
-  collectCorpusMarkdown: () => collectCorpusMarkdown,
-  compileSeedRow: () => compileSeedRow,
-  dateKeyToCreatedAt: () => dateKeyToCreatedAt,
-  discoverUncatalogedEfforts: () => discoverUncatalogedEfforts,
-  frontmatterDateToCreatedAt: () => frontmatterDateToCreatedAt,
-  generateSeed: () => generateSeed,
-  getFileCommit: () => getFileCommit,
-  getFileVersion: () => getFileVersion,
-  getPathCommit: () => getPathCommit,
-  getPathUpdatedAt: () => getPathUpdatedAt,
-  getPathVersion: () => getPathVersion,
-  groupCorpusPath: () => groupCorpusPath,
-  loadCorpusReferenceCatalog: () => loadCorpusReferenceCatalog,
-  partitionIntoChunks: () => partitionIntoChunks,
-  scaffoldDiscoveredEfforts: () => scaffoldDiscoveredEfforts,
-  seedNoteIdSync: () => seedNoteIdSync,
-  validateDashboardNote: () => validateDashboardNote,
-  validateWodBlockSyntax: () => validateWodBlockSyntax
+// src/cli/scaffoldFeed.ts
+var scaffoldFeed_exports = {};
+__export(scaffoldFeed_exports, {
+  scaffoldFeed: () => scaffoldFeed,
+  validateFeedName: () => validateFeedName
 });
-function listMarkdownFiles(dir, prefix = "") {
-  if (!fs.existsSync(dir)) return [];
-  const out = [];
-  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
-    const rel = prefix ? `${prefix}/${entry.name}` : entry.name;
-    if (entry.isDirectory()) out.push(...listMarkdownFiles(path.join(dir, entry.name), rel));
-    else if (entry.isFile() && entry.name.endsWith(".md")) out.push(rel);
+function validateFeedName(name) {
+  if (name.length === 0 || name === "." || name === "..") {
+    throw new Error("Feed name must be a single non-empty directory name");
   }
-  return out.sort();
-}
-function chunkIdFor(relPath) {
-  const parts = relPath.split("/");
-  if (parts[0] !== "markdown" || parts.length < 2) return null;
-  const corpus = parts[1];
-  if (parts.length === 2) return null;
-  const slug = parts[2]?.replace(/\.md$/, "");
-  switch (corpus) {
-    case "canvas":
-    case "dashboards":
-    case "efforts":
-    case "equipment":
-      return corpus;
-    case "notebooks":
-      return parts.length === 3 ? `notebook._root` : `notebook.${slug}`;
-    default:
-      return null;
+  if (name.includes("/") || name.includes("\\") || name.includes("\0")) {
+    throw new Error(`Invalid feed name '${name}': must be a single directory name (no path separators or traversal)`);
   }
-}
-function collectCorpusMarkdown(markdownDir, excludePaths = []) {
-  const excluded = new Set(excludePaths);
-  return listMarkdownFiles(markdownDir).map((p) => `markdown/${p}`).filter((path) => !excluded.has(path));
-}
-function partitionIntoChunks(paths) {
-  const byId = /* @__PURE__ */ new Map();
-  for (const p of 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 | equipment | notebooks). Extend chunkIdFor() if this is a new corpus.`
-      );
-    }
-    const list = byId.get(id);
-    if (list) list.push(p);
-    else byId.set(id, [p]);
+  if (/^(?:[A-Za-z]:)?[/\\]/.test(name)) {
+    throw new Error(`Invalid feed name '${name}': absolute paths are not allowed`);
   }
-  return [...byId.entries()].sort(([a], [b]) => a < b ? -1 : 1).map(([id, files]) => ({ id, files }));
+  if (name.length > 214 || !/^[a-z0-9][a-z0-9._-]*$/.test(name)) {
+    throw new Error(
+      `Invalid feed name '${name}': must be a valid npm package name (lowercase letters, digits, dots, hyphens, underscores; no leading dot/hyphen)`
+    );
+  }
+  return name;
 }
-function validateDashboardNote(raw) {
-  const problems = [];
-  const { meta } = wodWikiCore.parseFrontmatter(raw);
-  const { sections } = wodWikiWql.parseDashboardNote(raw);
-  const doc = wodWikiWql.buildDashboardDocument(sections, meta);
-  if (!doc.isDashboard) return ["file is not a dashboard note (missing dashboard frontmatter)"];
-  if (doc.title === void 0) problems.push("dashboard has no title");
-  if (doc.widgets.length < 3) problems.push(`dashboard has only ${doc.widgets.length} widgets (the locked format has \u2265 3)`);
-  const declared = new Set(doc.tokens.map((t) => t.name));
-  for (const widget of doc.widgets) {
-    const where = `widget '${widget.title ?? widget.body.slice(0, 40)}'`;
-    if (widget.title === void 0) problems.push(`${where}: missing title`);
-    if (!wodWikiWql.isDashboardWidgetType(wodWikiWql.resolveWidgetType(widget.type))) {
-      problems.push(`${where}: unknown widget type '${widget.type}'`);
+function scaffoldFeed(name, opts = {}) {
+  validateFeedName(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 });
     }
-    const parsed = wodWikiWql.parseQuery(widget.body);
-    if (parsed.error !== void 0) problems.push(`${where}: WQL parse error: ${parsed.error}`);
-    for (const ref of [
-      ...widget.body.matchAll(/\$([A-Za-z][\w-]*)/g),
-      ...Object.values(widget.attributes).flatMap((v) => [...String(v).matchAll(/\$([A-Za-z][\w-]*)/g)])
-    ]) {
-      if (!declared.has(ref[1])) problems.push(`${where}: undeclared token $${ref[1]}`);
+    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 feed: ${name}`,
+        scripts: {
+          build: "wod build . --output dist"
+        },
+        devDependencies: {
+          "@bitcobblers/wod-wiki-tools": `^${VERSION}`
+        }
+      },
+      null,
+      2
+    )}
+`],
+    [".gitignore", "node_modules/\ndist/\n"],
+    [".github/workflows/publish-feed.yml", publishWorkflow()],
+    ["markdown/notebooks/example/README.md", feedReadme(name)],
+    [`markdown/notebooks/example/morning-session.md`, exampleWorkout(date)],
+    ["README.md", repoReadme(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 problems;
+  return { dir, files: files.map(([rel]) => rel) };
 }
-function gateDashboards(groups, corpusRoot) {
-  for (const group of groups) {
-    if (group.id !== contract_exports.DASHBOARDS_CHUNK_ID) continue;
-    for (const p of group.files) {
-      const problems = validateDashboardNote(fs.readFileSync(path.join(corpusRoot, p), "utf8"));
-      if (problems.length > 0) {
-        throw new Error(`[generate-seed] Dashboard validation failed for '${p}':
-  - ${problems.join("\n  - ")}`);
-      }
-    }
-  }
-}
-function getFileCreatedAt(file, repoRoot) {
-  try {
-    const out = child_process.execSync(`git log -1 --format=%ct -- '${file}'`, { cwd: repoRoot, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim();
-    const ts = Number(out) * 1e3;
-    return Number.isFinite(ts) && ts > 0 ? ts : 0;
-  } catch {
-    return 0;
+var publishWorkflow, feedReadme, exampleWorkout, repoReadme;
+var init_scaffoldFeed = __esm({
+  "src/cli/scaffoldFeed.ts"() {
+    init_version();
+    publishWorkflow = () => `name: Publish feed
+
+# Compile the feed 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
+`;
+    feedReadme = (name) => `# ${name}
+
+Example benchmark notebook. Each \`.md\` file in this directory becomes part of
+the \`example\` notebook chunk; \`README.md\` is the notebook'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
+\`\`\`
+`;
+    repoReadme = (name) => `# ${name}
+
+A [WOD Wiki](https://github.com/bitcobblers/wod-wiki) workout feed: 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
+feed. 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-feed.yml\`)
+builds the feed on every push to \`main\` and deploys \`dist/\`.
+
+## Share
+
+Once published, anyone can subscribe to this feed from a WOD Wiki instance
+at:
+
+\`\`\`
+<app-url>/subscribe?source=<url-encoded published feed URL>
+\`\`\`
+
+For \`owner\`/\`repo\` on GitHub Pages the feed URL is the deployed
+directory, \`https://owner.github.io/repo/\`, e.g.
+\`/subscribe?source=https%3A%2F%2Fowner.github.io%2Frepo%2F\`.
+`;
   }
+});
+
+// src/cli/skills.ts
+var skills_exports = {};
+__export(skills_exports, {
+  bundledSkillsRoot: () => bundledSkillsRoot,
+  installSkills: () => installSkills,
+  listBundledSkills: () => listBundledSkills
+});
+function frontmatterField(source, key) {
+  const match = source.match(new RegExp(`^${key}:[ 	]*(.*)$`, "m"));
+  return match?.[1].trim().replace(/^(['"])(.*)\1$/, "$2") || void 0;
 }
-function seedNoteIdSync(path) {
-  const hash = crypto.createHash("sha1").update(`${contract_exports.SEED_NAMESPACE}:${path}`).digest();
-  const bytes = new Uint8Array(hash.subarray(0, 16));
-  bytes[6] = bytes[6] & 15 | 80;
-  bytes[8] = bytes[8] & 63 | 128;
-  return [...bytes].map((b, i) => [4, 6, 8, 10].includes(i) ? `-${b.toString(16).padStart(2, "0")}` : b.toString(16).padStart(2, "0")).join("");
-}
-function getFileCommit(file, repoRoot) {
-  try {
-    return child_process.execFileSync("git", ["log", "-1", "--format=%H", "--", file], { cwd: repoRoot, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim();
-  } catch {
-    return "";
-  }
+function listBundledSkills(root) {
+  if (!fs.existsSync(root)) return [];
+  return fs.readdirSync(root, { withFileTypes: true }).filter((entry) => entry.isDirectory() && fs.existsSync(path.join(root, entry.name, "SKILL.md"))).sort((a, b) => a.name.localeCompare(b.name)).map((entry) => {
+    const source = fs.readFileSync(path.join(root, entry.name, "SKILL.md"), "utf-8");
+    return {
+      name: entry.name,
+      description: frontmatterField(source, "description") ?? "",
+      path: path.join(root, entry.name)
+    };
+  });
 }
-function getFileVersion(file, repoRoot) {
-  try {
-    const out = child_process.execFileSync("git", ["rev-list", "--count", "HEAD", "--", file], { cwd: repoRoot, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim();
-    const count = Number(out);
-    return Number.isFinite(count) && count > 0 ? count : 1;
-  } catch {
-    return 1;
-  }
+function bundledSkillsRoot() {
+  const scriptDir = path.dirname(fs.realpathSync(process.argv[1] ?? process.cwd()));
+  const candidates = ["skills", "../skills", "../../skills", "../../../skills", "../../../../skills"].map(
+    (rel) => path.resolve(scriptDir, rel)
+  );
+  return candidates.find((candidate) => listBundledSkills(candidate).length > 0);
 }
-function getPathVersion(targetPath, repoRoot) {
-  try {
-    const out = child_process.execFileSync("git", ["rev-list", "--count", "HEAD", "--", targetPath], { cwd: repoRoot, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim();
-    const count = Number(out);
-    return Number.isFinite(count) && count > 0 ? count : 1;
-  } catch {
-    return 1;
+function installSkills(options = {}) {
+  const root = options.root ?? bundledSkillsRoot();
+  if (!root) {
+    throw new Error("no bundled skills found next to this CLI \u2014 reinstall the package or run from the wod-wiki checkout");
   }
-}
-function getPathCommit(targetPath, repoRoot) {
-  try {
-    return child_process.execFileSync("git", ["log", "-1", "--format=%H", "--", targetPath], { cwd: repoRoot, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim();
-  } catch {
-    return "";
+  const skills = listBundledSkills(root);
+  if (skills.length === 0) throw new Error(`no skills under ${root}`);
+  const target = path.join(path.resolve(options.dir ?? process.cwd()), ".agents", "skills");
+  const installed = [];
+  const skipped = [];
+  for (const skill of skills) {
+    const destination = path.join(target, skill.name);
+    if (fs.existsSync(destination) && options.force !== true) {
+      skipped.push(skill.name);
+      continue;
+    }
+    fs.rmSync(destination, { recursive: true, force: true });
+    fs.mkdirSync(target, { recursive: true });
+    fs.cpSync(skill.path, destination, { recursive: true });
+    installed.push(skill.name);
   }
+  return { root, target, installed, skipped };
 }
-function getPathUpdatedAt(targetPath, repoRoot) {
-  try {
-    const out = child_process.execFileSync("git", ["log", "-1", "--format=%cI", "--", targetPath], { cwd: repoRoot, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim();
-    return out || void 0;
-  } catch {
-    return void 0;
+var init_skills = __esm({
+  "src/cli/skills.ts"() {
   }
-}
-function groupCorpusPath(id) {
-  if (id.startsWith("notebook.")) {
-    const slug = id.slice("notebook.".length);
-    return slug === "_root" ? "markdown/notebooks" : `markdown/notebooks/${slug}`;
+});
+
+// src/seedbuild/contract.ts
+var contract_exports = {};
+var init_contract = __esm({
+  "src/seedbuild/contract.ts"() {
+    __reExport(contract_exports, wod_wiki_engine_star__namespace);
   }
-  return `markdown/${id}`;
-}
-function frontmatterDateToCreatedAt(raw, path) {
-  const value = wodWikiCore.getScalar(wodWikiCore.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)`);
+});
+
+// src/seedbuild/filename.ts
+function fileToDisplayName(filename) {
+  const base = filename.replace(/\.md$/, "");
+  if (base.toUpperCase() === "README") return "Overview";
+  const cleaned = base.replace(/^day-\d+-/, "");
+  const tokens = cleaned.split(/[-_]/);
+  const titled = [];
+  for (let i = 0; i < tokens.length; i++) {
+    const token = tokens[i];
+    const next = tokens[i + 1];
+    const after = tokens[i + 2];
+    const prev = tokens[i - 1];
+    if (/^\d{1,2}$/.test(token) && /^\d{1,2}$/.test(next ?? "") && !/^\d+$/.test(prev ?? "") && !/^\d+$/.test(after ?? "")) {
+      titled.push(`${token}.${next}`);
+      i++;
+      continue;
+    }
+    if (titled.length > 0 && FILE_TITLE_STOP_WORDS[token.toLowerCase()]) {
+      titled.push(token.toLowerCase());
+      continue;
+    }
+    titled.push(token.charAt(0).toUpperCase() + token.slice(1));
   }
-  return ts;
+  return titled.join(" ");
 }
-function dateKeyToCreatedAt(dateKey) {
-  if (!/^\d{4}-\d{2}-\d{2}$/.test(dateKey)) return 0;
-  const ts = Date.parse(`${dateKey}T00:00:00Z`);
-  return Number.isNaN(ts) ? 0 : ts;
+var FILE_TITLE_STOP_WORDS;
+var init_filename = __esm({
+  "src/seedbuild/filename.ts"() {
+    FILE_TITLE_STOP_WORDS = {
+      and: true,
+      or: true,
+      of: true,
+      for: true,
+      to: true,
+      in: true,
+      on: true,
+      at: true,
+      by: true,
+      with: true,
+      the: true,
+      a: true,
+      an: true
+    };
+  }
+});
+function resolveGitVersion(repoRoot) {
+  try {
+    const run = (args) => child_process.execSync(`git ${args}`, { cwd: repoRoot, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim();
+    const count = Number(run("rev-list --count HEAD"));
+    return {
+      version: Number.isFinite(count) && count > 0 ? count : 0,
+      versionLabel: run("describe --tags --long --always --dirty"),
+      commit: run("rev-parse HEAD"),
+      dirty: run("status --porcelain") !== ""
+    };
+  } catch {
+    return UNKNOWN_GIT_VERSION;
+  }
 }
-function compileSeedRow(path, content, metadata = {}) {
-  let ordinal = 0;
-  const blocks = wodWikiCore.reconcileNoteBlocks(content, { sourceRevision: 1, registeredWidgets: contract_exports.SEED_REGISTERED_WIDGETS, createId: () => `seed:${path}:${ordinal++}` });
-  const noteId = metadata.routeId ?? path;
-  const sections = wodWikiCore.parseDocumentSections(content);
-  const blockIndex = Object.values(blocks).map((block, position) => {
-    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: [], blockEquipment: [] };
+var UNKNOWN_GIT_VERSION;
+var init_git_version = __esm({
+  "src/seedbuild/git-version.ts"() {
+    UNKNOWN_GIT_VERSION = {
+      version: 0,
+      versionLabel: "unknown",
+      commit: "",
+      dirty: false
+    };
+  }
+});
+var init_frontmatter = __esm({
+  "src/seedbuild/frontmatter.ts"() {
+  }
+});
+
+// src/seedbuild/validation.ts
+var validation_exports = {};
+var init_validation = __esm({
+  "src/seedbuild/validation.ts"() {
+    __reExport(validation_exports, wod_wiki_engine_star__namespace);
+  }
+});
+
+// src/seedbuild/compiler.ts
+var compiler_exports = {};
+__export(compiler_exports, {
+  buildBlockEffortRows: () => buildBlockEffortRows,
+  buildBlockEquipmentRows: () => buildBlockEquipmentRows,
+  buildBlockIndexRows: () => buildBlockIndexRows,
+  chunkIdFor: () => chunkIdFor,
+  collectCorpusMarkdown: () => collectCorpusMarkdown,
+  compileSeedRow: () => compileSeedRow,
+  dateKeyToCreatedAt: () => dateKeyToCreatedAt,
+  discoverUncatalogedEfforts: () => discoverUncatalogedEfforts,
+  frontmatterDateToCreatedAt: () => frontmatterDateToCreatedAt,
+  generateSeed: () => generateSeed,
+  getFileCommit: () => getFileCommit,
+  getFileVersion: () => getFileVersion,
+  getPathCommit: () => getPathCommit,
+  getPathUpdatedAt: () => getPathUpdatedAt,
+  getPathVersion: () => getPathVersion,
+  groupCorpusPath: () => groupCorpusPath,
+  loadCorpusReferenceCatalog: () => loadCorpusReferenceCatalog,
+  partitionIntoChunks: () => partitionIntoChunks,
+  scaffoldDiscoveredEfforts: () => scaffoldDiscoveredEfforts,
+  seedNoteIdSync: () => seedNoteIdSync,
+  validateDashboardNote: () => validateDashboardNote,
+  validateWodBlockSyntax: () => validateWodBlockSyntax
+});
+function listMarkdownFiles(dir, prefix = "") {
+  if (!fs.existsSync(dir)) return [];
+  const out = [];
+  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+    const rel = prefix ? `${prefix}/${entry.name}` : entry.name;
+    if (entry.isDirectory()) out.push(...listMarkdownFiles(path.join(dir, entry.name), rel));
+    else if (entry.isFile() && entry.name.endsWith(".md")) out.push(rel);
+  }
+  return out.sort();
 }
-function buildBlockIndexRows(markdownDir, corpusRoot, excludePaths = []) {
-  const rows = [];
-  for (const path$1 of collectCorpusMarkdown(markdownDir, excludePaths)) {
-    const chunkId = chunkIdFor(path$1);
-    if (!chunkId) continue;
-    const content = fs.readFileSync(path.join(corpusRoot, path$1), "utf8");
-    const parts = path$1.split("/");
-    const stem = (parts.at(-1) ?? "").replace(/\.md$/, "");
-    const slug = parts[2];
-    const routeId = chunkId === "canvas" ? (0, contract_exports.canvasRouteSlug)(content) ?? void 0 : chunkId.startsWith("notebook.") ? stem.toLowerCase() === "readme" ? slug : parts.slice(2).join("/").replace(/\.md$/, "") : void 0;
-    const sourceId = (0, contract_exports.seedNoteSourceId)(path$1, content, chunkId);
-    const createdAt = frontmatterDateToCreatedAt(content, path$1) ?? (chunkId.startsWith("notebook.") && /^\d{4}-\d{2}-\d{2}$/.test(parts.at(-2) ?? "") ? dateKeyToCreatedAt(parts.at(-2) ?? "") : getFileCreatedAt(path$1, corpusRoot));
-    rows.push(...compileSeedRow(path$1, content, { routeId, sourceId, createdAt }).blockIndex);
+function chunkIdFor(relPath) {
+  const parts = relPath.split("/");
+  if (parts[0] !== "markdown" || parts.length < 2) return null;
+  const corpus = parts[1];
+  if (parts.length === 2) return null;
+  const slug = parts[2]?.replace(/\.md$/, "");
+  switch (corpus) {
+    case "canvas":
+    case "dashboards":
+    case "efforts":
+    case "equipment":
+      return corpus;
+    case "notebooks":
+      return parts.length === 3 ? `notebook._root` : `notebook.${slug}`;
+    default:
+      return null;
   }
-  return rows;
 }
-function validateWodBlockSyntax(blocks) {
+function collectCorpusMarkdown(markdownDir, excludePaths = []) {
+  const excluded = new Set(excludePaths);
+  return listMarkdownFiles(markdownDir).map((p) => `markdown/${p}`).filter((path) => !excluded.has(path));
+}
+function partitionIntoChunks(paths) {
+  const byId = /* @__PURE__ */ new Map();
+  for (const p of 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 | equipment | notebooks). Extend chunkIdFor() if this is a new corpus.`
+      );
+    }
+    const list = byId.get(id);
+    if (list) list.push(p);
+    else byId.set(id, [p]);
+  }
+  return [...byId.entries()].sort(([a], [b]) => a < b ? -1 : 1).map(([id, files]) => ({ id, files }));
+}
+function validateDashboardNote(raw) {
   const problems = [];
-  for (const block of blocks) {
-    if (block.dataType !== "wod" || !block.rawContent?.trim()) continue;
-    const section = wodWikiCore.parseDocumentSections(block.rawContent, { registeredWidgets: contract_exports.SEED_REGISTERED_WIDGETS }).find((s) => s.scriptBlock);
-    const source = section?.scriptBlock?.content ?? block.rawContent;
-    if (!source.trim()) continue;
-    const where = block.sourcePath ?? block.noteId;
-    if (section?.sport) {
-      const parsed = wodWikiLang.parseScript(source, { sport: section.sport });
-      for (const error of parsed.errors ?? []) {
-        problems.push(`${where}: ${error.message}`);
-      }
-      continue;
+  const { meta } = wodWikiCore.parseFrontmatter(raw);
+  const { sections } = wodWikiWql.parseDashboardNote(raw);
+  const doc = wodWikiWql.buildDashboardDocument(sections, meta);
+  if (!doc.isDashboard) return ["file is not a dashboard note (missing dashboard frontmatter)"];
+  if (doc.title === void 0) problems.push("dashboard has no title");
+  if (doc.widgets.length < 3) problems.push(`dashboard has only ${doc.widgets.length} widgets (the locked format has \u2265 3)`);
+  const declared = new Set(doc.tokens.map((t) => t.name));
+  for (const widget of doc.widgets) {
+    const where = `widget '${widget.title ?? widget.body.slice(0, 40)}'`;
+    if (widget.title === void 0) problems.push(`${where}: missing title`);
+    if (!wodWikiWql.isDashboardWidgetType(wodWikiWql.resolveWidgetType(widget.type))) {
+      problems.push(`${where}: unknown widget type '${widget.type}'`);
     }
-    const doc = source.endsWith("\n") ? source : source + "\n";
-    const tree = wodWikiLang.whiteboardParser.parse(doc);
-    tree.iterate({
-      enter: (node) => {
-        if (!node.type.isError) return;
-        const line = doc.slice(0, node.from).split("\n").length;
-        const snippet = source.slice(node.from, Math.min(node.to, node.from + 60)).split("\n")[0];
-        problems.push(`${where}:${line} \`${snippet}\``);
+    if (widget.body.includes("\n")) {
+      const docParsed = wodWikiWql.parseDocument(widget.body);
+      if (docParsed.diagnostics.length > 0) {
+        problems.push(`${where}: QueryDocument error: ${docParsed.diagnostics[0]}`);
       }
-    });
+    } else {
+      const parsed = wodWikiWql.parseQuery(widget.body);
+      if (parsed.error !== void 0) problems.push(`${where}: WQL parse error: ${parsed.error}`);
+    }
+    for (const ref of [
+      ...widget.body.matchAll(/\$([A-Za-z][\w-]*)/g),
+      ...Object.values(widget.attributes).flatMap((v) => [...String(v).matchAll(/\$([A-Za-z][\w-]*)/g)])
+    ]) {
+      if (!declared.has(ref[1])) problems.push(`${where}: undeclared token $${ref[1]}`);
+    }
   }
   return problems;
 }
-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 loadCorpusReferenceCatalog(markdownDir) {
-  const efforts = [];
-  const equipment = [];
-  const effortsDir = path.join(markdownDir, "efforts");
-  for (const file of listMarkdownFiles(effortsDir)) {
-    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);
+function gateDashboards(groups, corpusRoot) {
+  for (const group of groups) {
+    if (group.id !== contract_exports.DASHBOARDS_CHUNK_ID) continue;
+    for (const p of group.files) {
+      const problems = validateDashboardNote(fs.readFileSync(path.join(corpusRoot, p), "utf8"));
+      if (problems.length > 0) {
+        throw new Error(`[generate-seed] Dashboard validation failed for '${p}':
+  - ${problems.join("\n  - ")}`);
+      }
+    }
   }
-  return { efforts, equipment };
+}
+function getFileCreatedAt(file, repoRoot) {
+  try {
+    const out = child_process.execSync(`git log -1 --format=%ct -- '${file}'`, { cwd: repoRoot, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim();
+    const ts = Number(out) * 1e3;
+    return Number.isFinite(ts) && ts > 0 ? ts : 0;
+  } catch {
+    return 0;
+  }
+}
+function seedNoteIdSync(path) {
+  const hash = crypto.createHash("sha1").update(`${contract_exports.SEED_NAMESPACE}:${path}`).digest();
+  const bytes = new Uint8Array(hash.subarray(0, 16));
+  bytes[6] = bytes[6] & 15 | 80;
+  bytes[8] = bytes[8] & 63 | 128;
+  return [...bytes].map((b, i) => [4, 6, 8, 10].includes(i) ? `-${b.toString(16).padStart(2, "0")}` : b.toString(16).padStart(2, "0")).join("");
+}
+function getFileCommit(file, repoRoot) {
+  try {
+    return child_process.execFileSync("git", ["log", "-1", "--format=%H", "--", file], { cwd: repoRoot, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim();
+  } catch {
+    return "";
+  }
+}
+function getFileVersion(file, repoRoot) {
+  try {
+    const out = child_process.execFileSync("git", ["rev-list", "--count", "HEAD", "--", file], { cwd: repoRoot, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim();
+    const count = Number(out);
+    return Number.isFinite(count) && count > 0 ? count : 1;
+  } catch {
+    return 1;
+  }
+}
+function getPathVersion(targetPath, repoRoot) {
+  try {
+    const out = child_process.execFileSync("git", ["rev-list", "--count", "HEAD", "--", targetPath], { cwd: repoRoot, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim();
+    const count = Number(out);
+    return Number.isFinite(count) && count > 0 ? count : 1;
+  } catch {
+    return 1;
+  }
+}
+function getPathCommit(targetPath, repoRoot) {
+  try {
+    return child_process.execFileSync("git", ["log", "-1", "--format=%H", "--", targetPath], { cwd: repoRoot, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim();
+  } catch {
+    return "";
+  }
+}
+function getPathUpdatedAt(targetPath, repoRoot) {
+  try {
+    const out = child_process.execFileSync("git", ["log", "-1", "--format=%cI", "--", targetPath], { cwd: repoRoot, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim();
+    return out || void 0;
+  } catch {
+    return void 0;
+  }
+}
+function groupCorpusPath(id) {
+  if (id.startsWith("notebook.")) {
+    const slug = id.slice("notebook.".length);
+    return slug === "_root" ? "markdown/notebooks" : `markdown/notebooks/${slug}`;
+  }
+  return `markdown/${id}`;
+}
+function frontmatterDateToCreatedAt(raw, path) {
+  const value = wodWikiCore.getScalar(wodWikiCore.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 dateKeyToCreatedAt(dateKey) {
+  if (!/^\d{4}-\d{2}-\d{2}$/.test(dateKey)) return 0;
+  const ts = Date.parse(`${dateKey}T00:00:00Z`);
+  return Number.isNaN(ts) ? 0 : ts;
+}
+function compileCompanionTelemetry(path, jsonl, blockIndex) {
+  const firstWod = blockIndex.find((block) => block.dataType === "wod");
+  const noteId = seedNoteIdSync(path);
+  const normalized = jsonl.split(/\r?\n/).map((line) => {
+    if (!line.trim()) return line;
+    const parsed2 = JSON.parse(line);
+    if (typeof parsed2 !== "object" || parsed2 === null || Array.isArray(parsed2)) return line;
+    const record = { ...parsed2, noteId };
+    if (record.kind === "session" || record.kind === "event") {
+      if (!firstWod) throw new Error(`Telemetry for '${path}' requires a wod block`);
+      if (record.blockId === void 0 || record.blockId === "@first-wod") record.blockId = firstWod.blockId;
+      if (record.blockVersion === void 0 || record.blockVersion === "@first-wod") record.blockVersion = firstWod.blockVersion;
+      if (record.blockContentId === void 0 || record.blockContentId === "@first-wod") record.blockContentId = firstWod.blockContentId;
+    }
+    return JSON.stringify(record);
+  }).join("\n");
+  const parsed = wodWikiCore.parseNoteBundleFromJsonl(normalized);
+  if (parsed.errors.length > 0) throw new Error(`Invalid telemetry companion '${path}': ${parsed.errors.join("; ")}`);
+  return {
+    sessions: parsed.bundles.flatMap((bundle) => bundle.sessions),
+    events: parsed.bundles.flatMap((bundle) => bundle.events)
+  };
+}
+function compileSeedRow(path, content, metadata = {}) {
+  let ordinal = 0;
+  const blocks = wodWikiCore.reconcileNoteBlocks(content, { sourceRevision: 1, registeredWidgets: contract_exports.SEED_REGISTERED_WIDGETS, createId: () => `seed:${path}:${ordinal++}` });
+  const noteId = metadata.routeId ?? path;
+  const sections = wodWikiCore.parseDocumentSections(content);
+  const blockIndex = Object.values(blocks).map((block, position) => {
+    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 };
+  });
+  const telemetry = metadata.telemetryJsonl === void 0 ? void 0 : compileCompanionTelemetry(path, metadata.telemetryJsonl, blockIndex);
+  return { path, content, blocks, blockIndex, blockEfforts: [], blockEquipment: [], ...telemetry ? { telemetry } : {} };
+}
+function buildBlockIndexRows(markdownDir, corpusRoot, excludePaths = []) {
+  const rows = [];
+  for (const path$1 of collectCorpusMarkdown(markdownDir, excludePaths)) {
+    const chunkId = chunkIdFor(path$1);
+    if (!chunkId) continue;
+    const content = fs.readFileSync(path.join(corpusRoot, path$1), "utf8");
+    const parts = path$1.split("/");
+    const stem = (parts.at(-1) ?? "").replace(/\.md$/, "");
+    const slug = parts[2];
+    const routeId = chunkId === "canvas" ? (0, contract_exports.canvasRouteSlug)(content) ?? void 0 : chunkId.startsWith("notebook.") ? stem.toLowerCase() === "readme" ? slug : parts.slice(2).join("/").replace(/\.md$/, "") : void 0;
+    const sourceId = (0, contract_exports.seedNoteSourceId)(path$1, content, chunkId);
+    const createdAt = frontmatterDateToCreatedAt(content, path$1) ?? (chunkId.startsWith("notebook.") && /^\d{4}-\d{2}-\d{2}$/.test(parts.at(-2) ?? "") ? dateKeyToCreatedAt(parts.at(-2) ?? "") : getFileCreatedAt(path$1, corpusRoot));
+    rows.push(...compileSeedRow(path$1, content, { routeId, sourceId, createdAt }).blockIndex);
+  }
+  return rows;
+}
+function validateWodBlockSyntax(blocks) {
+  const problems = [];
+  for (const block of blocks) {
+    if (block.dataType !== "wod" || !block.rawContent?.trim()) continue;
+    const section = wodWikiCore.parseDocumentSections(block.rawContent, { registeredWidgets: contract_exports.SEED_REGISTERED_WIDGETS }).find((s) => s.scriptBlock);
+    const source = section?.scriptBlock?.content ?? block.rawContent;
+    if (!source.trim()) continue;
+    const where = block.sourcePath ?? block.noteId;
+    if (section?.sport) {
+      const parsed = wodWikiLang.parseScript(source, { sport: section.sport });
+      for (const error of parsed.errors ?? []) {
+        problems.push(`${where}: ${error.message}`);
+      }
+      continue;
+    }
+    const doc = source.endsWith("\n") ? source : source + "\n";
+    const tree = wodWikiLang.whiteboardParser.parse(doc);
+    tree.iterate({
+      enter: (node) => {
+        if (!node.type.isError) return;
+        const line = doc.slice(0, node.from).split("\n").length;
+        const snippet = source.slice(node.from, Math.min(node.to, node.from + 60)).split("\n")[0];
+        problems.push(`${where}:${line} \`${snippet}\``);
+      }
+    });
+  }
+  return problems;
+}
+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 loadCorpusReferenceCatalog(markdownDir) {
+  const efforts = [];
+  const equipment = [];
+  const effortsDir = path.join(markdownDir, "efforts");
+  for (const file of listMarkdownFiles(effortsDir)) {
+    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 { efforts, equipment };
 }
 function discoverUncatalogedEfforts(markdownDir, corpusRoot, excludePaths = []) {
   const catalog = loadCorpusReferenceCatalog(markdownDir);
@@ -913,434 +1271,168 @@ ${shown}${more}`);
   }
   for (const row of effortRows) {
     const rows = effortsByPath.get(row.sourcePath) ?? [];
-    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 manifestNotebooks = [];
-  const manifestBuiltAt = (/* @__PURE__ */ new Date()).toISOString();
-  const tWrite = Date.now();
-  for (const { id, files } of groups) {
-    const records = [];
-    const rows = files.map((p) => {
-      const raw = fs.readFileSync(path.join(corpusRoot, p), "utf8");
-      const content = raw;
-      const compiled = compileSeedRow(p, content);
-      compiled.blockIndex = blocksByPath.get(p) ?? compiled.blockIndex;
-      compiled.blockEfforts = effortsByPath.get(p) ?? [];
-      compiled.blockEquipment = equipmentByPath.get(p) ?? [];
-      const fileCommit = getFileCommit(p, corpusRoot) || gitVersion.commit || "";
-      const fileVer = getFileVersion(p, corpusRoot);
-      const uuid = seedNoteIdSync(p);
-      compiled.commit = fileCommit;
-      compiled.uuid = uuid;
-      compiled.version = fileVer;
-      const recordRelPath = p.replace(/\.md$/, ".json");
-      const recordOutFile = path.join(outDir, recordRelPath);
-      fs.mkdirSync(path.dirname(recordOutFile), { recursive: true });
-      const recordBytes = Buffer.from(JSON.stringify(compiled, null, 2), "utf8");
-      fs.writeFileSync(recordOutFile, recordBytes);
-      const title = compiled.blockIndex[0]?.noteTitle ?? fileToDisplayName(p.split("/").at(-1) ?? p);
-      records.push({
-        uuid,
-        path: p,
-        recordPath: recordRelPath,
-        commit: fileCommit,
-        version: fileVer,
-        sha256: sha256Hex(recordBytes),
-        title,
-        date: frontmatterDateToCreatedAt(content, p)
-      });
-      return compiled;
-    });
-    (0, validation_exports.assertSeedRows)(rows);
-    const bytes = Buffer.from(JSON.stringify(rows), "utf8");
-    const sha = sha256Hex(bytes);
-    const file = `chunks/${id}.${sha.slice(0, 8)}.json`;
-    fs.writeFileSync(path.join(outDir, file), bytes);
-    manifestChunks.push({ id, path: file, sha256: sha, bytes: bytes.length, count: rows.length });
-    totalFiles += rows.length;
-    const groupPath = groupCorpusPath(id);
-    const groupVersion = getPathVersion(groupPath, corpusRoot);
-    const groupCommit = getPathCommit(groupPath, corpusRoot) || gitVersion.commit || "";
-    const groupUpdatedAt = getPathUpdatedAt(groupPath, corpusRoot);
-    const notebookIndexPath = `indexes/notebooks/${id}.json`;
-    const summary = {
-      notebookId: id,
-      label: fileToDisplayName(id.split(".").at(-1) ?? id),
-      category: (0, contract_exports.notebookSlugForChunkId)(id),
-      indexPath: notebookIndexPath,
-      version: groupVersion,
-      commit: groupCommit,
-      updatedAt: groupUpdatedAt,
-      builtAt: manifestBuiltAt,
-      sha256: sha,
-      bytes: bytes.length,
-      count: rows.length
-    };
-    const notebookIndex = {
-      ...summary,
-      records
-    };
-    (0, validation_exports.assertNotebookIndex)(notebookIndex);
-    const indexOutFile = path.join(outDir, notebookIndexPath);
-    fs.mkdirSync(path.dirname(indexOutFile), { recursive: true });
-    fs.writeFileSync(indexOutFile, JSON.stringify(notebookIndex, null, 2) + "\n");
-    manifestNotebooks.push(summary);
-  }
-  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: contract_exports.SEED_SCHEMA,
-    version: gitVersion.version,
-    versionLabel: gitVersion.versionLabel,
-    commit: gitVersion.commit,
-    dirty: gitVersion.dirty,
-    builtAt: manifestBuiltAt,
-    chunks: manifestChunks,
-    notebooks: manifestNotebooks
-  };
-  (0, validation_exports.assertSeedManifest)(manifest);
-  fs.writeFileSync(path.join(outDir, "manifest.json"), JSON.stringify(manifest, null, 2) + "\n");
-  const reportPath = writeBuildReport(outDir, {
-    manifest,
-    totalMs: Date.now() - t0,
-    passMs,
-    fileCount: paths.length});
-  return { manifest, outDir, totalFiles, reportPath, passMs };
-}
-var NON_EFFORT_SLUGS;
-var init_compiler = __esm({
-  "src/seedbuild/compiler.ts"() {
-    init_contract();
-    init_filename();
-    init_git_version();
-    init_report();
-    init_frontmatter();
-    init_validation();
-    NON_EFFORT_SLUGS = {
-      "amrap": true,
-      "emom": true,
-      "tabata": true,
-      "for-time": true,
-      "rounds": true,
-      "sets": true,
-      "repetitions": true,
-      "count-down": true,
-      "total-reps": true,
-      "warmup": true,
-      "cooldown": true,
-      "cool-down": true,
-      "transition": true,
-      "rest": true,
-      "break": true,
-      "work": true,
-      "i-suck-at-this": true,
-      "isuckatthis": true,
-      "movement": true,
-      "movement-you": true,
-      "selected-exercise": true,
-      "training-setup": true,
-      "grade-system": true,
-      "hangs": true,
-      "warm-light-wind": true,
-      "basin": true,
-      "rock-canyon": true,
-      "b-onsight": true,
-      "a-redpoint": true,
-      "d-redpoint": true,
-      "v0-flash": true,
-      "v2-flash": true,
-      "v7-redpoint": true,
-      "avgrpe-mean": true,
-      "calculate": true,
-      "totalload-sum": true,
-      "query": true,
-      "by": true,
-      "": true,
-      "-": true,
-      "...": true,
-      "x": true,
-      "s": true,
-      "bw": true
-    };
-  }
-});
-
-// src/version.ts
-var VERSION;
-var init_version = __esm({
-  "src/version.ts"() {
-    VERSION = "0.51.2195";
-  }
-});
-
-// src/cli/scaffoldFeed.ts
-var scaffoldFeed_exports = {};
-__export(scaffoldFeed_exports, {
-  scaffoldFeed: () => scaffoldFeed,
-  validateFeedName: () => validateFeedName
-});
-function validateFeedName(name) {
-  if (name.length === 0 || name === "." || name === "..") {
-    throw new Error("Feed name must be a single non-empty directory name");
-  }
-  if (name.includes("/") || name.includes("\\") || name.includes("\0")) {
-    throw new Error(`Invalid feed name '${name}': must be a single directory name (no path separators or traversal)`);
-  }
-  if (/^(?:[A-Za-z]:)?[/\\]/.test(name)) {
-    throw new Error(`Invalid feed name '${name}': absolute paths are not allowed`);
-  }
-  if (name.length > 214 || !/^[a-z0-9][a-z0-9._-]*$/.test(name)) {
-    throw new Error(
-      `Invalid feed name '${name}': must be a valid npm package name (lowercase letters, digits, dots, hyphens, underscores; no leading dot/hyphen)`
-    );
-  }
-  return name;
-}
-function scaffoldFeed(name, opts = {}) {
-  validateFeedName(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 feed: ${name}`,
-        scripts: {
-          build: "wod build . --output dist"
-        },
-        devDependencies: {
-          "@bitcobblers/wod-wiki-tools": `^${VERSION}`
-        }
-      },
-      null,
-      2
-    )}
-`],
-    [".gitignore", "node_modules/\ndist/\n"],
-    [".github/workflows/publish-feed.yml", publishWorkflow()],
-    ["markdown/notebooks/example/README.md", feedReadme(name)],
-    [`markdown/notebooks/example/morning-session.md`, exampleWorkout(date)],
-    ["README.md", repoReadme(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, feedReadme, exampleWorkout, repoReadme;
-var init_scaffoldFeed = __esm({
-  "src/cli/scaffoldFeed.ts"() {
-    init_version();
-    publishWorkflow = () => `name: Publish feed
-
-# Compile the feed 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
-`;
-    feedReadme = (name) => `# ${name}
-
-Example benchmark notebook. Each \`.md\` file in this directory becomes part of
-the \`example\` notebook chunk; \`README.md\` is the notebook'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
-\`\`\`
-`;
-    repoReadme = (name) => `# ${name}
-
-A [WOD Wiki](https://github.com/bitcobblers/wod-wiki) workout feed: 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
-feed. 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-feed.yml\`)
-builds the feed on every push to \`main\` and deploys \`dist/\`.
-
-## Share
-
-Once published, anyone can subscribe to this feed from a WOD Wiki instance
-at:
-
-\`\`\`
-<app-url>/subscribe?source=<url-encoded published feed URL>
-\`\`\`
-
-For \`owner\`/\`repo\` on GitHub Pages the feed URL is the deployed
-directory, \`https://owner.github.io/repo/\`, e.g.
-\`/subscribe?source=https%3A%2F%2Fowner.github.io%2Frepo%2F\`.
-`;
+    rows.push(row);
+    effortsByPath.set(row.sourcePath, rows);
   }
-});
-
-// src/cli/skills.ts
-var skills_exports = {};
-__export(skills_exports, {
-  bundledSkillsRoot: () => bundledSkillsRoot,
-  installSkills: () => installSkills,
-  listBundledSkills: () => listBundledSkills
-});
-function frontmatterField(source, key) {
-  const match = source.match(new RegExp(`^${key}:[ 	]*(.*)$`, "m"));
-  return match?.[1].trim().replace(/^(['"])(.*)\1$/, "$2") || void 0;
-}
-function listBundledSkills(root) {
-  if (!fs.existsSync(root)) return [];
-  return fs.readdirSync(root, { withFileTypes: true }).filter((entry) => entry.isDirectory() && fs.existsSync(path.join(root, entry.name, "SKILL.md"))).sort((a, b) => a.name.localeCompare(b.name)).map((entry) => {
-    const source = fs.readFileSync(path.join(root, entry.name, "SKILL.md"), "utf-8");
-    return {
-      name: entry.name,
-      description: frontmatterField(source, "description") ?? "",
-      path: path.join(root, entry.name)
-    };
-  });
-}
-function bundledSkillsRoot() {
-  const scriptDir = path.dirname(fs.realpathSync(process.argv[1] ?? process.cwd()));
-  const candidates = ["skills", "../skills", "../../skills", "../../../skills", "../../../../skills"].map(
-    (rel) => path.resolve(scriptDir, rel)
-  );
-  return candidates.find((candidate) => listBundledSkills(candidate).length > 0);
-}
-function installSkills(options = {}) {
-  const root = options.root ?? bundledSkillsRoot();
-  if (!root) {
-    throw new Error("no bundled skills found next to this CLI \u2014 reinstall the package or run from the wod-wiki checkout");
+  for (const row of equipmentRows) {
+    const rows = equipmentByPath.get(row.sourcePath) ?? [];
+    rows.push(row);
+    equipmentByPath.set(row.sourcePath, rows);
   }
-  const skills = listBundledSkills(root);
-  if (skills.length === 0) throw new Error(`no skills under ${root}`);
-  const target = path.join(path.resolve(options.dir ?? process.cwd()), ".agents", "skills");
-  const installed = [];
-  const skipped = [];
-  for (const skill of skills) {
-    const destination = path.join(target, skill.name);
-    if (fs.existsSync(destination) && options.force !== true) {
-      skipped.push(skill.name);
-      continue;
-    }
-    fs.rmSync(destination, { recursive: true, force: true });
-    fs.mkdirSync(target, { recursive: true });
-    fs.cpSync(skill.path, destination, { recursive: true });
-    installed.push(skill.name);
+  let totalFiles = 0;
+  const manifestNotebooks = [];
+  const manifestBuiltAt = (/* @__PURE__ */ new Date()).toISOString();
+  const tWrite = Date.now();
+  for (const { id, files } of groups) {
+    const records = [];
+    const rows = files.map((p) => {
+      const raw = fs.readFileSync(path.join(corpusRoot, p), "utf8");
+      const content = raw;
+      const companionPath = path.join(corpusRoot, p.replace(/\.md$/, ".jsonl"));
+      const compiled = compileSeedRow(p, content, { telemetryJsonl: fs.existsSync(companionPath) ? fs.readFileSync(companionPath, "utf8") : void 0 });
+      compiled.blockIndex = blocksByPath.get(p) ?? compiled.blockIndex;
+      compiled.blockEfforts = effortsByPath.get(p) ?? [];
+      compiled.blockEquipment = equipmentByPath.get(p) ?? [];
+      const fileCommit = getFileCommit(p, corpusRoot) || gitVersion.commit || "";
+      const fileVer = getFileVersion(p, corpusRoot);
+      const uuid = seedNoteIdSync(p);
+      compiled.commit = fileCommit;
+      compiled.uuid = uuid;
+      compiled.version = fileVer;
+      const recordRelPath = p.replace(/\.md$/, ".json");
+      const recordOutFile = path.join(outDir, recordRelPath);
+      fs.mkdirSync(path.dirname(recordOutFile), { recursive: true });
+      const recordBytes = Buffer.from(JSON.stringify(compiled, null, 2), "utf8");
+      fs.writeFileSync(recordOutFile, recordBytes);
+      if (compiled.telemetry) {
+        fs.writeFileSync(path.join(outDir, p.replace(/\.md$/, ".jsonl")), wodWikiCore.serializeNoteBundleToJsonl(compiled.telemetry) + "\n");
+      }
+      const title = compiled.blockIndex[0]?.noteTitle ?? fileToDisplayName(p.split("/").at(-1) ?? p);
+      records.push({
+        uuid,
+        path: p,
+        recordPath: recordRelPath,
+        commit: fileCommit,
+        version: fileVer,
+        sha256: sha256Hex(recordBytes),
+        title,
+        date: frontmatterDateToCreatedAt(content, p)
+      });
+      return compiled;
+    });
+    (0, validation_exports.assertSeedRows)(rows);
+    const bytes = Buffer.from(JSON.stringify(rows), "utf8");
+    const sha = sha256Hex(bytes);
+    const file = `chunks/${id}.${sha.slice(0, 8)}.json`;
+    fs.writeFileSync(path.join(outDir, file), bytes);
+    manifestChunks.push({ id, path: file, sha256: sha, bytes: bytes.length, count: rows.length });
+    totalFiles += rows.length;
+    const groupPath = groupCorpusPath(id);
+    const groupVersion = getPathVersion(groupPath, corpusRoot);
+    const groupCommit = getPathCommit(groupPath, corpusRoot) || gitVersion.commit || "";
+    const groupUpdatedAt = getPathUpdatedAt(groupPath, corpusRoot);
+    const notebookIndexPath = `indexes/notebooks/${id}.json`;
+    const summary = {
+      notebookId: id,
+      label: fileToDisplayName(id.split(".").at(-1) ?? id),
+      category: (0, contract_exports.notebookSlugForChunkId)(id),
+      indexPath: notebookIndexPath,
+      version: groupVersion,
+      commit: groupCommit,
+      updatedAt: groupUpdatedAt,
+      builtAt: manifestBuiltAt,
+      sha256: sha,
+      bytes: bytes.length,
+      count: rows.length
+    };
+    const notebookIndex = {
+      ...summary,
+      records
+    };
+    (0, validation_exports.assertNotebookIndex)(notebookIndex);
+    const indexOutFile = path.join(outDir, notebookIndexPath);
+    fs.mkdirSync(path.dirname(indexOutFile), { recursive: true });
+    fs.writeFileSync(indexOutFile, JSON.stringify(notebookIndex, null, 2) + "\n");
+    manifestNotebooks.push(summary);
   }
-  return { root, target, installed, skipped };
+  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: contract_exports.SEED_SCHEMA,
+    version: gitVersion.version,
+    versionLabel: gitVersion.versionLabel,
+    commit: gitVersion.commit,
+    dirty: gitVersion.dirty,
+    builtAt: manifestBuiltAt,
+    chunks: manifestChunks,
+    notebooks: manifestNotebooks
+  };
+  (0, validation_exports.assertSeedManifest)(manifest);
+  fs.writeFileSync(path.join(outDir, "manifest.json"), JSON.stringify(manifest, null, 2) + "\n");
+  const reportPath = writeBuildReport(outDir, {
+    manifest,
+    totalMs: Date.now() - t0,
+    passMs,
+    fileCount: paths.length});
+  return { manifest, outDir, totalFiles, reportPath, passMs };
 }
-var init_skills = __esm({
-  "src/cli/skills.ts"() {
+var NON_EFFORT_SLUGS;
+var init_compiler = __esm({
+  "src/seedbuild/compiler.ts"() {
+    init_contract();
+    init_filename();
+    init_git_version();
+    init_report();
+    init_frontmatter();
+    init_validation();
+    NON_EFFORT_SLUGS = {
+      "amrap": true,
+      "emom": true,
+      "tabata": true,
+      "for-time": true,
+      "rounds": true,
+      "sets": true,
+      "repetitions": true,
+      "count-down": true,
+      "total-reps": true,
+      "warmup": true,
+      "cooldown": true,
+      "cool-down": true,
+      "transition": true,
+      "rest": true,
+      "break": true,
+      "work": true,
+      "i-suck-at-this": true,
+      "isuckatthis": true,
+      "movement": true,
+      "movement-you": true,
+      "selected-exercise": true,
+      "training-setup": true,
+      "grade-system": true,
+      "hangs": true,
+      "warm-light-wind": true,
+      "basin": true,
+      "rock-canyon": true,
+      "b-onsight": true,
+      "a-redpoint": true,
+      "d-redpoint": true,
+      "v0-flash": true,
+      "v2-flash": true,
+      "v7-redpoint": true,
+      "avgrpe-mean": true,
+      "calculate": true,
+      "totalload-sum": true,
+      "query": true,
+      "by": true,
+      "": true,
+      "-": true,
+      "...": true,
+      "x": true,
+      "s": true,
+      "bw": true
+    };
   }
 });
 
@@ -1550,10 +1642,75 @@ async function storeRoutes(db, method, sub, url, req) {
   }
   return methodNotAllowed();
 }
-async function apiRoutes(db, req, method, sub, url) {
+function isPublishedFeedAssetPath(pathname) {
+  if (pathname === "/feed" || pathname === "/feed/") return "index.html";
+  if (!pathname.startsWith("/feed/")) return null;
+  const sub = pathname.slice("/feed/".length);
+  if (sub === "index.html" || sub === "manifest.json" || sub === "report.html" || sub.startsWith("chunks/") || sub.startsWith("indexes/") || sub.startsWith("markdown/")) {
+    return sub;
+  }
+  return null;
+}
+async function servePublishedFeed(feedTree, method, relPath) {
+  if (method === "OPTIONS") {
+    return new Response(null, {
+      status: 204,
+      headers: {
+        "access-control-allow-origin": "*",
+        "access-control-allow-methods": "GET, HEAD, OPTIONS"
+      }
+    });
+  }
+  if (method !== "GET") return methodNotAllowed();
+  try {
+    const decoded = decodeURIComponent(relPath);
+    const bytes = await feedTree.read(decoded);
+    const ext = decoded.includes(".") ? decoded.slice(decoded.lastIndexOf(".") + 1).toLowerCase() : "html";
+    const cache = decoded.startsWith("chunks/") ? "public, max-age=31536000, immutable" : "no-cache";
+    const copy = new Uint8Array(bytes.byteLength);
+    copy.set(bytes);
+    return new Response(copy.buffer, {
+      status: 200,
+      headers: {
+        "content-type": MIME[ext] ?? "application/octet-stream",
+        "cache-control": cache,
+        "access-control-allow-origin": "*"
+      }
+    });
+  } catch (err) {
+    if (err instanceof wod_wiki_engine_star.FeedTreeError && err.code === "not-found") return notFound();
+    if (err instanceof wod_wiki_engine_star.FeedTreeError && err.code === "layout") return plain("forbidden", 403);
+    throw err;
+  }
+}
+async function apiRoutes(db, feedTree, req, method, sub, url) {
   if (sub === "/health") {
     return json({ ok: true, driver: db.dialect }, 200);
   }
+  if (sub === "/v1/feed/status" && method === "GET") {
+    const storage = new sql.SqlStorage(db);
+    const status = await wod_wiki_engine_star.checkUnpublishedFeedChanges(storage, feedTree);
+    return json({ ...status, feedUrl: `${url.origin}/feed/` }, 200);
+  }
+  if (sub === "/v1/feed/publish" && method === "POST") {
+    const body = req.headers.get("content-length") === "0" ? {} : await readJsonBody(req).catch(() => ({}));
+    const opts = typeof body === "object" && body !== null ? body : {};
+    const storage = new sql.SqlStorage(db);
+    const report = await wod_wiki_engine_star.publishFeedFromStorage(storage, feedTree, {
+      layout: "feed",
+      ...typeof opts.name === "string" ? { name: opts.name } : {},
+      ...typeof opts.description === "string" ? { description: opts.description } : {},
+      ...typeof opts.repositoryUrl === "string" ? { repositoryUrl: opts.repositoryUrl } : {},
+      ...typeof opts.notebookSlug === "string" ? { notebookSlug: opts.notebookSlug } : {}
+    });
+    return json({
+      manifest: report.manifest,
+      notebooks: report.notebooks,
+      totalNotes: report.totalNotes,
+      totalPublicSessions: report.totalPublicSessions,
+      feedUrl: `${url.origin}/feed/`
+    }, 200);
+  }
   if (sub === "/v1/wipe" && method === "POST") {
     await db.transaction(async (tx) => {
       await sql.wipeRows(tx);
@@ -1586,13 +1743,22 @@ function distRootOf(playgroundDist) {
 }
 function createHandler(db, options) {
   const distRoot = distRootOf(options.playgroundDist);
+  const feedTree = options.feedTree ?? (options.feedDir ? new NodeFsFeedTree(options.feedDir) : new wod_wiki_engine_star.MemoryFeedTree());
   return async (request) => {
     try {
       const url = new URL(request.url);
       const method = request.method === "HEAD" ? "GET" : request.method;
       const path = url.pathname;
-      const response = path === "/api" || path.startsWith("/api/") ? db ? await apiRoutes(db, request, method, path.slice("/api".length) || "/", url) : notFound() : await staticResponse(distRoot, method, path);
-      return response;
+      if (path === "/api" || path.startsWith("/api/")) {
+        return db ? await apiRoutes(db, feedTree, request, method, path.slice("/api".length) || "/", url) : notFound();
+      }
+      if (db) {
+        const feedAsset = isPublishedFeedAssetPath(path);
+        if (feedAsset !== null) {
+          return await servePublishedFeed(feedTree, request.method === "OPTIONS" ? "OPTIONS" : method, feedAsset);
+        }
+      }
+      return await staticResponse(distRoot, method, path);
     } catch (e) {
       if (e instanceof HttpError || e instanceof sql.StorageError) {
         const status = e.status;
@@ -1610,6 +1776,7 @@ var json, plain, notFound, methodNotAllowed, noContent, qget, MIME;
 var init_app = __esm({
   "src/server/app.ts"() {
     init_errors();
+    init_nodeFeedTree();
     json = (value, status) => new Response(JSON.stringify(value), { status, headers: { "content-type": "application/json" } });
     plain = (body, status) => new Response(body, { status, headers: { "content-type": "text/plain; charset=utf-8" } });
     notFound = () => json({ error: "not found" }, 404);
@@ -1636,7 +1803,10 @@ var init_app = __esm({
       wav: "audio/wav",
       webmanifest: "application/manifest+json",
       xml: "application/xml",
-      txt: "text/plain; charset=utf-8"
+      txt: "text/plain; charset=utf-8",
+      md: "text/markdown; charset=utf-8",
+      jsonl: "application/x-ndjson; charset=utf-8",
+      csv: "text/csv; charset=utf-8"
     };
   }
 });
@@ -1767,7 +1937,8 @@ async function runCliServer(mode, options, writeOut) {
   let server;
   try {
     const dist = resolveDist(mode, options);
-    const handler = createHandler(db?.db ?? null, { playgroundDist: dist });
+    const feedDir = mode === "server" && options.database?.kind === "sqlite" ? `${options.database.path}.feed` : void 0;
+    const handler = createHandler(db?.db ?? null, { playgroundDist: dist, feedDir });
     server = await startHttpServer(handler, host, port);
     if (mode === "server") {
       writeOut(`wod server: http://${host}:${port} \u2014 ${dbLabel} \xB7 dist ${dist}`);
@@ -3475,145 +3646,37 @@ function defaultSeedDirs(cwd) {
 
 // src/cli/publish.ts
 init_db();
-init_contract();
-init_compiler();
+init_nodeFeedTree();
 init_report();
 async function publishNotebookSeed(db, options) {
   const t0 = Date.now();
-  const fs = nodeFs();
-  const path = nodePath();
   const allNotes = await db.storage.readonly("notes").getAll();
   if (allNotes.length === 0) {
     throw new Error(`[wod publish] No notes found in database ${db.path}`);
   }
-  const notesByNotebook = /* @__PURE__ */ new Map();
-  for (const note of allNotes) {
-    const slug = wodWikiWql.notebookSlugOfSourceId(note.sourceId);
-    const key = slug || "__unassigned__";
-    const list = notesByNotebook.get(key) ?? [];
-    list.push(note);
-    notesByNotebook.set(key, list);
-  }
-  const targetNotebooks = /* @__PURE__ */ new Map();
-  if (options.notebook) {
-    const matching = notesByNotebook.get(options.notebook);
-    if (matching) {
-      targetNotebooks.set(options.notebook, matching);
-    } else if (notesByNotebook.has("__unassigned__") && notesByNotebook.size === 1) {
-      targetNotebooks.set(options.notebook, notesByNotebook.get("__unassigned__"));
-    } else {
-      const available = [...notesByNotebook.keys()].filter((k) => k !== "__unassigned__");
-      throw new Error(
-        `[wod publish] Notebook "${options.notebook}" not found in ${db.path}.` + (available.length > 0 ? ` Available notebooks: ${available.join(", ")}` : "")
-      );
-    }
-  } else {
-    for (const [slug, notes] of notesByNotebook.entries()) {
-      targetNotebooks.set(slug === "__unassigned__" ? "default" : slug, notes);
-    }
-  }
-  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) ?? [];
-    list.push(row);
-    indexByNote.set(row.noteId, list);
-  }
-  const effortsByNote = /* @__PURE__ */ new Map();
-  for (const row of allEffortRows) {
-    const list = effortsByNote.get(row.noteId) ?? [];
-    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 });
-  const manifestChunks = [];
-  let totalNotes = 0;
-  const publishedNotebooks = [];
-  for (const [notebookSlug, notes] of targetNotebooks.entries()) {
-    publishedNotebooks.push(notebookSlug);
-    const chunkRows = [];
-    for (const note of notes) {
-      const stem = (note.title || note.id).toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/(^-|-$)/g, "") || "note";
-      const notePath = note.sourcePath ?? `markdown/notebooks/${notebookSlug}/${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,
-        sourceId: b.sourceId ?? `notebook:${notebookSlug}/${stem}`,
-        sourcePath: b.sourcePath ?? notePath
-      })) : compileSeedRow(notePath, note.rawContent, {
-        routeId: `${notebookSlug}/${stem}`,
-        sourceId: `notebook:${notebookSlug}/${stem}`,
-        // 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) => ({
-        ...e,
-        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,
-        blockEquipment
-      });
-    }
-    const chunkId = `notebook.${notebookSlug}`;
-    const json2 = JSON.stringify(chunkRows);
-    const digest = nodeCrypto().createHash("sha256").update(json2).digest();
-    const sha = [...digest].map((b) => b.toString(16).padStart(2, "0")).join("");
-    const chunkFile = `chunks/${chunkId}.${sha.slice(0, 8)}.json`;
-    fs.writeFileSync(path.join(outDir, chunkFile), json2, "utf-8");
-    manifestChunks.push({
-      id: chunkId,
-      path: chunkFile,
-      sha256: sha,
-      bytes: Buffer.byteLength(json2, "utf8"),
-      count: chunkRows.length,
-      kind: "notes"
-    });
-    totalNotes += chunkRows.length;
-  }
-  const manifest = {
-    schema: contract_exports.SEED_SCHEMA,
-    version: options.version ?? 1,
-    versionLabel: `v${options.version ?? 1}`,
-    builtAt: (/* @__PURE__ */ new Date()).toISOString(),
-    chunks: manifestChunks
-  };
-  fs.writeFileSync(path.join(outDir, "manifest.json"), JSON.stringify(manifest, null, 2) + "\n", "utf-8");
+  const outDir = nodePath().resolve(process.cwd(), options.outDir);
+  const tree = new NodeFsFeedTree(outDir);
+  const report = await wod_wiki_engine_star.publishFeedFromStorage(db.storage, tree, {
+    layout: "feed",
+    notebookSlug: options.notebook,
+    version: options.version,
+    name: options.name,
+    description: options.description,
+    repositoryUrl: options.repositoryUrl,
+    includePrivateWhenFiltered: true
+  });
+  const elapsed = Math.max(1, Date.now() - t0);
   writeBuildReport(outDir, {
-    manifest,
-    totalMs: Date.now() - t0,
-    passMs: { scan: 0, blockIndex: 0, parseGate: 0, blockEfforts: 0, write: Date.now() - t0 },
-    fileCount: totalNotes});
+    manifest: report.manifest,
+    totalMs: elapsed,
+    passMs: { scan: 0, blockIndex: 0, parseGate: 0, blockEfforts: 0, write: elapsed },
+    fileCount: report.totalNotes});
   return {
-    manifest,
+    manifest: report.manifest,
     outDir,
-    notebooks: publishedNotebooks,
-    totalNotes
+    notebooks: report.notebooks,
+    totalNotes: report.totalNotes,
+    totalPublicSessions: report.totalPublicSessions
   };
 }
 
@@ -3991,13 +4054,13 @@ function parseCliArgs(args) {
       i++;
     } else if (arg === "--format") {
       const fmt = args[++i];
-      if (fmt === "json" || fmt === "table" || fmt === "csv") {
+      if (fmt === "json" || fmt === "table" || fmt === "csv" || fmt === "jsonl") {
         result.format = fmt;
       }
       i++;
     } else if (arg.startsWith("--format=")) {
       const fmt = arg.slice("--format=".length);
-      if (fmt === "json" || fmt === "table" || fmt === "csv") {
+      if (fmt === "json" || fmt === "table" || fmt === "csv" || fmt === "jsonl") {
         result.format = fmt;
       }
       i++;
@@ -4624,12 +4687,28 @@ async function cliMain(argv = process.argv.slice(2), io = {}) {
             writeErr(`[wod ${verb}] Session not found in ${db.path}: ${id}`);
             return 1;
           }
-          const csv = wod_wiki_engine_star.sessionToCsv(bundle.session, bundle.events);
-          const target = parsed.output && parsed.output !== "-" ? parsed.output : `${id}.csv`;
+          const wantsJsonl = parsed.format === "jsonl" || parsed.output !== void 0 && /\.jsonl$/i.test(parsed.output);
+          const defaultExt = wantsJsonl ? "jsonl" : "csv";
+          const target = parsed.output && parsed.output !== "-" ? parsed.output : `${id}.${defaultExt}`;
+          let payload;
+          if (wantsJsonl) {
+            const rev = await db.storage.readonly("block_revisions").get([
+              bundle.session.noteId,
+              bundle.session.blockId,
+              bundle.session.blockVersion
+            ]);
+            payload = wod_wiki_engine_star.serializeNoteBundleToJsonl({
+              ...rev ? { revisions: [rev] } : {},
+              sessions: [bundle.session],
+              events: bundle.events
+            }) + "\n";
+          } else {
+            payload = wod_wiki_engine_star.sessionToCsv(bundle.session, bundle.events);
+          }
           if (parsed.output === "-") {
-            writeOut(csv);
+            writeOut(payload.trimEnd());
           } else {
-            nodeFs().writeFileSync(target, csv, "utf-8");
+            nodeFs().writeFileSync(target, payload, "utf-8");
           }
           if (parsed.output !== "-") writeOut(`[wod ${verb}] session ${id} \u2192 ${target} (${bundle.events.length} events)`);
         } else if (kind === "effort") {
@@ -4749,13 +4828,25 @@ async function cliMain(argv = process.argv.slice(2), io = {}) {
         }
         return 0;
       }
-      const { session, events } = wod_wiki_engine_star.csvToSessionRows(fs.readFileSync(file, "utf-8"));
+      const rawSessionText = fs.readFileSync(file, "utf-8");
       const db = await openCliDb(cliDb());
       try {
-        const result = await persistSessionBundle(db, session, events);
-        writeOut(
-          `[wod import] session ${session.id} \u2014 ${result.events} events \u2192 ${db.path}`
-        );
+        if (/\.jsonl$/i.test(file)) {
+          const report = await wod_wiki_engine_star.ingestPortableFilesIntoStorage(db.storage, [{ path: file, content: rawSessionText }]);
+          if (report.errors.length > 0 && report.sessionsImported === 0) {
+            writeErr(`[wod import] ${report.errors.join("; ")}`);
+            return 1;
+          }
+          writeOut(
+            `[wod import] session jsonl \u2014 ${report.sessionsImported} session(s), ${report.eventsImported} events \u2192 ${db.path}`
+          );
+        } else {
+          const { session, events } = wod_wiki_engine_star.csvToSessionRows(rawSessionText);
+          const result = await persistSessionBundle(db, session, events);
+          writeOut(
+            `[wod import] session ${session.id} \u2014 ${result.events} events \u2192 ${db.path}`
+          );
+        }
       } finally {
         await db.close();
       }