skrypt-ai 0.5.0 → 0.6.1

package/dist/capture/parser.js

@@ -0,0 +1,80 @@
+/**
+ * Extract <Screenshot> directives from MDX files.
+ *
+ * Scans MDX content for <Screenshot> tags outside code blocks.
+ * Uses the same code-block-aware scanning pattern as src/qa/checks.ts.
+ */
+/**
+ * Parse all <Screenshot> directives from MDX content.
+ *
+ * Supports both self-closing (<Screenshot ... />) and open/close tags.
+ * Extracts url, selector, alt, caption props via regex.
+ * Resolves relative URLs against baseUrl.
+ */
+export function parseScreenshotDirectives(content, filePath, baseUrl) {
+    const directives = [];
+    const lines = content.split('\n');
+    let inCodeBlock = false;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if (line === undefined)
+            continue;
+        if (line.startsWith('```')) {
+            inCodeBlock = !inCodeBlock;
+            continue;
+        }
+        if (inCodeBlock)
+            continue;
+        // Match <Screenshot ...> or <Screenshot ... />
+        const tagMatches = line.matchAll(/<Screenshot\s+([^>]*?)\/?>/g);
+        for (const match of tagMatches) {
+            const propsStr = match[1];
+            if (!propsStr)
+                continue;
+            const url = extractProp(propsStr, 'url');
+            const alt = extractProp(propsStr, 'alt');
+            if (!url || !alt)
+                continue;
+            const selector = extractProp(propsStr, 'selector');
+            const caption = extractProp(propsStr, 'caption');
+            // Resolve relative URLs against baseUrl
+            let resolvedUrl;
+            if (url.startsWith('http://') || url.startsWith('https://')) {
+                resolvedUrl = url;
+            }
+            else {
+                // Ensure baseUrl doesn't have trailing slash for clean join
+                const base = baseUrl.replace(/\/+$/, '');
+                const path = url.startsWith('/') ? url : `/${url}`;
+                resolvedUrl = `${base}${path}`;
+            }
+            directives.push({
+                url: resolvedUrl,
+                selector: selector || undefined,
+                alt,
+                caption: caption || undefined,
+                sourceFile: filePath,
+                sourceLine: i + 1,
+            });
+        }
+    }
+    return directives;
+}
+/**
+ * Extract a prop value from a JSX props string.
+ * Handles both quoted values: prop="value" and prop='value'
+ * Also handles JSX expressions: prop={"value"} and prop={'value'}
+ */
+function extractProp(propsStr, propName) {
+    // Match prop="value" or prop='value'
+    const quoteRegex = new RegExp(`${propName}\\s*=\\s*["']([^"']*?)["']`);
+    const quoteMatch = propsStr.match(quoteRegex);
+    if (quoteMatch?.[1] !== undefined)
+        return quoteMatch[1];
+    // Match prop={"value"} or prop={'value'}
+    const jsxRegex = new RegExp(`${propName}\\s*=\\s*\\{\\s*["']([^"']*?)["']\\s*\\}`);
+    const jsxMatch = propsStr.match(jsxRegex);
+    if (jsxMatch?.[1] !== undefined)
+        return jsxMatch[1];
+    return null;
+}

package/dist/capture/types.d.ts

@@ -0,0 +1,57 @@
+export interface ScreenshotDirective {
+    url: string;
+    selector?: string;
+    alt: string;
+    caption?: string;
+    sourceFile: string;
+    sourceLine: number;
+}
+export interface ScreenshotResult {
+    directive: ScreenshotDirective;
+    filename: string;
+    darkFilename?: string;
+    status: 'captured' | 'unchanged' | 'failed';
+    error?: string;
+    hash?: string;
+    duration: number;
+}
+export interface CaptureReport {
+    directives: number;
+    captured: number;
+    unchanged: number;
+    failed: number;
+    duration: number;
+    results: ScreenshotResult[];
+}
+export interface ScreenshotManifest {
+    version: 1;
+    capturedAt: string;
+    baseUrl: string;
+    viewport: {
+        width: number;
+        height: number;
+    };
+    screenshots: Record<string, {
+        url: string;
+        selector?: string;
+        filename: string;
+        darkFilename?: string;
+        capturedAt: string;
+        hash: string;
+    }>;
+}
+export interface CaptureOptions {
+    baseUrl: string;
+    outputDir: string;
+    viewport: {
+        width: number;
+        height: number;
+    };
+    dark: boolean;
+    diff: boolean;
+    dryRun: boolean;
+    timeout: number;
+    wait: number;
+    device?: string;
+    concurrency: number;
+}

package/dist/capture/types.js

@@ -0,0 +1 @@
+export {};

package/dist/cli.js

@@ -6,6 +6,7 @@ import { watchCommand } from './commands/watch.js';
 import { autofixCommand } from './commands/autofix.js';
 import { reviewPRCommand } from './commands/review-pr.js';
 import { lintCommand } from './commands/lint.js';
+import { qaCommand } from './commands/qa.js';
 import { checkLinksCommand } from './commands/check-links.js';
 import { mcpCommand } from './commands/mcp.js';
 import { versionCommand } from './commands/version.js';
@@ -20,6 +21,7 @@ import { deployCommand } from './commands/deploy.js';
 import { testCommand } from './commands/test.js';
 import { securityCommand } from './commands/security.js';
 import { importCommand } from './commands/import.js';
+import { healCommand } from './commands/heal.js';
 import { createRequire } from 'module';
 process.on('uncaughtException', (err) => {
     console.error('\x1b[31mFatal error:\x1b[0m', err.message);
@@ -77,6 +79,7 @@ program.addCommand(watchCommand);
 program.addCommand(autofixCommand);
 program.addCommand(reviewPRCommand);
 program.addCommand(lintCommand);
+program.addCommand(qaCommand);
 program.addCommand(checkLinksCommand);
 program.addCommand(mcpCommand);
 program.addCommand(versionCommand);
@@ -93,4 +96,5 @@ program.addCommand(deployCommand);
 program.addCommand(testCommand);
 program.addCommand(securityCommand);
 program.addCommand(importCommand);
+program.addCommand(healCommand);
 program.parse();

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');
 });