@kernlang/review 3.1.5 → 3.1.7

package/dist/rules/fastapi.js

@@ -0,0 +1,183 @@
+/**
+ * FastAPI review rules — active when target = fastapi.
+ *
+ * FastAPI uses the Python concept pipeline, so the real checks live in
+ * runFastapiConceptRules() below and operate on ConceptMap + source text.
+ */
+import { finding } from './utils.js';
+function lineForIndex(text, index) {
+    return text.slice(0, index).split('\n').length;
+}
+function routeNodes(concepts) {
+    return concepts.nodes
+        .filter((node) => node.kind === 'entrypoint' && node.payload.kind === 'entrypoint' && node.payload.subtype === 'route')
+        .sort((a, b) => a.primarySpan.startLine - b.primarySpan.startLine);
+}
+function extractRoutes(source, concepts) {
+    const lines = source.split('\n');
+    const routes = [];
+    for (const node of routeNodes(concepts)) {
+        const startIdx = node.primarySpan.startLine - 1;
+        for (let i = startIdx; i < lines.length; i++) {
+            const match = lines[i].match(/^(\s*)(async\s+def|def)\s+([A-Za-z_]\w*)\s*\(/);
+            if (!match)
+                continue;
+            const defIndent = match[1].length;
+            let endLine = lines.length;
+            for (let j = i + 1; j < lines.length; j++) {
+                const line = lines[j];
+                const trimmed = line.trim();
+                if (!trimmed || trimmed.startsWith('#'))
+                    continue;
+                const indent = line.match(/^(\s*)/)?.[1].length ?? 0;
+                if (indent <= defIndent) {
+                    endLine = j;
+                    break;
+                }
+            }
+            routes.push({
+                startLine: node.primarySpan.startLine,
+                headerLine: i + 1,
+                endLine,
+                name: match[3],
+                method: node.payload.kind === 'entrypoint' ? node.payload.httpMethod : undefined,
+                isAsync: match[2].startsWith('async'),
+                decoratorText: node.evidence,
+                body: lines.slice(i + 1, endLine).join('\n'),
+            });
+            break;
+        }
+    }
+    return routes;
+}
+function nodesInRoute(ctx, route, kind) {
+    return ctx.concepts.nodes.filter((node) => node.kind === kind &&
+        node.primarySpan.startLine >= route.startLine &&
+        node.primarySpan.startLine <= route.endLine);
+}
+function bodyLine(route, index) {
+    return route.headerLine + lineForIndex(route.body, index);
+}
+// ── Rule: fastapi-missing-response-model ────────────────────────────────
+function missingResponseModel(ctx) {
+    const findings = [];
+    const plainReturn = /\breturn\s+(?!None\b)(?!JSONResponse\b)(?!ORJSONResponse\b)(?!UJSONResponse\b)(?!PlainTextResponse\b)(?!StreamingResponse\b)(?!FileResponse\b)(?!RedirectResponse\b)(?!HTMLResponse\b)(?!TemplateResponse\b)(?!Response\b)(?:\{|\[|[A-Za-z_]\w*(?:\.[A-Za-z_]\w*)*)/;
+    for (const route of extractRoutes(ctx.source, ctx.concepts)) {
+        if (/response_model\s*=/.test(route.decoratorText))
+            continue;
+        if (!plainReturn.test(route.body))
+            continue;
+        findings.push(finding('fastapi-missing-response-model', 'warning', 'pattern', `FastAPI route '${route.name}' returns data without response_model — response shape is undocumented and easy to over-expose`, ctx.filePath, route.startLine, 1, {
+            suggestion: 'Declare response_model=YourSchema on the route decorator so FastAPI validates and filters outbound data',
+        }));
+    }
+    return findings;
+}
+// ── Rule: fastapi-blocking-sync-route ───────────────────────────────────
+const BLOCKING_PATTERNS = [
+    {
+        pattern: /\brequests\.(?:get|post|put|patch|delete|head|options|request)\s*\(/g,
+        label: 'requests.*',
+        suggestion: 'Use httpx.AsyncClient/aiohttp or move the blocking call to a threadpool',
+    },
+    { pattern: /\bopen\s*\(/g, label: 'open()', suggestion: 'Use aiofiles or move blocking file I/O off the event loop' },
+    {
+        pattern: /\b(?:sqlite3|psycopg2)\./g,
+        label: 'sync DB client',
+        suggestion: 'Use an async database driver inside async FastAPI routes',
+    },
+    {
+        pattern: /\bcursor\.execute\s*\(/g,
+        label: 'cursor.execute()',
+        suggestion: 'Use an async database client or execute the query in a worker thread',
+    },
+    {
+        pattern: /\bsubprocess\.(?:run|call|check_call|check_output)\s*\(/g,
+        label: 'subprocess.*',
+        suggestion: 'Use asyncio.create_subprocess_exec() or a worker thread from async routes',
+    },
+    {
+        pattern: /\btime\.sleep\s*\(/g,
+        label: 'time.sleep()',
+        suggestion: 'Use await asyncio.sleep() in async FastAPI routes',
+    },
+];
+function blockingSyncRoute(ctx) {
+    const findings = [];
+    for (const route of extractRoutes(ctx.source, ctx.concepts)) {
+        if (!route.isAsync)
+            continue;
+        for (const { pattern, label, suggestion } of BLOCKING_PATTERNS) {
+            pattern.lastIndex = 0;
+            const match = pattern.exec(route.body);
+            if (!match)
+                continue;
+            findings.push(finding('fastapi-blocking-sync-route', 'warning', 'bug', `Async FastAPI route '${route.name}' uses blocking ${label} — the event loop will stall under load`, ctx.filePath, bodyLine(route, match.index), 1, { suggestion }));
+            break;
+        }
+    }
+    return findings;
+}
+// ── Rule: fastapi-shared-state ──────────────────────────────────────────
+function sharedState(ctx) {
+    const findings = [];
+    for (const route of extractRoutes(ctx.source, ctx.concepts)) {
+        for (const mutation of nodesInRoute(ctx, route, 'state_mutation')) {
+            const payload = mutation.payload;
+            if (payload.kind !== 'state_mutation')
+                continue;
+            if (payload.scope !== 'global' && payload.scope !== 'module')
+                continue;
+            findings.push(finding('fastapi-shared-state', 'error', 'bug', `FastAPI route '${route.name}' mutates ${payload.scope} state '${payload.target}' — concurrent requests can race and leak state across users`, ctx.filePath, mutation.primarySpan.startLine, 1, {
+                suggestion: 'Move per-request data into function scope, a dependency, or a database/cache with explicit concurrency control',
+            }));
+        }
+    }
+    return findings;
+}
+// ── Rule: fastapi-broad-except ──────────────────────────────────────────
+function broadExcept(ctx) {
+    const findings = [];
+    const broad = /^\s*except(?:\s+Exception(?:\s+as\s+\w+)?)?\s*:/gm;
+    for (const route of extractRoutes(ctx.source, ctx.concepts)) {
+        const handlers = nodesInRoute(ctx, route, 'error_handle');
+        if (handlers.length === 0)
+            continue;
+        let match;
+        while ((match = broad.exec(route.body)) !== null) {
+            const line = bodyLine(route, match.index);
+            const conceptMatch = handlers.find((node) => node.primarySpan.startLine === line);
+            if (!conceptMatch)
+                continue;
+            const block = route.body.slice(match.index, match.index + 220);
+            if (/\braise\s+HTTPException\b|\braise\b/.test(block))
+                continue;
+            findings.push(finding('fastapi-broad-except', 'warning', 'bug', `FastAPI route '${route.name}' catches broad exceptions without re-raising — real failures get flattened into generic responses`, ctx.filePath, line, 1, {
+                suggestion: "Catch specific exceptions and re-raise HTTPException (or let FastAPI's exception handlers deal with them)",
+            }));
+        }
+    }
+    return findings;
+}
+// ── Rule: fastapi-broad-cors ──────────────────────────────────────────────
+function broadCors(ctx) {
+    const findings = [];
+    const corsRegex = /allow_origins\s*=\s*\[([^\]]*)\]/g;
+    let match;
+    while ((match = corsRegex.exec(ctx.source)) !== null) {
+        if (!match[1].includes('"*"') && !match[1].includes("'*'"))
+            continue;
+        const line = lineForIndex(ctx.source, match.index);
+        findings.push(finding('fastapi-broad-cors', 'warning', 'pattern', 'CORSMiddleware uses allow_origins=["*"] — any origin can make credentialed requests if allow_credentials is also True', ctx.filePath, line, 1, { suggestion: 'Restrict allow_origins to specific trusted domains instead of wildcard' }));
+    }
+    return findings;
+}
+const FASTAPI_CONCEPT_RULES = [missingResponseModel, blockingSyncRoute, sharedState, broadExcept, broadCors];
+export function runFastapiConceptRules(concepts, filePath, source) {
+    const ctx = { concepts, filePath, source };
+    return FASTAPI_CONCEPT_RULES.flatMap((rule) => rule(ctx));
+}
+// FastAPI is executed via reviewPythonSource(), not the TS quality-rule layer.
+// The target still needs layer registration for --list-rules / target metadata.
+export const fastapiRules = [];
+//# sourceMappingURL=fastapi.js.map

package/dist/rules/fastapi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fastapi.js","sourceRoot":"","sources":["../../src/rules/fastapi.ts"],"names":[],"mappings":"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"}

package/dist/rules/ground-layer.js

@@ -12,7 +12,7 @@ function props(node) {
 }
 function children(node, type) {
     const c = node.children || [];
-    return type ? c.filter(n => n.type === type) : c;
+    return type ? c.filter((n) => n.type === type) : c;
 }
 function loc(node) {
     return { line: node.loc?.line || 0, col: node.loc?.col || 1 };
@@ -109,9 +109,9 @@ export const expectRangeInverted = (nodes) => {
         if (node.type === 'expect') {
             const p = props(node);
             const within = p.within;
-            if (within && within.includes('..')) {
+            if (within?.includes('..')) {
                 const [lo, hi] = within.split('..').map(Number);
-                if (!isNaN(lo) && !isNaN(hi) && lo > hi) {
+                if (!Number.isNaN(lo) && !Number.isNaN(hi) && lo > hi) {
                     findings.push(finding('expect-range-inverted', 'warning', 'bug', `Expect '${p.name || 'unnamed'}' has inverted range: ${lo} > ${hi}`, node));
                 }
             }

package/dist/rules/ground-layer.js.map

@@ -1 +1 @@
-{"version":3,"file":"ground-layer.js","sourceRoot":"","sources":["../../src/rules/ground-layer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ground-layer.js","sourceRoot":"","sources":["../../src/rules/ground-layer.ts"],"names":[],"mappings":"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"}

package/dist/rules/index.d.ts

@@ -3,9 +3,13 @@
  *
  * Layers:
  *   [base]     Always active — universal TS/KERN rules
- *   [react]    Active when target = nextjs | tailwind | web | native
+ *   [react]    Active when target = nextjs | tailwind | web | native | ink
+ *   [ink]      Active when target = ink (on top of react)
  *   [vue]      Active when target = vue | nuxt
  *   [express]  Active when target = express
+ *   [cli]      Active when target = cli
+ *   [terminal] Active when target = terminal
+ *   [fastapi]  Active when target = fastapi (Python concept layer)
  *   [nextjs]   Active when target = nextjs (on top of react)
  *   [nuxt]     Active when target = nuxt (on top of vue)
  */