@kernlang/codemod 3.3.4

package/dist/apply.js

@@ -0,0 +1,275 @@
+/**
+ * Apply orchestrator — turn a TemplateMatch into a transformed source file.
+ *
+ * Pipeline:
+ *   1. Adapter resolves the exact rewrite region (re-derived from AST; detector
+ *      reports endLine=EOF which we ignore).
+ *   2. Adapter extracts the user interior as CHILDREN lines.
+ *   3. Parse match.suggestedKern into an IR node and register the named
+ *      template if it isn't already.
+ *   4. Attach a `handler` child carrying the extracted CHILDREN.
+ *   5. expandTemplateNode → generateCoreNode-style line array.
+ *   6. Strip template-prepended imports (source file already imports them).
+ *   7. Splice new text into source at [region.start, region.end] (no comment
+ *      duplication — `before` already contains any leading trivia).
+ *   8. Mutate the original SourceFile IN-PLACE with replaceWithText so that
+ *      downstream consumers see the transformed module when diagnostics run,
+ *      then revert if any gate fails.
+ *   9. Reparse check (syntax), re-detect gate (template still recognized),
+ *      affected-set diagnostics gate, whole-program gate (--write only).
+ *  10. Write audit entry and return ApplyResult.
+ *
+ * The shared ts-morph Project is the caller's responsibility (see project.ts)
+ * so affected-set diagnostics amortize across --interactive sessions.
+ */
+import { expandTemplateNode, parse } from '@kernlang/core';
+import { detectTemplates } from '@kernlang/review';
+import { getAdapter } from './adapter-registry.js';
+import { runAffectedSetDiagnostics, runWholeProgramDiagnostics, snapshotWholeProgram } from './diagnostics.js';
+import { ensureTemplate } from './template-loader.js';
+// ── Helpers ────────────────────────────────────────────────────────────
+/**
+ * Strip leading `import ... from '...';` lines plus a single following blank line.
+ * The source file already imports what the template requires; re-injecting the
+ * template's import block would duplicate it.
+ */
+function stripTemplateImports(lines) {
+    const out = [...lines];
+    while (out.length > 0 && /^\s*import\s/.test(out[0])) {
+        out.shift();
+    }
+    if (out.length > 0 && out[0].trim() === '') {
+        out.shift();
+    }
+    return out;
+}
+/** Return the column (0-indexed) of region.start in its containing line. */
+function columnAt(sourceText, offset) {
+    const lineStart = sourceText.lastIndexOf('\n', offset - 1) + 1;
+    return offset - lineStart;
+}
+/** Indent every line (except the first) by `col` spaces. */
+function indentBlock(text, col) {
+    if (col <= 0)
+        return text;
+    const pad = ' '.repeat(col);
+    return text
+        .split('\n')
+        .map((line, i) => (i === 0 || line.length === 0 ? line : pad + line))
+        .join('\n');
+}
+/**
+ * Produce a minimal unified-style diff for audit/dry-run display.
+ * Not a full diff engine — just enough to visualize what will change.
+ */
+function minimalDiff(oldText, newText, filePath) {
+    if (oldText === newText)
+        return '';
+    const oldLines = oldText.split('\n');
+    const newLines = newText.split('\n');
+    const header = `--- a/${filePath}\n+++ b/${filePath}\n`;
+    return `${header}${oldLines.map((l) => `-${l}`).join('\n')}\n${newLines.map((l) => `+${l}`).join('\n')}\n`;
+}
+export function applyMatch(input, options = {}) {
+    const { project, filePath, match } = input;
+    const timestamp = new Date().toISOString();
+    const confidencePct = match.confidencePct;
+    const base = {
+        filePath,
+        templateName: match.templateName,
+        confidencePct,
+        decision: 'skipped',
+        timestamp,
+        tsTokens: match.tsTokens,
+        kernTokens: match.kernTokens,
+    };
+    // Confidence gate first — cheapest check.
+    const minConf = options.minConfidence ?? 80;
+    if (confidencePct < minConf) {
+        return { ...base, reason: `confidence ${confidencePct} < min ${minConf}` };
+    }
+    if (options.templateName && options.templateName !== match.templateName) {
+        return { ...base, reason: `template filter excluded ${match.templateName}` };
+    }
+    const adapter = getAdapter(match.templateName);
+    if (!adapter) {
+        return { ...base, reason: `no adapter registered for ${match.templateName}` };
+    }
+    const sourceFile = project.getSourceFile(filePath);
+    if (!sourceFile) {
+        return { ...base, reason: `source file not in project: ${filePath}` };
+    }
+    // 1. Resolve region
+    const resolved = adapter.resolveRegion(sourceFile, match);
+    if (!resolved.ok) {
+        return { ...base, reason: `resolveRegion: ${resolved.reason}` };
+    }
+    // 2. Extract children
+    const extracted = adapter.extractChildren(sourceFile, resolved.region, match);
+    if (!extracted.ok) {
+        return { ...base, reason: `extractChildren: ${extracted.reason}` };
+    }
+    // 3. Ensure template registered + parse suggestedKern
+    if (!match.suggestedKern) {
+        return { ...base, reason: 'match has no suggestedKern' };
+    }
+    if (!ensureTemplate(match.templateName)) {
+        return { ...base, reason: `template ${match.templateName} not found in catalog` };
+    }
+    let irNode;
+    try {
+        const ast = parse(match.suggestedKern);
+        if (ast.type === match.templateName) {
+            irNode = ast;
+        }
+        else if (ast.children && ast.children.length === 1 && ast.children[0].type === match.templateName) {
+            irNode = ast.children[0];
+        }
+        else {
+            return { ...base, reason: `parsed suggestedKern type=${ast.type}, expected ${match.templateName}` };
+        }
+    }
+    catch (err) {
+        return { ...base, reason: `parse suggestedKern: ${err.message}` };
+    }
+    // 4. Attach handler child with extracted CHILDREN (if any).
+    if (extracted.children.length > 0) {
+        const handlerChild = {
+            type: 'handler',
+            props: { code: extracted.children.join('\n') },
+            children: [],
+        };
+        irNode = { ...irNode, children: [...(irNode.children || []), handlerChild] };
+    }
+    // 5. Expand
+    let expandedLines;
+    try {
+        expandedLines = expandTemplateNode(irNode);
+    }
+    catch (err) {
+        return { ...base, reason: `expandTemplateNode: ${err.message}` };
+    }
+    // 6. Strip template-added imports (file already has them).
+    expandedLines = stripTemplateImports(expandedLines);
+    while (expandedLines.length > 0 && expandedLines[expandedLines.length - 1].trim() === '') {
+        expandedLines.pop();
+    }
+    const expandedText = expandedLines.join('\n');
+    const originalText = sourceFile.getFullText();
+    const col = columnAt(originalText, resolved.region.start);
+    const indented = indentBlock(expandedText, col);
+    // 7. Splice — `before` already contains any leading trivia, so do NOT prepend
+    //    comments separately (that would duplicate them, per codex-review feedback).
+    const before = originalText.slice(0, resolved.region.start);
+    const after = originalText.slice(resolved.region.end);
+    const newText = before + indented + after;
+    if (newText === originalText) {
+        return {
+            ...base,
+            decision: 'skipped',
+            reason: 'transform produced identical output (idempotent)',
+            replacedSpan: { start: resolved.region.start, end: resolved.region.end },
+            diff: '',
+        };
+    }
+    // 8. Mutate in place so dependents see the transformed module when we run
+    //    downstream diagnostics. Revert on any gate failure.
+    const wholeProgramBaseline = options.write ? snapshotWholeProgram(project) : undefined;
+    try {
+        sourceFile.replaceWithText(newText);
+    }
+    catch (err) {
+        return {
+            ...base,
+            reason: `reparse failed: ${err.message}`,
+            replacedSpan: { start: resolved.region.start, end: resolved.region.end },
+            parseOk: false,
+        };
+    }
+    const revert = () => {
+        sourceFile.replaceWithText(originalText);
+    };
+    // 9a. Re-detect gate: a canonical rewrite must still be detectable as the
+    //     same template. If the rewrite broke pattern recognition, reject.
+    let reDetectOk = true;
+    try {
+        const reMatches = detectTemplates(sourceFile);
+        if (!reMatches.some((m) => m.templateName === match.templateName)) {
+            reDetectOk = false;
+        }
+    }
+    catch {
+        // Detection errors are non-fatal; tsc gate remains authoritative.
+    }
+    if (!reDetectOk) {
+        revert();
+        return {
+            ...base,
+            decision: 'rejected',
+            reason: 're-detect failed: template pattern no longer recognized after rewrite',
+            replacedSpan: { start: resolved.region.start, end: resolved.region.end },
+            diff: minimalDiff(originalText, newText, filePath),
+            parseOk: true,
+            reDetectOk: false,
+        };
+    }
+    // 9b. Affected-set diagnostics (always). The transformed SourceFile is the
+    //     real one now, so referencing files are checked against the new module.
+    const newDiags = runAffectedSetDiagnostics(project, sourceFile, input.preDiagnostics);
+    if (newDiags.length > 0) {
+        revert();
+        return {
+            ...base,
+            decision: 'rejected',
+            reason: `new diagnostics: ${newDiags.length}`,
+            replacedSpan: { start: resolved.region.start, end: resolved.region.end },
+            diff: minimalDiff(originalText, newText, filePath),
+            parseOk: true,
+            reDetectOk,
+            newDiagnostics: newDiags,
+        };
+    }
+    // 9c. Whole-program final gate (--write only) — catches transitive-dep errors.
+    if (options.write && wholeProgramBaseline) {
+        const programNewDiags = runWholeProgramDiagnostics(project, wholeProgramBaseline);
+        if (programNewDiags.length > 0) {
+            revert();
+            return {
+                ...base,
+                decision: 'rejected',
+                reason: `new whole-program diagnostics: ${programNewDiags.length}`,
+                replacedSpan: { start: resolved.region.start, end: resolved.region.end },
+                diff: minimalDiff(originalText, newText, filePath),
+                parseOk: true,
+                reDetectOk,
+                newDiagnostics: programNewDiags,
+            };
+        }
+    }
+    const diff = minimalDiff(originalText, newText, filePath);
+    if (options.write) {
+        sourceFile.saveSync();
+        return {
+            ...base,
+            decision: 'applied',
+            replacedSpan: { start: resolved.region.start, end: resolved.region.end },
+            diff,
+            parseOk: true,
+            reDetectOk,
+            newDiagnostics: [],
+        };
+    }
+    // Dry-run path — revert the in-memory edit so subsequent candidates see the
+    // original file.
+    revert();
+    return {
+        ...base,
+        decision: 'dry-run',
+        replacedSpan: { start: resolved.region.start, end: resolved.region.end },
+        diff,
+        parseOk: true,
+        reDetectOk,
+        newDiagnostics: [],
+    };
+}
+//# sourceMappingURL=apply.js.map

package/dist/apply.js.map

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

package/dist/audit.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Audit log — JSONL append-only.
+ *
+ * Every invocation of applyMatch (including dry-runs and rejections) produces
+ * an audit entry. Default path is .kern/codemod-audit.jsonl under cwd, created
+ * on demand. Each line is a self-contained JSON object with schema:1.
+ */
+import type { ApplyResult } from './types.js';
+export declare function defaultAuditPath(cwd: string): string;
+export declare function writeAuditEntry(auditPath: string, result: ApplyResult): void;

package/dist/audit.js

@@ -0,0 +1,26 @@
+/**
+ * Audit log — JSONL append-only.
+ *
+ * Every invocation of applyMatch (including dry-runs and rejections) produces
+ * an audit entry. Default path is .kern/codemod-audit.jsonl under cwd, created
+ * on demand. Each line is a self-contained JSON object with schema:1.
+ */
+import { appendFileSync, existsSync, mkdirSync } from 'fs';
+import { dirname, resolve } from 'path';
+export function defaultAuditPath(cwd) {
+    return resolve(cwd, '.kern', 'codemod-audit.jsonl');
+}
+export function writeAuditEntry(auditPath, result) {
+    const entry = { ...result, schema: 1 };
+    try {
+        const dir = dirname(auditPath);
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        appendFileSync(auditPath, `${JSON.stringify(entry)}\n`, 'utf-8');
+    }
+    catch (err) {
+        console.error(`kern-codemod: audit write failed (${auditPath}): ${err.message}`);
+    }
+}
+//# sourceMappingURL=audit.js.map

package/dist/audit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.js","sourceRoot":"","sources":["../src/audit.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAGxC,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,OAAO,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,qBAAqB,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,SAAiB,EAAE,MAAmB;IACpE,MAAM,KAAK,GAAe,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;IACnD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;QAC/B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACrB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtC,CAAC;QACD,cAAc,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACnE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,qCAAqC,SAAS,MAAO,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;IAC9F,CAAC;AACH,CAAC"}

package/dist/diagnostics.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Two-stage diagnostics gate.
+ *
+ * Stage 1 (always): affected-set — the transformed file plus any source files
+ * that directly reference it. Fast enough for --interactive.
+ *
+ * Stage 2 (--write only): whole-program — full Program diagnostics via the
+ * shared Project. Catches cross-file regressions through transitive references
+ * that stage 1 misses. Slow (~500ms–2s on medium repos) so we reserve it for
+ * actual writes.
+ *
+ * Both stages compare pre-transform vs post-transform diagnostic fingerprints
+ * and return ONLY NEW diagnostics as an array of human-readable strings.
+ */
+import type { Project, SourceFile } from 'ts-morph';
+/**
+ * Snapshot diagnostics for a file's affected set (file + direct referencers).
+ * Use this once per file BEFORE transform; pass the returned strings back
+ * to runAffectedSetDiagnostics as the `preDiagnostics` baseline.
+ */
+export declare function snapshotAffectedSet(_project: Project, sourceFile: SourceFile): string[];
+/**
+ * Run the affected-set diagnostics check and return any NEW diagnostics
+ * (not present in preDiagnostics baseline).
+ */
+export declare function runAffectedSetDiagnostics(_project: Project, transformedFile: SourceFile, preDiagnostics: ReadonlyArray<string> | undefined): string[];
+/**
+ * Snapshot every diagnostic the Program currently produces. Use before --write
+ * to establish the whole-program baseline.
+ */
+export declare function snapshotWholeProgram(project: Project): string[];
+/**
+ * Whole-program check — diff post-transform Program diagnostics against a
+ * baseline snapshot taken before the transform. Returns any NEW entries.
+ */
+export declare function runWholeProgramDiagnostics(project: Project, preDiagnostics: ReadonlyArray<string>): string[];

package/dist/diagnostics.js

@@ -0,0 +1,117 @@
+/**
+ * Two-stage diagnostics gate.
+ *
+ * Stage 1 (always): affected-set — the transformed file plus any source files
+ * that directly reference it. Fast enough for --interactive.
+ *
+ * Stage 2 (--write only): whole-program — full Program diagnostics via the
+ * shared Project. Catches cross-file regressions through transitive references
+ * that stage 1 misses. Slow (~500ms–2s on medium repos) so we reserve it for
+ * actual writes.
+ *
+ * Both stages compare pre-transform vs post-transform diagnostic fingerprints
+ * and return ONLY NEW diagnostics as an array of human-readable strings.
+ */
+const TEMP_SUFFIX = '.kern-codemod.tmp.ts';
+/**
+ * Normalize the temp file path back to its original form so the same
+ * diagnostic on the original file and on the temp file share a fingerprint.
+ */
+function normalizePath(p) {
+    if (p.endsWith(TEMP_SUFFIX))
+        return p.slice(0, -TEMP_SUFFIX.length);
+    return p;
+}
+/**
+ * Fingerprint a diagnostic for baseline comparison. We exclude start offset —
+ * the transform will shift every position in the file, so offset-sensitive
+ * fingerprints would report every pre-existing diagnostic as "new". We keep
+ * code + normalized file + message, which is coarse but sound: two logically
+ * identical diagnostics match, and any NEW compile error shows up as new.
+ */
+function fingerprint(d) {
+    const file = normalizePath(d.getSourceFile()?.getFilePath() ?? '<no-file>');
+    const code = d.getCode();
+    const msg = typeof d.getMessageText() === 'string' ? d.getMessageText() : 'multi-line';
+    const shortMsg = msg.length > 120 ? `${msg.slice(0, 120)}…` : msg;
+    return `${file}|${code}|${shortMsg}`;
+}
+function readable(d) {
+    const file = d.getSourceFile()?.getFilePath() ?? '<no-file>';
+    const line = d.getLineNumber() ?? 0;
+    const code = d.getCode();
+    const msg = typeof d.getMessageText() === 'string' ? d.getMessageText() : 'multi-line diagnostic';
+    return `${file}:${line} TS${code}: ${msg}`;
+}
+function affectedFiles(sourceFile) {
+    const files = new Set([sourceFile]);
+    try {
+        for (const ref of sourceFile.getReferencingSourceFiles()) {
+            files.add(ref);
+        }
+    }
+    catch {
+        // fall back to file-only
+    }
+    return files;
+}
+/**
+ * Snapshot diagnostics for a file's affected set (file + direct referencers).
+ * Use this once per file BEFORE transform; pass the returned strings back
+ * to runAffectedSetDiagnostics as the `preDiagnostics` baseline.
+ */
+export function snapshotAffectedSet(_project, sourceFile) {
+    const files = affectedFiles(sourceFile);
+    const fps = [];
+    for (const f of files) {
+        for (const d of f.getPreEmitDiagnostics()) {
+            fps.push(fingerprint(d));
+        }
+    }
+    return fps;
+}
+/**
+ * Run the affected-set diagnostics check and return any NEW diagnostics
+ * (not present in preDiagnostics baseline).
+ */
+export function runAffectedSetDiagnostics(_project, transformedFile, preDiagnostics) {
+    const baseline = new Set(preDiagnostics ?? []);
+    const newDiags = [];
+    const files = affectedFiles(transformedFile);
+    for (const f of files) {
+        for (const d of f.getPreEmitDiagnostics()) {
+            const fp = fingerprint(d);
+            if (!baseline.has(fp)) {
+                newDiags.push(readable(d));
+            }
+        }
+    }
+    return newDiags;
+}
+/**
+ * Snapshot every diagnostic the Program currently produces. Use before --write
+ * to establish the whole-program baseline.
+ */
+export function snapshotWholeProgram(project) {
+    const out = [];
+    for (const d of project.getPreEmitDiagnostics()) {
+        out.push(fingerprint(d));
+    }
+    return out;
+}
+/**
+ * Whole-program check — diff post-transform Program diagnostics against a
+ * baseline snapshot taken before the transform. Returns any NEW entries.
+ */
+export function runWholeProgramDiagnostics(project, preDiagnostics) {
+    const baseline = new Set(preDiagnostics);
+    const newDiags = [];
+    for (const d of project.getPreEmitDiagnostics()) {
+        const fp = fingerprint(d);
+        if (!baseline.has(fp)) {
+            newDiags.push(readable(d));
+        }
+    }
+    return newDiags;
+}
+//# sourceMappingURL=diagnostics.js.map

package/dist/diagnostics.js.map

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

package/dist/format.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Optional formatting via Biome with canonical fallback.
+ *
+ * Q3 of the design: canonical generator output is the default, Biome runs
+ * only when --format is passed on a touched file. If Biome is missing or
+ * fails, we fall back silently to canonical output and note it in audit.
+ */
+export interface FormatResult {
+    ran: boolean;
+    ok: boolean;
+    error?: string;
+}
+export declare function formatWithBiome(filePath: string, cwd: string): FormatResult;

package/dist/format.js

@@ -0,0 +1,30 @@
+/**
+ * Optional formatting via Biome with canonical fallback.
+ *
+ * Q3 of the design: canonical generator output is the default, Biome runs
+ * only when --format is passed on a touched file. If Biome is missing or
+ * fails, we fall back silently to canonical output and note it in audit.
+ */
+import { spawnSync } from 'child_process';
+import { existsSync } from 'fs';
+import { resolve } from 'path';
+export function formatWithBiome(filePath, cwd) {
+    const binCandidates = [
+        resolve(cwd, 'node_modules/.bin/biome'),
+        resolve(cwd, 'node_modules/@biomejs/biome/bin/biome'),
+    ];
+    const bin = binCandidates.find((p) => existsSync(p));
+    if (!bin) {
+        return { ran: false, ok: false, error: 'biome binary not found in node_modules/.bin' };
+    }
+    const proc = spawnSync(bin, ['format', '--write', filePath], { cwd, encoding: 'utf-8' });
+    if (proc.error) {
+        return { ran: true, ok: false, error: proc.error.message };
+    }
+    if (proc.status !== 0) {
+        const stderr = (proc.stderr || '').trim();
+        return { ran: true, ok: false, error: stderr || `biome exited with ${proc.status}` };
+    }
+    return { ran: true, ok: true };
+}
+//# sourceMappingURL=format.js.map

package/dist/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAQ/B,MAAM,UAAU,eAAe,CAAC,QAAgB,EAAE,GAAW;IAC3D,MAAM,aAAa,GAAG;QACpB,OAAO,CAAC,GAAG,EAAE,yBAAyB,CAAC;QACvC,OAAO,CAAC,GAAG,EAAE,uCAAuC,CAAC;KACtD,CAAC;IACF,MAAM,GAAG,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,6CAA6C,EAAE,CAAC;IACzF,CAAC;IAED,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;IACzF,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;IAC7D,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC1C,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,IAAI,qBAAqB,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;IACvF,CAAC;IACD,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACjC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @kernlang/codemod — public API.
+ *
+ * Turn @kernlang/review TemplateMatch results into transformed TS source.
+ * Safety gates: reparse + re-detect + affected-set tsc diagnostics (always),
+ * whole-program tsc diagnostics (--write only).
+ */
+import './adapters/index.js';
+export { getAdapter, listAdapters, registerAdapter } from './adapter-registry.js';
+export { applyMatch } from './apply.js';
+export { type ApplyFilesResult, applyFiles } from './apply-files.js';
+export { defaultAuditPath, writeAuditEntry } from './audit.js';
+export { runAffectedSetDiagnostics, runWholeProgramDiagnostics, snapshotAffectedSet, snapshotWholeProgram, } from './diagnostics.js';
+export { type FormatResult, formatWithBiome } from './format.js';
+export { type LoadProjectOptions, loadHostProject } from './project.js';
+export type { ApplyDecision, ApplyOptions, ApplyResult, AuditEntry, ExtractResult, ResolvedRegion, ResolveResult, TemplateAdapter, } from './types.js';

package/dist/index.js

@@ -0,0 +1,18 @@
+/**
+ * @kernlang/codemod — public API.
+ *
+ * Turn @kernlang/review TemplateMatch results into transformed TS source.
+ * Safety gates: reparse + re-detect + affected-set tsc diagnostics (always),
+ * whole-program tsc diagnostics (--write only).
+ */
+// Register built-in adapters via side-effect import so consumers that only
+// import the package's public surface still get them.
+import './adapters/index.js';
+export { getAdapter, listAdapters, registerAdapter } from './adapter-registry.js';
+export { applyMatch } from './apply.js';
+export { applyFiles } from './apply-files.js';
+export { defaultAuditPath, writeAuditEntry } from './audit.js';
+export { runAffectedSetDiagnostics, runWholeProgramDiagnostics, snapshotAffectedSet, snapshotWholeProgram, } from './diagnostics.js';
+export { formatWithBiome } from './format.js';
+export { loadHostProject } from './project.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,2EAA2E;AAC3E,sDAAsD;AACtD,OAAO,qBAAqB,CAAC;AAE7B,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAClF,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAyB,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,EACL,yBAAyB,EACzB,0BAA0B,EAC1B,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAqB,eAAe,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAA2B,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/dist/project.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Shared ts-morph Project loader.
+ *
+ * Mirrors the tsconfig lookup from packages/review/src/inferrer.ts so codemod
+ * runs against the same type-resolution graph as review. A single Project is
+ * reused across all files in a codemod run so affected-set diagnostics amortize
+ * well under --interactive.
+ */
+import { Project } from 'ts-morph';
+export interface LoadProjectOptions {
+    /** Start directory for tsconfig lookup. Defaults to process.cwd(). */
+    cwd?: string;
+    /** Force in-memory project (used by unit tests). */
+    inMemory?: boolean;
+}
+export declare function loadHostProject(opts?: LoadProjectOptions): Project;

package/dist/project.js

@@ -0,0 +1,47 @@
+/**
+ * Shared ts-morph Project loader.
+ *
+ * Mirrors the tsconfig lookup from packages/review/src/inferrer.ts so codemod
+ * runs against the same type-resolution graph as review. A single Project is
+ * reused across all files in a codemod run so affected-set diagnostics amortize
+ * well under --interactive.
+ */
+import { existsSync } from 'fs';
+import { dirname, resolve } from 'path';
+import { Project } from 'ts-morph';
+function findTsConfig(startDir) {
+    let dir = startDir;
+    for (let i = 0; i < 20; i++) {
+        const candidate = resolve(dir, 'tsconfig.json');
+        if (existsSync(candidate))
+            return candidate;
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return undefined;
+}
+export function loadHostProject(opts = {}) {
+    if (opts.inMemory) {
+        return new Project({
+            compilerOptions: { strict: true, target: 99 },
+            useInMemoryFileSystem: true,
+            skipAddingFilesFromTsConfig: true,
+        });
+    }
+    const startDir = opts.cwd ?? process.cwd();
+    const tsConfigFilePath = findTsConfig(startDir);
+    if (tsConfigFilePath) {
+        return new Project({
+            tsConfigFilePath,
+            skipAddingFilesFromTsConfig: true,
+        });
+    }
+    return new Project({
+        compilerOptions: { strict: true, target: 99 },
+        useInMemoryFileSystem: false,
+        skipAddingFilesFromTsConfig: true,
+    });
+}
+//# sourceMappingURL=project.js.map

package/dist/project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../src/project.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAEnC,SAAS,YAAY,CAAC,QAAgB;IACpC,IAAI,GAAG,GAAG,QAAQ,CAAC;IACnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;QAChD,IAAI,UAAU,CAAC,SAAS,CAAC;YAAE,OAAO,SAAS,CAAC;QAC5C,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,MAAM,KAAK,GAAG;YAAE,MAAM;QAC1B,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AASD,MAAM,UAAU,eAAe,CAAC,OAA2B,EAAE;IAC3D,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClB,OAAO,IAAI,OAAO,CAAC;YACjB,eAAe,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE;YAC7C,qBAAqB,EAAE,IAAI;YAC3B,2BAA2B,EAAE,IAAI;SAClC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAC3C,MAAM,gBAAgB,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IAEhD,IAAI,gBAAgB,EAAE,CAAC;QACrB,OAAO,IAAI,OAAO,CAAC;YACjB,gBAAgB;YAChB,2BAA2B,EAAE,IAAI;SAClC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,IAAI,OAAO,CAAC;QACjB,eAAe,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE;QAC7C,qBAAqB,EAAE,KAAK;QAC5B,2BAA2B,EAAE,IAAI;KAClC,CAAC,CAAC;AACL,CAAC"}