@compilr-dev/factory 0.1.15 → 0.1.17

package/dist/index.d.ts

@@ -24,5 +24,5 @@ export { staticLandingToolkit } from './toolkits/static-landing/index.js';
 export { reactFastapiToolkit } from './toolkits/react-fastapi/index.js';
 export { reactGoToolkit } from './toolkits/react-go/index.js';
 export { factoryScaffoldSkill, factorySkills } from './factory/skill.js';
-export type { ResearchModel, Section, SectionStatus, Claim, ClaimType, EvidenceStrength, SourceRef, Source, SourceRelevance, CitationInfo, CitationType, CitationStyle, ResearchQuestion, QuestionStatus, ResearchMeta, ResearchValidationError, ResearchValidationResult, ResearchModelOperation, ResearchModelToolsConfig, } from './research-model/index.js';
-export { createDefaultResearchModel, createDefaultSection, createDefaultClaim, createDefaultSource, createDefaultQuestion, ResearchModelStore, applyResearchOperation, validateResearchModel, createResearchModelTools, } from './research-model/index.js';
+export type { ResearchModel, Section, SectionStatus, Claim, ClaimType, EvidenceStrength, SourceRef, Source, SourceRelevance, CitationInfo, CitationType, CitationStyle, ResearchQuestion, QuestionStatus, ResearchMeta, ResearchValidationError, ResearchValidationResult, ResearchModelOperation, ResearchModelToolsConfig, BibliographyOptions, BibTeXEntry, } from './research-model/index.js';
+export { createDefaultResearchModel, createDefaultSection, createDefaultClaim, createDefaultSource, createDefaultQuestion, ResearchModelStore, applyResearchOperation, validateResearchModel, createResearchModelTools, generateBibliography, parseBibTeX, } from './research-model/index.js';

package/dist/index.js

@@ -31,4 +31,4 @@ export { reactFastapiToolkit } from './toolkits/react-fastapi/index.js';
 export { reactGoToolkit } from './toolkits/react-go/index.js';
 // Factory skill (Phase 5)
 export { factoryScaffoldSkill, factorySkills } from './factory/skill.js';
-export { createDefaultResearchModel, createDefaultSection, createDefaultClaim, createDefaultSource, createDefaultQuestion, ResearchModelStore, applyResearchOperation, validateResearchModel, createResearchModelTools, } from './research-model/index.js';
+export { createDefaultResearchModel, createDefaultSection, createDefaultClaim, createDefaultSource, createDefaultQuestion, ResearchModelStore, applyResearchOperation, validateResearchModel, createResearchModelTools, generateBibliography, parseBibTeX, } from './research-model/index.js';

package/dist/research-model/bibliography.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Bibliography Generator
+ *
+ * Formats source citations from the Research Model into a complete
+ * bibliography in the project's citation style.
+ *
+ * Supported styles: APA, MLA, Chicago, IEEE, Harvard
+ * Output formats: Markdown, LaTeX/BibTeX
+ */
+import type { Source, CitationStyle } from './types.js';
+export interface BibliographyOptions {
+    /** Citation style (from Research Model) */
+    style: CitationStyle;
+    /** Output format */
+    format: 'markdown' | 'latex' | 'bibtex';
+    /** Filter: only referenced sources or all */
+    filter: 'referenced' | 'all';
+}
+/**
+ * Generate a formatted bibliography from a list of sources.
+ *
+ * @param sources - Sources to include
+ * @param referencedIds - Set of source IDs actually cited in the paper (for filter: 'referenced')
+ * @param options - Style, format, and filter options
+ */
+export declare function generateBibliography(sources: readonly Source[], referencedIds: Set<string>, options: BibliographyOptions): string;

package/dist/research-model/bibliography.js

@@ -0,0 +1,299 @@
+/**
+ * Bibliography Generator
+ *
+ * Formats source citations from the Research Model into a complete
+ * bibliography in the project's citation style.
+ *
+ * Supported styles: APA, MLA, Chicago, IEEE, Harvard
+ * Output formats: Markdown, LaTeX/BibTeX
+ */
+/**
+ * Generate a formatted bibliography from a list of sources.
+ *
+ * @param sources - Sources to include
+ * @param referencedIds - Set of source IDs actually cited in the paper (for filter: 'referenced')
+ * @param options - Style, format, and filter options
+ */
+export function generateBibliography(sources, referencedIds, options) {
+    let filtered = [...sources];
+    if (options.filter === 'referenced') {
+        filtered = filtered.filter((s) => referencedIds.has(s.id));
+    }
+    // Sort alphabetically by first author last name, then year
+    filtered.sort((a, b) => {
+        const authorA = getLastName(a.citation.authors[0] ?? '');
+        const authorB = getLastName(b.citation.authors[0] ?? '');
+        const cmp = authorA.localeCompare(authorB);
+        if (cmp !== 0)
+            return cmp;
+        return Number(a.citation.year) - Number(b.citation.year);
+    });
+    if (options.format === 'bibtex') {
+        return filtered.map((s) => formatBibTeX(s)).join('\n\n');
+    }
+    const formatter = getFormatter(options.style);
+    const entries = filtered.map((s) => formatter(s.citation, s.citeKey));
+    if (options.format === 'latex') {
+        return entries.join('\n\n');
+    }
+    // Markdown
+    return entries.join('\n\n');
+}
+function getFormatter(style) {
+    switch (style) {
+        case 'apa':
+            return formatAPA;
+        case 'mla':
+            return formatMLA;
+        case 'chicago':
+            return formatChicago;
+        case 'ieee':
+            return formatIEEE;
+        case 'harvard':
+            return formatHarvard;
+        default:
+            return formatAPA;
+    }
+}
+/**
+ * APA 7th Edition
+ * Author, A. A., & Author, B. B. (Year). Title of work. *Venue*, Volume(Issue), Pages. DOI
+ */
+function formatAPA(info, _citeKey) {
+    const authors = formatAuthorsAPA(info.authors);
+    const year = `(${String(info.year)})`;
+    const title = info.type === 'article' || info.type === 'chapter' ? info.title : `*${info.title}*`;
+    const parts = [authors, year, `${title}.`];
+    if (info.venue) {
+        parts.push(info.type === 'article' ? `*${info.venue}*` : info.venue);
+        if (info.volume) {
+            const vol = info.issue ? `${info.volume}(${info.issue})` : info.volume;
+            parts[parts.length - 1] += `, ${vol}`;
+        }
+        if (info.pages) {
+            parts[parts.length - 1] += `, ${info.pages}`;
+        }
+        parts[parts.length - 1] += '.';
+    }
+    if (info.doi)
+        parts.push(`https://doi.org/${info.doi}`);
+    else if (info.url)
+        parts.push(info.url);
+    return parts.join(' ');
+}
+/**
+ * MLA 9th Edition
+ * Author. "Title." *Venue*, vol. Volume, no. Issue, Year, pp. Pages.
+ */
+function formatMLA(info, _citeKey) {
+    const authors = formatAuthorsMLA(info.authors);
+    const title = info.type === 'article' || info.type === 'chapter' ? `"${info.title}."` : `*${info.title}*.`;
+    const parts = [authors, title];
+    if (info.venue) {
+        let venue = `*${info.venue}*`;
+        if (info.volume)
+            venue += `, vol. ${info.volume}`;
+        if (info.issue)
+            venue += `, no. ${info.issue}`;
+        venue += `, ${String(info.year)}`;
+        if (info.pages)
+            venue += `, pp. ${info.pages}`;
+        venue += '.';
+        parts.push(venue);
+    }
+    else {
+        parts.push(`${String(info.year)}.`);
+    }
+    if (info.doi)
+        parts.push(`https://doi.org/${info.doi}`);
+    return parts.join(' ');
+}
+/**
+ * Chicago (Author-Date)
+ * Author, First. Year. "Title." *Venue* Volume (Issue): Pages. DOI.
+ */
+function formatChicago(info, _citeKey) {
+    const authors = formatAuthorsChicago(info.authors);
+    const year = `${String(info.year)}.`;
+    const title = info.type === 'article' || info.type === 'chapter' ? `"${info.title}."` : `*${info.title}*.`;
+    const parts = [authors, year, title];
+    if (info.venue) {
+        let venue = `*${info.venue}*`;
+        if (info.volume) {
+            venue += ` ${info.volume}`;
+            if (info.issue)
+                venue += ` (${info.issue})`;
+        }
+        if (info.pages)
+            venue += `: ${info.pages}`;
+        venue += '.';
+        parts.push(venue);
+    }
+    if (info.doi)
+        parts.push(`https://doi.org/${info.doi}.`);
+    return parts.join(' ');
+}
+/**
+ * IEEE
+ * [N] A. Author and B. Author, "Title," *Venue*, vol. V, no. N, pp. P, Year.
+ */
+function formatIEEE(info, citeKey) {
+    const authors = formatAuthorsIEEE(info.authors);
+    const title = `"${info.title},"`;
+    const parts = [`[${citeKey}]`, `${authors},`, title];
+    if (info.venue) {
+        let venue = `*${info.venue}*`;
+        if (info.volume)
+            venue += `, vol. ${info.volume}`;
+        if (info.issue)
+            venue += `, no. ${info.issue}`;
+        if (info.pages)
+            venue += `, pp. ${info.pages}`;
+        venue += `, ${String(info.year)}.`;
+        parts.push(venue);
+    }
+    else {
+        parts.push(`${String(info.year)}.`);
+    }
+    if (info.doi)
+        parts.push(`doi: ${info.doi}.`);
+    return parts.join(' ');
+}
+/**
+ * Harvard
+ * Author, A. (Year) Title. *Venue*, Volume(Issue), pp. Pages.
+ */
+function formatHarvard(info, _citeKey) {
+    const authors = formatAuthorsHarvard(info.authors);
+    const year = `(${String(info.year)})`;
+    const title = info.type === 'article' || info.type === 'chapter' ? `'${info.title}'.` : `*${info.title}*.`;
+    const parts = [authors, year, title];
+    if (info.venue) {
+        let venue = `*${info.venue}*`;
+        if (info.volume) {
+            venue += `, ${info.volume}`;
+            if (info.issue)
+                venue += `(${info.issue})`;
+        }
+        if (info.pages)
+            venue += `, pp. ${info.pages}`;
+        venue += '.';
+        parts.push(venue);
+    }
+    if (info.doi)
+        parts.push(`doi: ${info.doi}.`);
+    return parts.join(' ');
+}
+// =============================================================================
+// BibTeX Format
+// =============================================================================
+function formatBibTeX(source) {
+    const info = source.citation;
+    const entryType = bibtexType(info.type);
+    const lines = [`@${entryType}{${source.citeKey},`];
+    lines.push(`  author = {${info.authors.join(' and ')}},`);
+    lines.push(`  title = {${info.title}},`);
+    lines.push(`  year = {${String(info.year)}},`);
+    if (info.venue) {
+        const field = info.type === 'book' ? 'publisher' : 'journal';
+        lines.push(`  ${field} = {${info.venue}},`);
+    }
+    if (info.volume)
+        lines.push(`  volume = {${info.volume}},`);
+    if (info.issue)
+        lines.push(`  number = {${info.issue}},`);
+    if (info.pages)
+        lines.push(`  pages = {${info.pages}},`);
+    if (info.doi)
+        lines.push(`  doi = {${info.doi}},`);
+    if (info.url)
+        lines.push(`  url = {${info.url}},`);
+    lines.push('}');
+    return lines.join('\n');
+}
+function bibtexType(citationType) {
+    switch (citationType) {
+        case 'article':
+            return 'article';
+        case 'book':
+            return 'book';
+        case 'chapter':
+            return 'incollection';
+        case 'conference':
+            return 'inproceedings';
+        case 'thesis':
+            return 'phdthesis';
+        case 'report':
+            return 'techreport';
+        case 'web':
+            return 'misc';
+        default:
+            return 'misc';
+    }
+}
+// =============================================================================
+// Author Formatting Helpers
+// =============================================================================
+function getLastName(author) {
+    // Handles "Last, First" and "First Last" formats
+    if (author.includes(','))
+        return author.split(',')[0].trim();
+    const parts = author.trim().split(/\s+/);
+    return parts[parts.length - 1];
+}
+function getInitials(author) {
+    if (author.includes(',')) {
+        const parts = author.split(',');
+        const firstNames = parts.slice(1).join(',').trim();
+        return firstNames
+            .split(/\s+/)
+            .map((n) => n.charAt(0).toUpperCase() + '.')
+            .join(' ');
+    }
+    const parts = author.trim().split(/\s+/);
+    return parts
+        .slice(0, -1)
+        .map((n) => n.charAt(0).toUpperCase() + '.')
+        .join(' ');
+}
+/** APA: Last, F. M., & Last, F. M. */
+function formatAuthorsAPA(authors) {
+    if (authors.length === 0)
+        return '';
+    const formatted = authors.map((a) => `${getLastName(a)}, ${getInitials(a)}`);
+    if (formatted.length === 1)
+        return formatted[0];
+    if (formatted.length === 2)
+        return `${formatted[0]}, & ${formatted[1]}`;
+    return `${formatted.slice(0, -1).join(', ')}, & ${formatted[formatted.length - 1]}`;
+}
+/** MLA: Last, First, and First Last. */
+function formatAuthorsMLA(authors) {
+    if (authors.length === 0)
+        return '';
+    if (authors.length === 1)
+        return `${authors[0]}.`;
+    if (authors.length === 2)
+        return `${authors[0]}, and ${authors[1]}.`;
+    return `${authors[0]}, et al.`;
+}
+/** Chicago: Last, First, and First Last. */
+function formatAuthorsChicago(authors) {
+    return formatAuthorsMLA(authors);
+}
+/** IEEE: F. Last and F. Last */
+function formatAuthorsIEEE(authors) {
+    const formatted = authors.map((a) => `${getInitials(a)} ${getLastName(a)}`);
+    if (formatted.length <= 2)
+        return formatted.join(' and ');
+    return `${formatted.slice(0, -1).join(', ')}, and ${formatted[formatted.length - 1]}`;
+}
+/** Harvard: Last, F. and Last, F. */
+function formatAuthorsHarvard(authors) {
+    const formatted = authors.map((a) => `${getLastName(a)}, ${getInitials(a)}`);
+    if (formatted.length === 1)
+        return formatted[0];
+    if (formatted.length === 2)
+        return `${formatted[0]} and ${formatted[1]}`;
+    return `${formatted.slice(0, -1).join(', ')} and ${formatted[formatted.length - 1]}`;
+}

package/dist/research-model/bibtex-parser.d.ts

@@ -0,0 +1,19 @@
+/**
+ * BibTeX Parser
+ *
+ * Parses .bib files into structured source entries that can be
+ * bulk-imported into the Research Model's source registry.
+ */
+import type { CitationInfo } from './types.js';
+export interface BibTeXEntry {
+    /** BibTeX citation key (e.g., "smith2024") */
+    citeKey: string;
+    /** Structured citation info */
+    citation: CitationInfo;
+    /** Raw BibTeX entry type (article, book, inproceedings, etc.) */
+    rawType: string;
+}
+/**
+ * Parse a BibTeX string into structured entries.
+ */
+export declare function parseBibTeX(bibtex: string): BibTeXEntry[];

package/dist/research-model/bibtex-parser.js

@@ -0,0 +1,147 @@
+/**
+ * BibTeX Parser
+ *
+ * Parses .bib files into structured source entries that can be
+ * bulk-imported into the Research Model's source registry.
+ */
+/**
+ * Parse a BibTeX string into structured entries.
+ */
+export function parseBibTeX(bibtex) {
+    const entries = [];
+    // Match @type{key, ... }  — handles nested braces via counting
+    const entryRegex = /@(\w+)\s*\{([^,]+),/g;
+    let match;
+    while ((match = entryRegex.exec(bibtex)) !== null) {
+        const rawType = match[1].toLowerCase();
+        const citeKey = match[2].trim();
+        // Skip @string, @preamble, @comment
+        if (rawType === 'string' || rawType === 'preamble' || rawType === 'comment')
+            continue;
+        // Extract the body of this entry (from after the key comma to the matching closing brace)
+        const bodyStart = match.index + match[0].length;
+        const body = extractBody(bibtex, bodyStart);
+        if (!body)
+            continue;
+        const fields = parseFields(body);
+        const citation = fieldsToCitation(fields, rawType);
+        entries.push({ citeKey, citation, rawType });
+    }
+    return entries;
+}
+// =============================================================================
+// Internals
+// =============================================================================
+/**
+ * Extract the body of a BibTeX entry by counting braces.
+ */
+function extractBody(source, startIndex) {
+    let depth = 1; // We're already inside the opening brace
+    let i = startIndex;
+    const start = startIndex;
+    while (i < source.length && depth > 0) {
+        if (source[i] === '{')
+            depth++;
+        else if (source[i] === '}')
+            depth--;
+        i++;
+    }
+    if (depth !== 0)
+        return null;
+    return source.slice(start, i - 1); // Exclude the final closing brace
+}
+/**
+ * Parse field = {value} or field = "value" or field = number pairs.
+ */
+function parseFields(body) {
+    const fields = {};
+    // Match: fieldname = {value} or fieldname = "value" or fieldname = 123
+    const fieldRegex = /(\w+)\s*=\s*(?:\{([^}]*(?:\{[^}]*\}[^}]*)*)\}|"([^"]*)"|(\d+))/g;
+    let m;
+    while ((m = fieldRegex.exec(body)) !== null) {
+        const key = m[1].toLowerCase();
+        const value = m[2] || m[3] || m[4] || '';
+        fields[key] = cleanValue(value);
+    }
+    return fields;
+}
+/**
+ * Clean LaTeX artifacts from a value.
+ */
+function cleanValue(value) {
+    return value
+        .replace(/\{/g, '')
+        .replace(/\}/g, '')
+        .replace(/\\&/g, '&')
+        .replace(/\\textit/g, '')
+        .replace(/\\textbf/g, '')
+        .replace(/\\emph/g, '')
+        .replace(/~/g, ' ')
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+/**
+ * Map BibTeX entry type to our CitationType.
+ */
+function mapType(rawType) {
+    switch (rawType) {
+        case 'article':
+            return 'article';
+        case 'book':
+            return 'book';
+        case 'incollection':
+        case 'inbook':
+            return 'chapter';
+        case 'inproceedings':
+        case 'conference':
+            return 'conference';
+        case 'phdthesis':
+        case 'mastersthesis':
+            return 'thesis';
+        case 'techreport':
+            return 'report';
+        case 'misc':
+        case 'online':
+            return 'web';
+        default:
+            return 'other';
+    }
+}
+/**
+ * Parse BibTeX author string ("Last, First and Last, First" or "First Last and First Last").
+ */
+function parseAuthors(authorStr) {
+    if (!authorStr)
+        return [];
+    return authorStr
+        .split(/\s+and\s+/i)
+        .map((a) => a.trim())
+        .filter((a) => a.length > 0);
+}
+/**
+ * Convert parsed fields to CitationInfo.
+ */
+function fieldsToCitation(fields, rawType) {
+    // Helper to access fields safely (Record<string,string> always returns string, but fields may be absent)
+    const get = (key) => {
+        return Object.prototype.hasOwnProperty.call(fields, key) ? fields[key] : undefined;
+    };
+    const venue = get('journal') ||
+        get('booktitle') ||
+        get('publisher') ||
+        get('school') ||
+        get('institution') ||
+        get('howpublished');
+    return {
+        type: mapType(rawType),
+        title: get('title') || 'Untitled',
+        authors: parseAuthors(get('author') || ''),
+        year: get('year') || 'n.d.',
+        venue,
+        volume: get('volume'),
+        issue: get('number'),
+        pages: get('pages')?.replace('--', '–'),
+        doi: get('doi'),
+        url: get('url'),
+    };
+}

package/dist/research-model/index.d.ts

@@ -10,3 +10,7 @@ export { validateResearchModel } from './schema.js';
 export type { ResearchValidationError, ResearchValidationResult } from './schema.js';
 export { createResearchModelTools } from './tools.js';
 export type { ResearchModelToolsConfig } from './tools.js';
+export { generateBibliography } from './bibliography.js';
+export type { BibliographyOptions } from './bibliography.js';
+export { parseBibTeX } from './bibtex-parser.js';
+export type { BibTeXEntry } from './bibtex-parser.js';

package/dist/research-model/index.js

@@ -11,3 +11,7 @@ export { applyResearchOperation } from './operations.js';
 export { validateResearchModel } from './schema.js';
 // Tools
 export { createResearchModelTools } from './tools.js';
+// Bibliography
+export { generateBibliography } from './bibliography.js';
+// BibTeX Parser
+export { parseBibTeX } from './bibtex-parser.js';

package/dist/research-model/tools.js

@@ -10,6 +10,9 @@ import { ResearchModelStore } from './persistence.js';
 import { applyResearchOperation } from './operations.js';
 import { validateResearchModel } from './schema.js';
 import { createDefaultResearchModel } from './defaults.js';
+import { generateBibliography } from './bibliography.js';
+import { parseBibTeX } from './bibtex-parser.js';
+import { generateId } from './defaults.js';
 // =============================================================================
 // Helpers
 // =============================================================================
@@ -572,6 +575,163 @@ function createResearchModelValidateTool(config) {
         readonly: true,
     });
 }
+function createBibliographyGenerateTool(config) {
+    return defineTool({
+        name: 'bibliography_generate',
+        description: 'Generate a formatted bibliography from the Research Model sources. Supports APA, MLA, Chicago, IEEE, Harvard styles and Markdown, LaTeX, BibTeX output.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                format: {
+                    type: 'string',
+                    enum: ['markdown', 'latex', 'bibtex'],
+                    description: 'Output format. Defaults to "markdown".',
+                },
+                filter: {
+                    type: 'string',
+                    enum: ['referenced', 'all'],
+                    description: 'Which sources to include. "referenced" = only sources cited in claims. "all" = entire registry. Defaults to "all".',
+                },
+                project_id: {
+                    type: 'number',
+                    description: 'Project ID. Uses active project if omitted.',
+                },
+            },
+            required: [],
+        },
+        execute: async (input) => {
+            try {
+                const projectId = getProjectId(config, input.project_id);
+                const store = createStore(config, projectId);
+                const model = await store.get();
+                if (!model) {
+                    return createErrorResult('No Research Model found. Create one first.');
+                }
+                if (model.sources.length === 0) {
+                    return createSuccessResult({
+                        bibliography: '',
+                        message: 'No sources in the model. Add sources first.',
+                        count: 0,
+                    });
+                }
+                // Collect referenced source IDs (from all claims)
+                const referencedIds = new Set();
+                for (const section of model.sections) {
+                    for (const claim of section.claims) {
+                        for (const ref of claim.supportingSources)
+                            referencedIds.add(ref.sourceId);
+                        for (const ref of claim.contradictingSources)
+                            referencedIds.add(ref.sourceId);
+                    }
+                }
+                const options = {
+                    style: model.citationStyle,
+                    format: input.format ?? 'markdown',
+                    filter: input.filter ?? 'all',
+                };
+                const bibliography = generateBibliography(model.sources, referencedIds, options);
+                const count = options.filter === 'referenced'
+                    ? model.sources.filter((s) => referencedIds.has(s.id)).length
+                    : model.sources.length;
+                return createSuccessResult({
+                    bibliography,
+                    style: model.citationStyle,
+                    format: options.format,
+                    filter: options.filter,
+                    count,
+                    totalSources: model.sources.length,
+                    referencedSources: referencedIds.size,
+                });
+            }
+            catch (error) {
+                return createErrorResult(error instanceof Error ? error.message : String(error));
+            }
+        },
+        readonly: true,
+    });
+}
+function createBibTeXImportTool(config) {
+    return defineTool({
+        name: 'bibtex_import',
+        description: 'Parse a BibTeX string and bulk-import entries as sources into the Research Model. Skips duplicates by citeKey.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                content: {
+                    type: 'string',
+                    description: 'BibTeX content to parse (the full .bib file content).',
+                },
+                project_id: {
+                    type: 'number',
+                    description: 'Project ID. Uses active project if omitted.',
+                },
+            },
+            required: ['content'],
+        },
+        execute: async (input) => {
+            try {
+                const projectId = getProjectId(config, input.project_id);
+                const store = createStore(config, projectId);
+                let model = await store.get();
+                if (!model) {
+                    model = createDefaultResearchModel();
+                }
+                const entries = parseBibTeX(input.content);
+                if (entries.length === 0) {
+                    return createSuccessResult({
+                        imported: 0,
+                        skipped: 0,
+                        message: 'No valid BibTeX entries found in the input.',
+                    });
+                }
+                const existingKeys = new Set(model.sources.map((s) => s.citeKey));
+                let imported = 0;
+                let skipped = 0;
+                const importedKeys = [];
+                for (const entry of entries) {
+                    if (existingKeys.has(entry.citeKey)) {
+                        skipped++;
+                        continue;
+                    }
+                    model = {
+                        ...model,
+                        sources: [
+                            ...model.sources,
+                            {
+                                id: generateId('src'),
+                                citeKey: entry.citeKey,
+                                citation: entry.citation,
+                                analyzed: false,
+                            },
+                        ],
+                        meta: {
+                            ...model.meta,
+                            revision: model.meta.revision + 1,
+                            updatedAt: new Date().toISOString(),
+                        },
+                    };
+                    existingKeys.add(entry.citeKey);
+                    imported++;
+                    importedKeys.push(entry.citeKey);
+                }
+                if (imported > 0) {
+                    await store.save(model);
+                }
+                return createSuccessResult({
+                    imported,
+                    skipped,
+                    total: entries.length,
+                    importedKeys,
+                    revision: model.meta.revision,
+                    message: `Imported ${String(imported)} source(s)${skipped > 0 ? `, skipped ${String(skipped)} duplicate(s)` : ''}.`,
+                });
+            }
+            catch (error) {
+                return createErrorResult(error instanceof Error ? error.message : String(error));
+            }
+        },
+    });
+}
 // =============================================================================
 // Public API
 // =============================================================================
@@ -580,5 +740,7 @@ export function createResearchModelTools(config) {
         createResearchModelGetTool(config),
         createResearchModelUpdateTool(config),
         createResearchModelValidateTool(config),
+        createBibliographyGenerateTool(config),
+        createBibTeXImportTool(config),
     ];
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@compilr-dev/factory",
-  "version": "0.1.15",
+  "version": "0.1.17",
   "description": "AI-driven application scaffolder for the compilr-dev ecosystem",
   "type": "module",
   "main": "dist/index.js",