lens-content-processor 0.3.0 → 0.5.0

package/dist/parser/learning-outcome.js

@@ -1,13 +1,14 @@
-import { parseFrontmatter } from './frontmatter.js';
-import { parseSections, LO_SECTION_TYPES } from './sections.js';
-import { parseWikilink, resolveWikilinkPath, hasRelativePath } from './wikilink.js';
-import { detectFieldTypos } from '../validator/field-typos.js';
-import { validateFrontmatter } from '../validator/validate-frontmatter.js';
-import { parseSegments, convertSegment, stripObsidianComments } from './lens.js';
+import { parseFrontmatter } from "./frontmatter.js";
+import { parseSections, LO_SECTION_TYPES, } from "./sections.js";
+import { parseWikilink, resolveWikilinkPath, hasRelativePath, } from "./wikilink.js";
+import { detectFieldTypos } from "../validator/field-typos.js";
+import { validateFrontmatter } from "../validator/validate-frontmatter.js";
+import { validateTestSegments } from "../validator/test-segments.js";
+import { convertSegment, stripAuthoringMarkup, LENS_SEGMENT_TYPES, } from "./lens.js";
 export function parseLearningOutcome(content, file) {
     const errors = [];
-    // Strip Obsidian comments before parsing
-    content = stripObsidianComments(content);
+    // Strip authoring markup (CriticMarkup + Obsidian comments) before parsing
+    content = stripAuthoringMarkup(content);
     // Step 1: Parse frontmatter and validate id field
     const frontmatterResult = parseFrontmatter(content, file);
     if (frontmatterResult.error) {
@@ -15,24 +16,25 @@ export function parseLearningOutcome(content, file) {
         return { learningOutcome: null, errors };
     }
     const { frontmatter, body, bodyStartLine } = frontmatterResult;
-    const frontmatterErrors = validateFrontmatter(frontmatter, 'learning-outcome', file);
+    const frontmatterErrors = validateFrontmatter(frontmatter, "learning-outcome", file);
     errors.push(...frontmatterErrors);
-    if (frontmatterErrors.some(e => e.severity === 'error')) {
+    if (frontmatterErrors.some((e) => e.severity === "error")) {
         return { learningOutcome: null, errors };
     }
     // LO-specific: id must be a string
-    if (typeof frontmatter.id !== 'string') {
+    if (typeof frontmatter.id !== "string") {
         errors.push({
             file,
             line: 2,
             message: `Field 'id' must be a string, got ${typeof frontmatter.id}`,
             suggestion: "Use quotes: id: '12345'",
-            severity: 'error',
+            severity: "error",
         });
         return { learningOutcome: null, errors };
     }
-    // Step 2: Parse sections with H2 level and LO_SECTION_TYPES ('lens', 'test')
-    const sectionsResult = parseSections(body, 2, LO_SECTION_TYPES, file);
+    // Step 2: Parse sections with H2 level and LO_SECTION_TYPES + 'submodule'
+    const loSectionTypes = new Set([...LO_SECTION_TYPES, "submodule"]);
+    const sectionsResult = parseSections(body, 0, loSectionTypes, file);
     // Adjust line numbers to account for frontmatter
     for (const error of sectionsResult.errors) {
         if (error.line) {
@@ -43,31 +45,85 @@ export function parseLearningOutcome(content, file) {
     for (const section of sectionsResult.sections) {
         section.line += bodyStartLine - 1;
     }
-    // Step 3: Extract lens refs with source field and optional flag
-    const lenses = [];
-    let testRef;
-    for (const section of sectionsResult.sections) {
-        // Detect likely typos in field names
+    // Helper: extract a lens ref from a parsed section
+    function extractLensRef(section) {
         const typoWarnings = detectFieldTypos(section.fields, file, section.line);
         errors.push(...typoWarnings);
-        if (section.type === 'lens') {
-            const source = section.fields.source;
-            if (!source) {
-                errors.push({
-                    file,
-                    line: section.line,
-                    message: 'Lens section missing source:: field',
-                    suggestion: "Add 'source:: [[../Lenses/filename.md|Display]]' to the lens section",
-                    severity: 'error',
-                });
-                continue;
+        const source = section.fields.source;
+        if (!source) {
+            errors.push({
+                file,
+                line: section.line,
+                message: "Lens section missing source:: field",
+                suggestion: "Add 'source:: [[../Lenses/filename.md|Display]]' to the lens section",
+                severity: "error",
+            });
+            return null;
+        }
+        const wikilink = parseWikilink(source);
+        if (!wikilink || wikilink.error) {
+            const suggestion = wikilink?.correctedPath
+                ? `Did you mean '[[${wikilink.correctedPath}]]'?`
+                : "Use format [[../Lenses/filename.md|Display Text]]";
+            errors.push({
+                file,
+                line: section.line,
+                message: wikilink?.error
+                    ? `${wikilink.error} in source:: field: ${source}`
+                    : `Invalid wikilink format in source:: field: ${source}`,
+                suggestion,
+                severity: "error",
+            });
+            return null;
+        }
+        if (!hasRelativePath(wikilink.path)) {
+            errors.push({
+                file,
+                line: section.line,
+                message: `source:: path must be relative (contain /): ${wikilink.path}`,
+                suggestion: "Use format [[../Lenses/filename.md|Display Text]] with relative path",
+                severity: "error",
+            });
+            return null;
+        }
+        const resolvedPath = resolveWikilinkPath(wikilink.path, file);
+        const optional = section.fields.optional?.toLowerCase() === "true";
+        const hide = section.fields.hide?.toLowerCase() === "true";
+        return { source, resolvedPath, optional, hide };
+    }
+    // Helper: extract test ref from a parsed section
+    function extractTestRef(section) {
+        const id = section.fields.id;
+        if (!id) {
+            const hasSource = Boolean(section.fields.source);
+            const hasSegmentHeader = /^(#{1,6})\s+(Text|Question|Chat|Roleplay)(?::|\s*$)/im.test(section.body);
+            const hasKnownTestFields = [
+                "content",
+                "assessment-instructions",
+                "ai-instructions",
+                "opening-message",
+                "feedback",
+            ].some((field) => section.fields[field] !== undefined);
+            if (!hasSource && !hasSegmentHeader && !hasKnownTestFields) {
+                return undefined;
             }
-            // Parse wikilink and resolve path
+            errors.push({
+                file,
+                line: section.line,
+                message: "Test section missing required id:: field",
+                suggestion: "Add an id:: field with a UUID (e.g., id:: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)",
+                severity: "error",
+            });
+            return undefined;
+        }
+        const source = section.fields.source;
+        let resolvedPath;
+        if (source) {
             const wikilink = parseWikilink(source);
             if (!wikilink || wikilink.error) {
                 const suggestion = wikilink?.correctedPath
                     ? `Did you mean '[[${wikilink.correctedPath}]]'?`
-                    : 'Use format [[../Lenses/filename.md|Display Text]]';
+                    : "Use format [[../Tests/filename.md|Display Text]]";
                 errors.push({
                     file,
                     line: section.line,
@@ -75,80 +131,100 @@ export function parseLearningOutcome(content, file) {
                         ? `${wikilink.error} in source:: field: ${source}`
                         : `Invalid wikilink format in source:: field: ${source}`,
                     suggestion,
-                    severity: 'error',
+                    severity: "error",
                 });
-                continue;
+                return undefined;
             }
-            // Require relative path (must contain /)
-            if (!hasRelativePath(wikilink.path)) {
-                errors.push({
-                    file,
-                    line: section.line,
-                    message: `source:: path must be relative (contain /): ${wikilink.path}`,
-                    suggestion: 'Use format [[../Lenses/filename.md|Display Text]] with relative path',
-                    severity: 'error',
-                });
-                continue;
+            resolvedPath = resolveWikilinkPath(wikilink.path, file);
+        }
+        const { sections: rawSegments, errors: segmentErrors } = parseSections(section.body, section.level, LENS_SEGMENT_TYPES, file, true);
+        for (const err of segmentErrors) {
+            if (err.line) {
+                err.line += bodyStartLine - 1;
             }
-            const resolvedPath = resolveWikilinkPath(wikilink.path, file);
-            const optional = section.fields.optional?.toLowerCase() === 'true';
-            lenses.push({
-                source,
-                resolvedPath,
-                optional,
-            });
         }
-        else if (section.type === 'test') {
-            const source = section.fields.source;
-            let resolvedPath;
-            if (source) {
-                // Parse wikilink and resolve path
-                const wikilink = parseWikilink(source);
-                if (!wikilink || wikilink.error) {
-                    const suggestion = wikilink?.correctedPath
-                        ? `Did you mean '[[${wikilink.correctedPath}]]'?`
-                        : 'Use format [[../Tests/filename.md|Display Text]]';
-                    errors.push({
-                        file,
-                        line: section.line,
-                        message: wikilink?.error
-                            ? `${wikilink.error} in source:: field: ${source}`
-                            : `Invalid wikilink format in source:: field: ${source}`,
-                        suggestion,
-                        severity: 'error',
-                    });
-                    continue;
-                }
-                resolvedPath = resolveWikilinkPath(wikilink.path, file);
+        errors.push(...segmentErrors);
+        // A Test is an assessment: only question/roleplay segments are rendered and
+        // scored. Flag any other segment type (e.g. intro text) — it is silently dropped.
+        const testSegmentErrors = validateTestSegments(rawSegments, file);
+        for (const err of testSegmentErrors) {
+            if (err.line) {
+                err.line += bodyStartLine - 1;
             }
-            // Parse inline H4 segments (#### Question, #### Chat, #### Text) from body
-            const { segments: rawSegments, errors: segmentErrors } = parseSegments(section.body, section.line + 1, file);
-            // Adjust segment error line numbers for frontmatter offset
-            for (const err of segmentErrors) {
+        }
+        errors.push(...testSegmentErrors);
+        const testSegments = [];
+        for (const rawSeg of rawSegments) {
+            const { segment, errors: conversionErrors } = convertSegment(rawSeg, "lens", file);
+            for (const err of conversionErrors) {
                 if (err.line) {
                     err.line += bodyStartLine - 1;
                 }
             }
-            errors.push(...segmentErrors);
-            const testSegments = [];
-            for (const rawSeg of rawSegments) {
-                const { segment, errors: conversionErrors } = convertSegment(rawSeg, 'page', file);
-                // Adjust conversion error line numbers for frontmatter offset
-                for (const err of conversionErrors) {
-                    if (err.line) {
-                        err.line += bodyStartLine - 1;
+            errors.push(...conversionErrors);
+            if (segment) {
+                testSegments.push(segment);
+            }
+        }
+        return { id, source, resolvedPath, segments: testSegments };
+    }
+    // Step 3: Check for submodule sections
+    const hasSubmodules = sectionsResult.sections.some((s) => s.type === "submodule");
+    const lenses = [];
+    let testRef;
+    let submodules;
+    if (hasSubmodules) {
+        // All-or-nothing: reject top-level lens/test sections when submodules exist
+        const orphanedSections = sectionsResult.sections.filter((s) => s.type !== "submodule");
+        if (orphanedSections.length > 0) {
+            errors.push({
+                file,
+                line: orphanedSections[0].line,
+                message: "Content found outside submodule boundaries — when using Submodule markers, all content must be inside a submodule",
+                suggestion: "Move this content into a Submodule section",
+                severity: "error",
+            });
+        }
+        submodules = [];
+        for (const section of sectionsResult.sections) {
+            if (section.type !== "submodule")
+                continue;
+            const group = {
+                title: section.title,
+                customSlug: section.fields.slug,
+                lenses: [],
+            };
+            // Process children (lens/test sections at H3)
+            if (section.children) {
+                for (const child of section.children) {
+                    if (child.type === "lens") {
+                        const ref = extractLensRef(child);
+                        if (ref) {
+                            group.lenses.push(ref);
+                            lenses.push(ref); // Also add to flat list for validation
+                        }
+                    }
+                    else if (child.type === "test") {
+                        group.test = extractTestRef(child);
                     }
-                }
-                errors.push(...conversionErrors);
-                if (segment) {
-                    testSegments.push(segment);
                 }
             }
-            testRef = {
-                source,
-                resolvedPath,
-                segments: testSegments,
-            };
+            submodules.push(group);
+        }
+    }
+    else {
+        // Normal path: extract lens refs from top-level sections
+        for (const section of sectionsResult.sections) {
+            const typoWarnings = detectFieldTypos(section.fields, file, section.line);
+            errors.push(...typoWarnings);
+            if (section.type === "lens") {
+                const ref = extractLensRef(section);
+                if (ref)
+                    lenses.push(ref);
+            }
+            else if (section.type === "test") {
+                testRef = extractTestRef(section);
+            }
         }
     }
     // Step 4: Validate at least one lens exists
@@ -156,17 +232,22 @@ export function parseLearningOutcome(content, file) {
         errors.push({
             file,
             line: bodyStartLine,
-            message: 'Learning Outcome must have at least one ## Lens: section',
+            message: "Learning Outcome must have at least one ## Lens: section",
             suggestion: "Add a '## Lens: <title>' section with a source:: field",
-            severity: 'error',
+            severity: "error",
         });
     }
+    const loAddToAiContext = "add_to_ai_context" in frontmatter
+        ? frontmatter.add_to_ai_context
+        : undefined;
     // Return result even if there are errors (partial success)
     const learningOutcome = {
         id: frontmatter.id,
         lenses,
         test: testRef,
         discussion: frontmatter.discussion,
+        submodules,
+        addToAiContext: loAddToAiContext,
     };
     return { learningOutcome, errors };
 }

package/dist/parser/learning-outcome.js.map

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

package/dist/parser/lens.d.ts

@@ -6,22 +6,25 @@ export interface ParsedTextSegment {
 }
 export interface ParsedChatSegment {
     type: 'chat';
-    title?: string;
     instructions?: string;
     hidePreviousContentFromUser?: boolean;
     hidePreviousContentFromTutor?: boolean;
     optional?: boolean;
 }
-export interface ParsedArticleExcerptSegment {
-    type: 'article-excerpt';
+export interface ParsedArticleSegment {
+    type: 'article';
+    source?: string;
+    resolvedPath?: string;
     fromAnchor?: string;
     toAnchor?: string;
     optional?: boolean;
 }
-export interface ParsedVideoExcerptSegment {
-    type: 'video-excerpt';
+export interface ParsedVideoSegment {
+    type: 'video';
+    source?: string;
+    resolvedPath?: string;
     fromTimeStr: string;
-    toTimeStr: string;
+    toTimeStr?: string;
     optional?: boolean;
 }
 export interface ParsedQuestionSegment {
@@ -34,37 +37,38 @@ export interface ParsedQuestionSegment {
     optional?: boolean;
     feedback?: boolean;
 }
-export type ParsedLensSegment = ParsedTextSegment | ParsedChatSegment | ParsedArticleExcerptSegment | ParsedVideoExcerptSegment | ParsedQuestionSegment;
-export interface ParsedLensSection {
-    type: string;
-    title: string;
-    source?: string;
-    resolvedPath?: string;
-    segments: ParsedLensSegment[];
-    line: number;
+export interface ParsedRoleplaySegment {
+    type: 'roleplay';
+    id: string;
+    content: string;
+    aiInstructions: string;
+    openingMessage?: string;
+    assessmentInstructions?: string;
+    userCustomizable?: boolean;
+    optional?: boolean;
+    feedback?: boolean;
 }
+export type ParsedLensSegment = ParsedTextSegment | ParsedChatSegment | ParsedArticleSegment | ParsedVideoSegment | ParsedQuestionSegment | ParsedRoleplaySegment;
 export interface ParsedLens {
     id: string;
-    sections: ParsedLensSection[];
+    title?: string;
+    tldr?: string;
+    summaryForTutor?: string;
+    addToAiContext?: string[] | null;
+    segments: ParsedLensSegment[];
 }
 export interface LensParseResult {
     lens: ParsedLens | null;
     errors: ContentError[];
 }
-interface RawSegment {
+export declare const LENS_SEGMENT_TYPES: Set<string>;
+/** Common interface for raw segments — compatible with ParsedSection */
+export interface RawSegment {
     type: string;
     title?: string;
     fields: Record<string, string>;
     line: number;
 }
-/**
- * Parse H4 segments from a section body.
- * Segments are defined by `#### <type>` headers within a section.
- */
-export declare function parseSegments(sectionBody: string, bodyStartLine: number, file: string): {
-    segments: RawSegment[];
-    errors: ContentError[];
-};
 /**
  * Convert a raw segment to a typed ParsedLensSegment.
  */
@@ -77,12 +81,32 @@ export declare function convertSegment(raw: RawSegment, sectionType: string, fil
  * Handles both inline (%% ... %% on same line) and block (multiline) comments.
  */
 export declare function stripObsidianComments(content: string): string;
+/**
+ * Strip CriticMarkup from content using reject-all-changes behavior:
+ * - {>>comments<<} -> removed
+ * - {++additions++} -> removed
+ * - {--deletions--} -> inner content kept (original preserved)
+ * - {~~old~>new~~} -> old text kept
+ * - {==highlights==} -> inner content kept, markers removed
+ */
+export declare function stripCriticMarkup(content: string): string;
+/**
+ * Strip all authoring markup (CriticMarkup + Obsidian comments) from content.
+ * Call at the top of each parser before any processing.
+ */
+export declare function stripAuthoringMarkup(content: string): string;
+/**
+ * Apply source inheritance for article and video segments.
+ * Each article/video segment inherits source:: from the previous segment of the same type.
+ * Errors if the first segment of a type has no source.
+ *
+ * Mutates segments in place. Returns any errors.
+ */
+export declare function applySourceInheritance(segments: ParsedLensSegment[], file: string): ContentError[];
 /**
  * Parse a lens file into structured lens data.
  *
- * Lens files use:
- * - H3 (`###`) for sections: Text, Article, Video
- * - H4 (`####`) for segments: Text, Chat, Article-excerpt, Video-excerpt
+ * Lens files are flat: frontmatter + H4 segments directly.
+ * No H3 section headers. Source is on segments with inheritance.
  */
 export declare function parseLens(content: string, file: string): LensParseResult;
-export {};