skrypt-ai 0.4.2 → 0.6.0

package/dist/commands/i18n.js

@@ -6,7 +6,12 @@ const CONFIG_FILE = 'skrypt.i18n.json';
 function loadI18nConfig(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 { defaultLocale: 'en', locales: ['en'] };
+        }
     }
     return { defaultLocale: 'en', locales: ['en'] };
 }
@@ -22,25 +27,31 @@ i18nCommand
     .argument('[docs-path]', 'Documentation directory', './docs')
     .option('--default <locale>', 'Default locale', 'en')
     .action((docsPath, options) => {
-    const resolvedPath = resolve(docsPath);
-    if (!existsSync(resolvedPath)) {
-        console.error(`Directory not found: ${resolvedPath}`);
-        process.exit(1);
+    try {
+        const resolvedPath = resolve(docsPath);
+        if (!existsSync(resolvedPath)) {
+            console.error(`Directory not found: ${resolvedPath}`);
+            process.exit(1);
+        }
+        const config = {
+            defaultLocale: options.default,
+            locales: [options.default],
+        };
+        saveI18nConfig(resolvedPath, config);
+        // Create locale directory structure
+        const localeDir = join(resolvedPath, options.default);
+        if (!existsSync(localeDir)) {
+            mkdirSync(localeDir, { recursive: true });
+            console.log(`Created locale directory: ${localeDir}`);
+        }
+        console.log('i18n initialized.');
+        console.log(`  Default locale: ${options.default}`);
+        console.log(`  Config: ${join(resolvedPath, CONFIG_FILE)}`);
     }
-    const config = {
-        defaultLocale: options.default,
-        locales: [options.default],
-    };
-    saveI18nConfig(resolvedPath, config);
-    // Create locale directory structure
-    const localeDir = join(resolvedPath, options.default);
-    if (!existsSync(localeDir)) {
-        mkdirSync(localeDir, { recursive: true });
-        console.log(`Created locale directory: ${localeDir}`);
+    catch (err) {
+        console.error(`Error: ${err instanceof Error ? err.message : err}`);
+        process.exit(1);
     }
-    console.log('i18n initialized.');
-    console.log(`  Default locale: ${options.default}`);
-    console.log(`  Config: ${join(resolvedPath, CONFIG_FILE)}`);
 });
 i18nCommand
     .command('add')
@@ -48,53 +59,65 @@ i18nCommand
     .argument('<locale>', 'Locale code (e.g., ja, fr, de)')
     .argument('[docs-path]', 'Documentation directory', './docs')
     .action((locale, docsPath) => {
-    const resolvedPath = resolve(docsPath);
-    const config = loadI18nConfig(resolvedPath);
-    if (config.locales.includes(locale)) {
-        console.log(`Locale ${locale} already exists.`);
-        return;
+    try {
+        const resolvedPath = resolve(docsPath);
+        const config = loadI18nConfig(resolvedPath);
+        if (config.locales.includes(locale)) {
+            console.log(`Locale ${locale} already exists.`);
+            return;
+        }
+        config.locales.push(locale);
+        saveI18nConfig(resolvedPath, config);
+        // Create locale directory
+        const localeDir = join(resolvedPath, locale);
+        mkdirSync(localeDir, { recursive: true });
+        console.log(`Added locale: ${locale}`);
+        console.log(`  Directory: ${localeDir}`);
+    }
+    catch (err) {
+        console.error(`Error: ${err instanceof Error ? err.message : err}`);
+        process.exit(1);
     }
-    config.locales.push(locale);
-    saveI18nConfig(resolvedPath, config);
-    // Create locale directory
-    const localeDir = join(resolvedPath, locale);
-    mkdirSync(localeDir, { recursive: true });
-    console.log(`Added locale: ${locale}`);
-    console.log(`  Directory: ${localeDir}`);
 });
 i18nCommand
     .command('status')
     .description('Show translation status')
     .argument('[docs-path]', 'Documentation directory', './docs')
     .action((docsPath) => {
-    const resolvedPath = resolve(docsPath);
-    const config = loadI18nConfig(resolvedPath);
-    console.log('i18n Status');
-    console.log(`  Default locale: ${config.defaultLocale}`);
-    console.log(`  Locales: ${config.locales.join(', ')}`);
-    console.log('');
-    // Get files from default locale
-    const defaultDir = join(resolvedPath, config.defaultLocale);
-    if (!existsSync(defaultDir)) {
-        console.log(`Default locale directory not found: ${defaultDir}`);
-        return;
-    }
-    const defaultFiles = findMdxFiles(defaultDir);
-    console.log(`Default locale (${config.defaultLocale}): ${defaultFiles.length} files`);
-    // Check each other locale
-    for (const locale of config.locales) {
-        if (locale === config.defaultLocale)
-            continue;
-        const localeDir = join(resolvedPath, locale);
-        if (!existsSync(localeDir)) {
-            console.log(`${locale}: 0/${defaultFiles.length} (directory missing)`);
-            continue;
+    try {
+        const resolvedPath = resolve(docsPath);
+        const config = loadI18nConfig(resolvedPath);
+        console.log('i18n Status');
+        console.log(`  Default locale: ${config.defaultLocale}`);
+        console.log(`  Locales: ${config.locales.join(', ')}`);
+        console.log('');
+        // Get files from default locale
+        const defaultDir = join(resolvedPath, config.defaultLocale);
+        if (!existsSync(defaultDir)) {
+            console.log(`Default locale directory not found: ${defaultDir}`);
+            return;
+        }
+        const defaultFiles = findMdxFiles(defaultDir);
+        console.log(`Default locale (${config.defaultLocale}): ${defaultFiles.length} files`);
+        // Check each other locale
+        for (const locale of config.locales) {
+            if (locale === config.defaultLocale)
+                continue;
+            const localeDir = join(resolvedPath, locale);
+            if (!existsSync(localeDir)) {
+                console.log(`${locale}: 0/${defaultFiles.length} (directory missing)`);
+                continue;
+            }
+            const localeFiles = findMdxFiles(localeDir);
+            const translated = localeFiles.length;
+            const total = defaultFiles.length;
+            const pct = total > 0 ? Math.round((translated / total) * 100) : 0;
+            console.log(`${locale}: ${translated}/${total} (${pct}%)`);
         }
-        const localeFiles = findMdxFiles(localeDir);
-        const translated = localeFiles.length;
-        const total = defaultFiles.length;
-        const pct = total > 0 ? Math.round((translated / total) * 100) : 0;
-        console.log(`${locale}: ${translated}/${total} (${pct}%)`);
+    }
+    catch (err) {
+        console.error(`Error: ${err instanceof Error ? err.message : err}`);
+        process.exit(1);
     }
 });
 i18nCommand
@@ -103,34 +126,40 @@ i18nCommand
     .argument('<locale>', 'Locale to check')
     .argument('[docs-path]', 'Documentation directory', './docs')
     .action((locale, docsPath) => {
-    const resolvedPath = resolve(docsPath);
-    const config = loadI18nConfig(resolvedPath);
-    if (!config.locales.includes(locale)) {
-        console.error(`Locale ${locale} not configured.`);
-        process.exit(1);
-    }
-    const defaultDir = join(resolvedPath, config.defaultLocale);
-    const localeDir = join(resolvedPath, locale);
-    if (!existsSync(defaultDir)) {
-        console.error(`Default locale directory not found: ${defaultDir}`);
-        process.exit(1);
-    }
-    const defaultFiles = findMdxFiles(defaultDir);
-    const missing = [];
-    for (const file of defaultFiles) {
-        const relPath = relative(defaultDir, file);
-        const localePath = join(localeDir, relPath);
-        if (!existsSync(localePath)) {
-            missing.push(relPath);
+    try {
+        const resolvedPath = resolve(docsPath);
+        const config = loadI18nConfig(resolvedPath);
+        if (!config.locales.includes(locale)) {
+            console.error(`Locale ${locale} not configured.`);
+            process.exit(1);
+        }
+        const defaultDir = join(resolvedPath, config.defaultLocale);
+        const localeDir = join(resolvedPath, locale);
+        if (!existsSync(defaultDir)) {
+            console.error(`Default locale directory not found: ${defaultDir}`);
+            process.exit(1);
+        }
+        const defaultFiles = findMdxFiles(defaultDir);
+        const missing = [];
+        for (const file of defaultFiles) {
+            const relPath = relative(defaultDir, file);
+            const localePath = join(localeDir, relPath);
+            if (!existsSync(localePath)) {
+                missing.push(relPath);
+            }
+        }
+        if (missing.length === 0) {
+            console.log(`All files translated for ${locale}!`);
+            return;
+        }
+        console.log(`Missing translations for ${locale} (${missing.length} files):`);
+        for (const file of missing) {
+            console.log(`  ${file}`);
         }
     }
-    if (missing.length === 0) {
-        console.log(`All files translated for ${locale}!`);
-        return;
-    }
-    console.log(`Missing translations for ${locale} (${missing.length} files):`);
-    for (const file of missing) {
-        console.log(`  ${file}`);
+    catch (err) {
+        console.error(`Error: ${err instanceof Error ? err.message : err}`);
+        process.exit(1);
     }
 });
 i18nCommand
@@ -139,35 +168,41 @@ i18nCommand
     .argument('[docs-path]', 'Documentation directory', './docs')
     .option('-o, --output <file>', 'Output file', 'strings.json')
     .action((docsPath, options) => {
-    const resolvedPath = resolve(docsPath);
-    const config = loadI18nConfig(resolvedPath);
-    const defaultDir = join(resolvedPath, config.defaultLocale);
-    if (!existsSync(defaultDir)) {
-        console.error(`Default locale directory not found: ${defaultDir}`);
-        process.exit(1);
-    }
-    const files = findMdxFiles(defaultDir);
-    const strings = {};
-    for (const file of files) {
-        const relPath = relative(defaultDir, file);
-        const content = readFileSync(file, 'utf-8');
-        const lines = content.split('\n');
-        const fileStrings = {};
-        for (const line of lines) {
-            // Extract headings
-            const headingMatch = line.match(/^(#{1,6})\s+(.+)$/);
-            if (headingMatch) {
-                const key = `heading_${Object.keys(fileStrings).length}`;
-                fileStrings[key] = headingMatch[2];
-            }
+    try {
+        const resolvedPath = resolve(docsPath);
+        const config = loadI18nConfig(resolvedPath);
+        const defaultDir = join(resolvedPath, config.defaultLocale);
+        if (!existsSync(defaultDir)) {
+            console.error(`Default locale directory not found: ${defaultDir}`);
+            process.exit(1);
         }
-        if (Object.keys(fileStrings).length > 0) {
-            strings[relPath] = fileStrings;
+        const files = findMdxFiles(defaultDir);
+        const strings = {};
+        for (const file of files) {
+            const relPath = relative(defaultDir, file);
+            const content = readFileSync(file, 'utf-8');
+            const lines = content.split('\n');
+            const fileStrings = {};
+            for (const line of lines) {
+                // Extract headings
+                const headingMatch = line.match(/^(#{1,6})\s+(.+)$/);
+                if (headingMatch) {
+                    const key = `heading_${Object.keys(fileStrings).length}`;
+                    fileStrings[key] = headingMatch[2];
+                }
+            }
+            if (Object.keys(fileStrings).length > 0) {
+                strings[relPath] = fileStrings;
+            }
         }
+        const outputPath = resolve(options.output);
+        writeFileSync(outputPath, JSON.stringify(strings, null, 2));
+        console.log(`Extracted strings to: ${outputPath}`);
+        console.log(`  Files: ${Object.keys(strings).length}`);
+        console.log(`  Strings: ${Object.values(strings).reduce((a, b) => a + Object.keys(b).length, 0)}`);
+    }
+    catch (err) {
+        console.error(`Error: ${err instanceof Error ? err.message : err}`);
+        process.exit(1);
     }
-    const outputPath = resolve(options.output);
-    writeFileSync(outputPath, JSON.stringify(strings, null, 2));
-    console.log(`Extracted strings to: ${outputPath}`);
-    console.log(`  Files: ${Object.keys(strings).length}`);
-    console.log(`  Strings: ${Object.values(strings).reduce((a, b) => a + Object.keys(b).length, 0)}`);
 });

package/dist/commands/import.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare const importCommand: Command;

package/dist/commands/import.js

@@ -0,0 +1,157 @@
+import { Command } from 'commander';
+import { existsSync, mkdirSync, cpSync, readFileSync, writeFileSync } from 'fs';
+import { resolve, join, dirname, basename } from 'path';
+import { fileURLToPath } from 'url';
+import { detectFormat, isGitHubUrl, parseGitHubUrl, runImport, importFromGitHub } from '../importers/index.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+export const importCommand = new Command('import')
+    .description('Import documentation from another platform')
+    .argument('<source>', 'Local directory or GitHub URL')
+    .option('--from <format>', 'Source format (mintlify, docusaurus, gitbook, readme, notion, confluence, markdown)')
+    .option('-o, --output <dir>', 'Output directory')
+    .option('--dry-run', 'Show what would be imported without writing files')
+    .option('--name <name>', 'Project name')
+    .action(async (source, options) => {
+    try {
+        console.log('skrypt import\n');
+        // Validate --from flag
+        const VALID_FORMATS = ['mintlify', 'docusaurus', 'gitbook', 'readme', 'notion', 'confluence', 'markdown'];
+        if (options.from && !VALID_FORMATS.includes(options.from)) {
+            console.error(`  Error: Unknown format "${options.from}". Valid formats: ${VALID_FORMATS.join(', ')}`);
+            process.exit(1);
+        }
+        let result;
+        if (isGitHubUrl(source)) {
+            // GitHub URL import
+            const { owner, repo, path, ref } = parseGitHubUrl(source);
+            console.log(`  Source: github.com/${owner}/${repo}/${path} (${ref})`);
+            result = await importFromGitHub(owner, repo, path, ref, {
+                format: options.from,
+                name: options.name,
+            });
+        }
+        else {
+            // Local directory import
+            const sourceDir = resolve(source);
+            if (!existsSync(sourceDir)) {
+                console.error(`  Error: Source directory not found: ${sourceDir}`);
+                process.exit(1);
+            }
+            const format = options.from || detectFormat(sourceDir);
+            console.log(`  Source: ${sourceDir} (${format})`);
+            result = runImport(sourceDir, format, options.name);
+        }
+        // Determine output directory
+        const outputDir = resolve(options.output || `${basename(source).replace(/[^a-zA-Z0-9-_]/g, '-')}-docs`);
+        console.log(`  Output: ${outputDir}`);
+        console.log('');
+        // Print migration report
+        printReport(result);
+        if (options.dryRun) {
+            console.log('  [dry run — no files written]\n');
+            return;
+        }
+        // Scaffold output directory
+        scaffoldOutput(outputDir, result);
+        console.log('  Next steps:');
+        console.log(`    cd ${outputDir} && npm install && npm run dev\n`);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.error(`  Error: ${message}`);
+        process.exit(1);
+    }
+});
+function printReport(result) {
+    console.log('  Imported:');
+    console.log(`    ${result.stats.pages} pages across ${result.stats.groups} groups`);
+    const { transforms } = result.stats;
+    if (transforms.callouts > 0)
+        console.log(`    ${transforms.callouts} callouts mapped`);
+    if (transforms.tabs > 0)
+        console.log(`    ${transforms.tabs} tabs mapped`);
+    if (transforms.codeGroups > 0)
+        console.log(`    ${transforms.codeGroups} code groups mapped`);
+    if (transforms.steps > 0)
+        console.log(`    ${transforms.steps} steps mapped`);
+    if (transforms.accordions > 0)
+        console.log(`    ${transforms.accordions} accordions mapped`);
+    if (transforms.images > 0)
+        console.log(`    ${transforms.images} images copied`);
+    if (result.warnings.length > 0) {
+        console.log('');
+        console.log('  Warnings:');
+        for (const w of result.warnings.slice(0, 10)) {
+            console.log(`    - ${w}`);
+        }
+        if (result.warnings.length > 10) {
+            console.log(`    ... and ${result.warnings.length - 10} more`);
+        }
+    }
+    console.log('');
+}
+function scaffoldOutput(outputDir, result) {
+    // Copy template
+    const templateDir = join(__dirname, '..', 'template');
+    if (existsSync(templateDir)) {
+        mkdirSync(outputDir, { recursive: true });
+        cpSync(templateDir, outputDir, { recursive: true });
+    }
+    else {
+        mkdirSync(outputDir, { recursive: true });
+    }
+    // Write transformed content files
+    for (const [filePath, content] of result.files) {
+        const outputPath = join(outputDir, filePath);
+        mkdirSync(dirname(outputPath), { recursive: true });
+        writeFileSync(outputPath, content);
+    }
+    // Copy assets
+    for (const [destPath, srcPath] of result.assets) {
+        const outputPath = join(outputDir, destPath);
+        mkdirSync(dirname(outputPath), { recursive: true });
+        try {
+            cpSync(srcPath, outputPath);
+        }
+        catch {
+            // Image may not exist (e.g. CDN URL)
+        }
+    }
+    // Generate docs.json navigation
+    const docsJson = {
+        name: result.name,
+        description: result.description,
+        theme: {
+            primaryColor: '#3b82f6',
+            accentColor: '#8b5cf6',
+            font: 'Inter',
+        },
+        navigation: result.navigation.map(group => ({
+            group: group.group,
+            pages: group.pages.map(page => ({
+                title: page.title,
+                path: `/docs/${page.slug}`,
+            })),
+        })),
+        footer: {
+            links: [],
+        },
+    };
+    writeFileSync(join(outputDir, 'docs.json'), JSON.stringify(docsJson, null, 2));
+    // Update package.json name if template exists
+    const pkgPath = join(outputDir, 'package.json');
+    if (existsSync(pkgPath)) {
+        try {
+            const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+            pkg.name = result.name.toLowerCase().replace(/[^a-z0-9-]/g, '-');
+            writeFileSync(pkgPath, JSON.stringify(pkg, null, 2));
+        }
+        catch { /* skip */ }
+    }
+    console.log(`  ✓ Wrote ${result.files.size} pages to ${outputDir}`);
+    if (result.assets.size > 0) {
+        console.log(`  ✓ Copied ${result.assets.size} assets`);
+    }
+    console.log('');
+}

package/dist/commands/init.js

@@ -35,15 +35,27 @@ export const initCommand = new Command('init')
         cpSync(templateDir, targetDir, { recursive: true });
         // Update package.json with project name
         const packageJsonPath = join(targetDir, 'package.json');
-        const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
-        packageJson.name = options.name;
-        writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2));
+        try {
+            const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+            packageJson.name = options.name;
+            writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2));
+        }
+        catch {
+            console.error('Error: Template package.json is missing or corrupted. Please reinstall skrypt.');
+            process.exit(1);
+        }
         // Update docs.json with project name
         const docsJsonPath = join(targetDir, 'docs.json');
-        const docsJson = JSON.parse(readFileSync(docsJsonPath, 'utf-8'));
-        docsJson.name = options.name;
-        docsJson.description = `${options.name} documentation`;
-        writeFileSync(docsJsonPath, JSON.stringify(docsJson, null, 2));
+        try {
+            const docsJson = JSON.parse(readFileSync(docsJsonPath, 'utf-8'));
+            docsJson.name = options.name;
+            docsJson.description = `${options.name} documentation`;
+            writeFileSync(docsJsonPath, JSON.stringify(docsJson, null, 2));
+        }
+        catch {
+            console.error('Error: Template docs.json is missing or corrupted. Please reinstall skrypt.');
+            process.exit(1);
+        }
         console.log('');
         console.log('Done! Next steps:');
         console.log('');

package/dist/commands/lint.js

@@ -198,55 +198,61 @@ export const lintCommand = new Command('lint')
     .option('--fix', 'Attempt to fix issues automatically')
     .option('-c, --config <file>', 'Config file with custom rules')
     .action(async (path, _options) => {
-    const targetPath = resolve(path);
-    if (!existsSync(targetPath)) {
-        console.error(`Error: Path not found: ${targetPath}`);
-        process.exit(1);
-    }
-    console.log('skrypt lint');
-    console.log(`  path: ${targetPath}`);
-    console.log('');
-    // Find all MDX files
-    const files = statSync(targetPath).isDirectory()
-        ? findMdxFiles(targetPath)
-        : [targetPath];
-    if (files.length === 0) {
-        console.log('No .md or .mdx files found.');
-        process.exit(0);
-    }
-    console.log(`Linting ${files.length} files...\n`);
-    let totalErrors = 0;
-    let totalWarnings = 0;
-    const results = [];
-    for (const file of files) {
-        const result = lintFile(file);
-        if (result.issues.length > 0) {
-            results.push(result);
+    try {
+        const targetPath = resolve(path);
+        if (!existsSync(targetPath)) {
+            console.error(`Error: Path not found: ${targetPath}`);
+            process.exit(1);
+        }
+        console.log('skrypt lint');
+        console.log(`  path: ${targetPath}`);
+        console.log('');
+        // Find all MDX files
+        const files = statSync(targetPath).isDirectory()
+            ? findMdxFiles(targetPath)
+            : [targetPath];
+        if (files.length === 0) {
+            console.log('No .md or .mdx files found.');
+            process.exit(0);
+        }
+        console.log(`Linting ${files.length} files...\n`);
+        let totalErrors = 0;
+        let totalWarnings = 0;
+        const results = [];
+        for (const file of files) {
+            const result = lintFile(file);
+            if (result.issues.length > 0) {
+                results.push(result);
+                for (const issue of result.issues) {
+                    if (issue.severity === 'error')
+                        totalErrors++;
+                    else
+                        totalWarnings++;
+                }
+            }
+        }
+        // Print results
+        for (const result of results) {
+            const relPath = result.file.replace(targetPath + '/', '');
+            console.log(`\n${relPath}`);
             for (const issue of result.issues) {
-                if (issue.severity === 'error')
-                    totalErrors++;
-                else
-                    totalWarnings++;
+                const icon = issue.severity === 'error' ? '✖' : '⚠';
+                const color = issue.severity === 'error' ? '\x1b[31m' : '\x1b[33m';
+                const reset = '\x1b[0m';
+                console.log(`  ${color}${icon}${reset} ${issue.line}:${issue.column}  ${issue.message}  ${color}${issue.rule}${reset}`);
             }
         }
-    }
-    // Print results
-    for (const result of results) {
-        const relPath = result.file.replace(targetPath + '/', '');
-        console.log(`\n${relPath}`);
-        for (const issue of result.issues) {
-            const icon = issue.severity === 'error' ? '✖' : '⚠';
-            const color = issue.severity === 'error' ? '\x1b[31m' : '\x1b[33m';
-            const reset = '\x1b[0m';
-            console.log(`  ${color}${icon}${reset} ${issue.line}:${issue.column}  ${issue.message}  ${color}${issue.rule}${reset}`);
+        // Summary
+        console.log('\n=== Summary ===');
+        console.log(`  Files:    ${files.length}`);
+        console.log(`  Errors:   ${totalErrors}`);
+        console.log(`  Warnings: ${totalWarnings}`);
+        if (totalErrors > 0) {
+            process.exit(1);
         }
     }
-    // Summary
-    console.log('\n=== Summary ===');
-    console.log(`  Files:    ${files.length}`);
-    console.log(`  Errors:   ${totalErrors}`);
-    console.log(`  Warnings: ${totalWarnings}`);
-    if (totalErrors > 0) {
+    catch (err) {
+        console.error(`Error: ${err instanceof Error ? err.message : err}`);
         process.exit(1);
     }
 });