lens-content-processor 0.2.2 → 0.4.0

package/dist/parser/learning-outcome.js

@@ -3,8 +3,11 @@ 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, stripAuthoringMarkup } from './lens.js';
 export function parseLearningOutcome(content, file) {
     const errors = [];
+    // 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) {
@@ -28,8 +31,9 @@ export function parseLearningOutcome(content, file) {
         });
         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, 2, loSectionTypes, file);
     // Adjust line numbers to account for frontmatter
     for (const error of sectionsResult.errors) {
         if (error.line) {
@@ -40,85 +44,153 @@ 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;
-            }
-            // Parse wikilink and resolve path
+        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';
+        return { source, resolvedPath, optional };
+    }
+    // Helper: extract test ref from a parsed section
+    function extractTestRef(section) {
+        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,
-                    message: `Invalid wikilink format in source:: field: ${source}`,
+                    message: wikilink?.error
+                        ? `${wikilink.error} in source:: field: ${source}`
+                        : `Invalid wikilink format in source:: field: ${source}`,
                     suggestion,
                     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 { segments: rawSegments, errors: segmentErrors } = parseSegments(section.body, section.line + 1, file);
+        for (const err of segmentErrors) {
+            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);
+            for (const err of conversionErrors) {
+                if (err.line) {
+                    err.line += bodyStartLine - 1;
+                }
+            }
+            errors.push(...conversionErrors);
+            if (segment) {
+                testSegments.push(segment);
             }
-            const resolvedPath = resolveWikilinkPath(wikilink.path, file);
-            const optional = section.fields.optional?.toLowerCase() === 'true';
-            lenses.push({
-                source,
-                resolvedPath,
-                optional,
+        }
+        return { 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',
             });
         }
-        else if (section.type === 'test') {
-            const source = section.fields.source;
-            // source:: is optional for test sections (tests not fully implemented yet)
-            if (!source) {
+        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);
+                    }
+                }
             }
-            // 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: `Invalid wikilink format in source:: field: ${source}`,
-                    suggestion,
-                    severity: 'error',
-                });
-                continue;
+            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);
             }
-            const resolvedPath = resolveWikilinkPath(wikilink.path, file);
-            testRef = {
-                source,
-                resolvedPath,
-            };
         }
     }
     // Step 4: Validate at least one lens exists
@@ -137,6 +209,7 @@ export function parseLearningOutcome(content, file) {
         lenses,
         test: testRef,
         discussion: frontmatter.discussion,
+        submodules,
     };
     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

@@ -24,7 +24,27 @@ export interface ParsedVideoExcerptSegment {
     toTimeStr: string;
     optional?: boolean;
 }
-export type ParsedLensSegment = ParsedTextSegment | ParsedChatSegment | ParsedArticleExcerptSegment | ParsedVideoExcerptSegment;
+export interface ParsedQuestionSegment {
+    type: 'question';
+    content: string;
+    assessmentInstructions?: string;
+    maxTime?: string;
+    maxChars?: number;
+    enforceVoice?: boolean;
+    optional?: boolean;
+    feedback?: boolean;
+}
+export interface ParsedRoleplaySegment {
+    type: 'roleplay';
+    id: string;
+    content: string;
+    aiInstructions: string;
+    openingMessage?: string;
+    assessmentInstructions?: string;
+    optional?: boolean;
+    feedback?: boolean;
+}
+export type ParsedLensSegment = ParsedTextSegment | ParsedChatSegment | ParsedArticleExcerptSegment | ParsedVideoExcerptSegment | ParsedQuestionSegment | ParsedRoleplaySegment;
 export interface ParsedLensSection {
     type: string;
     title: string;
@@ -35,12 +55,53 @@ export interface ParsedLensSection {
 }
 export interface ParsedLens {
     id: string;
+    tldr?: string;
     sections: ParsedLensSection[];
 }
 export interface LensParseResult {
     lens: ParsedLens | null;
     errors: ContentError[];
 }
+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.
+ */
+export declare function convertSegment(raw: RawSegment, sectionType: string, file: string): {
+    segment: ParsedLensSegment | null;
+    errors: ContentError[];
+};
+/**
+ * Strip Obsidian %% comments %% from content.
+ * 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;
 /**
  * Parse a lens file into structured lens data.
  *
@@ -49,3 +110,4 @@ export interface LensParseResult {
  * - H4 (`####`) for segments: Text, Chat, Article-excerpt, Video-excerpt
  */
 export declare function parseLens(content: string, file: string): LensParseResult;
+export {};

package/dist/parser/lens.js

@@ -1,28 +1,31 @@
+import { ALL_KNOWN_FIELDS } from '../content-schema.js';
 import { parseFrontmatter } from './frontmatter.js';
 import { parseSections, LENS_SECTION_TYPES, LENS_OUTPUT_TYPE } from './sections.js';
 import { validateSegmentFields } from '../validator/segment-fields.js';
 import { validateFieldValues } from '../validator/field-values.js';
 import { detectFieldTypos } from '../validator/field-typos.js';
 import { validateFrontmatter } from '../validator/validate-frontmatter.js';
+import { validateChatPrecedence } from '../validator/chat-precedence.js';
+import { detectDirectivesInNonArticle } from '../validator/directives.js';
 import { parseWikilink, hasRelativePath } from './wikilink.js';
 import { parseTimestamp } from '../bundler/video.js';
 // Valid segment types for lens H4 headers
-const LENS_SEGMENT_TYPES = new Set(['text', 'chat', 'article-excerpt', 'video-excerpt']);
+const LENS_SEGMENT_TYPES = new Set(['text', 'chat', 'article-excerpt', 'video-excerpt', 'question', 'roleplay']);
 // Valid segment types per section output type
 const VALID_SEGMENTS_PER_SECTION = {
-    'page': new Set(['text', 'chat']),
-    'lens-article': new Set(['text', 'chat', 'article-excerpt']),
-    'lens-video': new Set(['text', 'chat', 'video-excerpt']),
+    'page': new Set(['text', 'chat', 'question', 'roleplay']),
+    'lens-article': new Set(['text', 'chat', 'article-excerpt', 'question', 'roleplay']),
+    'lens-video': new Set(['text', 'chat', 'video-excerpt', 'question', 'roleplay']),
 };
 // H4 segment header pattern: #### <type> or #### <type>: <title>
-const SEGMENT_HEADER_PATTERN = /^####\s+([^:\s]+)(?::\s*(.*))?$/i;
+const SEGMENT_HEADER_PATTERN = /^####\s+([^:\s]+)(?::\s*(.*?))?\s*$/i;
 // Field pattern: fieldname:: value
-const FIELD_PATTERN = /^(\w+)::\s*(.*)$/;
+const FIELD_PATTERN = /^([\w-]+)::\s*(.*)$/;
 /**
  * Parse H4 segments from a section body.
  * Segments are defined by `#### <type>` headers within a section.
  */
-function parseSegments(sectionBody, bodyStartLine, file) {
+export function parseSegments(sectionBody, bodyStartLine, file) {
     const lines = sectionBody.split('\n');
     const segments = [];
     const errors = [];
@@ -61,14 +64,14 @@ function parseSegments(sectionBody, bodyStartLine, file) {
         }
         else if (currentSegment) {
             // Check for single-colon field that should be double-colon
-            const singleColonMatch = line.match(/^(\w+):\s+(.*)$/);
-            if (singleColonMatch && !line.match(/^https?:/) && !FIELD_PATTERN.test(line)) {
+            const singleColonMatch = line.match(/^([\w-]+):\s+(.*)$/);
+            if (singleColonMatch && !line.match(/^https?:/) && !FIELD_PATTERN.test(line) && ALL_KNOWN_FIELDS.includes(singleColonMatch[1])) {
                 errors.push({
                     file,
                     line: lineNum,
                     message: `Found '${singleColonMatch[1]}:' with single colon — did you mean '${singleColonMatch[1]}::'?`,
                     suggestion: `Change '${singleColonMatch[1]}:' to '${singleColonMatch[1]}::' (double colon)`,
-                    severity: 'warning',
+                    severity: 'error',
                 });
             }
             currentFieldLines.push(line);
@@ -125,7 +128,7 @@ function parseFieldsIntoSegment(segment, lines) {
 /**
  * Convert a raw segment to a typed ParsedLensSegment.
  */
-function convertSegment(raw, sectionType, file) {
+export function convertSegment(raw, sectionType, file) {
     const errors = [];
     switch (raw.type) {
         case 'text': {
@@ -159,6 +162,9 @@ function convertSegment(raw, sectionType, file) {
                 };
                 return { segment, errors };
             }
+            // Warn if directives are used in lens text segments (they only render in articles)
+            const directiveWarnings = detectDirectivesInNonArticle(content, file, raw.line);
+            errors.push(...directiveWarnings);
             const segment = {
                 type: 'text',
                 content,
@@ -261,6 +267,76 @@ function convertSegment(raw, sectionType, file) {
             };
             return { segment, errors };
         }
+        case 'question': {
+            const content = raw.fields['content'];
+            if (!content || content.trim() === '') {
+                errors.push({
+                    file,
+                    line: raw.line,
+                    message: 'Question segment missing content:: field',
+                    suggestion: "Add 'content:: Your question here'",
+                    severity: 'error',
+                });
+                return { segment: null, errors };
+            }
+            const segment = {
+                type: 'question',
+                content,
+                assessmentInstructions: raw.fields['assessment-instructions'] || undefined,
+                maxTime: raw.fields['max-time'] || undefined,
+                maxChars: raw.fields['max-chars'] ? parseInt(raw.fields['max-chars'], 10) : undefined,
+                enforceVoice: raw.fields['enforce-voice']?.toLowerCase() === 'true' ? true : undefined,
+                optional: raw.fields.optional?.toLowerCase() === 'true' ? true : undefined,
+                feedback: raw.fields['feedback']?.toLowerCase() === 'true' ? true : undefined,
+            };
+            return { segment, errors };
+        }
+        case 'roleplay': {
+            const id = raw.fields['id'];
+            if (!id || id.trim() === '') {
+                errors.push({
+                    file,
+                    line: raw.line,
+                    message: 'Roleplay segment missing id:: field',
+                    suggestion: "Add 'id:: <uuid>' to the roleplay segment",
+                    severity: 'error',
+                });
+            }
+            const content = raw.fields['content'];
+            if (!content || content.trim() === '') {
+                errors.push({
+                    file,
+                    line: raw.line,
+                    message: 'Roleplay segment missing content:: field',
+                    suggestion: "Add 'content:: Your scenario briefing here'",
+                    severity: 'error',
+                });
+            }
+            const aiInstructions = raw.fields['ai-instructions'];
+            if (!aiInstructions || aiInstructions.trim() === '') {
+                errors.push({
+                    file,
+                    line: raw.line,
+                    message: 'Roleplay segment missing ai-instructions:: field',
+                    suggestion: "Add 'ai-instructions:: Character behavior description'",
+                    severity: 'error',
+                });
+            }
+            if (!id || id.trim() === '' || !content || content.trim() === '' || !aiInstructions || aiInstructions.trim() === '') {
+                return { segment: null, errors };
+            }
+            const segment = {
+                type: 'roleplay',
+                id,
+                content,
+                aiInstructions,
+                openingMessage: raw.fields['opening-message'] || undefined,
+                assessmentInstructions: raw.fields['assessment-instructions'] || undefined,
+                optional: raw.fields.optional?.toLowerCase() === 'true' ? true : undefined,
+                feedback: raw.fields['feedback']?.toLowerCase() === 'true' ? true : undefined,
+            };
+            return { segment, errors };
+        }
         default:
             // Unknown segment type - error already reported during parseSegments
             return { segment: null, errors };
@@ -299,6 +375,38 @@ function checkEmptySegment(raw, file) {
     }
     return null;
 }
+/**
+ * Strip Obsidian %% comments %% from content.
+ * Handles both inline (%% ... %% on same line) and block (multiline) comments.
+ */
+export function stripObsidianComments(content) {
+    return content.replace(/%%.*?%%/gs, '');
+}
+/**
+ * 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 function stripCriticMarkup(content) {
+    return content
+        .replace(/\{>>.*?<<\}/gs, '') // Comments → remove
+        .replace(/\{\+\+.*?\+\+\}/gs, '') // Additions → remove
+        .replace(/\{--(?:\{[^}]*\}@@)?(.*?)--\}/gs, '$1') // Deletions → keep inner (skip metadata)
+        .replace(/\{~~(?:\{[^}]*\}@@)?(.*?)~>.*?~~\}/gs, '$1') // Substitutions → keep old (skip metadata)
+        .replace(/\{==(?:\{[^}]*\}@@)?(.*?)==\}/gs, '$1'); // Highlights → keep inner (skip metadata)
+}
+/**
+ * Strip all authoring markup (CriticMarkup + Obsidian comments) from content.
+ * Call at the top of each parser before any processing.
+ */
+export function stripAuthoringMarkup(content) {
+    const stripped = stripObsidianComments(stripCriticMarkup(content));
+    // Trim trailing whitespace left by inline markup removal
+    return stripped.split('\n').map(line => line.trimEnd()).join('\n');
+}
 /**
  * Parse a lens file into structured lens data.
  *
@@ -308,6 +416,8 @@ function checkEmptySegment(raw, file) {
  */
 export function parseLens(content, file) {
     const errors = [];
+    // 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) {
@@ -331,6 +441,19 @@ export function parseLens(content, file) {
         });
         return { lens: null, errors };
     }
+    const tldr = typeof frontmatter.tldr === 'string' ? frontmatter.tldr : undefined;
+    if (tldr) {
+        const wordCount = tldr.trim().split(/\s+/).filter(Boolean).length;
+        if (wordCount > 80) {
+            errors.push({
+                file,
+                line: 2,
+                message: `tldr exceeds 80 words (has ${wordCount})`,
+                suggestion: 'Shorten the tldr to 80 words or fewer',
+                severity: 'error',
+            });
+        }
+    }
     // Step 2: Parse H3 sections (Text, Article, Video)
     const sectionsResult = parseSections(body, 3, LENS_SECTION_TYPES, file);
     // Adjust line numbers to account for frontmatter
@@ -423,6 +546,9 @@ export function parseLens(content, file) {
                 segments.push(segment);
             }
         }
+        // Validate Chat segments are preceded by Text segments
+        const chatErrors = validateChatPrecedence(rawSegments, file);
+        errors.push(...chatErrors);
         // Warn if section has no segments
         if (segments.length === 0) {
             errors.push({
@@ -456,6 +582,7 @@ export function parseLens(content, file) {
     }
     const lens = {
         id: frontmatter.id,
+        tldr,
         sections: parsedSections,
     };
     return { lens, errors };