skrypt-ai 0.3.3 → 0.4.0

package/dist/generator/writer.js

@@ -2,6 +2,7 @@ import { mkdir, writeFile } from 'fs/promises';
 import { dirname, join, basename, relative } from 'path';
 import { formatAsMarkdown } from './generator.js';
 import { organizeByTopic, detectCrossReferences, getCrossRefsForElement } from './organizer.js';
+import { slugify } from '../utils/files.js';
 /**
  * Generate llms.txt file (Answer Engine Optimization)
  * Format follows https://llmstxt.org convention
@@ -90,7 +91,7 @@ export async function writeDocsToDirectory(results, outputDir, sourceDir) {
         // Create subdirectories if needed
         await mkdir(dirname(outputPath), { recursive: true });
         // Generate markdown content
-        const title = basename(result.filePath, '.py')
+        const title = basename(result.filePath).replace(/\.[^.]+$/, '')
             .replace(/^./, c => c.toUpperCase())
             .replace(/_/g, ' ');
         const content = formatAsMarkdown(result.docs, title);
@@ -313,12 +314,3 @@ async function writeSidebarConfig(topics, outputDir) {
     };
     await writeFile(join(outputDir, '_sidebars.json'), JSON.stringify(docusaurusSidebar, null, 2), 'utf-8');
 }
-/**
- * Convert string to URL-safe slug
- */
-function slugify(str) {
-    return str
-        .toLowerCase()
-        .replace(/[^a-z0-9]+/g, '-')
-        .replace(/^-|-$/g, '');
-}

package/dist/github/pr-comments.js

@@ -4,6 +4,7 @@
  * Posts documentation suggestions and issues as PR comments.
  * Requires: GITHUB_TOKEN environment variable
  */
+import ts from 'typescript';
 const GITHUB_API = 'https://api.github.com';
 /**
  * Post a review comment on a PR
@@ -31,6 +32,7 @@ export async function postPRComment(config, issues) {
                 'User-Agent': 'skrypt-cli',
             },
             body: JSON.stringify({ body }),
+            signal: AbortSignal.timeout(30000),
         });
         if (!response.ok) {
             const error = await response.text();
@@ -42,7 +44,7 @@ export async function postPRComment(config, issues) {
         const data = await response.json();
         return {
             success: true,
-            commentId: data.id,
+            commentId: data?.id,
         };
     }
     catch (err) {
@@ -71,6 +73,7 @@ export async function postInlineComments(config, issues) {
             Accept: 'application/vnd.github.v3+json',
             'User-Agent': 'skrypt-cli',
         },
+        signal: AbortSignal.timeout(30000),
     });
     if (!prResponse.ok) {
         return [{
@@ -79,7 +82,7 @@ export async function postInlineComments(config, issues) {
             }];
     }
     const pr = await prResponse.json();
-    const commitId = pr.head.sha;
+    const commitId = pr?.head?.sha;
     const results = [];
     for (const issue of issues) {
         if (!issue.line)
@@ -100,10 +103,11 @@ export async function postInlineComments(config, issues) {
                     line: issue.line,
                     side: 'RIGHT',
                 }),
+                signal: AbortSignal.timeout(30000),
             });
             if (response.ok) {
                 const data = await response.json();
-                results.push({ success: true, commentId: data.id });
+                results.push({ success: true, commentId: data?.id });
             }
             else {
                 const error = await response.text();
@@ -205,6 +209,7 @@ export async function analyzePRForDocs(config, _options = {}) {
             Accept: 'application/vnd.github.v3+json',
             'User-Agent': 'skrypt-cli',
         },
+        signal: AbortSignal.timeout(30000),
     });
     if (!response.ok) {
         throw new Error('Could not fetch PR files');
@@ -286,11 +291,19 @@ function checkCodeBlocks(patch, filename) {
         }
         // Check for obviously broken syntax
         if (language === 'javascript' || language === 'typescript') {
-            try {
-                new Function(code);
-            }
-            catch (err) {
-                const errMsg = err instanceof Error ? err.message : String(err);
+            const result = ts.transpileModule(code, {
+                compilerOptions: {
+                    module: ts.ModuleKind.ESNext,
+                    target: ts.ScriptTarget.ES2020,
+                },
+                reportDiagnostics: true,
+            });
+            if (result.diagnostics && result.diagnostics.length > 0) {
+                const errMsg = result.diagnostics[0]
+                    ? (typeof result.diagnostics[0].messageText === 'string'
+                        ? result.diagnostics[0].messageText
+                        : result.diagnostics[0].messageText.messageText)
+                    : 'Unknown error';
                 // Only flag if it's clearly meant to be runnable
                 if (!code.includes('// ...') && code.length > 20) {
                     issues.push({

package/dist/plugins/index.js

@@ -1,3 +1,4 @@
+// TODO: Plugin system is defined but not yet wired into the generate pipeline
 import { existsSync } from 'fs';
 import { resolve } from 'path';
 import { pathToFileURL } from 'url';

package/dist/scanner/index.js

@@ -1,5 +1,5 @@
 import { readdir, stat } from 'fs/promises';
-import { join, extname } from 'path';
+import { join, extname, parse as parsePath } from 'path';
 import { PythonScanner } from './python.js';
 import { TypeScriptScanner } from './typescript.js';
 import { GoScanner } from './go.js';
@@ -135,9 +135,15 @@ export async function scanDirectory(dir, options = {}) {
 export async function scanFile(filePath) {
     const scanner = getScannerForFile(filePath);
     if (!scanner) {
+        const ext = parsePath(filePath).ext.slice(1);
+        const langMap = {
+            ts: 'typescript', tsx: 'typescript', js: 'javascript', jsx: 'javascript',
+            py: 'python', go: 'go', rs: 'rust',
+        };
+        const language = langMap[ext] ?? 'typescript';
         return {
             filePath,
-            language: 'python', // default
+            language,
             elements: [],
             errors: [`No scanner available for ${filePath}`]
         };

package/dist/template/docs.json

@@ -3,7 +3,8 @@
   "description": "Documentation generated with Skrypt",
   "theme": {
     "primaryColor": "#3b82f6",
-    "accentColor": "#8b5cf6"
+    "accentColor": "#8b5cf6",
+    "font": "Inter"
   },
   "navigation": [
     {

package/dist/template/next.config.mjs

@@ -1,9 +1,11 @@
 import createMDX from '@next/mdx'
+import remarkGfm from 'remark-gfm'
+import remarkFrontmatter from 'remark-frontmatter'
 
 const withMDX = createMDX({
   extension: /\.mdx?$/,
   options: {
-    remarkPlugins: [],
+    remarkPlugins: [remarkGfm, remarkFrontmatter],
     rehypePlugins: [],
   },
 })

package/dist/template/package.json

@@ -10,30 +10,33 @@
     "start": "next start"
   },
   "dependencies": {
-    "next": "^15.3.0",
-    "react": "^19.0.0",
-    "react-dom": "^19.0.0",
-    "@next/mdx": "^15.3.0",
+    "@codesandbox/sandpack-react": "^2.20.0",
     "@mdx-js/loader": "^3.1.0",
     "@mdx-js/react": "^3.1.0",
-    "next-mdx-remote": "^5.0.0",
-    "shiki": "^3.0.0",
+    "@next/mdx": "^15.3.0",
     "@orama/orama": "^3.1.0",
-    "lucide-react": "^0.500.0",
+    "@scalar/nextjs-api-reference": "^0.4.0",
     "clsx": "^2.1.0",
-    "tailwind-merge": "^3.0.0",
     "gray-matter": "^4.0.3",
-    "@scalar/nextjs-api-reference": "^0.4.0",
-    "@codesandbox/sandpack-react": "^2.20.0"
+    "lucide-react": "^0.500.0",
+    "next": "^15.3.0",
+    "next-mdx-remote": "^6.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "remark-frontmatter": "^5.0.0",
+    "remark-gfm": "^4.0.0",
+    "shiki": "^3.0.0",
+    "tailwind-merge": "^3.0.0",
+    "yaml": "^2.8.2"
   },
   "devDependencies": {
+    "@tailwindcss/postcss": "^4.1.0",
+    "@types/mdx": "^2.0.0",
     "@types/node": "^22.0.0",
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
-    "@types/mdx": "^2.0.0",
-    "typescript": "^5.8.0",
+    "postcss": "^8.5.0",
     "tailwindcss": "^4.1.0",
-    "@tailwindcss/postcss": "^4.1.0",
-    "postcss": "^8.5.0"
+    "typescript": "^5.8.0"
   }
 }

package/dist/template/public/favicon.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32" width="32" height="32">
+  <rect width="32" height="32" rx="6" fill="#3b82f6"/>
+  <text x="16" y="23" font-family="system-ui, -apple-system, sans-serif" font-size="20" font-weight="700" fill="white" text-anchor="middle">S</text>
+</svg>