loopforge 1.15.1 → 2.0.1

package/dist/engine.js

@@ -7,174 +7,14 @@
  */
 import { randomUUID } from "node:crypto";
 import { getPolicy } from "./policy.js";
-import { FSBackend, readLineageMd } from "./backends/fs.js";
-import { AgentStatus, Mode, makeAnalysis, makeExecutionEvidence, makeExecutionFeedback, makeLoopCompileRequest, makeLoopObjective, makeLoopRoundResult, makeSelfEvaluation, makeSessionState, makeTaskId, makeVaultConfig, SELF_EVAL_REGEX, } from "./protocol.js";
+import { FileLoopStore, LoopStoreBackend } from "./loop-store.js";
+import { AgentStatus, Mode, makeExecutionFeedback, makeLoopCompileRequest, makeLoopObjective, makeLoopRoundResult, makeSessionState, makeTaskId, } from "./protocol.js";
 import { compileLoop } from "./loop-compiler.js";
 import { logEvent } from "./observability.js";
-// ═══════════════════════════════════════════════════════════════════════════
-// Shared helpers
-// ═══════════════════════════════════════════════════════════════════════════
-/** Parse ExecutionEvidence from a raw JSON object. Shared by buildSelfEvaluation
- *  and invokeLoopCompile — both parse the same execution_evidence shape. */
-export function parseExecutionEvidence(raw) {
-    if (!raw || typeof raw !== "object")
-        return undefined;
-    const testResults = raw.test_results;
-    return makeExecutionEvidence({
-        files_changed: Array.isArray(raw.files_changed)
-            ? raw.files_changed.filter((v) => typeof v === "string")
-            : [],
-        test_results: testResults && typeof testResults.passed === "number"
-            ? {
-                passed: testResults.passed,
-                failed: testResults.failed ?? 0,
-                skipped: testResults.skipped ?? 0,
-            }
-            : null,
-        success_criteria_met: Array.isArray(raw.success_criteria_met)
-            ? raw.success_criteria_met.filter((v) => typeof v === "string")
-            : [],
-        success_criteria_remaining: Array.isArray(raw.success_criteria_remaining)
-            ? raw.success_criteria_remaining.filter((v) => typeof v === "string")
-            : [],
-        progress_estimate: typeof raw.progress_estimate === "number"
-            ? Math.max(0, Math.min(1, raw.progress_estimate))
-            : 0.0,
-    });
-}
-/** Parse CriterionRevision[] from a raw JSON array. Shared by buildSelfEvaluation
- *  and invokeLoopCompile — both parse the same revised_success_criteria shape. */
-export function parseCriterionRevisions(raw) {
-    if (!Array.isArray(raw))
-        return [];
-    return raw
-        .filter((v) => typeof v === "object" && v !== null &&
-        typeof v.old === "string" &&
-        typeof v.new === "string")
-        .map((v) => {
-        const r = v;
-        return { old: r.old, new: r.new };
-    });
-}
-/** Parse WorkerResult[] from a raw JSON array. Shared by buildSelfEvaluation
- *  and invokeLoopCompile — both parse the same worker_results shape. */
-export function parseWorkerResults(raw) {
-    if (!Array.isArray(raw))
-        return [];
-    return raw
-        .filter((v) => typeof v === "object" && v !== null &&
-        typeof v.agentId === "string" &&
-        typeof v.subTask === "string" &&
-        typeof v.resultSummary === "string")
-        .map((v) => {
-        const w = v;
-        return {
-            agentId: w.agentId,
-            subAgentType: typeof w.subAgentType === "string" ? w.subAgentType : "general-purpose",
-            subTask: w.subTask,
-            resultSummary: w.resultSummary,
-            success: typeof w.success === "boolean" ? w.success : false,
-            discoveredConstraints: Array.isArray(w.discoveredConstraints)
-                ? w.discoveredConstraints.filter((c) => typeof c === "string")
-                : [],
-        };
-    });
-}
-// ═══════════════════════════════════════════════════════════════════════════
-// Self-Evaluation extraction (v1.1 — autonomous loop feedback)
-// ═══════════════════════════════════════════════════════════════════════════
-/** Extract a structured SelfEvaluation from agent output text.
- *  Returns null if no valid self-eval block is found.
- *  The agent is instructed to output JSON between the delimiters. */
-export function extractSelfEvaluation(text) {
-    const match = text.match(SELF_EVAL_REGEX);
-    if (!match)
-        return null;
-    try {
-        const raw = JSON.parse(match[1]);
-        // Validate required fields
-        if (typeof raw.success !== "boolean")
-            return null;
-        if (typeof raw.output_summary !== "string")
-            return null;
-        if (!Array.isArray(raw.constraint_violations))
-            return null;
-        if (typeof raw.should_continue !== "boolean")
-            return null;
-        return buildSelfEvaluation(raw);
-    }
-    catch {
-        return null;
-    }
-}
-/** Build a SelfEvaluation from a parsed JSON object.
- *  Lenient parsing: missing optional fields get sensible defaults.
- *  Used by extractSelfEvaluation() (regex path) and MCP tool handler
- *  (structured evaluation parameter path). */
-export function buildSelfEvaluation(raw) {
-    // P4: Parse execution evidence from raw JSON
-    const executionEvidence = parseExecutionEvidence(raw.execution_evidence);
-    // P5: Parse corrections
-    const retractedConstraints = Array.isArray(raw.retracted_constraints)
-        ? raw.retracted_constraints.filter((v) => typeof v === "string")
-        : [];
-    const revisedCriteria = parseCriterionRevisions(raw.revised_success_criteria);
-    const wrongAssumptions = Array.isArray(raw.wrong_assumptions)
-        ? raw.wrong_assumptions.filter((v) => typeof v === "string")
-        : [];
-    // Multi-agent: Parse worker delegation results
-    const workerResults = parseWorkerResults(raw.worker_results);
-    return makeSelfEvaluation({
-        success: typeof raw.success === "boolean" ? raw.success : false,
-        output_summary: typeof raw.output_summary === "string" ? raw.output_summary : "",
-        constraint_violations: Array.isArray(raw.constraint_violations)
-            ? raw.constraint_violations.filter((v) => typeof v === "string")
-            : [],
-        should_continue: typeof raw.should_continue === "boolean" ? raw.should_continue : true,
-        // P0–P2: Optional evolution fields
-        discovered_constraints: Array.isArray(raw.discovered_constraints)
-            ? raw.discovered_constraints.filter((v) => typeof v === "string")
-            : [],
-        objective_refinement: typeof raw.objective_refinement === "string"
-            ? raw.objective_refinement
-            : "",
-        emerged_subtasks: Array.isArray(raw.emerged_subtasks)
-            ? raw.emerged_subtasks.filter((v) => typeof v === "string")
-            : [],
-        // P4: Execution evidence
-        execution_evidence: executionEvidence,
-        // P5: Self-correction
-        retracted_constraints: retractedConstraints,
-        revised_success_criteria: revisedCriteria,
-        wrong_assumptions: wrongAssumptions,
-        // Multi-agent: Worker delegation results
-        worker_results: workerResults,
-        // v1.10: Checkpoint compression
-        compression_checkpoint: typeof raw.compression_checkpoint === "boolean" ? raw.compression_checkpoint : false,
-        checkpoint_label: typeof raw.checkpoint_label === "string" ? raw.checkpoint_label : "",
-    });
-}
-/** Fallback heuristic when structured self-eval extraction fails.
- *  Scans agent output for completion and error signals.
- *  Returns a low-confidence SelfEvaluation — the autonomous runner
- *  may choose to warn the user or continue cautiously. */
-export function heuristicSelfEvaluation(text) {
-    const lower = text.toLowerCase();
-    const hasError = /error|failed|exception|cannot|unable|失败|错误|异常/.test(lower);
-    const hasCompletion = /done|complete|finished|完成|成功/.test(lower);
-    const hasRemaining = /remaining|continue|still need|next|todo|剩余|继续|下一步/.test(lower);
-    // Extract a reasonable summary from the last meaningful paragraph
-    const paragraphs = text.split(/\n\n+/).filter((p) => p.trim().length > 30);
-    const summary = paragraphs.length > 0
-        ? paragraphs[paragraphs.length - 1].trim().slice(0, 300)
-        : text.trim().slice(0, 300);
-    return makeSelfEvaluation({
-        success: !hasError && (hasCompletion || !hasRemaining),
-        output_summary: summary || "[heuristic fallback — could not parse structured self-eval]",
-        constraint_violations: [],
-        should_continue: hasRemaining && !hasError,
-    });
-}
+import { parseExecutionEvidence, parseCriterionRevisions, parseWorkerResults, } from "./self-eval.js";
+import { parseLoopExtras } from "./loop-extras-parser.js";
+// ── Re-export self-evaluation utilities (moved to self-eval.ts) ──────────
+export { parseExecutionEvidence, parseCriterionRevisions, parseWorkerResults, extractSelfEvaluation, buildSelfEvaluation, heuristicSelfEvaluation, } from "./self-eval.js";
 function makeEngineMetrics() {
     return {
         vaultWriteErrors: 0,
@@ -196,15 +36,16 @@ export class LoopForgeEngine {
     metrics = null;
     feedbackWriteBuffer = [];
     lastTask = null;
-    // skillsDir parameter retained for API backward compatibility (v1.15).
-    // Previously stored as this.skillsDir but never read — now accepted & dropped.
-    constructor(_skillsDir = "skills", backend) {
-        if (backend)
-            this.backend = backend;
+    constructor(storeOrBackend) {
+        if (storeOrBackend) {
+            this.backend = "readSession" in storeOrBackend
+                ? new LoopStoreBackend(storeOrBackend)
+                : storeOrBackend;
+        }
     }
     resolveBackend() {
         if (this.backend === null) {
-            this.backend = new FSBackend();
+            this.backend = new LoopStoreBackend(new FileLoopStore(getPolicy().backend.root_dir));
         }
         return this.backend;
     }
@@ -319,7 +160,6 @@ export class LoopForgeEngine {
             constraints_active: response.constraints_active,
             task: request.task,
             success: true,
-            technique_used: response.technique_used,
         };
         let lastOutputSummary = "";
         let lastViolations = [];
@@ -335,8 +175,6 @@ export class LoopForgeEngine {
             timestamp: new Date().toISOString().replace(/\.\d+Z$/, ""),
             user_intent: `loop_compile round ${response.round} — ${response.goal_id}`,
             task_type: "loop_lineage",
-            skill_used: response.technique_used,
-            technique_used: response.technique_used,
             loop_id: response.loop_id,
             loop_lineage: structuredLineage,
             loop_objective: loopObjDict,
@@ -356,26 +194,6 @@ export class LoopForgeEngine {
                 this.metrics.vaultWriteErrors++;
             logEvent("vault_write_error", { error: "persist_lineage_json" });
         }
-        // 2. Markdown write (secondary, non-blocking)
-        try {
-            this.resolveBackend().writeLineageMd(response.loop_id, response.round, response.prompt || "", {
-                goal_id: response.goal_id,
-                goal_text_hash: response.goal_text_hash,
-                recompile_level: response.recompile_level,
-                constraints_active: response.constraints_active,
-                task: request.task,
-                technique_used: response.technique_used,
-                loop_objective: loopObjDict,
-                success: true,
-                output_summary: lastOutputSummary,
-                constraint_violations: lastViolations,
-            });
-        }
-        catch {
-            if (this.metrics)
-                this.metrics.vaultWriteErrors++;
-            logEvent("vault_write_error", { error: "persist_lineage_md" });
-        }
         return vaultOk;
     }
     // ═══════════════════════════════════════════════════════════════════════
@@ -387,9 +205,14 @@ export class LoopForgeEngine {
     recordDelegation(loopId, round, entries) {
         if (!entries.length)
             return;
+        const taskId = `loop:${loopId}:r${round}:delegations`;
+        const existing = this.resolveBackend().queryEntries({ prefix: taskId })
+            .some((candidate) => candidate.task_id === taskId);
+        if (existing)
+            return;
         const entry = {
             id: randomUUID(),
-            task_id: `loop:${loopId}:r${round}:delegations`,
+            task_id: taskId,
             version_tag: "v1",
             is_active: true,
             timestamp: new Date().toISOString().replace(/\.\d+Z$/, ""),
@@ -449,18 +272,8 @@ export class LoopForgeEngine {
                 entry.success = fbSuccess.get(rnd);
             }
         }
-        // Fallback: scan Markdown files if JSON vault had no matches
-        let finalResults = results;
-        if (!finalResults.length) {
-            const mdResults = this.resolveBackend().scanLineageMd(loopId);
-            if (mdResults.length)
-                finalResults = mdResults;
-        }
-        // Normalize technique_used field
+        const finalResults = results;
         for (const entry of finalResults) {
-            if (!entry.technique_used) {
-                entry.technique_used = entry.skill_used;
-            }
             const lineage = (entry.loop_lineage ?? entry.lineage ?? {});
             if (!entry.output_summary) {
                 entry.output_summary = lineage.output_summary ?? "";
@@ -470,19 +283,6 @@ export class LoopForgeEngine {
                     lineage.constraint_violations ?? [];
             }
         }
-        // Enrich: attach full prompt text from Markdown for L0 cache reuse
-        for (const entry of finalResults) {
-            if (entry.full_prompt)
-                continue;
-            const lineage = (entry.loop_lineage ?? entry.lineage ?? {});
-            const roundNum = lineage.round;
-            if (roundNum) {
-                const mdEntry = readLineageMd(loopId, roundNum);
-                if (mdEntry?.full_prompt) {
-                    entry.full_prompt = mdEntry.full_prompt;
-                }
-            }
-        }
         if (!finalResults.length)
             return null;
         return { results: finalResults, global_entries: [] };
@@ -500,7 +300,6 @@ export class LoopForgeEngine {
                 response: {
                     status: AgentStatus.ERROR,
                     prompt: null,
-                    analysis: null,
                     error: "Feedback mode requires a feedback payload.",
                 },
             };
@@ -545,7 +344,6 @@ export class LoopForgeEngine {
             this.state.circuit_breaker_count = 0;
         }
         logEvent("round_complete", {
-            technique: "feedback",
             success,
             loopId: loopId ?? "unknown",
             round: loopRound ?? this.state.call_count,
@@ -555,12 +353,6 @@ export class LoopForgeEngine {
             response: {
                 status: AgentStatus.OK,
                 prompt: `## Feedback Recorded\n\nSuccess: ${success}\nSignals: 1`,
-                analysis: makeAnalysis({
-                    technique: "feedback",
-                    rationale: `success=${success}`,
-                    independence: "n/a",
-                    cognitive_load: "low",
-                }),
                 error: null,
             },
         };
@@ -574,8 +366,8 @@ export class LoopForgeEngine {
      *  and emerged_subtasks for the compiler to consume next round.
      *  Call this BEFORE invokeLoopCompile for the next round so that
      *  hydrateLoopContext picks up the latest success flags. */
-    autoFeedback(selfEval, loopId, round, task) {
-        this.ensureInit({ task, mode: Mode.FEEDBACK, vault_config: makeVaultConfig(), feedback: null, skill_name: null, task_id: null });
+    autoFeedback(selfEval, loopId, round, task, roundTransaction) {
+        this.ensureInit({ task, mode: Mode.FEEDBACK, feedback: null, skill_name: null, task_id: null });
         const fb = makeExecutionFeedback({
             output: selfEval.output_summary,
             success: selfEval.success,
@@ -583,6 +375,27 @@ export class LoopForgeEngine {
             manual_fixes_needed: "",
         });
         const taskId = `loop:${loopId}:r${round}:feedback`;
+        const transactionId = typeof roundTransaction?.round_id === "string"
+            ? roundTransaction.round_id
+            : null;
+        const transactionPersisted = () => {
+            if (!transactionId)
+                return false;
+            return this.resolveBackend().queryEntries({
+                prefix: taskId,
+                feedbackOnly: true,
+            }).some((entry) => {
+                if (entry.task_id !== taskId)
+                    return false;
+                const lineage = entry.loop_lineage;
+                const transaction = lineage?.round_transaction;
+                return transaction !== null &&
+                    typeof transaction === "object" &&
+                    !Array.isArray(transaction) &&
+                    transaction.round_id === transactionId;
+            });
+        };
+        const alreadyCommitted = transactionPersisted();
         // Multi-agent: Merge sub-agent discovered constraints into the main constraint flow
         const subDiscovered = (selfEval.worker_results ?? [])
             .flatMap((w) => w.discoveredConstraints ?? [])
@@ -611,9 +424,21 @@ export class LoopForgeEngine {
             wrong_assumptions: selfEval.wrong_assumptions ?? [],
             // Multi-agent: Worker delegation results
             worker_results: selfEval.worker_results ?? [],
+            loop_lineage: roundTransaction
+                ? {
+                    round,
+                    round_id: roundTransaction.round_id,
+                    round_transaction: roundTransaction,
+                }
+                : {},
         };
-        this.persistFeedbackToVault(signal);
-        this.flushFeedbackBuffer();
+        if (!alreadyCommitted) {
+            this.persistFeedbackToVault(signal);
+            this.flushFeedbackBuffer();
+            if (transactionId && !transactionPersisted()) {
+                throw new Error(`Round feedback commit failed: ${transactionId}`);
+            }
+        }
         // Multi-agent: Auto-record delegation journal from worker_results
         if (selfEval.worker_results && selfEval.worker_results.length > 0) {
             const entries = selfEval.worker_results.map((w, i) => ({
@@ -627,6 +452,10 @@ export class LoopForgeEngine {
             }));
             this.recordDelegation(loopId, round, entries);
         }
+        // Replaying a committed transaction may repair derived delegation data,
+        // but must never apply the feedback to mutable engine state twice.
+        if (alreadyCommitted)
+            return fb.success;
         // Update state
         this.state.call_count++;
         this.state.success_trend.push(fb.success);
@@ -644,80 +473,87 @@ export class LoopForgeEngine {
             loopId,
             round,
             success: fb.success,
-            technique: this.state?.last_technique ?? "feedback",
         });
         return fb.success;
     }
     // ═══════════════════════════════════════════════════════════════════════
     // Loop Compile (public, primary)
     // ═══════════════════════════════════════════════════════════════════════
-    invokeLoopCompile(request, hydrateResults) {
+    invokeLoopCompile(request, hydrateResults, options = {}) {
         this.ensureInit(request);
         this.lastTask = request.task;
-        // Build LoopCompileRequest from LoopForgeRequest extras
+        // Parse extras via typed extraction pipeline (loop-extras-parser.ts).
+        // Errors are collected but never thrown — the compiler always gets
+        // best-effort defaults so a malformed request doesn't crash the engine.
         const extras = request;
+        const { parsed, ctx } = parseLoopExtras(extras, request.task_id ?? "");
+        if (ctx.errors.length > 0) {
+            logEvent("extras_parse_errors", {
+                errors: ctx.errors.map((e) => `${e.field}: ${e.message}`),
+            });
+        }
         const lcr = makeLoopCompileRequest({
-            loop_id: extras.loop_id ?? request.task_id ?? "",
-            round: extras.round ?? 1,
-            goal_id: extras.goal_id ?? "",
+            loop_id: parsed.loop_id,
+            round: parsed.round,
+            goal_id: parsed.goal_id,
             task: request.task,
-            domain: extras.domain ?? "",
-            next_task_proposal: extras.next_task_proposal ?? "",
-            plan_source: extras.plan_source ?? null,
-            constraints_from_plan: extras.constraints_from_plan ?? [],
-            new_since_last_round: extras.new_since_last_round ?? "",
-            force_level: extras.force_level ?? "auto",
-            health_check_interval: extras.health_check_interval ?? 1,
-            external_context: extras.external_context ?? "",
-            max_rounds: extras.max_rounds ?? undefined,
+            domain: parsed.domain,
+            next_task_proposal: parsed.next_task_proposal,
+            plan_source: parsed.plan_source,
+            constraints_from_plan: parsed.constraints_from_plan,
+            new_since_last_round: parsed.new_since_last_round,
+            force_level: parsed.force_level,
+            health_check_interval: parsed.health_check_interval,
+            external_context: parsed.external_context,
+            max_rounds: parsed.max_rounds,
+            verification_flags: parsed.verification_flags,
+            attempt: parsed.attempt,
+            consecutive_rejections: parsed.consecutive_rejections,
+            rejection_notice: parsed.rejection_notice,
         });
-        // Convert last_round_result if present
-        const lastRR = extras.last_round_result;
-        if (lastRR) {
-            if (typeof lastRR === "object" && !Array.isArray(lastRR)) {
-                const rr = lastRR;
-                // Parse P4 execution evidence (shared helper)
-                const executionEvidence = parseExecutionEvidence(rr.execution_evidence);
-                // Parse P5 revised_success_criteria (shared parser)
-                const revisedCriteria = parseCriterionRevisions(rr.revised_success_criteria);
-                lcr.last_round_result = makeLoopRoundResult({
-                    round: rr.round ?? 0,
-                    success: rr.success ?? false,
-                    output_summary: rr.output_summary ?? "",
-                    constraint_violations: rr.constraint_violations ?? [],
-                    manual_fixes_needed: rr.manual_fixes_needed ?? "",
-                    // P0–P2: Cognitive evolution fields
-                    discovered_constraints: Array.isArray(rr.discovered_constraints)
-                        ? rr.discovered_constraints.filter((v) => typeof v === "string")
-                        : [],
-                    objective_refinement: typeof rr.objective_refinement === "string"
-                        ? rr.objective_refinement
-                        : "",
-                    emerged_subtasks: Array.isArray(rr.emerged_subtasks)
-                        ? rr.emerged_subtasks.filter((v) => typeof v === "string")
-                        : [],
-                    // P4: Execution evidence
-                    execution_evidence: executionEvidence,
-                    // P5: Self-correction
-                    retracted_constraints: Array.isArray(rr.retracted_constraints)
-                        ? rr.retracted_constraints.filter((v) => typeof v === "string")
-                        : [],
-                    revised_success_criteria: revisedCriteria,
-                    wrong_assumptions: Array.isArray(rr.wrong_assumptions)
-                        ? rr.wrong_assumptions.filter((v) => typeof v === "string")
-                        : [],
-                    // v1.10: Checkpoint boundary
-                    compression_checkpoint: typeof rr.compression_checkpoint === "boolean" ? rr.compression_checkpoint : false,
-                    checkpoint_label: typeof rr.checkpoint_label === "string" ? rr.checkpoint_label : "",
-                    // Multi-agent: Worker delegation results (shared parser)
-                    worker_results: parseWorkerResults(rr.worker_results),
-                });
-            }
+        // Convert last_round_result if present (object already validated by parser)
+        if (parsed.last_round_result) {
+            const rr = parsed.last_round_result;
+            // Parse P4 execution evidence (shared helper)
+            const executionEvidence = parseExecutionEvidence(rr.execution_evidence);
+            // Parse P5 revised_success_criteria (shared parser)
+            const revisedCriteria = parseCriterionRevisions(rr.revised_success_criteria);
+            lcr.last_round_result = makeLoopRoundResult({
+                round: rr.round ?? 0,
+                success: rr.success ?? false,
+                output_summary: rr.output_summary ?? "",
+                constraint_violations: rr.constraint_violations ?? [],
+                manual_fixes_needed: rr.manual_fixes_needed ?? "",
+                // P0–P2: Cognitive evolution fields
+                discovered_constraints: Array.isArray(rr.discovered_constraints)
+                    ? rr.discovered_constraints.filter((v) => typeof v === "string")
+                    : [],
+                objective_refinement: typeof rr.objective_refinement === "string"
+                    ? rr.objective_refinement
+                    : "",
+                emerged_subtasks: Array.isArray(rr.emerged_subtasks)
+                    ? rr.emerged_subtasks.filter((v) => typeof v === "string")
+                    : [],
+                // P4: Execution evidence
+                execution_evidence: executionEvidence,
+                // P5: Self-correction
+                retracted_constraints: Array.isArray(rr.retracted_constraints)
+                    ? rr.retracted_constraints.filter((v) => typeof v === "string")
+                    : [],
+                revised_success_criteria: revisedCriteria,
+                wrong_assumptions: Array.isArray(rr.wrong_assumptions)
+                    ? rr.wrong_assumptions.filter((v) => typeof v === "string")
+                    : [],
+                // v1.10: Checkpoint boundary
+                compression_checkpoint: typeof rr.compression_checkpoint === "boolean" ? rr.compression_checkpoint : false,
+                checkpoint_label: typeof rr.checkpoint_label === "string" ? rr.checkpoint_label : "",
+                // Multi-agent: Worker delegation results (shared parser)
+                worker_results: parseWorkerResults(rr.worker_results),
+            });
         }
-        // Convert loop_objective if present
-        const lo = extras.loop_objective;
-        if (lo && typeof lo === "object" && !Array.isArray(lo)) {
-            const obj = lo;
+        // Convert loop_objective if present (object already validated by parser)
+        if (parsed.loop_objective) {
+            const obj = parsed.loop_objective;
             lcr.loop_objective = makeLoopObjective({
                 objective: obj.objective ?? "",
                 success_criteria: obj.success_criteria ?? [],
@@ -742,84 +578,22 @@ export class LoopForgeEngine {
                 response: {
                     status: AgentStatus.ERROR,
                     prompt: null,
-                    analysis: null,
                     error: `loop_compile failed: ${exc}`,
                 },
             };
         }
-        // Build prompt text from response.
-        // Compile functions (buildL2Prompt / specialist compilers via buildHeader)
-        // already produce their own round-level headers with technique + identity.
-        const promptLines = [response.prompt];
-        if (response.warnings.length) {
-            promptLines.push("");
-            promptLines.push("### Warnings");
-            for (const w of response.warnings) {
-                promptLines.push(`- ⚠️ ${w}`);
-            }
-        }
-        // Verification gate flags (v1.6) — injected after compiler warnings
-        const verificationFlags = extras.verification_flags ?? [];
-        if (verificationFlags.length) {
-            promptLines.push("");
-            promptLines.push("### Verification Gate");
-            for (const f of verificationFlags) {
-                const icon = f.severity === "error" ? "🚫" : "⚠️";
-                promptLines.push(`- ${icon} [${f.check}] ${f.detail}`);
-            }
-            const hasError = verificationFlags.some((f) => f.severity === "error");
-            if (hasError) {
-                promptLines.push("");
-                promptLines.push("**Gate Verdict: CONTRADICTED** — this round's success flag has been excluded " +
-                    "from the success trend. Address each 🚫 flag explicitly in your next response.");
-            }
-        }
-        if (response.loop_health) {
-            const h = response.loop_health;
-            promptLines.push("");
-            promptLines.push("### Loop Health");
-            promptLines.push(`- Goal Alignment: ${h.goal_alignment.toFixed(2)}`);
-            promptLines.push(`- Constraint Integrity: ${h.constraint_integrity.toFixed(2)}`);
-            promptLines.push(`- Task Continuity: ${h.task_continuity.toFixed(2)}`);
-            promptLines.push(`- Drift Detected: ${h.drift_detected}`);
-            promptLines.push(`- Strategy Stability: ${h.strategy_stability}`);
-        }
-        if (response.task_alignment &&
-            response.task_alignment.escalation !== "none") {
-            promptLines.push("");
-            promptLines.push("### Task Alignment Advisory");
-            promptLines.push(`- Score: ${response.task_alignment.alignment_score.toFixed(2)}`);
-            promptLines.push(`- Escalation: ${response.task_alignment.escalation}`);
-            promptLines.push(`- ${response.task_alignment.warning}`);
-        }
-        if (response.suggested_next_task) {
-            promptLines.push("");
-            promptLines.push(`### Suggested Next Task\n${response.suggested_next_task}`);
-        }
         // Persist lineage to vault
-        this.persistLoopLineage(response, lcr);
-        // Track technique for status queries
-        if (this.state) {
-            this.state.last_technique = response.technique_used;
+        if (options.persistLineage !== false) {
+            this.persistLoopLineage(response, lcr);
         }
         return {
             status: AgentStatus.OK,
             response: {
                 status: AgentStatus.OK,
-                prompt: promptLines.join("\n"),
-                analysis: makeAnalysis({
-                    technique: response.technique_used,
-                    rationale: `Recompile level: ${response.recompile_level}`,
-                    independence: "n/a",
-                    cognitive_load: response.recompile_level === "l0"
-                        ? "low"
-                        : response.recompile_level === "l1"
-                            ? "medium"
-                            : "high",
-                    reference_file: response.reference_file,
-                }),
+                prompt: response.prompt,
                 error: null,
                 state_file_content: response.state_file_content,
+                prompt_artifact: response.prompt_artifact,
             },
         };
     }
@@ -848,7 +622,7 @@ export class LoopForgeEngine {
 // ═══════════════════════════════════════════════════════════════════════════
 // Factory
 // ═══════════════════════════════════════════════════════════════════════════
-export function createEngine(skillsDir = "skills", backend) {
-    return new LoopForgeEngine(skillsDir, backend);
+export function createEngine(store) {
+    return new LoopForgeEngine(store);
 }
 //# sourceMappingURL=engine.js.map