lens-content-processor 0.1.0

package/dist/bundler/article.d.ts

@@ -0,0 +1,41 @@
+import type { ContentError } from '../index.js';
+export interface ArticleExcerptResult {
+    content?: string;
+    startIndex?: number;
+    endIndex?: number;
+    error?: ContentError;
+}
+export interface CollapsedExcerpt {
+    content: string;
+    collapsed_before?: string;
+    collapsed_after?: string;
+    error?: ContentError;
+}
+export interface ExcerptInput {
+    from: string;
+    to: string;
+}
+/**
+ * Extract content from an article between two anchor texts.
+ *
+ * Both anchors are optional:
+ * - Only fromAnchor → extract from anchor to end of article
+ * - Only toAnchor → extract from start of article to anchor
+ * - Neither → extract entire article (stripping frontmatter)
+ *
+ * @param article - The full article content
+ * @param fromAnchor - Text marking the start of the excerpt (inclusive), undefined means start
+ * @param toAnchor - Text marking the end of the excerpt (inclusive), undefined means end
+ * @param file - Source file path for error reporting
+ * @returns Extracted content or error
+ */
+export declare function extractArticleExcerpt(article: string, fromAnchor: string | undefined, toAnchor: string | undefined, file: string): ArticleExcerptResult;
+/**
+ * Bundle multiple excerpts from an article with collapsed content information.
+ *
+ * @param article - The full article content
+ * @param excerpts - Array of excerpt specifications { from, to }
+ * @param file - Source file path for error reporting
+ * @returns Array of excerpts with collapsed_before/collapsed_after fields
+ */
+export declare function bundleArticleWithCollapsed(article: string, excerpts: ExcerptInput[], file: string): CollapsedExcerpt[];

package/dist/bundler/article.js

@@ -0,0 +1,240 @@
+/**
+ * Find all occurrences of a substring in text (case-insensitive).
+ * Returns array of start indices.
+ */
+function findAllOccurrences(text, anchor) {
+    const lowerText = text.toLowerCase();
+    const lowerAnchor = anchor.toLowerCase();
+    const indices = [];
+    let pos = 0;
+    while (true) {
+        const idx = lowerText.indexOf(lowerAnchor, pos);
+        if (idx === -1)
+            break;
+        indices.push(idx);
+        pos = idx + 1;
+    }
+    return indices;
+}
+/**
+ * Strip frontmatter from article content.
+ * Frontmatter is enclosed in --- markers at the start of the file.
+ */
+function stripFrontmatter(article) {
+    const match = article.match(/^---\n[\s\S]*?\n---\n([\s\S]*)$/);
+    return match ? match[1].trim() : article.trim();
+}
+/**
+ * Extract content from an article between two anchor texts.
+ *
+ * Both anchors are optional:
+ * - Only fromAnchor → extract from anchor to end of article
+ * - Only toAnchor → extract from start of article to anchor
+ * - Neither → extract entire article (stripping frontmatter)
+ *
+ * @param article - The full article content
+ * @param fromAnchor - Text marking the start of the excerpt (inclusive), undefined means start
+ * @param toAnchor - Text marking the end of the excerpt (inclusive), undefined means end
+ * @param file - Source file path for error reporting
+ * @returns Extracted content or error
+ */
+export function extractArticleExcerpt(article, fromAnchor, toAnchor, file) {
+    // If no anchors, return entire article (strip frontmatter)
+    if (!fromAnchor && !toAnchor) {
+        const content = stripFrontmatter(article);
+        return {
+            content,
+            startIndex: 0,
+            endIndex: article.length,
+        };
+    }
+    // Get article body (strip frontmatter) for extraction
+    const body = stripFrontmatter(article);
+    // If only toAnchor, extract from start to anchor
+    if (!fromAnchor && toAnchor) {
+        const toOccurrences = findAllOccurrences(body, toAnchor);
+        if (toOccurrences.length === 0) {
+            return {
+                error: {
+                    file,
+                    message: `End anchor '${toAnchor}' not found in article`,
+                    suggestion: 'Check that the anchor text exists exactly in the article',
+                    severity: 'error',
+                },
+            };
+        }
+        if (toOccurrences.length > 1) {
+            return {
+                error: {
+                    file,
+                    message: `End anchor '${toAnchor}' found multiple times (${toOccurrences.length} occurrences) - ambiguous`,
+                    suggestion: 'Use a more specific anchor text that appears only once',
+                    severity: 'error',
+                },
+            };
+        }
+        const endIndex = toOccurrences[0] + toAnchor.length;
+        const content = body.slice(0, endIndex);
+        return {
+            content,
+            startIndex: 0,
+            endIndex,
+        };
+    }
+    // If only fromAnchor, extract from anchor to end
+    if (fromAnchor && !toAnchor) {
+        const fromOccurrences = findAllOccurrences(body, fromAnchor);
+        if (fromOccurrences.length === 0) {
+            return {
+                error: {
+                    file,
+                    message: `Start anchor '${fromAnchor}' not found in article`,
+                    suggestion: 'Check that the anchor text exists exactly in the article',
+                    severity: 'error',
+                },
+            };
+        }
+        if (fromOccurrences.length > 1) {
+            return {
+                error: {
+                    file,
+                    message: `Start anchor '${fromAnchor}' found multiple times (${fromOccurrences.length} occurrences) - ambiguous`,
+                    suggestion: 'Use a more specific anchor text that appears only once',
+                    severity: 'error',
+                },
+            };
+        }
+        const startIndex = fromOccurrences[0];
+        const content = body.slice(startIndex);
+        return {
+            content,
+            startIndex,
+            endIndex: body.length,
+        };
+    }
+    // Both anchors provided - find content between them
+    // At this point we know both fromAnchor and toAnchor are defined (not undefined)
+    const fromAnchorStr = fromAnchor;
+    const toAnchorStr = toAnchor;
+    const fromOccurrences = findAllOccurrences(article, fromAnchorStr);
+    if (fromOccurrences.length === 0) {
+        return {
+            error: {
+                file,
+                message: `Start anchor '${fromAnchorStr}' not found in article`,
+                suggestion: 'Check that the anchor text exists exactly in the article',
+                severity: 'error',
+            },
+        };
+    }
+    if (fromOccurrences.length > 1) {
+        return {
+            error: {
+                file,
+                message: `Start anchor '${fromAnchorStr}' found multiple times (${fromOccurrences.length} occurrences) - ambiguous`,
+                suggestion: 'Use a more specific anchor text that appears only once',
+                severity: 'error',
+            },
+        };
+    }
+    const startIndex = fromOccurrences[0];
+    // Search for end anchor only AFTER the start anchor (case-insensitive)
+    const afterStart = article.slice(startIndex);
+    const toOccurrences = findAllOccurrences(afterStart, toAnchorStr);
+    if (toOccurrences.length === 0) {
+        return {
+            error: {
+                file,
+                message: `End anchor '${toAnchorStr}' not found in article after start anchor`,
+                suggestion: 'Check that the anchor text exists after the start anchor',
+                severity: 'error',
+            },
+        };
+    }
+    if (toOccurrences.length > 1) {
+        return {
+            error: {
+                file,
+                message: `End anchor '${toAnchorStr}' found multiple times (${toOccurrences.length} occurrences) after start - ambiguous`,
+                suggestion: 'Use a more specific anchor text that appears only once',
+                severity: 'error',
+            },
+        };
+    }
+    // Calculate absolute end index (end of the anchor text)
+    const relativeToIndex = toOccurrences[0];
+    const endIndex = startIndex + relativeToIndex + toAnchorStr.length;
+    // Extract the content between (and including) the anchors
+    const content = article.slice(startIndex, endIndex);
+    return {
+        content,
+        startIndex,
+        endIndex,
+    };
+}
+/**
+ * Bundle multiple excerpts from an article with collapsed content information.
+ *
+ * @param article - The full article content
+ * @param excerpts - Array of excerpt specifications { from, to }
+ * @param file - Source file path for error reporting
+ * @returns Array of excerpts with collapsed_before/collapsed_after fields
+ */
+export function bundleArticleWithCollapsed(article, excerpts, file) {
+    // First, extract all excerpts and their positions
+    const extractedExcerpts = [];
+    for (const excerpt of excerpts) {
+        const result = extractArticleExcerpt(article, excerpt.from, excerpt.to, file);
+        if (result.error) {
+            extractedExcerpts.push({
+                content: '',
+                startIndex: -1,
+                endIndex: -1,
+                error: result.error,
+            });
+        }
+        else {
+            extractedExcerpts.push({
+                content: result.content,
+                startIndex: result.startIndex,
+                endIndex: result.endIndex,
+            });
+        }
+    }
+    // Build the result with collapsed content
+    const results = [];
+    for (let i = 0; i < extractedExcerpts.length; i++) {
+        const extracted = extractedExcerpts[i];
+        if (extracted.error) {
+            results.push({
+                content: '',
+                error: extracted.error,
+            });
+            continue;
+        }
+        const result = {
+            content: extracted.content,
+        };
+        // Calculate collapsed_before (content between previous excerpt end and this excerpt start)
+        if (i > 0) {
+            const prevExcerpt = extractedExcerpts[i - 1];
+            if (!prevExcerpt.error && prevExcerpt.endIndex < extracted.startIndex) {
+                const collapsedBefore = article.slice(prevExcerpt.endIndex, extracted.startIndex).trim();
+                if (collapsedBefore.length > 0) {
+                    result.collapsed_before = collapsedBefore;
+                }
+            }
+        }
+        // Calculate collapsed_after (content after this excerpt to next excerpt or end)
+        // Only set for the last excerpt
+        if (i === extractedExcerpts.length - 1) {
+            const collapsedAfter = article.slice(extracted.endIndex).trim();
+            if (collapsedAfter.length > 0) {
+                result.collapsed_after = collapsedAfter;
+            }
+        }
+        results.push(result);
+    }
+    return results;
+}
+//# sourceMappingURL=article.js.map

package/dist/bundler/article.js.map

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

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

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

package/dist/bundler/article.test.js

@@ -0,0 +1,212 @@
+// src/bundler/article.test.ts
+import { describe, it, expect } from 'vitest';
+import { extractArticleExcerpt, bundleArticleWithCollapsed } from './article.js';
+describe('extractArticleExcerpt', () => {
+    it('extracts content between anchors', () => {
+        const article = `# Article Title
+
+Some intro text.
+
+The key insight is that AI alignment requires careful consideration
+of human values. This is a complex problem that involves
+understanding this concept.
+
+More content after.
+`;
+        const result = extractArticleExcerpt(article, 'The key insight is', 'understanding this concept.', 'articles/test.md');
+        expect(result.content).toContain('AI alignment');
+        expect(result.content).toContain('human values');
+        expect(result.error).toBeUndefined();
+    });
+    it('returns error for missing start anchor', () => {
+        const article = 'Some content without the anchor.';
+        const result = extractArticleExcerpt(article, 'nonexistent anchor', 'also missing', 'articles/test.md');
+        expect(result.error).toBeDefined();
+        expect(result.error?.message).toContain('not found');
+        expect(result.error?.suggestion).toContain('anchor');
+    });
+    it('returns error for duplicate anchor', () => {
+        const article = `First occurrence of the phrase here.
+
+And another occurrence of the phrase here.`;
+        const result = extractArticleExcerpt(article, 'occurrence of the phrase', 'here', 'articles/test.md');
+        expect(result.error).toBeDefined();
+        expect(result.error?.message).toContain('multiple');
+    });
+    it('is case-insensitive for matching', () => {
+        const article = 'THE KEY INSIGHT is important.';
+        const result = extractArticleExcerpt(article, 'the key insight', 'important.', 'articles/test.md');
+        expect(result.content).toBeDefined();
+        expect(result.error).toBeUndefined();
+    });
+    describe('special characters in anchors', () => {
+        it('handles apostrophes in anchor text', () => {
+            const article = `Introduction here.
+
+It's important to understand that AI systems don't always behave as expected.
+
+Conclusion here.`;
+            const result = extractArticleExcerpt(article, "It's important", "don't always behave", 'articles/test.md');
+            expect(result.error).toBeUndefined();
+            expect(result.content).toContain("It's important");
+            expect(result.content).toContain("don't always");
+        });
+        it('handles ampersand in anchor text', () => {
+            const article = `Introduction here.
+
+The relationship between safety & alignment is crucial for AI development.
+
+Conclusion here.`;
+            const result = extractArticleExcerpt(article, 'safety & alignment', 'AI development', 'articles/test.md');
+            expect(result.error).toBeUndefined();
+            expect(result.content).toContain('safety & alignment');
+        });
+        it('handles colons in anchor text', () => {
+            const article = `Introduction here.
+
+Key point: this is the main argument we need to consider carefully.
+
+Conclusion here.`;
+            const result = extractArticleExcerpt(article, 'Key point:', 'consider carefully', 'articles/test.md');
+            expect(result.error).toBeUndefined();
+            expect(result.content).toContain('Key point:');
+        });
+        it('handles percent signs in anchor text', () => {
+            const article = `Introduction here.
+
+The model achieved 95% accuracy on the benchmark test results.
+
+Conclusion here.`;
+            const result = extractArticleExcerpt(article, '95% accuracy', 'test results', 'articles/test.md');
+            expect(result.error).toBeUndefined();
+            expect(result.content).toContain('95% accuracy');
+        });
+        it('handles multiple special characters together', () => {
+            const article = `Introduction here.
+
+Here's the key insight: AI systems won't achieve 100% safety & reliability without careful design.
+
+Conclusion here.`;
+            const result = extractArticleExcerpt(article, "Here's the key insight:", "100% safety & reliability", 'articles/test.md');
+            expect(result.error).toBeUndefined();
+            expect(result.content).toContain("Here's");
+            expect(result.content).toContain("100%");
+            expect(result.content).toContain("&");
+        });
+    });
+});
+describe('bundleArticleWithCollapsed', () => {
+    it('computes collapsed_before for non-first excerpt', () => {
+        const article = `# Article
+
+Intro paragraph.
+
+First important section that we want to show.
+
+Middle content that gets collapsed.
+
+Second important section to show.
+
+Conclusion.
+`;
+        const excerpts = [
+            { from: 'First important', to: 'want to show.' },
+            { from: 'Second important', to: 'section to show.' },
+        ];
+        const result = bundleArticleWithCollapsed(article, excerpts, 'articles/test.md');
+        expect(result[0].collapsed_before).toBeUndefined(); // First excerpt has no collapsed_before
+        expect(result[1].collapsed_before).toContain('Middle content');
+    });
+    it('computes collapsed_after for last excerpt', () => {
+        const article = `Intro.
+
+Main content here.
+
+Conclusion paragraph at the end.
+`;
+        const excerpts = [
+            { from: 'Main content', to: 'content here.' },
+        ];
+        const result = bundleArticleWithCollapsed(article, excerpts, 'articles/test.md');
+        expect(result[0].collapsed_after).toContain('Conclusion paragraph');
+    });
+    it('handles adjacent excerpts with no collapsed content', () => {
+        const article = `First sentence. Second sentence.`;
+        const excerpts = [
+            { from: 'First', to: 'sentence.' },
+            { from: 'Second', to: 'sentence.' },
+        ];
+        const result = bundleArticleWithCollapsed(article, excerpts, 'articles/test.md');
+        // Adjacent excerpts have minimal or no collapsed content
+        expect(result[0].collapsed_after).toBeUndefined();
+        expect(result[1].collapsed_before).toBeUndefined();
+    });
+});
+describe('extractArticleExcerpt with optional anchors', () => {
+    const articleWithFrontmatter = `---
+title: Test Article
+author: John Doe
+---
+
+Introduction paragraph here.
+
+Start here with the main content that we want to extract.
+
+Middle section content.
+
+End here and this is included.
+
+Conclusion paragraph at the end.
+`;
+    const articleWithoutFrontmatter = `Introduction paragraph here.
+
+Start here with the main content that we want to extract.
+
+Middle section content.
+
+End here and this is included.
+
+Conclusion paragraph at the end.
+`;
+    it('extracts from anchor to end of article when toAnchor is undefined', () => {
+        const result = extractArticleExcerpt(articleWithoutFrontmatter, 'Start here', undefined, 'articles/test.md');
+        expect(result.error).toBeUndefined();
+        expect(result.content).toContain('Start here');
+        expect(result.content).toContain('Middle section');
+        expect(result.content).toContain('End here');
+        expect(result.content).toContain('Conclusion paragraph');
+    });
+    it('extracts from start of article to anchor when fromAnchor is undefined', () => {
+        const result = extractArticleExcerpt(articleWithoutFrontmatter, undefined, 'End here and this is included.', 'articles/test.md');
+        expect(result.error).toBeUndefined();
+        expect(result.content).toContain('Introduction paragraph');
+        expect(result.content).toContain('Start here');
+        expect(result.content).toContain('End here and this is included.');
+        expect(result.content).not.toContain('Conclusion paragraph');
+    });
+    it('extracts entire article when both anchors are undefined', () => {
+        const result = extractArticleExcerpt(articleWithoutFrontmatter, undefined, undefined, 'articles/test.md');
+        expect(result.error).toBeUndefined();
+        expect(result.content).toContain('Introduction paragraph');
+        expect(result.content).toContain('Conclusion paragraph');
+        expect(result.content).toBe(articleWithoutFrontmatter.trim());
+    });
+    it('strips frontmatter when extracting entire article', () => {
+        const result = extractArticleExcerpt(articleWithFrontmatter, undefined, undefined, 'articles/test.md');
+        expect(result.error).toBeUndefined();
+        expect(result.content).not.toContain('title:');
+        expect(result.content).not.toContain('author:');
+        expect(result.content).not.toContain('---');
+        expect(result.content).toContain('Introduction paragraph');
+        expect(result.content).toContain('Conclusion paragraph');
+    });
+    it('strips frontmatter when extracting from start to anchor', () => {
+        const result = extractArticleExcerpt(articleWithFrontmatter, undefined, 'Middle section content.', 'articles/test.md');
+        expect(result.error).toBeUndefined();
+        expect(result.content).not.toContain('title:');
+        expect(result.content).not.toContain('---');
+        expect(result.content).toContain('Introduction paragraph');
+        expect(result.content).toContain('Middle section content.');
+    });
+});
+//# sourceMappingURL=article.test.js.map

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

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

package/dist/bundler/video.d.ts

@@ -0,0 +1,50 @@
+import type { ContentError } from '../index.js';
+export interface VideoExcerptResult {
+    from?: number;
+    to?: number | null;
+    transcript?: string;
+    error?: ContentError;
+}
+/**
+ * Word-level timestamp entry from .timestamps.json files.
+ */
+export interface TimestampEntry {
+    text: string;
+    start: string;
+}
+/**
+ * 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 declare function parseTimestamp(str: string): number | null;
+/**
+ * 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 declare function extractFromTimestamps(timestamps: TimestampEntry[], fromSeconds: number, toSeconds: number): string;
+/**
+ * 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 declare function extractVideoExcerpt(transcript: string, fromTime: string, toTime: string, file: string, timestamps?: TimestampEntry[]): VideoExcerptResult;