@theglitchking/hit-em-with-the-docs 2.0.0

package/dist/core/links/tracker.js

@@ -0,0 +1,184 @@
+import { readFile } from 'fs/promises';
+import { relative, dirname, resolve } from 'path';
+import { findMarkdownFiles } from '../../utils/glob.js';
+import { extractLinks } from '../../utils/markdown.js';
+import { detectDomainFromPath } from '../domains/detector.js';
+import { DOMAINS } from '../domains/constants.js';
+/**
+ * Build a complete link graph for the documentation
+ */
+export async function buildLinkGraph(docsPath) {
+    const files = await findMarkdownFiles(docsPath);
+    const nodes = new Map();
+    const edges = [];
+    // First pass: create nodes
+    for (const file of files) {
+        const relPath = relative(docsPath, file);
+        const domain = detectDomainFromPath(file, docsPath).domain;
+        nodes.set(relPath, {
+            id: relPath,
+            path: relPath,
+            domain,
+            inDegree: 0,
+            outDegree: 0,
+        });
+    }
+    // Second pass: find edges and update degrees
+    for (const file of files) {
+        const content = await readFile(file, 'utf-8');
+        const links = extractLinks(content);
+        const relPath = relative(docsPath, file);
+        const fileDir = dirname(file);
+        for (const link of links) {
+            if (link.isInternal) {
+                // Resolve the link
+                const pathPart = link.url.split('#')[0] ?? '';
+                if (!pathPart)
+                    continue;
+                let targetPath;
+                if (pathPart.startsWith('/')) {
+                    targetPath = pathPart.slice(1);
+                }
+                else {
+                    targetPath = relative(docsPath, resolve(fileDir, pathPart));
+                }
+                // Normalize path separators
+                targetPath = targetPath.replace(/\\/g, '/');
+                if (nodes.has(targetPath)) {
+                    edges.push({
+                        source: relPath,
+                        target: targetPath,
+                        linkText: link.text,
+                        lineNumber: link.lineNumber,
+                    });
+                    // Update degrees
+                    const sourceNode = nodes.get(relPath);
+                    const targetNode = nodes.get(targetPath);
+                    if (sourceNode)
+                        sourceNode.outDegree++;
+                    if (targetNode)
+                        targetNode.inDegree++;
+                }
+            }
+        }
+    }
+    return {
+        nodes: [...nodes.values()],
+        edges,
+    };
+}
+/**
+ * Build a domain connection matrix showing how domains link to each other
+ */
+export async function buildDomainConnectionMatrix(docsPath) {
+    const graph = await buildLinkGraph(docsPath);
+    // Initialize matrix
+    const matrix = DOMAINS.map(() => DOMAINS.map(() => 0));
+    let totalConnections = 0;
+    // Count connections between domains
+    for (const edge of graph.edges) {
+        const sourceNode = graph.nodes.find((n) => n.id === edge.source);
+        const targetNode = graph.nodes.find((n) => n.id === edge.target);
+        if (sourceNode?.domain && targetNode?.domain) {
+            const sourceIdx = DOMAINS.indexOf(sourceNode.domain);
+            const targetIdx = DOMAINS.indexOf(targetNode.domain);
+            if (sourceIdx !== -1 && targetIdx !== -1) {
+                matrix[sourceIdx][targetIdx]++;
+                totalConnections++;
+            }
+        }
+    }
+    return {
+        domains: [...DOMAINS],
+        matrix,
+        totalConnections,
+    };
+}
+/**
+ * Get top connected domain pairs
+ */
+export async function getTopConnectedDomains(docsPath, limit = 10) {
+    const { domains, matrix } = await buildDomainConnectionMatrix(docsPath);
+    const connections = [];
+    for (let i = 0; i < domains.length; i++) {
+        for (let j = 0; j < domains.length; j++) {
+            const count = matrix[i][j] ?? 0;
+            if (count > 0) {
+                connections.push({
+                    from: domains[i],
+                    to: domains[j],
+                    count,
+                });
+            }
+        }
+    }
+    return connections
+        .sort((a, b) => b.count - a.count)
+        .slice(0, limit);
+}
+/**
+ * Get backlinks for a specific file
+ */
+export async function getBacklinks(targetFile, docsPath) {
+    const graph = await buildLinkGraph(docsPath);
+    const targetPath = relative(docsPath, targetFile).replace(/\\/g, '/');
+    return graph.edges
+        .filter((e) => e.target === targetPath)
+        .map((e) => ({
+        source: e.source,
+        linkText: e.linkText,
+        lineNumber: e.lineNumber,
+    }));
+}
+/**
+ * Find orphan files (files with no incoming links)
+ */
+export async function findOrphanFiles(docsPath) {
+    const graph = await buildLinkGraph(docsPath);
+    return graph.nodes
+        .filter((n) => n.inDegree === 0)
+        .filter((n) => {
+        // Exclude index files
+        const name = n.path.split('/').pop() ?? '';
+        return !['INDEX.md', 'REGISTRY.md', 'README.md'].includes(name);
+    })
+        .map((n) => n.path);
+}
+/**
+ * Find highly connected files (hubs)
+ */
+export async function findHubFiles(docsPath, minDegree = 5) {
+    const graph = await buildLinkGraph(docsPath);
+    return graph.nodes
+        .filter((n) => n.inDegree >= minDegree || n.outDegree >= minDegree)
+        .sort((a, b) => (b.inDegree + b.outDegree) - (a.inDegree + a.outDegree));
+}
+/**
+ * Get link statistics summary
+ */
+export async function getLinkStatistics(docsPath) {
+    const graph = await buildLinkGraph(docsPath);
+    const totalInDegree = graph.nodes.reduce((sum, n) => sum + n.inDegree, 0);
+    const totalOutDegree = graph.nodes.reduce((sum, n) => sum + n.outDegree, 0);
+    const orphans = graph.nodes.filter((n) => n.inDegree === 0).length;
+    const hubs = graph.nodes.filter((n) => n.inDegree >= 5 || n.outDegree >= 5).length;
+    // Count cross-domain edges
+    let crossDomainEdges = 0;
+    for (const edge of graph.edges) {
+        const sourceNode = graph.nodes.find((n) => n.id === edge.source);
+        const targetNode = graph.nodes.find((n) => n.id === edge.target);
+        if (sourceNode?.domain && targetNode?.domain && sourceNode.domain !== targetNode.domain) {
+            crossDomainEdges++;
+        }
+    }
+    return {
+        totalNodes: graph.nodes.length,
+        totalEdges: graph.edges.length,
+        avgInDegree: graph.nodes.length > 0 ? totalInDegree / graph.nodes.length : 0,
+        avgOutDegree: graph.nodes.length > 0 ? totalOutDegree / graph.nodes.length : 0,
+        orphanCount: orphans,
+        hubCount: hubs,
+        crossDomainPercentage: graph.edges.length > 0 ? (crossDomainEdges / graph.edges.length) * 100 : 0,
+    };
+}
+//# sourceMappingURL=tracker.js.map

package/dist/core/links/tracker.js.map

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

package/dist/core/maintain/orchestrator.d.ts

@@ -0,0 +1,39 @@
+import { type SyncResult } from '../metadata/sync.js';
+import { type LinkCheckResult } from '../links/checker.js';
+import { type AuditResult } from '../audit/auditor.js';
+export interface MaintainOptions {
+    docsPath: string;
+    quick?: boolean;
+    fix?: boolean;
+    silent?: boolean;
+}
+export interface MaintainResult {
+    success: boolean;
+    domainHealth: DomainHealthResult;
+    metadataSync?: SyncResult;
+    linkCheck?: LinkCheckResult;
+    audit?: AuditResult;
+    healthScore: number;
+    reportPath?: string;
+    errors: string[];
+}
+export interface DomainHealthResult {
+    healthy: boolean;
+    presentDomains: string[];
+    missingDomains: string[];
+    missingIndexes: string[];
+    missingRegistries: string[];
+}
+/**
+ * Run full maintenance on documentation
+ */
+export declare function runMaintenance(options: MaintainOptions): Promise<MaintainResult>;
+/**
+ * Quick health check without full maintenance
+ */
+export declare function quickHealthCheck(docsPath: string): Promise<{
+    healthy: boolean;
+    score: number;
+    issues: string[];
+}>;
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/core/maintain/orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../../src/core/maintain/orchestrator.ts"],"names":[],"mappings":"AAIA,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAc,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAAsB,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAI3E,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,kBAAkB,CAAC;IACjC,YAAY,CAAC,EAAE,UAAU,CAAC;IAC1B,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CA0JtF;AA4OD;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAChE,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC,CAoBD"}

package/dist/core/maintain/orchestrator.js

@@ -0,0 +1,372 @@
+import { join } from 'path';
+import { writeFile, mkdir } from 'fs/promises';
+import { logger } from '../../utils/logger.js';
+import { pathExists } from '../../utils/glob.js';
+import { syncMetadata } from '../metadata/sync.js';
+import { checkLinks } from '../links/checker.js';
+import { auditDocumentation } from '../audit/auditor.js';
+import { DOMAINS } from '../domains/constants.js';
+import { formatDate } from '../metadata/generator.js';
+/**
+ * Run full maintenance on documentation
+ */
+export async function runMaintenance(options) {
+    const { docsPath, quick = false, fix = false, silent = false, } = options;
+    const result = {
+        success: true,
+        domainHealth: {
+            healthy: true,
+            presentDomains: [],
+            missingDomains: [],
+            missingIndexes: [],
+            missingRegistries: [],
+        },
+        healthScore: 0,
+        errors: [],
+    };
+    const startTime = Date.now();
+    if (!silent) {
+        logger.header('Documentation Maintenance');
+        logger.info(`Mode: ${quick ? 'Quick' : 'Full'}${fix ? ' (Auto-fix)' : ''}`);
+        logger.info(`Path: ${docsPath}`);
+    }
+    // Step 0: Domain Health Check
+    if (!silent) {
+        logger.subheader('Step 0: Domain Health Check');
+    }
+    result.domainHealth = await checkDomainHealth(docsPath);
+    if (!silent) {
+        if (result.domainHealth.healthy) {
+            logger.success(`All ${result.domainHealth.presentDomains.length} domains healthy`);
+        }
+        else {
+            logger.warn(`Domain issues found:`);
+            if (result.domainHealth.missingDomains.length > 0) {
+                logger.warn(`  Missing domains: ${result.domainHealth.missingDomains.join(', ')}`);
+            }
+            if (result.domainHealth.missingIndexes.length > 0) {
+                logger.warn(`  Missing INDEX.md: ${result.domainHealth.missingIndexes.join(', ')}`);
+            }
+            if (result.domainHealth.missingRegistries.length > 0) {
+                logger.warn(`  Missing REGISTRY.md: ${result.domainHealth.missingRegistries.join(', ')}`);
+            }
+        }
+    }
+    // Step 1: Metadata Sync
+    if (!silent) {
+        logger.subheader('Step 1: Metadata Sync');
+    }
+    try {
+        result.metadataSync = await syncMetadata({
+            docsPath,
+            dryRun: !fix,
+            fix,
+            silent,
+        });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        result.errors.push(`Metadata sync failed: ${message}`);
+        result.success = false;
+    }
+    // Step 2: Link Check (skip in quick mode)
+    if (!quick) {
+        if (!silent) {
+            logger.subheader('Step 2: Link Check');
+        }
+        try {
+            result.linkCheck = await checkLinks({
+                docsPath,
+                silent,
+            });
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            result.errors.push(`Link check failed: ${message}`);
+        }
+    }
+    else if (!silent) {
+        logger.info('Step 2: Link Check (SKIPPED - quick mode)');
+    }
+    // Step 3: Documentation Audit
+    if (!silent) {
+        logger.subheader('Step 3: Documentation Audit');
+    }
+    try {
+        result.audit = await auditDocumentation({
+            docsPath,
+            silent,
+        });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        result.errors.push(`Audit failed: ${message}`);
+    }
+    // Calculate overall health score
+    result.healthScore = calculateHealthScore(result);
+    // Generate report
+    if (!silent) {
+        logger.subheader('Step 4: Generate Report');
+    }
+    try {
+        result.reportPath = await generateMaintenanceReport(docsPath, result, startTime);
+        if (!silent) {
+            logger.success(`Report saved: ${result.reportPath}`);
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        result.errors.push(`Report generation failed: ${message}`);
+    }
+    // Summary
+    if (!silent) {
+        const duration = ((Date.now() - startTime) / 1000).toFixed(1);
+        logger.newline();
+        logger.header('Maintenance Summary');
+        logger.info(`Duration: ${duration}s`);
+        logger.info(`Health Score: ${result.healthScore.toFixed(1)}/100`);
+        if (result.metadataSync) {
+            logger.info(`Files: ${result.metadataSync.totalFiles}`);
+            if (fix) {
+                logger.info(`Fixed: ${result.metadataSync.fixedFiles}`);
+            }
+        }
+        if (result.linkCheck) {
+            logger.info(`Links: ${result.linkCheck.totalLinks} (${result.linkCheck.brokenLinks.length} broken)`);
+        }
+        if (result.audit) {
+            const errors = result.audit.issues.filter((i) => i.severity === 'error').length;
+            const warnings = result.audit.issues.filter((i) => i.severity === 'warning').length;
+            logger.info(`Issues: ${errors} errors, ${warnings} warnings`);
+        }
+        if (result.errors.length > 0) {
+            logger.warn(`Errors: ${result.errors.length}`);
+        }
+    }
+    return result;
+}
+/**
+ * Check domain health (folders, index files, registry files)
+ */
+async function checkDomainHealth(docsPath) {
+    const result = {
+        healthy: true,
+        presentDomains: [],
+        missingDomains: [],
+        missingIndexes: [],
+        missingRegistries: [],
+    };
+    for (const domain of DOMAINS) {
+        const domainPath = join(docsPath, domain);
+        const indexPath = join(domainPath, 'INDEX.md');
+        const registryPath = join(domainPath, 'REGISTRY.md');
+        const domainExists = await pathExists(domainPath);
+        const indexExists = await pathExists(indexPath);
+        const registryExists = await pathExists(registryPath);
+        if (!domainExists) {
+            result.missingDomains.push(domain);
+            result.healthy = false;
+        }
+        else {
+            result.presentDomains.push(domain);
+            if (!indexExists) {
+                result.missingIndexes.push(domain);
+                result.healthy = false;
+            }
+            if (!registryExists) {
+                result.missingRegistries.push(domain);
+                result.healthy = false;
+            }
+        }
+    }
+    return result;
+}
+/**
+ * Calculate overall health score
+ */
+function calculateHealthScore(result) {
+    let score = 100;
+    // Domain health penalty
+    if (!result.domainHealth.healthy) {
+        const missingCount = result.domainHealth.missingDomains.length +
+            result.domainHealth.missingIndexes.length +
+            result.domainHealth.missingRegistries.length;
+        score -= missingCount * 2;
+    }
+    // Metadata compliance
+    if (result.metadataSync) {
+        const complianceRate = result.metadataSync.validFiles / result.metadataSync.totalFiles;
+        score = score * 0.7 + complianceRate * 30;
+    }
+    // Link health
+    if (result.linkCheck) {
+        const brokenRate = result.linkCheck.brokenLinks.length / Math.max(result.linkCheck.totalLinks, 1);
+        score -= brokenRate * 20;
+    }
+    // Audit score
+    if (result.audit) {
+        score = score * 0.7 + result.audit.healthScore * 0.3;
+    }
+    return Math.max(0, Math.min(100, score));
+}
+/**
+ * Generate maintenance report
+ */
+async function generateMaintenanceReport(docsPath, result, startTime) {
+    const now = formatDate(new Date());
+    const timestamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, 19);
+    const duration = ((Date.now() - startTime) / 1000).toFixed(1);
+    let content = `---
+title: Maintenance Report - ${now}
+tier: admin
+domains: [root]
+status: active
+last_updated: '${now}'
+version: '1.0.0'
+---
+
+# Maintenance Report
+
+**Generated:** ${new Date().toISOString()}
+**Duration:** ${duration}s
+**Health Score:** ${result.healthScore.toFixed(1)}/100
+
+## Summary
+
+| Metric | Value |
+|--------|-------|
+| Overall Health | ${result.healthScore.toFixed(1)}% |
+| Domain Health | ${result.domainHealth.healthy ? 'Healthy' : 'Issues Found'} |
+| Files Scanned | ${result.metadataSync?.totalFiles ?? 0} |
+| Valid Files | ${result.metadataSync?.validFiles ?? 0} |
+| Broken Links | ${result.linkCheck?.brokenLinks.length ?? 'Not checked'} |
+| Audit Issues | ${result.audit?.issues.length ?? 0} |
+
+## Domain Health
+
+`;
+    if (result.domainHealth.healthy) {
+        content += `All ${result.domainHealth.presentDomains.length} domains are healthy.\n\n`;
+    }
+    else {
+        if (result.domainHealth.missingDomains.length > 0) {
+            content += `### Missing Domains\n\n`;
+            content += result.domainHealth.missingDomains.map((d) => `- ${d}`).join('\n');
+            content += '\n\n';
+        }
+        if (result.domainHealth.missingIndexes.length > 0) {
+            content += `### Missing INDEX.md Files\n\n`;
+            content += result.domainHealth.missingIndexes.map((d) => `- ${d}/INDEX.md`).join('\n');
+            content += '\n\n';
+        }
+        if (result.domainHealth.missingRegistries.length > 0) {
+            content += `### Missing REGISTRY.md Files\n\n`;
+            content += result.domainHealth.missingRegistries.map((d) => `- ${d}/REGISTRY.md`).join('\n');
+            content += '\n\n';
+        }
+    }
+    if (result.metadataSync) {
+        content += `## Metadata Sync
+
+| Metric | Value |
+|--------|-------|
+| Total Files | ${result.metadataSync.totalFiles} |
+| Valid | ${result.metadataSync.validFiles} |
+| Fixed | ${result.metadataSync.fixedFiles} |
+| Errors | ${result.metadataSync.errors.length} |
+| Avg Completeness | ${result.metadataSync.stats.avgCompleteness.toFixed(1)}% |
+
+`;
+    }
+    if (result.linkCheck) {
+        content += `## Link Check
+
+| Metric | Value |
+|--------|-------|
+| Total Links | ${result.linkCheck.totalLinks} |
+| Valid Links | ${result.linkCheck.validLinks} |
+| Broken Links | ${result.linkCheck.brokenLinks.length} |
+| Cross-Domain | ${result.linkCheck.stats.crossDomainLinks} |
+
+`;
+        if (result.linkCheck.brokenLinks.length > 0) {
+            content += `### Broken Links\n\n`;
+            content += `| File | Target | Line |\n`;
+            content += `|------|--------|------|\n`;
+            for (const link of result.linkCheck.brokenLinks.slice(0, 20)) {
+                content += `| ${link.sourceFile} | ${link.targetPath} | ${link.lineNumber} |\n`;
+            }
+            if (result.linkCheck.brokenLinks.length > 20) {
+                content += `\n*...and ${result.linkCheck.brokenLinks.length - 20} more*\n`;
+            }
+            content += '\n';
+        }
+    }
+    if (result.audit) {
+        content += `## Audit Results
+
+| Metric | Value |
+|--------|-------|
+| Passed Files | ${result.audit.passedFiles} |
+| Failed Files | ${result.audit.failedFiles} |
+| Health Score | ${result.audit.healthScore.toFixed(1)}% |
+| Metadata Compliance | ${result.audit.stats.metadataCompliance.toFixed(1)}% |
+| Naming Compliance | ${result.audit.stats.namingCompliance.toFixed(1)}% |
+
+`;
+        const errorIssues = result.audit.issues.filter((i) => i.severity === 'error');
+        if (errorIssues.length > 0) {
+            content += `### Critical Issues\n\n`;
+            for (const issue of errorIssues.slice(0, 10)) {
+                content += `- **${issue.file}**: ${issue.message}\n`;
+            }
+            if (errorIssues.length > 10) {
+                content += `\n*...and ${errorIssues.length - 10} more errors*\n`;
+            }
+            content += '\n';
+        }
+    }
+    if (result.errors.length > 0) {
+        content += `## Errors
+
+`;
+        for (const error of result.errors) {
+            content += `- ${error}\n`;
+        }
+    }
+    content += `
+---
+
+*Generated by hit-em-with-the-docs*
+`;
+    // Save report
+    const reportsDir = join(docsPath, 'reports');
+    if (!(await pathExists(reportsDir))) {
+        await mkdir(reportsDir, { recursive: true });
+    }
+    const reportPath = join(reportsDir, `maintenance-${timestamp}.md`);
+    await writeFile(reportPath, content, 'utf-8');
+    return reportPath;
+}
+/**
+ * Quick health check without full maintenance
+ */
+export async function quickHealthCheck(docsPath) {
+    const domainHealth = await checkDomainHealth(docsPath);
+    const issues = [];
+    if (!domainHealth.healthy) {
+        if (domainHealth.missingDomains.length > 0) {
+            issues.push(`Missing domains: ${domainHealth.missingDomains.join(', ')}`);
+        }
+        if (domainHealth.missingIndexes.length > 0) {
+            issues.push(`Missing INDEX.md in: ${domainHealth.missingIndexes.join(', ')}`);
+        }
+    }
+    const score = domainHealth.healthy ? 100 : 100 - issues.length * 10;
+    return {
+        healthy: issues.length === 0,
+        score: Math.max(0, score),
+        issues,
+    };
+}
+//# sourceMappingURL=orchestrator.js.map

package/dist/core/maintain/orchestrator.js.map

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

package/dist/core/metadata/generator.d.ts

@@ -0,0 +1,26 @@
+import type { DocumentMetadata, PartialDocumentMetadata } from './schema.js';
+export interface GeneratorOptions {
+    filePath: string;
+    content: string;
+    docsRoot?: string;
+    existingMetadata?: PartialDocumentMetadata;
+}
+export interface GeneratedMetadata extends Partial<DocumentMetadata> {
+    _generated: {
+        fields: string[];
+        confidence: Record<string, number>;
+    };
+}
+/**
+ * Generate metadata for a document
+ */
+export declare function generateMetadata(options: GeneratorOptions): GeneratedMetadata;
+/**
+ * Merge generated metadata with existing metadata
+ */
+export declare function mergeMetadata(existing: PartialDocumentMetadata, generated: GeneratedMetadata): DocumentMetadata;
+/**
+ * Format a date as YYYY-MM-DD
+ */
+export declare function formatDate(date: Date): string;
+//# sourceMappingURL=generator.d.ts.map

package/dist/core/metadata/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../../src/core/metadata/generator.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAE7E,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,uBAAuB,CAAC;CAC5C;AAED,MAAM,WAAW,iBAAkB,SAAQ,OAAO,CAAC,gBAAgB,CAAC;IAClE,UAAU,EAAE;QACV,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACpC,CAAC;CACH;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,GAAG,iBAAiB,CAgH7E;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,uBAAuB,EACjC,SAAS,EAAE,iBAAiB,GAC3B,gBAAgB,CAqClB;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAE7C"}