@mobrienv/autoloop-harness 0.7.0

package/dist/wave/launch-branches.js

@@ -0,0 +1,313 @@
+import { execSync } from "node:child_process";
+import { chmodSync, existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import * as md from "@mobrienv/autoloop-core";
+import { joinCsv, jsonField, listText, shellQuote, } from "@mobrienv/autoloop-core";
+import { appendEvent, extractField, readIfExists, } from "@mobrienv/autoloop-core/journal";
+import * as topology from "@mobrienv/autoloop-core/topology";
+import { parallelDispatchBase } from "../emit.js";
+import { renderBranchResult, runProcess, writeParallelBranchSummary, } 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"), 10) || 0,
+        finishedAtMs: parseInt(extractField(line, "finished_at_ms"), 10) || 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-", ""), 10) || 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/wave/launch-branches.js.map

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

package/dist/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/wave/parse-objectives.js

@@ -0,0 +1,32 @@
+import { lineSep } from "@mobrienv/autoloop-core";
+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/wave/parse-objectives.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-objectives.js","sourceRoot":"","sources":["../../src/wave/parse-objectives.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAGlD,MAAM,UAAU,uBAAuB,CACrC,OAAe,EACf,WAAmB;IAEnB,MAAM,KAAK,GAAG,OAAO;SAClB,KAAK,CAAC,OAAO,EAAE,CAAC;SAChB,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;IAC3B,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;QACT,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,qBAAqB,EAAE,CAAC;IACtE,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QACzB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC;IACpE,IAAI,UAAU,CAAC,MAAM,GAAG,WAAW;QACjC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC;IACpE,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;QAChD,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9B,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;QACnD,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACvC,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/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) => Promise<RunSummary>;

package/dist/wave/types.js

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

package/dist/wave/types.js.map

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

package/dist/wave.d.ts

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

package/dist/wave.js

@@ -0,0 +1,158 @@
+import { existsSync, mkdirSync, unlinkSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import * as md from "@mobrienv/autoloop-core";
+import { generateCompactId, joinCsv, jsonField } from "@mobrienv/autoloop-core";
+import { appendEvent, readIfExists } from "@mobrienv/autoloop-core/journal";
+import { finalizeParallelWave } from "./wave/finalize-wave.js";
+import { joinParallelBranches, launchParallelBranches, prepareParallelBranches, } from "./wave/launch-branches.js";
+import { parseParallelObjectives } from "./wave/parse-objectives.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-", ""), 10) || 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/wave.js.map

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