loopforge 1.0.0

package/dist/tests/replay.test.js

@@ -0,0 +1,194 @@
+/** Tests for ReplayBackend — time-travel queries. */
+import { describe, it, beforeEach } from "node:test";
+import assert from "node:assert/strict";
+import { ReplayBackend } from "../replay.js";
+/** In-memory backend for testing — implements VaultBackend without filesystem. */
+class MemoryBackend {
+    entries = [];
+    markdownFiles = new Map();
+    markdownScans = new Map();
+    readVault() {
+        return { entries: this.entries };
+    }
+    writeVault(data) {
+        this.entries = data.entries || [];
+    }
+    queryEntries(opts) {
+        return this.entries.filter((entry) => {
+            const taskId = String(entry.task_id ?? "");
+            if (opts?.feedbackOnly && !taskId.endsWith(":feedback"))
+                return false;
+            if (!opts?.feedbackOnly && taskId.endsWith(":feedback"))
+                return false;
+            if (opts?.prefix && !taskId.startsWith(opts.prefix))
+                return false;
+            return true;
+        });
+    }
+    appendEntry(entry) {
+        this.entries.push(entry);
+    }
+    appendEntries(entries) {
+        this.entries.push(...entries);
+        return entries.length;
+    }
+    writeLineageMd(_loopId, roundNum, content, _metadata) {
+        this.markdownFiles.set(`${_loopId}:r${roundNum}`, content);
+        return `/fake/${_loopId}/r${roundNum}.md`;
+    }
+    readLineageMd(loopId, roundNum) {
+        return this.markdownFiles.get(`${loopId}:r${roundNum}`) ?? null;
+    }
+    scanLineageMd(loopId) {
+        return this.markdownScans.get(loopId) ?? [];
+    }
+}
+function makeEntry(overrides = {}) {
+    return {
+        task_id: "loop:test:r1",
+        loop_lineage: {
+            loop_id: "test",
+            round: 1,
+            goal_id: "audit",
+            recompile_level: "l2",
+            task: "Audit contract",
+            constraints_active: ["check ownership"],
+        },
+        technique_used: "few-shot-cot",
+        quality_score: 4,
+        ...overrides,
+    };
+}
+describe("ReplayBackend — getRound", () => {
+    let backend;
+    let replay;
+    beforeEach(() => {
+        backend = new MemoryBackend();
+        replay = new ReplayBackend(backend);
+    });
+    it("returns entry for existing round", () => {
+        backend.appendEntry(makeEntry());
+        const result = replay.getRound("test", 1);
+        assert.notEqual(result, null);
+        assert.equal(result.task_id, "loop:test:r1");
+    });
+    it("returns null for missing round", () => {
+        const result = replay.getRound("test", 99);
+        assert.equal(result, null);
+    });
+    it("enriches with full_prompt from markdown", () => {
+        backend.appendEntry(makeEntry());
+        backend.markdownFiles.set("test:r1", "## Compiled Prompt\n\nAudit the contract.");
+        const result = replay.getRound("test", 1);
+        assert.equal(result.full_prompt, "## Compiled Prompt\n\nAudit the contract.");
+    });
+    it("falls back to markdown scan when JSON vault empty", () => {
+        backend.markdownScans.set("test", [
+            {
+                task_id: "loop:test:r1",
+                loop_lineage: { round: 1, goal_id: "audit", loop_id: "test" },
+                full_prompt: "## From Markdown",
+            },
+        ]);
+        const result = replay.getRound("test", 1);
+        assert.notEqual(result, null);
+        assert.equal(result.full_prompt, "## From Markdown");
+    });
+    it("merges feedback quality_score", () => {
+        backend.appendEntry(makeEntry({ quality_score: 0 }));
+        backend.appendEntry({
+            task_id: "loop:test:r1:feedback",
+            quality_score: 5,
+        });
+        const result = replay.getRound("test", 1);
+        assert.equal(result.quality_score, 5);
+    });
+});
+describe("ReplayBackend — replay", () => {
+    it("returns all rounds in range", () => {
+        const backend = new MemoryBackend();
+        backend.appendEntry(makeEntry({ task_id: "loop:test:r1", loop_lineage: { loop_id: "test", round: 1 } }));
+        backend.appendEntry(makeEntry({ task_id: "loop:test:r2", loop_lineage: { loop_id: "test", round: 2 } }));
+        backend.appendEntry(makeEntry({ task_id: "loop:test:r3", loop_lineage: { loop_id: "test", round: 3 } }));
+        const replay = new ReplayBackend(backend);
+        const results = replay.replay("test");
+        assert.equal(results.length, 3);
+    });
+    it("respects start/end range", () => {
+        const backend = new MemoryBackend();
+        for (let i = 1; i <= 5; i++) {
+            backend.appendEntry(makeEntry({
+                task_id: `loop:test:r${i}`,
+                loop_lineage: { loop_id: "test", round: i },
+            }));
+        }
+        const replay = new ReplayBackend(backend);
+        const results = replay.replay("test", { start: 2, end: 4 });
+        assert.equal(results.length, 3);
+    });
+    it("returns empty array for empty loop", () => {
+        const backend = new MemoryBackend();
+        const replay = new ReplayBackend(backend);
+        assert.deepEqual(replay.replay("nonexistent"), []);
+    });
+});
+describe("ReplayBackend — timeline", () => {
+    it("returns sorted summary entries", () => {
+        const backend = new MemoryBackend();
+        backend.appendEntry(makeEntry({
+            task_id: "loop:test:r3",
+            loop_lineage: { loop_id: "test", round: 3, recompile_level: "l1", goal_id: "audit", task: "Fix bugs" },
+            technique_used: "few-shot",
+            quality_score: 3,
+        }));
+        backend.appendEntry(makeEntry({
+            task_id: "loop:test:r1",
+            loop_lineage: { loop_id: "test", round: 1, recompile_level: "l2", goal_id: "audit", task: "Audit" },
+            technique_used: "few-shot-cot",
+            quality_score: 4,
+        }));
+        const replay = new ReplayBackend(backend);
+        const tl = replay.timeline("test");
+        assert.equal(tl.length, 2);
+        assert.equal(tl[0].round, 1);
+        assert.equal(tl[1].round, 3);
+        assert.equal(tl[0].recompile_level, "l2");
+        assert.equal(tl[1].recompile_level, "l1");
+    });
+});
+describe("ReplayBackend — diff", () => {
+    it("detects changes between rounds", () => {
+        const backend = new MemoryBackend();
+        backend.appendEntry(makeEntry({
+            task_id: "loop:test:r1",
+            loop_lineage: { loop_id: "test", round: 1, recompile_level: "l2", goal_id: "audit", task: "Audit ERC20", constraints_active: ["check ownership"] },
+            technique_used: "few-shot-cot",
+            quality_score: 4,
+        }));
+        backend.appendEntry(makeEntry({
+            task_id: "loop:test:r3",
+            loop_lineage: { loop_id: "test", round: 3, recompile_level: "l1", goal_id: "audit", task: "Check flash loans", constraints_active: ["check ownership", "check flash loans"] },
+            technique_used: "few-shot",
+            quality_score: 3,
+        }));
+        const replay = new ReplayBackend(backend);
+        const diff = replay.diff("test", 1, 3);
+        assert.equal(diff.missing, null);
+        assert.ok(diff.changes.length > 0);
+        assert.ok(diff.unchanged.includes("goal_id"));
+    });
+    it("handles missing rounds", () => {
+        const backend = new MemoryBackend();
+        backend.appendEntry(makeEntry({ task_id: "loop:test:r1" }));
+        const replay = new ReplayBackend(backend);
+        const diff = replay.diff("test", 1, 99);
+        assert.equal(diff.missing, "round_b");
+    });
+    it("handles both missing", () => {
+        const backend = new MemoryBackend();
+        const replay = new ReplayBackend(backend);
+        const diff = replay.diff("test", 1, 2);
+        assert.equal(diff.missing, "both");
+    });
+});
+//# sourceMappingURL=replay.test.js.map

package/dist/tests/replay.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay.test.js","sourceRoot":"","sources":["../../src/tests/replay.test.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAG7C,kFAAkF;AAClF,MAAM,aAAa;IACjB,OAAO,GAAiB,EAAE,CAAC;IAC3B,aAAa,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC1C,aAAa,GAAG,IAAI,GAAG,EAAwB,CAAC;IAEhD,SAAS;QACP,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;IACnC,CAAC;IACD,UAAU,CAAC,IAA6B;QACtC,IAAI,CAAC,OAAO,GAAI,IAAI,CAAC,OAAwB,IAAI,EAAE,CAAC;IACtD,CAAC;IACD,YAAY,CAAC,IAIZ;QACC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;YACnC,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;YAC3C,IAAI,IAAI,EAAE,YAAY,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC;gBAAE,OAAO,KAAK,CAAC;YACtE,IAAI,CAAC,IAAI,EAAE,YAAY,IAAI,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC;gBAAE,OAAO,KAAK,CAAC;YACtE,IAAI,IAAI,EAAE,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC;gBAAE,OAAO,KAAK,CAAC;YAClE,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC;IACD,WAAW,CAAC,KAAiB;QAC3B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IACD,aAAa,CAAC,OAAqB;QACjC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC;QAC9B,OAAO,OAAO,CAAC,MAAM,CAAC;IACxB,CAAC;IACD,cAAc,CACZ,OAAe,EACf,QAAgB,EAChB,OAAe,EACf,SAAkC;QAElC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,OAAO,KAAK,QAAQ,EAAE,EAAE,OAAO,CAAC,CAAC;QAC3D,OAAO,SAAS,OAAO,KAAK,QAAQ,KAAK,CAAC;IAC5C,CAAC;IACD,aAAa,CAAC,MAAc,EAAE,QAAgB;QAC5C,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,MAAM,KAAK,QAAQ,EAAE,CAAC,IAAI,IAAI,CAAC;IAClE,CAAC;IACD,aAAa,CAAC,MAAc;QAC1B,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAC9C,CAAC;CACF;AAED,SAAS,SAAS,CAAC,YAAiC,EAAE;IACpD,OAAO;QACL,OAAO,EAAE,cAAc;QACvB,YAAY,EAAE;YACZ,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,CAAC;YACR,OAAO,EAAE,OAAO;YAChB,eAAe,EAAE,IAAI;YACrB,IAAI,EAAE,gBAAgB;YACtB,kBAAkB,EAAE,CAAC,iBAAiB,CAAC;SACxC;QACD,cAAc,EAAE,cAAc;QAC9B,aAAa,EAAE,CAAC;QAChB,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;IACxC,IAAI,OAAsB,CAAC;IAC3B,IAAI,MAAqB,CAAC;IAE1B,UAAU,CAAC,GAAG,EAAE;QACd,OAAO,GAAG,IAAI,aAAa,EAAE,CAAC;QAC9B,MAAM,GAAG,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,OAAO,CAAC,WAAW,CAAC,SAAS,EAAE,CAAC,CAAC;QACjC,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAC1C,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC9B,MAAM,CAAC,KAAK,CAAC,MAAO,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC3C,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,OAAO,CAAC,WAAW,CAAC,SAAS,EAAE,CAAC,CAAC;QACjC,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,SAAS,EAAE,2CAA2C,CAAC,CAAC;QAClF,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAC1C,MAAM,CAAC,KAAK,CAAC,MAAO,CAAC,WAAW,EAAE,2CAA2C,CAAC,CAAC;IACjF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,EAAE;YAChC;gBACE,OAAO,EAAE,cAAc;gBACvB,YAAY,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE;gBAC7D,WAAW,EAAE,kBAAkB;aAChC;SACF,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAC1C,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC9B,MAAM,CAAC,KAAK,CAAC,MAAO,CAAC,WAAW,EAAE,kBAAkB,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACrD,OAAO,CAAC,WAAW,CAAC;YAClB,OAAO,EAAE,uBAAuB;YAChC,aAAa,EAAE,CAAC;SACjB,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAC1C,MAAM,CAAC,KAAK,CAAC,MAAO,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACtC,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,OAAO,GAAG,IAAI,aAAa,EAAE,CAAC;QACpC,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QACzG,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QACzG,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QACzG,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;QAE1C,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACtC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;QAClC,MAAM,OAAO,GAAG,IAAI,aAAa,EAAE,CAAC;QACpC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC5B,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC;gBAC5B,OAAO,EAAE,cAAc,CAAC,EAAE;gBAC1B,YAAY,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE;aAC5C,CAAC,CAAC,CAAC;QACN,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;QAE1C,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QAC5D,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,OAAO,GAAG,IAAI,aAAa,EAAE,CAAC;QACpC,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;QAC1C,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,EAAE,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;IACxC,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,OAAO,GAAG,IAAI,aAAa,EAAE,CAAC;QACpC,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC;YAC5B,OAAO,EAAE,cAAc;YACvB,YAAY,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,eAAe,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE;YACtG,cAAc,EAAE,UAAU;YAC1B,aAAa,EAAE,CAAC;SACjB,CAAC,CAAC,CAAC;QACJ,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC;YAC5B,OAAO,EAAE,cAAc;YACvB,YAAY,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,eAAe,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE;YACnG,cAAc,EAAE,cAAc;YAC9B,aAAa,EAAE,CAAC;SACjB,CAAC,CAAC,CAAC;QACJ,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;QAE1C,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACnC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAC3B,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAC7B,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAC7B,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC;QAC1C,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACpC,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,OAAO,GAAG,IAAI,aAAa,EAAE,CAAC;QACpC,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC;YAC5B,OAAO,EAAE,cAAc;YACvB,YAAY,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,eAAe,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,kBAAkB,EAAE,CAAC,iBAAiB,CAAC,EAAE;YAClJ,cAAc,EAAE,cAAc;YAC9B,aAAa,EAAE,CAAC;SACjB,CAAC,CAAC,CAAC;QACJ,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC;YAC5B,OAAO,EAAE,cAAc;YACvB,YAAY,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,eAAe,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,CAAC,iBAAiB,EAAE,mBAAmB,CAAC,EAAE;YAC7K,cAAc,EAAE,UAAU;YAC1B,aAAa,EAAE,CAAC;SACjB,CAAC,CAAC,CAAC;QACJ,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;QAE1C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACvC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACjC,MAAM,CAAC,EAAE,CAAE,IAAI,CAAC,OAAqB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAClD,MAAM,CAAC,EAAE,CAAE,IAAI,CAAC,SAAsB,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;QAChC,MAAM,OAAO,GAAG,IAAI,aAAa,EAAE,CAAC;QACpC,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC;QAC5D,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;QAE1C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QACxC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;QAC9B,MAAM,OAAO,GAAG,IAAI,aAAa,EAAE,CAAC;QACpC,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;QAE1C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACvC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/loop_policy.json

@@ -0,0 +1,44 @@
+{
+  "version": "1",
+  "constraints": {
+    "retire_window": 3,
+    "max_active": 12
+  },
+  "summary": {
+    "window": 5,
+    "health_check_interval": 1
+  },
+  "recompile_triggers": {
+    "l1": ["new_constraints", "repeated_failure", "repair_signal"],
+    "l2": ["goal_id_changed", "plan_source_provided", "strategy_collapse", "severe_alignment_drop"]
+  },
+  "technique": {
+    "fallback_chain": {
+      "zero-shot": "few-shot",
+      "few-shot": "zero-shot-cot",
+      "zero-shot-cot": "few-shot-cot",
+      "few-shot-cot": "tree-of-thought",
+      "step-back": "least-to-most",
+      "least-to-most": "tree-of-thought",
+      "tree-of-thought": "tree-of-thought"
+    },
+    "adaptive_quality_threshold": 3,
+    "adaptive_consecutive_rounds": 2,
+    "routing_table": {
+      "continuous_low": "zero-shot",
+      "independent_low": "zero-shot",
+      "continuous_medium": "few-shot",
+      "independent_medium": "zero-shot-cot",
+      "continuous_high": "few-shot-cot",
+      "independent_high": "tree-of-thought"
+    }
+  },
+  "engine": {
+    "feedback_flush_interval": 5,
+    "max_circuit_breaker": 3
+  },
+  "backend": {
+    "vault_path": ".promptcraft/prompt_vault.json",
+    "global_vault_path": "~/.promptcraft/global_vault.json"
+  }
+}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "loopforge",
+  "version": "1.0.0",
+  "description": "Loop-Time Intelligence Layer for AI coding agents — per-iteration prompt compiler with structured memory, constraint inheritance, and drift correction.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./compiler": {
+      "import": "./dist/loop-compiler.js",
+      "types": "./dist/loop-compiler.d.ts"
+    },
+    "./replay": {
+      "import": "./dist/replay.js",
+      "types": "./dist/replay.d.ts"
+    }
+  },
+  "bin": {
+    "loopforge": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "loop_policy.json",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc && node dist/generate-schema.js",
+    "generate-schema": "tsc && node dist/generate-schema.js",
+    "test": "tsc && node dist/generate-schema.js && node --test dist/tests/*.test.js",
+    "test:watch": "tsc && node --test --watch dist/tests/*.test.js",
+    "check": "tsc --noEmit"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kyrielrving11/LoopForge"
+  },
+  "keywords": [
+    "prompt-engineering",
+    "ai-agent",
+    "loop-compiler",
+    "claude-code",
+    "llm",
+    "cognitive-stability",
+    "constraint-management"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.4.0"
+  }
+}