@compilr-dev/factory 0.1.15 → 0.1.16

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, } from './research-model/index.js';
+export { createDefaultResearchModel, createDefaultSection, createDefaultClaim, createDefaultSource, createDefaultQuestion, ResearchModelStore, applyResearchOperation, validateResearchModel, createResearchModelTools, generateBibliography, } 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, } 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/index.d.ts

@@ -10,3 +10,5 @@ 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';

package/dist/research-model/index.js

@@ -11,3 +11,5 @@ export { applyResearchOperation } from './operations.js';
 export { validateResearchModel } from './schema.js';
 // Tools
 export { createResearchModelTools } from './tools.js';
+// Bibliography
+export { generateBibliography } from './bibliography.js';

package/dist/research-model/tools.js

@@ -10,6 +10,7 @@ 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';
 // =============================================================================
 // Helpers
 // =============================================================================
@@ -572,6 +573,81 @@ 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,
+    });
+}
 // =============================================================================
 // Public API
 // =============================================================================
@@ -580,5 +656,6 @@ export function createResearchModelTools(config) {
         createResearchModelGetTool(config),
         createResearchModelUpdateTool(config),
         createResearchModelValidateTool(config),
+        createBibliographyGenerateTool(config),
     ];
 }

package/package.json

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