skrypt-ai 0.4.2 → 0.6.0

package/dist/commands/autofix.js

@@ -1,10 +1,11 @@
 import { Command } from 'commander';
 import { readFileSync, writeFileSync } from 'fs';
-import { resolve } from 'path';
+import { resolve, dirname } from 'path';
 import { loadConfig, checkApiKey } from '../config/index.js';
 import { createLLMClient } from '../llm/index.js';
 import { autoFixExample, createTypeScriptValidator, createPythonValidator } from '../autofix/index.js';
 import { requirePro } from '../auth/index.js';
+import { runQA, printQAReport, fixQAIssues, printFixReport } from '../qa/index.js';
 export const autofixCommand = new Command('autofix')
     .description('Auto-fix broken code examples in documentation')
     .argument('<file>', 'Documentation file to fix (markdown/mdx)')
@@ -15,134 +16,149 @@ export const autofixCommand = new Command('autofix')
     .option('--dry-run', 'Show fixes without writing')
     .option('--language <lang>', 'Force language for validation')
     .action(async (file, options) => {
-    // Pro feature - requires subscription
-    if (!await requirePro('autofix')) {
-        process.exit(1);
-    }
-    const config = loadConfig(options.config);
-    if (options.provider)
-        config.llm.provider = options.provider;
-    if (options.model)
-        config.llm.model = options.model;
-    const { ok, envKey } = checkApiKey(config.llm.provider);
-    if (!ok && envKey) {
-        console.error(`Error: ${envKey} environment variable required`);
-        process.exit(1);
-    }
-    const filePath = resolve(file);
-    console.log(`skrypt autofix`);
-    console.log(`  file: ${filePath}`);
-    console.log(`  provider: ${config.llm.provider}`);
-    console.log(`  max iterations: ${options.maxIterations}`);
-    console.log('');
-    // Read the file
-    let content;
     try {
-        content = readFileSync(filePath, 'utf-8');
-    }
-    catch (err) {
-        const errObj = err;
-        if (errObj.code === 'ENOENT') {
-            console.error(`Error: File not found: ${filePath}`);
+        // Pro feature - requires subscription
+        if (!await requirePro('autofix')) {
+            process.exit(1);
         }
-        else if (errObj.code === 'EACCES') {
-            console.error(`Error: Permission denied: ${filePath}`);
+        const config = loadConfig(options.config);
+        if (options.provider)
+            config.llm.provider = options.provider;
+        if (options.model)
+            config.llm.model = options.model;
+        const { ok, envKey } = checkApiKey(config.llm.provider);
+        if (!ok && envKey) {
+            console.error(`Error: ${envKey} environment variable required`);
+            process.exit(1);
         }
-        else {
-            const message = err instanceof Error ? err.message : String(err);
-            console.error(`Error: Could not read file: ${filePath} (${message})`);
+        const filePath = resolve(file);
+        console.log(`skrypt autofix`);
+        console.log(`  file: ${filePath}`);
+        console.log(`  provider: ${config.llm.provider}`);
+        console.log(`  max iterations: ${options.maxIterations}`);
+        console.log('');
+        // Read the file
+        let content;
+        try {
+            content = readFileSync(filePath, 'utf-8');
         }
-        process.exit(1);
-    }
-    // Find all code blocks
-    const codeBlockRegex = /```(\w+)?\n([\s\S]*?)```/g;
-    const codeBlocks = [];
-    let match;
-    while ((match = codeBlockRegex.exec(content)) !== null) {
-        const code = match[2];
-        if (!code)
-            continue;
-        codeBlocks.push({
-            match: match[0],
-            language: options.language || match[1] || 'javascript',
-            code,
-            index: match.index,
-        });
-    }
-    if (codeBlocks.length === 0) {
-        console.log('No code blocks found in file.');
-        process.exit(0);
-    }
-    console.log(`Found ${codeBlocks.length} code block(s)`);
-    console.log('');
-    const client = createLLMClient({
-        provider: config.llm.provider,
-        model: config.llm.model,
-        baseUrl: config.llm.baseUrl,
-    });
-    const maxIterations = parseInt(options.maxIterations);
-    // Create validators
-    const validators = {
-        javascript: createTypeScriptValidator(),
-        typescript: createTypeScriptValidator(),
-        ts: createTypeScriptValidator(),
-        js: createTypeScriptValidator(),
-        python: createPythonValidator(),
-        py: createPythonValidator(),
-    };
-    let fixedCount = 0;
-    let failedCount = 0;
-    let newContent = content;
-    for (let i = 0; i < codeBlocks.length; i++) {
-        const block = codeBlocks[i];
-        if (!block)
-            continue;
-        const validator = validators[block.language.toLowerCase()];
-        if (!validator) {
-            console.log(`[${i + 1}/${codeBlocks.length}] Skipping ${block.language} (no validator)`);
-            continue;
+        catch (err) {
+            const errObj = err;
+            if (errObj.code === 'ENOENT') {
+                console.error(`Error: File not found: ${filePath}`);
+            }
+            else if (errObj.code === 'EACCES') {
+                console.error(`Error: Permission denied: ${filePath}`);
+            }
+            else {
+                const message = err instanceof Error ? err.message : String(err);
+                console.error(`Error: Could not read file: ${filePath} (${message})`);
+            }
+            process.exit(1);
         }
-        console.log(`[${i + 1}/${codeBlocks.length}] Checking ${block.language} example...`);
-        // First check if it's valid
-        const initial = await validator(block.code);
-        if (initial.valid) {
-            console.log(`  ✓ Already valid`);
-            continue;
+        // Find all code blocks
+        const codeBlockRegex = /```(\w+)?\n([\s\S]*?)```/g;
+        const codeBlocks = [];
+        let match;
+        while ((match = codeBlockRegex.exec(content)) !== null) {
+            const code = match[2];
+            if (!code)
+                continue;
+            codeBlocks.push({
+                match: match[0],
+                language: options.language || match[1] || 'javascript',
+                code,
+                index: match.index,
+            });
         }
-        console.log(`  ✗ Invalid: ${initial.errors[0]?.slice(0, 60)}...`);
-        console.log(`  → Attempting to fix...`);
-        const result = await autoFixExample({
-            code: block.code,
-            language: block.language,
-            context: `Code example from documentation file: ${file}`,
-        }, client, {
-            maxIterations,
-            validateFn: validator,
-            language: block.language,
+        if (codeBlocks.length === 0) {
+            console.log('No code blocks found in file.');
+            process.exit(0);
+        }
+        console.log(`Found ${codeBlocks.length} code block(s)`);
+        console.log('');
+        const client = createLLMClient({
+            provider: config.llm.provider,
+            model: config.llm.model,
+            baseUrl: config.llm.baseUrl,
         });
-        if (result.success) {
-            console.log(`  ✓ Fixed in ${result.iterations} iteration(s)`);
-            fixedCount++;
-            // Replace in content
-            const newBlock = '```' + block.language + '\n' + result.fixedCode + '```';
-            newContent = newContent.replace(block.match, newBlock);
+        const maxIterations = parseInt(options.maxIterations, 10);
+        if (isNaN(maxIterations) || maxIterations < 1) {
+            console.error('Error: --max-iterations must be a positive number');
+            process.exit(1);
         }
-        else {
-            console.log(`  ✗ Could not fix after ${result.iterations} iterations`);
-            failedCount++;
+        // Create validators
+        const validators = {
+            javascript: createTypeScriptValidator(),
+            typescript: createTypeScriptValidator(),
+            ts: createTypeScriptValidator(),
+            js: createTypeScriptValidator(),
+            python: createPythonValidator(),
+            py: createPythonValidator(),
+        };
+        let fixedCount = 0;
+        let failedCount = 0;
+        let newContent = content;
+        for (let i = 0; i < codeBlocks.length; i++) {
+            const block = codeBlocks[i];
+            if (!block)
+                continue;
+            const validator = validators[block.language.toLowerCase()];
+            if (!validator) {
+                console.log(`[${i + 1}/${codeBlocks.length}] Skipping ${block.language} (no validator)`);
+                continue;
+            }
+            console.log(`[${i + 1}/${codeBlocks.length}] Checking ${block.language} example...`);
+            // First check if it's valid
+            const initial = await validator(block.code);
+            if (initial.valid) {
+                console.log(`  ✓ Already valid`);
+                continue;
+            }
+            console.log(`  ✗ Invalid: ${initial.errors[0]?.slice(0, 60)}...`);
+            console.log(`  → Attempting to fix...`);
+            const result = await autoFixExample({
+                code: block.code,
+                language: block.language,
+                context: `Code example from documentation file: ${file}`,
+            }, client, {
+                maxIterations,
+                validateFn: validator,
+                language: block.language,
+            });
+            if (result.success) {
+                console.log(`  ✓ Fixed in ${result.iterations} iteration(s)`);
+                fixedCount++;
+                // Replace in content
+                const newBlock = '```' + block.language + '\n' + result.fixedCode + '```';
+                newContent = newContent.replace(block.match, newBlock);
+            }
+            else {
+                console.log(`  ✗ Could not fix after ${result.iterations} iterations`);
+                failedCount++;
+            }
         }
+        console.log('');
+        console.log('=== Summary ===');
+        console.log(`  Checked: ${codeBlocks.length}`);
+        console.log(`  Fixed:   ${fixedCount}`);
+        console.log(`  Failed:  ${failedCount}`);
+        if (fixedCount > 0 && !options.dryRun) {
+            writeFileSync(filePath, newContent);
+            console.log(`\nWrote fixes to ${filePath}`);
+            // Auto-fix then run QA on the fixed file's directory
+            const fixReport = fixQAIssues(dirname(filePath));
+            printFixReport(fixReport);
+            const qaReport = runQA(dirname(filePath));
+            printQAReport(qaReport);
+        }
+        else if (fixedCount > 0 && options.dryRun) {
+            console.log(`\n[dry run - no changes written]`);
+        }
+        console.log('\nDone!');
     }
-    console.log('');
-    console.log('=== Summary ===');
-    console.log(`  Checked: ${codeBlocks.length}`);
-    console.log(`  Fixed:   ${fixedCount}`);
-    console.log(`  Failed:  ${failedCount}`);
-    if (fixedCount > 0 && !options.dryRun) {
-        writeFileSync(filePath, newContent);
-        console.log(`\nWrote fixes to ${filePath}`);
-    }
-    else if (fixedCount > 0 && options.dryRun) {
-        console.log(`\n[dry run - no changes written]`);
+    catch (err) {
+        console.error(`Error: ${err instanceof Error ? err.message : err}`);
+        process.exit(1);
     }
-    console.log('\nDone!');
 });

package/dist/commands/cron.js

@@ -54,53 +54,64 @@ export const cronCommand = new Command('cron')
     .option('-s, --schedule <cron>', 'Cron schedule (default: daily at 2am UTC)', '0 2 * * *')
     .option('-f, --force', 'Overwrite existing workflow')
     .action(async (repoPath, options) => {
-    const resolvedPath = resolve(repoPath);
-    const workflowDir = join(resolvedPath, '.github', 'workflows');
-    const workflowPath = join(workflowDir, 'skrypt-docs.yml');
-    console.log('skrypt cron');
-    console.log(`  repo: ${resolvedPath}`);
-    console.log(`  schedule: ${options.schedule}`);
-    console.log('');
-    // Check if workflow exists
-    if (existsSync(workflowPath) && !options.force) {
-        console.log('Workflow already exists. Use --force to overwrite.');
-        console.log(`  ${workflowPath}`);
-        return;
+    try {
+        const resolvedPath = resolve(repoPath);
+        const workflowDir = join(resolvedPath, '.github', 'workflows');
+        const workflowPath = join(workflowDir, 'skrypt-docs.yml');
+        console.log('skrypt cron');
+        console.log(`  repo: ${resolvedPath}`);
+        console.log(`  schedule: ${options.schedule}`);
+        console.log('');
+        // Validate cron schedule format
+        if (options.schedule && !/^[\d\s*,\-/]+$/.test(options.schedule)) {
+            console.error('Error: Invalid cron schedule format');
+            process.exit(1);
+        }
+        // Check if workflow exists
+        if (existsSync(workflowPath) && !options.force) {
+            console.log('Workflow already exists. Use --force to overwrite.');
+            console.log(`  ${workflowPath}`);
+            return;
+        }
+        // Create workflow directory
+        mkdirSync(workflowDir, { recursive: true });
+        // Customize schedule if provided
+        let workflow = CRON_WORKFLOW;
+        if (options.schedule && options.schedule !== '0 2 * * *') {
+            workflow = workflow.replace("cron: '0 2 * * *'", `cron: '${options.schedule}'`);
+        }
+        // Write workflow
+        writeFileSync(workflowPath, workflow);
+        console.log(`✓ Created: ${workflowPath}`);
+        console.log('');
+        console.log('=== Setup Instructions ===');
+        console.log('');
+        console.log('1. Add secrets to your GitHub repository:');
+        console.log('   Settings > Secrets and variables > Actions');
+        console.log('');
+        console.log('   Required:');
+        console.log('   - SKRYPT_API_KEY: Get from https://skrypt.sh/dashboard/settings');
+        console.log('');
+        console.log('   For AI generation (one of):');
+        console.log('   - OPENAI_API_KEY');
+        console.log('   - ANTHROPIC_API_KEY');
+        console.log('');
+        console.log('2. Commit and push:');
+        console.log('   git add .github/');
+        console.log('   git commit -m "Add Skrypt auto-update workflow"');
+        console.log('   git push');
+        console.log('');
+        console.log('3. Trigger manually (optional):');
+        console.log('   Go to Actions > Skrypt Auto-Update Docs > Run workflow');
+        console.log('');
+        console.log('Common schedules:');
+        console.log('   "0 2 * * *"     - Daily at 2am UTC');
+        console.log('   "0 2 * * 1"     - Weekly on Monday');
+        console.log('   "0 2 1 * *"     - Monthly on the 1st');
+        console.log('   "0 */6 * * *"   - Every 6 hours');
     }
-    // Create workflow directory
-    mkdirSync(workflowDir, { recursive: true });
-    // Customize schedule if provided
-    let workflow = CRON_WORKFLOW;
-    if (options.schedule && options.schedule !== '0 2 * * *') {
-        workflow = workflow.replace("cron: '0 2 * * *'", `cron: '${options.schedule}'`);
+    catch (err) {
+        console.error(`Error: ${err instanceof Error ? err.message : err}`);
+        process.exit(1);
     }
-    // Write workflow
-    writeFileSync(workflowPath, workflow);
-    console.log(`✓ Created: ${workflowPath}`);
-    console.log('');
-    console.log('=== Setup Instructions ===');
-    console.log('');
-    console.log('1. Add secrets to your GitHub repository:');
-    console.log('   Settings > Secrets and variables > Actions');
-    console.log('');
-    console.log('   Required:');
-    console.log('   - SKRYPT_API_KEY: Get from https://skrypt.sh/dashboard/settings');
-    console.log('');
-    console.log('   For AI generation (one of):');
-    console.log('   - OPENAI_API_KEY');
-    console.log('   - ANTHROPIC_API_KEY');
-    console.log('');
-    console.log('2. Commit and push:');
-    console.log('   git add .github/');
-    console.log('   git commit -m "Add Skrypt auto-update workflow"');
-    console.log('   git push');
-    console.log('');
-    console.log('3. Trigger manually (optional):');
-    console.log('   Go to Actions > Skrypt Auto-Update Docs > Run workflow');
-    console.log('');
-    console.log('Common schedules:');
-    console.log('   "0 2 * * *"     - Daily at 2am UTC');
-    console.log('   "0 2 * * 1"     - Weekly on Monday');
-    console.log('   "0 2 1 * *"     - Monthly on the 1st');
-    console.log('   "0 */6 * * *"   - Every 6 hours');
 });

package/dist/commands/deploy.js

@@ -1,6 +1,6 @@
 import { Command } from 'commander';
 import { spawnSync, spawn } from 'child_process';
-import { existsSync, readFileSync, statSync } from 'fs';
+import { existsSync, readFileSync, statSync, unlinkSync } from 'fs';
 import { resolve, join } from 'path';
 import { homedir } from 'os';
 import { createHash } from 'crypto';
@@ -81,8 +81,7 @@ async function buildSite(docsPath) {
     return new Promise((resolve, reject) => {
         const child = spawn('npm', ['run', 'build'], {
             cwd: docsPath,
-            stdio: ['inherit', 'pipe', 'pipe'],
-            shell: true
+            stdio: ['inherit', 'pipe', 'pipe']
         });
         child.stdout?.on('data', (data) => {
             process.stdout.write(`  ${data.toString().trim()}\n`);
@@ -208,113 +207,135 @@ export const deployCommand = new Command('deploy')
     .option('--project <slug>', 'Project slug (e.g., my-docs)')
     .option('--token <key>', 'API token (or set SKRYPT_API_KEY env var)')
     .action(async (directory, options) => {
-    const startTime = Date.now();
-    const docsPath = resolve(directory);
-    console.log('skrypt deploy');
-    console.log(`  directory: ${docsPath}`);
-    console.log('');
-    // Validate directory
-    if (!existsSync(docsPath)) {
-        console.error(`Error: Directory not found: ${docsPath}`);
-        process.exit(1);
-    }
-    // Check for package.json (Next.js project)
-    const packageJsonPath = join(docsPath, 'package.json');
-    if (!existsSync(packageJsonPath)) {
-        console.error('Error: No package.json found. Is this a Skrypt docs site?');
-        console.error('  Run: skrypt init <directory>');
-        process.exit(1);
-    }
-    // Get API token
-    const apiToken = getApiToken(options);
-    if (!apiToken) {
-        console.error('Error: No API token found.');
-        console.error('');
-        console.error('  Provide a token using one of:');
-        console.error('    --token <key>');
-        console.error('    SKRYPT_API_KEY environment variable');
-        console.error('    skrypt login');
-        console.error('');
-        process.exit(1);
-    }
-    // Get project slug
-    const projectSlug = getProjectSlug(options, docsPath);
-    if (!projectSlug) {
-        console.error('Error: No project slug found.');
-        console.error('');
-        console.error('  Provide a project slug using one of:');
-        console.error('    --project <slug>');
-        console.error('    "slug" field in docs.json');
-        console.error('');
-        process.exit(1);
-    }
-    console.log(`  project: ${projectSlug}`);
-    console.log('');
-    // Step 1: Build the site
-    console.log('Step 1: Building documentation site...');
-    let outDir;
+    let bundlePath;
     try {
-        outDir = await buildSite(docsPath);
-    }
-    catch (err) {
-        console.error('');
-        console.error(`Error: Build failed`);
-        if (err instanceof Error) {
-            console.error(`  ${err.message}`);
+        const startTime = Date.now();
+        const docsPath = resolve(directory);
+        console.log('skrypt deploy');
+        console.log(`  directory: ${docsPath}`);
+        console.log('');
+        // Validate directory
+        if (!existsSync(docsPath)) {
+            console.error(`Error: Directory not found: ${docsPath}`);
+            process.exit(1);
         }
-        process.exit(1);
-    }
-    // Check build output exists
-    if (!existsSync(outDir)) {
-        // Try .next/static for non-static export
-        const nextDir = join(docsPath, '.next');
-        if (existsSync(nextDir)) {
+        // Check for package.json (Next.js project)
+        const packageJsonPath = join(docsPath, 'package.json');
+        if (!existsSync(packageJsonPath)) {
+            console.error('Error: No package.json found. Is this a Skrypt docs site?');
+            console.error('  Run: skrypt init <directory>');
+            process.exit(1);
+        }
+        // Get API token
+        const apiToken = getApiToken(options);
+        if (!apiToken) {
+            console.error('Error: No API token found.');
+            console.error('');
+            console.error('  Provide a token using one of:');
+            console.error('    --token <key>');
+            console.error('    SKRYPT_API_KEY environment variable');
+            console.error('    skrypt login');
             console.error('');
-            console.error('Error: Static export not found.');
-            console.error('  Add to next.config.mjs: output: "export"');
             process.exit(1);
         }
-        console.error('');
-        console.error('Error: Build output not found.');
-        process.exit(1);
-    }
-    console.log('  Build completed successfully');
-    console.log('');
-    // Step 2: Bundle the output
-    console.log('Step 2: Creating deployment bundle...');
-    let bundlePath;
-    try {
-        bundlePath = await bundleOutput(outDir);
+        // Get project slug
+        const projectSlug = getProjectSlug(options, docsPath);
+        if (!projectSlug) {
+            console.error('Error: No project slug found.');
+            console.error('');
+            console.error('  Provide a project slug using one of:');
+            console.error('    --project <slug>');
+            console.error('    "slug" field in docs.json');
+            console.error('');
+            process.exit(1);
+        }
+        console.log(`  project: ${projectSlug}`);
+        console.log('');
+        // Step 1: Build the site
+        console.log('Step 1: Building documentation site...');
+        let outDir;
+        try {
+            outDir = await buildSite(docsPath);
+        }
+        catch (err) {
+            console.error('');
+            console.error(`Error: Build failed`);
+            if (err instanceof Error) {
+                console.error(`  ${err.message}`);
+            }
+            process.exit(1);
+        }
+        // Check build output exists
+        if (!existsSync(outDir)) {
+            // Try .next/static for non-static export
+            const nextDir = join(docsPath, '.next');
+            if (existsSync(nextDir)) {
+                console.error('');
+                console.error('Error: Static export not found.');
+                console.error('  Add to next.config.mjs: output: "export"');
+                process.exit(1);
+            }
+            console.error('');
+            console.error('Error: Build output not found.');
+            process.exit(1);
+        }
+        console.log('  Build completed successfully');
+        console.log('');
+        // Step 2: Bundle the output
+        console.log('Step 2: Creating deployment bundle...');
+        try {
+            bundlePath = await bundleOutput(outDir);
+        }
+        catch (err) {
+            console.error('');
+            console.error('Error: Failed to create bundle');
+            if (err instanceof Error) {
+                console.error(`  ${err.message}`);
+            }
+            process.exit(1);
+        }
+        console.log('');
+        // Step 3: Upload
+        console.log('Step 3: Deploying to Skrypt...');
+        const result = await uploadBundle(bundlePath, projectSlug, apiToken);
+        if (!result.success) {
+            console.error('');
+            console.error(`Error: Deployment failed`);
+            console.error(`  ${result.error}`);
+            // Clean up temp bundle
+            try {
+                unlinkSync(bundlePath);
+            }
+            catch { /* ignore cleanup errors */ }
+            process.exit(1);
+        }
+        // Clean up temp bundle
+        try {
+            unlinkSync(bundlePath);
+        }
+        catch { /* ignore cleanup errors */ }
+        // Success
+        const duration = Math.round((Date.now() - startTime) / 1000);
+        console.log('');
+        console.log('=== Deployment Successful ===');
+        console.log('');
+        console.log(`  URL: ${result.url}`);
+        if (result.customDomain) {
+            console.log(`  Custom domain: ${result.customDomain}`);
+        }
+        console.log(`  Duration: ${duration}s`);
+        console.log('');
+        console.log('Your documentation is now live!');
+        console.log('');
     }
     catch (err) {
-        console.error('');
-        console.error('Error: Failed to create bundle');
-        if (err instanceof Error) {
-            console.error(`  ${err.message}`);
+        if (bundlePath) {
+            try {
+                unlinkSync(bundlePath);
+            }
+            catch { /* ignore cleanup errors */ }
         }
+        console.error(`Error: ${err instanceof Error ? err.message : err}`);
         process.exit(1);
     }
-    console.log('');
-    // Step 3: Upload
-    console.log('Step 3: Deploying to Skrypt...');
-    const result = await uploadBundle(bundlePath, projectSlug, apiToken);
-    if (!result.success) {
-        console.error('');
-        console.error(`Error: Deployment failed`);
-        console.error(`  ${result.error}`);
-        process.exit(1);
-    }
-    // Success
-    const duration = Math.round((Date.now() - startTime) / 1000);
-    console.log('');
-    console.log('=== Deployment Successful ===');
-    console.log('');
-    console.log(`  URL: ${result.url}`);
-    if (result.customDomain) {
-        console.log(`  Custom domain: ${result.customDomain}`);
-    }
-    console.log(`  Duration: ${duration}s`);
-    console.log('');
-    console.log('Your documentation is now live!');
-    console.log('');
 });