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

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

@@ -0,0 +1,36 @@
+export interface SyncOptions {
+    docsPath: string;
+    dryRun?: boolean;
+    fix?: boolean;
+    domain?: string;
+    silent?: boolean;
+}
+export interface SyncResult {
+    totalFiles: number;
+    validFiles: number;
+    fixedFiles: number;
+    skippedFiles: number;
+    errors: SyncError[];
+    stats: SyncStats;
+}
+export interface SyncError {
+    file: string;
+    error: string;
+    fixable: boolean;
+}
+export interface SyncStats {
+    totalWordCount: number;
+    avgCompleteness: number;
+    byDomain: Record<string, number>;
+    byStatus: Record<string, number>;
+    byTier: Record<string, number>;
+}
+/**
+ * Sync metadata across all documentation files
+ */
+export declare function syncMetadata(options: SyncOptions): Promise<SyncResult>;
+/**
+ * Get sync statistics for a documentation root
+ */
+export declare function getSyncStats(docsPath: string): Promise<SyncStats>;
+//# sourceMappingURL=sync.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../../src/core/metadata/sync.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,KAAK,EAAE,SAAS,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAyH5E;AAwGD;;GAEG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CASvE"}

package/dist/core/metadata/sync.js

@@ -0,0 +1,195 @@
+import { readFile, writeFile } from 'fs/promises';
+import { relative } from 'path';
+import { findMarkdownFiles } from '../../utils/glob.js';
+import { parseFrontmatter, setFrontmatter } from '../../utils/frontmatter.js';
+import { countWords, formatReadTime } from '../../utils/markdown.js';
+import { logger } from '../../utils/logger.js';
+import { validatePartialMetadata, getMissingRequiredFields, calculateMetadataCompleteness, } from './schema.js';
+import { generateMetadata, mergeMetadata, formatDate } from './generator.js';
+/**
+ * Sync metadata across all documentation files
+ */
+export async function syncMetadata(options) {
+    const { docsPath, dryRun = false, fix = false, domain, silent = false, } = options;
+    const result = {
+        totalFiles: 0,
+        validFiles: 0,
+        fixedFiles: 0,
+        skippedFiles: 0,
+        errors: [],
+        stats: {
+            totalWordCount: 0,
+            avgCompleteness: 0,
+            byDomain: {},
+            byStatus: {},
+            byTier: {},
+        },
+    };
+    if (!silent) {
+        logger.header('Metadata Sync');
+        if (dryRun)
+            logger.info('Running in dry-run mode (no changes will be made)');
+        if (fix)
+            logger.info('Auto-fix mode enabled');
+    }
+    // Find all markdown files
+    let files = await findMarkdownFiles(docsPath);
+    // Filter by domain if specified
+    if (domain) {
+        files = files.filter((f) => {
+            const rel = relative(docsPath, f);
+            return rel.startsWith(domain + '/') || rel.startsWith(domain + '\\');
+        });
+    }
+    // Exclude INDEX.md and REGISTRY.md files (system files)
+    files = files.filter((f) => {
+        const name = f.split(/[/\\]/).pop() ?? '';
+        return !['INDEX.md', 'REGISTRY.md'].includes(name);
+    });
+    result.totalFiles = files.length;
+    if (!silent) {
+        logger.info(`Found ${files.length} documentation files`);
+    }
+    let completenessSum = 0;
+    for (const file of files) {
+        try {
+            const syncResult = await syncFile(file, docsPath, dryRun, fix);
+            if (syncResult.valid) {
+                result.validFiles++;
+            }
+            if (syncResult.fixed) {
+                result.fixedFiles++;
+            }
+            if (syncResult.skipped) {
+                result.skippedFiles++;
+            }
+            if (syncResult.error) {
+                result.errors.push(syncResult.error);
+            }
+            // Update stats
+            if (syncResult.metadata) {
+                const meta = syncResult.metadata;
+                completenessSum += syncResult.completeness;
+                result.stats.totalWordCount += meta.word_count ?? 0;
+                // Track by domain
+                const domain = meta.domains?.[0] ?? 'unknown';
+                result.stats.byDomain[domain] = (result.stats.byDomain[domain] ?? 0) + 1;
+                // Track by status
+                const status = meta.status ?? 'unknown';
+                result.stats.byStatus[status] = (result.stats.byStatus[status] ?? 0) + 1;
+                // Track by tier
+                const tier = meta.tier ?? 'unknown';
+                result.stats.byTier[tier] = (result.stats.byTier[tier] ?? 0) + 1;
+            }
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            result.errors.push({
+                file: relative(docsPath, file),
+                error: message,
+                fixable: false,
+            });
+        }
+    }
+    // Calculate average completeness
+    result.stats.avgCompleteness =
+        files.length > 0 ? completenessSum / files.length : 0;
+    if (!silent) {
+        logger.newline();
+        logger.success(`Sync complete!`);
+        logger.info(`Valid: ${result.validFiles}/${result.totalFiles}`);
+        if (result.fixedFiles > 0) {
+            logger.info(`Fixed: ${result.fixedFiles}`);
+        }
+        if (result.errors.length > 0) {
+            logger.warn(`Errors: ${result.errors.length}`);
+        }
+        logger.info(`Avg completeness: ${result.stats.avgCompleteness.toFixed(1)}%`);
+    }
+    return result;
+}
+/**
+ * Sync metadata for a single file
+ */
+async function syncFile(filePath, docsPath, dryRun, fix) {
+    const result = {
+        valid: false,
+        fixed: false,
+        skipped: false,
+        completeness: 0,
+    };
+    const content = await readFile(filePath, 'utf-8');
+    const { data, content: body } = parseFrontmatter(content);
+    // Validate existing metadata
+    const validation = validatePartialMetadata(data);
+    const missingRequired = getMissingRequiredFields(data);
+    result.completeness = calculateMetadataCompleteness(data);
+    // Check if file is valid
+    if (validation.valid && missingRequired.length === 0) {
+        result.valid = true;
+        result.metadata = data;
+        // Still update auto-generated fields if fix mode
+        if (fix) {
+            const updated = updateAutoFields(data, body);
+            if (JSON.stringify(updated) !== JSON.stringify(data)) {
+                if (!dryRun) {
+                    const newContent = setFrontmatter(content, updated);
+                    await writeFile(filePath, newContent, 'utf-8');
+                }
+                result.fixed = true;
+                result.metadata = updated;
+            }
+        }
+        return result;
+    }
+    // File has issues
+    if (!fix) {
+        result.error = {
+            file: relative(docsPath, filePath),
+            error: `Missing required fields: ${missingRequired.join(', ')}`,
+            fixable: true,
+        };
+        return result;
+    }
+    // Fix mode: generate missing metadata
+    const generated = generateMetadata({
+        filePath,
+        content,
+        docsRoot: docsPath,
+        existingMetadata: data,
+    });
+    const merged = mergeMetadata(data, generated);
+    result.metadata = merged;
+    if (!dryRun) {
+        const newContent = setFrontmatter(content, merged);
+        await writeFile(filePath, newContent, 'utf-8');
+    }
+    result.fixed = true;
+    result.valid = true;
+    result.completeness = calculateMetadataCompleteness(merged);
+    return result;
+}
+/**
+ * Update auto-generated fields
+ */
+function updateAutoFields(metadata, content) {
+    return {
+        ...metadata,
+        word_count: countWords(content),
+        estimated_read_time: formatReadTime(content),
+        last_validated: formatDate(new Date()),
+    };
+}
+/**
+ * Get sync statistics for a documentation root
+ */
+export async function getSyncStats(docsPath) {
+    const result = await syncMetadata({
+        docsPath,
+        dryRun: true,
+        fix: false,
+        silent: true,
+    });
+    return result.stats;
+}
+//# sourceMappingURL=sync.js.map

package/dist/core/metadata/sync.js.map

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

package/dist/generators/index-generator.d.ts

@@ -0,0 +1,19 @@
+import { type Domain } from '../core/domains/constants.js';
+export interface IndexEntry {
+    path: string;
+    title: string;
+    tier: string;
+    status: string;
+    lastUpdated: string;
+    wordCount?: number;
+    description?: string;
+}
+/**
+ * Generate the root INDEX.md content
+ */
+export declare function generateRootIndex(entries?: Record<Domain, IndexEntry[]>): string;
+/**
+ * Generate a domain-specific INDEX.md content
+ */
+export declare function generateDomainIndexContent(domain: Domain, entries?: IndexEntry[]): string;
+//# sourceMappingURL=index-generator.d.ts.map

package/dist/generators/index-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-generator.d.ts","sourceRoot":"","sources":["../../src/generators/index-generator.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+B,KAAK,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAGxF,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,GAAG,MAAM,CA+DhF;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,UAAU,EAAO,GACzB,MAAM,CA0ER"}

package/dist/generators/index-generator.js

@@ -0,0 +1,191 @@
+import { DOMAINS, DOMAIN_DEFINITIONS } from '../core/domains/constants.js';
+import { formatDate } from '../core/metadata/generator.js';
+/**
+ * Generate the root INDEX.md content
+ */
+export function generateRootIndex(entries) {
+    const now = formatDate(new Date());
+    let content = `---
+title: Documentation Index
+tier: reference
+domains: [root]
+status: active
+last_updated: '${now}'
+version: '1.0.0'
+purpose: Navigation hub for all documentation
+---
+
+# Documentation Index
+
+> Complete listing of all documentation organized by domain.
+
+## Overview
+
+| Domain | Documents | Description |
+|--------|-----------|-------------|
+`;
+    // Add domain rows
+    for (const domain of DOMAINS) {
+        const def = DOMAIN_DEFINITIONS[domain];
+        const count = entries?.[domain]?.length ?? 0;
+        content += `| [${def.name}](#${domain}) | ${count} | ${def.description} |\n`;
+    }
+    content += `\n---\n\n`;
+    // Add domain sections
+    for (const domain of DOMAINS) {
+        const def = DOMAIN_DEFINITIONS[domain];
+        const domainEntries = entries?.[domain] ?? [];
+        content += `## ${def.name}\n\n`;
+        content += `> ${def.description}\n\n`;
+        content += `**Path:** \`${domain}/\`\n\n`;
+        if (domainEntries.length === 0) {
+            content += `*No documents yet.*\n\n`;
+        }
+        else {
+            content += `| Document | Tier | Status | Updated |\n`;
+            content += `|----------|------|--------|----------|\n`;
+            for (const entry of domainEntries) {
+                content += `| [${entry.title}](${entry.path}) | ${entry.tier} | ${entry.status} | ${entry.lastUpdated} |\n`;
+            }
+            content += `\n`;
+        }
+        content += `---\n\n`;
+    }
+    // Footer
+    content += `## Maintenance\n\n`;
+    content += `- **Last generated:** ${now}\n`;
+    content += `- **Run maintenance:** \`npx hit-em-with-the-docs maintain\`\n`;
+    content += `- **Regenerate index:** \`npx hit-em-with-the-docs index\`\n`;
+    return content;
+}
+/**
+ * Generate a domain-specific INDEX.md content
+ */
+export function generateDomainIndexContent(domain, entries = []) {
+    const def = DOMAIN_DEFINITIONS[domain];
+    const now = formatDate(new Date());
+    let content = `---
+title: ${def.name} Documentation Index
+tier: reference
+domains: [${domain}]
+status: active
+last_updated: '${now}'
+version: '1.0.0'
+purpose: Complete listing of ${domain} documentation
+---
+
+# ${def.name} Documentation
+
+> ${def.description}
+
+## Overview
+
+- **Total Documents:** ${entries.length}
+- **Domain:** \`${domain}/\`
+- **Category:** ${def.category}
+- **Load Priority:** ${def.loadPriority}/10
+
+## Documents
+
+`;
+    if (entries.length === 0) {
+        content += `*No documents in this domain yet.*\n\n`;
+        content += `To add a document:\n\n`;
+        content += `1. Create a markdown file in this directory\n`;
+        content += `2. Add YAML frontmatter with required metadata\n`;
+        content += `3. Run \`npx hit-em-with-the-docs integrate <file>\`\n`;
+    }
+    else {
+        // Group by tier
+        const byTier = groupByTier(entries);
+        for (const [tier, tierEntries] of Object.entries(byTier)) {
+            if (tierEntries.length === 0)
+                continue;
+            content += `### ${capitalize(tier)}s\n\n`;
+            content += `| Document | Status | Updated | Words |\n`;
+            content += `|----------|--------|---------|-------|\n`;
+            for (const entry of tierEntries) {
+                const words = entry.wordCount ? entry.wordCount.toLocaleString() : '-';
+                content += `| [${entry.title}](${entry.path}) | ${entry.status} | ${entry.lastUpdated} | ${words} |\n`;
+            }
+            content += `\n`;
+        }
+    }
+    // Keywords section
+    content += `## Keywords\n\n`;
+    content += `This domain covers: ${def.keywords.slice(0, 10).join(', ')}\n\n`;
+    // Related domains
+    const relatedDomains = findRelatedDomains(domain);
+    if (relatedDomains.length > 0) {
+        content += `## Related Domains\n\n`;
+        for (const related of relatedDomains) {
+            const relatedDef = DOMAIN_DEFINITIONS[related];
+            content += `- [${relatedDef.name}](../${related}/) - ${relatedDef.description}\n`;
+        }
+        content += `\n`;
+    }
+    // Footer
+    content += `---\n\n`;
+    content += `*Last updated: ${now}*\n`;
+    return content;
+}
+/**
+ * Group entries by tier
+ */
+function groupByTier(entries) {
+    const grouped = {
+        guide: [],
+        standard: [],
+        example: [],
+        reference: [],
+        admin: [],
+    };
+    for (const entry of entries) {
+        const tier = entry.tier.toLowerCase();
+        if (tier in grouped) {
+            grouped[tier].push(entry);
+        }
+        else {
+            grouped['guide'].push(entry);
+        }
+    }
+    return grouped;
+}
+/**
+ * Find related domains based on shared keywords
+ */
+function findRelatedDomains(domain) {
+    const def = DOMAIN_DEFINITIONS[domain];
+    const related = [];
+    for (const other of DOMAINS) {
+        if (other === domain)
+            continue;
+        const otherDef = DOMAIN_DEFINITIONS[other];
+        let score = 0;
+        // Check keyword overlap
+        for (const keyword of def.keywords) {
+            if (otherDef.keywords.includes(keyword)) {
+                score++;
+            }
+        }
+        // Check category match
+        if (def.category === otherDef.category) {
+            score += 2;
+        }
+        if (score > 0) {
+            related.push({ domain: other, score });
+        }
+    }
+    // Sort by score and return top 3
+    return related
+        .sort((a, b) => b.score - a.score)
+        .slice(0, 3)
+        .map((r) => r.domain);
+}
+/**
+ * Capitalize first letter
+ */
+function capitalize(str) {
+    return str.charAt(0).toUpperCase() + str.slice(1);
+}
+//# sourceMappingURL=index-generator.js.map

package/dist/generators/index-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-generator.js","sourceRoot":"","sources":["../../src/generators/index-generator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAe,MAAM,8BAA8B,CAAC;AACxF,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAY3D;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAsC;IACtE,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IAEnC,IAAI,OAAO,GAAG;;;;;iBAKC,GAAG;;;;;;;;;;;;;CAanB,CAAC;IAEA,kBAAkB;IAClB,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;QACvC,MAAM,KAAK,GAAG,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC;QAC7C,OAAO,IAAI,MAAM,GAAG,CAAC,IAAI,MAAM,MAAM,OAAO,KAAK,MAAM,GAAG,CAAC,WAAW,MAAM,CAAC;IAC/E,CAAC;IAED,OAAO,IAAI,WAAW,CAAC;IAEvB,sBAAsB;IACtB,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;QACvC,MAAM,aAAa,GAAG,OAAO,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAE9C,OAAO,IAAI,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC;QAChC,OAAO,IAAI,KAAK,GAAG,CAAC,WAAW,MAAM,CAAC;QACtC,OAAO,IAAI,eAAe,MAAM,SAAS,CAAC;QAE1C,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,OAAO,IAAI,yBAAyB,CAAC;QACvC,CAAC;aAAM,CAAC;YACN,OAAO,IAAI,0CAA0C,CAAC;YACtD,OAAO,IAAI,2CAA2C,CAAC;YAEvD,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE,CAAC;gBAClC,OAAO,IAAI,MAAM,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,IAAI,MAAM,KAAK,CAAC,MAAM,MAAM,KAAK,CAAC,WAAW,MAAM,CAAC;YAC9G,CAAC;YACD,OAAO,IAAI,IAAI,CAAC;QAClB,CAAC;QAED,OAAO,IAAI,SAAS,CAAC;IACvB,CAAC;IAED,SAAS;IACT,OAAO,IAAI,oBAAoB,CAAC;IAChC,OAAO,IAAI,yBAAyB,GAAG,IAAI,CAAC;IAC5C,OAAO,IAAI,gEAAgE,CAAC;IAC5E,OAAO,IAAI,8DAA8D,CAAC;IAE1E,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B,CACxC,MAAc,EACd,UAAwB,EAAE;IAE1B,MAAM,GAAG,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACvC,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IAEnC,IAAI,OAAO,GAAG;SACP,GAAG,CAAC,IAAI;;YAEL,MAAM;;iBAED,GAAG;;+BAEW,MAAM;;;IAGjC,GAAG,CAAC,IAAI;;IAER,GAAG,CAAC,WAAW;;;;yBAIM,OAAO,CAAC,MAAM;kBACrB,MAAM;kBACN,GAAG,CAAC,QAAQ;uBACP,GAAG,CAAC,YAAY;;;;CAItC,CAAC;IAEA,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,wCAAwC,CAAC;QACpD,OAAO,IAAI,wBAAwB,CAAC;QACpC,OAAO,IAAI,+CAA+C,CAAC;QAC3D,OAAO,IAAI,kDAAkD,CAAC;QAC9D,OAAO,IAAI,wDAAwD,CAAC;IACtE,CAAC;SAAM,CAAC;QACN,gBAAgB;QAChB,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;QAEpC,KAAK,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACzD,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAS;YAEvC,OAAO,IAAI,OAAO,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC;YAC1C,OAAO,IAAI,2CAA2C,CAAC;YACvD,OAAO,IAAI,2CAA2C,CAAC;YAEvD,KAAK,MAAM,KAAK,IAAI,WAAW,EAAE,CAAC;gBAChC,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;gBACvE,OAAO,IAAI,MAAM,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,MAAM,MAAM,KAAK,CAAC,WAAW,MAAM,KAAK,MAAM,CAAC;YACzG,CAAC;YACD,OAAO,IAAI,IAAI,CAAC;QAClB,CAAC;IACH,CAAC;IAED,mBAAmB;IACnB,OAAO,IAAI,iBAAiB,CAAC;IAC7B,OAAO,IAAI,uBAAuB,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;IAE7E,kBAAkB;IAClB,MAAM,cAAc,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAClD,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,OAAO,IAAI,wBAAwB,CAAC;QACpC,KAAK,MAAM,OAAO,IAAI,cAAc,EAAE,CAAC;YACrC,MAAM,UAAU,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;YAC/C,OAAO,IAAI,MAAM,UAAU,CAAC,IAAI,QAAQ,OAAO,QAAQ,UAAU,CAAC,WAAW,IAAI,CAAC;QACpF,CAAC;QACD,OAAO,IAAI,IAAI,CAAC;IAClB,CAAC;IAED,SAAS;IACT,OAAO,IAAI,SAAS,CAAC;IACrB,OAAO,IAAI,kBAAkB,GAAG,KAAK,CAAC;IAEtC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,SAAS,WAAW,CAAC,OAAqB;IACxC,MAAM,OAAO,GAAiC;QAC5C,KAAK,EAAE,EAAE;QACT,QAAQ,EAAE,EAAE;QACZ,OAAO,EAAE,EAAE;QACX,SAAS,EAAE,EAAE;QACb,KAAK,EAAE,EAAE;KACV,CAAC;IAEF,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QACtC,IAAI,IAAI,IAAI,OAAO,EAAE,CAAC;YACpB,OAAO,CAAC,IAAI,CAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7B,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,OAAO,CAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,SAAS,kBAAkB,CAAC,MAAc;IACxC,MAAM,GAAG,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACvC,MAAM,OAAO,GAAwC,EAAE,CAAC;IAExD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,KAAK,KAAK,MAAM;YAAE,SAAS;QAE/B,MAAM,QAAQ,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAC3C,IAAI,KAAK,GAAG,CAAC,CAAC;QAEd,wBAAwB;QACxB,KAAK,MAAM,OAAO,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;YACnC,IAAI,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBACxC,KAAK,EAAE,CAAC;YACV,CAAC;QACH,CAAC;QAED,uBAAuB;QACvB,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ,CAAC,QAAQ,EAAE,CAAC;YACvC,KAAK,IAAI,CAAC,CAAC;QACb,CAAC;QAED,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACd,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAED,iCAAiC;IACjC,OAAO,OAAO;SACX,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;SACjC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;SACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,SAAS,UAAU,CAAC,GAAW;IAC7B,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACpD,CAAC"}

package/dist/generators/registry-generator.d.ts

@@ -0,0 +1,11 @@
+import { type Domain } from '../core/domains/constants.js';
+import type { IndexEntry } from './index-generator.js';
+/**
+ * Generate the root REGISTRY.md content (quick reference)
+ */
+export declare function generateRootRegistry(): string;
+/**
+ * Generate domain-specific REGISTRY.md content
+ */
+export declare function generateDomainRegistryContent(domain: Domain, entries?: IndexEntry[]): string;
+//# sourceMappingURL=registry-generator.d.ts.map

package/dist/generators/registry-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-generator.d.ts","sourceRoot":"","sources":["../../src/generators/registry-generator.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+B,KAAK,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAExF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CA+D7C;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,UAAU,EAAO,GACzB,MAAM,CA8ER"}

package/dist/generators/registry-generator.js

@@ -0,0 +1,156 @@
+import { DOMAINS, DOMAIN_DEFINITIONS } from '../core/domains/constants.js';
+import { formatDate } from '../core/metadata/generator.js';
+/**
+ * Generate the root REGISTRY.md content (quick reference)
+ */
+export function generateRootRegistry() {
+    const now = formatDate(new Date());
+    let content = `---
+title: Documentation Registry
+tier: reference
+domains: [root]
+status: active
+last_updated: '${now}'
+version: '1.0.0'
+purpose: Quick reference for all documentation domains
+---
+
+# Documentation Registry
+
+> Quick reference tables for fast navigation.
+
+## Domain Quick Reference
+
+| Domain | Category | Priority | Keywords |
+|--------|----------|----------|----------|
+`;
+    for (const domain of DOMAINS) {
+        const def = DOMAIN_DEFINITIONS[domain];
+        const keywords = def.keywords.slice(0, 3).join(', ');
+        content += `| [${def.name}](${domain}/) | ${def.category} | ${def.loadPriority}/10 | ${keywords} |\n`;
+    }
+    content += `\n## By Category\n\n`;
+    // Group by category
+    const categories = ['core', 'development', 'features', 'advanced'];
+    for (const category of categories) {
+        const categoryDomains = DOMAINS.filter((d) => DOMAIN_DEFINITIONS[d].category === category);
+        content += `### ${capitalize(category)}\n\n`;
+        for (const domain of categoryDomains) {
+            const def = DOMAIN_DEFINITIONS[domain];
+            content += `- **[${def.name}](${domain}/)** - ${def.description}\n`;
+        }
+        content += `\n`;
+    }
+    content += `## Common Tasks\n\n`;
+    content += `| Task | Start Here |\n`;
+    content += `|------|------------|\n`;
+    content += `| New developer setup | [quickstart/](quickstart/) |\n`;
+    content += `| Coding standards | [standards/](standards/) |\n`;
+    content += `| API development | [api/](api/) |\n`;
+    content += `| Security implementation | [security/](security/) |\n`;
+    content += `| Database changes | [database/](database/) |\n`;
+    content += `| Deployment | [devops/](devops/) |\n`;
+    content += `| Troubleshooting | [troubleshooting/](troubleshooting/) |\n`;
+    content += `\n---\n\n`;
+    content += `*Last updated: ${now}*\n`;
+    return content;
+}
+/**
+ * Generate domain-specific REGISTRY.md content
+ */
+export function generateDomainRegistryContent(domain, entries = []) {
+    const def = DOMAIN_DEFINITIONS[domain];
+    const now = formatDate(new Date());
+    let content = `---
+title: ${def.name} Registry
+tier: reference
+domains: [${domain}]
+status: active
+last_updated: '${now}'
+version: '1.0.0'
+purpose: Quick reference for ${domain} documentation
+---
+
+# ${def.name} Registry
+
+> Quick reference for ${def.description.toLowerCase()}.
+
+## At a Glance
+
+| Metric | Value |
+|--------|-------|
+| Documents | ${entries.length} |
+| Category | ${def.category} |
+| Load Priority | ${def.loadPriority}/10 |
+
+`;
+    if (entries.length > 0) {
+        // Quick links to most important docs
+        const activeEntries = entries.filter((e) => e.status === 'active');
+        const recentEntries = [...entries]
+            .sort((a, b) => b.lastUpdated.localeCompare(a.lastUpdated))
+            .slice(0, 5);
+        if (activeEntries.length > 0) {
+            content += `## Active Documents\n\n`;
+            for (const entry of activeEntries.slice(0, 10)) {
+                content += `- [${entry.title}](${entry.path})\n`;
+            }
+            content += `\n`;
+        }
+        if (recentEntries.length > 0) {
+            content += `## Recently Updated\n\n`;
+            for (const entry of recentEntries) {
+                content += `- [${entry.title}](${entry.path}) - ${entry.lastUpdated}\n`;
+            }
+            content += `\n`;
+        }
+        // By status
+        content += `## By Status\n\n`;
+        const byStatus = groupByStatus(entries);
+        content += `| Status | Count |\n`;
+        content += `|--------|-------|\n`;
+        for (const [status, statusEntries] of Object.entries(byStatus)) {
+            content += `| ${status} | ${statusEntries.length} |\n`;
+        }
+        content += `\n`;
+    }
+    else {
+        content += `## Documents\n\n`;
+        content += `*No documents in this domain yet.*\n\n`;
+    }
+    // Keywords
+    content += `## Keywords\n\n`;
+    content += `\`${def.keywords.join('` `')}\`\n\n`;
+    // See also
+    content += `## See Also\n\n`;
+    content += `- [Full Index](INDEX.md) - Complete document listing\n`;
+    content += `- [Root Index](../INDEX.md) - All domains\n`;
+    content += `\n---\n\n`;
+    content += `*Last updated: ${now}*\n`;
+    return content;
+}
+/**
+ * Group entries by status
+ */
+function groupByStatus(entries) {
+    const grouped = {
+        active: [],
+        draft: [],
+        deprecated: [],
+        archived: [],
+    };
+    for (const entry of entries) {
+        const status = entry.status.toLowerCase();
+        if (status in grouped) {
+            grouped[status].push(entry);
+        }
+    }
+    return grouped;
+}
+/**
+ * Capitalize first letter
+ */
+function capitalize(str) {
+    return str.charAt(0).toUpperCase() + str.slice(1);
+}
+//# sourceMappingURL=registry-generator.js.map

package/dist/generators/registry-generator.js.map

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