lens-content-processor 0.1.0

package/dist/bundler/video.js

@@ -0,0 +1,213 @@
+/**
+ * Parse a timestamp string into seconds.
+ *
+ * Supports formats:
+ * - MM:SS (e.g., "1:30" -> 90)
+ * - H:MM:SS (e.g., "1:30:00" -> 5400)
+ * - M:SS.ms (e.g., "0:00.40" -> 0.4) - used in .timestamps.json files
+ *
+ * @param str - Timestamp string
+ * @returns Number of seconds, or null if invalid format
+ */
+export function parseTimestamp(str) {
+    // Handle M:SS.ms format (timestamps.json format)
+    const msMatch = str.match(/^(\d+):(\d+(?:\.\d+)?)$/);
+    if (msMatch) {
+        const minutes = parseInt(msMatch[1], 10);
+        const seconds = parseFloat(msMatch[2]);
+        return minutes * 60 + seconds;
+    }
+    // Match M:SS, MM:SS, H:MM:SS, HH:MM:SS patterns
+    const parts = str.split(':');
+    if (parts.length < 2 || parts.length > 3) {
+        return null;
+    }
+    // Validate all parts are numeric
+    for (const part of parts) {
+        if (!/^\d+$/.test(part)) {
+            return null;
+        }
+    }
+    if (parts.length === 2) {
+        // MM:SS format
+        const minutes = parseInt(parts[0], 10);
+        const seconds = parseInt(parts[1], 10);
+        return minutes * 60 + seconds;
+    }
+    else {
+        // H:MM:SS format
+        const hours = parseInt(parts[0], 10);
+        const minutes = parseInt(parts[1], 10);
+        const seconds = parseInt(parts[2], 10);
+        return hours * 3600 + minutes * 60 + seconds;
+    }
+}
+/**
+ * Parse a transcript line to extract its timestamp.
+ * Expected format: "M:SS - text" or "H:MM:SS - text"
+ *
+ * @param line - A line from the transcript
+ * @returns The timestamp in seconds, or null if no timestamp found
+ */
+function parseTranscriptLineTimestamp(line) {
+    // Match timestamp at start of line: "0:00 - ", "1:30 - ", "1:30:00 - "
+    const match = line.match(/^(\d+:\d{2}(?::\d{2})?)\s*-/);
+    if (!match) {
+        return null;
+    }
+    return parseTimestamp(match[1]);
+}
+/**
+ * Extract words from timestamps data that fall within the requested time range.
+ *
+ * @param timestamps - Array of word-level timestamp entries
+ * @param fromSeconds - Start time in seconds
+ * @param toSeconds - End time in seconds
+ * @returns Words joined with spaces
+ */
+export function extractFromTimestamps(timestamps, fromSeconds, toSeconds) {
+    const wordsInRange = [];
+    for (const entry of timestamps) {
+        const entryTime = parseTimestamp(entry.start);
+        if (entryTime === null)
+            continue;
+        // Include word if its start time falls within the range
+        if (entryTime >= fromSeconds && entryTime <= toSeconds) {
+            wordsInRange.push(entry.text);
+        }
+    }
+    return wordsInRange.join(' ');
+}
+/**
+ * Extract transcript content between two timestamps.
+ *
+ * If timestamps data (from .timestamps.json) is provided, uses word-level
+ * extraction. Otherwise, falls back to inline timestamp markers in the
+ * transcript markdown.
+ *
+ * @param transcript - The full transcript content (markdown)
+ * @param fromTime - Start timestamp string (e.g., "1:30")
+ * @param toTime - End timestamp string (e.g., "5:45")
+ * @param file - Source file path for error reporting
+ * @param timestamps - Optional word-level timestamps from .timestamps.json
+ * @returns Extracted transcript with from/to as seconds, or error
+ */
+export function extractVideoExcerpt(transcript, fromTime, toTime, file, timestamps) {
+    // Parse the requested timestamps
+    const fromSeconds = parseTimestamp(fromTime);
+    if (fromSeconds === null) {
+        return {
+            error: {
+                file,
+                message: `Invalid start timestamp format: '${fromTime}'`,
+                suggestion: 'Use MM:SS (e.g., 1:30) or H:MM:SS (e.g., 1:30:00) format',
+                severity: 'error',
+            },
+        };
+    }
+    const toSeconds = parseTimestamp(toTime);
+    if (toSeconds === null) {
+        return {
+            error: {
+                file,
+                message: `Invalid end timestamp format: '${toTime}'`,
+                suggestion: 'Use MM:SS (e.g., 1:30) or H:MM:SS (e.g., 1:30:00) format',
+                severity: 'error',
+            },
+        };
+    }
+    // Validate that from is not after to
+    if (fromSeconds > toSeconds) {
+        return {
+            error: {
+                file,
+                message: `Start timestamp '${fromTime}' is after end timestamp '${toTime}'`,
+                suggestion: 'Ensure the from:: timestamp comes before the to:: timestamp',
+                severity: 'error',
+            },
+        };
+    }
+    // If timestamps data is provided, use word-level extraction
+    if (timestamps && timestamps.length > 0) {
+        const extractedText = extractFromTimestamps(timestamps, fromSeconds, toSeconds);
+        return {
+            from: fromSeconds,
+            to: toSeconds,
+            transcript: extractedText,
+        };
+    }
+    // Fall back to inline timestamp markers in the markdown
+    // Parse the transcript into lines with timestamps
+    const lines = transcript.split('\n');
+    const timestampedLines = [];
+    for (const line of lines) {
+        const ts = parseTranscriptLineTimestamp(line);
+        if (ts !== null) {
+            timestampedLines.push({ timestamp: ts, line });
+        }
+    }
+    // Find lines that fall within the requested range
+    // Handle plain prose transcripts (no timestamps at all)
+    if (timestampedLines.length === 0) {
+        // If starting from 0:00, include entire transcript
+        if (fromSeconds === 0) {
+            return {
+                from: fromSeconds,
+                to: toSeconds,
+                transcript: transcript.trim(),
+            };
+        }
+        // Can't extract from a non-zero timestamp in a plain prose transcript
+        return {
+            error: {
+                file,
+                message: `Start timestamp '${fromTime}' not found in transcript (transcript has no timestamp markers)`,
+                suggestion: 'This transcript has no timestamp markers. Use from:: 0:00 to include from the start, or add timestamps to the transcript.',
+                severity: 'error',
+            },
+        };
+    }
+    // A line is included if its timestamp >= fromSeconds and < toSeconds
+    // Special case: fromSeconds === 0 means "start of video" - no need to find exact 0:00 marker
+    let foundFrom = fromSeconds === 0;
+    let foundTo = false;
+    const excerptLines = [];
+    for (const { timestamp, line } of timestampedLines) {
+        if (timestamp === fromSeconds) {
+            foundFrom = true;
+        }
+        if (timestamp === toSeconds) {
+            foundTo = true;
+        }
+        // Include lines from fromSeconds up to (but not including) toSeconds
+        if (timestamp >= fromSeconds && timestamp < toSeconds) {
+            excerptLines.push(line);
+        }
+    }
+    if (!foundFrom) {
+        return {
+            error: {
+                file,
+                message: `Start timestamp '${fromTime}' not found in transcript`,
+                suggestion: 'Check that the timestamp exists as a line marker in the transcript',
+                severity: 'error',
+            },
+        };
+    }
+    if (!foundTo) {
+        return {
+            error: {
+                file,
+                message: `End timestamp '${toTime}' not found in transcript`,
+                suggestion: 'Check that the timestamp exists as a line marker in the transcript',
+                severity: 'error',
+            },
+        };
+    }
+    return {
+        from: fromSeconds,
+        to: toSeconds,
+        transcript: excerptLines.join('\n'),
+    };
+}
+//# sourceMappingURL=video.js.map

package/dist/bundler/video.js.map

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

package/dist/bundler/video.test.d.ts

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

package/dist/bundler/video.test.js

@@ -0,0 +1,95 @@
+// src/bundler/video.test.ts
+import { describe, it, expect } from 'vitest';
+import { parseTimestamp, extractVideoExcerpt } from './video.js';
+describe('parseTimestamp', () => {
+    it('converts MM:SS to seconds', () => {
+        expect(parseTimestamp('1:30')).toBe(90);
+        expect(parseTimestamp('5:45')).toBe(345);
+        expect(parseTimestamp('0:00')).toBe(0);
+    });
+    it('converts H:MM:SS to seconds', () => {
+        expect(parseTimestamp('1:30:00')).toBe(5400);
+        expect(parseTimestamp('2:15:30')).toBe(8130);
+    });
+    it('returns null for invalid format', () => {
+        expect(parseTimestamp('invalid')).toBeNull();
+        expect(parseTimestamp('abc:def')).toBeNull();
+    });
+});
+describe('extractVideoExcerpt', () => {
+    it('extracts transcript between timestamps and returns seconds', () => {
+        const transcript = `0:00 - Welcome to this video.
+0:30 - Today we'll discuss AI safety.
+1:30 - The first key point is alignment.
+2:00 - This means ensuring AI does what we want.
+5:45 - Moving on to the next topic.
+6:00 - Let's talk about interpretability.
+`;
+        const result = extractVideoExcerpt(transcript, '1:30', // 90 seconds
+        '5:45', // 345 seconds
+        'video_transcripts/test.md');
+        expect(result.from).toBe(90); // Seconds as number
+        expect(result.to).toBe(345); // Seconds as number
+        expect(result.transcript).toContain('alignment');
+        expect(result.transcript).toContain('what we want');
+        expect(result.transcript).not.toContain('Welcome');
+        expect(result.transcript).not.toContain('interpretability');
+    });
+    it('returns error for invalid timestamp format', () => {
+        const transcript = '0:00 - Content here.';
+        const result = extractVideoExcerpt(transcript, 'invalid', '1:00', 'video_transcripts/test.md');
+        expect(result.error).toBeDefined();
+        expect(result.error?.message).toContain('timestamp');
+        expect(result.error?.suggestion).toContain('MM:SS');
+    });
+    it('returns error when timestamp not found in transcript', () => {
+        const transcript = '0:00 - Short video.\n0:30 - End.';
+        const result = extractVideoExcerpt(transcript, '5:00', '10:00', 'video_transcripts/test.md');
+        expect(result.error).toBeDefined();
+        expect(result.error?.message).toContain('not found');
+    });
+    it('returns error when from timestamp is after to timestamp', () => {
+        const transcript = `0:00 - Start.
+3:00 - Middle.
+5:00 - End.`;
+        const result = extractVideoExcerpt(transcript, '5:00', '3:00', 'video.md');
+        expect(result.error).toBeDefined();
+        expect(result.error?.message).toContain('after');
+    });
+    describe('from 0:00 (start of video)', () => {
+        it('treats 0:00 as start of video even when no 0:00 marker exists', () => {
+            // Transcript starts at 0:30, not 0:00
+            const transcript = `0:30 - First line of dialogue.
+1:00 - Second line continues.
+1:30 - Third line wraps up.
+2:00 - End of section.`;
+            const result = extractVideoExcerpt(transcript, '0:00', '1:30', 'video.md');
+            // Should NOT error - 0:00 means "from the start"
+            expect(result.error).toBeUndefined();
+            expect(result.from).toBe(0);
+            expect(result.to).toBe(90);
+            // Should include lines from start up to (but not including) 1:30
+            expect(result.transcript).toContain('First line');
+            expect(result.transcript).toContain('Second line');
+            expect(result.transcript).not.toContain('Third line');
+        });
+        it('handles plain prose transcript with no timestamps at all', () => {
+            // This is common for transcripts that are just paragraphs of text
+            const transcript = `This is the first paragraph of the transcript. It contains some interesting content about AI safety.
+
+This is the second paragraph. It continues discussing the topic.
+
+This is the third paragraph. It concludes the main points.`;
+            const result = extractVideoExcerpt(transcript, '0:00', '5:00', 'video.md');
+            // Should NOT error - include entire content since no timestamps exist
+            expect(result.error).toBeUndefined();
+            expect(result.from).toBe(0);
+            expect(result.to).toBe(300);
+            // Should include entire transcript
+            expect(result.transcript).toContain('first paragraph');
+            expect(result.transcript).toContain('second paragraph');
+            expect(result.transcript).toContain('third paragraph');
+        });
+    });
+});
+//# sourceMappingURL=video.test.js.map

package/dist/bundler/video.test.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+import { ProcessResult } from './index.js';
+export interface CliOptions {
+    vaultPath: string | null;
+    outputPath: string | null;
+    includeWip: boolean;
+    stdin: boolean;
+}
+export declare function parseArgs(argv: string[]): CliOptions;
+export declare function run(options: CliOptions): Promise<ProcessResult>;

package/dist/cli.js

@@ -0,0 +1,80 @@
+#!/usr/bin/env node
+// src/cli.ts
+import { readVaultFiles } from './fs/read-vault.js';
+import { processContent } from './index.js';
+import { writeFile } from 'fs/promises';
+export function parseArgs(argv) {
+    const args = argv.slice(2);
+    let vaultPath = null;
+    let outputPath = null;
+    let includeWip = false;
+    let stdin = false; // NEW
+    for (let i = 0; i < args.length; i++) {
+        if (args[i] === '--output' || args[i] === '-o') {
+            outputPath = args[i + 1] || null;
+            i++; // skip next arg
+        }
+        else if (args[i] === '--include-wip') {
+            includeWip = true;
+        }
+        else if (args[i] === '--stdin') { // NEW
+            stdin = true;
+        }
+        else if (!args[i].startsWith('-')) {
+            vaultPath = args[i];
+        }
+    }
+    return { vaultPath, outputPath, includeWip, stdin };
+}
+async function readStdin() {
+    const chunks = [];
+    for await (const chunk of process.stdin) {
+        chunks.push(chunk);
+    }
+    return Buffer.concat(chunks).toString('utf-8');
+}
+export async function run(options) {
+    let files;
+    if (options.stdin) {
+        // Read JSON from stdin: { "path": "content", ... }
+        const input = await readStdin();
+        const parsed = JSON.parse(input);
+        files = new Map(Object.entries(parsed));
+    }
+    else {
+        if (!options.vaultPath) {
+            throw new Error('Vault path is required (or use --stdin)');
+        }
+        files = await readVaultFiles(options.vaultPath, { includeWip: options.includeWip });
+    }
+    return processContent(files);
+}
+async function main() {
+    const options = parseArgs(process.argv);
+    if (!options.vaultPath && !options.stdin) {
+        console.error('Usage: npx tsx src/cli.ts <vault-path> [--output <file>] [--include-wip]');
+        console.error('       npx tsx src/cli.ts --stdin [--output <file>]');
+        process.exit(1);
+    }
+    try {
+        const result = await run(options);
+        const json = JSON.stringify(result, null, 2);
+        if (options.outputPath) {
+            await writeFile(options.outputPath, json, 'utf-8');
+            console.error(`Written to ${options.outputPath}`);
+        }
+        else {
+            console.log(json);
+        }
+    }
+    catch (error) {
+        console.error('Error:', error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+}
+// Run if executed directly (not imported as a module)
+const isMainModule = process.argv[1]?.includes('cli.ts') || process.argv[1]?.includes('cli.js');
+if (isMainModule) {
+    main();
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/cli.test.d.ts

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

package/dist/cli.test.js

@@ -0,0 +1,45 @@
+// src/cli.test.ts
+import { describe, it, expect } from 'vitest';
+import { spawn } from 'child_process';
+import { readFile } from 'fs/promises';
+import { join } from 'path';
+describe('CLI --stdin flag', () => {
+    it('produces same output as file-based input', async () => {
+        const fixturePath = join(__dirname, '../fixtures/valid/minimal-module/input');
+        const expectedPath = join(__dirname, '../fixtures/valid/minimal-module/expected.json');
+        // Read fixture files into a Map-like object
+        const { readVaultFiles } = await import('./fs/read-vault.js');
+        const files = await readVaultFiles(fixturePath);
+        const filesObject = {};
+        for (const [path, content] of files.entries()) {
+            filesObject[path] = content;
+        }
+        // Run CLI with --stdin
+        const result = await new Promise((resolve, reject) => {
+            const child = spawn('npx', ['tsx', 'src/cli.ts', '--stdin'], {
+                cwd: join(__dirname, '..'),
+                stdio: ['pipe', 'pipe', 'pipe'],
+            });
+            let stdout = '';
+            let stderr = '';
+            child.stdout.on('data', (data) => { stdout += data; });
+            child.stderr.on('data', (data) => { stderr += data; });
+            child.on('close', (code) => {
+                if (code !== 0) {
+                    reject(new Error(`CLI exited with code ${code}: ${stderr}`));
+                }
+                else {
+                    resolve(stdout);
+                }
+            });
+            // Write JSON to stdin
+            child.stdin.write(JSON.stringify(filesObject));
+            child.stdin.end();
+        });
+        // Parse and compare (ignore whitespace differences)
+        const actual = JSON.parse(result);
+        const expected = JSON.parse(await readFile(expectedPath, 'utf-8'));
+        expect(actual).toEqual(expected);
+    }, 60000); // 60s timeout for subprocess (first run compiles)
+});
+//# sourceMappingURL=cli.test.js.map

package/dist/cli.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.test.js","sourceRoot":"","sources":["../src/cli.test.ts"],"names":[],"mappings":"AAAA,kBAAkB;AAClB,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;QACxD,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,EAAE,wCAAwC,CAAC,CAAC;QAC9E,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,EAAE,gDAAgD,CAAC,CAAC;QAEvF,4CAA4C;QAC5C,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;QAC9D,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,WAAW,CAAC,CAAC;QAChD,MAAM,WAAW,GAA2B,EAAE,CAAC;QAC/C,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;YAC9C,WAAW,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC;QAC9B,CAAC;QAED,uBAAuB;QACvB,MAAM,MAAM,GAAG,MAAM,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC3D,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,YAAY,EAAE,SAAS,CAAC,EAAE;gBAC3D,GAAG,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC;gBAC1B,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;aAChC,CAAC,CAAC;YAEH,IAAI,MAAM,GAAG,EAAE,CAAC;YAChB,IAAI,MAAM,GAAG,EAAE,CAAC;YAEhB,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,GAAG,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YACvD,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,GAAG,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YAEvD,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;gBACzB,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;oBACf,MAAM,CAAC,IAAI,KAAK,CAAC,wBAAwB,IAAI,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC;gBAC/D,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,MAAM,CAAC,CAAC;gBAClB,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,sBAAsB;YACtB,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC;YAC/C,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QACpB,CAAC,CAAC,CAAC;QAEH,oDAAoD;QACpD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;QAEnE,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,kDAAkD;AAC/D,CAAC,CAAC,CAAC"}

package/dist/flattener/index.d.ts

@@ -0,0 +1,20 @@
+import type { FlattenedModule, ContentError } from '../index.js';
+export interface FlattenModuleResult {
+    module: FlattenedModule | null;
+    errors: ContentError[];
+}
+/**
+ * Flatten a module by resolving all references to Learning Outcomes, Lenses, and content.
+ *
+ * This function:
+ * 1. Parses the module file
+ * 2. For each Learning Outcome section, resolves the LO file
+ * 3. For each Lens in the LO, resolves the lens file
+ * 4. For each segment, extracts content from articles/videos as needed
+ *
+ * @param modulePath - Path to the module file within the files Map
+ * @param files - Map of all file paths to their content
+ * @param visitedPaths - Optional set of already-visited paths for cycle detection
+ * @returns Flattened module with resolved sections and segments, plus any errors
+ */
+export declare function flattenModule(modulePath: string, files: Map<string, string>, visitedPaths?: Set<string>): FlattenModuleResult;