@bitcobblers/wod-wiki-engine 0.35.2119 → 0.35.2121

package/dist/bin/wod.cjs

@@ -342,6 +342,7 @@ function writeBuildReport(outDir, data) {
   <dt>total</dt><dd>${totalMs} ms</dd>
   <dt>corpus scan + partition</dt><dd>${passMs.scan} ms (${fileCount} files)</dd>
   <dt>block-index derivation</dt><dd>${passMs.blockIndex} ms</dd>
+  <dt>block syntax gate</dt><dd>${passMs.parseGate} ms</dd>
   <dt>block-efforts derivation</dt><dd>${passMs.blockEfforts} ms</dd>
   <dt>chunk writes</dt><dd>${passMs.write} ms</dd>
 </dl>
@@ -378,7 +379,8 @@ __export(compiler_exports, {
   loadExistingEffortMap: () => loadExistingEffortMap,
   partitionIntoChunks: () => partitionIntoChunks,
   scaffoldDiscoveredEfforts: () => scaffoldDiscoveredEfforts,
-  validateDashboardNote: () => validateDashboardNote
+  validateDashboardNote: () => validateDashboardNote,
+  validateWodBlockSyntax: () => validateWodBlockSyntax
 });
 function listMarkdownFiles(dir, prefix = "") {
   if (!fs.existsSync(dir)) return [];
@@ -506,6 +508,26 @@ function buildBlockIndexRows(markdownDir, corpusRoot) {
   }
   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: SEED_REGISTERED_WIDGETS }).find((s) => s.scriptBlock);
+    const source = section?.scriptBlock?.content ?? block.rawContent;
+    if (!source.trim()) 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(`${block.sourcePath ?? block.noteId}:${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(" ");
@@ -628,7 +650,7 @@ function sha256Hex(data) {
 }
 function generateSeed(options = {}) {
   const t0 = Date.now();
-  const passMs = { scan: 0, blockIndex: 0, blockEfforts: 0, write: 0 };
+  const passMs = { scan: 0, blockIndex: 0, parseGate: 0, blockEfforts: 0, write: 0 };
   const corpusRoot = options.corpusRoot ?? process.cwd();
   const markdownDir = options.markdownDir ?? path.join(corpusRoot, "markdown");
   const outDir = options.outDir ?? path.join(corpusRoot, "dist");
@@ -648,13 +670,23 @@ function generateSeed(options = {}) {
     groups.push({ id: TEMPLATE_CHUNK_ID, files: [templateRowPath] });
   }
   passMs.scan = Date.now() - tScan;
+  const tBlockIndex = Date.now();
+  const blockRows = buildBlockIndexRows(markdownDir, corpusRoot);
+  passMs.blockIndex = Date.now() - tBlockIndex;
+  const tParseGate = Date.now();
+  const syntaxProblems = validateWodBlockSyntax(blockRows);
+  passMs.parseGate = Date.now() - tParseGate;
+  if (syntaxProblems.length > 0) {
+    const shown = syntaxProblems.slice(0, 20).map((p) => `  ${p}`).join("\n");
+    const more = syntaxProblems.length > 20 ? `
+  \u2026 and ${syntaxProblems.length - 20} more` : "";
+    throw new Error(`[wod build] block syntax gate failed \u2014 ${syntaxProblems.length} block(s) do not parse:
+${shown}${more}`);
+  }
   const chunksDir = path.join(outDir, "chunks");
   fs.rmSync(outDir, { recursive: true, force: true });
   fs.mkdirSync(chunksDir, { recursive: true });
   const manifestChunks = [];
-  const tBlockIndex = Date.now();
-  const blockRows = buildBlockIndexRows(markdownDir, corpusRoot);
-  passMs.blockIndex = Date.now() - tBlockIndex;
   const tBlockEfforts = Date.now();
   const effortRows = buildBlockEffortRows(markdownDir, corpusRoot, blockRows);
   passMs.blockEfforts = Date.now() - tBlockEfforts;