@mobrienv/autoloop-harness 0.7.0

package/dist/display.js

@@ -0,0 +1,177 @@
+import { execSync } from "node:child_process";
+import { lineSep, listText } from "@mobrienv/autoloop-core";
+export function printSummary(summary, loop) {
+    const hint = stopReasonHint(summary.stopReason);
+    const lines = [
+        "autoloops summary",
+        "===================",
+        `run_id: ${loop.runtime.runId}`,
+        `iterations: ${summary.iterations}`,
+        `stop_reason: ${summary.stopReason}`,
+        `journal: ${loop.paths.journalFile}`,
+        `memory: ${loop.paths.memoryFile}`,
+        `review_every: ${loop.review.every}`,
+        `inspect scratchpad: ${loop.paths.toolPath} inspect scratchpad --format md`,
+        ...hint,
+    ];
+    for (const l of lines)
+        console.log(l);
+}
+function stopReasonHint(reason) {
+    switch (reason) {
+        case "backend_failed":
+            return [
+                "Hint: check the backend output above; common causes: invalid API key, model not available, network error.",
+            ];
+        case "backend_timeout":
+            return [
+                "Hint: the backend did not respond in time. Try increasing timeout or check backend availability.",
+            ];
+        case "max_iterations":
+            return [
+                "Hint: loop reached the iteration limit without a completion event. Increase max_iterations or check if agents are stuck.",
+            ];
+        default:
+            return [];
+    }
+}
+function decorativeOutputEnabled() {
+    return Boolean(process.stdout.isTTY);
+}
+export function printIterationBanner(loop, iter) {
+    const roleLine = `role: ${listText(iter.allowedRoles)} │ event: ${iter.recentEvent} │ next: ${listText(iter.allowedEvents)}`;
+    if (!decorativeOutputEnabled()) {
+        console.log(`iteration ${iter.iteration}/${loop.limits.maxIterations}`);
+        console.log(roleLine);
+        if (iter.lastRejected) {
+            console.log(`previous emit rejected: \`${iter.lastRejected}\` — rerouting`);
+        }
+        return;
+    }
+    const label = `━━━ iteration ${iter.iteration}/${loop.limits.maxIterations} `;
+    const width = terminalWidth();
+    const rule = label.padEnd(width, "━");
+    console.log("");
+    console.log(rule);
+    console.log(roleLine);
+    if (iter.lastRejected) {
+        console.log(`↳ previous emit rejected: \`${iter.lastRejected}\` — rerouting`);
+    }
+    console.log("━".repeat(width));
+}
+export function printIterationFooter(iter, elapsedS) {
+    if (!decorativeOutputEnabled())
+        return;
+    const elapsed = elapsedS >= 60
+        ? `${Math.floor(elapsedS / 60)}m ${elapsedS % 60}s`
+        : `${elapsedS}s`;
+    const label = `──── end iteration ${iter.iteration} (${elapsed}) `;
+    console.log(label.padEnd(terminalWidth(), "─"));
+    console.log("");
+}
+export function printProgressLine(data) {
+    const parts = [
+        "[progress]",
+        `ts=${new Date().toISOString()}`,
+        `run_id=${data.runId}`,
+        `iter=${data.iteration}`,
+        `role=${progressRoleLabel(data.allowedRoles)}`,
+        `recent=${data.recentEvent || "(none)"}`,
+    ];
+    if (data.emittedTopic)
+        parts.push(`emitted=${data.emittedTopic}`);
+    parts.push(`outcome=${data.outcome}`);
+    console.log(parts.join(" "));
+}
+function progressRoleLabel(roles) {
+    if (roles.length === 0)
+        return "(none)";
+    if (roles.length === 1)
+        return roles[0];
+    return roles.join(",");
+}
+export function printReviewBanner(iteration) {
+    if (!decorativeOutputEnabled()) {
+        console.log(`review before iteration ${iteration}`);
+        return;
+    }
+    const label = `━━━ review before iteration ${iteration} `;
+    console.log("");
+    console.log(label.padEnd(terminalWidth(), "━"));
+}
+export function printBackendOutputTail(output, maxLines = 200) {
+    const lines = output.split(lineSep());
+    const tail = lines.slice(-maxLines);
+    if (!tail.join("").trim())
+        return;
+    const shown = Math.min(lines.length, maxLines);
+    if (!decorativeOutputEnabled()) {
+        console.log(`── backend stdout (last ${shown} of ${lines.length} lines) ──`);
+        console.log(tail.join(lineSep()));
+        return;
+    }
+    console.log(`── backend stdout (last ${shown} of ${lines.length} lines) ──`);
+    console.log(tail.join(lineSep()));
+    console.log("──────────────────────────────────────");
+}
+export function printFailureDiagnostic(output, stopReason) {
+    const lines = output.split(lineSep());
+    const tail = lines.slice(-15).join(lineSep());
+    if (!tail.trim())
+        return;
+    const header = stopReason
+        ? `── backend output (last 15 lines) — stopped: ${stopReason} ──`
+        : "── backend output (last 15 lines) ──";
+    console.log("");
+    console.log(header);
+    console.log(tail);
+    console.log("──────────────────────────────────────");
+}
+export function terminalWidth() {
+    const envWidth = parseInt(process.env.AUTOLOOP_WIDTH ?? "", 10);
+    if (envWidth > 0)
+        return envWidth;
+    const cols = parseInt(process.env.COLUMNS ?? "", 10);
+    if (cols > 0)
+        return cols;
+    try {
+        const tputResult = execSync("tput cols 2>/dev/null || true", {
+            encoding: "utf-8",
+            timeout: 1000,
+        }).trim();
+        const w = parseInt(tputResult, 10);
+        if (w > 0)
+            return w;
+    }
+    catch {
+        /* ignore */
+    }
+    return 68;
+}
+export function lastNChars(text, n) {
+    return text.length > n ? text.slice(-n) : text;
+}
+export function log(loop, level, message) {
+    const ranks = {
+        debug: 0,
+        info: 1,
+        warn: 2,
+        error: 3,
+        none: 4,
+    };
+    const currentRank = ranks[loop.runtime.logLevel] ?? 1;
+    const messageRank = ranks[level] ?? 1;
+    if (messageRank >= currentRank) {
+        process.stderr.write(`[autoloops] [${level}] ${message}\n`);
+    }
+    loop.onEvent?.({ type: "log", level, message });
+}
+export function printProjectedMarkdown(text, _format) {
+    // In terminal mode, the original uses host_call(:io_render_markdown)
+    // which is Tonic-specific. For TS, just output plain text.
+    console.log(text);
+}
+export function printProjectedText(text, _format) {
+    console.log(text);
+}
+//# sourceMappingURL=display.js.map

package/dist/display.js.map

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

package/dist/emit.d.ts

@@ -0,0 +1,21 @@
+export declare function coordinationTopic(topic: string): boolean;
+export declare function operatorTopic(topic: string): boolean;
+export declare function coreSystemTopic(topic: string): boolean;
+export declare function systemTopic(topic: string): boolean;
+export declare function parallelTopic(topic: string): boolean;
+export declare function parallelTriggerTopic(topic: string): boolean;
+export declare function reservedParallelJoinedTopic(topic: string): boolean;
+export interface EmitResult {
+    ok: boolean;
+    topic?: string;
+    error?: string;
+}
+export declare function emit(projectDir: string, topic: string, payload: string): EmitResult;
+export declare function invalidEvent(emittedTopic: string, allowedEvents: string[], parallelEnabled: boolean, completionEvent: string): boolean;
+export declare function parallelDispatchBase(topic: string): string;
+export declare function parallelJoinedTopic(topic: string): string;
+export declare function dispatchParallelJoinedTopic(topic: string): boolean;
+export declare function dispatchParallelJoinBase(topic: string): string;
+export declare function routingTopic(topic: string): boolean;
+export declare function appendInvalidEvent(journalFile: string, runId: string, iteration: string, recentEvent: string, emittedTopic: string, allowedRoles: string[], allowedEvents: string[]): void;
+export declare function resolveEmitJournalFile(projectDir: string): string;

package/dist/emit.js

@@ -0,0 +1,243 @@
+import { mkdirSync } from "node:fs";
+import { dirname } from "node:path";
+import { joinCsv, jsonField, listText, splitCsv, } from "@mobrienv/autoloop-core";
+import * as config from "@mobrienv/autoloop-core/config";
+import { appendAgentEvent, appendEvent, latestIterationForRun, latestRunId, } from "@mobrienv/autoloop-core/journal";
+import { materializeOpenFrom } from "@mobrienv/autoloop-core/tasks";
+import * as topology from "@mobrienv/autoloop-core/topology";
+const COORDINATION_TOPICS = new Set([
+    "issue.discovered",
+    "issue.resolved",
+    "slice.started",
+    "slice.verified",
+    "slice.committed",
+    "context.archived",
+    "chain.spawn",
+]);
+export function coordinationTopic(topic) {
+    return COORDINATION_TOPICS.has(topic);
+}
+const OPERATOR_TOPICS = new Set([
+    "operator.guidance",
+    "operator.guidance.consumed",
+]);
+export function operatorTopic(topic) {
+    return OPERATOR_TOPICS.has(topic);
+}
+const CORE_SYSTEM_TOPICS = new Set([
+    "iteration.start",
+    "iteration.finish",
+    "loop.start",
+    "loop.complete",
+    "loop.stop",
+    "review.start",
+    "review.finish",
+    "backend.start",
+    "backend.finish",
+    "event.invalid",
+]);
+export function coreSystemTopic(topic) {
+    if (CORE_SYSTEM_TOPICS.has(topic))
+        return true;
+    return topic.startsWith("wave.");
+}
+export function systemTopic(topic) {
+    return coordinationTopic(topic) || coreSystemTopic(topic);
+}
+export function parallelTopic(topic) {
+    return parallelTriggerTopic(topic) || reservedParallelJoinedTopic(topic);
+}
+export function parallelTriggerTopic(topic) {
+    if (topic === "explore.parallel")
+        return true;
+    return dispatchParallelTopic(topic);
+}
+function dispatchParallelTopic(topic) {
+    if (topic === "explore.parallel")
+        return false;
+    return topic.endsWith(".parallel");
+}
+export function reservedParallelJoinedTopic(topic) {
+    return topic.endsWith(".parallel.joined");
+}
+export function emit(projectDir, topic, payload) {
+    const journalFile = resolveEmitJournalFile(projectDir);
+    mkdirSync(dirname(journalFile), { recursive: true });
+    const validation = emitValidationContext(projectDir, journalFile);
+    if (coordinationTopic(topic)) {
+        return acceptEmit(journalFile, topic, payload, validation);
+    }
+    if (operatorTopic(topic)) {
+        return acceptEmit(journalFile, topic, payload, validation);
+    }
+    // Task completion gate: block completion if open tasks remain
+    if (topic === validation.completionEvent) {
+        const tasksFile = config.resolveTasksFile(projectDir);
+        const openTasks = materializeOpenFrom(tasksFile);
+        if (openTasks.length > 0) {
+            return rejectTaskGate(journalFile, topic, openTasks, validation);
+        }
+    }
+    if (invalidEvent(topic, validation.allowedEvents, validation.parallelEnabled, validation.completionEvent)) {
+        return rejectEmit(journalFile, topic, validation);
+    }
+    return acceptEmit(journalFile, topic, payload, validation);
+}
+export function invalidEvent(emittedTopic, allowedEvents, parallelEnabled, completionEvent) {
+    if (!emittedTopic)
+        return false;
+    if (reservedParallelJoinedTopic(emittedTopic))
+        return true;
+    if (!parallelEnabled) {
+        if (parallelTopic(emittedTopic))
+            return true;
+        return invalidEventAfterParallelCheck(emittedTopic, allowedEvents);
+    }
+    if (parallelTopic(emittedTopic)) {
+        return !validParallelTriggerEvent(emittedTopic, allowedEvents, completionEvent);
+    }
+    return invalidEventAfterParallelCheck(emittedTopic, allowedEvents);
+}
+function invalidEventAfterParallelCheck(emittedTopic, allowedEvents) {
+    if (allowedEvents.length === 0)
+        return false;
+    return !topology.eventMatchesAny(emittedTopic, allowedEvents);
+}
+function validParallelTriggerEvent(emittedTopic, allowedEvents, completionEvent) {
+    if (emittedTopic === "explore.parallel")
+        return true;
+    const baseEvent = parallelDispatchBase(emittedTopic);
+    if (!baseEvent)
+        return false;
+    if (baseEvent === completionEvent)
+        return false;
+    if (coordinationTopic(baseEvent) ||
+        coreSystemTopic(baseEvent) ||
+        parallelTopic(baseEvent))
+        return false;
+    if (allowedEvents.length === 0)
+        return false;
+    return topology.eventMatchesAny(baseEvent, allowedEvents);
+}
+export function parallelDispatchBase(topic) {
+    if (!dispatchParallelTopic(topic))
+        return "";
+    return topic.slice(0, -".parallel".length);
+}
+export function parallelJoinedTopic(topic) {
+    return `${topic}.joined`;
+}
+export function dispatchParallelJoinedTopic(topic) {
+    if (topic === "explore.parallel.joined")
+        return false;
+    return topic.endsWith(".parallel.joined");
+}
+export function dispatchParallelJoinBase(topic) {
+    if (topic === "explore.parallel.joined")
+        return "loop.start";
+    if (dispatchParallelJoinedTopic(topic)) {
+        return topic.slice(0, -".parallel.joined".length);
+    }
+    return topic;
+}
+export function routingTopic(topic) {
+    const nonRouting = new Set([
+        "iteration.start",
+        "iteration.finish",
+        "loop.complete",
+        "loop.stop",
+        "review.start",
+        "review.finish",
+        "backend.start",
+        "backend.finish",
+        "event.invalid",
+        "operator.guidance",
+        "operator.guidance.consumed",
+        "",
+    ]);
+    if (nonRouting.has(topic))
+        return false;
+    return !coordinationTopic(topic);
+}
+function emitValidationContext(projectDir, journalFile) {
+    const runId = resolveEmitRunId(journalFile);
+    const cfg = config.loadProject(projectDir);
+    const topo = topology.loadTopology(projectDir);
+    const compEvent = topology.completionEvent(topo, config.get(cfg, "event_loop.completion_event", "task.complete"));
+    const parallelEnabled = truthySetting(config.get(cfg, "parallel.enabled", "false"));
+    return {
+        runId,
+        iteration: resolveEmitIteration(journalFile, runId),
+        recentEvent: emitRecentEvent(),
+        allowedRoles: envCsvList("AUTOLOOP_ALLOWED_ROLES"),
+        allowedEvents: envCsvList("AUTOLOOP_ALLOWED_EVENTS"),
+        parallelEnabled,
+        completionEvent: compEvent,
+    };
+}
+function resolveEmitRunId(journalFile) {
+    const envValue = process.env.AUTOLOOP_RUN_ID;
+    return envValue || latestRunId(journalFile);
+}
+function resolveEmitIteration(journalFile, runId) {
+    const envValue = process.env.AUTOLOOP_ITERATION;
+    return envValue || latestIterationForRun(journalFile, runId);
+}
+function emitRecentEvent() {
+    return process.env.AUTOLOOP_RECENT_EVENT || "loop.start";
+}
+function envCsvList(name) {
+    const value = process.env[name];
+    if (!value)
+        return [];
+    return splitCsv(value);
+}
+function acceptEmit(journalFile, topic, payload, validation) {
+    appendAgentEvent(journalFile, validation.runId, validation.iteration, topic, payload);
+    return { ok: true, topic };
+}
+function rejectEmit(journalFile, topic, validation) {
+    const message = invalidEmitMessage(topic, validation);
+    appendInvalidEvent(journalFile, validation.runId, validation.iteration, validation.recentEvent, topic, validation.allowedRoles, validation.allowedEvents);
+    return { ok: false, topic, error: message };
+}
+function invalidEmitMessage(topic, validation) {
+    return ("invalid event `" +
+        topic +
+        "`; recent event: `" +
+        validation.recentEvent +
+        "`; suggested roles: " +
+        listText(validation.allowedRoles) +
+        "; allowed next events: " +
+        listText(validation.allowedEvents));
+}
+export function appendInvalidEvent(journalFile, runId, iteration, recentEvent, emittedTopic, allowedRoles, allowedEvents) {
+    appendEvent(journalFile, runId, iteration, "event.invalid", jsonField("recent_event", recentEvent) +
+        ", " +
+        jsonField("emitted", emittedTopic) +
+        ", " +
+        jsonField("suggested_roles", joinCsv(allowedRoles)) +
+        ", " +
+        jsonField("allowed_events", joinCsv(allowedEvents)));
+}
+export function resolveEmitJournalFile(projectDir) {
+    const envJournal = process.env.AUTOLOOP_JOURNAL_FILE;
+    if (envJournal)
+        return envJournal;
+    const envEvents = process.env.AUTOLOOP_EVENTS_FILE;
+    if (envEvents)
+        return envEvents;
+    return config.resolveJournalFile(projectDir);
+}
+function rejectTaskGate(journalFile, topic, openTasks, validation) {
+    appendEvent(journalFile, validation.runId, validation.iteration, "task.gate", jsonField("blocked_topic", topic) +
+        ", " +
+        jsonField("open_tasks", openTasks.map((t) => t.id).join(",")));
+    const taskLines = openTasks.map((t) => `  - [${t.id}] ${t.text}`).join("\n");
+    const message = `Cannot complete: ${openTasks.length} open tasks remain:\n${taskLines}\nComplete or remove these tasks before emitting ${topic}.`;
+    return { ok: false, topic, error: message };
+}
+function truthySetting(value) {
+    return value !== "false" && value !== "0" && value !== "";
+}
+//# sourceMappingURL=emit.js.map

package/dist/emit.js.map

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

package/dist/events.d.ts

@@ -0,0 +1,56 @@
+export type LoopEvent = {
+    type: "log";
+    level: string;
+    message: string;
+} | {
+    type: "iteration.start";
+    iteration: number;
+    maxIterations: number;
+    runId: string;
+} | {
+    type: "loop.finish";
+    iterations: number;
+    stopReason: string;
+    runId: string;
+} | {
+    type: "iteration.banner";
+    iteration: number;
+    maxIterations: number;
+    allowedRoles: string[];
+    recentEvent: string;
+    allowedEvents: string[];
+    lastRejected?: string;
+} | {
+    type: "iteration.footer";
+    iteration: number;
+    elapsedS: number;
+} | {
+    type: "progress";
+    runId: string;
+    iteration: number;
+    recentEvent: string;
+    allowedRoles: string[];
+    emittedTopic?: string;
+    outcome: string;
+} | {
+    type: "review.banner";
+    iteration: number;
+} | {
+    type: "backend.output";
+    output: string;
+    maxLines?: number;
+} | {
+    type: "failure.diagnostic";
+    output: string;
+    stopReason: string;
+} | {
+    type: "summary";
+    runId: string;
+    iterations: number;
+    stopReason: string;
+    journalFile: string;
+    memoryFile: string;
+    reviewEvery: number;
+    toolPath: string;
+};
+export type LoopEventEmitter = (event: LoopEvent) => void;

package/dist/events.js

@@ -0,0 +1,9 @@
+// LoopEvent — the public event envelope for SDK consumers.
+//
+// Emitted by harness.run() via RunOptions.onEvent. Each Phase-1 commit moves
+// one or more console.log call sites onto this stream; the default CLI
+// event-printer (cli/event-printer.ts) renders them using the helpers in
+// harness/display.ts. SDK consumers can ignore the display variants entirely
+// or drive their own UI.
+export {};
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,EAAE;AACF,6EAA6E;AAC7E,uEAAuE;AACvE,yEAAyE;AACzE,6EAA6E;AAC7E,yBAAyB"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+import { emit as emitCmd } from "./emit.js";
+import type { LoopContext, RunOptions, RunSummary } from "./types.js";
+export type { LoopContext, RunOptions, RunSummary };
+export declare function run(projectDir: string, promptOverride: string | null, selfCommand: string, runOptions: RunOptions): Promise<RunSummary>;
+export { emitCmd as emit };
+export declare function runParallelBranchCli(projectDir: string, branchDir: string, selfCommand: string, onEvent?: (event: import("./events.js").LoopEvent) => void): Promise<void>;