skrypt-ai 0.4.2 → 0.6.0

package/dist/commands/version.js

@@ -5,7 +5,12 @@ const CONFIG_FILE = 'skrypt.versions.json';
 function loadVersionConfig(docsPath) {
     const configPath = join(docsPath, CONFIG_FILE);
     if (existsSync(configPath)) {
-        return JSON.parse(readFileSync(configPath, 'utf-8'));
+        try {
+            return JSON.parse(readFileSync(configPath, 'utf-8'));
+        }
+        catch {
+            return { versions: [], current: '' };
+        }
     }
     return { versions: [], current: '' };
 }
@@ -20,16 +25,22 @@ versionCommand
     .description('List all versions')
     .argument('[docs-path]', 'Documentation directory', './docs')
     .action((docsPath) => {
-    const config = loadVersionConfig(resolve(docsPath));
-    if (config.versions.length === 0) {
-        console.log('No versions configured.');
-        console.log('Run: skrypt version create <version>');
-        return;
+    try {
+        const config = loadVersionConfig(resolve(docsPath));
+        if (config.versions.length === 0) {
+            console.log('No versions configured.');
+            console.log('Run: skrypt version create <version>');
+            return;
+        }
+        console.log('Versions:');
+        for (const v of config.versions) {
+            const marker = v === config.current ? ' (current)' : '';
+            console.log(`  ${v}${marker}`);
+        }
     }
-    console.log('Versions:');
-    for (const v of config.versions) {
-        const marker = v === config.current ? ' (current)' : '';
-        console.log(`  ${v}${marker}`);
+    catch (err) {
+        console.error(`Error: ${err instanceof Error ? err.message : err}`);
+        process.exit(1);
     }
 });
 versionCommand
@@ -39,49 +50,55 @@ versionCommand
     .argument('[docs-path]', 'Documentation directory', './docs')
     .option('--from <version>', 'Copy from existing version instead of current')
     .action((version, docsPath, options) => {
-    const resolvedPath = resolve(docsPath);
-    const config = loadVersionConfig(resolvedPath);
-    if (config.versions.includes(version)) {
-        console.error(`Version ${version} already exists.`);
-        process.exit(1);
-    }
-    const versionDir = join(resolvedPath, 'versions', version);
-    if (existsSync(versionDir)) {
-        console.error(`Directory already exists: ${versionDir}`);
-        process.exit(1);
-    }
-    // Determine source
-    let sourceDir;
-    if (options.from) {
-        sourceDir = join(resolvedPath, 'versions', options.from);
-        if (!existsSync(sourceDir)) {
-            console.error(`Source version not found: ${options.from}`);
+    try {
+        const resolvedPath = resolve(docsPath);
+        const config = loadVersionConfig(resolvedPath);
+        if (config.versions.includes(version)) {
+            console.error(`Version ${version} already exists.`);
             process.exit(1);
         }
+        const versionDir = join(resolvedPath, 'versions', version);
+        if (existsSync(versionDir)) {
+            console.error(`Directory already exists: ${versionDir}`);
+            process.exit(1);
+        }
+        // Determine source
+        let sourceDir;
+        if (options.from) {
+            sourceDir = join(resolvedPath, 'versions', options.from);
+            if (!existsSync(sourceDir)) {
+                console.error(`Source version not found: ${options.from}`);
+                process.exit(1);
+            }
+        }
+        else {
+            // Copy current docs (excluding versions folder)
+            sourceDir = resolvedPath;
+        }
+        // Create version directory
+        mkdirSync(versionDir, { recursive: true });
+        // Copy files
+        const entries = readdirSync(sourceDir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.name === 'versions' || entry.name === CONFIG_FILE)
+                continue;
+            const srcPath = join(sourceDir, entry.name);
+            const destPath = join(versionDir, entry.name);
+            cpSync(srcPath, destPath, { recursive: true });
+        }
+        // Update config
+        config.versions.push(version);
+        if (!config.current) {
+            config.current = version;
+        }
+        saveVersionConfig(resolvedPath, config);
+        console.log(`Created version: ${version}`);
+        console.log(`  Location: ${versionDir}`);
     }
-    else {
-        // Copy current docs (excluding versions folder)
-        sourceDir = resolvedPath;
-    }
-    // Create version directory
-    mkdirSync(versionDir, { recursive: true });
-    // Copy files
-    const entries = readdirSync(sourceDir, { withFileTypes: true });
-    for (const entry of entries) {
-        if (entry.name === 'versions' || entry.name === CONFIG_FILE)
-            continue;
-        const srcPath = join(sourceDir, entry.name);
-        const destPath = join(versionDir, entry.name);
-        cpSync(srcPath, destPath, { recursive: true });
-    }
-    // Update config
-    config.versions.push(version);
-    if (!config.current) {
-        config.current = version;
+    catch (err) {
+        console.error(`Error: ${err instanceof Error ? err.message : err}`);
+        process.exit(1);
     }
-    saveVersionConfig(resolvedPath, config);
-    console.log(`Created version: ${version}`);
-    console.log(`  Location: ${versionDir}`);
 });
 versionCommand
     .command('set-current')
@@ -89,16 +106,22 @@ versionCommand
     .argument('<version>', 'Version to set as current')
     .argument('[docs-path]', 'Documentation directory', './docs')
     .action((version, docsPath) => {
-    const resolvedPath = resolve(docsPath);
-    const config = loadVersionConfig(resolvedPath);
-    if (!config.versions.includes(version)) {
-        console.error(`Version ${version} not found.`);
-        console.log('Available versions:', config.versions.join(', '));
+    try {
+        const resolvedPath = resolve(docsPath);
+        const config = loadVersionConfig(resolvedPath);
+        if (!config.versions.includes(version)) {
+            console.error(`Version ${version} not found.`);
+            console.log('Available versions:', config.versions.join(', '));
+            process.exit(1);
+        }
+        config.current = version;
+        saveVersionConfig(resolvedPath, config);
+        console.log(`Set current version to: ${version}`);
+    }
+    catch (err) {
+        console.error(`Error: ${err instanceof Error ? err.message : err}`);
         process.exit(1);
     }
-    config.current = version;
-    saveVersionConfig(resolvedPath, config);
-    console.log(`Set current version to: ${version}`);
 });
 versionCommand
     .command('delete')
@@ -107,25 +130,31 @@ versionCommand
     .argument('[docs-path]', 'Documentation directory', './docs')
     .option('--force', 'Skip confirmation')
     .action((version, docsPath, options) => {
-    const resolvedPath = resolve(docsPath);
-    const config = loadVersionConfig(resolvedPath);
-    if (!config.versions.includes(version)) {
-        console.error(`Version ${version} not found.`);
-        process.exit(1);
+    try {
+        const resolvedPath = resolve(docsPath);
+        const config = loadVersionConfig(resolvedPath);
+        if (!config.versions.includes(version)) {
+            console.error(`Version ${version} not found.`);
+            process.exit(1);
+        }
+        if (version === config.current && !options.force) {
+            console.error(`Cannot delete current version. Use --force or set a different current version first.`);
+            process.exit(1);
+        }
+        const versionDir = join(resolvedPath, 'versions', version);
+        // Remove from config
+        config.versions = config.versions.filter(v => v !== version);
+        if (config.current === version) {
+            config.current = config.versions[0] || '';
+        }
+        saveVersionConfig(resolvedPath, config);
+        // Note: Not actually deleting files for safety
+        console.log(`Removed version ${version} from config.`);
+        console.log(`Files still exist at: ${versionDir}`);
+        console.log(`To fully delete, run: rm -rf "${versionDir}"`);
     }
-    if (version === config.current && !options.force) {
-        console.error(`Cannot delete current version. Use --force or set a different current version first.`);
+    catch (err) {
+        console.error(`Error: ${err instanceof Error ? err.message : err}`);
         process.exit(1);
     }
-    const versionDir = join(resolvedPath, 'versions', version);
-    // Remove from config
-    config.versions = config.versions.filter(v => v !== version);
-    if (config.current === version) {
-        config.current = config.versions[0] || '';
-    }
-    saveVersionConfig(resolvedPath, config);
-    // Note: Not actually deleting files for safety
-    console.log(`Removed version ${version} from config.`);
-    console.log(`Files still exist at: ${versionDir}`);
-    console.log(`To fully delete, run: rm -rf "${versionDir}"`);
 });

package/dist/commands/watch.js

@@ -7,6 +7,7 @@ import { DEFAULT_MODELS } from '../config/types.js';
 import { scanDirectory } from '../scanner/index.js';
 import { createLLMClient } from '../llm/index.js';
 import { generateForElements, groupDocsByFile, writeDocsToDirectory } from '../generator/index.js';
+import { runQA, printQAReport, fixQAIssues, printFixReport } from '../qa/index.js';
 export const watchCommand = new Command('watch')
     .description('Watch source files and regenerate docs on changes')
     .argument('<source>', 'Source directory to watch')
@@ -16,127 +17,142 @@ export const watchCommand = new Command('watch')
     .option('--model <name>', 'LLM model name')
     .option('--debounce <ms>', 'Debounce time in milliseconds', '1000')
     .action(async (source, options) => {
-    const config = loadConfig(options.config);
-    if (source)
-        config.source.path = source;
-    if (options.output)
-        config.output.path = options.output;
-    if (options.provider) {
-        config.llm.provider = options.provider;
-        if (!options.model) {
-            config.llm.model = DEFAULT_MODELS[config.llm.provider];
+    try {
+        const config = loadConfig(options.config);
+        if (source)
+            config.source.path = source;
+        if (options.output)
+            config.output.path = options.output;
+        if (options.provider) {
+            config.llm.provider = options.provider;
+            if (!options.model) {
+                config.llm.model = DEFAULT_MODELS[config.llm.provider];
+            }
         }
-    }
-    if (options.model)
-        config.llm.model = options.model;
-    const errors = validateConfig(config);
-    if (errors.length > 0) {
-        console.error('Config errors:', errors);
-        process.exit(1);
-    }
-    const { ok, envKey } = checkApiKey(config.llm.provider);
-    if (!ok && envKey) {
-        console.error(`Error: ${envKey} required`);
-        process.exit(1);
-    }
-    const sourcePath = resolve(config.source.path);
-    const outputPath = resolve(config.output.path);
-    if (!existsSync(sourcePath)) {
-        console.error(`Source not found: ${sourcePath}`);
-        process.exit(1);
-    }
-    console.log('skrypt watch');
-    console.log(`  source: ${sourcePath}`);
-    console.log(`  output: ${outputPath}`);
-    console.log(`  provider: ${config.llm.provider}`);
-    console.log('');
-    const client = createLLMClient({
-        provider: config.llm.provider,
-        model: config.llm.model,
-        baseUrl: config.llm.baseUrl
-    });
-    let generating = false;
-    let pendingGenerate = false;
-    const debounceMs = parseInt(options.debounce);
-    async function generate() {
-        if (generating) {
-            pendingGenerate = true;
-            return;
+        if (options.model)
+            config.llm.model = options.model;
+        const errors = validateConfig(config);
+        if (errors.length > 0) {
+            console.error('Config errors:', errors);
+            process.exit(1);
+        }
+        const { ok, envKey } = checkApiKey(config.llm.provider);
+        if (!ok && envKey) {
+            console.error(`Error: ${envKey} required`);
+            process.exit(1);
         }
-        generating = true;
-        const startTime = Date.now();
-        try {
-            console.log('\n[' + new Date().toLocaleTimeString() + '] Regenerating docs...');
-            const scanResult = await scanDirectory(sourcePath, {
-                include: config.source.include,
-                exclude: config.source.exclude,
-            });
-            if (scanResult.totalElements === 0) {
-                console.log('  No elements found');
+        const sourcePath = resolve(config.source.path);
+        const outputPath = resolve(config.output.path);
+        if (!existsSync(sourcePath)) {
+            console.error(`Source not found: ${sourcePath}`);
+            process.exit(1);
+        }
+        console.log('skrypt watch');
+        console.log(`  source: ${sourcePath}`);
+        console.log(`  output: ${outputPath}`);
+        console.log(`  provider: ${config.llm.provider}`);
+        console.log('');
+        const client = createLLMClient({
+            provider: config.llm.provider,
+            model: config.llm.model,
+            baseUrl: config.llm.baseUrl
+        });
+        let generating = false;
+        let pendingGenerate = false;
+        const debounceMs = parseInt(options.debounce, 10);
+        if (isNaN(debounceMs) || debounceMs < 1) {
+            console.error('Error: --debounce must be a positive number');
+            process.exit(1);
+        }
+        async function generate() {
+            if (generating) {
+                pendingGenerate = true;
                 return;
             }
-            const allElements = [];
-            for (const file of scanResult.files) {
-                allElements.push(...file.elements);
+            generating = true;
+            const startTime = Date.now();
+            try {
+                console.log('\n[' + new Date().toLocaleTimeString() + '] Regenerating docs...');
+                const scanResult = await scanDirectory(sourcePath, {
+                    include: config.source.include,
+                    exclude: config.source.exclude,
+                });
+                if (scanResult.totalElements === 0) {
+                    console.log('  No elements found');
+                    return;
+                }
+                const allElements = [];
+                for (const file of scanResult.files) {
+                    allElements.push(...file.elements);
+                }
+                const docs = await generateForElements(allElements, client, {
+                    onProgress: (p) => {
+                        process.stdout.write(`\r  [${p.current}/${p.total}] ${p.element}`.padEnd(60));
+                    }
+                });
+                const fileResults = groupDocsByFile(docs);
+                await writeDocsToDirectory(fileResults, outputPath, sourcePath);
+                // Auto-fix then run QA on generated output
+                const fixReport = fixQAIssues(outputPath);
+                printFixReport(fixReport);
+                const qaReport = runQA(outputPath);
+                printQAReport(qaReport);
+                const duration = ((Date.now() - startTime) / 1000).toFixed(1);
+                console.log(`\n  Done in ${duration}s`);
+            }
+            catch (err) {
+                console.error('\n  Error:', err);
             }
-            const docs = await generateForElements(allElements, client, {
-                onProgress: (p) => {
-                    process.stdout.write(`\r  [${p.current}/${p.total}] ${p.element}`.padEnd(60));
+            finally {
+                generating = false;
+                if (pendingGenerate) {
+                    pendingGenerate = false;
+                    setTimeout(generate, debounceMs);
                 }
-            });
-            const fileResults = groupDocsByFile(docs);
-            await writeDocsToDirectory(fileResults, outputPath, sourcePath);
-            const duration = ((Date.now() - startTime) / 1000).toFixed(1);
-            console.log(`\n  Done in ${duration}s`);
-        }
-        catch (err) {
-            console.error('\n  Error:', err);
-        }
-        finally {
-            generating = false;
-            if (pendingGenerate) {
-                pendingGenerate = false;
-                setTimeout(generate, debounceMs);
             }
         }
+        // Initial generation
+        await generate();
+        // Watch for changes
+        console.log('\nWatching for changes... (Ctrl+C to stop)');
+        let debounceTimer = null;
+        const watcher = watch(sourcePath, {
+            ignored: [
+                '**/node_modules/**',
+                '**/.git/**',
+                '**/dist/**',
+                '**/__pycache__/**',
+            ],
+            persistent: true,
+            ignoreInitial: true,
+        });
+        watcher.on('change', (path) => {
+            console.log(`  Changed: ${path}`);
+            if (debounceTimer)
+                clearTimeout(debounceTimer);
+            debounceTimer = setTimeout(generate, debounceMs);
+        });
+        watcher.on('add', (path) => {
+            console.log(`  Added: ${path}`);
+            if (debounceTimer)
+                clearTimeout(debounceTimer);
+            debounceTimer = setTimeout(generate, debounceMs);
+        });
+        watcher.on('unlink', (path) => {
+            console.log(`  Removed: ${path}`);
+            if (debounceTimer)
+                clearTimeout(debounceTimer);
+            debounceTimer = setTimeout(generate, debounceMs);
+        });
+        // Keep process alive
+        process.on('SIGINT', () => {
+            console.log('\nStopping watch...');
+            watcher.close();
+            process.exit(0);
+        });
+    }
+    catch (err) {
+        console.error(`Error: ${err instanceof Error ? err.message : err}`);
+        process.exit(1);
     }
-    // Initial generation
-    await generate();
-    // Watch for changes
-    console.log('\nWatching for changes... (Ctrl+C to stop)');
-    let debounceTimer = null;
-    const watcher = watch(sourcePath, {
-        ignored: [
-            '**/node_modules/**',
-            '**/.git/**',
-            '**/dist/**',
-            '**/__pycache__/**',
-        ],
-        persistent: true,
-        ignoreInitial: true,
-    });
-    watcher.on('change', (path) => {
-        console.log(`  Changed: ${path}`);
-        if (debounceTimer)
-            clearTimeout(debounceTimer);
-        debounceTimer = setTimeout(generate, debounceMs);
-    });
-    watcher.on('add', (path) => {
-        console.log(`  Added: ${path}`);
-        if (debounceTimer)
-            clearTimeout(debounceTimer);
-        debounceTimer = setTimeout(generate, debounceMs);
-    });
-    watcher.on('unlink', (path) => {
-        console.log(`  Removed: ${path}`);
-        if (debounceTimer)
-            clearTimeout(debounceTimer);
-        debounceTimer = setTimeout(generate, debounceMs);
-    });
-    // Keep process alive
-    process.on('SIGINT', () => {
-        console.log('\nStopping watch...');
-        watcher.close();
-        process.exit(0);
-    });
 });

package/dist/config/types.js

@@ -20,8 +20,8 @@ export const DEFAULT_CONFIG = {
     version: 1,
     source: {
         path: './src',
-        include: ['**/*.py', '**/*.js', '**/*.ts', '**/*.go', '**/*.rs'],
-        exclude: ['**/node_modules/**', '**/__pycache__/**', '**/dist/**', '**/target/**']
+        include: ['**/*.py', '**/*.js', '**/*.ts', '**/*.go', '**/*.rs', '**/*.java', '**/*.cs', '**/*.php', '**/*.kt', '**/*.kts', '**/*.swift', '**/*.rb'],
+        exclude: ['**/node_modules/**', '**/__pycache__/**', '**/dist/**', '**/target/**', '**/vendor/**', '**/build/**', '**/bin/**', '**/obj/**', '**/.build/**']
     },
     output: {
         path: './docs',

package/dist/context-hub/index.d.ts

@@ -0,0 +1,23 @@
+import type { ContextHubExportOptions, ContextHubExportResult, ContextHubContext } from './types.js';
+import type { GeneratedDoc } from '../generator/types.js';
+export type { ContextHubExportOptions, ContextHubExportResult, ContextHubContext };
+/**
+ * Check if the `chub` CLI is installed
+ */
+export declare function isChubInstalled(): boolean;
+/**
+ * Extract Context Hub IDs from import lines by matching against known mappings
+ */
+export declare function extractDependencyIds(imports: string[]): string[];
+/**
+ * Fetch docs from Context Hub for the given IDs
+ */
+export declare function fetchContextHubDocs(chubIds: string[], language?: string): Map<string, string>;
+/**
+ * Given an element's imports, return relevant fetched docs as a single string
+ */
+export declare function matchImportsToContext(imports: string[], contextMap: Map<string, string>): string | undefined;
+/**
+ * Export generated docs to Context Hub format
+ */
+export declare function exportToContextHub(docs: GeneratedDoc[], outputDir: string, options: ContextHubExportOptions): ContextHubExportResult;