@signalwire/docusaurus-plugin-llms-txt/lib/orchestrator.js

Generate Markdown versions of Docusaurus HTML pages and an llms.txt index file

/**
 * Simplified orchestrator using focused modules
 * Coordinates between all domains to process documents
 */
import { CacheManager } from './cache/cache';
import { analyzeCacheStrategy, validateCliContext, } from './cache/cache-strategy';
import { setupDirectories, buildSiteUrl } from './filesystem/paths';
import { generateOutputFiles } from './generation/output-generator';
import { coordinateProcessing } from './processing/processing-coordinator';
/**
 * Unified processing orchestrator that handles both build-time and CLI scenarios
 * @internal
 */
export async function orchestrateProcessing(routes, processingConfig, enhancedCachedRoutes) {
    const { siteDir, generatedFilesDir, config, siteConfig, outDir, logger } = processingConfig;
    // Setup infrastructure
    const directories = setupDirectories(siteDir, config, outDir);
    const siteUrl = siteConfig ? buildSiteUrl(siteConfig) : '';
    const cacheManager = new CacheManager(siteDir, generatedFilesDir, config, logger, outDir, siteConfig);
    const cache = await cacheManager.loadCache();
    // Use enhanced cached routes if provided (build-time with metadata)
    let finalCache = cache;
    if (enhancedCachedRoutes) {
        finalCache = {
            ...cache,
            routes: enhancedCachedRoutes,
        };
        logger.debug(`Using enhanced cached routes with metadata: ${enhancedCachedRoutes.length} routes`);
    }
    // Determine processing context and cache strategy
    const isCliContext = routes.length === 0;
    const cacheStrategy = analyzeCacheStrategy(cacheManager, cache, // Use original cache for comparison, not the enhanced one
    config, isCliContext, logger, isCliContext ? undefined : routes.length // Only pass route count for build context
    );
    // Validate CLI context if needed
    if (isCliContext) {
        validateCliContext(cacheStrategy.cacheHasRoutes, cacheStrategy.configMatches, logger);
    }
    // Process documents
    const processingResult = await coordinateProcessing(routes, finalCache, cacheManager, directories, config, siteUrl, cacheStrategy.useCache, generatedFilesDir, logger, siteConfig);
    // Generate output files
    const outputResult = await generateOutputFiles(processingResult.docs, config, siteConfig, directories, logger);
    return {
        docs: processingResult.docs,
        processedCount: processingResult.processedCount,
        cacheUpdated: processingResult.cacheUpdated,
        llmsTxtPath: outputResult.llmsTxtPath,
        errors: [],
    };
}