@bitcobblers/wod-wiki-wql 0.50.2189 → 0.50.2191

package/dist/index.cjs

@@ -136,9 +136,9 @@ var TARGET_TYPES = {
   note: /* @__PURE__ */ new Set(["text", "notebook", "tag", "effort", ...WQL_TYPED_TAG_KEYS, "type", "page", "source", "note", "time", "groupby", "where", "feed", "subscribed"]),
   block: /* @__PURE__ */ new Set(["text", "notebook", "tag", "effort", "type", "source", "note", "time", "groupby", "where", "feed", "subscribed"]),
   effort: /* @__PURE__ */ new Set([...WQL_EFFORT_FILTER_KEYS, "groupby"]),
-  session: /* @__PURE__ */ new Set(["result", "block", "note", "plane", "time", "groupby"]),
-  segment: /* @__PURE__ */ new Set([...TABLE_KEYS, "time", "groupby", "unit"]),
-  event: /* @__PURE__ */ new Set([...TABLE_KEYS, "time", "groupby", "unit"]),
+  session: /* @__PURE__ */ new Set(["result", "block", "note", "plane", ...FACT_KEYS.map((key) => key === "tags" ? "tag" : key), "time", "groupby"]),
+  segment: /* @__PURE__ */ new Set([...TABLE_KEYS, "tag", "time", "groupby", "unit"]),
+  event: /* @__PURE__ */ new Set([...TABLE_KEYS, "tag", "time", "groupby", "unit"]),
   // Container planes (ticket 08). `:notebook{}` delegates to the note plane
   // (see the notebook entry above); `:page{}` lists the page placements;
   // `:tag{}` the tags (results are notes); `:equipment{}` the equipment
@@ -173,7 +173,7 @@ function wqlGroupingDimensions(target, family) {
 function supportsWqlFilterKey(target, family, rawKey) {
   const key = rawKey === "tag" ? "tags" : rawKey;
   if (family === "aggregate" || target === "segment" || target === "event") {
-    return !WQL_CONTENT_ONLY_KEYS.includes(key) && key !== "plane" && !(family === "find" && key === "tags");
+    return !WQL_CONTENT_ONLY_KEYS.includes(key) && key !== "plane";
   }
   return wqlFilterKeys(target, family).includes(key);
 }
@@ -3552,6 +3552,14 @@ var QueryService = class {
     }
     groups.sort((a, b) => sessionCompletedAt(b[1]) - sessionCompletedAt(a[1]));
     const planeFilters = parsed.filters.filter((f) => f.key === "plane");
+    const factFilters = parsed.filters.filter((f) => !["result", "block", "note", "plane"].includes(f.key));
+    const touchesTags = factFilters.some((f) => isTagLabelKey(f.key));
+    let sessionNoteTags = /* @__PURE__ */ new Map();
+    if (touchesTags && groups.length > 0) {
+      const dummyPoints = groups.map(([, rows]) => ({ noteId: rows[0]?.noteId ?? "" }));
+      sessionNoteTags = await this.loadNoteTags(dummyPoints, true);
+    }
+    const normalizedFactFilters = factFilters.map((f) => f.key === "tag" ? { ...f, key: "tags" } : f);
     let runs = groups.map(([resultId, rows]) => {
       let events = rows;
       if (planeFilters.length > 0) {
@@ -3562,6 +3570,13 @@ var QueryService = class {
           })
         );
       }
+      if (normalizedFactFilters.length > 0) {
+        const matchingSession = events.some((row) => {
+          const facts = projectEventToFacts(row);
+          return facts.some((fact) => matchesFilters(fact, normalizedFactFilters, sessionNoteTags));
+        });
+        if (!matchingSession) events = [];
+      }
       return {
         resultId,
         noteId: rows[0].noteId,
@@ -3650,8 +3665,10 @@ var QueryService = class {
       if (temporal?.temporalKind === "civil-date" && temporal.civilDate) return zonedNoon(temporal.civilDate, ctx.timeZone);
       return row.timestamp;
     };
-    const noteTags = /* @__PURE__ */ new Map();
-    const tagFilters = parsed.filters.filter((f) => !["result", "block", "note", "plane"].includes(f.key));
+    const rawTagFilters = parsed.filters.filter((f) => !["result", "block", "note", "plane"].includes(f.key));
+    const tagFilters = rawTagFilters.map((f) => f.key === "tag" ? { ...f, key: "tags" } : f);
+    const touchesTags = tagFilters.some((f) => f.key === "tags");
+    const noteTags = touchesTags && eligibleRecords.length > 0 ? await this.loadNoteTags(eligibleRecords.map((r) => ({ noteId: r.noteId })), true) : /* @__PURE__ */ new Map();
     const timeScoped = !!(parsed.window || options2.range);
     const eligible = eligibleRecords.filter((row) => !timeScoped || effectiveTimeWindow(anchorTs(row), parsed.window, options2.range, ctx)).filter((row) => {
       if (tagFilters.length === 0) return true;
@@ -5144,152 +5161,9 @@ function buildDashboardDocument(sections, meta) {
   };
 }
 
-// src/dashboard/frontmatter.ts
-var FRONTMATTER_RE = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?/;
-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++;
-      }
-      if (items.length > 0) {
-        meta[key] = items;
-      } else if (key === "metrics" || key === "summaries") {
-        while (i + 1 < lines.length) {
-          const childLine = lines[i + 1];
-          if (/^\s*(?:#.*)?$/.test(childLine)) {
-            i++;
-            continue;
-          }
-          const childMatch = childLine.match(/^\s{2,}([A-Za-z][\w.-]*)\s*:(.*)$/);
-          if (!childMatch) break;
-          i++;
-          const childKey = `${key}.${childMatch[1]}`;
-          const childRaw = childMatch[2].trim();
-          if (childRaw === "") {
-            const childItems = [];
-            while (i + 1 < lines.length) {
-              const listMatch = lines[i + 1].match(/^\s{4,}-\s+(.+)$/);
-              if (!listMatch) break;
-              childItems.push(listMatch[1].trim());
-              i++;
-            }
-            meta[childKey] = childItems.length > 0 ? childItems : "";
-          } else {
-            const wasQuoted = /^(['"])(.*)\1$/.test(childRaw);
-            const value = unquote(childRaw);
-            const num = Number(value);
-            meta[childKey] = !wasQuoted && value !== "" && !isNaN(num) ? num : value;
-          }
-        }
-      } else {
-        meta[key] = "";
-      }
-    } 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 parseFrontmatterBody(innerContent) {
-  return parseMetaLines(innerContent.split(/\r?\n/));
-}
-function quoteYamlScalar(value) {
-  if (value === "") return '""';
-  const looksNumeric = !isNaN(Number(value));
-  const looksKeyword = /^(true|false|null|yes|no|on|off)$/i.test(value);
-  if (/[":'\n#{}[\\],&*?|<>=%!@`]/.test(value) || value !== value.trim() || value.startsWith("-") || looksNumeric || looksKeyword) {
-    return `"${value.replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`;
-  }
-  return value;
-}
-function serializeFrontmatter(meta) {
-  const lines = [];
-  for (const [key, value] of Object.entries(meta)) {
-    if (Array.isArray(value)) {
-      if (value.length === 0) {
-        lines.push(`${key}: ""`);
-        continue;
-      }
-      lines.push(`${key}:`);
-      for (const item of value) {
-        lines.push(`  - ${quoteYamlScalar(item)}`);
-      }
-    } else if (typeof value === "number") {
-      lines.push(`${key}: ${value}`);
-    } else {
-      lines.push(`${key}: ${quoteYamlScalar(value)}`);
-    }
-  }
-  return lines.join("\n");
-}
-function stripFrontmatter(raw) {
-  return parseFrontmatter(raw).body;
-}
-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 : [];
-}
-function parseFrontmatterCategories(raw) {
-  return getList(parseFrontmatter(raw).meta, "category").map((c) => c.toLowerCase());
-}
-function extractFrontmatterTags(raw) {
-  const meta = FRONTMATTER_RE.test(raw) ? parseFrontmatter(raw).meta : parseFrontmatterBody(raw);
-  const tags = meta["tags"];
-  const list = Array.isArray(tags) ? tags : typeof tags === "string" && tags.trim() ? tags.trim().startsWith("[") && tags.trim().endsWith("]") ? tags.trim().slice(1, -1).split(",") : [tags] : [];
-  return [...new Set(list.map((tag) => tag.trim()).filter(Boolean))];
-}
-function parseFlatProperties(innerContent) {
-  const props = {};
-  for (const line of innerContent.split(/\r?\n/)) {
-    const match = line.match(/^([^:]+):\s*(.*)$/);
-    if (match) {
-      props[match[1].trim()] = match[2].trim();
-    }
-  }
-  return props;
-}
-function parseFrontmatterProps(lines) {
-  const props = {};
-  for (const line of lines) {
-    const match = line.match(/^([^:]+):\s*(.*)$/);
-    if (match) {
-      props[match[1].trim()] = match[2].trim();
-    }
-  }
-  return props;
-}
-
 // src/dashboard/parser.ts
 function parseDashboardNote(rawContent) {
-  const { meta } = parseFrontmatter(rawContent);
+  const { meta } = wodWikiCore.parseFrontmatter(rawContent);
   const lines = rawContent.split(/\r?\n/);
   const sections = [];
   let i = 0;
@@ -5303,7 +5177,12 @@ function parseDashboardNote(rawContent) {
   while (i < lines.length) {
     const line = lines[i];
     const trimmed = line.trim();
-    if (/^```query/.test(trimmed)) {
+    const isQueryFence = /^```query(?:[:\s]|$)/i.test(trimmed);
+    const widgetFenceMatch = !isQueryFence ? trimmed.match(/^```widget:([a-zA-Z0-9_-]+.*)?$/i) : null;
+    const isWidgetChartFence = Boolean(
+      widgetFenceMatch && widgetFenceMatch[1] && isDashboardWidgetType(parseQueryWidgetSuffix(widgetFenceMatch[1]).type)
+    );
+    if (isQueryFence || isWidgetChartFence) {
       const tag = trimmed.slice(3);
       let widgetType;
       let spanCols;
@@ -5311,8 +5190,9 @@ function parseDashboardNote(rawContent) {
       let widgetError;
       let attributes;
       let attributeOrder;
-      if (tag.startsWith("query:")) {
-        const spec = parseQueryWidgetSuffix(tag.slice("query:".length));
+      const colonMatch = tag.match(/^(?:query|widget):(.*)$/i);
+      if (colonMatch) {
+        const spec = parseQueryWidgetSuffix(colonMatch[1]);
         widgetType = spec.type || void 0;
         spanCols = spec.spanCols;
         spanFull = spec.spanFull;
@@ -5627,15 +5507,490 @@ ${query}
   });
   return out;
 }
+var TYPED_TAG_SET = new Set(WQL_TYPED_TAG_KEYS);
+function formatFilterValue(val) {
+  const trimmed = val.trim();
+  if (!trimmed) return '""';
+  return /[\s,|{}]/.test(trimmed) ? `"${trimmed.replace(/"/g, '\\"')}"` : trimmed;
+}
+function extractNoteWqlOverride(rawContent) {
+  if (!rawContent || !rawContent.trimStart().startsWith("---")) return void 0;
+  const { meta } = wodWikiCore.parseFrontmatter(rawContent);
+  const explicit = wodWikiCore.getScalar(meta, "wql") ?? wodWikiCore.getScalar(meta, "dashboard.wql") ?? wodWikiCore.getScalar(meta, "dashboard.scope");
+  return typeof explicit === "string" && explicit.trim().length > 0 ? explicit.trim() : void 0;
+}
+function resolveEntityScope(input) {
+  const rawId = (input.noteId ?? input.slug ?? "").trim();
+  const explicitWql = input.wql?.trim() || extractNoteWqlOverride(input.rawContent);
+  let kind = input.kind ?? "note";
+  let slug = (input.slug ?? "").trim();
+  let category = input.category?.trim();
+  if (!input.kind && rawId) {
+    if (rawId.startsWith("effort/")) {
+      kind = "effort";
+      slug = slug || rawId.slice("effort/".length);
+    } else if (rawId.startsWith("equipment/")) {
+      kind = "equipment";
+      slug = slug || rawId.slice("equipment/".length);
+    } else if (rawId.startsWith("t/") || rawId.startsWith("tag/")) {
+      const prefix = rawId.startsWith("t/") ? "t/" : "tag/";
+      const rest = rawId.slice(prefix.length);
+      const parts = rest.split("/").filter(Boolean);
+      if (parts.length >= 2) {
+        kind = "tag";
+        category = category || parts[0];
+        slug = slug || parts.slice(1).join("/");
+      } else if (parts.length === 1) {
+        kind = "tag-category";
+        category = category || parts[0];
+        slug = slug || parts[0];
+      }
+    } else if (rawId.startsWith("notebook/")) {
+      const rest = rawId.slice("notebook/".length);
+      const parts = rest.split("/").filter(Boolean);
+      if (parts.length === 1) {
+        kind = "notebook";
+        slug = slug || parts[0];
+      } else {
+        kind = "note";
+        slug = slug || rawId;
+      }
+    } else if (rawId.startsWith("feed/")) {
+      kind = "feed";
+      slug = slug || rawId.slice("feed/".length);
+    } else if (rawId.startsWith("session/") || rawId.startsWith("result/")) {
+      kind = "session";
+      slug = slug || rawId.slice(rawId.indexOf("/") + 1);
+    }
+  }
+  if (!slug) slug = rawId || "unknown";
+  const id = rawId || (category ? `${kind}/${category}/${slug}` : `${kind}/${slug}`);
+  const label = (input.label ?? slug).trim() || slug;
+  const safeSlug = formatFilterValue(slug);
+  switch (kind) {
+    case "effort": {
+      const scopeFilter = `effort:${safeSlug}`;
+      const notesWql = `:note{${scopeFilter}}`;
+      const blocksWql = `:block{${scopeFilter}}`;
+      const sessionsWql = `:session{${scopeFilter}}`;
+      const recordsWql = `:segment{${scopeFilter}}`;
+      return {
+        kind,
+        id,
+        slug,
+        category: "effort",
+        label,
+        scopeFilter,
+        notesWql,
+        blocksWql,
+        sessionsWql,
+        recordsWql,
+        primaryWql: explicitWql ?? notesWql,
+        tokens: {
+          scope: scopeFilter,
+          effort: slug,
+          note: id,
+          metric: "totalVolume"
+        }
+      };
+    }
+    case "equipment": {
+      const scopeFilter = `equipment:${safeSlug}`;
+      const notesWql = `:note{${scopeFilter}}`;
+      const blocksWql = `:block{tags:${safeSlug}}`;
+      const sessionsWql = `:session{${scopeFilter}}`;
+      const recordsWql = `:segment{${scopeFilter}}`;
+      return {
+        kind,
+        id,
+        slug,
+        category: "equipment",
+        label,
+        scopeFilter,
+        notesWql,
+        blocksWql,
+        sessionsWql,
+        recordsWql,
+        primaryWql: explicitWql ?? notesWql,
+        tokens: {
+          scope: scopeFilter,
+          equipment: slug,
+          note: id,
+          metric: "totalVolume"
+        }
+      };
+    }
+    case "tag": {
+      const cat = (category ?? "tag").trim() || "tag";
+      if (cat === "effort") {
+        return resolveEntityScope({ ...input, kind: "effort", slug });
+      }
+      if (cat === "equipment") {
+        return resolveEntityScope({ ...input, kind: "equipment", slug });
+      }
+      const isTypedKey = TYPED_TAG_SET.has(cat) || cat === "discipline" || cat === "intensity";
+      const scopeFilter = isTypedKey ? `${cat}:${safeSlug}` : `tags:${safeSlug}`;
+      const notesWql = `:note{${scopeFilter}}`;
+      const blocksWql = `:block{tags:${safeSlug}}`;
+      const sessionsWql = `:session{${scopeFilter}}`;
+      const recordsWql = `:segment{${scopeFilter}}`;
+      return {
+        kind,
+        id,
+        slug,
+        category: cat,
+        label,
+        scopeFilter,
+        notesWql,
+        blocksWql,
+        sessionsWql,
+        recordsWql,
+        primaryWql: explicitWql ?? notesWql,
+        tokens: {
+          scope: scopeFilter,
+          tag: slug,
+          category: cat,
+          note: id,
+          metric: "tis"
+        }
+      };
+    }
+    case "tag-category": {
+      const cat = (category ?? slug).trim() || "tag";
+      const safeCat = formatFilterValue(cat);
+      const scopeFilter = `type:${safeCat}`;
+      const notesWql = cat === "effort" ? ":effort{}" : cat === "equipment" ? ":equipment{}" : `:tag{${scopeFilter}}`;
+      const blocksWql = `:block{}`;
+      const sessionsWql = `:session{}`;
+      const recordsWql = `:segment{}`;
+      return {
+        kind,
+        id,
+        slug: cat,
+        category: cat,
+        label,
+        scopeFilter,
+        notesWql,
+        blocksWql,
+        sessionsWql,
+        recordsWql,
+        primaryWql: explicitWql ?? notesWql,
+        tokens: {
+          scope: scopeFilter,
+          category: cat,
+          note: id,
+          metric: "tis"
+        }
+      };
+    }
+    case "notebook": {
+      const nbSlug = slug.replace(/^notebook\//, "");
+      const safeNb = formatFilterValue(nbSlug);
+      const scopeFilter = `notebook:${safeNb}`;
+      const notesWql = `:note{${scopeFilter}}`;
+      const blocksWql = `:block{${scopeFilter}}`;
+      const sessionsWql = `:session{} where ${notesWql}`;
+      const recordsWql = `:segment{} where ${notesWql}`;
+      return {
+        kind,
+        id: `notebook/${nbSlug}`,
+        slug: nbSlug,
+        label,
+        scopeFilter,
+        notesWql,
+        blocksWql,
+        sessionsWql,
+        recordsWql,
+        primaryWql: explicitWql ?? notesWql,
+        tokens: {
+          scope: scopeFilter,
+          notebook: nbSlug,
+          metric: "tis"
+        }
+      };
+    }
+    case "feed": {
+      const feedSlug = slug.replace(/^feed\//, "");
+      const safeFeed = formatFilterValue(feedSlug);
+      const scopeFilter = `feed:${safeFeed}`;
+      const notesWql = `:notebook{${scopeFilter}}`;
+      const blocksWql = `:block{${scopeFilter}}`;
+      const sessionsWql = `:session{} where ${notesWql}`;
+      const recordsWql = `:segment{} where ${notesWql}`;
+      return {
+        kind,
+        id: `feed/${feedSlug}`,
+        slug: feedSlug,
+        label,
+        scopeFilter,
+        notesWql,
+        blocksWql,
+        sessionsWql,
+        recordsWql,
+        primaryWql: explicitWql ?? notesWql,
+        tokens: {
+          scope: scopeFilter,
+          feed: feedSlug,
+          metric: "tis"
+        }
+      };
+    }
+    case "session": {
+      const scopeFilter = `result:${safeSlug}`;
+      const notesWql = `:note{}`;
+      const blocksWql = `:block{}`;
+      const sessionsWql = `:session{${scopeFilter}}`;
+      const recordsWql = `:segment{${scopeFilter}}`;
+      return {
+        kind,
+        id,
+        slug,
+        label,
+        scopeFilter,
+        notesWql,
+        blocksWql,
+        sessionsWql,
+        recordsWql,
+        primaryWql: explicitWql ?? sessionsWql,
+        tokens: {
+          scope: scopeFilter,
+          result: slug,
+          metric: "tis"
+        }
+      };
+    }
+    case "wql": {
+      const query = explicitWql ?? ":note{}";
+      return {
+        kind: "wql",
+        id: id || "wql",
+        slug: slug || "query",
+        label,
+        scopeFilter: "",
+        notesWql: query,
+        blocksWql: query,
+        sessionsWql: query,
+        recordsWql: query,
+        primaryWql: query,
+        tokens: {
+          scope: query,
+          metric: "tis"
+        }
+      };
+    }
+    case "note":
+    default: {
+      const noteKey = formatFilterValue(id || slug);
+      const scopeFilter = `note:${noteKey}`;
+      const notesWql = `:note{${scopeFilter}}`;
+      const blocksWql = `:block{${scopeFilter}}`;
+      const sessionsWql = `:session{${scopeFilter}}`;
+      const recordsWql = `:segment{${scopeFilter}}`;
+      return {
+        kind: "note",
+        id: id || slug,
+        slug,
+        label,
+        scopeFilter,
+        notesWql,
+        blocksWql,
+        sessionsWql,
+        recordsWql,
+        primaryWql: explicitWql ?? sessionsWql,
+        tokens: {
+          scope: scopeFilter,
+          note: id || slug,
+          metric: "tis"
+        }
+      };
+    }
+  }
+}
+function buildWidgetsForWqlScope(wqlOrScope, extraWidgets = []) {
+  if (typeof wqlOrScope === "string") {
+    const query = wqlOrScope.trim();
+    const parsed = parseQuery(query);
+    const widgets2 = [];
+    if (!parsed.error && isFindQuery(parsed)) {
+      const isSessionOrSegment = parsed.target === "session" || parsed.target === "segment" || parsed.target === "event";
+      widgets2.push({
+        title: isSessionOrSegment ? "Matching Records" : "Matching Items",
+        type: isSessionOrSegment ? "table" : "list",
+        spanFull: true,
+        wql: query
+      });
+      if (parsed.target === "note" || parsed.target === "notebook" || parsed.target === "block") {
+        widgets2.push({
+          title: "Weekly Volume Across Scope",
+          question: "How does $metric trend across matching workouts?",
+          type: "timeseries",
+          spanCols: 2,
+          wql: `sum:$metric{} by {week} where ${query}`
+        });
+      }
+    } else if (!parsed.error && isPipelineQuery(parsed)) {
+      const sinkType = parsed.sink?.head ?? "table";
+      widgets2.push({
+        title: "Query Output",
+        type: sinkType,
+        spanCols: sinkType === "value" ? 1 : 2,
+        wql: query
+      });
+    } else {
+      widgets2.push({
+        title: "Trend Overview",
+        type: "timeseries",
+        spanCols: 2,
+        wql: query || "sum:$metric{} by {week}"
+      });
+    }
+    return [...widgets2, ...extraWidgets];
+  }
+  const scope = wqlOrScope;
+  const widgets = [];
+  switch (scope.kind) {
+    case "effort":
+      widgets.push(
+        {
+          title: `${scope.label} Volume Trend`,
+          question: `How does $metric for ${scope.label} trend week over week?`,
+          type: "timeseries",
+          spanCols: 2,
+          wql: `sum:$metric{${scope.scopeFilter}} by {week}`
+        },
+        {
+          title: `${scope.label} Recent Sessions`,
+          type: "table",
+          spanCols: 2,
+          wql: scope.recordsWql
+        },
+        {
+          title: `Workouts Containing ${scope.label}`,
+          type: "list",
+          spanFull: true,
+          wql: scope.notesWql
+        }
+      );
+      break;
+    case "equipment":
+      widgets.push(
+        {
+          title: `${scope.label} Volume Trend`,
+          type: "timeseries",
+          spanCols: 2,
+          wql: `sum:$metric{${scope.scopeFilter}} by {week}`
+        },
+        {
+          title: `Workouts Using ${scope.label}`,
+          type: "list",
+          spanFull: true,
+          wql: scope.notesWql
+        }
+      );
+      break;
+    case "tag":
+      widgets.push(
+        {
+          title: `${scope.label} Weekly Trend`,
+          type: "timeseries",
+          spanCols: 2,
+          wql: `sum:$metric{${scope.scopeFilter}} by {week}`
+        },
+        {
+          title: `Tagged Notes (${scope.label})`,
+          type: "list",
+          spanFull: true,
+          wql: scope.notesWql
+        }
+      );
+      break;
+    case "tag-category":
+      widgets.push({
+        title: `${scope.label} Tags`,
+        type: "list",
+        spanFull: true,
+        wql: scope.notesWql
+      });
+      break;
+    case "notebook":
+    case "feed":
+      widgets.push(
+        {
+          title: `${scope.label} Workouts`,
+          type: "list",
+          spanFull: true,
+          wql: scope.notesWql
+        },
+        {
+          title: `${scope.label} Weekly Activity`,
+          type: "timeseries",
+          spanCols: 2,
+          wql: `sum:$metric{} by {week} where ${scope.notesWql}`
+        }
+      );
+      break;
+    case "note":
+    default:
+      widgets.push(
+        {
+          title: "Session History",
+          type: "table",
+          spanCols: 2,
+          wql: scope.sessionsWql
+        },
+        {
+          title: "Recorded Statements",
+          type: "table",
+          spanCols: 2,
+          wql: scope.recordsWql
+        }
+      );
+      break;
+  }
+  return [...widgets, ...extraWidgets];
+}
+function buildDashboardFromScope(options2) {
+  const scopeObj = typeof options2.scope === "object" ? options2.scope : void 0;
+  const rawWql = typeof options2.scope === "string" ? options2.scope : scopeObj?.primaryWql;
+  const title = (options2.title ?? (scopeObj ? `${scopeObj.label} Dashboard` : DEFAULT_DASHBOARD_TITLE)).trim() || DEFAULT_DASHBOARD_TITLE;
+  const slug = options2.slug?.trim() || dashboardSlug(title);
+  const widgets = options2.widgets && options2.widgets.length > 0 ? options2.widgets : buildWidgetsForWqlScope(options2.scope ?? "sum:$metric{} by {week}");
+  const headerLines = [
+    "---",
+    "dashboard: true",
+    "dashboard.active: true",
+    `title: ${title}`,
+    `slug: ${slug}`
+  ];
+  if (rawWql) {
+    headerLines.push(`wql: "${rawWql.replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`);
+  }
+  const defaultMetric = scopeObj?.tokens.metric ?? "totalVolume";
+  headerLines.push("dashboard.metric:");
+  headerLines.push(`  - ${defaultMetric}`);
+  for (const [k, v] of Object.entries(options2.tokens ?? {})) {
+    const tokenKey = k.startsWith("dashboard.") ? k : `dashboard.${k}`;
+    if (tokenKey === "dashboard.metric") continue;
+    if (Array.isArray(v)) {
+      headerLines.push(`${tokenKey}:`);
+      for (const item of v) headerLines.push(`  - ${item}`);
+    } else {
+      headerLines.push(`${tokenKey}: ${v}`);
+    }
+  }
+  headerLines.push("---", "");
+  const bodyGroups = widgets.map((w) => renderWidgetGroup(w).join("\n"));
+  return headerLines.join("\n") + bodyGroups.join("\n\n") + "\n";
+}
 
 // src/version.ts
-var VERSION = "0.50.2189";
-var GIT_SHA = "5da2c23";
-var BUILD_TIME = "2026-11-01T16:27:05.203Z";
+var VERSION = "0.50.2191";
+var GIT_SHA = "95c89db";
+var BUILD_TIME = "2026-11-03T03:31:31.921Z";
 var SEMVER = {
-  version: "0.50.2189",
-  gitSha: "5da2c23",
-  buildTime: "2026-11-01T16:27:05.203Z"
+  version: "0.50.2191",
+  gitSha: "95c89db",
+  buildTime: "2026-11-03T03:31:31.921Z"
 };
 
 Object.defineProperty(exports, "DEFAULT_NOTEBOOK_SLUGS", {
@@ -5658,6 +6013,22 @@ Object.defineProperty(exports, "dimensionKeyOf", {
   enumerable: true,
   get: function () { return wodWikiCore.dimensionKeyOf; }
 });
+Object.defineProperty(exports, "extractFrontmatterTags", {
+  enumerable: true,
+  get: function () { return wodWikiCore.extractFrontmatterTags; }
+});
+Object.defineProperty(exports, "extractTypedFrontmatterTags", {
+  enumerable: true,
+  get: function () { return wodWikiCore.extractTypedFrontmatterTags; }
+});
+Object.defineProperty(exports, "getList", {
+  enumerable: true,
+  get: function () { return wodWikiCore.getList; }
+});
+Object.defineProperty(exports, "getScalar", {
+  enumerable: true,
+  get: function () { return wodWikiCore.getScalar; }
+});
 Object.defineProperty(exports, "isNoteEditable", {
   enumerable: true,
   get: function () { return wodWikiCore.isNoteEditable; }
@@ -5670,6 +6041,34 @@ Object.defineProperty(exports, "notebookSlugFromId", {
   enumerable: true,
   get: function () { return wodWikiCore.notebookSlugFromId; }
 });
+Object.defineProperty(exports, "parseFlatProperties", {
+  enumerable: true,
+  get: function () { return wodWikiCore.parseFlatProperties; }
+});
+Object.defineProperty(exports, "parseFrontmatter", {
+  enumerable: true,
+  get: function () { return wodWikiCore.parseFrontmatter; }
+});
+Object.defineProperty(exports, "parseFrontmatterBody", {
+  enumerable: true,
+  get: function () { return wodWikiCore.parseFrontmatterBody; }
+});
+Object.defineProperty(exports, "parseFrontmatterCategories", {
+  enumerable: true,
+  get: function () { return wodWikiCore.parseFrontmatterCategories; }
+});
+Object.defineProperty(exports, "parseFrontmatterProps", {
+  enumerable: true,
+  get: function () { return wodWikiCore.parseFrontmatterProps; }
+});
+Object.defineProperty(exports, "serializeFrontmatter", {
+  enumerable: true,
+  get: function () { return wodWikiCore.serializeFrontmatter; }
+});
+Object.defineProperty(exports, "stripFrontmatter", {
+  enumerable: true,
+  get: function () { return wodWikiCore.stripFrontmatter; }
+});
 Object.defineProperty(exports, "systemDefaultUnit", {
   enumerable: true,
   get: function () { return wodWikiCore.systemDefaultUnit; }
@@ -5727,8 +6126,10 @@ exports.allowedFilterTypesForTarget = allowedFilterTypesForTarget;
 exports.appendSuffixes = appendSuffixes;
 exports.appendWidget = appendWidget;
 exports.buildDashboardDocument = buildDashboardDocument;
+exports.buildDashboardFromScope = buildDashboardFromScope;
 exports.buildDashboardScaffold = buildDashboardScaffold;
 exports.buildDrillDownQuery = buildDrillDownQuery;
+exports.buildWidgetsForWqlScope = buildWidgetsForWqlScope;
 exports.captureContext = captureContext;
 exports.chunkIdOfItem = chunkIdOfItem;
 exports.civilDateAdd = civilDateAdd;
@@ -5745,12 +6146,10 @@ exports.disciplineFactorFor = disciplineFactorFor;
 exports.duplicateWidget = duplicateWidget;
 exports.eventsToStoredLogs = eventsToStoredLogs;
 exports.extractDashboardTokens = extractDashboardTokens;
-exports.extractFrontmatterTags = extractFrontmatterTags;
+exports.extractNoteWqlOverride = extractNoteWqlOverride;
 exports.feedIdOfItem = feedIdOfItem;
 exports.feedOfItem = feedOfItem;
 exports.findTargetAdvisories = findTargetAdvisories;
-exports.getList = getList;
-exports.getScalar = getScalar;
 exports.getUnitFamily = getUnitFamily;
 exports.hasLegacyIdentity = hasLegacyIdentity;
 exports.inRange = inRange;
@@ -5776,11 +6175,6 @@ exports.notebookOriginOfItem = notebookOriginOfItem;
 exports.notebookSlugOfSourceId = notebookSlugOfSourceId;
 exports.parseDashboardNote = parseDashboardNote;
 exports.parseDocument = parseDocument;
-exports.parseFlatProperties = parseFlatProperties;
-exports.parseFrontmatter = parseFrontmatter;
-exports.parseFrontmatterBody = parseFrontmatterBody;
-exports.parseFrontmatterCategories = parseFrontmatterCategories;
-exports.parseFrontmatterProps = parseFrontmatterProps;
 exports.parseQuery = parseQuery;
 exports.parseQueryWidgetSuffix = parseQueryWidgetSuffix;
 exports.parseWqlSuffixes = parseWqlSuffixes;
@@ -5790,18 +6184,17 @@ exports.removeWidget = removeWidget;
 exports.renderWidgetGroup = renderWidgetGroup;
 exports.resizeWidget = resizeWidget;
 exports.resolveCanonicalMetricKey = resolveCanonicalMetricKey;
+exports.resolveEntityScope = resolveEntityScope;
 exports.resolveOutputUnit = resolveOutputUnit;
 exports.resolveWidgetType = resolveWidgetType;
 exports.resolveWindowRange = resolveWindowRange;
 exports.rowsParseError = rowsParseError;
 exports.serialize = serialize;
 exports.serializeDocument = serializeDocument;
-exports.serializeFrontmatter = serializeFrontmatter;
 exports.setDashboardTokenValue = setDashboardTokenValue;
 exports.sourceMatches = sourceMatches;
 exports.sourceShape = sourceShape;
 exports.splitAtWhere = splitAtWhere;
-exports.stripFrontmatter = stripFrontmatter;
 exports.substituteTokens = substituteTokens2;
 exports.substituteTokensRaw = substituteTokens;
 exports.supportsWqlFilterKey = supportsWqlFilterKey;