loopforge 1.3.1 → 1.8.0

package/dist/memory-bridge.js

@@ -0,0 +1,290 @@
+/** LoopForge — Memory Bridge (v1.8).
+ *
+ *  Zero-config auto-detection bridge between LoopForge and claude-mem.
+ *  Detects claude-mem via the local filesystem, provides memoryProvider
+ *  (file-based retrieval) and memoryWriter (Markdown file writeback).
+ *
+ *  Two integration paths:
+ *    MCP:  autoConfigureMemory(sessionMgr) — sets provider/writer on SessionManager
+ *    Lib:  tryAutoConfigure() → { memoryProvider?, memoryWriter? } — for resolveConfig()
+ *
+ *  If claude-mem is not installed or the project has no memory directory,
+ *  both functions return without side effects — silent graceful degradation.
+ */
+import { homedir } from "node:os";
+import { join, dirname } from "node:path";
+import { existsSync, readdirSync, readFileSync, mkdirSync, writeFileSync, appendFileSync, rmSync, } from "node:fs";
+// ═══════════════════════════════════════════════════════════════════════════
+// Detection
+// ═══════════════════════════════════════════════════════════════════════════
+/** Compute the project directory name the same way claude-mem does:
+ *  replace every non-alphanumeric character with `-`.
+ *  e.g. `C:\Users\Dell\Desktop\LoopForge` → `C--Users-Dell-Desktop-LoopForge` */
+export function computeProjectHash(gitRoot) {
+    return gitRoot.replace(/[^a-zA-Z0-9]/g, "-");
+}
+/** Walk upward from cwd looking for a `.git` directory.
+ *  Returns the git root path, or null if not found within 20 levels. */
+export function findGitRoot() {
+    let dir = process.cwd();
+    for (let i = 0; i < 20; i++) {
+        if (existsSync(join(dir, ".git")))
+            return dir;
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return null;
+}
+/** Check whether claude-mem has a memory directory for the current project.
+ *  Returns the memory directory path and MEMORY.md path, or null. */
+export function detectClaudeMem() {
+    const gitRoot = findGitRoot();
+    if (!gitRoot)
+        return null;
+    const hash = computeProjectHash(gitRoot);
+    const memoryDir = join(homedir(), ".claude", "projects", hash, "memory");
+    const indexPath = join(memoryDir, "MEMORY.md");
+    if (!existsSync(memoryDir) || !existsSync(indexPath))
+        return null;
+    return { memoryDir, indexPath };
+}
+// ═══════════════════════════════════════════════════════════════════════════
+// Retrieval
+// ═══════════════════════════════════════════════════════════════════════════
+/** Split text into lowercase words ≥4 chars for keyword matching. */
+function keywords(text) {
+    return text
+        .toLowerCase()
+        .split(/[^a-z0-9]+/)
+        .filter((w) => w.length >= 4);
+}
+/** Build a phase-aware set of query terms from the provider context.
+ *  Phase 1: task terms only (initial anchoring).
+ *  Phase 2: task + recurring issues + failed patterns (mid-loop breakout).
+ *  Phase 3: task + remaining criteria + key lessons (late-stage edge cases). */
+function buildQueryTerms(ctx) {
+    const terms = new Set();
+    for (const w of keywords(ctx.task))
+        terms.add(w);
+    if (ctx.domain)
+        for (const w of keywords(ctx.domain))
+            terms.add(w);
+    if (ctx.phase === 2) {
+        for (const issue of ctx.accumulatedContext.recurringIssues) {
+            for (const w of keywords(issue))
+                terms.add(w);
+        }
+        for (const pat of ctx.accumulatedContext.failedPatterns) {
+            for (const w of keywords(pat))
+                terms.add(w);
+        }
+    }
+    else if (ctx.phase === 3) {
+        for (const crit of ctx.accumulatedContext.remainingCriteria) {
+            for (const w of keywords(crit))
+                terms.add(w);
+        }
+        for (const lesson of ctx.accumulatedContext.keyLessons) {
+            for (const w of keywords(lesson))
+                terms.add(w);
+        }
+    }
+    return [...terms];
+}
+/** Strip YAML frontmatter (--- ... ---) from a markdown file and return the body. */
+function stripFrontmatter(md) {
+    const match = md.match(/^---\r?\n[\s\S]*?\r?\n---\r?\n/);
+    if (!match)
+        return md;
+    return md.slice(match[0].length).trim();
+}
+/** Scan all .md memory files (excluding MEMORY.md) and return the top-N
+ *  most relevant memories concatenated, scored by keyword overlap. */
+function retrieveFromFiles(memoryDir, queryTerms, maxFiles, maxCharsPerFile) {
+    let files;
+    try {
+        files = readdirSync(memoryDir).filter((f) => f.endsWith(".md") && f !== "MEMORY.md");
+    }
+    catch {
+        return "";
+    }
+    if (files.length === 0 || queryTerms.length === 0)
+        return "";
+    const scored = [];
+    for (const file of files) {
+        let content;
+        try {
+            content = readFileSync(join(memoryDir, file), "utf-8");
+        }
+        catch {
+            continue;
+        }
+        const lower = content.toLowerCase();
+        let score = 0;
+        for (const term of queryTerms) {
+            if (lower.includes(term))
+                score++;
+        }
+        if (score > 0) {
+            scored.push({ body: stripFrontmatter(content), score });
+        }
+    }
+    if (scored.length === 0)
+        return "";
+    scored.sort((a, b) => b.score - a.score);
+    return scored
+        .slice(0, maxFiles)
+        .map((s) => s.body.slice(0, maxCharsPerFile))
+        .join("\n\n---\n\n");
+}
+/** Create a memoryProvider callback bound to a specific memory directory.
+ *  Reads .md files directly — no REST API dependency. */
+export function createMemoryProvider(memoryDir) {
+    return async (ctx) => {
+        const queryTerms = buildQueryTerms(ctx);
+        return retrieveFromFiles(memoryDir, queryTerms, 3, 600);
+    };
+}
+// ═══════════════════════════════════════════════════════════════════════════
+// Writeback
+// ═══════════════════════════════════════════════════════════════════════════
+const LOCK_RETRY_MS = 50;
+/** Minimal mkdir-based mutex for safguarding MEMORY.md writes.
+ *  Non-blocking: returns true if lock was acquired, false if held by another process. */
+function acquireLock(lockDir) {
+    try {
+        mkdirSync(lockDir);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function releaseLock(lockDir) {
+    try {
+        rmSync(lockDir, { recursive: true });
+    }
+    catch {
+        // lock dir already removed — ignore
+    }
+}
+/** Write a single .md memory file with claude-mem-compatible YAML frontmatter. */
+function writeMemoryFile(memoryDir, name, description, memType, body) {
+    const filename = `${name}.md`;
+    const frontmatter = [
+        "---",
+        `name: ${name}`,
+        `description: ${description.slice(0, 100)}`,
+        "metadata:",
+        `  type: ${memType}`,
+        "---",
+        "",
+    ].join("\n");
+    writeFileSync(join(memoryDir, filename), frontmatter + body, "utf-8");
+    return filename;
+}
+/** Create a memoryWriter callback bound to a specific memory directory.
+ *  Writes .md files directly + appends to MEMORY.md index. */
+export function createMemoryWriter(memoryDir, indexPath) {
+    return async (payload) => {
+        const lockDir = join(memoryDir, ".loopforge-wb.lock");
+        // Non-blocking lock acquire — skip if claude-mem is writing concurrently
+        for (let attempt = 0; attempt < 3; attempt++) {
+            if (acquireLock(lockDir))
+                break;
+            if (attempt === 2)
+                return; // could not acquire after 3 attempts — skip
+            await new Promise((r) => setTimeout(r, LOCK_RETRY_MS));
+        }
+        try {
+            const date = new Date().toISOString().split("T")[0];
+            const indexLines = [];
+            // 1. Project entry
+            const projectName = `loopforge-${payload.loopId}-outcome`;
+            const projectBody = [
+                `# ${payload.projectEntry.title}`,
+                "",
+                `**Outcome**: ${payload.projectEntry.keyOutcome}`,
+                `**Date**: ${date}`,
+                `**Rounds**: ${payload.roundsCompleted}`,
+                `**Quality Trajectory**: [${payload.qualityTrajectory.join(", ")}]`,
+                "",
+                payload.projectEntry.objective
+                    ? `**Objective**: ${payload.projectEntry.objective}\n`
+                    : "",
+                payload.projectEntry.keyDiscoveries.length > 0
+                    ? [
+                        "**Key Discoveries**:",
+                        ...payload.projectEntry.keyDiscoveries.map((d) => `- ${d}`),
+                        "",
+                    ].join("\n")
+                    : "",
+            ]
+                .filter(Boolean)
+                .join("\n");
+            const projectFile = writeMemoryFile(memoryDir, projectName, payload.projectEntry.title.slice(0, 100), "project", projectBody);
+            indexLines.push(`- [LoopForge: ${payload.task.slice(0, 60)}](${projectFile}) — ${payload.outcome} (${date})`);
+            // 2. Feedback entries
+            for (let i = 0; i < payload.feedbackEntries.length; i++) {
+                const fb = payload.feedbackEntries[i];
+                const fbName = `loopforge-${payload.loopId}-fb-${i + 1}`;
+                const fbBody = [
+                    `# ${fb.rule}`,
+                    "",
+                    `**Why:** ${fb.why}`,
+                    "",
+                    `**How to apply:** ${fb.howToApply}`,
+                    "",
+                ].join("\n");
+                const fbFile = writeMemoryFile(memoryDir, fbName, fb.rule.slice(0, 100), "feedback", fbBody);
+                indexLines.push(`- [LoopForge Feedback](${fbFile}) — ${payload.outcome} (${date})`);
+            }
+            // 3. Reference entry
+            if (payload.referenceEntry) {
+                const refName = `loopforge-${payload.loopId}-ref`;
+                const refBody = [
+                    `# ${payload.referenceEntry.description}`,
+                    "",
+                    `**Vault Location**: ${payload.referenceEntry.vaultLocation}`,
+                    "",
+                ].join("\n");
+                const refFile = writeMemoryFile(memoryDir, refName, payload.referenceEntry.description.slice(0, 100), "reference", refBody);
+                indexLines.push(`- [LoopForge Reference](${refFile}) — ${payload.outcome} (${date})`);
+            }
+            // 4. Append to MEMORY.md index
+            appendFileSync(indexPath, indexLines.join("\n") + "\n", "utf-8");
+        }
+        finally {
+            releaseLock(lockDir);
+        }
+    };
+}
+// ═══════════════════════════════════════════════════════════════════════════
+// Integration entry points
+// ═══════════════════════════════════════════════════════════════════════════
+/** Auto-detect claude-mem and wire memoryProvider / memoryWriter onto a
+ *  SessionManager instance. Called once at MCP server startup.
+ *  If claude-mem is not available, this is a no-op. */
+export function autoConfigureMemory(mgr) {
+    const detected = detectClaudeMem();
+    if (!detected)
+        return;
+    mgr.memoryProvider = createMemoryProvider(detected.memoryDir);
+    mgr.memoryWriter = createMemoryWriter(detected.memoryDir, detected.indexPath);
+}
+/** Auto-detect claude-mem and return provider/writer callbacks.
+ *  Used by the runtime library path (resolveConfig). Callers should
+ *  only invoke this when the user has NOT provided explicit callbacks —
+ *  explicit callbacks always take precedence. */
+export function tryAutoConfigure() {
+    const detected = detectClaudeMem();
+    if (!detected)
+        return {};
+    return {
+        memoryProvider: createMemoryProvider(detected.memoryDir),
+        memoryWriter: createMemoryWriter(detected.memoryDir, detected.indexPath),
+    };
+}
+//# sourceMappingURL=memory-bridge.js.map

package/dist/memory-bridge.js.map

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

package/dist/observability.d.ts

@@ -0,0 +1,23 @@
+/** LoopForge — Structured event logging (v1.7).
+ *
+ *  JSON-line events to stderr for key lifecycle moments.
+ *  Gated behind process.env.LOOPFORGE_LOG — silent by default.
+ *
+ *  Events:
+ *    round_complete   — engine/runtime after feedback processed
+ *    circuit_breaker  — shouldBreak() returns true
+ *    gate_contradicted — verification gate returns contradicted verdict
+ *    strategy_rotated — adaptive technique routing rotates
+ *    vault_write_error — any catch in vault write paths
+ *    session_start / session_end — MCP session lifecycle
+ *
+ *  Usage:
+ *    LOOPFORGE_LOG=1 npm test
+ *    LOOPFORGE_LOG=1 node my_script.js 2>&1 | grep '\[loopforge\]'
+ */
+export interface LogEventData {
+    [key: string]: unknown;
+}
+/** Emit a structured JSON event to stderr when LOOPFORGE_LOG is set. */
+export declare function logEvent(event: string, data?: LogEventData): void;
+//# sourceMappingURL=observability.d.ts.map

package/dist/observability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability.d.ts","sourceRoot":"","sources":["../src/observability.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,WAAW,YAAY;IAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,wEAAwE;AACxE,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,YAAiB,GAAG,IAAI,CAQrE"}

package/dist/observability.js

@@ -0,0 +1,29 @@
+/** LoopForge — Structured event logging (v1.7).
+ *
+ *  JSON-line events to stderr for key lifecycle moments.
+ *  Gated behind process.env.LOOPFORGE_LOG — silent by default.
+ *
+ *  Events:
+ *    round_complete   — engine/runtime after feedback processed
+ *    circuit_breaker  — shouldBreak() returns true
+ *    gate_contradicted — verification gate returns contradicted verdict
+ *    strategy_rotated — adaptive technique routing rotates
+ *    vault_write_error — any catch in vault write paths
+ *    session_start / session_end — MCP session lifecycle
+ *
+ *  Usage:
+ *    LOOPFORGE_LOG=1 npm test
+ *    LOOPFORGE_LOG=1 node my_script.js 2>&1 | grep '\[loopforge\]'
+ */
+/** Emit a structured JSON event to stderr when LOOPFORGE_LOG is set. */
+export function logEvent(event, data = {}) {
+    if (!process.env.LOOPFORGE_LOG)
+        return;
+    const record = {
+        ts: new Date().toISOString(),
+        event,
+        ...data,
+    };
+    process.stderr.write(`[loopforge] ${JSON.stringify(record)}\n`);
+}
+//# sourceMappingURL=observability.js.map

package/dist/observability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability.js","sourceRoot":"","sources":["../src/observability.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH,wEAAwE;AACxE,MAAM,UAAU,QAAQ,CAAC,KAAa,EAAE,OAAqB,EAAE;IAC7D,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa;QAAE,OAAO;IACvC,MAAM,MAAM,GAAG;QACb,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QAC5B,KAAK;QACL,GAAG,IAAI;KACR,CAAC;IACF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAClE,CAAC"}

package/dist/policy.d.ts

@@ -35,6 +35,75 @@ export interface BackendPolicy {
     vault_path: string;
     global_vault_path: string;
 }
+export interface EvolutionPolicy {
+    /** P0: Max new constraints the agent can discover per round. */
+    max_discovered_constraints_per_round: number;
+    /** P0: Hard upper bound on total active constraints. */
+    max_active_constraints: number;
+    /** P1: Max versions of the loop objective to retain in history. */
+    max_objective_versions: number;
+    /** P4: Minimum progress delta to not be considered stalled. */
+    progress_stall_threshold: number;
+    /** P4: Consecutive rounds below stall threshold before warning. */
+    progress_stall_rounds: number;
+    /** P4: Max allowed difference between objective and subjective progress. */
+    progress_mismatch_threshold: number;
+}
+/** A tier in the round-based injection strategy.
+ *  Each tier defines how many and which injection phases are allowed
+ *  based on the loop's maxRounds. */
+export interface MemoryInjectionTier {
+    /** Upper bound of maxRounds for this tier (inclusive). */
+    max_rounds: number;
+    /** Which phases are allowed in this tier: [1], [1,3], or [1,2,3]. */
+    allowed_phases: number[];
+}
+export interface MemoryInjectionPolicy {
+    /** Master toggle for memory injection. */
+    enabled: boolean;
+    /** Minimum rounds between two consecutive injections. */
+    min_rounds_between_injections: number;
+    /** Phase trigger configuration. */
+    phase_thresholds: {
+        phase1: {
+            trigger: "round_1";
+        };
+        phase2: {
+            trigger: "progress";
+            threshold: number;
+        };
+        phase3: {
+            trigger: "progress";
+            threshold: number;
+        };
+    };
+    /** Round-based tiered injection strategy. Each tier defines which phases
+     *  are allowed based on maxRounds. The first matching tier wins.
+     *  Tiers should be ordered by max_rounds ascending. */
+    round_tiers: MemoryInjectionTier[];
+    /** Jaccard similarity threshold above which a new context is considered
+     *  duplicate and skipped. */
+    dedup_threshold: number;
+    /** Maximum characters of memory context to inject (truncated if longer). */
+    max_context_length: number;
+    /** Section header for the injected context block in the L2 prompt. */
+    section_title: string;
+}
+/** Resolve which injection phases are allowed for a given maxRounds.
+ *  Uses the tiered strategy: finds the first tier where maxRounds ≤ tier.max_rounds,
+ *  and returns its allowed_phases. If maxRounds exceeds all tiers, returns the
+ *  last tier's phases. */
+export declare function resolveAllowedPhases(maxRounds: number, tiers: MemoryInjectionTier[]): number[];
+export interface MemoryWritebackPolicy {
+    /** Master toggle for memory writeback on loop end. */
+    enabled: boolean;
+    /** Maximum number of feedback entries to write back. */
+    max_feedback_entries: number;
+    /** Maximum number of discoveries in the project entry. */
+    max_discoveries_in_project: number;
+    /** Only write back for these stop reasons. */
+    write_on_outcomes: string[];
+}
 export interface LoopPolicy {
     version: string;
     constraints: ConstraintsPolicy;
@@ -44,6 +113,9 @@ export interface LoopPolicy {
     engine: EnginePolicy;
     runtime: RuntimePolicy;
     backend: BackendPolicy;
+    evolution: EvolutionPolicy;
+    memory_injection: MemoryInjectionPolicy;
+    memory_writeback: MemoryWritebackPolicy;
 }
 export declare const DEFAULT_POLICY: LoopPolicy;
 export declare function loadPolicy(path?: string): LoopPolicy;

package/dist/policy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../src/policy.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,EAAE,CAAC;IACb,EAAE,EAAE,MAAM,EAAE,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,0BAA0B,EAAE,MAAM,CAAC;IACnC,2BAA2B,EAAE,MAAM,CAAC;IACpC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,YAAY;IAC3B,uBAAuB,EAAE,MAAM,CAAC;IAChC,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IAEnB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,iBAAiB,CAAC;IAC/B,OAAO,EAAE,aAAa,CAAC;IACvB,kBAAkB,EAAE,uBAAuB,CAAC;IAC5C,SAAS,EAAE,eAAe,CAAC;IAC3B,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,EAAE,aAAa,CAAC;IACvB,OAAO,EAAE,aAAa,CAAC;CACxB;AAMD,eAAO,MAAM,cAAc,EAAE,UAuD5B,CAAC;AAmCF,wBAAgB,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,CAmBpD;AAQD,wBAAgB,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,CAKnD;AAED,wBAAgB,WAAW,IAAI,IAAI,CAElC"}
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../src/policy.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,EAAE,CAAC;IACb,EAAE,EAAE,MAAM,EAAE,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,0BAA0B,EAAE,MAAM,CAAC;IACnC,2BAA2B,EAAE,MAAM,CAAC;IACpC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,YAAY;IAC3B,uBAAuB,EAAE,MAAM,CAAC;IAChC,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IAEnB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,gEAAgE;IAChE,oCAAoC,EAAE,MAAM,CAAC;IAC7C,wDAAwD;IACxD,sBAAsB,EAAE,MAAM,CAAC;IAC/B,mEAAmE;IACnE,sBAAsB,EAAE,MAAM,CAAC;IAC/B,+DAA+D;IAC/D,wBAAwB,EAAE,MAAM,CAAC;IACjC,mEAAmE;IACnE,qBAAqB,EAAE,MAAM,CAAC;IAC9B,4EAA4E;IAC5E,2BAA2B,EAAE,MAAM,CAAC;CACrC;AAED;;qCAEqC;AACrC,MAAM,WAAW,mBAAmB;IAClC,0DAA0D;IAC1D,UAAU,EAAE,MAAM,CAAC;IACnB,qEAAqE;IACrE,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,qBAAqB;IACpC,0CAA0C;IAC1C,OAAO,EAAE,OAAO,CAAC;IACjB,yDAAyD;IACzD,6BAA6B,EAAE,MAAM,CAAC;IACtC,mCAAmC;IACnC,gBAAgB,EAAE;QAChB,MAAM,EAAE;YAAE,OAAO,EAAE,SAAS,CAAA;SAAE,CAAC;QAC/B,MAAM,EAAE;YAAE,OAAO,EAAE,UAAU,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAC;QACnD,MAAM,EAAE;YAAE,OAAO,EAAE,UAAU,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAC;KACpD,CAAC;IACF;;2DAEuD;IACvD,WAAW,EAAE,mBAAmB,EAAE,CAAC;IACnC;iCAC6B;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,4EAA4E;IAC5E,kBAAkB,EAAE,MAAM,CAAC;IAC3B,sEAAsE;IACtE,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;0BAG0B;AAC1B,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,mBAAmB,EAAE,GAC3B,MAAM,EAAE,CAMV;AAED,MAAM,WAAW,qBAAqB;IACpC,sDAAsD;IACtD,OAAO,EAAE,OAAO,CAAC;IACjB,wDAAwD;IACxD,oBAAoB,EAAE,MAAM,CAAC;IAC7B,0DAA0D;IAC1D,0BAA0B,EAAE,MAAM,CAAC;IACnC,8CAA8C;IAC9C,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,iBAAiB,CAAC;IAC/B,OAAO,EAAE,aAAa,CAAC;IACvB,kBAAkB,EAAE,uBAAuB,CAAC;IAC5C,SAAS,EAAE,eAAe,CAAC;IAC3B,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,EAAE,aAAa,CAAC;IACvB,OAAO,EAAE,aAAa,CAAC;IACvB,SAAS,EAAE,eAAe,CAAC;IAC3B,gBAAgB,EAAE,qBAAqB,CAAC;IACxC,gBAAgB,EAAE,qBAAqB,CAAC;CACzC;AAMD,eAAO,MAAM,cAAc,EAAE,UAsF5B,CAAC;AAmCF,wBAAgB,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,CAmBpD;AAQD,wBAAgB,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,CAKnD;AAED,wBAAgB,WAAW,IAAI,IAAI,CAElC"}

package/dist/policy.js

@@ -4,6 +4,19 @@
  */
 import { readFileSync } from "node:fs";
 import { resolve } from "node:path";
+/** Resolve which injection phases are allowed for a given maxRounds.
+ *  Uses the tiered strategy: finds the first tier where maxRounds ≤ tier.max_rounds,
+ *  and returns its allowed_phases. If maxRounds exceeds all tiers, returns the
+ *  last tier's phases. */
+export function resolveAllowedPhases(maxRounds, tiers) {
+    if (tiers.length === 0)
+        return [1]; // safety fallback
+    for (const tier of tiers) {
+        if (maxRounds <= tier.max_rounds)
+            return tier.allowed_phases;
+    }
+    return tiers[tiers.length - 1].allowed_phases;
+}
 // ═══════════════════════════════════════════════════════════════════════════
 // Default policy
 // ═══════════════════════════════════════════════════════════════════════════
@@ -62,6 +75,37 @@ export const DEFAULT_POLICY = {
         vault_path: ".promptcraft/prompt_vault.json",
         global_vault_path: "~/.promptcraft/global_vault.json",
     },
+    evolution: {
+        max_discovered_constraints_per_round: 5,
+        max_active_constraints: 15,
+        max_objective_versions: 10,
+        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"],
+    },
 };
 // ═══════════════════════════════════════════════════════════════════════════
 // Deep merge — custom values override defaults, unset fields retain defaults

package/dist/policy.js.map

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