@phuetz/code-buddy 0.3.0 → 1.0.0-rc.8

package/dist/docs/doc-exporter.js

@@ -0,0 +1,91 @@
+/**
+ * Doc Exporter — orchestrates rendering and writing all formats to disk.
+ *
+ * Takes an array of RenderInput pages and writes them to the output directory
+ * in the requested formats (markdown, html, json, wiki).
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { logger } from '../utils/logger.js';
+import { MultiFormatRenderer } from './renderers/multi-format-renderer.js';
+// ============================================================================
+// Exporter
+// ============================================================================
+export class DocExporter {
+    /**
+     * Export all pages in all requested formats and write to disk.
+     */
+    static async export(pages, options) {
+        const startTime = Date.now();
+        const { outputDir, formats, repoName } = options;
+        const byFormat = {};
+        let totalFiles = 0;
+        let totalBytes = 0;
+        // Ensure output directory exists
+        if (!fs.existsSync(outputDir)) {
+            fs.mkdirSync(outputDir, { recursive: true });
+        }
+        // Ensure wiki subdirectory if needed
+        if (formats.includes('wiki')) {
+            const wikiDir = path.join(outputDir, 'wiki');
+            if (!fs.existsSync(wikiDir)) {
+                fs.mkdirSync(wikiDir, { recursive: true });
+            }
+        }
+        // Render and write each page in each format
+        for (const page of pages) {
+            for (const format of formats) {
+                const outputs = DocExporter.renderPage(page, pages, format);
+                for (const output of outputs) {
+                    const filePath = path.join(outputDir, output.filename);
+                    // Ensure parent directory exists (for wiki/ subdirectory)
+                    const dir = path.dirname(filePath);
+                    if (!fs.existsSync(dir)) {
+                        fs.mkdirSync(dir, { recursive: true });
+                    }
+                    fs.writeFileSync(filePath, output.content, 'utf-8');
+                    totalFiles++;
+                    totalBytes += output.sizeBytes;
+                    if (!byFormat[format]) {
+                        byFormat[format] = { files: 0, bytes: 0 };
+                    }
+                    byFormat[format].files++;
+                    byFormat[format].bytes += output.sizeBytes;
+                }
+            }
+        }
+        // Write README.md index
+        const indexContent = MultiFormatRenderer.buildIndex(pages, formats, repoName);
+        const indexPath = path.join(outputDir, 'README.md');
+        fs.writeFileSync(indexPath, indexContent, 'utf-8');
+        totalFiles++;
+        totalBytes += Buffer.byteLength(indexContent, 'utf-8');
+        const duration = Date.now() - startTime;
+        logger.info(`DocExporter: wrote ${totalFiles} files (${(totalBytes / 1024).toFixed(1)} KB) in ${duration}ms`);
+        return {
+            totalFiles,
+            totalBytes,
+            byFormat,
+            duration,
+        };
+    }
+    /**
+     * Render a single page in a given format. Returns array because wiki yields multiple files.
+     */
+    static renderPage(page, allPages, format) {
+        switch (format) {
+            case 'markdown':
+                return [MultiFormatRenderer.toMarkdown(page)];
+            case 'html':
+                return [MultiFormatRenderer.toHtml(page, allPages)];
+            case 'json':
+                return [MultiFormatRenderer.toJson(page)];
+            case 'wiki':
+                return MultiFormatRenderer.toWiki(page, allPages);
+            default:
+                logger.warn(`DocExporter: unknown format "${format}", skipping`);
+                return [];
+        }
+    }
+}
+//# sourceMappingURL=doc-exporter.js.map

package/dist/docs/doc-exporter.js.map

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

package/dist/docs/docs-context-provider.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Docs Context Provider
+ *
+ * Makes generated documentation (.codebuddy/docs/) available to the agent
+ * at runtime. Lazy-loads and indexes doc pages, then provides:
+ * - Per-turn relevant context based on user message keywords
+ * - Architecture summary for system prompt injection
+ *
+ * Mirrors the pattern from code-graph-context-provider.ts.
+ */
+declare class DocsContextProvider {
+    private index;
+    private _loaded;
+    private _loadedAt;
+    private _docsDir;
+    get isLoaded(): boolean;
+    loadDocsIndex(cwd?: string): Promise<void>;
+    /** Synchronous reload for staleness recovery (reuses the same parsing logic) */
+    private loadDocsIndexSync;
+    /**
+     * Get relevant doc context for a user message.
+     * Returns null if no relevant docs found.
+     */
+    getRelevantContext(message: string, maxChars?: number): string | null;
+    /**
+     * Get architecture summary for system prompt injection.
+     * Returns overview + architecture page content, stripped of <details> blocks.
+     */
+    getArchitectureSummary(maxChars?: number): string;
+}
+export declare function getDocsContextProvider(): DocsContextProvider;
+export declare function resetDocsContextProvider(): void;
+export {};

package/dist/docs/docs-context-provider.js

@@ -0,0 +1,269 @@
+/**
+ * Docs Context Provider
+ *
+ * Makes generated documentation (.codebuddy/docs/) available to the agent
+ * at runtime. Lazy-loads and indexes doc pages, then provides:
+ * - Per-turn relevant context based on user message keywords
+ * - Architecture summary for system prompt injection
+ *
+ * Mirrors the pattern from code-graph-context-provider.ts.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { logger } from '../utils/logger.js';
+// ============================================================================
+// Constants
+// ============================================================================
+const MAX_CONTEXT_CHARS = 1200;
+const MAX_ARCHITECTURE_CHARS = 2000;
+const MAX_PAGES_RETURNED = 2;
+const CACHE_TTL_MS = 60_000;
+const STOP_WORDS = new Set([
+    'the', 'a', 'an', 'is', 'are', 'was', 'were', 'be', 'been', 'being',
+    'have', 'has', 'had', 'do', 'does', 'did', 'will', 'would', 'could',
+    'should', 'may', 'might', 'can', 'shall', 'to', 'of', 'in', 'for',
+    'on', 'with', 'at', 'by', 'from', 'as', 'into', 'through', 'about',
+    'this', 'that', 'these', 'those', 'it', 'its', 'and', 'or', 'but',
+    'not', 'no', 'if', 'then', 'else', 'when', 'how', 'what', 'which',
+    'who', 'where', 'why', 'all', 'each', 'every', 'some', 'any', 'my',
+    'your', 'our', 'we', 'you', 'they', 'me', 'him', 'her', 'us', 'them',
+    'i', 'he', 'she', 'use', 'using', 'used', 'file', 'files', 'code',
+]);
+// ============================================================================
+// Provider
+// ============================================================================
+class DocsContextProvider {
+    index = new Map();
+    _loaded = false;
+    _loadedAt = 0;
+    _docsDir = '';
+    get isLoaded() { return this._loaded; }
+    async loadDocsIndex(cwd) {
+        const docsDir = path.join(cwd ?? process.cwd(), '.codebuddy', 'docs');
+        this._docsDir = docsDir;
+        if (!fs.existsSync(docsDir)) {
+            this._loaded = false;
+            return;
+        }
+        this.index.clear();
+        const files = fs.readdirSync(docsDir).filter(f => f.endsWith('.md') && f !== 'index.md');
+        for (const file of files) {
+            try {
+                const content = fs.readFileSync(path.join(docsDir, file), 'utf-8');
+                const slug = file.replace(/\.md$/, '');
+                // Extract title from first H1
+                const titleMatch = content.match(/^# (.+)$/m);
+                const title = titleMatch?.[1]?.trim() ?? slug;
+                // Extract description: first non-empty paragraph after title (skip <details>)
+                const afterTitle = content.replace(/^# .+\n/, '').replace(/<details>[\s\S]*?<\/details>\s*/, '');
+                const descMatch = afterTitle.match(/^(?!#|\s*$|\|)(.+)/m);
+                const description = descMatch?.[1]?.trim().substring(0, 200) ?? '';
+                // Extract keywords from title + H2 headings + bold terms
+                const keywords = [];
+                // Title words
+                for (const w of title.toLowerCase().split(/[^a-z0-9]+/).filter(w => w.length > 2 && !STOP_WORDS.has(w))) {
+                    keywords.push(w);
+                }
+                // H2 headings
+                for (const m of content.matchAll(/^## (.+)$/gm)) {
+                    const heading = m[1];
+                    if (heading === undefined)
+                        continue;
+                    for (const w of heading.toLowerCase().split(/[^a-z0-9]+/).filter(w => w.length > 2 && !STOP_WORDS.has(w))) {
+                        keywords.push(w);
+                    }
+                }
+                // Bold terms
+                for (const m of content.matchAll(/\*\*([^*]+)\*\*/g)) {
+                    const bold = m[1];
+                    if (bold === undefined)
+                        continue;
+                    for (const w of bold.toLowerCase().split(/[^a-z0-9]+/).filter(w => w.length > 2 && !STOP_WORDS.has(w))) {
+                        keywords.push(w);
+                    }
+                }
+                const isArchitecture = /overview|architecture|key.concept/i.test(slug) ||
+                    /overview|architecture/i.test(title);
+                this.index.set(slug, { slug, title, description, keywords: [...new Set(keywords)], content, isArchitecture });
+            }
+            catch { /* skip unreadable files */ }
+        }
+        this._loaded = this.index.size > 0;
+        this._loadedAt = Date.now();
+        if (this._loaded) {
+            logger.debug(`DocsContextProvider: indexed ${this.index.size} pages from ${docsDir}`);
+        }
+    }
+    /** Synchronous reload for staleness recovery (reuses the same parsing logic) */
+    loadDocsIndexSync(cwd) {
+        const docsDir = path.join(cwd, '.codebuddy', 'docs');
+        if (!fs.existsSync(docsDir))
+            return;
+        this.index.clear();
+        const files = fs.readdirSync(docsDir).filter(f => f.endsWith('.md') && f !== 'index.md');
+        for (const file of files) {
+            try {
+                const content = fs.readFileSync(path.join(docsDir, file), 'utf-8');
+                const slug = file.replace(/\.md$/, '');
+                const titleMatch = content.match(/^# (.+)$/m);
+                const title = titleMatch?.[1]?.trim() ?? slug;
+                const afterTitle = content.replace(/^# .+\n/, '').replace(/<details>[\s\S]*?<\/details>\s*/, '');
+                const descMatch = afterTitle.match(/^(?!#|\s*$|\|)(.+)/m);
+                const description = descMatch?.[1]?.trim().substring(0, 200) ?? '';
+                const keywords = [];
+                for (const w of title.toLowerCase().split(/[^a-z0-9]+/).filter(w => w.length > 2 && !STOP_WORDS.has(w)))
+                    keywords.push(w);
+                for (const m of content.matchAll(/^## (.+)$/gm)) {
+                    const heading = m[1];
+                    if (heading === undefined)
+                        continue;
+                    for (const w of heading.toLowerCase().split(/[^a-z0-9]+/).filter(w => w.length > 2 && !STOP_WORDS.has(w)))
+                        keywords.push(w);
+                }
+                const isArchitecture = /overview|architecture|key.concept/i.test(slug) || /overview|architecture/i.test(title);
+                this.index.set(slug, { slug, title, description, keywords: [...new Set(keywords)], content, isArchitecture });
+            }
+            catch { /* skip */ }
+        }
+        this._loaded = this.index.size > 0;
+        this._loadedAt = Date.now();
+        this._docsDir = docsDir;
+    }
+    /**
+     * Get relevant doc context for a user message.
+     * Returns null if no relevant docs found.
+     */
+    getRelevantContext(message, maxChars = MAX_CONTEXT_CHARS) {
+        if (!this._loaded || this.index.size === 0)
+            return null;
+        // Check staleness — reload synchronously if docs were regenerated
+        if (Date.now() - this._loadedAt > CACHE_TTL_MS) {
+            try {
+                const indexFile = path.join(this._docsDir, 'index.md');
+                if (fs.existsSync(indexFile)) {
+                    const mtime = fs.statSync(indexFile).mtimeMs;
+                    if (mtime > this._loadedAt) {
+                        this.loadDocsIndexSync(path.dirname(this._docsDir));
+                    }
+                }
+            }
+            catch { /* ignore staleness check errors */ }
+        }
+        // Extract query keywords
+        const queryWords = message.toLowerCase()
+            .split(/[^a-z0-9]+/)
+            .filter(w => w.length > 2 && !STOP_WORDS.has(w));
+        if (queryWords.length === 0)
+            return null;
+        // Score each page
+        const scored = [];
+        for (const entry of this.index.values()) {
+            let score = 0;
+            const titleLower = entry.title.toLowerCase();
+            const descLower = entry.description.toLowerCase();
+            for (const word of queryWords) {
+                if (titleLower.includes(word))
+                    score += 3;
+                if (descLower.includes(word))
+                    score += 2;
+                if (entry.keywords.includes(word))
+                    score += 1;
+                // Content match (heavier but informative)
+                if (entry.content.toLowerCase().includes(word))
+                    score += 0.5;
+            }
+            if (score > 0)
+                scored.push({ entry, score });
+        }
+        if (scored.length === 0)
+            return null;
+        // Top N pages
+        scored.sort((a, b) => b.score - a.score);
+        const topPages = scored.slice(0, MAX_PAGES_RETURNED);
+        // Only return if the top score is meaningful
+        const topPage = topPages[0];
+        if (topPage === undefined || topPage.score < 1.5)
+            return null;
+        // Build context snippets
+        const parts = [];
+        let chars = 0;
+        for (const { entry } of topPages) {
+            // Find the most relevant H2 section
+            const sections = entry.content.split(/(?=^## )/m).filter(s => s.trim());
+            let bestSection = '';
+            let bestScore = 0;
+            for (const section of sections) {
+                const sectionLower = section.toLowerCase();
+                let sScore = 0;
+                for (const word of queryWords) {
+                    if (sectionLower.includes(word))
+                        sScore++;
+                }
+                if (sScore > bestScore) {
+                    bestScore = sScore;
+                    bestSection = section;
+                }
+            }
+            // Format snippet
+            const snippet = bestSection
+                ? `### ${entry.title}\n${bestSection.substring(0, 500).trim()}`
+                : `### ${entry.title}\n${entry.description}`;
+            if (chars + snippet.length > maxChars) {
+                if (parts.length === 0)
+                    parts.push(snippet.substring(0, maxChars));
+                break;
+            }
+            parts.push(snippet);
+            chars += snippet.length;
+        }
+        return parts.length > 0 ? parts.join('\n\n') : null;
+    }
+    /**
+     * Get architecture summary for system prompt injection.
+     * Returns overview + architecture page content, stripped of <details> blocks.
+     */
+    getArchitectureSummary(maxChars = MAX_ARCHITECTURE_CHARS) {
+        if (!this._loaded || this.index.size === 0)
+            return '';
+        const archPages = [...this.index.values()]
+            .filter(p => p.isArchitecture)
+            .sort((a, b) => {
+            // Overview first, then architecture, then key-concepts
+            const order = (s) => s.includes('overview') ? 0 : s.includes('architecture') ? 1 : 2;
+            return order(a.slug) - order(b.slug);
+        });
+        if (archPages.length === 0)
+            return '';
+        const parts = [];
+        let chars = 0;
+        for (const page of archPages) {
+            // Strip <details> blocks and "See also"/"Referenced by" footers
+            let content = page.content
+                .replace(/<details>[\s\S]*?<\/details>\s*/g, '')
+                .replace(/\n---\n\n\*\*(?:See also|Referenced by):\*\*[^\n]*/g, '')
+                .trim();
+            const available = maxChars - chars;
+            if (available <= 100)
+                break;
+            if (content.length > available) {
+                content = content.substring(0, available - 3) + '...';
+            }
+            parts.push(content);
+            chars += content.length;
+        }
+        return parts.join('\n\n');
+    }
+}
+// ============================================================================
+// Singleton
+// ============================================================================
+let _instance = null;
+export function getDocsContextProvider() {
+    if (!_instance)
+        _instance = new DocsContextProvider();
+    return _instance;
+}
+export function resetDocsContextProvider() {
+    _instance = null;
+}
+//# sourceMappingURL=docs-context-provider.js.map

package/dist/docs/docs-context-provider.js.map

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

package/dist/docs/docs-pipeline.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Docs Pipeline — Generic DeepWiki-style documentation generator
+ *
+ * 4-phase pipeline:
+ *   Phase 1: DISCOVER  → Analyze code graph for project profile
+ *   Phase 2: PLAN      → Generate adaptive doc plan (LLM or deterministic)
+ *   Phase 3: GENERATE  → Produce pages using type-specific templates
+ *   Phase 4: LINK      → Create hyperlinks between concepts
+ *
+ * Works on any project — not hardcoded to Code Buddy.
+ */
+import { KnowledgeGraph } from '../knowledge/knowledge-graph.js';
+import type { LLMCall } from './llm-enricher.js';
+import type { DocsConfig } from './config.js';
+export interface PipelineResult {
+    files: string[];
+    pagesGenerated: number;
+    conceptsLinked: number;
+    durationMs: number;
+    errors: string[];
+    stats?: {
+        totalLines: number;
+        mermaidDiagrams: number;
+        seeAlsoFooters: number;
+        crossSubsystemDeps: number;
+    };
+}
+export interface PipelineOptions {
+    /** Project root */
+    cwd?: string;
+    /** LLM function for enrichment (optional — works without it) */
+    llmCall?: LLMCall;
+    /** Config overrides */
+    config?: Partial<DocsConfig>;
+    /** Force deterministic plan (30 pages) even when LLM is available */
+    forceDeterministicPlan?: boolean;
+    /** Incremental mode: only regenerate pages whose source files changed */
+    incremental?: boolean;
+    /** Progress callback */
+    onProgress?: (phase: string, detail: string) => void;
+}
+export declare function runDocsPipeline(graph: KnowledgeGraph, options?: PipelineOptions): Promise<PipelineResult>;

package/dist/docs/docs-pipeline.js

@@ -0,0 +1,132 @@
+/**
+ * Docs Pipeline — Generic DeepWiki-style documentation generator
+ *
+ * 4-phase pipeline:
+ *   Phase 1: DISCOVER  → Analyze code graph for project profile
+ *   Phase 2: PLAN      → Generate adaptive doc plan (LLM or deterministic)
+ *   Phase 3: GENERATE  → Produce pages using type-specific templates
+ *   Phase 4: LINK      → Create hyperlinks between concepts
+ *
+ * Works on any project — not hardcoded to Code Buddy.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { logger } from '../utils/logger.js';
+import { discoverProject } from './discovery/project-discovery.js';
+import { generateDocPlan } from './planning/plan-generator.js';
+import { generatePages } from './generation/page-generator.js';
+import { buildConceptIndex, linkConcepts } from './linking/concept-linker.js';
+import { validatePages } from './validation/page-validator.js';
+import { loadDocsConfig } from './config.js';
+// ============================================================================
+// Pipeline
+// ============================================================================
+export async function runDocsPipeline(graph, options = {}) {
+    const startTime = Date.now();
+    const cwd = options.cwd ?? process.cwd();
+    const config = { ...loadDocsConfig(cwd), ...options.config };
+    const errors = [];
+    // Phase 1: DISCOVER
+    options.onProgress?.('discover', 'Analyzing project...');
+    logger.info('Docs pipeline: Phase 1 — Discovery');
+    const profile = await discoverProject(graph, cwd, config.repoUrl, config.commit);
+    logger.info(`  → ${profile.name} v${profile.version}: ${profile.metrics.totalModules} modules, ${profile.architecture.type} architecture`);
+    // Phase 2: PLAN
+    options.onProgress?.('plan', 'Generating documentation plan...');
+    logger.info('Docs pipeline: Phase 2 — Planning');
+    const planLlm = options.forceDeterministicPlan ? undefined : options.llmCall;
+    const plan = await generateDocPlan(profile, planLlm);
+    logger.info(`  → ${plan.pages.length} pages planned`);
+    // Phase 3: GENERATE
+    options.onProgress?.('generate', `Generating ${plan.pages.length} pages...`);
+    logger.info('Docs pipeline: Phase 3 — Generation');
+    const genResult = await generatePages(plan, graph, config, options.llmCall, (page, current, total) => {
+        options.onProgress?.('generate', `[${current}/${total}] ${page}`);
+        logger.info(`  Generating [${current}/${total}] ${page}`);
+    }, options.incremental);
+    errors.push(...genResult.errors);
+    logger.info(`  → ${genResult.pages.length} pages generated in ${genResult.durationMs}ms`);
+    const outputDir = path.join(cwd, config.outputDir);
+    // Phase 3.5: VALIDATE
+    options.onProgress?.('validate', 'Validating pages...');
+    logger.info('Docs pipeline: Phase 3.5 — Validation');
+    const validation = validatePages(outputDir, genResult.pages);
+    logger.info(`  → ${validation.brokenLinksFixed} broken links, ${validation.placeholdersRemoved} placeholders, ${validation.fakeCitationsRemoved} fake citations fixed`);
+    // Phase 4: LINK
+    options.onProgress?.('link', 'Linking concepts...');
+    logger.info('Docs pipeline: Phase 4 — Linking');
+    const concepts = buildConceptIndex(plan, genResult.pages);
+    const linked = linkConcepts(outputDir, genResult.pages, concepts);
+    logger.info(`  → ${linked} concept links created from ${concepts.length} concepts`);
+    const files = genResult.pages.map(p => `${p.page.slug}.md`);
+    files.push('index.md');
+    // Collect quality stats
+    let totalLines = 0;
+    let mermaidDiagrams = 0;
+    let seeAlsoFooters = 0;
+    let crossSubsystemDeps = 0;
+    for (const page of genResult.pages) {
+        const filePath = path.join(outputDir, `${page.page.slug}.md`);
+        try {
+            const content = fs.readFileSync(filePath, 'utf-8');
+            totalLines += content.split('\n').length;
+            mermaidDiagrams += (content.match(/```mermaid/g) ?? []).length;
+            if (content.includes('**See also:**'))
+                seeAlsoFooters++;
+            if (content.includes('Cross-Subsystem'))
+                crossSubsystemDeps++;
+        }
+        catch { /* skip */ }
+    }
+    logger.info(`  Stats: ${totalLines} lines, ${mermaidDiagrams} mermaid, ${seeAlsoFooters} see-also, ${crossSubsystemDeps} cross-deps`);
+    // Save generation manifest for incremental mode
+    try {
+        const manifest = {};
+        for (const page of genResult.pages) {
+            manifest[page.page.slug] = {
+                generatedAt: Date.now(),
+                sourceFiles: page.page.sourceFiles,
+            };
+        }
+        fs.writeFileSync(path.join(outputDir, '.manifest.json'), JSON.stringify(manifest, null, 2));
+    }
+    catch { /* manifest save non-critical */ }
+    // Reload docs context provider if it was loaded
+    try {
+        const { getDocsContextProvider } = await import('./docs-context-provider.js');
+        const dp = getDocsContextProvider();
+        if (dp.isLoaded) {
+            await dp.loadDocsIndex(cwd);
+            logger.debug('DocsContextProvider reloaded after doc generation');
+        }
+    }
+    catch { /* optional */ }
+    // Generate combined single-file export
+    try {
+        const indexContent = fs.readFileSync(path.join(outputDir, 'index.md'), 'utf-8');
+        const combined = [indexContent, '\n\n---\n\n'];
+        for (const page of genResult.pages) {
+            const filePath = path.join(outputDir, `${page.page.slug}.md`);
+            if (fs.existsSync(filePath)) {
+                let content = fs.readFileSync(filePath, 'utf-8');
+                // Strip nav footers for combined view
+                content = content.replace(/\n---\n\[← Previous.*$/s, '');
+                combined.push(content, '\n\n---\n\n');
+            }
+        }
+        fs.writeFileSync(path.join(outputDir, 'docs-combined.md'), combined.join(''));
+        files.push('docs-combined.md');
+    }
+    catch { /* combined export non-critical */ }
+    const totalMs = Date.now() - startTime;
+    logger.info(`Docs pipeline: Done in ${(totalMs / 1000).toFixed(1)}s — ${files.length} files, ${linked} links`);
+    return {
+        files,
+        pagesGenerated: genResult.pages.length,
+        conceptsLinked: linked,
+        durationMs: totalMs,
+        errors,
+        stats: { totalLines, mermaidDiagrams, seeAlsoFooters, crossSubsystemDeps },
+    };
+}
+//# sourceMappingURL=docs-pipeline.js.map

package/dist/docs/docs-pipeline.js.map

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

package/dist/docs/generation/page-generator.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Phase 3 — Page Generator
+ *
+ * Generates markdown pages from a DocPlan using type-specific templates.
+ * Each PageType has its own prompt template. Raw pages are generated first
+ * (data extraction), then optionally enriched by LLM.
+ */
+import { KnowledgeGraph } from '../../knowledge/knowledge-graph.js';
+import type { DocPage, DocPlan } from '../planning/plan-generator.js';
+import type { LLMCall } from '../llm-enricher.js';
+import type { DocsConfig } from '../config.js';
+export interface GeneratedPage {
+    page: DocPage;
+    content: string;
+    filePath: string;
+}
+export interface GenerationResult {
+    pages: GeneratedPage[];
+    errors: string[];
+    durationMs: number;
+}
+export declare function generatePages(plan: DocPlan, graph: KnowledgeGraph, config: DocsConfig, llmCall?: LLMCall, onProgress?: (page: string, current: number, total: number) => void, incremental?: boolean): Promise<GenerationResult>;