lens-content-processor 0.1.0

package/dist/fs/read-vault.test.js

@@ -0,0 +1,37 @@
+// src/fs/read-vault.test.ts
+import { describe, it, expect } from 'vitest';
+import { readVaultFiles } from './read-vault.js';
+import { join } from 'path';
+import { mkdtempSync, rmSync } from 'fs';
+import { tmpdir } from 'os';
+describe('readVaultFiles', () => {
+    it('reads all .md files from fixture directory', async () => {
+        const fixturesDir = join(import.meta.dirname, '../../fixtures/valid/minimal-module/input');
+        const files = await readVaultFiles(fixturesDir);
+        expect(files.has('modules/intro.md')).toBe(true);
+        expect(files.get('modules/intro.md')).toContain('slug: intro');
+    });
+    it('reads files from nested directories with correct relative paths', async () => {
+        const fixturesDir = join(import.meta.dirname, '../../fixtures/golden/actual-content/input');
+        const files = await readVaultFiles(fixturesDir);
+        // Should have files in nested paths like "modules/intro.md", "Lenses/..."
+        const paths = Array.from(files.keys());
+        expect(paths.some(p => p.includes('/'))).toBe(true);
+        // Paths should NOT start with leading slash
+        expect(paths.every(p => !p.startsWith('/'))).toBe(true);
+    });
+    it('returns empty map for directory with no .md files', async () => {
+        const tempDir = mkdtempSync(join(tmpdir(), 'empty-vault-'));
+        try {
+            const files = await readVaultFiles(tempDir);
+            expect(files.size).toBe(0);
+        }
+        finally {
+            rmSync(tempDir, { recursive: true });
+        }
+    });
+    it('throws descriptive error for non-existent directory', async () => {
+        await expect(readVaultFiles('/nonexistent/path')).rejects.toThrow(/ENOENT|no such file/i);
+    });
+});
+//# sourceMappingURL=read-vault.test.js.map

package/dist/fs/read-vault.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-vault.test.js","sourceRoot":"","sources":["../../src/fs/read-vault.test.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAC5B,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC;AAE5B,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;QAC1D,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,2CAA2C,CAAC,CAAC;QAE3F,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,WAAW,CAAC,CAAC;QAEhD,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjD,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iEAAiE,EAAE,KAAK,IAAI,EAAE;QAC/E,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,4CAA4C,CAAC,CAAC;QAE5F,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,WAAW,CAAC,CAAC;QAEhD,0EAA0E;QAC1E,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QACvC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEpD,4CAA4C;QAC5C,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,KAAK,IAAI,EAAE;QACjE,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,cAAc,CAAC,CAAC,CAAC;QAC5D,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,CAAC;YAC5C,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC7B,CAAC;gBAAS,CAAC;YACT,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACvC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,KAAK,IAAI,EAAE;QACnE,MAAM,MAAM,CAAC,cAAc,CAAC,mBAAmB,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAC5F,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,75 @@
+export interface ProcessResult {
+    modules: FlattenedModule[];
+    courses: Course[];
+    errors: ContentError[];
+}
+export interface FlattenedModule {
+    slug: string;
+    title: string;
+    contentId: string | null;
+    sections: Section[];
+    error?: string;
+    warnings?: string[];
+}
+export interface Course {
+    slug: string;
+    title: string;
+    progression: ProgressionItem[];
+    error?: string;
+}
+export interface Section {
+    type: 'page' | 'lens-video' | 'lens-article';
+    meta: SectionMeta;
+    segments: Segment[];
+    optional?: boolean;
+    contentId: string | null;
+    learningOutcomeId: string | null;
+    videoId: string | null;
+}
+export interface SectionMeta {
+    title?: string;
+    author?: string;
+    sourceUrl?: string;
+    channel?: string;
+}
+export interface ProgressionItem {
+    type: 'module' | 'meeting';
+    slug?: string;
+    number?: number;
+    optional?: boolean;
+}
+export interface ContentError {
+    file: string;
+    line?: number;
+    message: string;
+    suggestion?: string;
+    severity: 'error' | 'warning';
+}
+export interface TextSegment {
+    type: 'text';
+    content: string;
+    optional?: boolean;
+}
+export interface ChatSegment {
+    type: 'chat';
+    instructions?: string;
+    hidePreviousContentFromUser?: boolean;
+    hidePreviousContentFromTutor?: boolean;
+    optional?: boolean;
+}
+export interface ArticleExcerptSegment {
+    type: 'article-excerpt';
+    content: string;
+    collapsed_before?: string;
+    collapsed_after?: string;
+    optional?: boolean;
+}
+export interface VideoExcerptSegment {
+    type: 'video-excerpt';
+    from: number;
+    to: number | null;
+    transcript: string;
+    optional?: boolean;
+}
+export type Segment = TextSegment | ChatSegment | ArticleExcerptSegment | VideoExcerptSegment;
+export declare function processContent(files: Map<string, string>): ProcessResult;

package/dist/index.js

@@ -0,0 +1,137 @@
+import { flattenModule } from './flattener/index.js';
+import { parseCourse } from './parser/course.js';
+import { parseLearningOutcome } from './parser/learning-outcome.js';
+import { parseLens } from './parser/lens.js';
+import { parseWikilink, resolveWikilinkPath, findFileWithExtension } from './parser/wikilink.js';
+import { validateUuids } from './validator/uuid.js';
+import { extractArticleExcerpt } from './bundler/article.js';
+import { extractVideoExcerpt } from './bundler/video.js';
+/**
+ * Validate lens excerpts by checking if source files exist and anchors/timestamps are valid.
+ */
+function validateLensExcerpts(lens, lensPath, files) {
+    const errors = [];
+    for (const section of lens.sections) {
+        // Skip sections without source (e.g., Text sections)
+        if (!section.source)
+            continue;
+        // Resolve the source wikilink to get the actual file path
+        const wikilink = parseWikilink(section.source);
+        if (!wikilink)
+            continue;
+        const resolvedPath = resolveWikilinkPath(wikilink.path, lensPath);
+        const actualPath = findFileWithExtension(resolvedPath, files);
+        if (!actualPath) {
+            errors.push({
+                file: lensPath,
+                line: section.line,
+                message: `Source file not found: ${resolvedPath}`,
+                suggestion: 'Check that the file exists and the path is correct',
+                severity: 'error',
+            });
+            continue;
+        }
+        const sourceContent = files.get(actualPath);
+        // Validate article excerpts
+        if (section.type === 'article' || section.type === 'lens-article') {
+            for (const segment of section.segments) {
+                if (segment.type === 'article-excerpt') {
+                    const result = extractArticleExcerpt(sourceContent, segment.fromAnchor, segment.toAnchor, actualPath);
+                    if (result.error) {
+                        errors.push({ ...result.error, file: lensPath });
+                    }
+                }
+            }
+        }
+        // Validate video excerpts
+        if (section.type === 'video' || section.type === 'lens-video') {
+            // Look for corresponding .timestamps.json file
+            const timestampsPath = actualPath.replace(/\.md$/, '.timestamps.json');
+            let timestamps;
+            if (files.has(timestampsPath)) {
+                try {
+                    timestamps = JSON.parse(files.get(timestampsPath));
+                }
+                catch {
+                    // JSON parse error - will fall back to inline timestamps
+                }
+            }
+            for (const segment of section.segments) {
+                if (segment.type === 'video-excerpt') {
+                    const result = extractVideoExcerpt(sourceContent, segment.fromTimeStr, segment.toTimeStr, actualPath, timestamps);
+                    if (result.error) {
+                        errors.push({ ...result.error, file: lensPath });
+                    }
+                }
+            }
+        }
+    }
+    return errors;
+}
+export function processContent(files) {
+    const modules = [];
+    const courses = [];
+    const errors = [];
+    const uuidEntries = [];
+    // Identify file types by path
+    for (const [path, content] of files.entries()) {
+        if (path.startsWith('modules/')) {
+            const result = flattenModule(path, files);
+            if (result.module) {
+                modules.push(result.module);
+                // Collect module contentId for UUID validation
+                if (result.module.contentId) {
+                    uuidEntries.push({
+                        uuid: result.module.contentId,
+                        file: path,
+                        field: 'contentId',
+                    });
+                }
+            }
+            errors.push(...result.errors);
+        }
+        else if (path.startsWith('courses/')) {
+            const result = parseCourse(content, path);
+            if (result.course) {
+                courses.push(result.course);
+            }
+            errors.push(...result.errors);
+        }
+        else if (path.startsWith('Learning Outcomes/') || path.includes('/Learning Outcomes/')) {
+            // Fully validate Learning Outcome (structure, fields, wikilink syntax)
+            const result = parseLearningOutcome(content, path);
+            errors.push(...result.errors);
+            // Collect id for UUID validation
+            if (result.learningOutcome?.id) {
+                uuidEntries.push({
+                    uuid: result.learningOutcome.id,
+                    file: path,
+                    field: 'id',
+                });
+            }
+        }
+        else if (path.startsWith('Lenses/') || path.includes('/Lenses/')) {
+            // Fully validate Lens (structure, segments, fields)
+            const result = parseLens(content, path);
+            errors.push(...result.errors);
+            // Validate excerpts (source files exist, anchors/timestamps valid)
+            if (result.lens) {
+                const excerptErrors = validateLensExcerpts(result.lens, path, files);
+                errors.push(...excerptErrors);
+            }
+            // Collect id for UUID validation
+            if (result.lens?.id) {
+                uuidEntries.push({
+                    uuid: result.lens.id,
+                    file: path,
+                    field: 'id',
+                });
+            }
+        }
+    }
+    // Validate all collected UUIDs
+    const uuidValidation = validateUuids(uuidEntries);
+    errors.push(...uuidValidation.errors);
+    return { modules, courses, errors };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/parser/course.d.ts

@@ -0,0 +1,17 @@
+import type { ContentError, Course } from '../index.js';
+export declare const COURSE_SECTION_TYPES: Set<string>;
+export interface CourseParseResult {
+    course: Course | null;
+    errors: ContentError[];
+}
+/**
+ * Parses a course file and extracts its structure.
+ *
+ * Course files use H1 sections:
+ * - `# Module: [[../modules/name.md|Display]]` - references a module
+ * - `# Meeting: 1` - marks a meeting point
+ *
+ * The module slug is extracted from the filename in the wikilink path.
+ * Reference validation (checking if modules exist) happens in processContent.
+ */
+export declare function parseCourse(content: string, file: string): CourseParseResult;

package/dist/parser/course.js

@@ -0,0 +1,145 @@
+import { parseFrontmatter } from './frontmatter.js';
+import { parseSections } from './sections.js';
+import { parseWikilink } from './wikilink.js';
+import { basename } from 'path';
+// Valid section types for course files
+export const COURSE_SECTION_TYPES = new Set(['module', 'meeting']);
+/**
+ * Extracts the slug from a module path (filename without extension)
+ * e.g., '../modules/intro.md' -> 'intro'
+ */
+function extractSlugFromPath(path) {
+    const filename = basename(path);
+    return filename.replace(/\.md$/, '');
+}
+/**
+ * Parses a Module section title to extract the wikilink and module slug
+ * Title format: [[../modules/intro.md|Display Text]]
+ */
+function parseModuleSection(section, file) {
+    // The title should be a wikilink
+    const wikilink = parseWikilink(section.title);
+    if (!wikilink) {
+        return {
+            error: {
+                file,
+                line: section.line,
+                message: `Module section must have a wikilink in title, got: "${section.title}"`,
+                suggestion: 'Use format: # Module: [[../modules/module-name.md|Display Text]]',
+                severity: 'error',
+            },
+        };
+    }
+    const slug = extractSlugFromPath(wikilink.path);
+    const optional = section.fields.optional === 'true';
+    return { slug, optional };
+}
+/**
+ * Parses a Meeting section title to extract the meeting number
+ * Title format: 1, 2, 3, etc.
+ */
+function parseMeetingSection(section, file) {
+    const meetingNumber = parseInt(section.title, 10);
+    if (isNaN(meetingNumber)) {
+        return {
+            error: {
+                file,
+                line: section.line,
+                message: `Meeting section must have a number in title, got: "${section.title}"`,
+                suggestion: 'Use format: # Meeting: 1',
+                severity: 'error',
+            },
+        };
+    }
+    return { number: meetingNumber };
+}
+/**
+ * Parses a course file and extracts its structure.
+ *
+ * Course files use H1 sections:
+ * - `# Module: [[../modules/name.md|Display]]` - references a module
+ * - `# Meeting: 1` - marks a meeting point
+ *
+ * The module slug is extracted from the filename in the wikilink path.
+ * Reference validation (checking if modules exist) happens in processContent.
+ */
+export function parseCourse(content, file) {
+    const errors = [];
+    // Parse frontmatter
+    const frontmatterResult = parseFrontmatter(content, file);
+    if (frontmatterResult.error) {
+        errors.push(frontmatterResult.error);
+        return { course: null, errors };
+    }
+    const { frontmatter, body, bodyStartLine } = frontmatterResult;
+    // Validate required frontmatter fields
+    if (!frontmatter.slug) {
+        errors.push({
+            file,
+            line: 2,
+            message: 'Missing required field: slug',
+            suggestion: "Add 'slug: your-course-slug' to frontmatter",
+            severity: 'error',
+        });
+    }
+    if (!frontmatter.title) {
+        errors.push({
+            file,
+            line: 2,
+            message: 'Missing required field: title',
+            suggestion: "Add 'title: Your Course Title' to frontmatter",
+            severity: 'error',
+        });
+    }
+    if (errors.length > 0) {
+        return { course: null, errors };
+    }
+    // Parse sections (H1 headers for course files)
+    const sectionsResult = parseSections(body, 1, COURSE_SECTION_TYPES, file);
+    // Adjust line numbers to account for frontmatter
+    for (const error of sectionsResult.errors) {
+        if (error.line) {
+            error.line += bodyStartLine - 1;
+        }
+    }
+    errors.push(...sectionsResult.errors);
+    for (const section of sectionsResult.sections) {
+        section.line += bodyStartLine - 1;
+    }
+    // Build progression array from parsed sections
+    const progression = [];
+    for (const section of sectionsResult.sections) {
+        if (section.type === 'module') {
+            const result = parseModuleSection(section, file);
+            if ('error' in result) {
+                errors.push(result.error);
+            }
+            else {
+                progression.push({
+                    type: 'module',
+                    slug: result.slug,
+                    optional: result.optional,
+                });
+            }
+        }
+        else if (section.type === 'meeting') {
+            const result = parseMeetingSection(section, file);
+            if ('error' in result) {
+                errors.push(result.error);
+            }
+            else {
+                progression.push({
+                    type: 'meeting',
+                    number: result.number,
+                });
+            }
+        }
+    }
+    const course = {
+        slug: frontmatter.slug,
+        title: frontmatter.title,
+        progression,
+    };
+    return { course, errors };
+}
+//# sourceMappingURL=course.js.map

package/dist/parser/course.js.map

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

package/dist/parser/course.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/parser/course.test.js

@@ -0,0 +1,117 @@
+// src/parser/course.test.ts
+import { describe, it, expect } from 'vitest';
+import { parseCourse } from './course.js';
+describe('parseCourse', () => {
+    it('parses course with module references', () => {
+        const content = `---
+slug: intro-course
+title: Introduction to AI Safety
+---
+
+# Module: [[../modules/intro.md|Introduction]]
+
+# Module: [[../modules/advanced.md|Advanced Topics]]
+optional:: true
+
+# Meeting: 1
+
+# Module: [[../modules/conclusion.md|Conclusion]]
+`;
+        const result = parseCourse(content, 'courses/intro.md');
+        expect(result.course?.slug).toBe('intro-course');
+        expect(result.course?.title).toBe('Introduction to AI Safety');
+        expect(result.course?.progression).toHaveLength(4);
+        expect(result.course?.progression[0].type).toBe('module');
+        expect(result.course?.progression[0].slug).toBe('intro');
+        expect(result.course?.progression[0].optional).toBe(false);
+        expect(result.course?.progression[1].type).toBe('module');
+        expect(result.course?.progression[1].slug).toBe('advanced');
+        expect(result.course?.progression[1].optional).toBe(true);
+        expect(result.course?.progression[2].type).toBe('meeting');
+        expect(result.course?.progression[2].number).toBe(1);
+        expect(result.course?.progression[3].type).toBe('module');
+        expect(result.course?.progression[3].slug).toBe('conclusion');
+        expect(result.errors).toHaveLength(0);
+    });
+    it('validates module references exist', () => {
+        const content = `---
+slug: broken-course
+title: Broken Course
+---
+
+# Module: [[../modules/nonexistent.md|Missing]]
+`;
+        // Note: Reference validation happens in processContent, not parseCourse
+        // parseCourse only parses the structure, it does not validate file existence
+        const result = parseCourse(content, 'courses/broken.md');
+        expect(result.course).toBeDefined();
+        expect(result.course?.slug).toBe('broken-course');
+        expect(result.course?.progression).toHaveLength(1);
+        expect(result.course?.progression[0].type).toBe('module');
+        expect(result.course?.progression[0].slug).toBe('nonexistent');
+        // Errors about missing modules are added during processContent, not parseCourse
+    });
+    it('handles missing frontmatter', () => {
+        const content = `# Module: [[../modules/intro.md|Introduction]]`;
+        const result = parseCourse(content, 'courses/bad.md');
+        expect(result.course).toBeNull();
+        expect(result.errors.length).toBeGreaterThan(0);
+        expect(result.errors[0].message).toContain('frontmatter');
+    });
+    it('requires slug in frontmatter', () => {
+        const content = `---
+title: Course Without Slug
+---
+
+# Module: [[../modules/intro.md|Introduction]]
+`;
+        const result = parseCourse(content, 'courses/no-slug.md');
+        expect(result.course).toBeNull();
+        expect(result.errors.some(e => e.message.includes('slug'))).toBe(true);
+    });
+    it('requires title in frontmatter', () => {
+        const content = `---
+slug: no-title-course
+---
+
+# Module: [[../modules/intro.md|Introduction]]
+`;
+        const result = parseCourse(content, 'courses/no-title.md');
+        expect(result.course).toBeNull();
+        expect(result.errors.some(e => e.message.includes('title'))).toBe(true);
+    });
+    it('reports error for unknown section types', () => {
+        const content = `---
+slug: test-course
+title: Test Course
+---
+
+# Unknown: Bad Section
+`;
+        const result = parseCourse(content, 'courses/unknown.md');
+        expect(result.errors.some(e => e.message.includes('Unknown section type'))).toBe(true);
+    });
+    it('reports error for Module section without wikilink', () => {
+        const content = `---
+slug: test-course
+title: Test Course
+---
+
+# Module: No Wikilink Here
+`;
+        const result = parseCourse(content, 'courses/no-link.md');
+        expect(result.errors.some(e => e.message.includes('wikilink'))).toBe(true);
+    });
+    it('reports error for Meeting section without number', () => {
+        const content = `---
+slug: test-course
+title: Test Course
+---
+
+# Meeting: not a number
+`;
+        const result = parseCourse(content, 'courses/bad-meeting.md');
+        expect(result.errors.some(e => e.message.includes('number'))).toBe(true);
+    });
+});
+//# sourceMappingURL=course.test.js.map

package/dist/parser/course.test.js.map

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

package/dist/parser/frontmatter.d.ts

@@ -0,0 +1,8 @@
+import type { ContentError } from '../index.js';
+export interface FrontmatterResult {
+    frontmatter: Record<string, unknown>;
+    body: string;
+    bodyStartLine: number;
+    error?: ContentError;
+}
+export declare function parseFrontmatter(content: string, file?: string): FrontmatterResult;

package/dist/parser/frontmatter.js

@@ -0,0 +1,58 @@
+// src/parser/frontmatter.ts
+import { parse as parseYaml } from 'yaml';
+// Matches: ---\n<yaml>\n---\n<body>
+const FRONTMATTER_PATTERN = /^---\n([\s\S]*?)\n---\n?([\s\S]*)$/;
+export function parseFrontmatter(content, file = '') {
+    const match = content.match(FRONTMATTER_PATTERN);
+    if (!match) {
+        // Check if it starts with --- but doesn't close
+        if (content.startsWith('---\n') && !content.includes('\n---\n')) {
+            return {
+                frontmatter: {},
+                body: content,
+                bodyStartLine: 1,
+                error: {
+                    file,
+                    line: 1,
+                    message: 'Unclosed frontmatter - missing closing ---',
+                    suggestion: 'Add --- on its own line after frontmatter fields',
+                    severity: 'error',
+                },
+            };
+        }
+        return {
+            frontmatter: {},
+            body: content,
+            bodyStartLine: 1,
+            error: {
+                file,
+                line: 1,
+                message: 'Missing frontmatter',
+                suggestion: "Add YAML frontmatter with 'slug' and 'title' fields",
+                severity: 'error',
+            },
+        };
+    }
+    const yamlContent = match[1];
+    const body = match[2];
+    const bodyStartLine = yamlContent.split('\n').length + 3; // 1 for opening ---, N for yaml, 1 for closing ---
+    try {
+        const frontmatter = parseYaml(yamlContent) ?? {};
+        return { frontmatter, body, bodyStartLine };
+    }
+    catch (e) {
+        return {
+            frontmatter: {},
+            body,
+            bodyStartLine,
+            error: {
+                file,
+                line: 2,
+                message: `Invalid YAML: ${e instanceof Error ? e.message : String(e)}`,
+                suggestion: 'Check YAML syntax - colons, indentation, quoting',
+                severity: 'error',
+            },
+        };
+    }
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/parser/frontmatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../../src/parser/frontmatter.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAC5B,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAU1C,oCAAoC;AACpC,MAAM,mBAAmB,GAAG,oCAAoC,CAAC;AAEjE,MAAM,UAAU,gBAAgB,CAAC,OAAe,EAAE,OAAe,EAAE;IACjE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;IAEjD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,gDAAgD;QAChD,IAAI,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YAChE,OAAO;gBACL,WAAW,EAAE,EAAE;gBACf,IAAI,EAAE,OAAO;gBACb,aAAa,EAAE,CAAC;gBAChB,KAAK,EAAE;oBACL,IAAI;oBACJ,IAAI,EAAE,CAAC;oBACP,OAAO,EAAE,4CAA4C;oBACrD,UAAU,EAAE,kDAAkD;oBAC9D,QAAQ,EAAE,OAAO;iBAClB;aACF,CAAC;QACJ,CAAC;QACD,OAAO;YACL,WAAW,EAAE,EAAE;YACf,IAAI,EAAE,OAAO;YACb,aAAa,EAAE,CAAC;YAChB,KAAK,EAAE;gBACL,IAAI;gBACJ,IAAI,EAAE,CAAC;gBACP,OAAO,EAAE,qBAAqB;gBAC9B,UAAU,EAAE,qDAAqD;gBACjE,QAAQ,EAAE,OAAO;aAClB;SACF,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAC7B,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACtB,MAAM,aAAa,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,mDAAmD;IAE7G,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,SAAS,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;QACjD,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;IAC9C,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO;YACL,WAAW,EAAE,EAAE;YACf,IAAI;YACJ,aAAa;YACb,KAAK,EAAE;gBACL,IAAI;gBACJ,IAAI,EAAE,CAAC;gBACP,OAAO,EAAE,iBAAiB,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;gBACtE,UAAU,EAAE,kDAAkD;gBAC9D,QAAQ,EAAE,OAAO;aAClB;SACF,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/parser/frontmatter.test.d.ts

@@ -0,0 +1 @@
+export {};