@mobrienv/autoloop 0.1.2

package/dist/harness/wave/finalize-wave.js

@@ -0,0 +1,60 @@
+import { jsonField } from "../../json.js";
+import { appendEvent, appendHarnessEvent } from "../journal.js";
+import { parallelDispatchBase, parallelJoinedTopic } from "../emit.js";
+import * as topology from "../../topology.js";
+import { joinCsv } from "../../utils.js";
+export function finalizeParallelWave(loop, iter, waveId, results) {
+    const timedOut = results.filter(r => r.stopReason === "backend_timeout").map(r => r.branchId);
+    if (timedOut.length > 0) {
+        appendEvent(loop.paths.journalFile, loop.runtime.runId, String(iter.iteration), "wave.timeout", jsonField("wave_id", waveId) + ", " + jsonField("timed_out_branches", joinCsv(timedOut)));
+        return { reason: "parallel_wave_timeout", waveId };
+    }
+    const failed = results.filter(r => !branchSuccessStatus(r.stopReason)).map(r => r.branchId);
+    if (failed.length > 0) {
+        appendEvent(loop.paths.journalFile, loop.runtime.runId, String(iter.iteration), "wave.failed", jsonField("wave_id", waveId) + ", " + jsonField("failed_branches", joinCsv(failed)));
+        return { reason: "parallel_wave_failed", waveId };
+    }
+    return { reason: "parallel_wave_complete", waveId };
+}
+function branchSuccessStatus(status) {
+    return status === "max_iterations" || status === "completion_event" || status === "completion_promise";
+}
+export function continueAfterParallelJoin(loop, iter, waveId, emittedTopic, totalElapsedMs, iterateFn) {
+    const joinedTopic = parallelJoinedTopic(emittedTopic);
+    appendWaveJoinFinish(loop, iter, waveId, emittedTopic, joinedTopic, totalElapsedMs);
+    appendHarnessEvent(loop.paths.journalFile, loop.runtime.runId, String(iter.iteration), joinedTopic, waveId);
+    return iterateFn(loop, iter.iteration + 1);
+}
+export function stopAfterParallelWave(loop, iter, reason, waveId) {
+    const fields = jsonField("reason", reason) + ", " + jsonField("iteration", String(iter.iteration)) + (waveId ? ", " + jsonField("wave_id", waveId) : "");
+    appendEvent(loop.paths.journalFile, loop.runtime.runId, String(iter.iteration), "loop.stop", fields);
+    return { iterations: iter.iteration, stopReason: reason };
+}
+function joinedResumeRoutingBasis(iter, emittedTopic) {
+    if (emittedTopic === "explore.parallel")
+        return iter.recentEvent;
+    return parallelDispatchBase(emittedTopic) || iter.recentEvent;
+}
+function joinedResumeRecentEvent(iter, emittedTopic, joinedTopic) {
+    if (emittedTopic === "explore.parallel")
+        return iter.recentEvent;
+    return joinedTopic;
+}
+function joinedResumeRoles(loop, iter, emittedTopic, routingBasis) {
+    if (emittedTopic === "explore.parallel")
+        return iter.allowedRoles;
+    return topology.suggestedRoles(loop.topology, routingBasis);
+}
+function joinedResumeEvents(loop, iter, emittedTopic, routingBasis) {
+    if (emittedTopic === "explore.parallel")
+        return iter.allowedEvents;
+    return topology.allowedEvents(loop.topology, routingBasis);
+}
+function appendWaveJoinFinish(loop, iter, waveId, emittedTopic, joinedTopic, totalElapsed) {
+    const routingBasis = joinedResumeRoutingBasis(iter, emittedTopic);
+    const resumeRecentEvent = joinedResumeRecentEvent(iter, emittedTopic, joinedTopic);
+    const resumeRoles = joinedResumeRoles(loop, iter, emittedTopic, routingBasis);
+    const resumeEvents = joinedResumeEvents(loop, iter, emittedTopic, routingBasis);
+    appendEvent(loop.paths.journalFile, loop.runtime.runId, String(iter.iteration), "wave.join.finish", jsonField("wave_id", waveId) + ", " + jsonField("trigger_topic", emittedTopic) + ", " + jsonField("joined_topic", joinedTopic) + ", " + jsonField("routing_basis", routingBasis) + ", " + jsonField("resume_recent_event", resumeRecentEvent) + ", " + jsonField("resume_roles", joinCsv(resumeRoles)) + ", " + jsonField("resume_events", joinCsv(resumeEvents)) + ", " + jsonField("elapsed_ms", String(totalElapsed)));
+}
+//# sourceMappingURL=finalize-wave.js.map

package/dist/harness/wave/finalize-wave.js.map

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

package/dist/harness/wave/launch-branches.d.ts

@@ -0,0 +1,6 @@
+import type { LoopContext } from "../types.js";
+import type { IterationContext } from "../prompt.js";
+import type { BranchSpec, BranchResult } from "./types.js";
+export declare function prepareParallelBranches(loop: LoopContext, iter: IterationContext, waveId: string, waveDir: string, emittedTopic: string, objectives: string[]): BranchSpec[];
+export declare function launchParallelBranches(loop: LoopContext, specs: BranchSpec[]): BranchSpec[];
+export declare function joinParallelBranches(loop: LoopContext, iter: IterationContext, waveId: string, pending: BranchSpec[]): BranchResult[];

package/dist/harness/wave/launch-branches.js

@@ -0,0 +1,218 @@
+import { writeFileSync, mkdirSync, chmodSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import { execSync } from "node:child_process";
+import { jsonField } from "../../json.js";
+import { joinCsv, listText, shellQuote } from "../../utils.js";
+import * as md from "../../markdown.js";
+import * as topology from "../../topology.js";
+import { readIfExists, appendEvent, extractField } from "../journal.js";
+import { parallelDispatchBase } from "../emit.js";
+import { runProcess, writeParallelBranchSummary, renderBranchResult } from "../parallel.js";
+export function prepareParallelBranches(loop, iter, waveId, waveDir, emittedTopic, objectives) {
+    return objectives.map((objective, i) => {
+        const branchId = `branch-${i + 1}`;
+        const branchDir = join(waveDir, "branches", branchId);
+        const routingEvent = branchRoutingEvent(iter, emittedTopic);
+        const branchRoles = topology.suggestedRoles(loop.topology, routingEvent);
+        const branchEvents = topology.allowedEvents(loop.topology, routingEvent);
+        const prompt = renderBranchPrompt(loop, objective, emittedTopic, routingEvent, branchRoles, branchEvents);
+        const spec = {
+            branchId, waveId, objective, emittedTopic, routingEvent,
+            allowedRoles: branchRoles, allowedEvents: branchEvents, prompt,
+            branchDir,
+            launchFile: join(branchDir, "launch.json"),
+            summaryFile: join(branchDir, "summary.json"),
+            stdoutFile: join(branchDir, "stdout.log"),
+            stderrFile: join(branchDir, "stderr.log"),
+            statusFile: join(branchDir, "status.txt"),
+            pidFile: join(branchDir, "pid.txt"),
+            supervisorFile: join(branchDir, "supervisor.sh"),
+            launchMs: 0,
+        };
+        mkdirSync(branchDir, { recursive: true });
+        writeFileSync(join(branchDir, "objective.md"), renderBranchObjective(objective, emittedTopic, routingEvent, branchRoles, branchEvents));
+        writeBranchLaunch(spec, loop);
+        appendWaveBranchStart(loop, iter, waveId, branchId, objective, routingEvent, branchRoles, branchEvents);
+        return spec;
+    });
+}
+export function launchParallelBranches(loop, specs) {
+    return specs.map(spec => launchBranch(loop, spec));
+}
+function launchBranch(loop, spec) {
+    const launchMs = Date.now();
+    writeSupervisor(loop, spec);
+    const cmd = `rm -f ${shellQuote(spec.stdoutFile)} ${shellQuote(spec.stderrFile)} ${shellQuote(spec.statusFile)} ${shellQuote(spec.pidFile)} ; ` +
+        `nohup sh ${shellQuote(spec.supervisorFile)} >/dev/null 2>&1 & printf '%s' "$!" > ${shellQuote(spec.pidFile)}`;
+    runProcess(cmd, 10000);
+    const launched = { ...spec, launchMs };
+    const pid = readIfExists(spec.pidFile).trim();
+    if (!pid)
+        recordLaunchFailure(launched);
+    return launched;
+}
+export function joinParallelBranches(loop, iter, waveId, pending) {
+    const results = [];
+    let remaining = [...pending];
+    while (remaining.length > 0) {
+        const ready = [];
+        const stillPending = [];
+        for (const spec of remaining) {
+            const polled = pollBranch(loop, spec);
+            if (polled)
+                ready.push(polled);
+            else
+                stillPending.push(spec);
+        }
+        if (ready.length > 0) {
+            for (const r of sortByFinishedAt(ready)) {
+                appendWaveBranchFinish(loop, iter, waveId, r.branchId, r);
+                results.push(r);
+            }
+        }
+        remaining = stillPending;
+        if (remaining.length > 0 && ready.length === 0) {
+            try {
+                execSync("sleep 0.1");
+            }
+            catch { /* */ }
+        }
+    }
+    return results;
+}
+function writeBranchLaunch(spec, loop) {
+    const fields = jsonField("branch_id", spec.branchId) + ", " +
+        jsonField("objective", spec.objective) + ", " +
+        jsonField("emitted_topic", spec.emittedTopic) + ", " +
+        jsonField("routing_event", spec.routingEvent) + ", " +
+        jsonField("allowed_roles", joinCsv(spec.allowedRoles)) + ", " +
+        jsonField("allowed_events", joinCsv(spec.allowedEvents)) + ", " +
+        jsonField("prompt", spec.prompt) + ", " +
+        jsonField("backend_kind", loop.backend.kind) + ", " +
+        jsonField("backend_command", loop.backend.command) + ", " +
+        jsonField("backend_args", joinCsv(loop.backend.args)) + ", " +
+        jsonField("backend_prompt_mode", loop.backend.promptMode) + ", " +
+        jsonField("log_level", loop.runtime.logLevel);
+    writeFileSync(spec.launchFile, "{" + fields + "}\n");
+}
+function writeSupervisor(loop, spec) {
+    const cmd = loop.runtime.selfCommand + " branch-run " + shellQuote(loop.paths.projectDir) + " " + shellQuote(spec.branchDir);
+    const content = "#!/bin/sh\nset -eu\nchild=''\n" +
+        "cleanup() {\n  if [ -n \"$child\" ]; then\n    kill \"$child\" 2>/dev/null || true\n    wait \"$child\" 2>/dev/null || true\n  fi\n  exit 130\n}\n" +
+        "trap cleanup INT TERM\n" +
+        cmd + " >" + shellQuote(spec.stdoutFile) + " 2>" + shellQuote(spec.stderrFile) + " &\n" +
+        "child=$!\nwait \"$child\"\nstatus=$?\n" +
+        "printf '%s' \"$status\" > " + shellQuote(spec.statusFile) + "\n";
+    writeFileSync(spec.supervisorFile, content);
+    try {
+        chmodSync(spec.supervisorFile, 0o755);
+    }
+    catch { /* */ }
+}
+function recordLaunchFailure(spec) {
+    const finishedMs = Date.now();
+    const result = branchResultFromSpec(spec, "branch_process_failed", `branch launch failed for \`${spec.branchId}\``, finishedMs - spec.launchMs, finishedMs);
+    writeFileSync(spec.statusFile, "1");
+    writeFileSync(join(spec.branchDir, "result.md"), renderBranchResult({ ...result, branch_dir: spec.branchDir }));
+    writeParallelBranchSummary(spec.branchDir, { ...result, branch_dir: spec.branchDir });
+}
+function pollBranch(loop, spec) {
+    if (existsSync(spec.summaryFile))
+        return loadSummaryResult(spec);
+    if (existsSync(spec.statusFile))
+        return ensureBranchResult(spec, "branch_process_failed");
+    if (Date.now() - spec.launchMs > loop.parallel.branchTimeoutMs) {
+        terminateBranch(spec);
+        return ensureBranchResult(spec, "backend_timeout");
+    }
+    return null;
+}
+function loadSummaryResult(spec) {
+    const line = readIfExists(spec.summaryFile);
+    return {
+        branchId: extractField(line, "branch_id"),
+        objective: extractField(line, "objective"),
+        stopReason: extractField(line, "stop_reason"),
+        output: extractField(line, "output"),
+        routingEvent: extractField(line, "routing_event"),
+        allowedRoles: csvList(line, "allowed_roles"),
+        allowedEvents: csvList(line, "allowed_events"),
+        branchDir: spec.branchDir,
+        elapsedMs: parseInt(extractField(line, "elapsed_ms")) || 0,
+        finishedAtMs: parseInt(extractField(line, "finished_at_ms")) || 0,
+    };
+}
+function ensureBranchResult(spec, fallbackReason) {
+    if (existsSync(spec.summaryFile))
+        return loadSummaryResult(spec);
+    const finishedMs = Date.now();
+    const output = combinedOutput(spec);
+    const result = branchResultFromSpec(spec, fallbackReason, output, finishedMs - spec.launchMs, finishedMs);
+    writeFileSync(join(spec.branchDir, "result.md"), renderBranchResult({ ...result, branch_dir: spec.branchDir }));
+    writeParallelBranchSummary(spec.branchDir, { ...result, branch_dir: spec.branchDir });
+    return result;
+}
+function terminateBranch(spec) {
+    const pid = readIfExists(spec.pidFile).trim();
+    if (pid) {
+        try {
+            runProcess(`kill ${shellQuote(pid)} 2>/dev/null || true`, 5000);
+        }
+        catch { /* */ }
+    }
+}
+function combinedOutput(spec) {
+    const stdout = readIfExists(spec.stdoutFile).trim();
+    const stderr = readIfExists(spec.stderrFile).trim();
+    if (!stdout)
+        return stderr;
+    if (!stderr)
+        return stdout;
+    return stdout + "\n\nstderr:\n" + stderr;
+}
+function csvList(line, field) {
+    const v = extractField(line, field);
+    return v ? v.split(",").map(s => s.trim()).filter(s => s !== "") : [];
+}
+function branchResultFromSpec(spec, stopReason, output, elapsedMs, finishedAtMs) {
+    return { branchId: spec.branchId, objective: spec.objective, stopReason, output, routingEvent: spec.routingEvent, allowedRoles: spec.allowedRoles, allowedEvents: spec.allowedEvents, branchDir: spec.branchDir, elapsedMs, finishedAtMs };
+}
+function sortByFinishedAt(results) {
+    return [...results].sort((a, b) => {
+        if (a.finishedAtMs !== b.finishedAtMs)
+            return a.finishedAtMs - b.finishedAtMs;
+        return branchIndex(a.branchId) - branchIndex(b.branchId);
+    });
+}
+function branchIndex(id) {
+    return parseInt(id.replace("branch-", "")) || 0;
+}
+function branchRoutingEvent(iter, emittedTopic) {
+    if (emittedTopic === "explore.parallel")
+        return iter.recentEvent;
+    return parallelDispatchBase(emittedTopic) || iter.recentEvent;
+}
+function renderBranchPrompt(loop, objective, emittedTopic, routingEvent, roles, events) {
+    return "Parallel branch objective:\n" + objective + "\n\n" +
+        "Parent objective:\n" + loop.objective + "\n\n" +
+        "Wave trigger: " + md.code(emittedTopic) + "\n" +
+        "Branch routing event: " + md.code(routingEvent) + "\n" +
+        "Suggested roles: " + listText(roles) + "\n" +
+        "Allowed events: " + listText(events) + "\n" +
+        "Work only on this branch objective. Branch state is isolated; do not assume you can control parent routing directly.\n";
+}
+function renderBranchObjective(objective, emittedTopic, routingEvent, roles, events) {
+    return md.heading(1, "Branch Objective") + "\n\n" +
+        "Trigger: " + md.code(emittedTopic) + "\n" +
+        "Routing event: " + md.code(routingEvent) + "\n" +
+        "Roles: " + listText(roles) + "\n" +
+        "Allowed events: " + listText(events) + "\n\n" +
+        objective + "\n";
+}
+function appendWaveBranchStart(loop, iter, waveId, branchId, objective, routingEvent, roles, events) {
+    appendEvent(loop.paths.journalFile, loop.runtime.runId, String(iter.iteration), "wave.branch.start", jsonField("wave_id", waveId) + ", " + jsonField("branch_id", branchId) + ", " + jsonField("objective", objective) + ", " + jsonField("routing_event", routingEvent) + ", " + jsonField("branch_roles", joinCsv(roles)) + ", " + jsonField("branch_events", joinCsv(events)));
+}
+function appendWaveBranchFinish(loop, iter, waveId, branchId, result) {
+    appendEvent(loop.paths.journalFile, loop.runtime.runId, String(iter.iteration), "wave.branch.finish", jsonField("wave_id", waveId) + ", " + jsonField("branch_id", branchId) + ", " + jsonField("stop_reason", result.stopReason) + ", " + jsonField("elapsed_ms", String(result.elapsedMs)) + ", " + jsonField("output", result.output));
+}
+//# sourceMappingURL=launch-branches.js.map

package/dist/harness/wave/launch-branches.js.map

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

package/dist/harness/wave/parse-objectives.d.ts

@@ -0,0 +1,3 @@
+import type { ParseResult } from "./types.js";
+export declare function parseParallelObjectives(payload: string, maxBranches: number): ParseResult;
+export declare function parseObjectiveLine(line: string): string;

package/dist/harness/wave/parse-objectives.js

@@ -0,0 +1,29 @@
+import { lineSep } from "../../utils.js";
+export function parseParallelObjectives(payload, maxBranches) {
+    const lines = payload.split(lineSep()).map((l) => l.trim()).filter((l) => l !== "");
+    const objectives = [];
+    let invalid = false;
+    for (const line of lines) {
+        const obj = parseObjectiveLine(line);
+        if (obj === "")
+            invalid = true;
+        else
+            objectives.push(obj);
+    }
+    if (invalid)
+        return { ok: false, objectives: [], reason: "invalid_branch_list" };
+    if (objectives.length === 0)
+        return { ok: false, objectives: [], reason: "empty_branch_list" };
+    if (objectives.length > maxBranches)
+        return { ok: false, objectives: [], reason: "too_many_branches" };
+    return { ok: true, objectives, reason: "" };
+}
+export function parseObjectiveLine(line) {
+    if (line.startsWith("- ") || line.startsWith("* "))
+        return line.slice(2).trim();
+    const dotIdx = line.indexOf(". ");
+    if (dotIdx > 0 && /^\d+$/.test(line.slice(0, dotIdx)))
+        return line.slice(dotIdx + 2).trim();
+    return "";
+}
+//# sourceMappingURL=parse-objectives.js.map

package/dist/harness/wave/parse-objectives.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-objectives.js","sourceRoot":"","sources":["../../../src/harness/wave/parse-objectives.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAGzC,MAAM,UAAU,uBAAuB,CAAC,OAAe,EAAE,WAAmB;IAC1E,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IACpF,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,GAAG,KAAK,EAAE;YAAE,OAAO,GAAG,IAAI,CAAC;;YAC1B,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;IAED,IAAI,OAAO;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,qBAAqB,EAAE,CAAC;IACjF,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC/F,IAAI,UAAU,CAAC,MAAM,GAAG,WAAW;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC;IACvG,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAChF,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5F,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/harness/wave/types.d.ts

@@ -0,0 +1,43 @@
+import type { RunSummary } from "../types.js";
+export interface WaveResult {
+    reason: string;
+    waveId: string;
+    elapsedMs: number;
+}
+export interface BranchSpec {
+    branchId: string;
+    waveId: string;
+    objective: string;
+    emittedTopic: string;
+    routingEvent: string;
+    allowedRoles: string[];
+    allowedEvents: string[];
+    prompt: string;
+    branchDir: string;
+    launchFile: string;
+    summaryFile: string;
+    stdoutFile: string;
+    stderrFile: string;
+    statusFile: string;
+    pidFile: string;
+    supervisorFile: string;
+    launchMs: number;
+}
+export interface BranchResult {
+    branchId: string;
+    objective: string;
+    stopReason: string;
+    output: string;
+    routingEvent: string;
+    allowedRoles: string[];
+    allowedEvents: string[];
+    branchDir: string;
+    elapsedMs: number;
+    finishedAtMs: number;
+}
+export interface ParseResult {
+    ok: boolean;
+    objectives: string[];
+    reason: string;
+}
+export type IterateFn = (loop: any, iteration: number) => RunSummary;

package/dist/harness/wave/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/harness/wave/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/harness/wave/types.ts"],"names":[],"mappings":""}

package/dist/harness/wave.d.ts

@@ -0,0 +1,6 @@
+import type { LoopContext } from "./types.js";
+import type { IterationContext } from "./prompt.js";
+import type { WaveResult } from "./wave/types.js";
+export type { WaveResult } from "./wave/types.js";
+export { continueAfterParallelJoin, stopAfterParallelWave } from "./wave/finalize-wave.js";
+export declare function executeParallelWave(loop: LoopContext, iter: IterationContext, emittedTopic: string, emittedPayload: string): WaveResult;

package/dist/harness/wave.js

@@ -0,0 +1,98 @@
+import { writeFileSync, existsSync, mkdirSync, unlinkSync } from "node:fs";
+import { join } from "node:path";
+import { jsonField } from "../json.js";
+import { joinCsv, generateCompactId } from "../utils.js";
+import * as md from "../markdown.js";
+import { readIfExists, appendEvent } from "./journal.js";
+import { prepareParallelBranches, launchParallelBranches, joinParallelBranches } from "./wave/launch-branches.js";
+import { parseParallelObjectives } from "./wave/parse-objectives.js";
+import { finalizeParallelWave } from "./wave/finalize-wave.js";
+export { continueAfterParallelJoin, stopAfterParallelWave } from "./wave/finalize-wave.js";
+export function executeParallelWave(loop, iter, emittedTopic, emittedPayload) {
+    const markerPath = activeWaveMarkerPath(loop);
+    if (existsSync(markerPath)) {
+        return rejectActiveWave(loop, iter, emittedTopic, markerPath);
+    }
+    const parsed = parseParallelObjectives(emittedPayload, loop.parallel.maxBranches);
+    if (!parsed.ok) {
+        return rejectPayload(loop, iter, emittedTopic, parsed.reason);
+    }
+    return executeWaveWithObjectives(loop, iter, emittedTopic, parsed.objectives, markerPath);
+}
+function rejectActiveWave(loop, iter, topic, markerPath) {
+    const activeWaveId = readIfExists(markerPath);
+    appendWaveInvalid(loop, iter, topic, "active_wave_exists", activeWaveId);
+    return { reason: "parallel_wave_invalid", waveId: activeWaveId, elapsedMs: 0 };
+}
+function rejectPayload(loop, iter, topic, reason) {
+    appendWaveInvalid(loop, iter, topic, reason, "");
+    return { reason: "parallel_wave_invalid", waveId: "", elapsedMs: 0 };
+}
+function executeWaveWithObjectives(loop, iter, emittedTopic, objectives, markerPath) {
+    const waveId = generateCompactId("wave");
+    const waveDir = join(loop.paths.stateDir, "waves", waveId);
+    const branchesDir = join(waveDir, "branches");
+    const openingRoles = iter.allowedRoles;
+    const openingEvents = iter.allowedEvents;
+    const waveStartMs = Date.now();
+    mkdirSync(branchesDir, { recursive: true });
+    writeFileSync(markerPath, waveId);
+    writeWaveSpec(waveDir, waveId, emittedTopic, iter, objectives);
+    appendWaveStart(loop, iter, waveId, emittedTopic, objectives);
+    const specs = prepareParallelBranches(loop, iter, waveId, waveDir, emittedTopic, objectives);
+    const launched = launchParallelBranches(loop, specs);
+    const results = joinParallelBranches(loop, iter, waveId, launched);
+    const ordered = sortByBranchId(results);
+    const totalElapsed = Date.now() - waveStartMs;
+    writeWaveJoin(waveDir, waveId, emittedTopic, objectives, ordered, iter.recentEvent, openingRoles, openingEvents, totalElapsed);
+    appendWaveJoinStart(loop, iter, waveId, emittedTopic, objectives, ordered, totalElapsed);
+    try {
+        unlinkSync(markerPath);
+    }
+    catch { /* ok */ }
+    const finalized = finalizeParallelWave(loop, iter, waveId, ordered);
+    return { ...finalized, elapsedMs: totalElapsed };
+}
+function sortByBranchId(results) {
+    return [...results].sort((a, b) => branchIndex(a.branchId) - branchIndex(b.branchId));
+}
+function branchIndex(id) {
+    return parseInt(id.replace("branch-", "")) || 0;
+}
+function writeWaveSpec(waveDir, waveId, emittedTopic, iter, objectives) {
+    const content = md.heading(1, "Parallel Wave " + waveId) + "\n\n" +
+        "Trigger: " + md.code(emittedTopic) + "\n" +
+        "Opening recent event: " + md.code(iter.recentEvent) + "\n" +
+        "Opening roles: " + iter.allowedRoles.join(", ") + "\n" +
+        "Opening events: " + iter.allowedEvents.join(", ") + "\n\n" +
+        md.heading(2, "Branch Objectives") + "\n" + md.bulletList(objectives);
+    writeFileSync(join(waveDir, "spec.md"), content);
+}
+function writeWaveJoin(waveDir, waveId, emittedTopic, objectives, results, recentEvent, openingRoles, openingEvents, totalElapsed) {
+    const items = results.map(r => md.code(r.branchId) + ": " + r.stopReason + " (" + r.elapsedMs + "ms)");
+    const content = md.heading(1, "Parallel Join " + waveId) + "\n\n" +
+        "Trigger: " + md.code(emittedTopic) + "\n" +
+        "Opening recent event: " + md.code(recentEvent) + "\n" +
+        "Opening roles: " + openingRoles.join(", ") + "\n" +
+        "Opening events: " + openingEvents.join(", ") + "\n" +
+        "Total wave elapsed: " + md.code(totalElapsed + "ms") + "\n\n" +
+        md.heading(2, "Objectives") + "\n" + md.bulletList(objectives) + "\n\n" +
+        md.heading(2, "Branch Results") + "\n" + md.bulletList(items);
+    writeFileSync(join(waveDir, "join.md"), content);
+}
+function activeWaveMarkerPath(loop) {
+    const wavesDir = join(loop.paths.stateDir, "waves");
+    mkdirSync(wavesDir, { recursive: true });
+    return join(wavesDir, "active");
+}
+function appendWaveInvalid(loop, iter, topic, reason, activeWaveId) {
+    appendEvent(loop.paths.journalFile, loop.runtime.runId, String(iter.iteration), "wave.invalid", jsonField("trigger_topic", topic) + ", " + jsonField("reason", reason) + ", " + jsonField("active_wave_id", activeWaveId) + ", " + jsonField("opening_recent_event", iter.recentEvent));
+}
+function appendWaveStart(loop, iter, waveId, emittedTopic, objectives) {
+    appendEvent(loop.paths.journalFile, loop.runtime.runId, String(iter.iteration), "wave.start", jsonField("wave_id", waveId) + ", " + jsonField("trigger_topic", emittedTopic) + ", " + jsonField("branch_count", String(objectives.length)) + ", " + jsonField("opening_recent_event", iter.recentEvent) + ", " + jsonField("opening_roles", joinCsv(iter.allowedRoles)) + ", " + jsonField("opening_events", joinCsv(iter.allowedEvents)) + ", " + jsonField("objectives", joinCsv(objectives)));
+}
+function appendWaveJoinStart(loop, iter, waveId, emittedTopic, objectives, results, totalElapsed) {
+    const outcomes = results.map(r => r.branchId + ":" + r.stopReason).join(",");
+    appendEvent(loop.paths.journalFile, loop.runtime.runId, String(iter.iteration), "wave.join.start", jsonField("wave_id", waveId) + ", " + jsonField("trigger_topic", emittedTopic) + ", " + jsonField("branch_count", String(objectives.length)) + ", " + jsonField("elapsed_ms", String(totalElapsed)) + ", " + jsonField("branch_outcomes", outcomes));
+}
+//# sourceMappingURL=wave.js.map

package/dist/harness/wave.js.map

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

package/dist/json.d.ts

@@ -0,0 +1,8 @@
+export declare function jsonString(text: string): string;
+export declare function jsonBool(value: boolean): string;
+export declare function jsonField(key: string, value: string): string;
+export declare function jsonFieldRaw(key: string, rawValue: string): string;
+export declare function extractTopic(line: string): string;
+export declare function extractField(line: string, key: string): string;
+export declare function encodeJsonValue(text: string): string;
+export declare function decodeJsonValue(text: string): string;

package/dist/json.js

@@ -0,0 +1,80 @@
+import { replaceAll, lineSep } from "./utils.js";
+import { decodeEvent } from "./events/decode.js";
+export function jsonString(text) {
+    return '"' + encodeJsonValue(text) + '"';
+}
+export function jsonBool(value) {
+    return value ? "true" : "false";
+}
+export function jsonField(key, value) {
+    return '"' + key + '": ' + jsonString(value);
+}
+export function jsonFieldRaw(key, rawValue) {
+    return '"' + key + '": ' + rawValue;
+}
+export function extractTopic(line) {
+    const decoded = decodeEvent(line);
+    if (decoded)
+        return String(decoded.topic);
+    return extractField(line, "topic");
+}
+export function extractField(line, key) {
+    const decoded = decodeEvent(line);
+    if (decoded) {
+        if (key === "run")
+            return decoded.run;
+        if (key === "iteration")
+            return decoded.iteration ?? "";
+        if (key === "topic")
+            return String(decoded.topic);
+        if (decoded.shape === "payload") {
+            if (key === "payload")
+                return decoded.payload;
+            if (key === "source")
+                return decoded.source ?? "";
+            return "";
+        }
+        return decoded.fields[key] ?? "";
+    }
+    const marker = '"' + key + '": ';
+    return decodeJsonValue(firstQuotedValue(firstAfterMarker(line.split(marker))));
+}
+export function encodeJsonValue(text) {
+    let escaped = replaceAll(text, "\\", "\\u005c");
+    escaped = replaceAll(escaped, '"', "\\u0022");
+    escaped = replaceAll(escaped, lineSep(), "\\u000a");
+    escaped = replaceAll(escaped, "\r", "\\u000d");
+    escaped = replaceAll(escaped, "\t", "\\u0009");
+    return escapeRemainingControlChars(escaped);
+}
+function escapeRemainingControlChars(text) {
+    // Replace control chars \x00-\x08, \x0b, \x0c, \x0e-\x1f
+    return text.replace(
+    // eslint-disable-next-line no-control-regex
+    /[\x00-\x08\x0b\x0c\x0e-\x1f]/g, (ch) => "\\u" + ch.charCodeAt(0).toString(16).padStart(4, "0"));
+}
+export function decodeJsonValue(text) {
+    let restored = replaceAll(text, "\\u000a", lineSep());
+    restored = replaceAll(restored, "\\u000d", "\r");
+    restored = replaceAll(restored, "\\u0009", "\t");
+    restored = replaceAll(restored, "\\u0022", '"');
+    restored = replaceAll(restored, "\\u005c", "\\");
+    return restored;
+}
+function firstAfterMarker(parts) {
+    if (parts.length <= 1)
+        return "";
+    return parts[1];
+}
+function firstQuotedValue(text) {
+    return firstQuotedValueParts(text.split('"'));
+}
+function firstQuotedValueParts(parts) {
+    for (let i = 0; i < parts.length; i++) {
+        if (parts[i] === "") {
+            return i + 1 < parts.length ? parts[i + 1] : "";
+        }
+    }
+    return "";
+}
+//# sourceMappingURL=json.js.map

package/dist/json.js.map

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