loopforge 1.0.0

package/dist/backends/fs.js

@@ -0,0 +1,308 @@
+/** FSBackend — filesystem implementation of VaultBackend.
+ *
+ * Wraps Node.js fs for JSON vault read/write and Markdown lineage I/O.
+ * All file I/O is contained in this single module — engine.ts never
+ * touches the filesystem directly.
+ */
+import { readFileSync, writeFileSync, mkdirSync, readdirSync, existsSync, } from "node:fs";
+import { resolve, dirname } from "node:path";
+import { homedir } from "node:os";
+// ═══════════════════════════════════════════════════════════════════════════
+// YAML frontmatter helpers (lightweight, no dependency)
+// ═══════════════════════════════════════════════════════════════════════════
+const FRONTMATTER_DELIM = "---";
+function escapeYamlString(value) {
+    if (/[":{}[\],&\*\#\?\-<>=!%@`]/.test(value) || value.includes("\n")) {
+        return `"${value.replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`;
+    }
+    return value;
+}
+function buildYamlFrontmatter(metadata) {
+    const lines = [FRONTMATTER_DELIM];
+    for (const [key, value] of Object.entries(metadata)) {
+        if (value === null || value === undefined)
+            continue;
+        if (Array.isArray(value)) {
+            if (value.length === 0) {
+                lines.push(`${key}: []`);
+            }
+            else {
+                lines.push(`${key}:`);
+                for (const item of value) {
+                    lines.push(`  - ${escapeYamlString(String(item))}`);
+                }
+            }
+        }
+        else if (typeof value === "object") {
+            lines.push(`${key}:`);
+            for (const [subKey, subValue] of Object.entries(value)) {
+                if (subValue !== null && subValue !== undefined) {
+                    if (Array.isArray(subValue)) {
+                        lines.push(`  ${subKey}:`);
+                        for (const item of subValue) {
+                            lines.push(`    - ${escapeYamlString(String(item))}`);
+                        }
+                    }
+                    else {
+                        lines.push(`  ${subKey}: ${escapeYamlString(String(subValue))}`);
+                    }
+                }
+            }
+        }
+        else if (typeof value === "boolean") {
+            lines.push(`${key}: ${value}`);
+        }
+        else if (typeof value === "number") {
+            lines.push(`${key}: ${value}`);
+        }
+        else {
+            lines.push(`${key}: ${escapeYamlString(String(value))}`);
+        }
+    }
+    lines.push(FRONTMATTER_DELIM);
+    return lines.join("\n") + "\n";
+}
+function parseYamlFrontmatter(text) {
+    const metadata = {};
+    let body = text;
+    if (!text.startsWith(FRONTMATTER_DELIM)) {
+        return { metadata, body };
+    }
+    const endIdx = text.indexOf(FRONTMATTER_DELIM, 3);
+    if (endIdx === -1) {
+        return { metadata, body };
+    }
+    const fmBlock = text.slice(3, endIdx).trim();
+    body = text.slice(endIdx + 3).trim();
+    // Simple YAML key: value parser (covers our subset)
+    let currentKey = "";
+    for (const line of fmBlock.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        // List item
+        if (trimmed.startsWith("- ")) {
+            const item = trimmed.slice(2).trim().replace(/^"(.*)"$/, "$1");
+            if (currentKey && metadata[currentKey]) {
+                metadata[currentKey].push(item);
+            }
+            else if (currentKey) {
+                metadata[currentKey] = [item];
+            }
+            continue;
+        }
+        // Nested key (indented)
+        if (line.startsWith("  ") && !line.startsWith("    ")) {
+            const nestedMatch = trimmed.match(/^([a-z_]+):\s*(.*)/i);
+            if (nestedMatch && currentKey) {
+                const nKey = nestedMatch[1];
+                const nVal = nestedMatch[2].trim().replace(/^"(.*)"$/, "$1");
+                if (!metadata[currentKey]) {
+                    metadata[currentKey] = {};
+                }
+                metadata[currentKey][nKey] =
+                    coerceYamlScalar(nVal);
+            }
+            continue;
+        }
+        // Top-level key: value
+        const match = trimmed.match(/^([a-z_]+):\s*(.*)/i);
+        if (match) {
+            currentKey = match[1];
+            const val = match[2].trim();
+            if (val) {
+                metadata[currentKey] = coerceYamlScalar(val.replace(/^"(.*)"$/, "$1"));
+            }
+            else {
+                metadata[currentKey] = "";
+            }
+        }
+    }
+    return { metadata, body };
+}
+function coerceYamlScalar(value) {
+    if (value === "true" || value === "True")
+        return true;
+    if (value === "false" || value === "False")
+        return false;
+    const num = Number(value);
+    if (!Number.isNaN(num) && value.trim() !== "")
+        return num;
+    return value;
+}
+// ═══════════════════════════════════════════════════════════════════════════
+// Path helpers
+// ═══════════════════════════════════════════════════════════════════════════
+function lineageDirName(loopId) {
+    return `loop-${loopId.replace(/:/g, "-")}`;
+}
+function resolveVaultPath(rawPath) {
+    if (rawPath.startsWith("~")) {
+        return resolve(homedir(), rawPath.slice(2));
+    }
+    return resolve(rawPath);
+}
+// ═══════════════════════════════════════════════════════════════════════════
+// Markdown lineage I/O (module-level functions)
+// ═══════════════════════════════════════════════════════════════════════════
+export function readLineageMd(loopId, roundNum, vaultPath) {
+    const baseDir = vaultPath
+        ? dirname(resolveVaultPath(vaultPath))
+        : resolve(".promptcraft");
+    const mdPath = resolve(baseDir, "prompts", lineageDirName(loopId), `r${roundNum}.md`);
+    try {
+        const raw = readFileSync(mdPath, "utf-8");
+        const { metadata, body } = parseYamlFrontmatter(raw);
+        return { full_prompt: body, metadata };
+    }
+    catch {
+        return null;
+    }
+}
+export function writeLineageMd(loopId, roundNum, content, metadata, vaultPath) {
+    const baseDir = vaultPath
+        ? dirname(resolveVaultPath(vaultPath))
+        : resolve(".promptcraft");
+    const dir = resolve(baseDir, "prompts", lineageDirName(loopId));
+    const mdPath = resolve(dir, `r${roundNum}.md`);
+    try {
+        mkdirSync(dir, { recursive: true });
+        const fm = buildYamlFrontmatter(metadata);
+        writeFileSync(mdPath, fm + "\n" + content, "utf-8");
+        return mdPath;
+    }
+    catch {
+        return null;
+    }
+}
+export function scanLineageMd(loopId, vaultPath) {
+    const baseDir = vaultPath
+        ? dirname(resolveVaultPath(vaultPath))
+        : resolve(".promptcraft");
+    const dir = resolve(baseDir, "prompts", lineageDirName(loopId));
+    const entries = [];
+    try {
+        if (!existsSync(dir))
+            return entries;
+        const files = readdirSync(dir).filter((f) => f.startsWith("r") && f.endsWith(".md"));
+        for (const file of files) {
+            const roundMatch = file.match(/^r(\d+)\.md$/);
+            if (!roundMatch)
+                continue;
+            const roundNum = parseInt(roundMatch[1], 10);
+            const fullPath = resolve(dir, file);
+            const raw = readFileSync(fullPath, "utf-8");
+            const { metadata, body } = parseYamlFrontmatter(raw);
+            entries.push({
+                task_id: `loop:${loopId}:r${roundNum}`,
+                full_prompt: body,
+                technique_used: metadata.technique_used,
+                quality_score: metadata.quality_score,
+                loop_lineage: {
+                    loop_id: loopId,
+                    round: roundNum,
+                    goal_id: metadata.goal_id,
+                    goal_text_hash: metadata.goal_text_hash,
+                    recompile_level: metadata.recompile_level,
+                    constraints_active: metadata.constraints_active,
+                    task: metadata.task,
+                    technique_used: metadata.technique_used,
+                    success: metadata.success,
+                    quality_score: metadata.quality_score,
+                    output_summary: metadata.output_summary,
+                    constraint_violations: metadata.constraint_violations,
+                },
+                loop_id: loopId,
+                task: metadata.task,
+                output_summary: metadata.output_summary,
+                constraint_violations: metadata
+                    .constraint_violations,
+            });
+        }
+    }
+    catch {
+        // Directory doesn't exist or can't be read
+    }
+    return entries;
+}
+// ═══════════════════════════════════════════════════════════════════════════
+// FSBackend
+// ═══════════════════════════════════════════════════════════════════════════
+export class FSBackend {
+    vaultPath;
+    globalVaultPath;
+    constructor(vaultPath = ".promptcraft/prompt_vault.json", globalVaultPath = "~/.promptcraft/global_vault.json") {
+        this.vaultPath = vaultPath;
+        this.globalVaultPath = globalVaultPath;
+    }
+    // ── JSON vault ────────────────────────────────────────────────────────
+    readVault() {
+        const resolved = resolveVaultPath(this.vaultPath);
+        try {
+            const raw = readFileSync(resolved, "utf-8");
+            return JSON.parse(raw);
+        }
+        catch {
+            return { entries: [] };
+        }
+    }
+    writeVault(data) {
+        const resolved = resolveVaultPath(this.vaultPath);
+        mkdirSync(dirname(resolved), { recursive: true });
+        writeFileSync(resolved, JSON.stringify(data, null, 2), "utf-8");
+    }
+    // ── Entry queries ─────────────────────────────────────────────────────
+    queryEntries(opts) {
+        const vault = this.readVault();
+        const entries = vault.entries || [];
+        return entries.filter((entry) => {
+            const taskId = String(entry.task_id ?? "");
+            // Feedback-only filter
+            if (opts?.feedbackOnly && !taskId.endsWith(":feedback")) {
+                return false;
+            }
+            // Exclude feedback entries when not feedbackOnly
+            if (!opts?.feedbackOnly && taskId.endsWith(":feedback")) {
+                return false;
+            }
+            // Prefix filter
+            if (opts?.prefix && !taskId.startsWith(opts.prefix)) {
+                return false;
+            }
+            // Pattern filter (simple substring match)
+            if (opts?.taskIdPattern &&
+                !taskId.includes(opts.taskIdPattern)) {
+                return false;
+            }
+            return true;
+        });
+    }
+    appendEntry(entry) {
+        const vault = this.readVault();
+        const entries = vault.entries || [];
+        entries.push(entry);
+        vault.entries = entries;
+        this.writeVault(vault);
+    }
+    appendEntries(entries) {
+        if (entries.length === 0)
+            return 0;
+        const vault = this.readVault();
+        const existing = vault.entries || [];
+        vault.entries = [...existing, ...entries];
+        this.writeVault(vault);
+        return entries.length;
+    }
+    // ── Markdown lineage ──────────────────────────────────────────────────
+    writeLineageMd(loopId, roundNum, content, metadata) {
+        return writeLineageMd(loopId, roundNum, content, metadata, this.vaultPath);
+    }
+    readLineageMd(loopId, roundNum) {
+        const result = readLineageMd(loopId, roundNum, this.vaultPath);
+        return result?.full_prompt ?? null;
+    }
+    scanLineageMd(loopId) {
+        return scanLineageMd(loopId, this.vaultPath);
+    }
+}
+//# sourceMappingURL=fs.js.map

package/dist/backends/fs.js.map

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

package/dist/backends/interface.d.ts

@@ -0,0 +1,42 @@
+/** VaultBackend — storage abstraction interface.
+ *
+ * 9 methods that define the storage contract. All engine I/O goes through
+ * this interface — no direct filesystem access outside of backend implementations.
+ */
+export interface VaultEntry {
+    id?: string;
+    task_id?: string;
+    version_tag?: string;
+    is_active?: boolean;
+    timestamp?: string;
+    user_intent?: string;
+    task_type?: string;
+    quality_score?: number;
+    skill_used?: string;
+    technique_used?: string;
+    loop_id?: string;
+    loop_lineage?: Record<string, unknown>;
+    loop_objective?: Record<string, unknown> | null;
+    execution_feedback?: string;
+    task?: string;
+    output_summary?: string;
+    constraint_violations?: string[];
+    tags?: string[];
+    full_prompt?: string;
+    [key: string]: unknown;
+}
+export interface VaultBackend {
+    readVault(): Record<string, unknown>;
+    writeVault(data: Record<string, unknown>): void;
+    queryEntries(opts?: {
+        prefix?: string;
+        taskIdPattern?: string;
+        feedbackOnly?: boolean;
+    }): VaultEntry[];
+    appendEntry(entry: VaultEntry): void;
+    appendEntries(entries: VaultEntry[]): number;
+    writeLineageMd(loopId: string, roundNum: number, content: string, metadata: Record<string, unknown>): string | null;
+    readLineageMd(loopId: string, roundNum: number): string | null;
+    scanLineageMd(loopId: string): VaultEntry[];
+}
+//# sourceMappingURL=interface.d.ts.map

package/dist/backends/interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../src/backends/interface.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,UAAU;IACzB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAChD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAE3B,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAGhD,YAAY,CAAC,IAAI,CAAC,EAAE;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,YAAY,CAAC,EAAE,OAAO,CAAC;KACxB,GAAG,UAAU,EAAE,CAAC;IAEjB,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IACrC,aAAa,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;IAG7C,cAAc,CACZ,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,MAAM,GAAG,IAAI,CAAC;IAEjB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC/D,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,EAAE,CAAC;CAC7C"}

package/dist/backends/interface.js

@@ -0,0 +1,7 @@
+/** VaultBackend — storage abstraction interface.
+ *
+ * 9 methods that define the storage contract. All engine I/O goes through
+ * this interface — no direct filesystem access outside of backend implementations.
+ */
+export {};
+//# sourceMappingURL=interface.js.map

package/dist/backends/interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.js","sourceRoot":"","sources":["../../src/backends/interface.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/builder.d.ts

@@ -0,0 +1,17 @@
+/** LoopForge Agent — Technique router + quality scoring.
+ *
+ * Two pure-function responsibilities:
+ *   1. Technique selection — keyword heuristic, fast + zero-cost
+ *   2. Quality scoring — deterministic 1-5 from feedback signals
+ */
+import { type Analysis } from "./protocol.js";
+export declare const TECHNIQUE_REFERENCE: Record<string, string>;
+export declare function routeTechnique(task: string): Analysis;
+export declare function scoreQuality(feedback: {
+    success: boolean;
+    constraint_violations?: unknown[];
+    manual_fixes_needed?: string;
+} | null): number;
+export declare function routeTechniqueAdaptive(task: string, vaultContext?: Record<string, unknown> | null, loopId?: string): Analysis;
+export declare function extractGlobalConstraints(hydrateResults: Record<string, unknown> | null): string[];
+//# sourceMappingURL=builder.d.ts.map

package/dist/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAGL,KAAK,QAAQ,EACd,MAAM,eAAe,CAAC;AA+BvB,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAQtD,CAAC;AAgCF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAmCrD;AAMD,wBAAgB,YAAY,CAC1B,QAAQ,EAAE;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,qBAAqB,CAAC,EAAE,OAAO,EAAE,CAAC;IAAC,mBAAmB,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,GACrG,MAAM,CAYR;AA4CD,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,YAAY,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAW,EACnD,MAAM,SAAK,GACV,QAAQ,CAqCV;AAMD,wBAAgB,wBAAwB,CACtC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAC7C,MAAM,EAAE,CAeV"}

package/dist/builder.js

@@ -0,0 +1,205 @@
+/** LoopForge Agent — Technique router + quality scoring.
+ *
+ * Two pure-function responsibilities:
+ *   1. Technique selection — keyword heuristic, fast + zero-cost
+ *   2. Quality scoring — deterministic 1-5 from feedback signals
+ */
+import { getPolicy } from "./policy.js";
+import { makeAnalysis, Technique, } from "./protocol.js";
+// ═══════════════════════════════════════════════════════════════════════════
+// Routing table
+// ═══════════════════════════════════════════════════════════════════════════
+const ROUTING_TABLE = {
+    continuous_low: Technique.ZERO_SHOT,
+    independent_low: Technique.ZERO_SHOT,
+    continuous_medium: Technique.FEW_SHOT,
+    independent_medium: Technique.ZERO_SHOT_COT,
+    continuous_high: Technique.FEW_SHOT_COT,
+    independent_high: Technique.TREE_OF_THOUGHT,
+};
+const RATIONALE = {
+    [Technique.ZERO_SHOT]: "Low load — direct instruction suffices.",
+    [Technique.FEW_SHOT]: "Fixed I/O pattern expected — examples anchor output format.",
+    [Technique.ZERO_SHOT_COT]: "Multi-step reasoning needed, no examples provided.",
+    [Technique.FEW_SHOT_COT]: "Complex reasoning with provided examples — relay pattern.",
+    [Technique.STEP_BACK]: "Vague or legacy — abstract to principles first.",
+    [Technique.LEAST_TO_MOST]: "Decomposable into ordered subproblems.",
+    [Technique.TREE_OF_THOUGHT]: "High risk, multi-path — explore + evaluate + prune.",
+};
+export const TECHNIQUE_REFERENCE = {
+    "zero-shot": "skills/prompt-techniques/references/zero-shot.md",
+    "few-shot": "skills/prompt-techniques/references/few-shot.md",
+    "zero-shot-cot": "skills/prompt-techniques/references/chain-of-thought.md",
+    "few-shot-cot": "skills/prompt-techniques/references/chain-of-thought.md",
+    "step-back": "skills/prompt-techniques/references/step-back.md",
+    "least-to-most": "skills/prompt-techniques/references/least-to-most.md",
+    "tree-of-thought": "skills/prompt-techniques/references/tree-of-thought.md",
+};
+// Keyword sets for heuristic classification
+const HIGH_LOAD_WORDS = new Set([
+    "security", "audit", "crypto", "encrypt", "concurrent",
+    "thread", "transaction", "rollback", "compile", "protocol",
+    "安全", "审计", "加密", "并发", "签名", "校验", "默克尔",
+    "assembly", "重放攻击", "共识", "虚拟机", "字节码",
+]);
+const LOW_LOAD_WORDS = new Set([
+    "rename", "format", "comment", "config", "readme", "simple", "basic",
+]);
+const CONTINUOUS_WORDS = new Set([
+    "fix", "modify", "update", "change", "refactor", "extend",
+    "add", "improve", "debug",
+]);
+// v1.1: Keywords that trigger specialist techniques (override routing table)
+const STEP_BACK_WORDS = new Set([
+    "重构", "排查", "legacy", "原则", "抽象", "根本原因", "root cause",
+    "报错", "逻辑混乱", "含糊", "vague", "审计方法", "底层",
+]);
+const LEAST_TO_MOST_WORDS = new Set([
+    "逐步", "搭建", "实现系统", "build system", "pipeline", "编译器",
+    "逐步求解", "有序", "从简单到复杂", "数据采集", "完整模块",
+    "多步骤", "部署流程", "子问题",
+]);
+// ═══════════════════════════════════════════════════════════════════════════
+// Keyword heuristic router
+// ═══════════════════════════════════════════════════════════════════════════
+export function routeTechnique(task) {
+    const taskLower = task.toLowerCase();
+    // Independence — check if any continuous word appears in task
+    const continuous = [...CONTINUOUS_WORDS].some((w) => taskLower.includes(w));
+    const independence = continuous ? "continuous" : "independent";
+    // Cognitive load — check keyword presence
+    let load;
+    if ([...HIGH_LOAD_WORDS].some((w) => taskLower.includes(w))) {
+        load = "high";
+    }
+    else if ([...LOW_LOAD_WORDS].some((w) => taskLower.includes(w))) {
+        load = "low";
+    }
+    else {
+        load = task.split(/\s+/).length > 8 ? "medium" : "low";
+    }
+    let technique = ROUTING_TABLE[`${independence}_${load}`] ?? Technique.ZERO_SHOT;
+    // v1.1: Keyword overrides for specialist techniques
+    if ([...STEP_BACK_WORDS].some((w) => taskLower.includes(w))) {
+        technique = Technique.STEP_BACK;
+        load = "high";
+    }
+    else if ([...LEAST_TO_MOST_WORDS].some((w) => taskLower.includes(w))) {
+        technique = Technique.LEAST_TO_MOST;
+        load = "high";
+    }
+    return makeAnalysis({
+        technique: technique,
+        rationale: RATIONALE[technique] ?? "Default route.",
+        independence,
+        cognitive_load: load,
+        reference_file: TECHNIQUE_REFERENCE[technique] ?? "",
+    });
+}
+// ═══════════════════════════════════════════════════════════════════════════
+// Quality scoring
+// ═══════════════════════════════════════════════════════════════════════════
+export function scoreQuality(feedback) {
+    if (feedback === null)
+        return 0;
+    const success = feedback.success;
+    const violations = feedback.constraint_violations ?? [];
+    const fixes = feedback.manual_fixes_needed ?? "";
+    if (success && violations.length === 0 && !fixes)
+        return 5;
+    if (success && violations.length === 0)
+        return 4;
+    if (success)
+        return 3;
+    if (violations.length > 0)
+        return 2;
+    return 1;
+}
+// ═══════════════════════════════════════════════════════════════════════════
+// Adaptive routing (v3.5)
+// ═══════════════════════════════════════════════════════════════════════════
+function countConsecutiveLowQuality(technique, loopId, vaultContext) {
+    if (vaultContext === null)
+        return 0;
+    const results = vaultContext.results || [];
+    if (!results.length)
+        return 0;
+    const policy = getPolicy();
+    const threshold = policy.technique.adaptive_quality_threshold;
+    // Filter to this loop, sort by round descending
+    const rounds = [];
+    for (const r of results) {
+        const lineage = (r.loop_lineage || r.lineage || {});
+        if (lineage.loop_id !== loopId)
+            continue;
+        rounds.push({
+            round: lineage.round ?? 0,
+            quality_score: r.quality_score ?? lineage.quality_score ?? 0,
+            technique_used: r.technique_used ?? r.skill_used ?? "",
+        });
+    }
+    rounds.sort((a, b) => b.round - a.round);
+    let count = 0;
+    for (const rnd of rounds) {
+        if (rnd.technique_used && rnd.technique_used !== technique)
+            break;
+        if (rnd.quality_score > 0 && rnd.quality_score < threshold) {
+            count++;
+        }
+        else {
+            break;
+        }
+    }
+    return count;
+}
+export function routeTechniqueAdaptive(task, vaultContext = null, loopId = "") {
+    // Step 1: Keyword heuristic (always)
+    const analysis = routeTechnique(task);
+    if (!vaultContext || !loopId)
+        return analysis;
+    // Step 2: Check if current technique needs rotation
+    const technique = analysis.technique;
+    const policy = getPolicy();
+    const lowCount = countConsecutiveLowQuality(technique, loopId, vaultContext);
+    if (lowCount < policy.technique.adaptive_consecutive_rounds) {
+        return analysis;
+    }
+    // Step 3: Rotate
+    const fallback = policy.technique.fallback_chain[technique] ?? technique;
+    if (fallback === technique)
+        return analysis; // Already at ceiling
+    const originalTechnique = technique;
+    const originalRationale = analysis.rationale;
+    return makeAnalysis({
+        technique: fallback,
+        rationale: `${originalRationale} [ROTATED: ${originalTechnique} → ${fallback} — ` +
+            `${lowCount} consecutive low-quality rounds (score < ${policy.technique.adaptive_quality_threshold})]`,
+        independence: analysis.independence,
+        cognitive_load: fallback === "tree-of-thought" || fallback === "few-shot-cot"
+            ? "high"
+            : fallback === "zero-shot-cot" || fallback === "least-to-most"
+                ? "medium"
+                : analysis.cognitive_load,
+        reference_file: TECHNIQUE_REFERENCE[fallback] ?? analysis.reference_file,
+        was_rotated: true,
+    });
+}
+// ═══════════════════════════════════════════════════════════════════════════
+// Global constraints extraction
+// ═══════════════════════════════════════════════════════════════════════════
+export function extractGlobalConstraints(hydrateResults) {
+    const constraints = [];
+    if (!hydrateResults)
+        return constraints;
+    const globalEntries = hydrateResults.global_entries || [];
+    for (const entry of globalEntries) {
+        const added = entry.hard_constraints_added || [];
+        for (const c of added) {
+            if (!constraints.includes(c)) {
+                constraints.push(c);
+            }
+        }
+    }
+    return constraints;
+}
+//# sourceMappingURL=builder.js.map

package/dist/builder.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/** LoopForge CLI — command-line interface for the loop compiler.
+ *
+ * v1.0 — npm install loopforge
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;GAGG"}