@kernlang/evolve 3.0.0

package/dist/graduation.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @kernlang/evolve — Self-extending template system for KERN.
+ *
+ * Scans TypeScript projects, detects patterns KERN can't yet express,
+ * proposes new templates, validates them, and stages for human approval.
+ *
+ * Public API:
+ *   evolve(inputPath, options?)      — full pipeline: scan → detect → propose → stage
+ *   evolveSource(source, options?)   — single-source analysis
+ *   registerDetector(pack)           — register custom detector
+ *   loadBuiltinDetectors()           — load all built-in detectors
+ */
+export type { PatternKind, DetectorPack, DetectionResult, ExtractedParam, PatternGap, ImportDecl, GoldenExample, QualityScore, QualityThresholds, AnalyzedPattern, TemplateProposal, ValidationResult, ProposalStatus, StagedProposal, EvolveConfig, EvolveResult, ConceptGapSummary, ExpressibilityScore, NodeProposal, NodeValidationResult, NodeProposalStatus, StagedNodeProposal, } from './types.js';
+export { registerDetector, unregisterDetector, getDetector, getAllDetectors, getDetectorsForImport, getUniversalDetectors, clearDetectors, detectorCount, loadBuiltinDetectors, registerDetectors, } from './detector-registry.js';
+export { detectGaps, detectGapsInFiles, detectGapsFromSource, resetGapIds } from './gap-detector.js';
+export { detectConceptualGaps, resetConceptGapIds } from './concept-gap-adapter.js';
+export { scorePattern, passesThresholds, DEFAULT_THRESHOLDS } from './quality-scorer.js';
+export { analyzePatterns, analyzeStructuralPatterns, computeStructuralHash, deriveTemplateName } from './pattern-analyzer.js';
+export { proposeTemplates, generateKernSource } from './template-proposer.js';
+export { validateProposal } from './template-validator.js';
+export { stageProposal, listStaged, getStaged, updateStagedStatus, promoteLocal, cleanRejected, formatSplitView, stageNodeProposal, listStagedNodes, updateStagedNodeStatus, formatNodeSplitView, stageEvolveV4Proposal, listStagedEvolveV4, getStagedEvolveV4, updateStagedEvolveV4Status, cleanRejectedEvolveV4, cleanApprovedEvolveV4, formatEvolveV4SplitView, } from './staging.js';
+export { scoreExpressibility, isNodeCandidate, EXPRESSIBILITY_NODE_THRESHOLD, } from './expressibility-scorer.js';
+export { proposeNodes, deriveNodeName as deriveNodeProposalName, resetNodeProposalIds } from './node-proposer.js';
+export { governanceGate, getGovernanceThresholds } from './node-governance.js';
+export { validateNodeProposal } from './node-validator.js';
+export { evolve, evolveSource } from './evolve-runner.js';
+export type { EvolveOptions } from './evolve-runner.js';
+export type { ParserHints, EvolvedNodeDefinition, EvolvedNodeProp, EvolvedNodeReason, EvolvedManifest, EvolvedManifestEntry, EvolveNodeProposal, EvolveV4ValidationResult, EvolveV4ProposalStatus, StagedEvolveProposal, CodegenHelpers, } from './evolved-types.js';
+export { loadEvolvedNodes, clearEvolvedNodes, getEvolvedGenerator, getParserHints as getEvolvedParserHints, hasEvolvedNodes, evolvedNodeCount, getEvolvedKeywords, readManifest as readEvolvedManifest, readNodeDefinition, rebuildManifest as rebuildEvolvedManifest, } from './evolved-node-loader.js';
+export type { RebuildResult } from './evolved-node-loader.js';
+export { loadSandboxedGenerator, compileSandboxedGenerator, getCodegenHelpers } from './sandboxed-generator.js';
+export { validateEvolveProposal } from './evolve-validator-v4.js';
+export { checkDedup } from './evolve-dedup.js';
+export { compareGoldenOutput, runGoldenTests, formatGoldenTestResults } from './golden-test-runner.js';
+export { graduateNode, compileCodegenToJS, promoteNode } from './graduation.js';
+export { rollbackNode, restoreNode, findUsages, pruneNodes, detectCollisions, renameEvolvedNode } from './evolve-rollback.js';
+export type { PruneResult, CollisionInfo } from './evolve-rollback.js';
+export { buildDiscoveryPrompt, parseDiscoveryResponse, selectRepresentativeFiles, collectTsFiles, estimateTokens, buildBackfillPrompt, buildRetryPrompt } from './llm-discovery.js';
+export { createLLMProvider, TokenBudget } from './llm-provider.js';
+export type { LLMProvider, LLMProviderOptions } from './llm-provider.js';

package/dist/index.js

@@ -0,0 +1,58 @@
+/**
+ * @kernlang/evolve — Self-extending template system for KERN.
+ *
+ * Scans TypeScript projects, detects patterns KERN can't yet express,
+ * proposes new templates, validates them, and stages for human approval.
+ *
+ * Public API:
+ *   evolve(inputPath, options?)      — full pipeline: scan → detect → propose → stage
+ *   evolveSource(source, options?)   — single-source analysis
+ *   registerDetector(pack)           — register custom detector
+ *   loadBuiltinDetectors()           — load all built-in detectors
+ */
+// Detector Registry
+export { registerDetector, unregisterDetector, getDetector, getAllDetectors, getDetectorsForImport, getUniversalDetectors, clearDetectors, detectorCount, loadBuiltinDetectors, registerDetectors, } from './detector-registry.js';
+// Gap Detector
+export { detectGaps, detectGapsInFiles, detectGapsFromSource, resetGapIds } from './gap-detector.js';
+// Concept Gap Adapter
+export { detectConceptualGaps, resetConceptGapIds } from './concept-gap-adapter.js';
+// Quality Scorer
+export { scorePattern, passesThresholds, DEFAULT_THRESHOLDS } from './quality-scorer.js';
+// Pattern Analyzer
+export { analyzePatterns, analyzeStructuralPatterns, computeStructuralHash, deriveTemplateName } from './pattern-analyzer.js';
+// Template Proposer
+export { proposeTemplates, generateKernSource } from './template-proposer.js';
+// Template Validator
+export { validateProposal } from './template-validator.js';
+// Staging
+export { stageProposal, listStaged, getStaged, updateStagedStatus, promoteLocal, cleanRejected, formatSplitView, 
+// v3 node staging
+stageNodeProposal, listStagedNodes, updateStagedNodeStatus, formatNodeSplitView, 
+// v4 evolve staging
+stageEvolveV4Proposal, listStagedEvolveV4, getStagedEvolveV4, updateStagedEvolveV4Status, cleanRejectedEvolveV4, cleanApprovedEvolveV4, formatEvolveV4SplitView, } from './staging.js';
+// Expressibility Scorer (v3)
+export { scoreExpressibility, isNodeCandidate, EXPRESSIBILITY_NODE_THRESHOLD, } from './expressibility-scorer.js';
+// Node Proposer (v3)
+export { proposeNodes, deriveNodeName as deriveNodeProposalName, resetNodeProposalIds } from './node-proposer.js';
+// Node Governance (v3)
+export { governanceGate, getGovernanceThresholds } from './node-governance.js';
+// Node Validator (v3)
+export { validateNodeProposal } from './node-validator.js';
+// Evolve Runner (main entry points)
+export { evolve, evolveSource } from './evolve-runner.js';
+// Evolved Node Loader
+export { loadEvolvedNodes, clearEvolvedNodes, getEvolvedGenerator, getParserHints as getEvolvedParserHints, hasEvolvedNodes, evolvedNodeCount, getEvolvedKeywords, readManifest as readEvolvedManifest, readNodeDefinition, rebuildManifest as rebuildEvolvedManifest, } from './evolved-node-loader.js';
+// Sandboxed Generator
+export { loadSandboxedGenerator, compileSandboxedGenerator, getCodegenHelpers } from './sandboxed-generator.js';
+// v4 Validation
+export { validateEvolveProposal } from './evolve-validator-v4.js';
+export { checkDedup } from './evolve-dedup.js';
+export { compareGoldenOutput, runGoldenTests, formatGoldenTestResults } from './golden-test-runner.js';
+// Graduation
+export { graduateNode, compileCodegenToJS, promoteNode } from './graduation.js';
+// Rollback + Prune + Migrate
+export { rollbackNode, restoreNode, findUsages, pruneNodes, detectCollisions, renameEvolvedNode } from './evolve-rollback.js';
+// LLM Discovery
+export { buildDiscoveryPrompt, parseDiscoveryResponse, selectRepresentativeFiles, collectTsFiles, estimateTokens, buildBackfillPrompt, buildRetryPrompt } from './llm-discovery.js';
+export { createLLMProvider, TokenBudget } from './llm-provider.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;;;;;;;;;;;GAWG;AA6BH,oBAAoB;AACpB,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,WAAW,EACX,eAAe,EACf,qBAAqB,EACrB,qBAAqB,EACrB,cAAc,EACd,aAAa,EACb,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAEhC,eAAe;AACf,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErG,sBAAsB;AACtB,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEpF,iBAAiB;AACjB,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzF,mBAAmB;AACnB,OAAO,EAAE,eAAe,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE9H,oBAAoB;AACpB,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE9E,qBAAqB;AACrB,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,UAAU;AACV,OAAO,EACL,aAAa,EACb,UAAU,EACV,SAAS,EACT,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACb,eAAe;AACf,kBAAkB;AAClB,iBAAiB,EACjB,eAAe,EACf,sBAAsB,EACtB,mBAAmB;AACnB,oBAAoB;AACpB,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,EACjB,0BAA0B,EAC1B,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,cAAc,CAAC;AAEtB,6BAA6B;AAC7B,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,6BAA6B,GAC9B,MAAM,4BAA4B,CAAC;AAEpC,qBAAqB;AACrB,OAAO,EAAE,YAAY,EAAE,cAAc,IAAI,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAElH,uBAAuB;AACvB,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAE/E,sBAAsB;AACtB,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE3D,oCAAoC;AACpC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAoB1D,sBAAsB;AACtB,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,IAAI,qBAAqB,EACvC,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,YAAY,IAAI,mBAAmB,EACnC,kBAAkB,EAClB,eAAe,IAAI,sBAAsB,GAC1C,MAAM,0BAA0B,CAAC;AAGlC,sBAAsB;AACtB,OAAO,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAEhH,gBAAgB;AAChB,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAEvG,aAAa;AACb,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEhF,6BAA6B;AAC7B,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAG9H,gBAAgB;AAChB,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,cAAc,EAAE,cAAc,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACpL,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/llm-discovery.d.ts

@@ -0,0 +1,55 @@
+/**
+ * LLM Discovery — universal pattern recognition for KERN Evolve v4.
+ *
+ * No hardcoded detectors. The LLM reads TypeScript source files and
+ * identifies repeating patterns that KERN can't yet express.
+ *
+ * Offline-safe: this module only constructs prompts and parses responses.
+ * The actual LLM call is handled by llm-provider.ts.
+ */
+import type { EvolveNodeProposal, EvolvedNodeProp } from './evolved-types.js';
+/**
+ * Select representative TypeScript files, clustered by directory.
+ * Returns batches of 3-5 files suitable for LLM context.
+ *
+ * @param filePaths — all .ts/.tsx files in the project
+ * @param maxPerCluster — max files to sample per directory (default: 3)
+ * @param maxBatchSize — max files per LLM batch (default: 5)
+ */
+export declare function selectRepresentativeFiles(filePaths: string[], maxPerCluster?: number, maxBatchSize?: number): string[][];
+/**
+ * Collect all TypeScript files from a directory (recursive).
+ * Skips node_modules, dist, .files, test files, and .d.ts files.
+ */
+export declare function collectTsFiles(dir: string, recursive?: boolean): string[];
+/**
+ * Build the LLM discovery prompt for a batch of files.
+ */
+export declare function buildDiscoveryPrompt(files: Array<{
+    path: string;
+    content: string;
+}>, nodeTypes: readonly string[], evolvedKeywords?: string[]): string;
+/**
+ * Parse the LLM response into EvolveNodeProposal[].
+ * Handles common LLM quirks: markdown fences, preamble, trailing text.
+ */
+export declare function parseDiscoveryResponse(response: string, evolveRunId?: string): EvolveNodeProposal[];
+/**
+ * Estimate token count for a string (rough: 1 token ≈ 4 chars).
+ */
+export declare function estimateTokens(text: string): number;
+/**
+ * Build a prompt asking the LLM to fix a failed proposal.
+ * Feeds back the validation errors so the LLM can correct its output.
+ */
+export declare function buildRetryPrompt(proposal: EvolveNodeProposal, errors: string[]): string;
+/**
+ * Build a prompt for LLM to generate a target-specific codegen for an evolved node.
+ */
+export declare function buildBackfillPrompt(keyword: string, definition: {
+    props: EvolvedNodeProp[];
+    childTypes: string[];
+    kernExample: string;
+    codegenSource: string;
+    expectedOutput: string;
+}, target: string): string;

package/dist/llm-discovery.js

@@ -0,0 +1,352 @@
+/**
+ * LLM Discovery — universal pattern recognition for KERN Evolve v4.
+ *
+ * No hardcoded detectors. The LLM reads TypeScript source files and
+ * identifies repeating patterns that KERN can't yet express.
+ *
+ * Offline-safe: this module only constructs prompts and parses responses.
+ * The actual LLM call is handled by llm-provider.ts.
+ */
+import { readdirSync, statSync } from 'fs';
+import { resolve, join, dirname } from 'path';
+// ── File Selection ───────────────────────────────────────────────────────
+/**
+ * Select representative TypeScript files, clustered by directory.
+ * Returns batches of 3-5 files suitable for LLM context.
+ *
+ * @param filePaths — all .ts/.tsx files in the project
+ * @param maxPerCluster — max files to sample per directory (default: 3)
+ * @param maxBatchSize — max files per LLM batch (default: 5)
+ */
+export function selectRepresentativeFiles(filePaths, maxPerCluster = 3, maxBatchSize = 5) {
+    // Cluster by parent directory
+    const clusters = new Map();
+    for (const fp of filePaths) {
+        const dir = dirname(fp);
+        const cluster = clusters.get(dir) || [];
+        cluster.push(fp);
+        clusters.set(dir, cluster);
+    }
+    // Sample from each cluster: pick diverse files (by size variance)
+    const sampled = [];
+    for (const [dir, files] of clusters) {
+        // Sort by file size (descending) to get diverse samples
+        const sorted = [...files].sort((a, b) => {
+            try {
+                return statSync(b).size - statSync(a).size;
+            }
+            catch {
+                return 0;
+            }
+        });
+        // Take up to maxPerCluster, spread across the size range
+        const take = Math.min(sorted.length, maxPerCluster);
+        if (take <= 2) {
+            sampled.push(...sorted.slice(0, take));
+        }
+        else {
+            // First, middle, last for diversity
+            const step = Math.floor((sorted.length - 1) / (take - 1));
+            for (let i = 0; i < take; i++) {
+                const idx = Math.min(i * step, sorted.length - 1);
+                sampled.push(sorted[idx]);
+            }
+        }
+    }
+    // Group into batches
+    const batches = [];
+    for (let i = 0; i < sampled.length; i += maxBatchSize) {
+        batches.push(sampled.slice(i, i + maxBatchSize));
+    }
+    return batches;
+}
+/**
+ * Collect all TypeScript files from a directory (recursive).
+ * Skips node_modules, dist, .files, test files, and .d.ts files.
+ */
+export function collectTsFiles(dir, recursive = true) {
+    const files = [];
+    function walk(d) {
+        try {
+            for (const entry of readdirSync(d, { withFileTypes: true })) {
+                if (entry.name.startsWith('.') || entry.name === 'node_modules' || entry.name === 'dist')
+                    continue;
+                const full = join(d, entry.name);
+                if (entry.isDirectory() && recursive) {
+                    walk(full);
+                }
+                else if ((entry.name.endsWith('.ts') || entry.name.endsWith('.tsx')) &&
+                    !entry.name.endsWith('.d.ts') &&
+                    !entry.name.endsWith('.test.ts') &&
+                    !entry.name.endsWith('.test.tsx') &&
+                    !entry.name.endsWith('.spec.ts')) {
+                    files.push(full);
+                }
+            }
+        }
+        catch { // file may not exist
+        }
+    }
+    walk(resolve(dir));
+    return files;
+}
+// ── Prompt Construction ──────────────────────────────────────────────────
+/**
+ * Build the LLM discovery prompt for a batch of files.
+ */
+export function buildDiscoveryPrompt(files, nodeTypes, evolvedKeywords = []) {
+    const fileBlocks = files.map(f => `### ${f.path}\n\`\`\`typescript\n${truncate(f.content, 3000)}\n\`\`\``).join('\n\n');
+    const existingNodes = [...nodeTypes, ...evolvedKeywords].join(', ');
+    return `You are analyzing TypeScript source files to find repeating structural patterns that a language called KERN cannot yet express.
+
+KERN is an indent-based IR language that compiles to TypeScript. It has these existing node types:
+${existingNodes}
+
+## Source Files to Analyze
+
+${fileBlocks}
+
+## Your Task
+
+Identify **repeating structural patterns** in these files that:
+1. Appear 2+ times (across these files or clearly would across a larger codebase)
+2. Cannot be expressed by any existing KERN node type listed above
+3. Have a clear structural template (not just random code)
+4. Would benefit from a first-class language construct (saves boilerplate, enforces consistency)
+
+## Response Format
+
+Respond with a JSON array. Each element represents one proposed node:
+
+\`\`\`json
+[
+  {
+    "keyword": "lowercase-with-hyphens",
+    "displayName": "Human Readable Name",
+    "description": "What this node represents",
+    "props": [
+      { "name": "propName", "type": "string", "required": true, "description": "What this prop does" }
+    ],
+    "childTypes": ["child-type-if-any"],
+    "kernExample": "keyword prop1=value1 prop2=value2\\n  child-type prop=value",
+    "expectedOutput": "export const example = { /* generated TS */ };",
+    "codegenSource": "module.exports = function(node, helpers) {\\n  var name = helpers.p(node).name;\\n  return ['export const ' + name + ' = {};'];\\n};",
+    "reason": {
+      "observation": "Found N instances of this pattern in the analyzed files",
+      "inefficiency": "Each instance requires M lines of boilerplate",
+      "kernBenefit": "Reduces to K lines of KERN, ensures consistency"
+    }
+  }
+]
+\`\`\`
+
+## Critical Rules
+
+1. **codegenSource MUST be valid CommonJS JavaScript** (not TypeScript). Use \`module.exports = function(node, helpers) { ... }\`. The function receives an AST node and helpers object.
+2. **Available helpers:** \`helpers.p(node)\` returns props, \`helpers.kids(node, 'type')\` returns children of type, \`helpers.firstChild(node, 'type')\`, \`helpers.capitalize(str)\`, \`helpers.parseParamList(str)\`, \`helpers.dedent(str)\`, \`helpers.handlerCode(node)\`, \`helpers.exportPrefix(node)\`.
+3. **The function must return string[]** — an array of lines of TypeScript code.
+4. **kernExample must parse** with KERN's indent-based parser (2-space indents, key=value props, no special syntax).
+5. **expectedOutput must be the TypeScript** that codegenSource would produce for kernExample.
+6. **keyword must be lowercase with hyphens**, not colliding with existing node types.
+7. **Return an empty array []** if no valid patterns are found. Do not hallucinate patterns.
+8. **Only return the JSON array.** No markdown, no explanation, no preamble.`;
+}
+// ── Response Parsing ─────────────────────────────────────────────────────
+/**
+ * Parse the LLM response into EvolveNodeProposal[].
+ * Handles common LLM quirks: markdown fences, preamble, trailing text.
+ */
+export function parseDiscoveryResponse(response, evolveRunId = `run-${Date.now()}`) {
+    // Strip markdown fences
+    let json = response.trim();
+    const fenceMatch = json.match(/```(?:json)?\s*\n?([\s\S]*?)```/);
+    if (fenceMatch) {
+        json = fenceMatch[1].trim();
+    }
+    // Try to find JSON array boundaries
+    const arrayStart = json.indexOf('[');
+    const arrayEnd = json.lastIndexOf(']');
+    if (arrayStart === -1 || arrayEnd === -1 || arrayEnd <= arrayStart) {
+        return [];
+    }
+    json = json.slice(arrayStart, arrayEnd + 1);
+    let parsed;
+    try {
+        parsed = JSON.parse(json);
+    }
+    catch {
+        return [];
+    }
+    if (!Array.isArray(parsed))
+        return [];
+    const proposals = [];
+    for (const item of parsed) {
+        try {
+            const p = normalizeProposal(item, evolveRunId);
+            if (p)
+                proposals.push(p);
+        }
+        catch (err) {
+            // Malformed LLM response entry — log and continue
+            if (process.env.KERN_DEBUG)
+                console.warn('Skipping malformed proposal entry:', err.message);
+        }
+    }
+    return proposals;
+}
+function normalizeProposal(raw, evolveRunId) {
+    const keyword = raw.keyword;
+    if (!keyword || typeof keyword !== 'string')
+        return null;
+    // Normalize keyword to lowercase with hyphens
+    const normalizedKeyword = keyword.toLowerCase().replace(/[^a-z0-9-]/g, '-').replace(/-+/g, '-').replace(/^-|-$/g, '');
+    if (!normalizedKeyword)
+        return null;
+    const reason = raw.reason || {};
+    return {
+        id: `proposal-${normalizedKeyword}-${Date.now()}`,
+        keyword: normalizedKeyword,
+        displayName: raw.displayName || normalizedKeyword,
+        description: raw.description || '',
+        props: normalizeProps(raw.props),
+        childTypes: Array.isArray(raw.childTypes) ? raw.childTypes.filter((c) => typeof c === 'string') : [],
+        kernExample: raw.kernExample || '',
+        expectedOutput: raw.expectedOutput || '',
+        codegenSource: raw.codegenSource || '',
+        parserHints: undefined,
+        targetOverrides: undefined,
+        reason: {
+            observation: reason.observation || '',
+            inefficiency: reason.inefficiency || '',
+            kernBenefit: reason.kernBenefit || '',
+            frequency: reason.frequency || 0,
+            avgLines: reason.avgLines || 0,
+            instances: Array.isArray(reason.instances) ? reason.instances : [],
+        },
+        codegenTier: 1,
+        proposedAt: new Date().toISOString(),
+        evolveRunId,
+    };
+}
+function normalizeProps(raw) {
+    if (!Array.isArray(raw))
+        return [];
+    return raw
+        .filter((p) => p !== null && typeof p === 'object')
+        .map(p => ({
+        name: p.name || 'unknown',
+        type: (['string', 'boolean', 'number', 'expression'].includes(p.type) ? p.type : 'string'),
+        required: p.required === true,
+        description: p.description || '',
+    }));
+}
+// ── Utility ──────────────────────────────────────────────────────────────
+function truncate(content, maxChars) {
+    if (content.length <= maxChars)
+        return content;
+    return content.slice(0, maxChars) + '\n// ... truncated ...';
+}
+/**
+ * Estimate token count for a string (rough: 1 token ≈ 4 chars).
+ */
+export function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+// ── Retry Prompt ──────────────────────────────────────────────────────────
+/**
+ * Build a prompt asking the LLM to fix a failed proposal.
+ * Feeds back the validation errors so the LLM can correct its output.
+ */
+export function buildRetryPrompt(proposal, errors) {
+    return `Your previous KERN node proposal "${proposal.keyword}" failed validation. Fix the issues and return the corrected proposal.
+
+## Previous Proposal
+
+keyword: ${proposal.keyword}
+kernExample: ${proposal.kernExample}
+expectedOutput: ${proposal.expectedOutput}
+codegenSource:
+${proposal.codegenSource}
+
+## Validation Errors
+
+${errors.map((e, i) => `${i + 1}. ${e}`).join('\n')}
+
+## Rules
+
+1. **codegenSource MUST be valid CommonJS JavaScript** (not TypeScript). Use \`module.exports = function(node, helpers) { ... }\`.
+2. **Available helpers:** \`helpers.p(node)\` returns props, \`helpers.kids(node, 'type')\`, \`helpers.firstChild(node, 'type')\`, \`helpers.capitalize(str)\`, \`helpers.parseParamList(str)\`, \`helpers.dedent(str)\`, \`helpers.handlerCode(node)\`, \`helpers.exportPrefix(node)\`.
+3. **The function must return string[]** — an array of lines of TypeScript code.
+4. **kernExample must parse** with KERN's indent-based parser (2-space indents, key=value props).
+5. **expectedOutput must match** what codegenSource produces for kernExample.
+
+## Response Format
+
+Return ONLY the corrected JSON object (same schema as before):
+
+\`\`\`json
+{
+  "keyword": "${proposal.keyword}",
+  "displayName": "${proposal.displayName}",
+  "description": "${proposal.description}",
+  "props": ${JSON.stringify(proposal.props)},
+  "childTypes": ${JSON.stringify(proposal.childTypes)},
+  "kernExample": "...",
+  "expectedOutput": "...",
+  "codegenSource": "module.exports = function(node, helpers) { ... }",
+  "reason": ${JSON.stringify(proposal.reason)}
+}
+\`\`\`
+
+No markdown outside the JSON block. No explanation.`;
+}
+// ── Backfill Prompt ───────────────────────────────────────────────────────
+/**
+ * Build a prompt for LLM to generate a target-specific codegen for an evolved node.
+ */
+export function buildBackfillPrompt(keyword, definition, target) {
+    return `You are generating a target-specific code generator for a KERN evolved node.
+
+## Node: ${keyword}
+Target: ${target}
+
+## Props
+${definition.props.map(p => `- ${p.name} (${p.type}${p.required ? ', required' : ''}): ${p.description}`).join('\n')}
+
+## Child Types
+${definition.childTypes.join(', ') || '(none)'}
+
+## KERN Example Input
+\`\`\`kern
+${definition.kernExample}
+\`\`\`
+
+## Default Codegen (TypeScript target)
+\`\`\`javascript
+${definition.codegenSource}
+\`\`\`
+
+## Default Output (TypeScript)
+\`\`\`typescript
+${definition.expectedOutput}
+\`\`\`
+
+## Your Task
+
+Write a **CommonJS JavaScript** function that generates **${target}**-specific output for this node. The function receives \`(node, helpers)\` and must return \`string[]\` (lines of code).
+
+Available helpers: \`helpers.p(node)\` (props), \`helpers.kids(node, 'type')\` (children), \`helpers.firstChild(node, 'type')\`, \`helpers.capitalize(str)\`, \`helpers.parseParamList(str)\`, \`helpers.dedent(str)\`, \`helpers.handlerCode(node)\`, \`helpers.exportPrefix(node)\`.
+
+## Response Format
+
+Return ONLY a JSON object:
+\`\`\`json
+{
+  "codegenSource": "module.exports = function(node, helpers) { ... }",
+  "expectedOutput": "// expected output for the kern example above"
+}
+\`\`\`
+
+No markdown, no explanation, just the JSON object.`;
+}
+//# sourceMappingURL=llm-discovery.js.map

package/dist/llm-discovery.js.map

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

package/dist/llm-provider.d.ts

@@ -0,0 +1,35 @@
+/**
+ * LLM Provider — abstraction over OpenAI, Anthropic, and local models.
+ *
+ * Used only by `kern evolve discover` and `kern evolve backfill`.
+ * Never called during compilation.
+ */
+export interface LLMProvider {
+    name: string;
+    complete(prompt: string): Promise<string>;
+}
+export interface LLMProviderOptions {
+    provider?: 'openai' | 'anthropic' | 'ollama';
+    model?: string;
+    maxTokens?: number;
+    apiKey?: string;
+    baseUrl?: string;
+}
+/**
+ * Create an LLM provider based on configuration.
+ * Checks environment variables for API keys.
+ */
+export declare function createLLMProvider(options?: LLMProviderOptions): LLMProvider;
+/**
+ * Track token usage for cost estimation.
+ */
+export declare class TokenBudget {
+    readonly limit: number;
+    private used;
+    constructor(limit: number);
+    add(tokens: number): void;
+    get remaining(): number;
+    get exhausted(): boolean;
+    get totalUsed(): number;
+    toString(): string;
+}