progmune-runtime 2.0.4 → 2.1.1

package/dist/execute.js

@@ -0,0 +1,251 @@
+"use strict";
+/**
+ * Phase 5: Semantic Execution Kernel
+ *
+ * Single entry point: intent → validated code → file written → audit verified.
+ * Wires together: IR extraction → Planner → EmitCode → Fingerprint.
+ *
+ * This is what progmune_execute MCP tool calls internally.
+ */
+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.recordGeneration = recordGeneration;
+exports.getExecutionMetrics = getExecutionMetrics;
+exports.execute = execute;
+exports.verifyCompiles = verifyCompiles;
+exports.verifyFileMarker = verifyFileMarker;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const planner_1 = require("./planner");
+const extract_ir_1 = require("./extract-ir");
+const failure_collector_1 = require("./failure-collector");
+const emitter_1 = require("./emitter");
+const METRICS_FILE = ".progmune_corpus/metrics.json";
+function loadMetrics() {
+    try {
+        if (fs.existsSync(METRICS_FILE)) {
+            return JSON.parse(fs.readFileSync(METRICS_FILE, "utf-8"));
+        }
+    }
+    catch { }
+    return { generated: 0, repaired: 0, lastGeneration: null, history: [] };
+}
+function saveMetrics(m) {
+    const dir = ".progmune_corpus";
+    if (!fs.existsSync(dir))
+        fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(METRICS_FILE, JSON.stringify(m, null, 2), "utf-8");
+}
+/** Record a generation event. Called automatically by execute(). */
+/** @requires GENERATION_EVENT @produces METRICS_DATA */
+function recordGeneration(record) {
+    const m = loadMetrics();
+    m.generated++;
+    if (record.repaired)
+        m.repaired++;
+    m.lastGeneration = record.filePath;
+    m.history.push(record);
+    // Keep last 100 entries
+    if (m.history.length > 100)
+        m.history = m.history.slice(-100);
+    saveMetrics(m);
+}
+/** Get current execution metrics. */
+/** @requires METRICS_DATA @produces EXECUTION_METRICS */
+/** @requires METRICS_DATA @produces EXECUTION_METRICS */
+function getExecutionMetrics() {
+    return loadMetrics();
+}
+/**
+ * Execute the full Progmune pipeline: intent → validated code → file.
+ *
+ * @param intent - Natural language programming intent
+ * @param projectPath - Absolute path to project root
+ * @param filePath - Optional: write generated code to this file
+ */
+/** @requires INTENT @produces CODE */
+/** @requires INTENT @produces CODE */
+async function execute(intent, projectPath, filePath) {
+    // 1. IR extraction
+    let ir;
+    try {
+        ir = (0, extract_ir_1.extractIR)(projectPath);
+    }
+    catch (e) {
+        return { success: false, code: "", sessionId: "", hash: "", ruleHash: "", irFunctionCount: 0, protocolRuleCount: 0, violations: 0, repairApplied: false, repairCount: 0, repairBranchIds: [], branchWinner: undefined, error: `IR extraction failed: ${e.message}` };
+    }
+    // 2. Protocol rule count
+    let protocolRuleCount = 0;
+    try {
+        const protoPath = path.resolve(projectPath, "protocols.json");
+        if (fs.existsSync(protoPath)) {
+            protocolRuleCount = Object.keys(JSON.parse(fs.readFileSync(protoPath, "utf-8")).rules || {}).length;
+        }
+    }
+    catch { }
+    // 3. Plan (LLM + immune constraints)
+    let planResult;
+    try {
+        planResult = await (0, planner_1.plan)(intent);
+    }
+    catch (e) {
+        (0, failure_collector_1.recordFailure)({
+            intent,
+            stage: "plan",
+            plan: [],
+            compileErrors: [e.message],
+            rootCause: (0, failure_collector_1.classifyPlanError)(e.message),
+            sessionId: undefined,
+        });
+        return { success: false, code: "", sessionId: "", hash: "", ruleHash: "", irFunctionCount: ir.length, protocolRuleCount, violations: 0, repairApplied: false, repairCount: 0, repairBranchIds: [], branchWinner: undefined, error: `Planning failed: ${e.message}` };
+    }
+    const actions = planResult.actions || [];
+    if (actions.length === 0) {
+        return { success: false, code: "", sessionId: planResult.sessionId, hash: "", ruleHash: planResult.ruleHash || "", irFunctionCount: ir.length, protocolRuleCount, violations: 0, repairApplied: false, repairCount: 0, repairBranchIds: [], branchWinner: undefined, error: "Planner returned empty action sequence" };
+    }
+    // 4. Emit code with generation marker
+    const code = (0, emitter_1.emitCode)(actions, {
+        sessionId: planResult.sessionId,
+        ruleHash: planResult.ruleHash,
+        irFunctionCount: ir.length,
+        protocolRuleCount,
+    });
+    // 5. Write to file if requested
+    if (filePath) {
+        const resolvedPath = path.isAbsolute(filePath) ? filePath : path.resolve(projectPath, filePath);
+        const dir = path.dirname(resolvedPath);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        fs.writeFileSync(resolvedPath, code, "utf-8");
+    }
+    // 6. Compute hash (from code content)
+    const crypto = require("crypto");
+    const hash = crypto.createHash("sha256").update(code).digest("hex").slice(0, 16);
+    const ruleHash = planResult.ruleHash || "";
+    // Phase 7: Record execution metrics
+    if (filePath) {
+        recordGeneration({
+            sessionId: planResult.sessionId,
+            timestamp: Date.now(),
+            filePath: filePath,
+            repaired: planResult.repairApplied,
+            repairCount: planResult.repairCount,
+            irFunctionCount: ir.length,
+        });
+    }
+    // Fingerprint registration is NOT done here.
+    // plan() internally calls recordSession() which writes real transitions to
+    // .progmune_corpus/sessions/. The fingerprint is registered later by
+    // `npm run check` → registerAllMissingFingerprints() which reads the
+    // actual session file with real StateTransition[].
+    return {
+        success: true,
+        code,
+        sessionId: planResult.sessionId,
+        filePath: filePath || undefined,
+        hash,
+        ruleHash,
+        irFunctionCount: ir.length,
+        protocolRuleCount,
+        violations: 0,
+        repairApplied: planResult.repairApplied,
+        repairCount: planResult.repairCount,
+        repairBranchIds: planResult.repairBranchIds,
+        branchWinner: planResult.repairApplied && planResult.repairBranchIds.length >= 2
+            ? (() => {
+                try {
+                    // Load branches from the session file to evaluate
+                    const sessionFile = `.progmune_corpus/sessions/${planResult.sessionId}.json`;
+                    if (fs.existsSync(sessionFile)) {
+                        const session = JSON.parse(fs.readFileSync(sessionFile, "utf-8"));
+                        if (session.branchTree && session.branchTree.length > 0) {
+                            const { evaluateBranches } = require("./branch-ledger");
+                            const { getNsInit } = require("./protocol-registry");
+                            const evalResult = evaluateBranches(session.branchTree, getNsInit());
+                            if (evalResult.winner) {
+                                return {
+                                    id: evalResult.winner.branchId.slice(0, 12),
+                                    score: evalResult.winner.score,
+                                    recommendation: evalResult.winner.recommendation,
+                                };
+                            }
+                        }
+                    }
+                }
+                catch { }
+                return undefined;
+            })()
+            : undefined,
+    };
+}
+/** Verify a file compiles without errors. Returns {pass, errors[]}.
+ *  Uses tsc directly — no grep tricks, no pipefail ambiguity. */
+/** @requires FILE_PATH @produces COMPILE_RESULT */
+/** @requires FILE_PATH @produces COMPILE_RESULT */
+/** @requires FILE_PATH @produces COMPILE_RESULT */
+function verifyCompiles(filePath) {
+    try {
+        const { execSync } = require("child_process");
+        const result = execSync(`npx tsc --noEmit --project tsconfig.json --pretty false 2>&1`, {
+            timeout: 30000,
+            encoding: "utf-8",
+            stdio: "pipe",
+        });
+        // tsc exits 0, check if our file is mentioned in output anyway (unlikely but safe)
+        const lines = result.split("\n").filter((l) => l.includes(filePath));
+        return { pass: lines.length === 0, errors: lines };
+    }
+    catch (e) {
+        // tsc exits non-zero — parse stderr/stdout for our file's errors
+        const output = (e.stdout || "") + (e.stderr || "");
+        const lines = output.split("\n").filter((l) => l.includes(filePath));
+        return { pass: lines.length === 0, errors: lines };
+    }
+}
+/** Quick audit: check whether a file has the @progmune-generated marker. */
+/** @requires FILE_PATH @produces MARKER_STATUS */
+function verifyFileMarker(filePath) {
+    try {
+        const content = fs.readFileSync(filePath, "utf-8");
+        const head = content.split("\n").slice(0, 5).join("\n");
+        const match = head.match(/@progmune-generated\s+session=(\S+)(?:\s+timestamp=(\S+))?/);
+        if (match) {
+            return { marked: true, sessionId: match[1], timestamp: match[2] };
+        }
+    }
+    catch { }
+    return { marked: false };
+}