@kernlang/codemod 3.3.4

package/dist/template-loader.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Template loader — lazy-registers built-in KERN templates from @kernlang/core's
+ * TEMPLATE_CATALOG so expandTemplateNode can find them.
+ *
+ * Uses defaultRuntime's template registry. Idempotent: calling ensureTemplate()
+ * for the same templateName twice only registers it once.
+ */
+/**
+ * Ensure the named template is registered. Searches TEMPLATE_CATALOG, parses
+ * the first matching template source, and registers it with defaultRuntime.
+ *
+ * Returns true if the template is available (either newly registered or already
+ * was), false if it wasn't found in the catalog.
+ */
+export declare function ensureTemplate(templateName: string): boolean;

package/dist/template-loader.js

@@ -0,0 +1,55 @@
+/**
+ * Template loader — lazy-registers built-in KERN templates from @kernlang/core's
+ * TEMPLATE_CATALOG so expandTemplateNode can find them.
+ *
+ * Uses defaultRuntime's template registry. Idempotent: calling ensureTemplate()
+ * for the same templateName twice only registers it once.
+ */
+import { defaultRuntime, parse, registerTemplate, TEMPLATE_CATALOG } from '@kernlang/core';
+const registered = new Set();
+function findTemplateNode(source, templateName) {
+    let ast;
+    try {
+        ast = parse(source);
+    }
+    catch {
+        // A single catalog template failing to parse must not abort lookup for
+        // every other template.
+        return undefined;
+    }
+    if (ast.type === 'template' && ast.props?.name === templateName)
+        return ast;
+    for (const child of ast.children || []) {
+        if (child.type === 'template' && child.props?.name === templateName)
+            return child;
+    }
+    return undefined;
+}
+/**
+ * Ensure the named template is registered. Searches TEMPLATE_CATALOG, parses
+ * the first matching template source, and registers it with defaultRuntime.
+ *
+ * Returns true if the template is available (either newly registered or already
+ * was), false if it wasn't found in the catalog.
+ */
+export function ensureTemplate(templateName) {
+    if (registered.has(templateName))
+        return true;
+    // If someone else already registered it, trust that.
+    if (defaultRuntime.templateRegistry.has(templateName)) {
+        registered.add(templateName);
+        return true;
+    }
+    for (const entry of TEMPLATE_CATALOG) {
+        for (const source of Object.values(entry.templates)) {
+            const node = findTemplateNode(source, templateName);
+            if (node) {
+                registerTemplate(node);
+                registered.add(templateName);
+                return true;
+            }
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=template-loader.js.map

package/dist/template-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-loader.js","sourceRoot":"","sources":["../src/template-loader.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,EAAe,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAExG,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;AAErC,SAAS,gBAAgB,CAAC,MAAc,EAAE,YAAoB;IAC5D,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;IACtB,CAAC;IAAC,MAAM,CAAC;QACP,uEAAuE;QACvE,wBAAwB;QACxB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,GAAG,CAAC,IAAI,KAAK,UAAU,IAAI,GAAG,CAAC,KAAK,EAAE,IAAI,KAAK,YAAY;QAAE,OAAO,GAAG,CAAC;IAC5E,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;QACvC,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,IAAI,KAAK,CAAC,KAAK,EAAE,IAAI,KAAK,YAAY;YAAE,OAAO,KAAK,CAAC;IACpF,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,YAAoB;IACjD,IAAI,UAAU,CAAC,GAAG,CAAC,YAAY,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9C,qDAAqD;IACrD,IAAI,cAAc,CAAC,gBAAgB,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;QACtD,UAAU,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,gBAAgB,EAAE,CAAC;QACrC,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;YACpD,MAAM,IAAI,GAAG,gBAAgB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;YACpD,IAAI,IAAI,EAAE,CAAC;gBACT,gBAAgB,CAAC,IAAI,CAAC,CAAC;gBACvB,UAAU,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;gBAC7B,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Types for @kernlang/codemod.
+ *
+ * TemplateMatch from @kernlang/review is treated as a candidate signal only.
+ * Each TemplateAdapter re-derives the exact AST span, extracts CHILDREN from
+ * the user's interior, and returns a RewritePlan. The orchestrator applies
+ * the plan, then gates the write behind reparse, re-detect, and a two-stage
+ * diagnostics check.
+ */
+import type { TemplateMatch } from '@kernlang/review';
+import type { SourceFile } from 'ts-morph';
+/** Exact replacement span in the source file, anchored by an adapter. */
+export interface ResolvedRegion {
+    /** Character offset start (inclusive) */
+    start: number;
+    /** Character offset end (exclusive) */
+    end: number;
+    /** Human-readable description used in audit/logging (e.g. "VariableStatement at L12") */
+    label: string;
+}
+/** Result of extracting the user's interior into CHILDREN lines. */
+export type ExtractResult = {
+    ok: true;
+    children: string[];
+} | {
+    ok: false;
+    reason: string;
+};
+/** Result of resolving the replacement region. */
+export type ResolveResult = {
+    ok: true;
+    region: ResolvedRegion;
+} | {
+    ok: false;
+    reason: string;
+};
+/** A template adapter owns one templateName's rewrite semantics end-to-end. */
+export interface TemplateAdapter {
+    /** Matches TemplateMatch.templateName (e.g. 'zustand-store') */
+    readonly templateName: string;
+    /** Re-derive the real rewrite span from the candidate match. */
+    resolveRegion(sourceFile: SourceFile, match: TemplateMatch): ResolveResult;
+    /** Extract the user interior as KERN child lines to be injected as {{CHILDREN}}. */
+    extractChildren(sourceFile: SourceFile, region: ResolvedRegion, match: TemplateMatch): ExtractResult;
+}
+export interface ApplyOptions {
+    /** Actually write to disk. Default false (dry-run). */
+    write?: boolean;
+    /** Minimum confidence percentage to consider (0-100). Default 80. */
+    minConfidence?: number;
+    /** Restrict to a single template name. */
+    templateName?: string;
+    /** Path to write audit JSONL. Default .kern/codemod-audit.jsonl under cwd. */
+    auditPath?: string;
+    /** Override cwd (affects tsconfig lookup + audit path). */
+    cwd?: string;
+}
+export type ApplyDecision = 'applied' | 'dry-run' | 'skipped' | 'rejected';
+export interface ApplyResult {
+    filePath: string;
+    templateName: string;
+    confidencePct: number;
+    decision: ApplyDecision;
+    reason?: string;
+    /** Span that was replaced (character offsets). Present when adapter resolved. */
+    replacedSpan?: {
+        start: number;
+        end: number;
+    };
+    /** Unified diff between original and transformed text (present for applied/dry-run). */
+    diff?: string;
+    /** True when transformed text parsed cleanly. */
+    parseOk?: boolean;
+    /** True when post-transform re-detection no longer finds the original match. */
+    reDetectOk?: boolean;
+    /** New tsc diagnostics introduced by this edit (empty = safe). */
+    newDiagnostics?: string[];
+    tsTokens?: number;
+    kernTokens?: number;
+    /** ISO-8601 */
+    timestamp: string;
+}
+export type AuditEntry = ApplyResult & {
+    /** Schema version for forward compatibility */
+    schema: 1;
+};

package/dist/types.js

@@ -0,0 +1,11 @@
+/**
+ * Types for @kernlang/codemod.
+ *
+ * TemplateMatch from @kernlang/review is treated as a candidate signal only.
+ * Each TemplateAdapter re-derives the exact AST span, extracts CHILDREN from
+ * the user's interior, and returns a RewritePlan. The orchestrator applies
+ * the plan, then gates the write behind reparse, re-detect, and a two-stage
+ * diagnostics check.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@kernlang/codemod",
+  "version": "3.3.4",
+  "description": "Kern Codemod — apply kern-review TemplateMatch results to rewrite TS into KERN-template-backed TS",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "kern",
+    "codemod",
+    "refactor",
+    "typescript",
+    "ai"
+  ],
+  "license": "AGPL-3.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/KERNlang/kern",
+    "directory": "packages/codemod"
+  },
+  "dependencies": {
+    "ts-morph": "^28.0.0",
+    "@kernlang/core": "3.3.4",
+    "@kernlang/review": "3.3.4"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "test": "node --experimental-vm-modules ../../node_modules/jest/bin/jest.js --config jest.config.js"
+  }
+}