loopforge 1.0.0

package/dist/cli.js

@@ -0,0 +1,360 @@
+#!/usr/bin/env node
+/** LoopForge CLI — command-line interface for the loop compiler.
+ *
+ * v1.0 — npm install loopforge
+ */
+import { createEngine } from "./engine.js";
+import { FSBackend } from "./backends/fs.js";
+import { ReplayBackend } from "./replay.js";
+import { makeExecutionFeedback, } from "./protocol.js";
+// ═══════════════════════════════════════════════════════════════════════════
+// Constants
+// ═══════════════════════════════════════════════════════════════════════════
+const VERSION = "1.0.0";
+const VAULT_CONFIG = {
+    project_vault: ".promptcraft/prompt_vault.json",
+    global_vault: "~/.promptcraft/global_vault.json",
+    skills_dir: "skills",
+    no_global: false,
+};
+const USAGE = `LoopForge v${VERSION} — Loop-Time Intelligence Layer
+
+Usage:
+  loopforge init                  Initialise .promptcraft vault
+  loopforge compile [json]        Compile a loop prompt
+  loopforge feedback [json]       Record execution feedback
+  loopforge replay <loop-id>      Show loop timeline
+  loopforge diff <loop-id> <a> <b> Diff two rounds
+  loopforge review <loop-id> <rN> Audit stored prompt
+  loopforge status                Vault health summary
+
+Flags:
+  --help, -h     Show this help
+  --version, -V  Show version
+
+Pipe JSON via stdin:  echo '{"task":"..."}' | loopforge compile
+`;
+const CMD_HELP = {
+    init: "loopforge init — create .promptcraft/prompt_vault.json if it doesn't exist.",
+    compile: "loopforge compile '<json>' — run loop_compile (L0/L1/L2).\n  Required: task, loop_id, goal_id. Optional: round, domain, constraints_from_plan, new_since_last_round, force_level.",
+    feedback: "loopforge feedback '<json>' — record execution result.\n  Flat: {loop_id, round, success, score, output}\n  Nested: {loop_id, round, feedback: {success, score, output}}",
+    replay: "loopforge replay <loop-id> — show timeline: round, recompile level, quality, technique, task.",
+    diff: "loopforge diff <loop-id> <round-a> <round-b> — field-level comparison between two rounds.",
+    review: "loopforge review <loop-id> <round-num> — structural audit of a stored prompt.",
+    status: "loopforge status — vault health: entry counts, active loops.",
+};
+// ═══════════════════════════════════════════════════════════════════════════
+// Helpers
+// ═══════════════════════════════════════════════════════════════════════════
+function die(msg) {
+    process.stderr.write(`loopforge: ${msg}\n`);
+    process.exit(1);
+}
+function showHelp(cmd) {
+    if (cmd && CMD_HELP[cmd]) {
+        console.log(CMD_HELP[cmd]);
+    }
+    else {
+        console.log(USAGE);
+    }
+}
+async function readStdin() {
+    return new Promise((resolve) => {
+        const chunks = [];
+        process.stdin.on("data", (chunk) => chunks.push(chunk));
+        process.stdin.on("end", () => resolve(Buffer.concat(chunks).toString("utf-8")));
+        if (process.stdin.isTTY)
+            resolve("");
+    });
+}
+function parseJson(raw) {
+    try {
+        const data = JSON.parse(raw);
+        if (typeof data !== "object" || Array.isArray(data) || data === null) {
+            die("input must be a JSON object");
+        }
+        return data;
+    }
+    catch (e) {
+        die(`invalid JSON: ${e instanceof Error ? e.message : e}`);
+    }
+}
+/** Normalise flat fields into feedback payload — accepts both formats. */
+function normaliseFeedbackPayload(data) {
+    // Already nested: { feedback: { success, score, ... } }
+    if (data.feedback && typeof data.feedback === "object") {
+        return data.feedback;
+    }
+    // Flat format: { success, score, output, ... } — auto-nest
+    if (data.success !== undefined || data.score !== undefined) {
+        return {
+            output: data.output ?? "",
+            success: data.success ?? false,
+            constraint_violations: data.constraint_violations ?? [],
+            manual_fixes_needed: data.manual_fixes_needed ?? "",
+        };
+    }
+    return null;
+}
+// ═══════════════════════════════════════════════════════════════════════════
+// Commands
+// ═══════════════════════════════════════════════════════════════════════════
+async function cmdInit() {
+    const backend = new FSBackend();
+    const vault = backend.readVault();
+    if (!vault.entries || !Array.isArray(vault.entries)) {
+        backend.writeVault({ entries: [] });
+        console.log("Initialised .promptcraft/prompt_vault.json");
+    }
+    else {
+        const count = vault.entries.length;
+        console.log(`Vault already exists (${count} entries). Nothing to do.`);
+    }
+}
+async function cmdCompile(engine, jsonArg) {
+    let raw;
+    if (jsonArg === "--help" || jsonArg === "-h") {
+        showHelp("compile");
+        return;
+    }
+    if (jsonArg) {
+        raw = jsonArg;
+    }
+    else {
+        raw = await readStdin();
+    }
+    if (!raw.trim())
+        die("compile requires JSON input (argument or stdin)");
+    const data = parseJson(raw);
+    const result = engine.invokeLoopCompile({
+        task: data.task ?? "",
+        mode: "loop_compile",
+        vault_config: { ...VAULT_CONFIG },
+        feedback: null,
+        skill_name: null,
+        task_id: null,
+        ...data,
+    });
+    const prompt = result.response?.prompt ?? "Error: no prompt generated";
+    console.log(prompt);
+}
+async function cmdFeedback(engine, jsonArg) {
+    if (jsonArg === "--help" || jsonArg === "-h") {
+        showHelp("feedback");
+        return;
+    }
+    let raw;
+    if (jsonArg) {
+        raw = jsonArg;
+    }
+    else {
+        raw = await readStdin();
+    }
+    if (!raw.trim())
+        die("feedback requires JSON input (argument or stdin)");
+    const data = parseJson(raw);
+    const fbPayload = normaliseFeedbackPayload(data);
+    if (!fbPayload) {
+        die("feedback requires one of: {feedback:{success,score}} or {success,score} at top level");
+    }
+    const result = engine.invokeFeedback({
+        task: data.task ?? "",
+        mode: "feedback",
+        vault_config: { ...VAULT_CONFIG },
+        feedback: makeExecutionFeedback({
+            output: fbPayload.output ?? "",
+            success: fbPayload.success ?? false,
+            constraint_violations: fbPayload.constraint_violations ?? [],
+            manual_fixes_needed: fbPayload.manual_fixes_needed ?? "",
+        }),
+        skill_name: null,
+        task_id: null,
+        ...data,
+    });
+    console.log(result.response?.prompt ?? result.response?.error ?? "Error");
+}
+function cmdReplay(loopId) {
+    if (loopId === "--help" || loopId === "-h") {
+        showHelp("replay");
+        return;
+    }
+    if (!loopId)
+        die("replay requires a loop-id");
+    const backend = new FSBackend();
+    const replay = new ReplayBackend(backend);
+    const tl = replay.timeline(loopId);
+    if (!tl.length) {
+        console.log(`No rounds found for loop "${loopId}".`);
+        return;
+    }
+    console.log(`Loop: ${loopId}  (${tl.length} rounds)\n`);
+    console.log("Round  Level  Quality  Technique       Task");
+    console.log("-----  -----  -------  --------------  ----");
+    for (const entry of tl) {
+        const rnd = String(entry.round).padStart(5);
+        const level = String(entry.recompile_level).padEnd(6);
+        const q = String(entry.quality_score ?? "-").padEnd(8);
+        const tech = String(entry.technique_used || "-").padEnd(15);
+        const task = String(entry.task || "").slice(0, 50);
+        console.log(`${rnd}  ${level} ${q} ${tech} ${task}`);
+    }
+}
+function cmdDiff(loopId, roundA, roundB) {
+    if (loopId === "--help" || loopId === "-h") {
+        showHelp("diff");
+        return;
+    }
+    if (!loopId || !roundA || !roundB) {
+        die("diff requires <loop-id> <round-a> <round-b>");
+    }
+    const backend = new FSBackend();
+    const replay = new ReplayBackend(backend);
+    const diff = replay.diff(loopId, parseInt(roundA, 10), parseInt(roundB, 10));
+    if (diff.missing) {
+        console.log(`Cannot diff: ${diff.missing} not found.`);
+        return;
+    }
+    console.log(`Diff: ${loopId}  round ${diff.round_a} → round ${diff.round_b}\n`);
+    const changes = diff.changes;
+    if (!changes.length) {
+        console.log("No changes detected.");
+    }
+    else {
+        for (const c of changes) {
+            console.log(`  ${c.label}:`);
+            if (c.field === "constraints_active") {
+                const added = c.added;
+                const removed = c.removed;
+                if (added?.length)
+                    console.log(`    + added: [${added.join(", ")}]`);
+                if (removed?.length)
+                    console.log(`    - removed: [${removed.join(", ")}]`);
+            }
+            else {
+                console.log(`    before: ${c.before}`);
+                console.log(`    after:  ${c.after}`);
+            }
+        }
+    }
+    const unchanged = diff.unchanged;
+    if (unchanged?.length) {
+        console.log(`\nUnchanged: ${unchanged.join(", ")}`);
+    }
+}
+function cmdReview(loopId, roundStr) {
+    if (loopId === "--help" || loopId === "-h") {
+        showHelp("review");
+        return;
+    }
+    if (!loopId || !roundStr)
+        die("review requires <loop-id> <round-num>");
+    const roundNum = parseInt(roundStr, 10);
+    if (Number.isNaN(roundNum))
+        die(`invalid round number: ${roundStr}`);
+    const backend = new FSBackend();
+    const engine = createEngine("skills", backend);
+    const context = engine.hydrateLoopContext(loopId);
+    if (!context) {
+        console.log(`No entries found for loop "${loopId}".`);
+        return;
+    }
+    const results = context.results ?? [];
+    const target = results.find((r) => {
+        const lineage = (r.loop_lineage ?? {});
+        return lineage.round === roundNum;
+    });
+    if (!target) {
+        console.log(`Round ${roundNum} not found in loop "${loopId}".`);
+        return;
+    }
+    const result = engine.handleReview({
+        task: target.task ?? "review",
+        mode: "review",
+        vault_config: { ...VAULT_CONFIG },
+        feedback: null,
+        skill_name: null,
+        task_id: null,
+    }, { results: [target], global_entries: [] });
+    console.log(result.response?.prompt ?? "Review produced no output.");
+}
+function cmdStatus() {
+    const backend = new FSBackend();
+    const vault = backend.readVault();
+    const entries = vault.entries ?? [];
+    const loops = new Set();
+    let lineageCount = 0;
+    let feedbackCount = 0;
+    for (const e of entries) {
+        const taskId = String(e.task_id ?? "");
+        if (taskId.endsWith(":feedback")) {
+            feedbackCount++;
+        }
+        else if (taskId.startsWith("loop:")) {
+            lineageCount++;
+        }
+        const lid = e.loop_id ?? e.loop_lineage?.loop_id;
+        if (lid)
+            loops.add(String(lid));
+    }
+    console.log("LoopForge Vault Status");
+    console.log("=======================");
+    console.log(`Total entries:   ${entries.length}`);
+    console.log(`Lineage entries: ${lineageCount}`);
+    console.log(`Feedback entries: ${feedbackCount}`);
+    console.log(`Active loops:    ${loops.size}`);
+    if (loops.size > 0) {
+        console.log(`\nLoops: ${[...loops].sort().join(", ")}`);
+    }
+}
+// ═══════════════════════════════════════════════════════════════════════════
+// Main
+// ═══════════════════════════════════════════════════════════════════════════
+async function main() {
+    const args = process.argv.slice(2);
+    const cmd = args[0];
+    if (!cmd || cmd === "--help" || cmd === "-h") {
+        showHelp(args[1]); // "loopforge --help compile" shows compile help
+        process.exit(0);
+    }
+    if (cmd === "--version" || cmd === "-V") {
+        console.log(`loopforge v${VERSION}`);
+        process.exit(0);
+    }
+    const engine = createEngine("skills");
+    switch (cmd) {
+        case "init":
+            if (args[1] === "--help" || args[1] === "-h")
+                showHelp("init");
+            else
+                await cmdInit();
+            break;
+        case "compile":
+            await cmdCompile(engine, args[1]);
+            break;
+        case "feedback":
+            await cmdFeedback(engine, args[1]);
+            break;
+        case "replay":
+            cmdReplay(args[1]);
+            break;
+        case "diff":
+            cmdDiff(args[1], args[2], args[3]);
+            break;
+        case "review":
+            cmdReview(args[1], args[2]);
+            break;
+        case "status":
+            if (args[1] === "--help" || args[1] === "-h")
+                showHelp("status");
+            else
+                cmdStatus();
+            break;
+        default:
+            die(`unknown command: ${cmd}\nUse --help for usage.`);
+    }
+}
+main().catch((err) => {
+    process.stderr.write(`loopforge: fatal: ${err.message ?? err}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/engine.d.ts

@@ -0,0 +1,42 @@
+/** LoopForge-loop_compile — Engine (outer loop manager).
+ *
+ * v1.0: 3-mode engine with vault-backed loop lineage persistence.
+ * invokeLoopCompile (primary), invokeBuild (internal), invokeFeedback.
+ * Circuit breaker prevents infinite stall loops.
+ * EngineMetrics tracks silent-failure counters for observability.
+ */
+import type { VaultBackend } from "./backends/interface.js";
+import { type AgentLoopResult, type LoopForgeRequest, type SessionState } from "./protocol.js";
+export interface EngineMetrics {
+    vaultWriteErrors: number;
+    vaultWriteTimeouts: number;
+    vaultWriteBytes: number;
+    silentAnalysisErrors: number;
+    hydrateCacheMisses: number;
+    feedbackBufferFlushes: number;
+    feedbackBufferMaxSize: number;
+    sessionStart: number;
+}
+export declare class LoopForgeEngine {
+    skillsDir: string;
+    state: SessionState | null;
+    private backend;
+    private metrics;
+    private feedbackWriteBuffer;
+    lastTask: string | null;
+    private seenConstraints;
+    constructor(skillsDir?: string, backend?: VaultBackend);
+    private resolveBackend;
+    private ensureInit;
+    private persistFeedbackToVault;
+    flushFeedbackBuffer(): number;
+    private persistLoopLineage;
+    hydrateLoopContext(loopId: string): Record<string, unknown> | null;
+    invokeBuild(request: LoopForgeRequest, _hydrateResults?: Record<string, unknown> | null): AgentLoopResult;
+    invokeFeedback(request: LoopForgeRequest, _hydrateResults?: Record<string, unknown> | null): AgentLoopResult;
+    invokeLoopCompile(request: LoopForgeRequest, hydrateResults?: Record<string, unknown> | null): AgentLoopResult;
+    handleReview(request: LoopForgeRequest, hydrateResults?: Record<string, unknown> | null): AgentLoopResult;
+    shouldBreak(): boolean;
+}
+export declare function createEngine(skillsDir?: string, backend?: VaultBackend): LoopForgeEngine;
+//# sourceMappingURL=engine.d.ts.map

package/dist/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAc,MAAM,yBAAyB,CAAC;AACxE,OAAO,EAQL,KAAK,eAAe,EAGpB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EAClB,MAAM,eAAe,CAAC;AASvB,MAAM,WAAW,aAAa;IAC5B,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,YAAY,EAAE,MAAM,CAAC;CACtB;AAmBD,qBAAa,eAAe;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,YAAY,GAAG,IAAI,CAAQ;IAClC,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,mBAAmB,CAAoB;IAC/C,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAC/B,OAAO,CAAC,eAAe,CAAqB;gBAEhC,SAAS,SAAW,EAAE,OAAO,CAAC,EAAE,YAAY;IAKxD,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,UAAU;IAelB,OAAO,CAAC,sBAAsB;IAkB9B,mBAAmB,IAAI,MAAM;IA4D7B,OAAO,CAAC,kBAAkB;IA0F1B,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAqFlE,WAAW,CACT,OAAO,EAAE,gBAAgB,EACzB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAC/C,eAAe;IAoClB,cAAc,CACZ,OAAO,EAAE,gBAAgB,EACzB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAC/C,eAAe;IA0FlB,iBAAiB,CACf,OAAO,EAAE,gBAAgB,EACzB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAC9C,eAAe;IA6JlB,YAAY,CACV,OAAO,EAAE,gBAAgB,EACzB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAC9C,eAAe;IAsElB,WAAW,IAAI,OAAO;CAYvB;AAMD,wBAAgB,YAAY,CAC1B,SAAS,SAAW,EACpB,OAAO,CAAC,EAAE,YAAY,GACrB,eAAe,CAEjB"}