loopforge 1.7.0 → 1.8.0

package/dist/tests/memory-bridge.test.js

@@ -0,0 +1,384 @@
+/** Tests for Memory Bridge (v1.8).
+ *
+ *  Covers: detection, computeProjectHash, createMemoryProvider (retrieval),
+ *  createMemoryWriter (writeback), autoConfigureMemory, tryAutoConfigure,
+ *  and edge cases (empty dirs, no matches, lock contention).
+ */
+import { describe, it, before, after } from "node:test";
+import assert from "node:assert/strict";
+import { mkdirSync, writeFileSync, rmSync, readFileSync, existsSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { randomUUID } from "node:crypto";
+import { computeProjectHash, findGitRoot, detectClaudeMem, createMemoryProvider, createMemoryWriter, autoConfigureMemory, tryAutoConfigure, } from "../memory-bridge.js";
+import { SessionManager } from "../mcp/session.js";
+// ═══════════════════════════════════════════════════════════════════════════
+// Helpers
+// ═══════════════════════════════════════════════════════════════════════════
+function makeMemDir() {
+    const dir = join(tmpdir(), `loopforge-mem-test-${randomUUID()}`);
+    mkdirSync(dir, { recursive: true });
+    return dir;
+}
+function seedMemoryFile(dir, name, body) {
+    const content = [
+        "---",
+        `name: ${name}`,
+        `description: Test memory about ${name}`,
+        "metadata:",
+        "  type: project",
+        "---",
+        "",
+        body,
+    ].join("\n");
+    writeFileSync(join(dir, `${name}.md`), content, "utf-8");
+}
+function makeProviderCtx(overrides) {
+    return {
+        loopId: "test-loop",
+        round: 1,
+        task: "Audit ERC20 token for reentrancy vulnerabilities",
+        domain: "solidity",
+        phase: 1,
+        progressEstimate: 0,
+        accumulatedContext: {
+            recurringIssues: [],
+            failedPatterns: [],
+            keyLessons: [],
+            remainingCriteria: [],
+        },
+        ...overrides,
+    };
+}
+function makeWritebackPayload(overrides) {
+    return {
+        loopId: "test-wb",
+        task: "Audit ERC20 token for reentrancy vulnerabilities",
+        outcome: "completed",
+        roundsCompleted: 5,
+        qualityTrajectory: [1, 3, 3, 5, 5],
+        projectEntry: {
+            title: "ERC20 Audit — completed",
+            objective: "Find and fix all reentrancy bugs in the ERC20 token contract",
+            keyOutcome: "Completed successfully in 5 rounds.",
+            keyDiscoveries: ["withdraw() has reentrancy via external call before state update"],
+            date: "2026-07-01",
+        },
+        feedbackEntries: [
+            {
+                rule: "zero-shot failed consistently on Solidity audit — rotate to ToT after 2 low rounds",
+                why: "Solidity audits need structured reasoning; zero-shot misses multi-step vulnerabilities",
+                howToApply: "For security audit tasks, start with CoT; if quality <3 for 2 rounds, switch to ToT",
+            },
+        ],
+        referenceEntry: {
+            description: "LoopForge vault data for ERC20 audit",
+            vaultLocation: ".promptcraft/prompt_vault.json → loop:test-wb:*",
+        },
+        ...overrides,
+    };
+}
+// ═══════════════════════════════════════════════════════════════════════════
+// Detection
+// ═══════════════════════════════════════════════════════════════════════════
+describe("computeProjectHash", () => {
+    it("replaces special chars with hyphens (Windows path)", () => {
+        const hash = computeProjectHash("C:\\Users\\Dell\\Desktop\\LoopForge");
+        assert.equal(hash, "C--Users-Dell-Desktop-LoopForge");
+    });
+    it("replaces special chars with hyphens (Unix path)", () => {
+        const hash = computeProjectHash("/home/user/my-project");
+        assert.equal(hash, "-home-user-my-project");
+    });
+    it("preserves alphanumeric characters", () => {
+        const hash = computeProjectHash("simple");
+        assert.equal(hash, "simple");
+    });
+    it("handles dots and hyphens in path", () => {
+        const hash = computeProjectHash("/home/user/.claude-mem/projects");
+        assert.ok(hash.includes("claude-mem"), `expected claude-mem in: ${hash}`);
+    });
+});
+describe("findGitRoot", () => {
+    it("returns a string when run inside a git repo", () => {
+        const root = findGitRoot();
+        assert.ok(root, "should find git root (test runs inside LoopForge repo)");
+        assert.ok(root.endsWith("LoopForge") || root.endsWith("loopforge"), `expected path ending with LoopForge, got: ${root}`);
+    });
+});
+describe("detectClaudeMem", () => {
+    it("returns memory directory for this project (claude-mem is active)", () => {
+        const detected = detectClaudeMem();
+        // This test runs inside LoopForge repo where claude-mem IS active
+        assert.ok(detected, "claude-mem should be detected for this project");
+        assert.ok(detected.memoryDir.endsWith("memory"), `expected memory dir, got: ${detected?.memoryDir}`);
+        assert.ok(detected.indexPath.endsWith("MEMORY.md"), `expected MEMORY.md, got: ${detected?.indexPath}`);
+        assert.ok(existsSync(detected.memoryDir));
+        assert.ok(existsSync(detected.indexPath));
+    });
+});
+// ═══════════════════════════════════════════════════════════════════════════
+// Retrieval
+// ═══════════════════════════════════════════════════════════════════════════
+describe("createMemoryProvider — retrieval", () => {
+    let memDir;
+    before(() => {
+        memDir = makeMemDir();
+        writeFileSync(join(memDir, "MEMORY.md"), "", "utf-8");
+    });
+    after(() => {
+        rmSync(memDir, { recursive: true, force: true });
+    });
+    it("returns empty string for empty memory directory", async () => {
+        const provider = createMemoryProvider(memDir);
+        const result = await provider(makeProviderCtx());
+        assert.equal(result, "");
+    });
+    it("returns empty string when no memories match the task", async () => {
+        seedMemoryFile(memDir, "unrelated", "# Python async patterns\n\nUse asyncio for IO-bound tasks.");
+        const provider = createMemoryProvider(memDir);
+        const result = await provider(makeProviderCtx({
+            task: "ERC20 token audit",
+        }));
+        assert.equal(result, "");
+    });
+    it("returns relevant memories when keywords match", async () => {
+        seedMemoryFile(memDir, "erc20-reentrancy", "# ERC20 Reentrancy Pattern\n\nAlways update state before external calls. The withdraw() function is especially vulnerable.");
+        const provider = createMemoryProvider(memDir);
+        const result = await provider(makeProviderCtx({
+            task: "Audit ERC20 token for reentrancy vulnerabilities",
+        }));
+        assert.ok(result.includes("Reentrancy"), `expected reentrancy context, got: "${result.slice(0, 100)}"`);
+        assert.ok(result.includes("withdraw"), `expected withdraw mention, got: "${result.slice(0, 100)}"`);
+    });
+    it("ranks memories by keyword match count", async () => {
+        // High-match file
+        seedMemoryFile(memDir, "high-match", "# ERC20 Audit Guide\n\nCheck reentrancy in ERC20 token. Audit all external calls.");
+        // Low-match file
+        seedMemoryFile(memDir, "low-match", "# General Notes\n\nSolidity contracts sometimes have issues.");
+        const provider = createMemoryProvider(memDir);
+        const result = await provider(makeProviderCtx({
+            task: "Audit ERC20 token for reentrancy vulnerabilities",
+        }));
+        // The high-match file should appear first (lower index) in the result
+        const highIdx = result.indexOf("ERC20 Audit Guide");
+        const lowIdx = result.indexOf("General Notes");
+        assert.ok(highIdx >= 0, "high-match file should be present");
+        assert.ok(lowIdx < 0 || highIdx < lowIdx, `high-match should appear before low-match, got high@${highIdx} low@${lowIdx}`);
+    });
+    it("Phase 2 query includes recurring issues and failed patterns", async () => {
+        seedMemoryFile(memDir, "phase2-test", "# Gas Optimization\n\nUnchecked arithmetic can save gas in Solidity 0.8+.");
+        const provider = createMemoryProvider(memDir);
+        const result = await provider(makeProviderCtx({
+            phase: 2,
+            progressEstimate: 0.35,
+            accumulatedContext: {
+                recurringIssues: ["gas optimization needed for loops"],
+                failedPatterns: ["unchecked arithmetic missing"],
+                keyLessons: [],
+                remainingCriteria: [],
+            },
+        }));
+        // Should find gas-related content because "optimization" and "arithmetic" are in query
+        assert.ok(result.length > 0, "Phase 2 query should match gas-related memory");
+    });
+    it("Phase 3 query includes remaining criteria and key lessons", async () => {
+        seedMemoryFile(memDir, "phase3-test", "# Access Control\n\nUse Ownable and RBAC for permission management.");
+        const provider = createMemoryProvider(memDir);
+        const result = await provider(makeProviderCtx({
+            phase: 3,
+            progressEstimate: 0.65,
+            task: "Audit smart contract",
+            accumulatedContext: {
+                recurringIssues: [],
+                failedPatterns: [],
+                keyLessons: ["access control is critical for upgradeable proxies"],
+                remainingCriteria: ["verify role-based access control"],
+            },
+        }));
+        assert.ok(result.length > 0, "Phase 3 query should match access control memory");
+    });
+    it("strips YAML frontmatter from returned content", async () => {
+        seedMemoryFile(memDir, "frontmatter-test", "# Keep This Content\n\nThis should be in the output.");
+        const provider = createMemoryProvider(memDir);
+        const result = await provider(makeProviderCtx({
+            task: "frontmatter Keep Content output",
+        }));
+        assert.ok(result.includes("Keep This Content"), "body content should be present");
+        assert.ok(!result.includes("name:"), "YAML frontmatter should be stripped");
+        assert.ok(!result.includes("metadata:"), "YAML metadata should be stripped");
+    });
+});
+// ═══════════════════════════════════════════════════════════════════════════
+// Writeback
+// ═══════════════════════════════════════════════════════════════════════════
+describe("createMemoryWriter — writeback", () => {
+    let memDir;
+    let indexPath;
+    before(() => {
+        memDir = makeMemDir();
+        indexPath = join(memDir, "MEMORY.md");
+        writeFileSync(indexPath, "", "utf-8");
+    });
+    after(() => {
+        rmSync(memDir, { recursive: true, force: true });
+    });
+    it("writes project entry file with correct frontmatter", async () => {
+        const writer = createMemoryWriter(memDir, indexPath);
+        const payload = makeWritebackPayload({ feedbackEntries: [], referenceEntry: undefined });
+        await writer(payload);
+        const files = readdirSync(memDir).filter(f => f.endsWith(".md") && f !== "MEMORY.md");
+        const projectFile = files.find(f => f.includes("outcome"));
+        assert.ok(projectFile, `expected project file in: ${files.join(", ")}`);
+        const content = readFileSync(join(memDir, projectFile), "utf-8");
+        assert.ok(content.includes("name: loopforge-test-wb-outcome"), "should have correct name in frontmatter");
+        assert.ok(content.includes("type: project"), "should have project type");
+        assert.ok(content.includes("ERC20 Audit"), "should contain task title");
+        assert.ok(content.includes("reentrancy"), "should contain discovery content");
+    });
+    it("writes feedback entries with rule + Why + How to apply", async () => {
+        const writer = createMemoryWriter(memDir, indexPath);
+        const payload = makeWritebackPayload();
+        await writer(payload);
+        const files = readdirSync(memDir).filter(f => f.endsWith(".md") && f !== "MEMORY.md");
+        const fbFile = files.find(f => f.includes("fb-1"));
+        assert.ok(fbFile, `expected feedback file in: ${files.join(", ")}`);
+        const content = readFileSync(join(memDir, fbFile), "utf-8");
+        assert.ok(content.includes("type: feedback"), "should have feedback type");
+        assert.ok(content.includes("**Why:**"), "should have Why section");
+        assert.ok(content.includes("**How to apply:**"), "should have How to apply section");
+        assert.ok(content.includes("zero-shot failed"), "should contain feedback rule");
+    });
+    it("writes reference entry", async () => {
+        const writer = createMemoryWriter(memDir, indexPath);
+        const payload = makeWritebackPayload({ feedbackEntries: [] });
+        await writer(payload);
+        const files = readdirSync(memDir).filter(f => f.endsWith(".md") && f !== "MEMORY.md");
+        const refFile = files.find(f => f.includes("-ref"));
+        assert.ok(refFile, `expected reference file in: ${files.join(", ")}`);
+        const content = readFileSync(join(memDir, refFile), "utf-8");
+        assert.ok(content.includes("type: reference"), "should have reference type");
+        assert.ok(content.includes("Vault Location"), "should contain vault location");
+    });
+    it("appends entries to MEMORY.md index", async () => {
+        const writer = createMemoryWriter(memDir, indexPath);
+        const payload = makeWritebackPayload();
+        await writer(payload);
+        const index = readFileSync(indexPath, "utf-8");
+        assert.ok(index.includes(`[LoopForge: ${payload.task.slice(0, 60)}]`), "index should link to project entry");
+        assert.ok(index.includes("LoopForge Feedback"), "index should link to feedback entries");
+        assert.ok(index.includes("LoopForge Reference"), "index should link to reference entry");
+    });
+    it("does not write duplicate project files (each write creates uniquely named files)", async () => {
+        const writer = createMemoryWriter(memDir, indexPath);
+        const payload1 = makeWritebackPayload({ loopId: "write-1" });
+        const payload2 = makeWritebackPayload({ loopId: "write-2" });
+        await writer(payload1);
+        await writer(payload2);
+        const files = readdirSync(memDir).filter(f => f !== "MEMORY.md");
+        const outcomeFiles = files.filter(f => f.includes("-outcome.md") && (f.includes("write-1") || f.includes("write-2")));
+        assert.equal(outcomeFiles.length, 2, "should have 2 distinct outcome files");
+    });
+    it("handles empty feedback entries gracefully", async () => {
+        const writer = createMemoryWriter(memDir, indexPath);
+        const payload = makeWritebackPayload({
+            loopId: "no-fb",
+            feedbackEntries: [],
+        });
+        await writer(payload);
+        const files = readdirSync(memDir).filter(f => f !== "MEMORY.md");
+        const fbFiles = files.filter(f => /-fb-\d+\.md$/.test(f) && f.includes("no-fb"));
+        assert.equal(fbFiles.length, 0, "should not create feedback files when empty");
+    });
+});
+// ═══════════════════════════════════════════════════════════════════════════
+// Integration entry points
+// ═══════════════════════════════════════════════════════════════════════════
+describe("autoConfigureMemory", () => {
+    it("sets memoryProvider and memoryWriter on SessionManager when detected", () => {
+        // In this test environment, claude-mem IS active (we're in LoopForge repo)
+        const mgr = new SessionManager();
+        assert.equal(mgr.memoryProvider, undefined, "should start with no provider");
+        assert.equal(mgr.memoryWriter, undefined, "should start with no writer");
+        autoConfigureMemory(mgr);
+        // Since we're in a git repo with claude-mem active, it should detect
+        const detected = detectClaudeMem();
+        if (detected) {
+            assert.ok(mgr.memoryProvider, "provider should be set when claude-mem detected");
+            assert.ok(mgr.memoryWriter, "writer should be set when claude-mem detected");
+        }
+        else {
+            // Outside git or claude-mem not active — still no provider (graceful degradation)
+            assert.equal(mgr.memoryProvider, undefined);
+            assert.equal(mgr.memoryWriter, undefined);
+        }
+    });
+});
+describe("tryAutoConfigure", () => {
+    it("returns provider and writer when claude-mem is detected", () => {
+        const result = tryAutoConfigure();
+        const detected = detectClaudeMem();
+        if (detected) {
+            assert.ok(result.memoryProvider, "should return provider when detected");
+            assert.ok(result.memoryWriter, "should return writer when detected");
+        }
+        else {
+            assert.equal(result.memoryProvider, undefined);
+            assert.equal(result.memoryWriter, undefined);
+        }
+    });
+    it("returned provider works (integration smoke test)", async () => {
+        const result = tryAutoConfigure();
+        if (!result.memoryProvider)
+            return; // skip if claude-mem not active
+        const ctx = makeProviderCtx();
+        const context = await result.memoryProvider(ctx);
+        // May be empty if no matching memories, but should not throw
+        assert.equal(typeof context, "string");
+    });
+});
+// ═══════════════════════════════════════════════════════════════════════════
+// Edge cases
+// ═══════════════════════════════════════════════════════════════════════════
+describe("Memory bridge edge cases", () => {
+    it("createMemoryProvider handles missing directory gracefully", async () => {
+        const provider = createMemoryProvider("/nonexistent/path/memory");
+        const result = await provider(makeProviderCtx());
+        assert.equal(result, "");
+    });
+    it("createMemoryProvider handles files without frontmatter", async () => {
+        const memDir = makeMemDir();
+        try {
+            writeFileSync(join(memDir, "MEMORY.md"), "", "utf-8");
+            writeFileSync(join(memDir, "plain.md"), "# No Frontmatter\n\nJust plain markdown content.", "utf-8");
+            const provider = createMemoryProvider(memDir);
+            const result = await provider(makeProviderCtx({ task: "plain markdown content frontmatter" }));
+            assert.ok(result.includes("No Frontmatter"), "should handle files without YAML frontmatter");
+        }
+        finally {
+            rmSync(memDir, { recursive: true, force: true });
+        }
+    });
+    it("createMemoryWriter handles concurrent lock gracefully (non-blocking)", async () => {
+        const memDir = makeMemDir();
+        const indexPath = join(memDir, "MEMORY.md");
+        writeFileSync(indexPath, "", "utf-8");
+        // Manually create the lock directory to simulate contention
+        const lockDir = join(memDir, ".loopforge-wb.lock");
+        mkdirSync(lockDir);
+        try {
+            const writer = createMemoryWriter(memDir, indexPath);
+            const payload = makeWritebackPayload({ loopId: "locked-test" });
+            // Should not throw — just skip quietly
+            await writer(payload);
+            // No files should be written since lock was held
+            const mdFiles = readdirSync(memDir).filter(f => f.endsWith(".md") && f !== "MEMORY.md");
+            assert.equal(mdFiles.length, 0, "should not write files when lock is held");
+        }
+        finally {
+            rmSync(lockDir, { recursive: true, force: true });
+            rmSync(memDir, { recursive: true, force: true });
+        }
+    });
+});
+//# sourceMappingURL=memory-bridge.test.js.map

package/dist/tests/memory-bridge.test.js.map

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

package/dist/tests/protocol.test.js

@@ -1,7 +1,7 @@
 /** Tests for protocol type factories and serialisation. */
 import { describe, it } from "node:test";
 import assert from "node:assert/strict";
-import { Mode, AgentStatus, Technique, makeAnalysis, makeVaultConfig, makeLoopCompileRequest, makeLoopCompileResponse, makeTaskId, } from "../protocol.js";
+import { Mode, AgentStatus, Technique, makeAnalysis, makeVaultConfig, makeLoopCompileRequest, makeLoopCompileResponse, makeTaskId, makeSelfEvaluation, } from "../protocol.js";
 describe("Protocol — Enums", () => {
     it("Mode has 2 values", () => {
         assert.equal(Object.values(Mode).length, 2);
@@ -57,5 +57,16 @@ describe("Protocol — Factory functions", () => {
         assert.equal(makeTaskId("Audit ERC20 token"), "audit-erc20-token");
         assert.equal(makeTaskId(""), "unnamed-task");
     });
+    it("makeSelfEvaluation includes worker_results default", () => {
+        const se = makeSelfEvaluation();
+        assert.deepEqual(se.worker_results, []);
+    });
+    it("makeSelfEvaluation accepts worker_results override", () => {
+        const wr = [{ agentId: "abc", subAgentType: "explore", subTask: "search", resultSummary: "found 3 bugs", success: true }];
+        const se = makeSelfEvaluation({ worker_results: wr });
+        assert.equal(se.worker_results.length, 1);
+        assert.equal(se.worker_results[0].agentId, "abc");
+        assert.equal(se.worker_results[0].success, true);
+    });
 });
 //# sourceMappingURL=protocol.test.js.map

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

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

package/loop_policy.json

@@ -55,5 +55,28 @@
     "progress_stall_threshold": 0.05,
     "progress_stall_rounds": 2,
     "progress_mismatch_threshold": 0.3
+  },
+  "memory_injection": {
+    "enabled": true,
+    "min_rounds_between_injections": 1,
+    "phase_thresholds": {
+      "phase1": { "trigger": "round_1" },
+      "phase2": { "trigger": "progress", "threshold": 0.40 },
+      "phase3": { "trigger": "progress", "threshold": 0.70 }
+    },
+    "round_tiers": [
+      { "max_rounds": 10, "allowed_phases": [1] },
+      { "max_rounds": 20, "allowed_phases": [1, 3] },
+      { "max_rounds": 30, "allowed_phases": [1, 2, 3] }
+    ],
+    "dedup_threshold": 0.6,
+    "max_context_length": 2000,
+    "section_title": "### Background Context (Long-Term Memory)"
+  },
+  "memory_writeback": {
+    "enabled": true,
+    "max_feedback_entries": 5,
+    "max_discoveries_in_project": 3,
+    "write_on_outcomes": ["completed", "circuit_breaker", "max_rounds"]
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "loopforge",
-  "version": "1.7.0",
+  "version": "1.8.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",

package/skills/perception/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: perception
-description: Multi-round autonomous loop driver powered by LoopForge MCP. Compiles context-aware prompts per iteration, tracks quality, inherits constraints, and stops when work is done — not when rounds run out.
+description: Multi-round autonomous loop driver powered by LoopForge MCP. Compiles context-aware prompts per iteration, tracks quality, inherits constraints, and stops when work is done — not when rounds run out. Supports single-agent and multi-agent (AgentTool / Coordinator) scenarios.
 ---
 
 # Perception — Loop-Time Intelligence Skill
@@ -13,6 +13,11 @@ detection — maintaining cognitive stability across long-horizon loops.
 Works with Claude Code, Codex, and any MCP-capable host. Zero configuration
 beyond having `loopforge-mcp` registered as an MCP server.
 
+**Multi-Agent:** When you spawn sub-agents (AgentTool) or orchestrate Workers
+(Coordinator mode), LoopForge tracks delegation history, inherits constraints
+across Workers, and injects structured summaries into subsequent prompts.
+No separate mode required — LoopForge treats all agents the same.
+
 ## When to Activate
 
 Activate when the user says any of:
@@ -107,6 +112,7 @@ is preferred — it's validated by the MCP client before reaching the server.
 | `retracted_constraints` | string[] | **P5 (optional)** — Constraints you now believe are wrong. Removed from active guardrails. Only retract with evidence. Empty `[]` if none. |
 | `revised_success_criteria` | object[] | **P5 (optional)** — Success criteria that need reformulation. Array of `{old: string, new: string}`. Applied to Loop Objective. Empty `[]` if none. |
 | `wrong_assumptions` | string[] | **P5 (optional)** — Assumptions from earlier rounds that turned out to be incorrect. Recorded as key lessons. Empty `[]` if none. |
+| `worker_results` | object[] | **Multi-Agent (optional)** — Results of sub-agent / Worker delegations this round. Each entry: `{ agentId, subAgentType, subTask, resultSummary, success, discoveredConstraints? }`. Engine auto-records to delegation journal. Empty `[]` if no delegations. |
 
 **Why this matters:** The evaluation is validated by the MCP client before
 reaching the server — a missing or malformed evaluation causes an immediate
@@ -146,6 +152,51 @@ If the result has a non-null `prompt`, execute it and repeat from Step 2.
 | `loopforge_resume` | Resume a loop after process restart | `loopId` | next `prompt` or `null` + `stopReason` |
 | `loopforge_health` | Check loop health mid-run | `loopId` | goal alignment, constraint integrity, drift, strategy |
 
+## Delegation Helpers (AgentTool Mode)
+
+When you spawn sub-agents via `AgentTool` (Explore, General-purpose, Plan)
+during a loop round, use these helpers to improve delegation quality:
+
+**Before delegating:**
+1. **Filter constraints** — not all active constraints apply to every sub-agent.
+   An Explore agent searching for deprecated APIs doesn't need "all files must
+   have a license header." Use `filterConstraintsForSubTask(allConstraints, subTask)`
+   to get only the relevant subset.
+2. **Format the prompt** — use `formatDelegationPrompt(subTask, subAgentType,
+   relevantConstraints, options?)` to produce a self-contained prompt. This is
+   critical: sub-agents cannot see your conversation. Every prompt must stand
+   alone — no "based on above," no "continue from previous."
+
+**After delegating (in your self-evaluation):**
+Include `worker_results` in your evaluation to record what you delegated.
+The engine auto-detects this field and writes delegation journals to the vault:
+
+```json
+{
+  "worker_results": [
+    {
+      "agentId": "abc123",
+      "subAgentType": "explore",
+      "subTask": "Search for deprecated API usage in src/",
+      "resultSummary": "Found 12 deprecated calls across 8 files",
+      "success": true,
+      "discoveredConstraints": ["All API calls must be versioned"]
+    }
+  ]
+}
+```
+
+This feeds into the delegation history table displayed in future rounds.
+Constraints discovered by sub-agents flow into the active constraint set
+automatically — they appear in future prompts alongside main-agent constraints.
+Delegation recording is lightweight — it's the main agent's memory,
+not sub-agent memory.
+
+**Important:** These helpers are optional. If your sub-task is trivial (e.g.
+"read file X and report line 42"), a raw prompt is fine. Use the helpers when
+sub-tasks involve constraints, specific output formats, or results worth
+remembering across rounds.
+
 ## Quality Signals (Read the Room)
 
 The prompt changes between rounds based on your trajectory. Pay attention to:

package/dist/adapter.d.ts

@@ -1,17 +0,0 @@
-/** LoopForge-loop_compile — Sub-agent adapter (unified entry point).
- *
- * This is the single entry point when LoopForge is invoked as a sub-agent.
- * It wraps the Engine, routes by mode, and always prepends a compact health line.
- *
- * Three modes (v1.0):
- *     loop_compile — Per-iteration prompt compiler (primary entry point)
- *     feedback     — Record execution results → quality scoring → vault persistence
- *     review       — Audit prompt quality (structural checks + constraint compliance)
- *
- * build is an internal path (loop_compile L2 delegation) — not an exposed mode.
- */
-import { type LoopForgeRequest } from "./protocol.js";
-import { LoopForgeEngine } from "./engine.js";
-export declare function handle(requestInput: string | Record<string, unknown> | LoopForgeRequest, engine?: LoopForgeEngine): string;
-export declare function main(): void;
-//# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAKL,KAAK,gBAAgB,EACtB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,eAAe,EAGhB,MAAM,aAAa,CAAC;AAiBrB,wBAAgB,MAAM,CACpB,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB,EACjE,MAAM,CAAC,EAAE,eAAe,GACvB,MAAM,CAwER;AAsJD,wBAAgB,IAAI,IAAI,IAAI,CA8B3B"}