@mobrienv/autoloop 0.2.0 → 0.3.0

package/dist/harness/prompt.js

@@ -1,11 +1,11 @@
+import { resolveRoleAgent } from "../agent-map.js";
 import * as memory from "../memory.js";
 import { materialize as materializeTasks } from "../tasks.js";
 import { renderTasksPrompt } from "../tasks-render.js";
 import * as topology from "../topology.js";
 import { joinCsv, listText } from "../utils.js";
 import { coordinationTopic, coreSystemTopic, parallelTopic, reservedParallelJoinedTopic, routingTopic, systemTopic, } from "./emit.js";
-import { resolveRoleAgent } from "../agent-map.js";
-import { extractField, extractIteration, extractTopic, readLines, readRunLines, } from "./journal.js";
+import { appendHarnessEvent, extractField, extractIteration, extractTopic, readLines, readRunLines, } from "./journal.js";
 import { renderRunScratchpadPrompt } from "./scratchpad.js";
 function deriveRunContext(loop, runLines) {
     const taskLines = readLines(loop.paths.tasksFile);
@@ -21,6 +21,7 @@ function deriveRunContext(loop, runLines) {
             done: tasksMaterialized.done.length,
             total: tasksMaterialized.open.length + tasksMaterialized.done.length,
         },
+        guidanceMessages: drainGuidance(runLines),
         routing: iterationRoutingContext(loop.topology, runLines),
         backpressure: latestInvalidNote(runLines),
         invalidCount: invalidEventCount(runLines),
@@ -30,8 +31,14 @@ function deriveRunContext(loop, runLines) {
 export function buildIterationContext(loop, iteration) {
     const runLines = readRunLines(loop.paths.journalFile, loop.runtime.runId);
     const derived = deriveRunContext(loop, runLines);
-    const activeRole = derived.routing.allowedRoles.length === 1 ? derived.routing.allowedRoles[0] : "";
+    const activeRole = derived.routing.allowedRoles.length === 1
+        ? derived.routing.allowedRoles[0]
+        : "";
     const roleAgent = resolveRoleAgent(loop.agentMap, loop.launch.preset, activeRole) || "";
+    const prompt = renderIterationPromptText(loop, iteration, derived);
+    if (derived.guidanceMessages.length > 0) {
+        appendHarnessEvent(loop.paths.journalFile, loop.runtime.runId, String(iteration), "operator.guidance.consumed", `Consumed ${derived.guidanceMessages.length} guidance message(s)`);
+    }
     return {
         iteration,
         recentEvent: derived.routing.recentEvent,
@@ -41,7 +48,7 @@ export function buildIterationContext(loop, iteration) {
         lastRejected: derived.lastRejected,
         scratchpadText: derived.scratchpadText,
         memoryText: derived.memoryText,
-        prompt: renderIterationPromptText(loop, iteration, derived),
+        prompt,
         roleAgent,
     };
 }
@@ -174,7 +181,7 @@ export function lastRejectedTopic(runLines) {
     return last;
 }
 export function renderIterationPromptText(loop, iteration, derived) {
-    const { routing, backpressure, memoryStats, memoryText, tasksText, tasksStats, scratchpadText, invalidCount, lastRejected, } = derived;
+    const { routing, backpressure, memoryStats, memoryText, tasksText, tasksStats, guidanceMessages, scratchpadText, invalidCount, lastRejected, } = derived;
     const { allowedRoles, allowedEvents, recentEvent } = routing;
     return ("You are inside a bare-minimal autoloops harness.\n\n" +
         harnessInstructionsText(loop) +
@@ -183,6 +190,7 @@ export function renderIterationPromptText(loop, iteration, derived) {
         "Objective:\n" +
         loop.objective +
         "\n\n" +
+        renderGuidanceSection(guidanceMessages) +
         (memoryText ? `${memoryText}\n` : "") +
         (tasksText ? `${tasksText}\n` : "") +
         topology.renderWithContext(loop.topology, recentEvent, allowedRoles, allowedEvents) +
@@ -231,7 +239,7 @@ export function renderIterationPromptText(loop, iteration, derived) {
 }
 export function renderReviewPromptText(loop, iteration, runLines) {
     const derived = deriveRunContext(loop, runLines);
-    const { scratchpadText, memoryText, tasksText, memoryStats, tasksStats, routing, backpressure, invalidCount, lastRejected, } = derived;
+    const { scratchpadText, memoryText, tasksText, memoryStats, tasksStats, guidanceMessages, routing, backpressure, invalidCount, lastRejected, } = derived;
     const latestIteration = String(maxReviewPromptIteration(runLines));
     return ("You are the metareview meta-reviewer for this loop.\n\n" +
         "Your job is to improve the loop itself, not to finish the task directly.\n" +
@@ -245,6 +253,7 @@ export function renderReviewPromptText(loop, iteration, runLines) {
         reviewInstructionsText(loop) +
         contextPressureText(memoryStats, tasksStats, invalidCount, lastRejected) +
         backpressureText(backpressure) +
+        renderGuidanceSection(guidanceMessages) +
         (memoryText ? `${memoryText}\n` : "") +
         (tasksText ? `${tasksText}\n` : "") +
         `Review trigger iteration: ${iteration}\n` +
@@ -271,6 +280,36 @@ export function renderReviewPromptText(loop, iteration, runLines) {
         " --format text\n\n" +
         "If no improvements are needed, store a short learning explaining why and exit cleanly.\n");
 }
+export function drainGuidance(runLines) {
+    // Find the index of the last operator.guidance.consumed marker
+    let consumedIdx = -1;
+    for (let i = runLines.length - 1; i >= 0; i--) {
+        if (extractTopic(runLines[i]) === "operator.guidance.consumed") {
+            consumedIdx = i;
+            break;
+        }
+    }
+    // Collect all operator.guidance events after the last consumed marker
+    const messages = [];
+    for (let i = consumedIdx + 1; i < runLines.length; i++) {
+        if (extractTopic(runLines[i]) === "operator.guidance") {
+            const payload = extractField(runLines[i], "payload");
+            if (payload)
+                messages.push(payload);
+        }
+    }
+    return messages;
+}
+function renderGuidanceSection(guidance) {
+    if (guidance.length === 0)
+        return "";
+    const body = guidance.length === 1
+        ? guidance[0]
+        : guidance.map((g, i) => `${i + 1}. ${g}`).join("\n");
+    return ("## OPERATOR GUIDANCE\n\n" +
+        body +
+        "\n\n\u26a0\ufe0f Act on this guidance in this iteration. It will not be repeated.\n\n");
+}
 function harnessInstructionsText(loop) {
     if (!loop.harness.instructions)
         return "";

package/dist/harness/prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/harness/prompt.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,WAAW,IAAI,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,2BAA2B,EAC3B,YAAY,EACZ,WAAW,GACZ,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,SAAS,EACT,YAAY,GACb,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AA2B5D,SAAS,gBAAgB,CACvB,IAAiB,EACjB,QAAkB;IAElB,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAClD,MAAM,iBAAiB,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;IACtD,MAAM,SAAS,GAAG,iBAAiB,CACjC,iBAAiB,EACjB,IAAI,CAAC,KAAK,CAAC,WAAW,CACvB,CAAC;IACF,OAAO;QACL,cAAc,EAAE,yBAAyB,CAAC,QAAQ,CAAC;QACnD,UAAU,EAAE,MAAM,CAAC,UAAU,CAC3B,IAAI,CAAC,KAAK,CAAC,UAAU,EACrB,IAAI,CAAC,MAAM,CAAC,WAAW,CACxB;QACD,WAAW,EAAE,MAAM,CAAC,SAAS,CAC3B,IAAI,CAAC,KAAK,CAAC,UAAU,EACrB,IAAI,CAAC,MAAM,CAAC,WAAW,CACxB;QACD,SAAS;QACT,UAAU,EAAE;YACV,IAAI,EAAE,iBAAiB,CAAC,IAAI,CAAC,MAAM;YACnC,IAAI,EAAE,iBAAiB,CAAC,IAAI,CAAC,MAAM;YACnC,KAAK,EAAE,iBAAiB,CAAC,IAAI,CAAC,MAAM,GAAG,iBAAiB,CAAC,IAAI,CAAC,MAAM;SACrE;QACD,OAAO,EAAE,uBAAuB,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC;QACzD,YAAY,EAAE,iBAAiB,CAAC,QAAQ,CAAC;QACzC,YAAY,EAAE,iBAAiB,CAAC,QAAQ,CAAC;QACzC,YAAY,EAAE,iBAAiB,CAAC,QAAQ,CAAC;KAC1C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,IAAiB,EACjB,SAAiB;IAEjB,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC1E,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACjD,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACpG,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,IAAI,EAAE,CAAC;IAExF,OAAO;QACL,SAAS;QACT,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,WAAW;QACxC,YAAY,EAAE,OAAO,CAAC,OAAO,CAAC,YAAY;QAC1C,aAAa,EAAE,OAAO,CAAC,OAAO,CAAC,aAAa;QAC5C,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,MAAM,EAAE,yBAAyB,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC;QAC3D,SAAS;KACV,CAAC;AACJ,CAAC;AAQD,MAAM,UAAU,uBAAuB,CACrC,IAAuB,EACvB,QAAkB;IAElB,MAAM,WAAW,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IAEpD,IAAI,2BAA2B,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7C,OAAO,6BAA6B,CAAC,IAAI,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;IACpE,CAAC;IAED,OAAO;QACL,WAAW;QACX,YAAY,EAAE,QAAQ,CAAC,cAAc,CAAC,IAAI,EAAE,WAAW,CAAC;QACxD,aAAa,EAAE,QAAQ,CAAC,aAAa,CAAC,IAAI,EAAE,WAAW,CAAC;KACzD,CAAC;AACJ,CAAC;AAED,SAAS,6BAA6B,CACpC,IAAuB,EACvB,QAAkB,EAClB,WAAmB;IAEnB,MAAM,QAAQ,GAAG,wBAAwB,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IACjE,MAAM,YAAY,GAAG,kBAAkB,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IAC/D,MAAM,iBAAiB,GAAG,iBAAiB,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IACnE,MAAM,aAAa,GAAG,QAAQ,CAAC,cAAc,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAClE,MAAM,cAAc,GAAG,QAAQ,CAAC,aAAa,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAClE,MAAM,aAAa,GAAG,YAAY,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IAC7D,MAAM,cAAc,GAAG,YAAY,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;IAE/D,OAAO;QACL,WAAW,EAAE,iBAAiB;QAC9B,YAAY,EAAE,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,aAAa;QACtE,aAAa,EAAE,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,cAAc;KAC3E,CAAC;AACJ,CAAC;AAED,SAAS,wBAAwB,CAC/B,KAAe,EACf,WAAmB;IAEnB,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,YAAY,CAAC,IAAI,CAAC,KAAK,kBAAkB,EAAE,CAAC;YAC9C,IAAI,YAAY,CAAC,IAAI,EAAE,cAAc,CAAC,KAAK,WAAW,EAAE,CAAC;gBACvD,OAAO,GAAG,IAAI,CAAC;YACjB,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,kBAAkB,CAAC,QAAgB,EAAE,WAAmB;IAC/D,IAAI,CAAC,QAAQ;QAAE,OAAO,yBAAyB,CAAC,WAAW,CAAC,CAAC;IAC7D,MAAM,KAAK,GAAG,YAAY,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;IACtD,OAAO,KAAK,IAAI,yBAAyB,CAAC,WAAW,CAAC,CAAC;AACzD,CAAC;AAED,SAAS,yBAAyB,CAAC,WAAmB;IACpD,IAAI,WAAW,KAAK,yBAAyB;QAAE,OAAO,YAAY,CAAC;IACnE,IAAI,WAAW,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;QAC7C,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,SAAS,iBAAiB,CAAC,QAAgB,EAAE,WAAmB;IAC9D,IAAI,CAAC,QAAQ;QAAE,OAAO,WAAW,CAAC;IAClC,OAAO,YAAY,CAAC,QAAQ,EAAE,qBAAqB,CAAC,IAAI,WAAW,CAAC;AACtE,CAAC;AAED,SAAS,YAAY,CAAC,IAAY,EAAE,KAAa;IAC/C,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACxC,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,OAAO,KAAK;SACT,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAe;IACnD,IAAI,OAAO,GAAG,YAAY,CAAC;IAC3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,KAAK,KAAK,eAAe,EAAE,CAAC;YAC9B,MAAM,SAAS,GAAG,YAAY,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;YACrD,IAAI,SAAS;gBAAE,OAAO,GAAG,SAAS,CAAC;QACrC,CAAC;aAAM,IAAI,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/B,OAAO,GAAG,KAAK,CAAC;QAClB,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,QAAkB;IAClD,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,KAAK,KAAK,eAAe,EAAE,CAAC;YAC9B,IAAI,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;QACnC,CAAC;aAAM,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/B,IAAI,GAAG,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,mBAAmB,CAAC,IAAY;IACvC,OAAO,CACL,WAAW;QACX,YAAY,CAAC,IAAI,EAAE,SAAS,CAAC;QAC7B,WAAW;QACX,YAAY,CAAC,IAAI,EAAE,cAAc,CAAC;QAClC,MAAM;QACN,mBAAmB;QACnB,aAAa,CAAC,YAAY,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;QACpD,IAAI;QACJ,uBAAuB;QACvB,aAAa,CAAC,YAAY,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;QACnD,IAAI;QACJ,gDAAgD,CACjD,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,IAAY;IACjC,OAAO,IAAI,IAAI,QAAQ,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,QAAkB;IAClD,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,IAAI,YAAY,CAAC,IAAI,CAAC,KAAK,eAAe;YAAE,KAAK,EAAE,CAAC;IACtD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,QAAkB;IAClD,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,IAAI,YAAY,CAAC,IAAI,CAAC,KAAK,eAAe,EAAE,CAAC;YAC3C,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,IAAiB,EACjB,SAAiB,EACjB,OAA0B;IAE1B,MAAM,EACJ,OAAO,EACP,YAAY,EACZ,WAAW,EACX,UAAU,EACV,SAAS,EACT,UAAU,EACV,cAAc,EACd,YAAY,EACZ,YAAY,GACb,GAAG,OAAO,CAAC;IACZ,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;IAC7D,OAAO,CACL,sDAAsD;QACtD,uBAAuB,CAAC,IAAI,CAAC;QAC7B,mBAAmB,CAAC,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,CAAC;QACxE,gBAAgB,CAAC,YAAY,CAAC;QAC9B,cAAc;QACd,IAAI,CAAC,SAAS;QACd,MAAM;QACN,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,UAAU,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACrC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACnC,QAAQ,CAAC,iBAAiB,CACxB,IAAI,CAAC,QAAQ,EACb,WAAW,EACX,YAAY,EACZ,aAAa,CACd;QACD,IAAI;QACJ,kBAAkB,CAAC,IAAI,EAAE,aAAa,CAAC;QACvC,cAAc,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,IAAI;QACxD,cAAc,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI;QACvC,qBAAqB,IAAI,CAAC,UAAU,CAAC,KAAK,IAAI;QAC9C,gCAAgC,IAAI,CAAC,UAAU,CAAC,OAAO,IAAI;QAC3D,oBAAoB,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,IAAI;QACxH,0CAA0C,IAAI,CAAC,KAAK,CAAC,QAAQ,IAAI;QACjE,uEAAuE,IAAI,CAAC,KAAK,CAAC,QAAQ,YAAY,IAAI,CAAC,KAAK,CAAC,QAAQ,mBAAmB,IAAI,CAAC,KAAK,CAAC,QAAQ,WAAW;QAC1K,6BAA6B,QAAQ,CAAC,YAAY,CAAC,IAAI;QACvD,4BAA4B,QAAQ,CAAC,aAAa,CAAC,IAAI;QACvD,cAAc;QACd,IAAI,CAAC,KAAK,CAAC,QAAQ;QACnB,MAAM;QACN,uBAAuB;QACvB,CAAC,cAAc,IAAI,SAAS,CAAC;QAC7B,MAAM;QACN,2EAA2E;QAC3E,aAAa;QACb,IAAI,CAAC,KAAK,CAAC,QAAQ;QACnB,iDAAiD;QACjD,IAAI,CAAC,KAAK,CAAC,QAAQ;QACnB,QAAQ;QACR,IAAI,CAAC,UAAU,CAAC,KAAK;QACrB,+BAA+B;QAC/B,IAAI,CAAC,KAAK,CAAC,QAAQ;QACnB,yCAAyC;QACzC,IAAI,CAAC,KAAK,CAAC,QAAQ;QACnB,2DAA2D;QAC3D,IAAI,CAAC,KAAK,CAAC,QAAQ;QACnB,wCAAwC;QACxC,IAAI,CAAC,KAAK,CAAC,QAAQ;QACnB,2BAA2B;QAC3B,0IAA0I;QAC1I,kFAAkF;QAClF,IAAI,CAAC,KAAK,CAAC,QAAQ;QACnB,mBAAmB,SAAS,oBAAoB;QAChD,IAAI,CAAC,KAAK,CAAC,QAAQ;QACnB,yCAAyC;QACzC,IAAI,CAAC,KAAK,CAAC,QAAQ;QACnB,iCAAiC;QACjC,yGAAyG,CAC1G,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,IAAiB,EACjB,SAAiB,EACjB,QAAkB;IAElB,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACjD,MAAM,EACJ,cAAc,EACd,UAAU,EACV,SAAS,EACT,WAAW,EACX,UAAU,EACV,OAAO,EACP,YAAY,EACZ,YAAY,EACZ,YAAY,GACb,GAAG,OAAO,CAAC;IACZ,MAAM,eAAe,GAAG,MAAM,CAAC,wBAAwB,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEnE,OAAO,CACL,yDAAyD;QACzD,4EAA4E;QAC5E,+GAA+G;QAC/G,yHAAyH,IAAI,CAAC,KAAK,CAAC,QAAQ,oBAAoB,IAAI,CAAC,KAAK,CAAC,QAAQ,iBAAiB,IAAI,CAAC,KAAK,CAAC,QAAQ,qBAAqB,IAAI,CAAC,KAAK,CAAC,QAAQ,mBAAmB,IAAI,CAAC,KAAK,CAAC,QAAQ,iBAAiB;QACtT,qCAAqC,IAAI,CAAC,KAAK,CAAC,QAAQ,gEAAgE;QACxH,SAAS,IAAI,CAAC,KAAK,CAAC,QAAQ,mGAAmG;QAC/H,0FAA0F,IAAI,CAAC,KAAK,CAAC,QAAQ,0CAA0C;QACvJ,uLAAuL;QACvL,mDAAmD;QACnD,sBAAsB,CAAC,IAAI,CAAC;QAC5B,mBAAmB,CAAC,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,CAAC;QACxE,gBAAgB,CAAC,YAAY,CAAC;QAC9B,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,UAAU,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACrC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACnC,6BAA6B,SAAS,IAAI;QAC1C,wBAAwB;QACxB,OAAO,CAAC,WAAW;QACnB,MAAM;QACN,QAAQ,CAAC,iBAAiB,CACxB,IAAI,CAAC,QAAQ,EACb,OAAO,CAAC,WAAW,EACnB,OAAO,CAAC,YAAY,EACpB,OAAO,CAAC,aAAa,CACtB;QACD,IAAI;QACJ,uBAAuB;QACvB,CAAC,cAAc,IAAI,SAAS,CAAC;QAC7B,MAAM;QACN,oBAAoB;QACpB,IAAI,CAAC,KAAK,CAAC,QAAQ;QACnB,mCAAmC;QACnC,IAAI,CAAC,KAAK,CAAC,QAAQ;QACnB,+BAA+B;QAC/B,IAAI,CAAC,KAAK,CAAC,QAAQ;QACnB,kBAAkB;QAClB,eAAe;QACf,gBAAgB;QAChB,IAAI,CAAC,KAAK,CAAC,QAAQ;QACnB,kBAAkB;QAClB,eAAe;QACf,oBAAoB;QACpB,0FAA0F,CAC3F,CAAC;AACJ,CAAC;AAED,SAAS,uBAAuB,CAAC,IAAiB;IAChD,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY;QAAE,OAAO,EAAE,CAAC;IAC1C,OAAO,+BAA+B,IAAI,CAAC,OAAO,CAAC,YAAY,MAAM,CAAC;AACxE,CAAC;AAED,SAAS,sBAAsB,CAAC,IAAiB;IAC/C,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IACnC,OAAO,wCAAwC,IAAI,CAAC,MAAM,CAAC,MAAM,MAAM,CAAC;AAC1E,CAAC;AAED,SAAS,mBAAmB,CAC1B,WAAwB,EACxB,UAAyD,EACzD,YAAoB,EACpB,YAAoB;IAEpB,OAAO,CACL,qBAAqB;QACrB,YAAY;QACZ,qBAAqB,CAAC,WAAW,CAAC;QAClC,IAAI;QACJ,WAAW;QACX,oBAAoB,CAAC,UAAU,CAAC;QAChC,IAAI;QACJ,4BAA4B;QAC5B,YAAY;QACZ,eAAe,CAAC,YAAY,EAAE,YAAY,CAAC;QAC3C,IAAI;QACJ,6BAA6B,CAAC,WAAW,CAAC,SAAS,EAAE,YAAY,CAAC,CACnE,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAAC,KAI7B;IACC,IAAI,KAAK,CAAC,KAAK,KAAK,CAAC;QAAE,OAAO,UAAU,CAAC;IACzC,OAAO,GAAG,KAAK,CAAC,IAAI,UAAU,KAAK,CAAC,IAAI,UAAU,KAAK,CAAC,KAAK,SAAS,CAAC;AACzE,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAkB;IAC/C,MAAM,WAAW,GAAG,GAAG,KAAK,CAAC,YAAY,aAAa,KAAK,CAAC,WAAW,iBAAiB,KAAK,CAAC,SAAS,eAAe,KAAK,CAAC,IAAI,QAAQ,CAAC;IACzI,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;QACpB,OAAO,GAAG,KAAK,CAAC,aAAa,IAAI,KAAK,CAAC,WAAW,iBAAiB,WAAW,mBAAmB,KAAK,CAAC,aAAa,GAAG,KAAK,CAAC,WAAW,qDAAqD,CAAC;IAChM,CAAC;IACD,IAAI,KAAK,CAAC,WAAW,IAAI,CAAC,EAAE,CAAC;QAC3B,OAAO,GAAG,KAAK,CAAC,aAAa,iBAAiB,WAAW,0BAA0B,CAAC;IACtF,CAAC;IACD,OAAO,GAAG,KAAK,CAAC,aAAa,IAAI,KAAK,CAAC,WAAW,iBAAiB,WAAW,EAAE,CAAC;AACnF,CAAC;AAED,SAAS,eAAe,CAAC,YAAoB,EAAE,YAAoB;IACjE,IAAI,YAAY,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAClC,IAAI,CAAC,YAAY;QAAE,OAAO,4CAA4C,CAAC;IACvE,OAAO,6CAA6C,YAAY,IAAI,CAAC;AACvE,CAAC;AAED,SAAS,6BAA6B,CACpC,SAAkB,EAClB,YAAoB;IAEpB,IAAI,SAAS,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;QAClC,OAAO,8IAA8I,CAAC;IACxJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAY;IACpC,OAAO,IAAI,CAAC,CAAC,CAAC,kBAAkB,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;AAClD,CAAC;AAED,SAAS,kBAAkB,CACzB,IAAiB,EACjB,aAAuB;IAEvB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU;QAAE,OAAO,EAAE,CAAC;IACjE,MAAM,QAAQ,GAAG,4BAA4B,CAC3C,aAAa,EACb,IAAI,CAAC,UAAU,CAAC,KAAK,CACtB,CAAC;IACF,MAAM,YAAY,GAChB,QAAQ,CAAC,MAAM,KAAK,CAAC;QACnB,CAAC,CAAC,8GAA8G;QAChH,CAAC,CAAC,sEAAsE;YACtE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YAC1C,KAAK,CAAC;IACZ,OAAO,CACL,2BAA2B;QAC3B,8GAA8G;QAC9G,YAAY;QACZ,sEAAsE,IAAI,CAAC,QAAQ,CAAC,WAAW,gCAAgC;QAC/H,oIAAoI;QACpI,4CAA4C,IAAI,CAAC,KAAK,CAAC,QAAQ,6GAA6G,CAC7K,CAAC;AACJ,CAAC;AAED,SAAS,4BAA4B,CACnC,aAAuB,EACvB,eAAuB;IAEvB,OAAO,aAAa;SACjB,MAAM,CACL,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,KAAK,eAAe;QACrB,CAAC,iBAAiB,CAAC,CAAC,CAAC;QACrB,CAAC,eAAe,CAAC,CAAC,CAAC;QACnB,CAAC,aAAa,CAAC,CAAC,CAAC,CACpB;SACA,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;AACjC,CAAC;AAED,SAAS,wBAAwB,CAAC,QAAkB;IAClD,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,IAAI,YAAY,CAAC,IAAI,CAAC,KAAK,iBAAiB,EAAE,CAAC;YAC7C,MAAM,GAAG,GAAG,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;YACjD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,OAAO;gBAAE,OAAO,GAAG,GAAG,CAAC;QACzD,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/harness/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD,OAAO,KAAK,MAAM,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,WAAW,IAAI,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,2BAA2B,EAC3B,YAAY,EACZ,WAAW,GACZ,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,SAAS,EACT,YAAY,GACb,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AA4B5D,SAAS,gBAAgB,CACvB,IAAiB,EACjB,QAAkB;IAElB,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAClD,MAAM,iBAAiB,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;IACtD,MAAM,SAAS,GAAG,iBAAiB,CACjC,iBAAiB,EACjB,IAAI,CAAC,KAAK,CAAC,WAAW,CACvB,CAAC;IACF,OAAO;QACL,cAAc,EAAE,yBAAyB,CAAC,QAAQ,CAAC;QACnD,UAAU,EAAE,MAAM,CAAC,UAAU,CAC3B,IAAI,CAAC,KAAK,CAAC,UAAU,EACrB,IAAI,CAAC,MAAM,CAAC,WAAW,CACxB;QACD,WAAW,EAAE,MAAM,CAAC,SAAS,CAC3B,IAAI,CAAC,KAAK,CAAC,UAAU,EACrB,IAAI,CAAC,MAAM,CAAC,WAAW,CACxB;QACD,SAAS;QACT,UAAU,EAAE;YACV,IAAI,EAAE,iBAAiB,CAAC,IAAI,CAAC,MAAM;YACnC,IAAI,EAAE,iBAAiB,CAAC,IAAI,CAAC,MAAM;YACnC,KAAK,EAAE,iBAAiB,CAAC,IAAI,CAAC,MAAM,GAAG,iBAAiB,CAAC,IAAI,CAAC,MAAM;SACrE;QACD,gBAAgB,EAAE,aAAa,CAAC,QAAQ,CAAC;QACzC,OAAO,EAAE,uBAAuB,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC;QACzD,YAAY,EAAE,iBAAiB,CAAC,QAAQ,CAAC;QACzC,YAAY,EAAE,iBAAiB,CAAC,QAAQ,CAAC;QACzC,YAAY,EAAE,iBAAiB,CAAC,QAAQ,CAAC;KAC1C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,IAAiB,EACjB,SAAiB;IAEjB,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC1E,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACjD,MAAM,UAAU,GACd,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,MAAM,KAAK,CAAC;QACvC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;QACjC,CAAC,CAAC,EAAE,CAAC;IACT,MAAM,SAAS,GACb,gBAAgB,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,IAAI,EAAE,CAAC;IAExE,MAAM,MAAM,GAAG,yBAAyB,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IAEnE,IAAI,OAAO,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxC,kBAAkB,CAChB,IAAI,CAAC,KAAK,CAAC,WAAW,EACtB,IAAI,CAAC,OAAO,CAAC,KAAK,EAClB,MAAM,CAAC,SAAS,CAAC,EACjB,4BAA4B,EAC5B,YAAY,OAAO,CAAC,gBAAgB,CAAC,MAAM,sBAAsB,CAClE,CAAC;IACJ,CAAC;IAED,OAAO;QACL,SAAS;QACT,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,WAAW;QACxC,YAAY,EAAE,OAAO,CAAC,OAAO,CAAC,YAAY;QAC1C,aAAa,EAAE,OAAO,CAAC,OAAO,CAAC,aAAa;QAC5C,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,MAAM;QACN,SAAS;KACV,CAAC;AACJ,CAAC;AAQD,MAAM,UAAU,uBAAuB,CACrC,IAAuB,EACvB,QAAkB;IAElB,MAAM,WAAW,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IAEpD,IAAI,2BAA2B,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7C,OAAO,6BAA6B,CAAC,IAAI,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;IACpE,CAAC;IAED,OAAO;QACL,WAAW;QACX,YAAY,EAAE,QAAQ,CAAC,cAAc,CAAC,IAAI,EAAE,WAAW,CAAC;QACxD,aAAa,EAAE,QAAQ,CAAC,aAAa,CAAC,IAAI,EAAE,WAAW,CAAC;KACzD,CAAC;AACJ,CAAC;AAED,SAAS,6BAA6B,CACpC,IAAuB,EACvB,QAAkB,EAClB,WAAmB;IAEnB,MAAM,QAAQ,GAAG,wBAAwB,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IACjE,MAAM,YAAY,GAAG,kBAAkB,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IAC/D,MAAM,iBAAiB,GAAG,iBAAiB,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IACnE,MAAM,aAAa,GAAG,QAAQ,CAAC,cAAc,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAClE,MAAM,cAAc,GAAG,QAAQ,CAAC,aAAa,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAClE,MAAM,aAAa,GAAG,YAAY,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IAC7D,MAAM,cAAc,GAAG,YAAY,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;IAE/D,OAAO;QACL,WAAW,EAAE,iBAAiB;QAC9B,YAAY,EAAE,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,aAAa;QACtE,aAAa,EAAE,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,cAAc;KAC3E,CAAC;AACJ,CAAC;AAED,SAAS,wBAAwB,CAC/B,KAAe,EACf,WAAmB;IAEnB,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,YAAY,CAAC,IAAI,CAAC,KAAK,kBAAkB,EAAE,CAAC;YAC9C,IAAI,YAAY,CAAC,IAAI,EAAE,cAAc,CAAC,KAAK,WAAW,EAAE,CAAC;gBACvD,OAAO,GAAG,IAAI,CAAC;YACjB,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,kBAAkB,CAAC,QAAgB,EAAE,WAAmB;IAC/D,IAAI,CAAC,QAAQ;QAAE,OAAO,yBAAyB,CAAC,WAAW,CAAC,CAAC;IAC7D,MAAM,KAAK,GAAG,YAAY,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;IACtD,OAAO,KAAK,IAAI,yBAAyB,CAAC,WAAW,CAAC,CAAC;AACzD,CAAC;AAED,SAAS,yBAAyB,CAAC,WAAmB;IACpD,IAAI,WAAW,KAAK,yBAAyB;QAAE,OAAO,YAAY,CAAC;IACnE,IAAI,WAAW,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;QAC7C,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,SAAS,iBAAiB,CAAC,QAAgB,EAAE,WAAmB;IAC9D,IAAI,CAAC,QAAQ;QAAE,OAAO,WAAW,CAAC;IAClC,OAAO,YAAY,CAAC,QAAQ,EAAE,qBAAqB,CAAC,IAAI,WAAW,CAAC;AACtE,CAAC;AAED,SAAS,YAAY,CAAC,IAAY,EAAE,KAAa;IAC/C,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACxC,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,OAAO,KAAK;SACT,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAe;IACnD,IAAI,OAAO,GAAG,YAAY,CAAC;IAC3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,KAAK,KAAK,eAAe,EAAE,CAAC;YAC9B,MAAM,SAAS,GAAG,YAAY,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;YACrD,IAAI,SAAS;gBAAE,OAAO,GAAG,SAAS,CAAC;QACrC,CAAC;aAAM,IAAI,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/B,OAAO,GAAG,KAAK,CAAC;QAClB,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,QAAkB;IAClD,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,KAAK,KAAK,eAAe,EAAE,CAAC;YAC9B,IAAI,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;QACnC,CAAC;aAAM,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/B,IAAI,GAAG,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,mBAAmB,CAAC,IAAY;IACvC,OAAO,CACL,WAAW;QACX,YAAY,CAAC,IAAI,EAAE,SAAS,CAAC;QAC7B,WAAW;QACX,YAAY,CAAC,IAAI,EAAE,cAAc,CAAC;QAClC,MAAM;QACN,mBAAmB;QACnB,aAAa,CAAC,YAAY,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;QACpD,IAAI;QACJ,uBAAuB;QACvB,aAAa,CAAC,YAAY,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;QACnD,IAAI;QACJ,gDAAgD,CACjD,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,IAAY;IACjC,OAAO,IAAI,IAAI,QAAQ,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,QAAkB;IAClD,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,IAAI,YAAY,CAAC,IAAI,CAAC,KAAK,eAAe;YAAE,KAAK,EAAE,CAAC;IACtD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,QAAkB;IAClD,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,IAAI,YAAY,CAAC,IAAI,CAAC,KAAK,eAAe,EAAE,CAAC;YAC3C,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,IAAiB,EACjB,SAAiB,EACjB,OAA0B;IAE1B,MAAM,EACJ,OAAO,EACP,YAAY,EACZ,WAAW,EACX,UAAU,EACV,SAAS,EACT,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,YAAY,GACb,GAAG,OAAO,CAAC;IACZ,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;IAC7D,OAAO,CACL,sDAAsD;QACtD,uBAAuB,CAAC,IAAI,CAAC;QAC7B,mBAAmB,CAAC,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,CAAC;QACxE,gBAAgB,CAAC,YAAY,CAAC;QAC9B,cAAc;QACd,IAAI,CAAC,SAAS;QACd,MAAM;QACN,qBAAqB,CAAC,gBAAgB,CAAC;QACvC,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,UAAU,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACrC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACnC,QAAQ,CAAC,iBAAiB,CACxB,IAAI,CAAC,QAAQ,EACb,WAAW,EACX,YAAY,EACZ,aAAa,CACd;QACD,IAAI;QACJ,kBAAkB,CAAC,IAAI,EAAE,aAAa,CAAC;QACvC,cAAc,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,IAAI;QACxD,cAAc,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI;QACvC,qBAAqB,IAAI,CAAC,UAAU,CAAC,KAAK,IAAI;QAC9C,gCAAgC,IAAI,CAAC,UAAU,CAAC,OAAO,IAAI;QAC3D,oBAAoB,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,IAAI;QACxH,0CAA0C,IAAI,CAAC,KAAK,CAAC,QAAQ,IAAI;QACjE,uEAAuE,IAAI,CAAC,KAAK,CAAC,QAAQ,YAAY,IAAI,CAAC,KAAK,CAAC,QAAQ,mBAAmB,IAAI,CAAC,KAAK,CAAC,QAAQ,WAAW;QAC1K,6BAA6B,QAAQ,CAAC,YAAY,CAAC,IAAI;QACvD,4BAA4B,QAAQ,CAAC,aAAa,CAAC,IAAI;QACvD,cAAc;QACd,IAAI,CAAC,KAAK,CAAC,QAAQ;QACnB,MAAM;QACN,uBAAuB;QACvB,CAAC,cAAc,IAAI,SAAS,CAAC;QAC7B,MAAM;QACN,2EAA2E;QAC3E,aAAa;QACb,IAAI,CAAC,KAAK,CAAC,QAAQ;QACnB,iDAAiD;QACjD,IAAI,CAAC,KAAK,CAAC,QAAQ;QACnB,QAAQ;QACR,IAAI,CAAC,UAAU,CAAC,KAAK;QACrB,+BAA+B;QAC/B,IAAI,CAAC,KAAK,CAAC,QAAQ;QACnB,yCAAyC;QACzC,IAAI,CAAC,KAAK,CAAC,QAAQ;QACnB,2DAA2D;QAC3D,IAAI,CAAC,KAAK,CAAC,QAAQ;QACnB,wCAAwC;QACxC,IAAI,CAAC,KAAK,CAAC,QAAQ;QACnB,2BAA2B;QAC3B,0IAA0I;QAC1I,kFAAkF;QAClF,IAAI,CAAC,KAAK,CAAC,QAAQ;QACnB,mBAAmB,SAAS,oBAAoB;QAChD,IAAI,CAAC,KAAK,CAAC,QAAQ;QACnB,yCAAyC;QACzC,IAAI,CAAC,KAAK,CAAC,QAAQ;QACnB,iCAAiC;QACjC,yGAAyG,CAC1G,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,IAAiB,EACjB,SAAiB,EACjB,QAAkB;IAElB,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACjD,MAAM,EACJ,cAAc,EACd,UAAU,EACV,SAAS,EACT,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,OAAO,EACP,YAAY,EACZ,YAAY,EACZ,YAAY,GACb,GAAG,OAAO,CAAC;IACZ,MAAM,eAAe,GAAG,MAAM,CAAC,wBAAwB,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEnE,OAAO,CACL,yDAAyD;QACzD,4EAA4E;QAC5E,+GAA+G;QAC/G,yHAAyH,IAAI,CAAC,KAAK,CAAC,QAAQ,oBAAoB,IAAI,CAAC,KAAK,CAAC,QAAQ,iBAAiB,IAAI,CAAC,KAAK,CAAC,QAAQ,qBAAqB,IAAI,CAAC,KAAK,CAAC,QAAQ,mBAAmB,IAAI,CAAC,KAAK,CAAC,QAAQ,iBAAiB;QACtT,qCAAqC,IAAI,CAAC,KAAK,CAAC,QAAQ,gEAAgE;QACxH,SAAS,IAAI,CAAC,KAAK,CAAC,QAAQ,mGAAmG;QAC/H,0FAA0F,IAAI,CAAC,KAAK,CAAC,QAAQ,0CAA0C;QACvJ,uLAAuL;QACvL,mDAAmD;QACnD,sBAAsB,CAAC,IAAI,CAAC;QAC5B,mBAAmB,CAAC,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,CAAC;QACxE,gBAAgB,CAAC,YAAY,CAAC;QAC9B,qBAAqB,CAAC,gBAAgB,CAAC;QACvC,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,UAAU,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACrC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACnC,6BAA6B,SAAS,IAAI;QAC1C,wBAAwB;QACxB,OAAO,CAAC,WAAW;QACnB,MAAM;QACN,QAAQ,CAAC,iBAAiB,CACxB,IAAI,CAAC,QAAQ,EACb,OAAO,CAAC,WAAW,EACnB,OAAO,CAAC,YAAY,EACpB,OAAO,CAAC,aAAa,CACtB;QACD,IAAI;QACJ,uBAAuB;QACvB,CAAC,cAAc,IAAI,SAAS,CAAC;QAC7B,MAAM;QACN,oBAAoB;QACpB,IAAI,CAAC,KAAK,CAAC,QAAQ;QACnB,mCAAmC;QACnC,IAAI,CAAC,KAAK,CAAC,QAAQ;QACnB,+BAA+B;QAC/B,IAAI,CAAC,KAAK,CAAC,QAAQ;QACnB,kBAAkB;QAClB,eAAe;QACf,gBAAgB;QAChB,IAAI,CAAC,KAAK,CAAC,QAAQ;QACnB,kBAAkB;QAClB,eAAe;QACf,oBAAoB;QACpB,0FAA0F,CAC3F,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,QAAkB;IAC9C,+DAA+D;IAC/D,IAAI,WAAW,GAAG,CAAC,CAAC,CAAC;IACrB,KAAK,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9C,IAAI,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,4BAA4B,EAAE,CAAC;YAC/D,WAAW,GAAG,CAAC,CAAC;YAChB,MAAM;QACR,CAAC;IACH,CAAC;IAED,sEAAsE;IACtE,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,IAAI,CAAC,GAAG,WAAW,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvD,IAAI,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,mBAAmB,EAAE,CAAC;YACtD,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;YACrD,IAAI,OAAO;gBAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,qBAAqB,CAAC,QAAkB;IAC/C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACrC,MAAM,IAAI,GACR,QAAQ,CAAC,MAAM,KAAK,CAAC;QACnB,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;QACb,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1D,OAAO,CACL,0BAA0B;QAC1B,IAAI;QACJ,uFAAuF,CACxF,CAAC;AACJ,CAAC;AAED,SAAS,uBAAuB,CAAC,IAAiB;IAChD,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY;QAAE,OAAO,EAAE,CAAC;IAC1C,OAAO,+BAA+B,IAAI,CAAC,OAAO,CAAC,YAAY,MAAM,CAAC;AACxE,CAAC;AAED,SAAS,sBAAsB,CAAC,IAAiB;IAC/C,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IACnC,OAAO,wCAAwC,IAAI,CAAC,MAAM,CAAC,MAAM,MAAM,CAAC;AAC1E,CAAC;AAED,SAAS,mBAAmB,CAC1B,WAAwB,EACxB,UAAyD,EACzD,YAAoB,EACpB,YAAoB;IAEpB,OAAO,CACL,qBAAqB;QACrB,YAAY;QACZ,qBAAqB,CAAC,WAAW,CAAC;QAClC,IAAI;QACJ,WAAW;QACX,oBAAoB,CAAC,UAAU,CAAC;QAChC,IAAI;QACJ,4BAA4B;QAC5B,YAAY;QACZ,eAAe,CAAC,YAAY,EAAE,YAAY,CAAC;QAC3C,IAAI;QACJ,6BAA6B,CAAC,WAAW,CAAC,SAAS,EAAE,YAAY,CAAC,CACnE,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAAC,KAI7B;IACC,IAAI,KAAK,CAAC,KAAK,KAAK,CAAC;QAAE,OAAO,UAAU,CAAC;IACzC,OAAO,GAAG,KAAK,CAAC,IAAI,UAAU,KAAK,CAAC,IAAI,UAAU,KAAK,CAAC,KAAK,SAAS,CAAC;AACzE,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAkB;IAC/C,MAAM,WAAW,GAAG,GAAG,KAAK,CAAC,YAAY,aAAa,KAAK,CAAC,WAAW,iBAAiB,KAAK,CAAC,SAAS,eAAe,KAAK,CAAC,IAAI,QAAQ,CAAC;IACzI,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;QACpB,OAAO,GAAG,KAAK,CAAC,aAAa,IAAI,KAAK,CAAC,WAAW,iBAAiB,WAAW,mBAAmB,KAAK,CAAC,aAAa,GAAG,KAAK,CAAC,WAAW,qDAAqD,CAAC;IAChM,CAAC;IACD,IAAI,KAAK,CAAC,WAAW,IAAI,CAAC,EAAE,CAAC;QAC3B,OAAO,GAAG,KAAK,CAAC,aAAa,iBAAiB,WAAW,0BAA0B,CAAC;IACtF,CAAC;IACD,OAAO,GAAG,KAAK,CAAC,aAAa,IAAI,KAAK,CAAC,WAAW,iBAAiB,WAAW,EAAE,CAAC;AACnF,CAAC;AAED,SAAS,eAAe,CAAC,YAAoB,EAAE,YAAoB;IACjE,IAAI,YAAY,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAClC,IAAI,CAAC,YAAY;QAAE,OAAO,4CAA4C,CAAC;IACvE,OAAO,6CAA6C,YAAY,IAAI,CAAC;AACvE,CAAC;AAED,SAAS,6BAA6B,CACpC,SAAkB,EAClB,YAAoB;IAEpB,IAAI,SAAS,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;QAClC,OAAO,8IAA8I,CAAC;IACxJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAY;IACpC,OAAO,IAAI,CAAC,CAAC,CAAC,kBAAkB,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;AAClD,CAAC;AAED,SAAS,kBAAkB,CACzB,IAAiB,EACjB,aAAuB;IAEvB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU;QAAE,OAAO,EAAE,CAAC;IACjE,MAAM,QAAQ,GAAG,4BAA4B,CAC3C,aAAa,EACb,IAAI,CAAC,UAAU,CAAC,KAAK,CACtB,CAAC;IACF,MAAM,YAAY,GAChB,QAAQ,CAAC,MAAM,KAAK,CAAC;QACnB,CAAC,CAAC,8GAA8G;QAChH,CAAC,CAAC,sEAAsE;YACtE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YAC1C,KAAK,CAAC;IACZ,OAAO,CACL,2BAA2B;QAC3B,8GAA8G;QAC9G,YAAY;QACZ,sEAAsE,IAAI,CAAC,QAAQ,CAAC,WAAW,gCAAgC;QAC/H,oIAAoI;QACpI,4CAA4C,IAAI,CAAC,KAAK,CAAC,QAAQ,6GAA6G,CAC7K,CAAC;AACJ,CAAC;AAED,SAAS,4BAA4B,CACnC,aAAuB,EACvB,eAAuB;IAEvB,OAAO,aAAa;SACjB,MAAM,CACL,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,KAAK,eAAe;QACrB,CAAC,iBAAiB,CAAC,CAAC,CAAC;QACrB,CAAC,eAAe,CAAC,CAAC,CAAC;QACnB,CAAC,aAAa,CAAC,CAAC,CAAC,CACpB;SACA,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;AACjC,CAAC;AAED,SAAS,wBAAwB,CAAC,QAAkB;IAClD,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,IAAI,YAAY,CAAC,IAAI,CAAC,KAAK,iBAAiB,EAAE,CAAC;YAC7C,MAAM,GAAG,GAAG,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;YACjD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,OAAO;gBAAE,OAAO,GAAG,GAAG,CAAC;QACzD,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/harness/types.d.ts

@@ -1,6 +1,6 @@
-import type * as topo from "../topology.js";
-import type { KiroSessionHandle } from "../backend/kiro-bridge.js";
 import type { AgentMap } from "../agent-map.js";
+import type { KiroSessionHandle } from "../backend/kiro-bridge.js";
+import type * as topo from "../topology.js";
 export type TriggerSource = "cli" | "chain" | "branch";
 export interface LaunchMetadata {
     preset: string;

package/dist/main.js

@@ -1,8 +1,10 @@
 import { existsSync } from "node:fs";
 import { join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
 import { dispatchChain } from "./commands/chain.js";
 import { dispatchConfig } from "./commands/config.js";
 import { dispatchDashboard } from "./commands/dashboard.js";
+import { dispatchGuide } from "./commands/guide.js";
 import { dispatchInspect } from "./commands/inspect.js";
 import { dispatchList } from "./commands/list.js";
 import { dispatchLoops } from "./commands/loops.js";
@@ -71,6 +73,9 @@ function dispatch(args, argv) {
         case "config":
             dispatchConfig(args.slice(1));
             return;
+        case "guide":
+            dispatchGuide(args.slice(1));
+            return;
         case "dashboard":
             dispatchDashboard(args.slice(1), bundleRoot, selfCmd);
             return;
@@ -110,6 +115,7 @@ function isCliCommand(value) {
         "branch-run",
         "worktree",
         "config",
+        "guide",
         "dashboard",
         "--help",
         "-h",
@@ -123,14 +129,18 @@ function resolveBundleRoot(argv) {
     const envRoot = process.env.AUTOLOOPS_BUNDLE_ROOT;
     if (envRoot)
         return envRoot;
-    // Try to resolve from the script location
+    // Resolve relative to this file — works for both source and npm-installed binary
+    const thisFile = fileURLToPath(import.meta.url);
+    const candidate = resolve(thisFile, "../..");
+    if (existsSync(join(candidate, "presets")))
+        return candidate;
+    // Fallback: try argv[1] heuristic (works when running from source via bin/)
     const scriptPath = argv[1] ?? "";
     if (scriptPath) {
-        // The bundle root is the directory containing the script's parent project
         const scriptDir = resolve(scriptPath, "..");
-        const candidate = resolve(scriptDir, "..");
-        if (existsSync(join(candidate, "presets")))
-            return candidate;
+        const argvCandidate = resolve(scriptDir, "..");
+        if (existsSync(join(argvCandidate, "presets")))
+            return argvCandidate;
     }
     return ".";
 }

package/dist/main.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mobrienv/autoloop",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Autonomous LLM loop harness and control plane for long-horizon autonomous work",
   "type": "module",
   "main": "dist/main.js",
@@ -11,6 +11,7 @@
     "bin/autoloop",
     "dist",
     "presets",
+    "plugins",
     "README.md"
   ],
   "engines": {
@@ -46,7 +47,8 @@
     "test:coverage": "node --experimental-vm-modules node_modules/.bin/vitest run --coverage",
     "test:watch": "node --experimental-vm-modules node_modules/.bin/vitest",
     "check": "biome check src/ test/ && tsc --noEmit && npm run test:coverage",
-    "prepare": "husky"
+    "prepare": "husky",
+    "version": "node -e \"const p=require('./plugins/autoloop/.claude-plugin/plugin.json');p.version=require('./package.json').version;require('fs').writeFileSync('./plugins/autoloop/.claude-plugin/plugin.json',JSON.stringify(p,null,2)+'\\n')\" && git add plugins/autoloop/.claude-plugin/plugin.json"
   },
   "lint-staged": {
     "*.{ts,js,json}": [

package/plugins/autoloop/.claude-plugin/plugin.json

@@ -0,0 +1,9 @@
+{
+  "name": "autoloop",
+  "version": "0.3.0",
+  "description": "Run and operate autoloops — start runs, monitor progress, inject guidance, manage worktrees, inspect artifacts, and clean up.",
+  "homepage": "https://github.com/mikeyobrien/autoloop-ts",
+  "repository": "https://github.com/mikeyobrien/autoloop-ts",
+  "license": "MIT",
+  "keywords": ["autoloop", "ai-agents", "autonomous", "coding"]
+}

package/plugins/autoloop/skills/autoloop/SKILL.md

@@ -0,0 +1,225 @@
+---
+name: autoloop
+description: Run and operate autoloops — start runs, monitor progress, inject guidance, manage worktrees, inspect artifacts, and clean up. Use when the user asks to run an autoloop, check loop status, merge/clean worktrees, or operate on runs.
+argument-hint: [run|status|guide|merge|clean|inspect] [args...]
+---
+
+# Autoloop Operations
+
+You are operating the **autoloop** CLI to manage autonomous coding loops. Parse `$ARGUMENTS` to determine the operation. If no arguments or ambiguous, ask what the user needs.
+
+## Operations
+
+### Start a Run
+
+```bash
+# Basic run with a preset
+autoloop run <preset> "objective"
+
+# Run in isolated worktree (recommended for code changes)
+autoloop run <preset> "objective" --worktree
+
+# Auto-merge worktree on completion
+autoloop run <preset> "objective" --worktree --automerge
+
+# Run a chain of presets in sequence
+autoloop run --chain autocode,autoqa "objective" --worktree
+```
+
+**Presets:** autocode, autofix, autotest, autoqa, autoreview, autosimplify, autodoc, autosec, autoperf, autospec, autoresearch, autoideas, autopr, automerge
+
+**When to use `--worktree`:** Always for code-modifying presets (autocode, autofix, autosimplify, autoperf). Optional for read-only presets (autoreview, autoideas, autosec).
+
+**When to use `--automerge`:** When the user wants hands-off operation. Appends an automerge step that squash-merges on completion.
+
+**Backend override:** Use `-b claude` or `-b pi` or `-b kiro` to switch backends.
+
+Use `run_in_background: true` on the Bash tool when starting runs so the user isn't blocked.
+
+### Check Status
+
+```bash
+# List active runs
+autoloop loops
+
+# List all runs (including completed/failed)
+autoloop loops --all
+
+# Show details for a specific run (supports prefix match)
+autoloop loops show <run-id>
+
+# Watch a run live (polls every 2s, exits on completion)
+autoloop loops watch <run-id>
+
+# Health summary (stuck/watching/failed runs)
+autoloop loops health
+autoloop loops health --verbose
+```
+
+When the user asks "how's it going" or "status" with no specifics, run `autoloop loops` first. If there's one active run, follow up with `autoloop loops show <run-id>`.
+
+### Inject Guidance
+
+Send a message to a running loop. It appears once in the next iteration's prompt as `## OPERATOR GUIDANCE`, then is consumed.
+
+```bash
+# Guide the latest active run
+autoloop guide "Focus on error handling"
+
+# Guide a specific run
+autoloop guide --run <run-id> "Skip the auth module, focus on payments"
+```
+
+Use this when the user wants to steer a running loop without killing it.
+
+### Inspect Artifacts
+
+```bash
+# View the scratchpad (iteration-by-iteration summary)
+autoloop inspect scratchpad
+
+# View the prompt sent to backend for a specific iteration
+autoloop inspect prompt <iteration> --format md
+
+# View raw backend output for an iteration
+autoloop inspect output <iteration>
+
+# View coordination events
+autoloop inspect coordination
+
+# View topology (role routing graph)
+autoloop inspect topology --format graph
+
+# View metrics
+autoloop inspect metrics --format terminal
+
+# View memory
+autoloop inspect memory
+
+# All inspect commands support --run <run-id> for specific runs
+```
+
+### Manage Worktrees
+
+Worktrees provide git-level isolation. Each `--worktree` run gets its own branch (`autoloop/<run-id>`).
+
+#### List Worktrees
+```bash
+autoloop worktree list
+```
+Shows: run ID, status, branch, base branch, merge strategy, created time. Orphaned worktrees (disk path missing) show `(orphan)`.
+
+#### Merge a Worktree
+```bash
+# Merge with recorded strategy (default: squash)
+autoloop worktree merge <run-id>
+
+# Override merge strategy
+autoloop worktree merge <run-id> --strategy squash   # squash commits into one
+autoloop worktree merge <run-id> --strategy merge    # merge commit (no squash)
+autoloop worktree merge <run-id> --strategy rebase   # rebase onto base
+```
+
+If merge conflicts occur, the command aborts the merge, lists conflicting files, and exits non-zero. The user must resolve manually with `git merge <branch>` from the base branch.
+
+#### Clean Up Worktrees
+
+```bash
+# Clean orphaned + terminal (merged/failed/removed) worktrees
+autoloop worktree clean
+
+# Clean ALL worktrees including running ones
+autoloop worktree clean --all
+
+# Force-clean a specific run's worktree
+autoloop worktree clean --force <run-id>
+```
+
+**What gets cleaned:**
+- `git worktree remove` (or force-delete the directory)
+- `git branch -d/-D` to delete the branch
+- Metadata directory removed
+
+**What's skipped by default:** Running worktrees are skipped unless `--all` or `--force` is used.
+
+#### Clean Up Run Directories
+
+```bash
+# Remove stale run directories older than 7 days
+autoloop runs clean
+
+# Custom age threshold
+autoloop runs clean --max-age 30
+```
+
+### Worktree Lifecycle
+
+1. **Created** on `autoloop run --worktree`: branch `autoloop/<run-id>`, dir `.autoloop/worktrees/<run-id>/tree/`
+2. **Running**: loop executes, commits land on worktree branch
+3. **Completed**: run finishes, worktree sits ready for merge
+4. **Merged**: `autoloop worktree merge <run-id>` squashes into base branch
+5. **Cleaned**: `autoloop worktree clean` removes directory, branch, and metadata
+
+**Routine maintenance pattern:**
+```bash
+# After reviewing and merging completed worktrees:
+autoloop worktree clean
+# Periodically clean old run state:
+autoloop runs clean --max-age 14
+```
+
+### Dashboard
+
+```bash
+# Start the web dashboard (default: http://127.0.0.1:4800)
+autoloop dashboard
+
+# Custom port/host
+autoloop dashboard -p 3000 --host 0.0.0.0
+```
+
+### Configuration
+
+```bash
+# Show resolved config with provenance
+autoloop config show
+
+# Show as JSON
+autoloop config show --json
+
+# Show config file path
+autoloop config path
+```
+
+### Memory & Tasks
+
+```bash
+# Memory operations
+autoloop memory list
+autoloop memory status
+autoloop memory find "pattern"
+autoloop memory add learning "insight"
+autoloop memory remove <id>
+
+# Task operations
+autoloop task list
+autoloop task add "description"
+autoloop task complete <id>
+```
+
+## Decision Guide
+
+| User wants to... | Command |
+|---|---|
+| Implement a feature | `autoloop run autocode "..." --worktree` |
+| Fix a bug | `autoloop run autofix "..." --worktree` |
+| Write tests | `autoloop run autotest "..." --worktree` |
+| Review code | `autoloop run autoreview "..."` |
+| Security audit | `autoloop run autosec "..."` |
+| Write docs | `autoloop run autodoc "..." --worktree` |
+| Check what's running | `autoloop loops` |
+| Steer a running loop | `autoloop guide "..."` |
+| See what a loop did | `autoloop inspect scratchpad` |
+| Merge finished work | `autoloop worktree merge <id>` |
+| Clean up | `autoloop worktree clean && autoloop runs clean` |
+| Full hands-off | `autoloop run autocode "..." --worktree --automerge` |