progmune-runtime 2.1.6 → 3.2.1

package/dist/l3-cross-function.js

@@ -0,0 +1,280 @@
+"use strict";
+/**
+ * L3 Cross-Function Resource Lifecycle Analysis
+ *
+ * Same-file alloc/free pairing check.
+ * For each function that calls an allocator,
+ * verifies there exists a call-graph path to a function that calls
+ * the corresponding deallocator.
+ *
+ * Phase 1: Experimental — curl openssl.c + redis server.c
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.analyzeL3 = analyzeL3;
+exports.runL3Experiment = runL3Experiment;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const ALLOC_FREE_PAIRS = [
+    // OpenSSL
+    { type: "SSL_CTX", allocPattern: /\bSSL_CTX_new\b/, freePattern: /\bSSL_CTX_free\b/ },
+    { type: "SSL", allocPattern: /\bSSL_new\b/, freePattern: /\bSSL_free\b/ },
+    { type: "BIO", allocPattern: /\bBIO_new\b/, freePattern: /\bBIO_free\b/ },
+    { type: "EVP_PKEY", allocPattern: /\bEVP_PKEY_new\b/, freePattern: /\bEVP_PKEY_free\b/ },
+    // curl
+    { type: "curl_easy", allocPattern: /\bcurl_easy_init\b/, freePattern: /\bcurl_easy_cleanup\b/ },
+    { type: "curl_multi", allocPattern: /\bcurl_multi_init\b/, freePattern: /\bcurl_multi_cleanup\b/ },
+    { type: "curl_slist", allocPattern: /\bcurl_slist_append\b/, freePattern: /\bcurl_slist_free_all\b/ },
+    // nghttp2
+    { type: "nghttp2_session", allocPattern: /\bnghttp2_session_(new|server_new|client_new)\b/, freePattern: /\bnghttp2_session_del\b/ },
+    { type: "nghttp2_mem", allocPattern: /\bnghttp2_mem_(malloc|calloc|realloc)\b/, freePattern: /\bnghttp2_mem_free\b/ },
+    // libssh
+    { type: "ssh_session", allocPattern: /\bssh_(new|session_new)\b/, freePattern: /\bssh_free\b/ },
+    { type: "ssh_string", allocPattern: /\bssh_string_(new|from_char)\b/, freePattern: /\bssh_string_(free|burn)\b/ },
+    // redis
+    { type: "sds", allocPattern: /\bsds(new|newlen|empty|dup)\b/, freePattern: /\bsds(free|clear)\b/ },
+    { type: "zmalloc", allocPattern: /\bz(malloc|calloc|realloc|trymalloc)\b/, freePattern: /\bzfree\b/ },
+    // nginx
+    { type: "ngx_pool", allocPattern: /\bngx_(create_pool|palloc|pcalloc)\b/, freePattern: /\bngx_(destroy_pool|pfree)\b/ },
+    { type: "ngx_array", allocPattern: /\bngx_(array_create|array_push)\b/, freePattern: /\bngx_array_destroy\b/ },
+    // Apache
+    { type: "apr_pool", allocPattern: /\bapr_p(alloc|calloc|create)\b/, freePattern: /\bapr_p(free|ool_destroy|ool_clear)\b/ },
+    // Generic C
+    { type: "malloc", allocPattern: /\b(malloc|calloc|realloc)\b/, freePattern: /\bfree\b/ },
+];
+// ── Call Graph ──
+function buildCallGraph(funcs) {
+    const callers = new Map();
+    const callees = new Map();
+    const funcFiles = new Map();
+    for (const f of funcs) {
+        funcFiles.set(f.name, f.file);
+        if (!callees.has(f.name))
+            callees.set(f.name, []);
+        callees.get(f.name).push(...f.calls);
+        for (const c of f.calls) {
+            if (!callers.has(c))
+                callers.set(c, []);
+            callers.get(c).push(f.name);
+        }
+    }
+    return { callers, callees, funcFiles };
+}
+// ── Path Finding (BFS from alloc function to any free function) ──
+function canReach(start, targets, callees, maxDepth = 5) {
+    if (targets.includes(start))
+        return { reachable: true, path: [start] };
+    const visited = new Set();
+    const queue = [{ func: start, path: [start] }];
+    visited.add(start);
+    while (queue.length > 0) {
+        const { func, path: currentPath } = queue.shift();
+        if (currentPath.length > maxDepth)
+            continue;
+        const called = callees.get(func) || [];
+        for (const c of called) {
+            if (targets.includes(c)) {
+                return { reachable: true, path: [...currentPath, c] };
+            }
+            if (!visited.has(c)) {
+                visited.add(c);
+                queue.push({ func: c, path: [...currentPath, c] });
+            }
+        }
+    }
+    return { reachable: false, path: [] };
+}
+function analyzeL3(repo, sequences) {
+    const { callees, funcFiles } = buildCallGraph(sequences);
+    // Find alloc/free sites
+    const allocSites = [];
+    const freeSites = [];
+    for (const func of sequences) {
+        for (const call of func.calls) {
+            for (const pair of ALLOC_FREE_PAIRS) {
+                if (pair.allocPattern.test(call)) {
+                    allocSites.push({
+                        func: func.name,
+                        file: func.file,
+                        allocCall: call,
+                        allocType: pair.type,
+                    });
+                }
+                if (pair.freePattern.test(call)) {
+                    freeSites.push({
+                        func: func.name,
+                        file: func.file,
+                        freeCall: call,
+                        allocType: pair.type,
+                    });
+                }
+            }
+        }
+    }
+    // Group by file
+    const fileAllocs = new Map();
+    const fileFrees = new Map();
+    for (const a of allocSites) {
+        if (!fileAllocs.has(a.file))
+            fileAllocs.set(a.file, []);
+        fileAllocs.get(a.file).push(a);
+    }
+    for (const f of freeSites) {
+        if (!fileFrees.has(f.file))
+            fileFrees.set(f.file, []);
+        fileFrees.get(f.file).push(f);
+    }
+    // For each same-file alloc/free pair, check reachability
+    const violations = [];
+    let sameFilePairs = 0;
+    for (const [file, allocs] of fileAllocs) {
+        const frees = fileFrees.get(file) || [];
+        if (frees.length === 0)
+            continue;
+        for (const alloc of allocs) {
+            // Find matching free functions (same type)
+            const matchingFrees = frees.filter(f => f.allocType === alloc.allocType);
+            if (matchingFrees.length === 0)
+                continue;
+            sameFilePairs++;
+            const matchingFreeFuncs = matchingFrees.map(f => f.func);
+            const { reachable, path: foundPath } = canReach(alloc.func, matchingFreeFuncs, callees);
+            if (!reachable) {
+                violations.push({
+                    allocFunc: alloc.func,
+                    freeFunc: matchingFreeFuncs[0] || null,
+                    file,
+                    allocCall: alloc.allocCall,
+                    allocType: alloc.allocType,
+                    reason: foundPath.length > 0
+                        ? `path too deep (${foundPath.length} > 5)`
+                        : `no path from ${alloc.func} to any of [${matchingFreeFuncs.join(", ")}]`,
+                    reachableFrees: matchingFreeFuncs,
+                });
+            }
+        }
+    }
+    return {
+        repo,
+        totalFuncs: sequences.length,
+        allocSites: allocSites.length,
+        freeSites: freeSites.length,
+        sameFilePairs,
+        violations,
+    };
+}
+// ── CLI ──
+function runL3Experiment() {
+    const BENCH_DIR = path.resolve(__dirname, "..", "benchmarks");
+    // Try full IR first, fall back to sequence data
+    for (const repo of ["curl"]) {
+        const irFile = path.join(BENCH_DIR, repo, "ir.json");
+        const seqFile = path.join(BENCH_DIR, `${repo}-sequences.json`);
+        let seqs = [];
+        if (fs.existsSync(irFile)) {
+            const data = JSON.parse(fs.readFileSync(irFile, "utf-8"));
+            seqs = (data.functions || []).map((f) => ({
+                name: f.name || "",
+                file: f.file || "",
+                calls: f.calls || [],
+            }));
+            console.error(`Loaded ${seqs.length} functions from ir.json`);
+        }
+        else if (fs.existsSync(seqFile)) {
+            const data = JSON.parse(fs.readFileSync(seqFile, "utf-8"));
+            seqs = (data.sequences || data).map((s) => ({
+                name: s.function || "",
+                file: s.file || "",
+                calls: s.calls || [],
+            }));
+            console.error(`Loaded ${seqs.length} functions from sequences (no ir.json)`);
+        }
+        else {
+            console.log(`${repo}: no data`);
+            continue;
+        }
+        const result = analyzeL3(repo, seqs);
+        console.log(`\n═══ L3 Analysis: ${repo} (FULL IR) ═══`);
+        console.log(`  Functions: ${result.totalFuncs}`);
+        console.log(`  Alloc sites: ${result.allocSites}`);
+        console.log(`  Free sites: ${result.freeSites}`);
+        console.log(`  Same-file pairs: ${result.sameFilePairs}`);
+        console.log(`  Unreachable (violations): ${result.violations.length}`);
+        // Show top files with violations
+        const byFile = new Map();
+        for (const v of result.violations) {
+            if (!byFile.has(v.file))
+                byFile.set(v.file, []);
+            byFile.get(v.file).push(v);
+        }
+        const sortedFiles = [...byFile.entries()].sort((a, b) => b[1].length - a[1].length);
+        console.log(`\n  Top files with L3 violations:`);
+        for (const [file, viols] of sortedFiles.slice(0, 10)) {
+            console.log(`    ${file}: ${viols.length} violations`);
+            // Show most common alloc types
+            const types = new Map();
+            for (const v of viols) {
+                types.set(v.allocType, (types.get(v.allocType) || 0) + 1);
+            }
+            const topTypes = [...types.entries()].sort((a, b) => b[1] - a[1]).slice(0, 3);
+            console.log(`      types: ${topTypes.map(([t, c]) => `${t}(${c})`).join(", ")}`);
+        }
+        // Sample violations from top file
+        if (sortedFiles.length > 0) {
+            const [topFile, topViols] = sortedFiles[0];
+            console.log(`\n  Sample violations (${topFile}):`);
+            for (const v of topViols.slice(0, 5)) {
+                const isKnownFP = /return|caller|library/i.test(v.reason);
+                const verdict = isKnownFP ? "FP" : "?";
+                console.log(`    [${verdict}] ${v.allocFunc} → ${v.allocCall} (${v.allocType})`);
+                console.log(`           free: [${v.reachableFrees.slice(0, 3).join(", ")}] | ${v.reason}`);
+            }
+        }
+        // Summary: potential TPs vs known FPs
+        const potentialTPs = result.violations.filter(v => {
+            // Heuristic: functions that allocate and return (not library constructors)
+            return !/new$|init$|create$/.test(v.allocFunc) && v.reachableFrees.length <= 3;
+        });
+        console.log(`\n  Summary:`);
+        console.log(`    Total violations: ${result.violations.length}`);
+        console.log(`    Potential TPs (narrow free targets): ${potentialTPs.length}`);
+        console.log(`    FP rate estimate: ${result.violations.length > 0 ? ((1 - potentialTPs.length / result.violations.length) * 100).toFixed(0) : 0}%`);
+        console.log();
+    }
+}
+// Run if called directly
+if (require.main === module) {
+    runL3Experiment();
+}

package/dist/learning-ranker.js

@@ -0,0 +1,148 @@
+"use strict";
+/**
+ * P2.6: Learning Ranker — Feedback-Weighted Ranking
+ *
+ * Wraps a base Ranker and adjusts scores using real acceptance data
+ * from the TelemetryIndex. This is the first self-improving loop:
+ *
+ *   Planner → Feedback → Telemetry → LearningRanker → Better Ranking
+ *
+ * Architecture:
+ *   LearningRanker WRAPS Ranker (does not implement it).
+ *   Base Ranker handles protocolSafety / performance / auditability.
+ *   LearningRanker adds feedback correction on top.
+ *
+ * Evolution path:
+ *   HeuristicRanker (P3) → LearningRanker (P2.6) → RewardModelRanker (P4)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LearningRanker = void 0;
+exports.createLearningRanker = createLearningRanker;
+const planner_telemetry_1 = require("./planner-telemetry");
+const repair_ranker_1 = require("./repair-ranker");
+const DEFAULT_CONFIG = {
+    baseWeight: 0.7,
+    feedbackWeight: 0.3,
+    minSamples: 5,
+};
+/**
+ * LearningRanker wraps a base CandidateRanker and applies
+ * feedback correction from the TelemetryIndex.
+ *
+ * Usage:
+ *   const base = createLinearRanker();
+ *   const learner = new LearningRanker(base, telemetry);
+ *   const ranked = learner.rank(candidates, features, ctx);
+ */
+class LearningRanker {
+    constructor(baseRanker, telemetry, config, rewardModel, modelWeight = 0.5) {
+        this.base = baseRanker;
+        this.telemetry = telemetry;
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.rewardModel = rewardModel;
+        this.modelWeight = modelWeight;
+    }
+    /**
+     * Rank candidates by base heuristic score, then adjust
+     * using acceptance data from the telemetry index.
+     *
+     * @param candidates  Repair candidates to rank
+     * @param features    Feature vectors (same index as candidates)
+     * @param ctx         Search context (for protocol/violationType)
+     */
+    rank(candidates, features, ctx) {
+        // 1. Score with base ranker
+        const baseScores = features.map(f => this.base.score(f));
+        // 2. Adjust with telemetry feedback + reward model (if available)
+        const ranked = candidates.map((c, i) => {
+            const fp = this.fingerprintFor(c, ctx);
+            const acceptance = this.telemetry.getCandidateAcceptance(fp, this.config.minSamples);
+            const effectiveReward = this.telemetry.getCandidateReward(fp, this.config.minSamples);
+            const baseScore = baseScores[i];
+            let adjustedScore;
+            if (this.rewardModel && this.rewardModel.isTrained) {
+                // Reward model: blend base + telemetry + model prediction
+                const acceptTotal = acceptance;
+                const execTotal = this.telemetry.getCandidateStats(fp);
+                const execRate = (execTotal.executionSuccess + execTotal.executionFailure) > 0
+                    ? execTotal.executionSuccess / (execTotal.executionSuccess + execTotal.executionFailure) : 0.5;
+                const modelScore = this.rewardModel.score(features[i], { acceptanceRate: acceptTotal, executionSuccessRate: execRate });
+                adjustedScore =
+                    baseScore * this.config.baseWeight * 0.5 +
+                        effectiveReward * this.config.feedbackWeight * 0.3 +
+                        modelScore * this.modelWeight;
+            }
+            else {
+                // Fallback: base + telemetry feedback only
+                adjustedScore =
+                    baseScore * this.config.baseWeight +
+                        effectiveReward * this.config.feedbackWeight;
+            }
+            return {
+                ...c,
+                score: adjustedScore,
+                acceptance,
+                effectiveReward,
+                baseScore,
+            };
+        });
+        // 3. Sort by adjusted score descending
+        ranked.sort((a, b) => b.score - a.score);
+        return ranked;
+    }
+    /**
+     * Single-candidate score (used by backwards-compat code).
+     */
+    score(candidate, features, ctx) {
+        const fp = this.fingerprintFor(candidate, ctx);
+        const baseScore = this.base.score(features);
+        const effectiveReward = this.telemetry.getCandidateReward(fp, this.config.minSamples);
+        return (baseScore * this.config.baseWeight +
+            effectiveReward * this.config.feedbackWeight);
+    }
+    /**
+     * Record a single feedback event for incremental learning.
+     * Convenience method for integration tests and CLI usage.
+     */
+    onFeedback(event) {
+        const fp = this.fingerprintFor({ id: event.candidateId, source: "protocol", actions: event.fixPath.map(fn => ({ kind: "call", function: fn, args: [] })), explanation: "" }, { protocol: "default", violationType: undefined });
+        if (event.accepted) {
+            this.telemetry.recordFeedback(event.candidateId, {
+                decision: "accepted",
+                executionResult: { success: event.accepted, violations: [] },
+                timestamp: Date.now(),
+            });
+        }
+    }
+    /** Compute the v2 fingerprint for a candidate. */
+    fingerprintFor(candidate, ctx) {
+        const actions = candidate.actions
+            .filter(a => a.kind === "call")
+            .map(a => a.function);
+        return (0, planner_telemetry_1.candidateFingerprint)(ctx.protocol, actions, ctx.violationType);
+    }
+}
+exports.LearningRanker = LearningRanker;
+// ═══════════════════════════════════════════════════════════════
+// Convenience factory
+// ═══════════════════════════════════════════════════════════════
+/**
+ * Create a fully wired learning ranker:
+ *   LinearRanker (base) + TelemetryIndex (feedback) = LearningRanker
+ */
+function createLearningRanker(baseRankerOrTelemetry, telemetryOrConfig, compatConfig) {
+    // Backward compat: createLearningRanker(baseRanker, telemetry, config)
+    if (telemetryOrConfig instanceof planner_telemetry_1.PlannerTelemetry) {
+        const base = baseRankerOrTelemetry;
+        const telemetry = telemetryOrConfig;
+        // Map learningRate/feedbackWindow to baseWeight/feedbackWeight/minSamples
+        const config = {};
+        if (compatConfig?.learningRate !== undefined)
+            config.feedbackWeight = compatConfig.learningRate;
+        if (compatConfig?.feedbackWindow !== undefined)
+            config.minSamples = compatConfig.feedbackWindow;
+        return new LearningRanker(base, telemetry, { ...config, ...compatConfig });
+    }
+    // New API: createLearningRanker(telemetry, config)
+    return new LearningRanker((0, repair_ranker_1.createLinearRanker)(), baseRankerOrTelemetry, telemetryOrConfig);
+}