@kernlang/cli 3.2.3 → 3.3.5

package/dist/commands/gaps.js

@@ -0,0 +1,178 @@
+import { readCoverageGaps } from '@kernlang/core';
+import { existsSync, readdirSync, readFileSync, statSync } from 'fs';
+import { extname, join, relative, resolve } from 'path';
+import { withOptionalRemoteRepo } from '../remote-repo.js';
+import { hasFlag, parseFlagOrNext } from '../shared.js';
+/** Display order — most actionable first. Keeps the report scanable. */
+const CATEGORY_ORDER = [
+    'migratable',
+    'blocked-by-parser',
+    'blocked-by-codegen',
+    'needs-new-node',
+    'detected',
+];
+const CATEGORY_HINTS = {
+    migratable: 'run `kern migrate <name>` to auto-rewrite',
+    'blocked-by-parser': 'parser cannot read this yet — file a parser issue',
+    'blocked-by-codegen': 'parses but no codegen path — file a codegen issue',
+    'needs-new-node': 'no IR node models this — proposal needed',
+    detected: 'feature observed; no migration or schema change available yet',
+};
+const SCAN_EXTENSIONS = new Set(['.kern', '.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs']);
+const SKIP_DIRS = new Set([
+    'node_modules',
+    'dist',
+    'build',
+    '.git',
+    '.kern-gaps',
+    'coverage',
+    '.next',
+    '.turbo',
+    '.vercel',
+    'generated',
+]);
+const KERN_GAP_PATTERN = /\/\/\s*KERN-GAP:\s*(.+?)\s*$/;
+function walkSources(root, files) {
+    let entries;
+    try {
+        entries = readdirSync(root);
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        if (SKIP_DIRS.has(entry))
+            continue;
+        const full = join(root, entry);
+        let stat;
+        try {
+            stat = statSync(full);
+        }
+        catch {
+            continue;
+        }
+        if (stat.isDirectory()) {
+            walkSources(full, files);
+        }
+        else if (stat.isFile() && SCAN_EXTENSIONS.has(extname(entry))) {
+            files.push(full);
+        }
+    }
+}
+function scanFileForGaps(file) {
+    let content;
+    try {
+        content = readFileSync(file, 'utf-8');
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    const lines = content.split('\n');
+    for (let i = 0; i < lines.length; i++) {
+        const match = lines[i].match(KERN_GAP_PATTERN);
+        if (match) {
+            out.push({ file, line: i + 1, message: match[1] });
+        }
+    }
+    return out;
+}
+function collectGapsReport(rootDir, gapDir) {
+    const files = [];
+    walkSources(rootDir, files);
+    const sourceGaps = [];
+    for (const file of files) {
+        sourceGaps.push(...scanFileForGaps(file));
+    }
+    const coverageGaps = existsSync(gapDir) ? readCoverageGaps(gapDir) : [];
+    return { scannedFiles: files.length, sourceGaps, coverageGaps };
+}
+function printHumanReport(report, rootDir, verbose) {
+    const total = report.sourceGaps.length + report.coverageGaps.length;
+    process.stdout.write(`kern gaps — scanned ${report.scannedFiles} files in ${relative(process.cwd(), rootDir) || '.'}\n`);
+    if (total === 0) {
+        process.stdout.write('No gaps found.\n');
+        return;
+    }
+    if (report.sourceGaps.length > 0) {
+        process.stdout.write(`\nKERN-GAP comments (${report.sourceGaps.length}):\n`);
+        const grouped = new Map();
+        for (const gap of report.sourceGaps) {
+            const rel = relative(rootDir, gap.file) || gap.file;
+            if (!grouped.has(rel))
+                grouped.set(rel, []);
+            grouped.get(rel)?.push(gap);
+        }
+        const sorted = [...grouped.entries()].sort(([a], [b]) => a.localeCompare(b));
+        for (const [file, gaps] of sorted) {
+            process.stdout.write(`  ${file}\n`);
+            for (const gap of gaps) {
+                process.stdout.write(`    ${gap.line}: ${gap.message}\n`);
+            }
+        }
+    }
+    if (report.coverageGaps.length > 0) {
+        process.stdout.write(`\nCompiler coverage gaps (${report.coverageGaps.length}):\n`);
+        // Group by category; missing category (older .kern-gaps JSONs) counts as `detected`.
+        const byCategory = new Map();
+        for (const gap of report.coverageGaps) {
+            const category = gap.category ?? 'detected';
+            if (!byCategory.has(category))
+                byCategory.set(category, []);
+            byCategory.get(category).push(gap);
+        }
+        for (const category of CATEGORY_ORDER) {
+            const gaps = byCategory.get(category);
+            if (!gaps || gaps.length === 0)
+                continue;
+            const migrationNames = new Set();
+            for (const g of gaps)
+                if (g.migration)
+                    migrationNames.add(g.migration);
+            const hint = CATEGORY_HINTS[category];
+            const migrationSuffix = category === 'migratable' && migrationNames.size > 0
+                ? ` — ${[...migrationNames]
+                    .sort()
+                    .map((m) => `kern migrate ${m}`)
+                    .join(', ')}`
+                : '';
+            process.stdout.write(`  ${category} (${gaps.length}): ${hint}${migrationSuffix}\n`);
+        }
+        if (!verbose) {
+            process.stdout.write('\n  (run with --verbose for per-file detail)\n');
+        }
+        else {
+            process.stdout.write('\n  Detail:\n');
+            for (const category of CATEGORY_ORDER) {
+                const gaps = byCategory.get(category);
+                if (!gaps || gaps.length === 0)
+                    continue;
+                for (const gap of gaps) {
+                    const rel = relative(rootDir, gap.file) || gap.file;
+                    const migration = gap.migration ? ` migration=${gap.migration}` : '';
+                    const parent = gap.parentType ? ` parent=${gap.parentType}` : '';
+                    process.stdout.write(`    [${category}] ${rel}:${gap.line}  handler ${gap.handlerLength}ch${parent}${migration}  @ ${gap.timestamp}\n`);
+                }
+            }
+        }
+    }
+    process.stdout.write(`\nTotal: ${total} gaps across ${report.scannedFiles} scanned files.\n`);
+}
+async function runGapsLocal(args, remoteContext) {
+    const rootDir = resolve(parseFlagOrNext(args, '--root') ?? remoteContext?.rootDir ?? process.cwd());
+    const gapDir = resolve(parseFlagOrNext(args, '--gap-dir') ?? join(rootDir, '.kern-gaps'));
+    const json = hasFlag(args, '--json');
+    const verbose = hasFlag(args, '--verbose', '-v');
+    const report = collectGapsReport(rootDir, gapDir);
+    if (json) {
+        process.stdout.write(`${JSON.stringify(report, null, 2)}\n`);
+        return;
+    }
+    printHumanReport(report, rootDir, verbose);
+}
+export async function runGaps(args) {
+    await withOptionalRemoteRepo(args, { commandName: 'gaps' }, async (remoteContext) => {
+        await runGapsLocal(args, remoteContext);
+    });
+}
+//# sourceMappingURL=gaps.js.map

package/dist/commands/gaps.js.map

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

package/dist/commands/migrate-class-body.d.ts

@@ -0,0 +1,50 @@
+/**
+ * `kern migrate class-body` — convert handler-escaped class expressions to
+ * first-class `class` nodes.
+ *
+ * Detects this shape:
+ *
+ *   const name=AudioRecorder type=(any|object|unknown) [export=true]
+ *     handler <<<
+ *       class AudioRecorder [extends X] [implements Y] {
+ *         private fd: T = init;
+ *         ...
+ *         constructor(...) { ... }
+ *         foo(...) { ... }
+ *       }
+ *     >>>
+ *
+ * and rewrites it to a proper:
+ *
+ *   class name=AudioRecorder [export=true] [extends=X] [implements=Y]
+ *     field name=fd type=T private=true default={{ init }}
+ *     constructor params="..."
+ *       handler <<< ... >>>
+ *     method name=foo params="..." returns=T
+ *       handler <<< ... >>>
+ *
+ * This is NOT byte-equivalent: the original emits
+ *   `export const X: any = class X { ... };`   (class expression bound to const)
+ * whereas the rewrite emits
+ *   `export class X { ... }`                   (class declaration)
+ *
+ * The two are behaviourally compatible at the call sites we care about
+ * (constructor, methods, imports) but differ in hoisting and in the
+ * value of `typeof X`. We only migrate when the original annotation was the
+ * throwaway `any`/`object`/`unknown` — i.e. no existing code relied on the
+ * type of the const, because the const had no useful type to begin with.
+ */
+export interface ClassBodyHit {
+    headerLine: number;
+    literal: string;
+    valueAttr: string;
+}
+export interface ClassBodyResult {
+    hits: ClassBodyHit[];
+    output: string;
+}
+/**
+ * Main entry: walk .kern source text, rewrite every
+ * `const ... handler <<< class X {...} >>>` block to a `class` node.
+ */
+export declare function rewriteClassBodies(source: string): ClassBodyResult;