lens-content-processor 0.51.0 → 0.54.0

package/dist/glossary.js

@@ -0,0 +1,365 @@
+import { parseMarkdown } from "./markdown-parse.js";
+import { stripAuthoringMarkup } from "./authoring-markup.js";
+import { parseFrontmatter } from "./parser/frontmatter.js";
+import { findFileWithExtension, parseWikilink, resolveWikilinkPath, } from "./parser/wikilink.js";
+import { validateFrontmatter } from "./validator/validate-frontmatter.js";
+import { checkTierViolation } from "./validator/tier.js";
+export function isGlossaryPath(path) {
+    return path.startsWith("glossary/") || path.includes("/glossary/");
+}
+function termFromPath(path) {
+    return (path.split("/").pop() ?? path).replace(/\.md$/, "");
+}
+export function parseGlossaryEntry(content, file) {
+    const errors = [];
+    const stripped = stripAuthoringMarkup(content);
+    // An entry with no aliases needs no frontmatter: the whole file is the definition.
+    const parsed = /^---\r?\n/.test(stripped)
+        ? parseFrontmatter(stripped, file)
+        : { frontmatter: {}, body: stripped, bodyStartLine: 1 };
+    if ("error" in parsed && parsed.error) {
+        return { entry: null, errors: [parsed.error] };
+    }
+    const { frontmatter, body, bodyStartLine } = parsed;
+    errors.push(...validateFrontmatter(frontmatter, "glossary", file));
+    const fail = (message, suggestion, line = bodyStartLine) => {
+        errors.push({ file, line, message, suggestion, severity: "error" });
+        return { entry: null, errors };
+    };
+    const aliases = frontmatter.aliases ?? [];
+    if (!Array.isArray(aliases) ||
+        !aliases.every((a) => typeof a === "string" && a.trim())) {
+        return fail("Field 'aliases' must be a list of phrases", 'Write one phrase per line, e.g.\naliases:\n  - "artificial general intelligence"', 2);
+    }
+    const definition = body.trim();
+    if (!definition) {
+        return fail("Glossary entry has no definition", "Write the definition below the frontmatter, in one or two sentences");
+    }
+    if (/^#{1,6}\s/m.test(definition)) {
+        return fail("A glossary definition cannot contain a heading", "Definitions show in a small popup; keep them to plain sentences");
+    }
+    return {
+        entry: {
+            term: termFromPath(file),
+            aliases: aliases.map((a) => a.trim()),
+            definition,
+        },
+        errors,
+    };
+}
+/** A phrase may belong to one entry only, or a highlight could not say which. */
+export function validateGlossaryAliases(entries) {
+    const owner = new Map();
+    const errors = [];
+    for (const [path, entry] of entries) {
+        for (const phrase of phrasesOf(entry)) {
+            const key = normalizeApostrophes(phrase.toLowerCase());
+            const first = owner.get(key);
+            if (first === undefined) {
+                owner.set(key, path);
+            }
+            else if (first !== path) {
+                errors.push({
+                    file: path,
+                    message: `Glossary phrase "${phrase}" is already used by ${first}`,
+                    suggestion: "Remove the phrase from one of the two entries (phrases differing only in case also clash)",
+                    severity: "error",
+                });
+            }
+        }
+    }
+    return errors;
+}
+function phrasesOf(entry) {
+    return [entry.term, ...entry.aliases];
+}
+function normalizeApostrophes(text) {
+    return text.replace(/[’‘]/g, "'");
+}
+// ─── Applying a lens's glossary_terms ───
+const WORD = String.raw `[\p{L}\p{N}_-]`;
+function compilePhrase(term, phrase) {
+    const escaped = normalizeApostrophes(phrase)
+        .replace(/[.*+?^${}()|[\]\\]/g, "\\$&")
+        .replace(/'/g, "['’‘]");
+    const capitals = /\p{L}/u.test(phrase) && phrase === phrase.toUpperCase();
+    return {
+        term,
+        pattern: new RegExp(`(?<!${WORD})${escaped}(?!${WORD})`, capitals ? "gu" : "giu"),
+        length: phrase.length,
+    };
+}
+/** Nodes whose text the learner does not read as running prose. */
+const SKIPPED_NODES = new Set([
+    "heading",
+    "link",
+    "linkReference",
+    "inlineCode",
+    "code",
+    "html",
+    "inlineMath",
+    "math",
+    "footnoteDefinition",
+]);
+const SKIPPED_DIRECTIVES = new Set(["hide", "collapse", "footnote"]);
+/** Inline markup a term may sit in; the mark then wraps it (see findHits). */
+const EMPHASIS = new Set(["emphasis", "strong", "delete"]);
+function isSkipped(node) {
+    if (SKIPPED_NODES.has(node.type))
+        return true;
+    if (node.type !== "textDirective" &&
+        node.type !== "leafDirective" &&
+        node.type !== "containerDirective")
+        return false;
+    return (SKIPPED_DIRECTIVES.has(node.name) ||
+        (node.name === "callout" && node.attributes?.collapse === "closed"));
+}
+// Inline raw HTML arrives as separate open and close tag nodes; the text
+// between them (<a>, <code>, <abbr>...) is not running prose either.
+const OPEN_TAG = /^<([a-z][\w-]*)\b[^>]*(?<!\/)>$/i;
+const CLOSE_TAG = /^<\/[a-z][\w-]*\s*>$/i;
+const VOID_TAGS = new Set(["br", "hr", "img", "input", "wbr"]);
+/** Text nodes a learner reads, in document order, with their ancestors. */
+function readableText(tree) {
+    const out = [];
+    const walk = (node, ancestors) => {
+        if (isSkipped(node))
+            return;
+        if (node.type === "text")
+            out.push({ text: node, ancestors });
+        if (!("children" in node))
+            return;
+        let insideTag = 0;
+        for (const c of node.children) {
+            if (c.type === "html") {
+                const open = OPEN_TAG.exec(c.value);
+                if (open && !VOID_TAGS.has(open[1].toLowerCase()))
+                    insideTag++;
+                else if (CLOSE_TAG.test(c.value))
+                    insideTag = Math.max(0, insideTag - 1);
+            }
+            else if (!insideTag)
+                walk(c, [...ancestors, node]);
+        }
+    };
+    walk(tree, []);
+    return out;
+}
+// The renderer's inline math rule (web_frontend/src/lib/markdownMath.ts),
+// which the parser here does not apply. A test fails if the two differ.
+export const INLINE_MATH_RE = /(?<!\$)\$(?!\$)([^\s$](?:[^$\n]*?[^\s$])?)\$(?![\d$])/g;
+const ENTITY = /^&(?:#\d+|#x[\da-f]+|[a-z][a-z\d]*);/i;
+/** Source the parser drops from a text node's value, at the cursor. */
+const DROPPED = /^(?:[ \t]+(?=\r?\n)|\\(?=[!-/:-@[-`{-~]))/;
+const LINE_PREFIX = /^[ \t>]+/;
+/**
+ * The source offset of each character of a text node's value. The value is
+ * not a plain slice of the source: its container drops what starts each line
+ * (`> `, list indentation), and escapes and entities are decoded. A character
+ * written as an entity has no offset; the walk stops at anything else it
+ * cannot place, and later characters have no offset either.
+ */
+function sourceOffsets(source, text) {
+    const end = text.position?.end.offset ?? 0;
+    let cursor = text.position?.start.offset ?? end;
+    const offsets = [];
+    // By UTF-16 unit, as the offsets are: an emoji is two.
+    walk: for (let i = 0; i < text.value.length; i++) {
+        while (cursor < end) {
+            const rest = source.slice(cursor, cursor + 40);
+            // Before the plain comparison: "&amp;" is one "&" of the value. Text
+            // that only looks like an entity ("AT&T;") is still in the value.
+            const entity = ENTITY.exec(rest);
+            if (entity && !text.value.startsWith(entity[0], i)) {
+                cursor += entity[0].length;
+                continue walk;
+            }
+            if (source[cursor] === text.value[i]) {
+                offsets[i] = cursor++;
+                continue walk;
+            }
+            const dropped = DROPPED.exec(rest) ??
+                (source[cursor - 1] === "\n" ? LINE_PREFIX.exec(rest) : null);
+            if (!dropped)
+                break walk;
+            cursor += dropped[0].length;
+        }
+        break;
+    }
+    return offsets;
+}
+/**
+ * Every non-overlapping occurrence of a phrase in `source`, as source
+ * offsets, longest phrase first at each place.
+ *
+ * The renderer wraps each mark in a `:glossary[...]` directive, so a mark is
+ * placed where that directive parses as the same text:
+ * - Not inside `$...$` math, and not right after `:` (it would read as
+ *   `::glossary`) or `\` (an escaped colon). Such a place is still taken,
+ *   so a shorter phrase inside it is not marked instead.
+ * - A term that is all of an emphasis (`**LLM**s`) is marked around the
+ *   emphasis: a directive inside it would stop the closing `**` from
+ *   closing. A term that only touches the edge of an emphasis is skipped.
+ */
+function findHits(source, phrases, footnotesRunToEnd) {
+    const hits = [];
+    const tree = parseMarkdown(source, "gfm-directive-math");
+    // An article's footnotes render leniently (web_frontend/src/lib/footnotes.ts):
+    // everything after the first definition belongs to the notes.
+    const end = footnotesRunToEnd
+        ? Math.min(...tree.children
+            .filter((n) => n.type === "footnoteDefinition")
+            .map((n) => n.position?.start.offset ?? Infinity))
+        : Infinity;
+    for (const { text, ancestors } of readableText(tree)) {
+        if ((text.position?.start.offset ?? 0) >= end)
+            break;
+        const math = [...text.value.matchAll(INLINE_MATH_RE)].map((m) => ({
+            start: m.index,
+            end: m.index + m[0].length,
+        }));
+        const offsets = sourceOffsets(source, text);
+        const taken = [];
+        for (const phrase of phrases) {
+            for (const match of text.value.matchAll(phrase.pattern)) {
+                const at = { start: match.index, end: match.index + match[0].length };
+                if (taken.some((t) => at.start < t.end && t.start < at.end))
+                    continue;
+                const from = offsets[at.start];
+                const to = offsets[at.end - 1];
+                const inMath = math.some((m) => at.start < m.end && m.start < at.end);
+                let mark = null;
+                if (from !== undefined &&
+                    to !== undefined &&
+                    source.slice(from, to + 1) === match[0] &&
+                    !inMath) {
+                    mark = placeMark({ start: from, end: to + 1, term: phrase.term }, text, ancestors);
+                    if (mark && /[:\\]/.test(source[mark.start - 1] ?? ""))
+                        mark = null;
+                }
+                taken.push({ ...at, mark });
+            }
+        }
+        for (const t of taken)
+            if (t.mark)
+                hits.push(t.mark);
+    }
+    return hits.sort((a, b) => a.start - b.start);
+}
+/** Widen a mark around the emphasis it fills, or drop one that touches an emphasis edge. */
+function placeMark(mark, text, ancestors) {
+    let node = text;
+    let covers = mark.start === text.position?.start.offset &&
+        mark.end === text.position?.end.offset;
+    let widened = mark;
+    for (let i = ancestors.length - 1; i >= 0; i--) {
+        const parent = ancestors[i];
+        if (!EMPHASIS.has(parent.type))
+            break;
+        const touches = widened.start === node.position?.start.offset ||
+            widened.end === node.position?.end.offset;
+        if (!touches)
+            break;
+        if (!covers || parent.children.length !== 1)
+            return null;
+        const start = parent.position?.start.offset;
+        const end = parent.position?.end.offset;
+        if (start === undefined || end === undefined)
+            return null;
+        widened = { ...mark, start, end };
+        node = parent;
+        covers = true;
+    }
+    return widened;
+}
+/** Text and article segments, unless they sit in a box that starts closed. */
+function isMarkable(segment) {
+    return ((segment.type === "text" || segment.type === "article") &&
+        !segment.frames?.some((frame) => frame.collapse === "closed"));
+}
+/**
+ * Mark the first occurrence of each term a lens lists in `glossary_terms`.
+ * `links` is the raw frontmatter value.
+ */
+export function applyGlossary(links, segments, lensPath, files, entriesByPath, tierMap) {
+    const errors = [];
+    const unchanged = { segments, glossary: [], errors };
+    // `glossary_terms:` with nothing under it is an empty list.
+    if (links === null)
+        return unchanged;
+    if (!Array.isArray(links) || !links.every((l) => typeof l === "string")) {
+        errors.push({
+            file: lensPath,
+            message: "Field 'glossary_terms' must be a list of wikilinks",
+            suggestion: 'Write one link per line, e.g.\nglossary_terms:\n  - "[[../glossary/AGI]]"',
+            severity: "error",
+        });
+        return unchanged;
+    }
+    const entries = [];
+    for (const link of links) {
+        const entry = resolveEntry(link, lensPath, files, entriesByPath, tierMap, errors);
+        if (entry && !entries.some((e) => e.term === entry.term))
+            entries.push(entry);
+    }
+    const phrases = entries
+        .flatMap((entry) => phrasesOf(entry).map((p) => compilePhrase(entry.term, p)))
+        .sort((a, b) => b.length - a.length);
+    if (phrases.length === 0)
+        return unchanged;
+    const marked = new Set();
+    const out = segments.map((segment) => {
+        if (!isMarkable(segment))
+            return segment;
+        const glossaryMarks = findHits(segment.content, phrases, segment.type === "article").filter((hit) => {
+            if (marked.has(hit.term))
+                return false;
+            marked.add(hit.term);
+            return true;
+        });
+        return glossaryMarks.length ? { ...segment, glossaryMarks } : segment;
+    });
+    for (const entry of entries) {
+        if (!marked.has(entry.term)) {
+            errors.push({
+                file: lensPath,
+                message: `Glossary term "${entry.term}" does not appear in this lens`,
+                suggestion: "Remove it from glossary_terms, or add the phrase it is written as to the entry's aliases",
+                severity: "warning",
+            });
+        }
+    }
+    return {
+        segments: out,
+        glossary: entries
+            .filter((e) => marked.has(e.term))
+            .map(({ term, definition }) => ({ term, definition })),
+        errors,
+    };
+}
+function resolveEntry(link, lensPath, files, entriesByPath, tierMap, errors) {
+    const parsed = parseWikilink(link.trim());
+    const target = parsed && !parsed.error
+        ? findFileWithExtension(resolveWikilinkPath(parsed.path, lensPath), files)
+        : null;
+    if (!target || !isGlossaryPath(target)) {
+        errors.push({
+            file: lensPath,
+            message: target
+                ? `glossary_terms: ${link} is not a glossary entry`
+                : `glossary_terms: ${link} could not be resolved`,
+            suggestion: "Link to a file in the glossary/ folder, e.g. [[../glossary/AGI]]",
+            severity: "error",
+        });
+        return null;
+    }
+    const violation = checkTierViolation(lensPath, tierMap?.get(lensPath) ?? "production", target, tierMap?.get(target) ?? "production", "glossary entry");
+    if (violation) {
+        errors.push(violation);
+        return null;
+    }
+    // An entry that failed to parse is missing here; its own errors are
+    // reported once, against the entry.
+    return entriesByPath.get(target) ?? null;
+}
+//# sourceMappingURL=glossary.js.map

package/dist/glossary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glossary.js","sourceRoot":"","sources":["../src/glossary.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -9,6 +9,12 @@ export interface ProcessResult {
     modules: FlattenedModule[];
     courses: Course[];
     surveys: FlattenedSurvey[];
+    /**
+     * Meeting-doc Markdown by repo path (meetings/ folder), published text:
+     * what the platform renders into a meeting's session-doc template. A
+     * meeting's `docPath` is a key of this map.
+     */
+    meetingDocs?: Record<string, string>;
     errors: ContentError[];
     urlsToValidate: UrlToValidate[];
     skillTree: SkillTree;
@@ -33,6 +39,7 @@ export interface SurveyQuestionSegment {
     type: "question";
     key: string;
     content: string;
+    description?: string;
     required: boolean;
     maxChars?: number;
     placeholder?: string;
@@ -42,6 +49,7 @@ export interface SurveyRatingSegment {
     type: "rating";
     key: string;
     content: string;
+    description?: string;
     scale: number;
     required: boolean;
     lowLabel?: string;
@@ -52,6 +60,7 @@ export interface SurveyChoiceSegment {
     type: "choice";
     key: string;
     content: string;
+    description?: string;
     options: string[];
     multi: boolean;
     required: boolean;
@@ -97,6 +106,9 @@ export interface Course {
     outcomes?: string;
     timeCommitment?: string;
     applicationNotes?: string;
+    /** The language the course is written in, a name like `Spanish`; absent =
+     *  English. The read-aloud reader speaks it (core/tts/config.py). */
+    language?: string;
     error?: string;
 }
 /**
@@ -128,7 +140,7 @@ export interface Section {
     optional?: boolean;
     hide?: boolean;
     feedback?: boolean;
-    forceFeedback?: boolean;
+    forceFeedback?: true | "first";
     contentId: string | null;
     learningOutcomes: LearningOutcomeRef[];
     wordCount?: number;
@@ -140,6 +152,8 @@ export interface Section {
     readingMinutes?: number;
     tutorMinutes?: number;
     addToAiContext?: string[] | null;
+    glossary?: GlossaryDefinition[];
+    glossaryTerms?: unknown;
 }
 export interface SectionMeta {
     title?: string;
@@ -156,6 +170,7 @@ export interface ProgressionItem {
     facilitatorSurveyPath?: string;
     facilitatorSurveyId?: string;
     docTemplateUrl?: string;
+    docPath?: string;
 }
 export interface ContentError {
     file: string;
@@ -171,6 +186,7 @@ export interface TextSegment {
     type: "text";
     content: string;
     optional?: boolean;
+    glossaryMarks?: GlossaryMark[];
 }
 export interface ChatSegment {
     type: "chat";
@@ -181,6 +197,7 @@ export interface ChatSegment {
 export interface ArticleSegment {
     type: "article";
     content: string;
+    glossaryMarks?: GlossaryMark[];
     collapsed_before?: string;
     collapsed_after?: string;
     skipEndMarker?: boolean;
@@ -225,6 +242,7 @@ export interface QuestionSegment {
     graded: boolean;
     feedbackInstructions?: string;
     content: string;
+    description?: string;
     assessmentInstructions?: string;
     maxTime?: string;
     maxChars?: number;
@@ -232,7 +250,7 @@ export interface QuestionSegment {
     placeholder?: string;
     optional?: boolean;
     feedback?: boolean;
-    forceFeedback?: boolean;
+    forceFeedback?: true | "first";
     scale?: number;
     lowLabel?: string;
     highLabel?: string;
@@ -318,6 +336,7 @@ export type Segment = (TextSegment | ChatSegment | ArticleSegment | VideoSegment
 import { type TranscriptSentence } from "./bundler/video.js";
 export type { TranscriptSentence } from "./bundler/video.js";
 export { parseWidget, isWidgetPath } from "./parser/widget.js";
+import { type GlossaryDefinition, type GlossaryMark } from "./glossary.js";
 export type { ContentTier } from "./validator/tier.js";
 export { checkTierViolation } from "./validator/tier.js";
 import { type SkillTree } from "./skill-tree.js";

package/dist/index.js

@@ -4,6 +4,7 @@ import { populateCardModuleSlugs, resolveInlineLensModuleSlugs, } from "./flatte
 import { parseModule } from "./parser/module.js";
 import { parseCourse } from "./parser/course.js";
 import { parseSurvey } from "./parser/survey.js";
+import { MEETING_DOC_SHARED_DIR, parseMeetingDoc, } from "./parser/meeting-doc.js";
 import { parseLearningOutcome, } from "./parser/learning-outcome.js";
 import { parseLens } from "./parser/lens.js";
 import { parseWikilink, resolveWikilinkPath, findFileWithExtension, findSimilarFiles, formatSuggestion, } from "./parser/wikilink.js";
@@ -17,6 +18,7 @@ import { parseWidget, isWidgetPath } from "./parser/widget.js";
 export { parseWidget, isWidgetPath } from "./parser/widget.js";
 import { parseVideoTranscript } from "./parser/video-transcript.js";
 import { parsePrompt, isPromptPath } from "./parser/prompt.js";
+import { applyGlossary, isGlossaryPath, parseGlossaryEntry, validateGlossaryAliases, } from "./glossary.js";
 import { validateTimestamps } from "./validator/timestamps.js";
 import { levenshtein } from "./validator/field-typos.js";
 import { buildTagMap, buildTierMap, checkTierViolation, } from "./validator/tier.js";
@@ -156,6 +158,7 @@ function processContentRun(files, cache) {
     const courses = [];
     const surveys = [];
     const surveyPathToId = new Map();
+    const meetingDocs = {};
     const errors = [];
     const urlsToValidate = [];
     const uuidEntries = [];
@@ -177,6 +180,7 @@ function processContentRun(files, cache) {
     // LO path → module path → the submodules (local slug → title) that
     // reference it; empty when the module is not split or the LO is module-level.
     const moduleLoRefs = new Map();
+    const glossaryEntries = new Map();
     const skillTreeModules = new Map();
     // Record that `modulePath` references each LO reachable from `sections`,
     // remembering which submodule it sits in. A "# Submodule:" heading opens a
@@ -307,6 +311,14 @@ function processContentRun(files, cache) {
             }
             errors.push(...result.errors);
         }
+        else if (path.startsWith("meetings/") &&
+            path.endsWith(".md") &&
+            !path.startsWith(MEETING_DOC_SHARED_DIR)) {
+            const result = parseMeetingDoc(content, path, files);
+            errors.push(...result.errors);
+            if (result.markdown !== null)
+                meetingDocs[path] = result.markdown;
+        }
         else if (path.startsWith("surveys/") || path.includes("/surveys/")) {
             const result = parseSurvey(content, path);
             errors.push(...result.errors);
@@ -555,6 +567,12 @@ function processContentRun(files, cache) {
                 });
             }
         }
+        else if (isGlossaryPath(path) && path.endsWith(".md")) {
+            const result = parseGlossaryEntry(content, path);
+            errors.push(...result.errors);
+            if (result.entry)
+                glossaryEntries.set(path, result.entry);
+        }
         else if (isPromptPath(path)) {
             // Fully validate prompt file (frontmatter + non-empty prompt text)
             const result = parsePrompt(content, path);
@@ -585,6 +603,7 @@ function processContentRun(files, cache) {
                 "Domains and Topics",
                 "prompts",
                 "widgets",
+                "glossary",
             ];
             let closest = "";
             let minDist = Infinity;
@@ -607,6 +626,7 @@ function processContentRun(files, cache) {
             }
         }
     }
+    errors.push(...validateGlossaryAliases(glossaryEntries));
     // Build contentId → moduleSlug mapping and populate moduleSlug in cross-module card links.
     // Prefer real modules over standalone lenses (lens/ prefix) — a lens that appears in
     // both a module and as a standalone should map to the module.
@@ -624,6 +644,21 @@ function processContentRun(files, cache) {
         populateCardModuleSlugs(mod.sections, contentIdToModuleSlug);
         resolveInlineLensModuleSlugs(mod.sections, contentIdToModuleSlug);
     }
+    // Glossary marks are offsets into segment text, so they are placed after
+    // every pass that rewrites it (card links and lens links above, card
+    // metadata in the flattener).
+    for (const mod of modules) {
+        for (const section of mod.sections) {
+            if (section.glossaryTerms === undefined)
+                continue;
+            const result = applyGlossary(section.glossaryTerms, section.segments, section.sourcePath ?? mod.sourcePath ?? mod.slug, files, glossaryEntries, tierMap);
+            errors.push(...result.errors);
+            section.segments = result.segments;
+            if (result.glossary.length)
+                section.glossary = result.glossary;
+            delete section.glossaryTerms;
+        }
+    }
     // Card-to-module membership check. Runs after card link resolution above so
     // every card has its data-lens-card JSON populated, including allowExternal.
     errors.push(...validateCardModuleMembership(modules));
@@ -708,6 +743,22 @@ function processContentRun(files, cache) {
                         label: "facilitator-survey",
                     },
                 ];
+                if (item.docPath) {
+                    const resolved = resolveWikilinkPath(item.docPath, courseFile);
+                    const actualFile = findFileWithExtension(resolved, files);
+                    if (actualFile && actualFile in meetingDocs) {
+                        item.docPath = actualFile;
+                    }
+                    else {
+                        errors.push({
+                            file: courseFile,
+                            message: `Meeting doc reference could not be resolved: "${item.docPath}"`,
+                            suggestion: "Check that meeting-doc:: points to an existing, error-free file in meetings/",
+                            severity: "error",
+                        });
+                        delete item.docPath;
+                    }
+                }
                 for (const field of surveyFields) {
                     const surveyPath = item[field.pathKey];
                     if (!surveyPath) {
@@ -907,6 +958,7 @@ function processContentRun(files, cache) {
         modules,
         courses,
         surveys,
+        ...(Object.keys(meetingDocs).length > 0 ? { meetingDocs } : {}),
         errors: dedupeErrors(errors),
         urlsToValidate,
         skillTree: skillTreeResult.skillTree,