@kernlang/evolve 3.0.0

package/dist/detectors/vue-composables.js.map

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

package/dist/evolve-dedup.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Evolve Dedup — structural similarity checking for node proposals.
+ *
+ * Prevents duplicates by checking keyword similarity and prop-schema overlap
+ * against existing core and evolved node types.
+ */
+import type { EvolveNodeProposal } from './evolved-types.js';
+/**
+ * Check if a proposal is a duplicate of an existing node.
+ * Returns true if the proposal is NOT a duplicate (passes the check).
+ */
+export declare function checkDedup(proposal: EvolveNodeProposal, existingKeywords: string[]): boolean;

package/dist/evolve-dedup.js

@@ -0,0 +1,50 @@
+/**
+ * Evolve Dedup — structural similarity checking for node proposals.
+ *
+ * Prevents duplicates by checking keyword similarity and prop-schema overlap
+ * against existing core and evolved node types.
+ */
+/**
+ * Check if a proposal is a duplicate of an existing node.
+ * Returns true if the proposal is NOT a duplicate (passes the check).
+ */
+export function checkDedup(proposal, existingKeywords) {
+    // Exact keyword match
+    if (existingKeywords.includes(proposal.keyword))
+        return false;
+    // Similarity check — keywords that are too close
+    for (const existing of existingKeywords) {
+        const sim = keywordSimilarity(proposal.keyword, existing);
+        if (sim > 0.85)
+            return false;
+    }
+    return true;
+}
+/**
+ * Normalized Levenshtein similarity between two keywords.
+ * Returns 0-1 where 1 = identical.
+ */
+function keywordSimilarity(a, b) {
+    const distance = levenshtein(a, b);
+    const maxLen = Math.max(a.length, b.length);
+    if (maxLen === 0)
+        return 1;
+    return 1 - distance / maxLen;
+}
+function levenshtein(a, b) {
+    const m = a.length;
+    const n = b.length;
+    const dp = Array.from({ length: m + 1 }, () => Array(n + 1).fill(0));
+    for (let i = 0; i <= m; i++)
+        dp[i][0] = i;
+    for (let j = 0; j <= n; j++)
+        dp[0][j] = j;
+    for (let i = 1; i <= m; i++) {
+        for (let j = 1; j <= n; j++) {
+            const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+            dp[i][j] = Math.min(dp[i - 1][j] + 1, dp[i][j - 1] + 1, dp[i - 1][j - 1] + cost);
+        }
+    }
+    return dp[m][n];
+}
+//# sourceMappingURL=evolve-dedup.js.map

package/dist/evolve-dedup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evolve-dedup.js","sourceRoot":"","sources":["../src/evolve-dedup.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;GAGG;AACH,MAAM,UAAU,UAAU,CACxB,QAA4B,EAC5B,gBAA0B;IAE1B,sBAAsB;IACtB,IAAI,gBAAgB,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IAE9D,iDAAiD;IACjD,KAAK,MAAM,QAAQ,IAAI,gBAAgB,EAAE,CAAC;QACxC,MAAM,GAAG,GAAG,iBAAiB,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAC1D,IAAI,GAAG,GAAG,IAAI;YAAE,OAAO,KAAK,CAAC;IAC/B,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,SAAS,iBAAiB,CAAC,CAAS,EAAE,CAAS;IAC7C,MAAM,QAAQ,GAAG,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACnC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;IAC5C,IAAI,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAC3B,OAAO,CAAC,GAAG,QAAQ,GAAG,MAAM,CAAC;AAC/B,CAAC;AAED,SAAS,WAAW,CAAC,CAAS,EAAE,CAAS;IACvC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC;IACnB,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC;IACnB,MAAM,EAAE,GAAe,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAEjF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE;QAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAC1C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE;QAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAE1C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3C,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CACjB,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAChB,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,EAChB,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CACxB,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}

package/dist/evolve-rollback.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Evolve Rollback — remove or restore graduated nodes.
+ *
+ * Moves to .trash/ for recovery instead of deleting permanently.
+ */
+export interface RollbackResult {
+    success: boolean;
+    error?: string;
+    usageFiles?: string[];
+}
+/**
+ * Check if a keyword is used in any .kern files under the project.
+ */
+export declare function findUsages(keyword: string, baseDir?: string): string[];
+/**
+ * Rollback a graduated node. Moves to .trash/ (recoverable).
+ *
+ * @param force — skip usage check
+ */
+export declare function rollbackNode(keyword: string, baseDir?: string, force?: boolean): RollbackResult;
+export interface PruneResult {
+    keyword: string;
+    daysUnused: number;
+    pruned: boolean;
+    error?: string;
+}
+/**
+ * Prune evolved nodes that haven't been used in any .kern files
+ * and are older than the given threshold (default: 90 days).
+ *
+ * @param dryRun — if true, just report what would be pruned
+ */
+export declare function pruneNodes(baseDir?: string, thresholdDays?: number, dryRun?: boolean): PruneResult[];
+export interface CollisionInfo {
+    keyword: string;
+    displayName: string;
+    graduatedAt: string;
+}
+/**
+ * Detect keyword collisions between evolved nodes and core NODE_TYPES.
+ * Called when KERN is upgraded and new core types may have been added.
+ */
+export declare function detectCollisions(coreTypes: readonly string[], baseDir?: string): CollisionInfo[];
+/**
+ * Rename an evolved node's keyword.
+ * Updates the manifest, directory name, and definition.json.
+ */
+export declare function renameEvolvedNode(oldKeyword: string, newKeyword: string, baseDir?: string): {
+    success: boolean;
+    error?: string;
+};
+/**
+ * Restore a previously rolled-back node from .trash/.
+ */
+export declare function restoreNode(keyword: string, baseDir?: string): {
+    success: boolean;
+    error?: string;
+};

package/dist/evolve-rollback.js

@@ -0,0 +1,242 @@
+/**
+ * Evolve Rollback — remove or restore graduated nodes.
+ *
+ * Moves to .trash/ for recovery instead of deleting permanently.
+ */
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync, renameSync, rmSync } from 'fs';
+import { resolve, join } from 'path';
+import { removeFromManifest } from './graduation.js';
+/**
+ * Check if a keyword is used in any .kern files under the project.
+ */
+export function findUsages(keyword, baseDir = process.cwd()) {
+    const usages = [];
+    function walk(dir) {
+        try {
+            for (const entry of readdirSync(dir, { withFileTypes: true })) {
+                if (entry.name.startsWith('.') || entry.name === 'node_modules' || entry.name === 'dist')
+                    continue;
+                const full = join(dir, entry.name);
+                if (entry.isDirectory()) {
+                    walk(full);
+                }
+                else if (entry.name.endsWith('.kern')) {
+                    try {
+                        const content = readFileSync(full, 'utf-8');
+                        // Check if any line starts with this keyword (at any indent level)
+                        const escaped = keyword.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+                        const re = new RegExp(`^\\s*${escaped}\\b`, 'm');
+                        if (re.test(content)) {
+                            usages.push(full);
+                        }
+                    }
+                    catch { // file may not exist
+                    }
+                }
+            }
+        }
+        catch { // file may not exist
+        }
+    }
+    walk(baseDir);
+    return usages;
+}
+/**
+ * Rollback a graduated node. Moves to .trash/ (recoverable).
+ *
+ * @param force — skip usage check
+ */
+export function rollbackNode(keyword, baseDir = process.cwd(), force = false) {
+    const evolvedDir = resolve(baseDir, '.kern', 'evolved');
+    const nodeDir = join(evolvedDir, keyword);
+    if (!existsSync(nodeDir)) {
+        return { success: false, error: `Node '${keyword}' is not graduated` };
+    }
+    // Check usage unless forced
+    if (!force) {
+        const usages = findUsages(keyword, baseDir);
+        if (usages.length > 0) {
+            return {
+                success: false,
+                error: `Node '${keyword}' is used in ${usages.length} file(s). Use --force to rollback anyway.`,
+                usageFiles: usages,
+            };
+        }
+    }
+    try {
+        // Move to .trash/
+        const trashDir = join(evolvedDir, '.trash');
+        mkdirSync(trashDir, { recursive: true });
+        const trashDest = join(trashDir, keyword);
+        // Remove previous trash if exists
+        if (existsSync(trashDest)) {
+            rmSync(trashDest, { recursive: true });
+        }
+        renameSync(nodeDir, trashDest);
+        // Update manifest
+        removeFromManifest(evolvedDir, keyword);
+        return { success: true };
+    }
+    catch (err) {
+        return { success: false, error: err.message };
+    }
+}
+/**
+ * Prune evolved nodes that haven't been used in any .kern files
+ * and are older than the given threshold (default: 90 days).
+ *
+ * @param dryRun — if true, just report what would be pruned
+ */
+export function pruneNodes(baseDir = process.cwd(), thresholdDays = 90, dryRun = false) {
+    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 [];
+    }
+    const now = Date.now();
+    const thresholdMs = thresholdDays * 24 * 60 * 60 * 1000;
+    const results = [];
+    for (const [keyword, entry] of Object.entries(manifest.nodes)) {
+        const graduatedAt = new Date(entry.graduatedAt).getTime();
+        const ageMs = now - graduatedAt;
+        const daysOld = Math.floor(ageMs / (24 * 60 * 60 * 1000));
+        if (ageMs < thresholdMs)
+            continue; // Too young to prune
+        // Check if used anywhere
+        const usages = findUsages(keyword, baseDir);
+        if (usages.length > 0)
+            continue; // Still in use
+        if (dryRun) {
+            results.push({ keyword, daysUnused: daysOld, pruned: false });
+        }
+        else {
+            const rollResult = rollbackNode(keyword, baseDir, true);
+            results.push({
+                keyword,
+                daysUnused: daysOld,
+                pruned: rollResult.success,
+                error: rollResult.error,
+            });
+        }
+    }
+    return results;
+}
+/**
+ * Detect keyword collisions between evolved nodes and core NODE_TYPES.
+ * Called when KERN is upgraded and new core types may have been added.
+ */
+export function detectCollisions(coreTypes, 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 [];
+    }
+    const collisions = [];
+    const coreSet = new Set(coreTypes);
+    for (const [keyword, entry] of Object.entries(manifest.nodes)) {
+        if (coreSet.has(keyword)) {
+            collisions.push({
+                keyword,
+                displayName: entry.displayName,
+                graduatedAt: entry.graduatedAt,
+            });
+        }
+    }
+    return collisions;
+}
+/**
+ * Rename an evolved node's keyword.
+ * Updates the manifest, directory name, and definition.json.
+ */
+export function renameEvolvedNode(oldKeyword, newKeyword, baseDir = process.cwd()) {
+    const evolvedDir = resolve(baseDir, '.kern', 'evolved');
+    const oldDir = join(evolvedDir, oldKeyword);
+    const newDir = join(evolvedDir, newKeyword);
+    if (!existsSync(oldDir)) {
+        return { success: false, error: `Node '${oldKeyword}' not found` };
+    }
+    if (existsSync(newDir)) {
+        return { success: false, error: `Node '${newKeyword}' already exists` };
+    }
+    try {
+        // Rename directory
+        renameSync(oldDir, newDir);
+        // Update definition.json
+        const defPath = join(newDir, 'definition.json');
+        if (existsSync(defPath)) {
+            const def = JSON.parse(readFileSync(defPath, 'utf-8'));
+            def.keyword = newKeyword;
+            writeFileSync(defPath, JSON.stringify(def, null, 2));
+        }
+        // Update manifest
+        const manifestPath = join(evolvedDir, 'manifest.json');
+        if (existsSync(manifestPath)) {
+            const manifest = JSON.parse(readFileSync(manifestPath, 'utf-8'));
+            if (manifest.nodes[oldKeyword]) {
+                manifest.nodes[newKeyword] = { ...manifest.nodes[oldKeyword], keyword: newKeyword };
+                delete manifest.nodes[oldKeyword];
+                writeFileSync(manifestPath, JSON.stringify(manifest, null, 2));
+            }
+        }
+        return { success: true };
+    }
+    catch (err) {
+        return { success: false, error: err.message };
+    }
+}
+/**
+ * Restore a previously rolled-back node from .trash/.
+ */
+export function restoreNode(keyword, baseDir = process.cwd()) {
+    const evolvedDir = resolve(baseDir, '.kern', 'evolved');
+    const trashDir = join(evolvedDir, '.trash', keyword);
+    const nodeDir = join(evolvedDir, keyword);
+    if (!existsSync(trashDir)) {
+        return { success: false, error: `No trashed node '${keyword}' found` };
+    }
+    if (existsSync(nodeDir)) {
+        return { success: false, error: `Node '${keyword}' already exists. Rollback it first.` };
+    }
+    try {
+        renameSync(trashDir, nodeDir);
+        // Re-add to manifest from definition.json
+        const defPath = join(nodeDir, 'definition.json');
+        if (existsSync(defPath)) {
+            const def = JSON.parse(readFileSync(defPath, 'utf-8'));
+            const manifestPath = join(evolvedDir, 'manifest.json');
+            const manifest = existsSync(manifestPath)
+                ? JSON.parse(readFileSync(manifestPath, 'utf-8'))
+                : { version: 1, nodes: {} };
+            manifest.nodes[keyword] = {
+                keyword: def.keyword,
+                displayName: def.displayName,
+                codegenTier: 1,
+                childTypes: def.childTypes || [],
+                parserHints: def.parserHints,
+                hash: def.hash,
+                graduatedBy: def.graduatedBy,
+                graduatedAt: def.graduatedAt,
+                evolveRunId: def.evolveRunId,
+                kernVersion: def.kernVersion,
+            };
+            writeFileSync(manifestPath, JSON.stringify(manifest, null, 2));
+        }
+        return { success: true };
+    }
+    catch (err) {
+        return { success: false, error: err.message };
+    }
+}
+//# sourceMappingURL=evolve-rollback.js.map

package/dist/evolve-rollback.js.map

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

package/dist/evolve-runner.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Evolve Runner — orchestrator for the full evolve pipeline.
+ *
+ * Pipeline: scan → gap-detect → analyze → propose → validate → stage
+ */
+import type { EvolveConfig, EvolveResult, QualityThresholds } from './types.js';
+export interface EvolveOptions {
+    recursive?: boolean;
+    preview?: boolean;
+    thresholds?: Partial<QualityThresholds>;
+    tsconfigPath?: string;
+    config?: Partial<EvolveConfig>;
+    enableNodeProposals?: boolean;
+}
+/**
+ * Run the full evolve pipeline on a directory or file.
+ */
+export declare function evolve(inputPath: string, options?: EvolveOptions): EvolveResult;
+/**
+ * Run evolve on a source string (useful for testing and single-file analysis).
+ */
+export declare function evolveSource(source: string, filePath?: string, options?: EvolveOptions): EvolveResult;

package/dist/evolve-runner.js

@@ -0,0 +1,183 @@
+/**
+ * Evolve Runner — orchestrator for the full evolve pipeline.
+ *
+ * Pipeline: scan → gap-detect → analyze → propose → validate → stage
+ */
+import { readdirSync, statSync, existsSync } from 'fs';
+import { resolve, join } from 'path';
+import { Project } from 'ts-morph';
+import { detectGaps } from './gap-detector.js';
+import { analyzePatterns, analyzeStructuralPatterns } from './pattern-analyzer.js';
+import { proposeTemplates } from './template-proposer.js';
+import { validateProposal } from './template-validator.js';
+import { stageProposal, stageNodeProposal } from './staging.js';
+import { DEFAULT_THRESHOLDS } from './quality-scorer.js';
+import { scoreExpressibility, isNodeCandidate } from './expressibility-scorer.js';
+import { proposeNodes } from './node-proposer.js';
+import { governanceGate } from './node-governance.js';
+import { validateNodeProposal } from './node-validator.js';
+/**
+ * Run the full evolve pipeline on a directory or file.
+ */
+export function evolve(inputPath, options = {}) {
+    const resolvedPath = resolve(inputPath);
+    const thresholds = {
+        ...DEFAULT_THRESHOLDS,
+        ...options.thresholds,
+    };
+    // Collect TS files
+    const filePaths = collectTsFiles(resolvedPath, options.recursive ?? false);
+    if (filePaths.length === 0) {
+        return { gaps: [], analyzed: [], proposals: [], validated: [], staged: [] };
+    }
+    // Create a ts-morph project for analysis
+    const project = new Project({
+        skipAddingFilesFromTsConfig: true,
+        tsConfigFilePath: options.tsconfigPath,
+    });
+    // Phase 1: Detect gaps across all files
+    const allGaps = [];
+    for (const filePath of filePaths) {
+        try {
+            const sourceFile = project.addSourceFileAtPath(filePath);
+            const gaps = detectGaps(sourceFile, filePath);
+            allGaps.push(...gaps);
+        }
+        catch { // file may not exist
+        }
+    }
+    // Phase 2: Analyze and group patterns (v2 template path)
+    const analyzed = analyzePatterns(allGaps, thresholds);
+    // Phase 3: Propose templates
+    const proposals = proposeTemplates(analyzed);
+    // Phase 4: Validate proposals
+    const validated = proposals.map(proposal => ({
+        proposal,
+        validation: validateProposal(proposal, options.tsconfigPath),
+    }));
+    // Phase 5: Stage validated proposals (unless preview mode)
+    const staged = options.preview
+        ? []
+        : validated
+            .filter(v => v.validation.parseOk && v.validation.registerOk && v.validation.expansionOk)
+            .map(v => stageProposal(v.proposal, v.validation, options.config));
+    // ── v3 branch: Node proposals from structural gaps ──
+    let nodeProposals;
+    let nodeValidated;
+    let stagedNodes;
+    if (options.enableNodeProposals) {
+        // Phase 2.5: Analyze structural gaps separately
+        const structuralAnalyzed = analyzeStructuralPatterns(allGaps, thresholds);
+        // Phase 2.6: Score expressibility for structural gaps
+        const expressScores = new Map();
+        for (const pattern of structuralAnalyzed) {
+            const snippets = allGaps
+                .filter(g => pattern.gapIds.includes(g.id))
+                .map(g => g.snippet);
+            const score = scoreExpressibility(allGaps.filter(g => pattern.gapIds.includes(g.id)), snippets);
+            expressScores.set(pattern.structuralHash, score);
+        }
+        // Phase 2.7: Propose nodes for high-expressibility patterns
+        const candidatePatterns = structuralAnalyzed.filter(p => {
+            const score = expressScores.get(p.structuralHash);
+            return score && isNodeCandidate(score);
+        });
+        nodeProposals = proposeNodes(candidatePatterns, expressScores);
+        // Phase 2.8: Governance gate filter
+        const governed = nodeProposals.filter(np => governanceGate(np).pass);
+        // Phase 2.9: Validate governed proposals
+        nodeValidated = governed.map(np => ({
+            proposal: np,
+            validation: validateNodeProposal(np),
+        }));
+        // Phase 2.10: Stage validated node proposals
+        stagedNodes = options.preview
+            ? []
+            : nodeValidated
+                .filter(v => v.validation.parseOk && v.validation.codegenOk)
+                .map(v => stageNodeProposal(v.proposal, v.validation, options.config));
+    }
+    return {
+        gaps: allGaps,
+        analyzed,
+        proposals,
+        validated,
+        staged,
+        conceptSummary: buildConceptSummary(allGaps),
+        nodeProposals,
+        nodeValidated,
+        stagedNodes,
+    };
+}
+/**
+ * Run evolve on a source string (useful for testing and single-file analysis).
+ */
+export function evolveSource(source, filePath = 'input.ts', options = {}) {
+    const thresholds = {
+        ...DEFAULT_THRESHOLDS,
+        ...options.thresholds,
+    };
+    const project = new Project({ skipAddingFilesFromTsConfig: true });
+    const sourceFile = project.createSourceFile(filePath, source, { overwrite: true });
+    // Phase 1
+    const gaps = detectGaps(sourceFile, filePath);
+    // Phase 2
+    const analyzed = analyzePatterns(gaps, thresholds);
+    // Phase 3
+    const proposals = proposeTemplates(analyzed);
+    // Phase 4
+    const validated = proposals.map(proposal => ({
+        proposal,
+        validation: validateProposal(proposal, options.tsconfigPath),
+    }));
+    // Phase 5 (skip staging for source mode)
+    return {
+        gaps,
+        analyzed,
+        proposals,
+        validated,
+        staged: [],
+        conceptSummary: buildConceptSummary(gaps),
+    };
+}
+function buildConceptSummary(gaps) {
+    const conceptGaps = gaps.filter(g => g.libraryName === 'structural');
+    if (conceptGaps.length === 0)
+        return undefined;
+    const byRule = {};
+    for (const g of conceptGaps) {
+        const rule = g.detectorId.replace(/^concept-/, '');
+        byRule[rule] = (byRule[rule] || 0) + 1;
+    }
+    const parts = Object.entries(byRule).map(([rule, count]) => `${rule}: ${count}`);
+    const formatted = `Structural gaps: ${conceptGaps.length} (${parts.join(', ')})`;
+    return { total: conceptGaps.length, byRule, formatted };
+}
+function collectTsFiles(inputPath, recursive) {
+    if (!existsSync(inputPath))
+        return [];
+    const stat = statSync(inputPath);
+    if (stat.isFile()) {
+        if (inputPath.endsWith('.ts') || inputPath.endsWith('.tsx')) {
+            if (!inputPath.endsWith('.d.ts') && !inputPath.endsWith('.test.ts') && !inputPath.endsWith('.test.tsx')) {
+                return [inputPath];
+            }
+        }
+        return [];
+    }
+    if (!stat.isDirectory())
+        return [];
+    const files = [];
+    for (const entry of readdirSync(inputPath)) {
+        const full = join(inputPath, entry);
+        const s = statSync(full);
+        if (s.isDirectory() && recursive && !entry.startsWith('.') && entry !== 'node_modules' && entry !== 'dist') {
+            files.push(...collectTsFiles(full, true));
+        }
+        else if ((entry.endsWith('.ts') || entry.endsWith('.tsx')) && !entry.endsWith('.d.ts') && !entry.endsWith('.test.ts') && !entry.endsWith('.test.tsx')) {
+            files.push(full);
+        }
+    }
+    return files;
+}
+//# sourceMappingURL=evolve-runner.js.map

package/dist/evolve-runner.js.map

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

package/dist/evolve-validator-v4.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Evolve v4 Validation Pipeline — 9-step validation for node proposals.
+ *
+ * Steps: schema → keyword → parse → codegen compile → codegen run →
+ *        typescript check → golden diff → dedup → (LLM retry on failure)
+ */
+import type { EvolveNodeProposal, EvolveV4ValidationResult } from './evolved-types.js';
+/**
+ * Run the full 9-step validation pipeline on a node proposal.
+ */
+export declare function validateEvolveProposal(proposal: EvolveNodeProposal, existingKeywords?: string[]): EvolveV4ValidationResult;