@esthernandez/vibe-doc 0.1.0

package/dist/generator/markdown-writer.js

@@ -0,0 +1,85 @@
+"use strict";
+/**
+ * Markdown Writer Module
+ * Writes rendered content to .md files with metadata headers
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeMarkdown = writeMarkdown;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const logger_1 = require("../utils/logger");
+/**
+ * Write rendered content to a markdown file with metadata header
+ * @param renderedContent - The rendered markdown content
+ * @param docType - Type of document (e.g., 'adr', 'runbook')
+ * @param projectPath - Root path of the project
+ * @param metadata - Document metadata
+ * @returns Full path to the written file
+ */
+function writeMarkdown(renderedContent, docType, projectPath, metadata) {
+    // Create docs/generated directory
+    const docsDir = path.join(projectPath, 'docs', 'generated');
+    if (!fs.existsSync(docsDir)) {
+        fs.mkdirSync(docsDir, { recursive: true });
+        logger_1.logger.debug('Created docs/generated directory', { path: docsDir });
+    }
+    // Generate metadata header comment
+    const metadataHeader = generateMetadataHeader(metadata, docType);
+    // Combine metadata header with content
+    const fullContent = metadataHeader + '\n\n' + renderedContent;
+    // Write to file
+    const outputPath = path.join(docsDir, `${docType}.md`);
+    fs.writeFileSync(outputPath, fullContent, 'utf-8');
+    logger_1.logger.info('Markdown written', {
+        docType,
+        path: outputPath,
+        size: fullContent.length,
+    });
+    return outputPath;
+}
+/**
+ * Generate the metadata header comment for a document
+ */
+function generateMetadataHeader(metadata, docType) {
+    const lines = [
+        '<!-- Generated by Vibe Doc v0.1.0 -->',
+        `<!-- Date: ${metadata.generatedAt} -->`,
+        `<!-- Classification: ${metadata.classification} -->`,
+        `<!-- Source artifacts: ${metadata.sourceArtifacts} files scanned -->`,
+        `<!-- Confidence: ${metadata.confidenceSummary.high} high, ${metadata.confidenceSummary.medium} medium, ${metadata.confidenceSummary.low} low sections -->`,
+    ];
+    return lines.join('\n');
+}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * Vibe Doc CLI
+ * Main entry point for documentation generation pipeline
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;GAGG"}

package/dist/index.js

@@ -0,0 +1,372 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * Vibe Doc CLI
+ * Main entry point for documentation generation pipeline
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const commander_1 = require("commander");
+const logger_1 = require("./utils/logger");
+const scanner_1 = require("./scanner");
+const state_1 = require("./state");
+const classifier_1 = require("./classifier");
+const gap_analyzer_1 = require("./gap-analyzer");
+const generator_1 = require("./generator");
+const templates_1 = require("./templates");
+const extractor_1 = require("./generator/extractor");
+const program = new commander_1.Command();
+program
+    .name('vibe-doc')
+    .description('AI-powered documentation gap analyzer for any codebase')
+    .version('0.1.0');
+/**
+ * Scan command: Run artifact scanner and save inventory
+ */
+program
+    .command('scan [projectPath]')
+    .description('Scan a project and analyze its artifacts')
+    .option('-c, --confidence-threshold <number>', 'Classification confidence threshold (0-1, default: 0.85)', '0.85')
+    .option('--profile <path>', 'Path to interview answers JSON file to populate project profile')
+    .action(async (projectPath, options) => {
+    const resolvedPath = projectPath ? path.resolve(projectPath) : process.cwd();
+    const confidenceThreshold = parseFloat(options.confidenceThreshold);
+    try {
+        logger_1.logger.info('Starting vibe-doc scan', { projectPath: resolvedPath });
+        // Initialize state
+        let state = (0, state_1.readState)(resolvedPath) || (0, state_1.initState)();
+        state.lastScan = new Date().toISOString();
+        // Load interview answers from profile if provided
+        if (options.profile) {
+            try {
+                const profilePath = path.resolve(options.profile);
+                const profileContent = fs.readFileSync(profilePath, 'utf-8');
+                const profileData = JSON.parse(profileContent);
+                // Populate interviewAnswers with provided data, using defaults for missing fields
+                state.projectProfile.interviewAnswers = {
+                    projectName: profileData.projectName || '',
+                    projectDescription: profileData.projectDescription || '',
+                    mainPurpose: profileData.mainPurpose || '',
+                    primaryUsers: profileData.primaryUsers || '',
+                    coreFeatures: profileData.coreFeatures || [],
+                    technologies: profileData.technologies || [],
+                    deploymentModel: profileData.deploymentModel || '',
+                    architectureStyle: profileData.architectureStyle || '',
+                };
+                // Set providedContext flag
+                state.projectProfile.providedContext = 'profile';
+                logger_1.logger.info('Loaded interview answers from profile', { path: profilePath });
+            }
+            catch (error) {
+                logger_1.logger.warn('Failed to load profile file', { path: options.profile, error });
+                // Continue without profile data - not a fatal error
+            }
+        }
+        // Run scanner
+        logger_1.logger.info('Running artifact inventory scan...');
+        state.artifactInventory = await (0, scanner_1.scan)(resolvedPath);
+        // Run classifier
+        logger_1.logger.info('Running hybrid classification...');
+        const classificationResult = (0, classifier_1.classify)(state.artifactInventory, { confidenceThreshold });
+        if (classificationResult.resolved) {
+            state.classification = classificationResult.classification;
+            logger_1.logger.info('Classification complete', {
+                category: state.classification.primaryCategory,
+                confidence: state.classification.confidence,
+            });
+        }
+        else {
+            // Low confidence - use best candidate classification with LLM review available
+            state.classification = classificationResult.classification;
+            logger_1.logger.info('Low confidence classification, LLM prompt available', {
+                category: state.classification.primaryCategory,
+                confidence: state.classification.confidence,
+            });
+        }
+        // Run gap analyzer
+        logger_1.logger.info('Running gap analyzer...');
+        state.gapReport = (0, gap_analyzer_1.analyzeGaps)(state.classification, state.artifactInventory);
+        // Save state
+        (0, state_1.writeState)(resolvedPath, state);
+        logger_1.logger.info('Scan complete', {
+            category: state.classification.primaryCategory,
+            docsCovered: state.gapReport.summary.docsCovered,
+            docsMissing: state.gapReport.summary.docsMissing,
+            coverage: `${state.gapReport.summary.coveragePercent}%`,
+        });
+        // Output summary
+        console.log('\n=== Vibe Doc Scan Complete ===\n');
+        console.log(`Project: ${resolvedPath}`);
+        console.log(`Category: ${state.classification.primaryCategory}`);
+        console.log(`Confidence: ${(state.classification.confidence * 100).toFixed(0)}%`);
+        console.log(`\nDocumentation Coverage: ${state.gapReport.summary.coveragePercent}%`);
+        console.log(`  Covered: ${state.gapReport.summary.docsCovered}`);
+        console.log(`  Partial: ${state.gapReport.summary.docsPartial}`);
+        console.log(`  Missing: ${state.gapReport.summary.docsMissing}`);
+        console.log(`\nState saved to: ${path.join(resolvedPath, '.vibe-doc', 'state.json')}\n`);
+    }
+    catch (error) {
+        logger_1.logger.error('Scan failed', { error });
+        process.exit(1);
+    }
+});
+/**
+ * Report command: Display gap analysis report
+ */
+program
+    .command('report [projectPath]')
+    .description('Display documentation gap report')
+    .action((projectPath) => {
+    const resolvedPath = projectPath ? path.resolve(projectPath) : process.cwd();
+    try {
+        const state = (0, state_1.readState)(resolvedPath);
+        if (!state) {
+            console.error('No vibe-doc state found. Run "vibe-doc scan" first.');
+            process.exit(1);
+        }
+        console.log('\n=== Documentation Gap Report ===\n');
+        console.log(`Category: ${state.classification.primaryCategory}`);
+        console.log(`Confidence: ${(state.classification.confidence * 100).toFixed(0)}%`);
+        console.log(`\nGaps by Tier:\n`);
+        const byTier = {
+            required: [],
+            recommended: [],
+            optional: [],
+        };
+        for (const gap of state.gapReport.gaps) {
+            if (!byTier[gap.tier]) {
+                byTier[gap.tier] = [];
+            }
+            byTier[gap.tier].push(gap);
+        }
+        for (const tier of ['required', 'recommended', 'optional']) {
+            const gaps = byTier[tier];
+            if (gaps.length > 0) {
+                console.log(`${tier.toUpperCase()}:`);
+                for (const gap of gaps) {
+                    const status = gap.found === 0 ? '❌' : gap.missing === 0 ? '✅' : '⚠️';
+                    console.log(`  ${status} ${gap.docType}`);
+                    console.log(`     ${gap.rationale}`);
+                }
+                console.log();
+            }
+        }
+        console.log(`Coverage: ${state.gapReport.summary.coveragePercent}%\n`);
+    }
+    catch (error) {
+        logger_1.logger.error('Report failed', { error });
+        process.exit(1);
+    }
+});
+/**
+ * Status command: Check current state
+ */
+program
+    .command('status [projectPath]')
+    .description('Check vibe-doc status')
+    .action((projectPath) => {
+    const resolvedPath = projectPath ? path.resolve(projectPath) : process.cwd();
+    try {
+        const state = (0, state_1.readState)(resolvedPath);
+        if (!state) {
+            console.log('No vibe-doc state found. Run "vibe-doc scan" to initialize.');
+            return;
+        }
+        console.log('\n=== Vibe Doc Status ===\n');
+        console.log(`Last scan: ${new Date(state.lastScan).toLocaleString()}`);
+        console.log(`Artifacts: ${state.artifactInventory.totalArtifacts}`);
+        console.log(`Category: ${state.classification.primaryCategory}`);
+        console.log(`Coverage: ${state.gapReport.summary.coveragePercent}% (${state.gapReport.summary.docsCovered} covered, ${state.gapReport.summary.docsMissing} missing)\n`);
+    }
+    catch (error) {
+        logger_1.logger.error('Status check failed', { error });
+        process.exit(1);
+    }
+});
+/**
+ * Confirm command: Mark classification as user-confirmed
+ */
+program
+    .command('confirm [projectPath]')
+    .description('Confirm the classification and mark as approved by user')
+    .action((projectPath) => {
+    const resolvedPath = projectPath ? path.resolve(projectPath) : process.cwd();
+    try {
+        const state = (0, state_1.readState)(resolvedPath);
+        if (!state) {
+            console.error('No vibe-doc state found. Run "vibe-doc scan" first.');
+            process.exit(1);
+        }
+        state.classification.userConfirmed = true;
+        (0, state_1.writeState)(resolvedPath, state);
+        logger_1.logger.info('Classification confirmed', {
+            category: state.classification.primaryCategory,
+        });
+        console.log('\n=== Classification Confirmed ===\n');
+        console.log(`Category "${state.classification.primaryCategory}" has been confirmed by user.\n`);
+    }
+    catch (error) {
+        logger_1.logger.error('Confirmation failed', { error });
+        process.exit(1);
+    }
+});
+/**
+ * Check command: CI-safe documentation check
+ */
+program
+    .command('check [projectPath]')
+    .description('CI-safe documentation check')
+    .option('-t, --threshold <commits>', 'Staleness threshold in commits', '20')
+    .action(async (projectPath, options) => {
+    const resolvedPath = projectPath ? path.resolve(projectPath) : process.cwd();
+    const threshold = parseInt(options.threshold, 10);
+    try {
+        const { runCheck } = await Promise.resolve().then(() => __importStar(require('./checker')));
+        const result = await runCheck(resolvedPath, { threshold });
+        console.log('\n=== Documentation Check ===\n');
+        console.log(result.details);
+        console.log();
+        if (!result.pass) {
+            process.exit(result.exitCode);
+        }
+    }
+    catch (error) {
+        logger_1.logger.error('Check failed', { error });
+        process.exit(1);
+    }
+});
+/**
+ * Generate command: Generate a document from template
+ */
+program
+    .command('generate <docType> [projectPath]')
+    .description('Generate a document from template')
+    .option('-f, --format <format>', 'Output format: md, docx, or both', 'both')
+    .option('-a, --answers <answers.json>', 'Path to answers JSON file')
+    .action(async (docType, projectPath, options) => {
+    const resolvedPath = projectPath ? path.resolve(projectPath) : process.cwd();
+    const format = options.format;
+    try {
+        logger_1.logger.info('Starting document generation', { docType, format });
+        // Read state
+        const state = (0, state_1.readState)(resolvedPath);
+        if (!state) {
+            console.error('No vibe-doc state found. Run "vibe-doc scan" first.');
+            process.exit(1);
+        }
+        // Load answers if provided
+        let userAnswers = {};
+        if (options.answers) {
+            const answersPath = path.resolve(options.answers);
+            try {
+                const content = fs.readFileSync(answersPath, 'utf-8');
+                userAnswers = JSON.parse(content);
+                logger_1.logger.debug('Loaded user answers', { path: answersPath });
+            }
+            catch (error) {
+                logger_1.logger.warn('Failed to load answers file', { path: answersPath, error });
+            }
+        }
+        // Extract data from artifacts
+        const extractedData = (0, extractor_1.extractDataForDocType)(docType, state, resolvedPath);
+        // Build render data
+        const renderData = {
+            extracted: extractedData,
+            user: userAnswers,
+            metadata: {
+                docType,
+                generatedAt: new Date().toISOString(),
+                classification: state.classification.primaryCategory,
+                sourceArtifacts: state.artifactInventory.totalArtifacts,
+            },
+        };
+        // Generate document
+        const result = await (0, generator_1.generateDocument)(docType, resolvedPath, state, renderData, format);
+        // Save updated state
+        (0, state_1.writeState)(resolvedPath, state);
+        // Output summary
+        console.log('\n=== Document Generated ===\n');
+        console.log(`Document: ${docType}`);
+        console.log(`Version: ${result.version}`);
+        console.log(`Format(s): ${format}`);
+        console.log(`\nGenerated files:`);
+        for (const filePath of result.paths) {
+            console.log(`  ${filePath}`);
+        }
+        console.log();
+    }
+    catch (error) {
+        logger_1.logger.error('Generation failed', { error });
+        process.exit(1);
+    }
+});
+/**
+ * Templates command group: Manage document templates
+ */
+const templatesCmd = program.command('templates').description('Manage document templates');
+templatesCmd
+    .command('list')
+    .description('List all available document templates')
+    .action(() => {
+    try {
+        const embeddedTemplates = (0, templates_1.listTemplates)();
+        const cacheDir = path.join(process.cwd(), '.vibe-doc');
+        const cachedPath = path.join(cacheDir, 'templates');
+        console.log('\n=== Available Templates ===\n');
+        console.log('EMBEDDED (Built-in):');
+        for (const template of embeddedTemplates) {
+            console.log(`  • ${template}`);
+        }
+        // Check for cached remote templates
+        if (fs.existsSync(cachedPath)) {
+            const cachedFiles = fs.readdirSync(cachedPath).filter((f) => f.endsWith('.md'));
+            const cachedTemplates = cachedFiles.map((f) => f.replace(/\.md$/, ''));
+            const remoteOnly = cachedTemplates.filter((t) => !embeddedTemplates.includes(t));
+            if (remoteOnly.length > 0) {
+                console.log('\nREMOTE (Cached):');
+                for (const template of remoteOnly) {
+                    console.log(`  • ${template}`);
+                }
+            }
+        }
+    }
+    catch (error) {
+        logger_1.logger.error('Template list failed', { error });
+        process.exit(1);
+    }
+});
+program.parse(process.argv);

package/dist/scanner/artifact-scanner.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Artifact Scanner
+ * Reads artifact files and extracts summaries and metadata
+ */
+interface ArtifactMetadata {
+    path: string;
+    type: 'markdown' | 'skill' | 'config';
+    summary: string;
+    title?: string;
+}
+/**
+ * Enriches artifact files with summaries and metadata
+ */
+export declare function enrichArtifacts(markdownFiles: string[], skillFiles: string[], configFiles: string[]): Promise<ArtifactMetadata[]>;
+export {};
+//# sourceMappingURL=artifact-scanner.d.ts.map

package/dist/scanner/artifact-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-scanner.d.ts","sourceRoot":"","sources":["../../src/scanner/artifact-scanner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,UAAU,gBAAgB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAyID;;GAEG;AACH,wBAAsB,eAAe,CACnC,aAAa,EAAE,MAAM,EAAE,EACvB,UAAU,EAAE,MAAM,EAAE,EACpB,WAAW,EAAE,MAAM,EAAE,GACpB,OAAO,CAAC,gBAAgB,EAAE,CAAC,CA8B7B"}

package/dist/scanner/artifact-scanner.js

@@ -0,0 +1,189 @@
+"use strict";
+/**
+ * Artifact Scanner
+ * Reads artifact files and extracts summaries and metadata
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.enrichArtifacts = enrichArtifacts;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const logger_1 = require("../utils/logger");
+const YAML_FRONTMATTER_REGEX = /^---\n([\s\S]*?)\n---/;
+/**
+ * Extracts YAML frontmatter from a file
+ */
+function extractYamlFrontmatter(content) {
+    const match = content.match(YAML_FRONTMATTER_REGEX);
+    if (!match) {
+        return null;
+    }
+    const yamlContent = match[1];
+    const result = {};
+    const lines = yamlContent.split('\n').filter((line) => line.trim());
+    for (const line of lines) {
+        const [key, ...valueParts] = line.split(':');
+        const value = valueParts.join(':').trim();
+        if (key && value) {
+            result[key.trim()] = value;
+        }
+    }
+    return result;
+}
+/**
+ * Extracts first meaningful paragraph from markdown content
+ */
+function extractMarkdownSummary(content, maxChars = 200) {
+    // Remove frontmatter
+    const withoutFrontmatter = content.replace(YAML_FRONTMATTER_REGEX, '').trim();
+    // Get lines and skip empty ones
+    const lines = withoutFrontmatter.split('\n').filter((line) => line.trim().length > 0);
+    let summary = '';
+    for (const line of lines) {
+        // Skip headers, code blocks, etc.
+        if (line.startsWith('#') || line.startsWith('```') || line.startsWith('    ')) {
+            continue;
+        }
+        summary += (summary ? ' ' : '') + line.trim();
+        if (summary.length >= maxChars) {
+            break;
+        }
+    }
+    return summary.substring(0, maxChars).trim();
+}
+/**
+ * Reads markdown artifact and returns metadata
+ */
+async function readMarkdownArtifact(filePath) {
+    try {
+        const content = fs.readFileSync(filePath, 'utf-8');
+        // Extract first header as title
+        const titleMatch = content.match(/^#\s+(.+?)$/m);
+        const title = titleMatch ? titleMatch[1].trim() : undefined;
+        // Extract summary
+        const summary = extractMarkdownSummary(content);
+        return {
+            path: filePath,
+            type: 'markdown',
+            summary,
+            title,
+        };
+    }
+    catch (error) {
+        logger_1.logger.warn('Failed to read markdown artifact', { path: filePath, error });
+        return {
+            path: filePath,
+            type: 'markdown',
+            summary: '',
+        };
+    }
+}
+/**
+ * Reads skill artifact and returns metadata from YAML frontmatter
+ */
+async function readSkillArtifact(filePath) {
+    try {
+        const content = fs.readFileSync(filePath, 'utf-8');
+        const frontmatter = extractYamlFrontmatter(content);
+        const title = frontmatter?.name || path.basename(filePath);
+        const summary = frontmatter?.description || '';
+        return {
+            path: filePath,
+            type: 'skill',
+            summary,
+            title,
+        };
+    }
+    catch (error) {
+        logger_1.logger.warn('Failed to read skill artifact', { path: filePath, error });
+        return {
+            path: filePath,
+            type: 'skill',
+            summary: '',
+        };
+    }
+}
+/**
+ * Reads config-as-docs artifact
+ */
+async function readConfigArtifact(filePath) {
+    try {
+        const content = fs.readFileSync(filePath, 'utf-8');
+        const summary = extractMarkdownSummary(content, 300);
+        const title = path.basename(filePath);
+        return {
+            path: filePath,
+            type: 'config',
+            summary,
+            title,
+        };
+    }
+    catch (error) {
+        logger_1.logger.warn('Failed to read config artifact', { path: filePath, error });
+        return {
+            path: filePath,
+            type: 'config',
+            summary: '',
+        };
+    }
+}
+/**
+ * Enriches artifact files with summaries and metadata
+ */
+async function enrichArtifacts(markdownFiles, skillFiles, configFiles) {
+    logger_1.logger.debug('Starting artifact enrichment', {
+        markdownCount: markdownFiles.length,
+        skillCount: skillFiles.length,
+        configCount: configFiles.length,
+    });
+    const allMetadata = [];
+    // Process markdown files
+    for (const file of markdownFiles) {
+        const metadata = await readMarkdownArtifact(file);
+        allMetadata.push(metadata);
+    }
+    // Process skill files
+    for (const file of skillFiles) {
+        const metadata = await readSkillArtifact(file);
+        allMetadata.push(metadata);
+    }
+    // Process config files
+    for (const file of configFiles) {
+        const metadata = await readConfigArtifact(file);
+        allMetadata.push(metadata);
+    }
+    logger_1.logger.info('Artifact enrichment completed', { total: allMetadata.length });
+    return allMetadata;
+}