@kernlang/evolve 3.0.0

package/dist/evolved-types.js

@@ -0,0 +1,8 @@
+/**
+ * Evolve v4 Types — Self-Extending IR
+ *
+ * These types define the schema for evolved nodes: proposals from LLM discovery,
+ * graduated node definitions on disk, parser hints, and validation results.
+ */
+export {};
+//# sourceMappingURL=evolved-types.js.map

package/dist/evolved-types.js.map

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

package/dist/expressibility-scorer.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Expressibility Scorer — measures how well the current IR handles a pattern.
+ *
+ * Scores from 0-10 where higher = less expressible (needs a new node type).
+ * Used to decide when to propose new IR nodes vs. just new templates.
+ */
+import type { PatternGap, ExpressibilityScore } from './types.js';
+/** Score above which a pattern is a candidate for a new IR node. */
+export declare const EXPRESSIBILITY_NODE_THRESHOLD = 7;
+/**
+ * Score how well the current IR can express the patterns found in these gaps.
+ *
+ * - Handler escapes (<<<...>>>) mean the IR can't express the logic — weight 3
+ * - Non-standard attributes mean the node types lack proper slots — weight 2
+ * - Semantic leaks (raw code in props) mean the abstraction is leaking — weight 1.5
+ */
+export declare function scoreExpressibility(gaps: PatternGap[], snippets: string[]): ExpressibilityScore;
+/** Check if an expressibility score warrants proposing a new IR node. */
+export declare function isNodeCandidate(score: ExpressibilityScore): boolean;

package/dist/expressibility-scorer.js

@@ -0,0 +1,78 @@
+/**
+ * Expressibility Scorer — measures how well the current IR handles a pattern.
+ *
+ * Scores from 0-10 where higher = less expressible (needs a new node type).
+ * Used to decide when to propose new IR nodes vs. just new templates.
+ */
+// Weights for different signal types
+const HANDLER_ESCAPE_WEIGHT = 3;
+const NON_STANDARD_ATTR_WEIGHT = 2;
+const SEMANTIC_LEAK_WEIGHT = 1.5;
+// Max counts for normalization (clamp above these)
+const MAX_HANDLER_ESCAPES = 5;
+const MAX_NON_STANDARD_ATTRS = 8;
+const MAX_SEMANTIC_LEAKS = 6;
+/** Score above which a pattern is a candidate for a new IR node. */
+export const EXPRESSIBILITY_NODE_THRESHOLD = 7.0;
+/**
+ * Score how well the current IR can express the patterns found in these gaps.
+ *
+ * - Handler escapes (<<<...>>>) mean the IR can't express the logic — weight 3
+ * - Non-standard attributes mean the node types lack proper slots — weight 2
+ * - Semantic leaks (raw code in props) mean the abstraction is leaking — weight 1.5
+ */
+export function scoreExpressibility(gaps, snippets) {
+    let handlerEscapes = 0;
+    let nonStandardAttrs = 0;
+    let semanticLeaks = 0;
+    for (const snippet of snippets) {
+        // Count handler escapes: <<<...>>>
+        const handlerMatches = snippet.match(/<<<[^]*?>>>/g);
+        if (handlerMatches)
+            handlerEscapes += handlerMatches.length;
+        // Count non-standard attributes (attrs that aren't name, value, type, etc.)
+        const attrMatches = snippet.match(/\b[a-z][a-zA-Z]*=/g);
+        if (attrMatches) {
+            const standard = new Set(['name', 'value', 'type', 'key', 'id', 'class', 'src', 'href', 'label', 'placeholder']);
+            for (const attr of attrMatches) {
+                const attrName = attr.slice(0, -1);
+                if (!standard.has(attrName))
+                    nonStandardAttrs++;
+            }
+        }
+        // Count semantic leaks: raw code expressions in {{ }}
+        const exprMatches = snippet.match(/\{\{[^}]+\}\}/g);
+        if (exprMatches)
+            semanticLeaks += exprMatches.length;
+    }
+    // Also count from gap snippets not already in snippets array
+    const snippetSet = new Set(snippets);
+    for (const gap of gaps) {
+        if (snippetSet.has(gap.snippet))
+            continue;
+        if (gap.snippet.includes('<<<'))
+            handlerEscapes++;
+        if (gap.snippet.includes('{{'))
+            semanticLeaks++;
+    }
+    // Normalize each dimension to 0-10
+    const normHandler = Math.min(handlerEscapes / MAX_HANDLER_ESCAPES, 1) * 10;
+    const normAttrs = Math.min(nonStandardAttrs / MAX_NON_STANDARD_ATTRS, 1) * 10;
+    const normLeaks = Math.min(semanticLeaks / MAX_SEMANTIC_LEAKS, 1) * 10;
+    // Weighted average
+    const totalWeight = HANDLER_ESCAPE_WEIGHT + NON_STANDARD_ATTR_WEIGHT + SEMANTIC_LEAK_WEIGHT;
+    const overall = (normHandler * HANDLER_ESCAPE_WEIGHT +
+        normAttrs * NON_STANDARD_ATTR_WEIGHT +
+        normLeaks * SEMANTIC_LEAK_WEIGHT) / totalWeight;
+    return {
+        handlerEscapes,
+        nonStandardAttrs,
+        semanticLeaks,
+        overall: Math.round(overall * 100) / 100,
+    };
+}
+/** Check if an expressibility score warrants proposing a new IR node. */
+export function isNodeCandidate(score) {
+    return score.overall > EXPRESSIBILITY_NODE_THRESHOLD;
+}
+//# sourceMappingURL=expressibility-scorer.js.map

package/dist/expressibility-scorer.js.map

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

package/dist/gap-detector.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Gap Detector — Phase 1 of the evolve pipeline.
+ *
+ * Uses @kernlang/review to find what IS covered, then runs pluggable
+ * detector packs to find what's NOT covered (gaps).
+ */
+import { Project, type SourceFile } from 'ts-morph';
+import type { ReviewReport } from '@kernlang/review';
+import type { PatternGap } from './types.js';
+/**
+ * Reset the gap ID counter (for test isolation).
+ */
+export declare function resetGapIds(): void;
+/**
+ * Detect gaps in a single TS file: patterns that exist in the code
+ * but are NOT covered by existing KERN templates.
+ */
+export declare function detectGaps(sourceFile: SourceFile, filePath: string, existingCoverage?: ReviewReport): PatternGap[];
+/**
+ * Detect gaps across multiple files.
+ */
+export declare function detectGapsInFiles(filePaths: string[], project?: Project): PatternGap[];
+/**
+ * Detect gaps from a source string (useful for testing).
+ */
+export declare function detectGapsFromSource(source: string, filePath?: string, project?: Project): PatternGap[];

package/dist/gap-detector.js

@@ -0,0 +1,141 @@
+/**
+ * Gap Detector — Phase 1 of the evolve pipeline.
+ *
+ * Uses @kernlang/review to find what IS covered, then runs pluggable
+ * detector packs to find what's NOT covered (gaps).
+ */
+import { Project } from 'ts-morph';
+import { reviewFile } from '@kernlang/review';
+import { getDetectorsForImport, getUniversalDetectors } from './detector-registry.js';
+import { detectConceptualGaps } from './concept-gap-adapter.js';
+let _gapIdCounter = 0;
+function nextGapId(detectorId) {
+    return `gap-${detectorId}-${++_gapIdCounter}`;
+}
+/**
+ * Reset the gap ID counter (for test isolation).
+ */
+export function resetGapIds() {
+    _gapIdCounter = 0;
+}
+/**
+ * Detect gaps in a single TS file: patterns that exist in the code
+ * but are NOT covered by existing KERN templates.
+ */
+export function detectGaps(sourceFile, filePath, existingCoverage) {
+    const fullText = sourceFile.getFullText();
+    const imports = sourceFile.getImportDeclarations();
+    const gaps = [];
+    // Collect existing template match ranges so we skip already-covered code
+    const coveredRanges = new Set();
+    if (existingCoverage) {
+        for (const tm of existingCoverage.templateMatches) {
+            for (let l = tm.startLine; l <= tm.endLine; l++) {
+                coveredRanges.add(`${l}`);
+            }
+        }
+    }
+    // Find which detectors are relevant for this file's imports
+    const relevantDetectors = new Set();
+    for (const imp of imports) {
+        const importPath = imp.getModuleSpecifierValue();
+        for (const det of getDetectorsForImport(importPath)) {
+            relevantDetectors.add(det);
+        }
+    }
+    // Run each relevant detector (import-matched)
+    for (const detector of relevantDetectors) {
+        const detections = detector.detect(sourceFile, fullText);
+        for (const detection of detections) {
+            // Skip if any line in this range is already covered by existing templates
+            let isCovered = false;
+            for (let l = detection.startLine; l <= detection.endLine; l++) {
+                if (coveredRanges.has(`${l}`)) {
+                    isCovered = true;
+                    break;
+                }
+            }
+            if (isCovered)
+                continue;
+            gaps.push({
+                id: nextGapId(detector.id),
+                detectorId: detector.id,
+                libraryName: detector.libraryName,
+                patternKind: detector.patternKind,
+                anchorImport: detection.anchorImport,
+                startLine: detection.startLine,
+                endLine: detection.endLine,
+                snippet: detection.snippet,
+                extractedParams: detection.extractedParams,
+                confidencePct: detection.confidencePct,
+                filePath,
+            });
+        }
+    }
+    // Run universal detectors (import-agnostic structural patterns)
+    for (const detector of getUniversalDetectors()) {
+        if (relevantDetectors.has(detector))
+            continue; // already ran
+        const detections = detector.detect(sourceFile, fullText);
+        for (const detection of detections) {
+            let isCovered = false;
+            for (let l = detection.startLine; l <= detection.endLine; l++) {
+                if (coveredRanges.has(`${l}`)) {
+                    isCovered = true;
+                    break;
+                }
+            }
+            if (isCovered)
+                continue;
+            gaps.push({
+                id: nextGapId(detector.id),
+                detectorId: detector.id,
+                libraryName: detector.libraryName,
+                patternKind: detector.patternKind,
+                anchorImport: detection.anchorImport,
+                startLine: detection.startLine,
+                endLine: detection.endLine,
+                snippet: detection.snippet,
+                extractedParams: detection.extractedParams,
+                confidencePct: detection.confidencePct,
+                filePath,
+            });
+        }
+    }
+    // Run concept-based detection (universal structural gaps)
+    const conceptGaps = detectConceptualGaps(sourceFile, filePath);
+    return [...gaps, ...conceptGaps];
+}
+/**
+ * Detect gaps across multiple files.
+ */
+export function detectGapsInFiles(filePaths, project) {
+    const tsProject = project || new Project({ skipAddingFilesFromTsConfig: true });
+    const allGaps = [];
+    for (const filePath of filePaths) {
+        try {
+            const sourceFile = tsProject.addSourceFileAtPath(filePath);
+            // Get existing coverage from review
+            let coverage;
+            try {
+                coverage = reviewFile(filePath);
+            }
+            catch { // file may not exist
+            }
+            const gaps = detectGaps(sourceFile, filePath, coverage);
+            allGaps.push(...gaps);
+        }
+        catch { // file may not exist
+        }
+    }
+    return allGaps;
+}
+/**
+ * Detect gaps from a source string (useful for testing).
+ */
+export function detectGapsFromSource(source, filePath = 'input.ts', project) {
+    const tsProject = project || new Project({ skipAddingFilesFromTsConfig: true });
+    const sourceFile = tsProject.createSourceFile(filePath, source, { overwrite: true });
+    return detectGaps(sourceFile, filePath);
+}
+//# sourceMappingURL=gap-detector.js.map

package/dist/gap-detector.js.map

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

package/dist/golden-test-runner.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Golden Test Runner — AST-based comparison of codegen output vs expected output.
+ *
+ * Whitespace-insensitive: normalizes both sides before comparing.
+ * Used by validation pipeline and `kern evolve test` command.
+ */
+export interface GoldenTestResult {
+    keyword: string;
+    pass: boolean;
+    error?: string;
+    actual?: string;
+    expected?: string;
+}
+/**
+ * Compare two code strings with whitespace normalization.
+ * Returns true if they're structurally equivalent.
+ */
+export declare function compareGoldenOutput(actual: string, expected: string): boolean;
+/**
+ * Run golden tests for all evolved nodes in .kern/evolved/.
+ * Each node must have template.kern + expected-output.ts.
+ */
+export declare function runGoldenTests(baseDir?: string): GoldenTestResult[];
+/**
+ * Format golden test results for terminal display.
+ */
+export declare function formatGoldenTestResults(results: GoldenTestResult[]): string;

package/dist/golden-test-runner.js

@@ -0,0 +1,120 @@
+/**
+ * Golden Test Runner — AST-based comparison of codegen output vs expected output.
+ *
+ * Whitespace-insensitive: normalizes both sides before comparing.
+ * Used by validation pipeline and `kern evolve test` command.
+ */
+import { existsSync, readFileSync } from 'fs';
+import { resolve, join } from 'path';
+import { parse } from '@kernlang/core';
+import { loadSandboxedGenerator } from './sandboxed-generator.js';
+import { registerParserHints, unregisterParserHints } from '@kernlang/core';
+/**
+ * Compare two code strings with whitespace normalization.
+ * Returns true if they're structurally equivalent.
+ */
+export function compareGoldenOutput(actual, expected) {
+    return normalize(actual) === normalize(expected);
+}
+/**
+ * Normalize code for comparison:
+ * - Trim each line
+ * - Remove empty lines
+ * - Collapse multiple spaces
+ * - Normalize line endings
+ */
+function normalize(code) {
+    return code
+        .split('\n')
+        .map(l => l.trim().replace(/\s+/g, ' '))
+        .filter(l => l.length > 0)
+        .join('\n')
+        .trim();
+}
+/**
+ * Run golden tests for all evolved nodes in .kern/evolved/.
+ * Each node must have template.kern + expected-output.ts.
+ */
+export function runGoldenTests(baseDir = process.cwd()) {
+    const evolvedDir = resolve(baseDir, '.kern', 'evolved');
+    const manifestPath = join(evolvedDir, 'manifest.json');
+    if (!existsSync(manifestPath))
+        return [];
+    let manifest;
+    try {
+        manifest = JSON.parse(readFileSync(manifestPath, 'utf-8'));
+    }
+    catch {
+        return [{ keyword: '*', pass: false, error: 'Failed to parse manifest.json' }];
+    }
+    const results = [];
+    for (const [keyword, entry] of Object.entries(manifest.nodes)) {
+        const nodeDir = join(evolvedDir, keyword);
+        const templatePath = join(nodeDir, 'template.kern');
+        const expectedPath = join(nodeDir, 'expected-output.ts');
+        const codegenPath = join(nodeDir, 'codegen.js');
+        // Check required files exist
+        if (!existsSync(templatePath)) {
+            results.push({ keyword, pass: false, error: 'Missing template.kern' });
+            continue;
+        }
+        if (!existsSync(expectedPath)) {
+            results.push({ keyword, pass: false, error: 'Missing expected-output.ts' });
+            continue;
+        }
+        if (!existsSync(codegenPath)) {
+            results.push({ keyword, pass: false, error: 'Missing codegen.js' });
+            continue;
+        }
+        // Register parser hints temporarily
+        if (entry.parserHints) {
+            registerParserHints(keyword, entry.parserHints);
+        }
+        try {
+            const kernSource = readFileSync(templatePath, 'utf-8');
+            const expectedOutput = readFileSync(expectedPath, 'utf-8');
+            const generator = loadSandboxedGenerator(codegenPath);
+            const ast = parse(kernSource);
+            const actual = generator(ast).join('\n');
+            const pass = compareGoldenOutput(actual, expectedOutput);
+            results.push({
+                keyword,
+                pass,
+                ...(pass ? {} : { actual, expected: expectedOutput }),
+            });
+        }
+        catch (err) {
+            results.push({ keyword, pass: false, error: err.message });
+        }
+        finally {
+            if (entry.parserHints) {
+                unregisterParserHints(keyword);
+            }
+        }
+    }
+    return results;
+}
+/**
+ * Format golden test results for terminal display.
+ */
+export function formatGoldenTestResults(results) {
+    if (results.length === 0)
+        return '  No evolved nodes to test.';
+    const lines = [];
+    let passed = 0;
+    let failed = 0;
+    for (const r of results) {
+        if (r.pass) {
+            lines.push(`  \u2713 ${r.keyword}`);
+            passed++;
+        }
+        else {
+            lines.push(`  \u2717 ${r.keyword}: ${r.error || 'Golden diff mismatch'}`);
+            failed++;
+        }
+    }
+    lines.push('');
+    lines.push(`  ${passed} passed, ${failed} failed, ${results.length} total`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=golden-test-runner.js.map

package/dist/golden-test-runner.js.map

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

package/dist/graduation.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Graduation — writes approved node proposals to .kern/evolved/.
+ *
+ * Compiles the codegen TypeScript source to JS, writes all files,
+ * updates the manifest, and makes the node available at next compile.
+ */
+import type { EvolveNodeProposal, EvolvedNodeDefinition } from './evolved-types.js';
+/**
+ * Graduate an approved proposal: write all files to .kern/evolved/<keyword>/.
+ */
+export declare function graduateNode(proposal: EvolveNodeProposal, compiledJs: string, graduatedBy?: string, baseDir?: string): {
+    success: boolean;
+    error?: string;
+    path?: string;
+};
+/**
+ * Compile codegen TypeScript source to JavaScript for the sandbox.
+ * Strips types, imports, and converts to CommonJS.
+ */
+export declare function compileCodegenToJS(tsSource: string): string;
+/**
+ * Promote a graduated evolved node → core.
+ *
+ * Reads the node from .kern/evolved/<keyword>/, returns all the data
+ * needed to add it to the core package. Does NOT write to core files
+ * (that's the CLI's job — it knows the file paths).
+ */
+export declare function promoteNode(keyword: string, baseDir?: string): {
+    success: boolean;
+    error?: string;
+    codegenTs?: string;
+    goldenKern?: string;
+    goldenOutput?: string;
+    definition?: EvolvedNodeDefinition;
+};
+export declare function removeFromManifest(evolvedDir: string, keyword: string): boolean;

package/dist/graduation.js

@@ -0,0 +1,175 @@
+/**
+ * Graduation — writes approved node proposals to .kern/evolved/.
+ *
+ * Compiles the codegen TypeScript source to JS, writes all files,
+ * updates the manifest, and makes the node available at next compile.
+ */
+import { mkdirSync, writeFileSync, readFileSync, existsSync } from 'fs';
+import { resolve, join } from 'path';
+import { createHash } from 'crypto';
+import { KERN_VERSION } from '@kernlang/core';
+/**
+ * Graduate an approved proposal: write all files to .kern/evolved/<keyword>/.
+ */
+export function graduateNode(proposal, compiledJs, graduatedBy = 'user', baseDir = process.cwd()) {
+    const evolvedDir = resolve(baseDir, '.kern', 'evolved');
+    const nodeDir = join(evolvedDir, proposal.keyword);
+    // Prevent overwriting existing graduated node
+    if (existsSync(nodeDir)) {
+        return { success: false, error: `Node '${proposal.keyword}' is already graduated. Rollback first.` };
+    }
+    try {
+        mkdirSync(nodeDir, { recursive: true });
+        // 1. Write codegen.js (pre-compiled)
+        writeFileSync(join(nodeDir, 'codegen.js'), compiledJs);
+        // 2. Write codegen.ts (source, for editing/review)
+        writeFileSync(join(nodeDir, 'codegen.ts'), proposal.codegenSource);
+        // 3. Write template.kern (golden input)
+        writeFileSync(join(nodeDir, 'template.kern'), proposal.kernExample);
+        // 4. Write expected-output.ts (golden output)
+        writeFileSync(join(nodeDir, 'expected-output.ts'), proposal.expectedOutput);
+        // 5. Write definition.json
+        const hash = 'sha256:' + createHash('sha256').update(compiledJs).digest('hex');
+        const definition = {
+            keyword: proposal.keyword,
+            displayName: proposal.displayName,
+            description: proposal.description,
+            props: proposal.props,
+            childTypes: proposal.childTypes,
+            parserHints: proposal.parserHints,
+            reason: proposal.reason,
+            hash,
+            graduatedBy,
+            graduatedAt: new Date().toISOString(),
+            evolveRunId: proposal.evolveRunId,
+            kernVersion: KERN_VERSION,
+        };
+        writeFileSync(join(nodeDir, 'definition.json'), JSON.stringify(definition, null, 2));
+        // 6. Write target overrides if any
+        if (proposal.targetOverrides) {
+            const targetsDir = join(nodeDir, 'targets');
+            mkdirSync(targetsDir, { recursive: true });
+            for (const [target, source] of Object.entries(proposal.targetOverrides)) {
+                writeFileSync(join(targetsDir, `${target}.js`), source);
+            }
+        }
+        // 7. Update manifest
+        updateManifest(evolvedDir, proposal.keyword, {
+            keyword: proposal.keyword,
+            displayName: proposal.displayName,
+            codegenTier: proposal.codegenTier,
+            childTypes: proposal.childTypes,
+            parserHints: proposal.parserHints,
+            hash,
+            graduatedBy,
+            graduatedAt: definition.graduatedAt,
+            evolveRunId: proposal.evolveRunId,
+            kernVersion: KERN_VERSION,
+        });
+        return { success: true, path: nodeDir };
+    }
+    catch (err) {
+        return { success: false, error: err.message };
+    }
+}
+/**
+ * Compile codegen TypeScript source to JavaScript for the sandbox.
+ * Strips types, imports, and converts to CommonJS.
+ */
+export function compileCodegenToJS(tsSource) {
+    let js = tsSource;
+    // Strip import statements
+    js = js.replace(/import\s+.*?from\s+['"].*?['"];?\n?/g, '');
+    js = js.replace(/import\s+type\s+.*?from\s+['"].*?['"];?\n?/g, '');
+    // Convert export default function → module.exports = function
+    js = js.replace(/^export\s+default\s+function/m, 'module.exports = function');
+    js = js.replace(/^export\s+function\s+(\w+)/m, 'module.exports = function $1');
+    // If no module.exports yet, wrap
+    if (!js.includes('module.exports')) {
+        // Try to find a standalone function declaration
+        const fnMatch = js.match(/^function\s{1,20}\w+/m);
+        if (fnMatch) {
+            js = js.replace(/^(function\s{1,20}\w+)/m, 'module.exports = $1');
+        }
+    }
+    // Strip TypeScript type annotations from function signatures and variable declarations.
+    // Only match annotations that follow an identifier or closing paren — not inside strings.
+    // Pattern: (identifier|))\s*:\s*Type → strip the `: Type` part
+    js = js.replace(/(\w|\))\s*:\s*IRNode\b/g, '$1');
+    js = js.replace(/(\w|\))\s*:\s*string\[\]/g, '$1');
+    js = js.replace(/(\w|\))\s*:\s*string\b/g, '$1');
+    js = js.replace(/(\w|\))\s*:\s*number\b/g, '$1');
+    js = js.replace(/(\w|\))\s*:\s*boolean\b/g, '$1');
+    js = js.replace(/(\w|\))\s*:\s*void\b/g, '$1');
+    js = js.replace(/(\w|\))\s*:\s*any\b/g, '$1');
+    js = js.replace(/(\w|\))\s*:\s*CodegenHelpers\b/g, '$1');
+    js = js.replace(/(\w|\))\s*:\s*Record<[^>]+>/g, '$1');
+    js = js.replace(/<[A-Z]\w+(?:,\s?[A-Z]\w+){0,10}>/g, '');
+    js = js.replace(/\bas\s{1,20}\w+/g, '');
+    return js;
+}
+// ── Manifest management ──────────────────────────────────────────────────
+function readManifest(evolvedDir) {
+    const manifestPath = join(evolvedDir, 'manifest.json');
+    if (!existsSync(manifestPath)) {
+        return { version: 1, nodes: {} };
+    }
+    try {
+        return JSON.parse(readFileSync(manifestPath, 'utf-8'));
+    }
+    catch {
+        return { version: 1, nodes: {} };
+    }
+}
+function writeManifest(evolvedDir, manifest) {
+    mkdirSync(evolvedDir, { recursive: true });
+    writeFileSync(join(evolvedDir, 'manifest.json'), JSON.stringify(manifest, null, 2));
+}
+function updateManifest(evolvedDir, keyword, entry) {
+    const manifest = readManifest(evolvedDir);
+    manifest.nodes[keyword] = entry;
+    writeManifest(evolvedDir, manifest);
+}
+/**
+ * Promote a graduated evolved node → core.
+ *
+ * Reads the node from .kern/evolved/<keyword>/, returns all the data
+ * needed to add it to the core package. Does NOT write to core files
+ * (that's the CLI's job — it knows the file paths).
+ */
+export function promoteNode(keyword, baseDir = process.cwd()) {
+    const evolvedDir = resolve(baseDir, '.kern', 'evolved');
+    const nodeDir = join(evolvedDir, keyword);
+    if (!existsSync(nodeDir)) {
+        return { success: false, error: `Node '${keyword}' is not graduated` };
+    }
+    const codegenTsPath = join(nodeDir, 'codegen.ts');
+    const templateKernPath = join(nodeDir, 'template.kern');
+    const expectedOutputPath = join(nodeDir, 'expected-output.ts');
+    const defPath = join(nodeDir, 'definition.json');
+    if (!existsSync(codegenTsPath)) {
+        return { success: false, error: `Missing codegen.ts for '${keyword}'` };
+    }
+    if (!existsSync(defPath)) {
+        return { success: false, error: `Missing definition.json for '${keyword}'` };
+    }
+    try {
+        const codegenTs = readFileSync(codegenTsPath, 'utf-8');
+        const goldenKern = existsSync(templateKernPath) ? readFileSync(templateKernPath, 'utf-8') : undefined;
+        const goldenOutput = existsSync(expectedOutputPath) ? readFileSync(expectedOutputPath, 'utf-8') : undefined;
+        const definition = JSON.parse(readFileSync(defPath, 'utf-8'));
+        return { success: true, codegenTs, goldenKern, goldenOutput, definition };
+    }
+    catch (err) {
+        return { success: false, error: err.message };
+    }
+}
+export function removeFromManifest(evolvedDir, keyword) {
+    const manifest = readManifest(evolvedDir);
+    if (!manifest.nodes[keyword])
+        return false;
+    delete manifest.nodes[keyword];
+    writeManifest(evolvedDir, manifest);
+    return true;
+}
+//# sourceMappingURL=graduation.js.map