agent-conveyor 0.1.0

package/dist/runtime/notifications.d.ts

@@ -0,0 +1,89 @@
+import { DatabaseSync } from "node:sqlite";
+export type RoutedNotificationDeliveryMode = "pull_required" | "push";
+export type RoutedNotificationState = "delivered" | "failed" | "pending" | "suppressed";
+export interface RoutedNotificationRecord {
+    binding_id: string;
+    claimed_at: string | null;
+    claimed_by: string | null;
+    claim_expires_at: string | null;
+    command_id: string | null;
+    correlation_id: string;
+    created_at: string;
+    consumed_at: string | null;
+    consumed_by_session_id: string | null;
+    consumed_manager_cycle_id: number | null;
+    dedupe_key: string;
+    delivered_at: string | null;
+    delivery_mode: RoutedNotificationDeliveryMode;
+    error: string | null;
+    id: number;
+    payload: Record<string, unknown>;
+    side_effect_completed: boolean;
+    side_effect_started: boolean;
+    signal_type: string;
+    source_event_id: number | null;
+    source_event_timestamp: string | null;
+    source_session_id: string;
+    state: RoutedNotificationState;
+    target_session_id: string;
+    task_id: string;
+}
+export interface SessionInboxRecord extends RoutedNotificationRecord {
+    source_session_name: string;
+    source_session_role: string;
+    target_session_name: string;
+    target_session_role: string;
+    task_name: string;
+}
+export declare class RoutedNotificationError extends Error {
+    constructor(message: string);
+}
+export declare function deliveryModeForTargetSessionSync(database: DatabaseSync, targetSessionId: string): RoutedNotificationDeliveryMode;
+export declare function insertRoutedNotificationSync(database: DatabaseSync, options: {
+    bindingId: string;
+    claimExpiresAt?: string | null;
+    claimedAt?: string | null;
+    claimedBy?: string | null;
+    commandId?: string | null;
+    correlationId: string;
+    dedupeKey: string;
+    deliveryMode?: RoutedNotificationDeliveryMode;
+    now?: string;
+    payload: Record<string, unknown>;
+    signalType: string;
+    sourceEventId?: number | null;
+    sourceEventTimestamp?: string | null;
+    sourceSessionId: string;
+    state?: RoutedNotificationState;
+    targetSessionId: string;
+    taskId: string;
+}): number;
+export declare function finishRoutedNotificationSync(database: DatabaseSync, options: {
+    error?: string | null;
+    notificationId: number;
+    now?: string;
+    sideEffectCompleted?: boolean | null;
+    state: "delivered" | "failed" | "suppressed";
+}): void;
+export declare function markRoutedNotificationSideEffectStartedSync(database: DatabaseSync, options: {
+    claimExpiresAt?: string | null;
+    claimedBy?: string | null;
+    notificationId: number;
+    now?: string;
+}): void;
+export declare function deferRoutedNotificationBeforeSideEffectSync(database: DatabaseSync, options: {
+    error: string;
+    notificationId: number;
+}): void;
+export declare function routedNotificationsSync(database: DatabaseSync, options?: {
+    taskId?: string | null;
+}): RoutedNotificationRecord[];
+export declare function sessionInboxSync(database: DatabaseSync, options: {
+    includeConsumed?: boolean;
+    limit?: number;
+    sessionName: string;
+}): SessionInboxRecord[];
+export declare function consumeNextSessionInboxItemSync(database: DatabaseSync, options: {
+    now?: string;
+    sessionName: string;
+}): SessionInboxRecord | null;

package/dist/runtime/notifications.js

@@ -0,0 +1,208 @@
+export class RoutedNotificationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "RoutedNotificationError";
+    }
+}
+export function deliveryModeForTargetSessionSync(database, targetSessionId) {
+    const row = database.prepare("select tmux_session from sessions where id = ?").get(targetSessionId);
+    if (!row) {
+        throw new RoutedNotificationError(`target session ${JSON.stringify(targetSessionId)} no longer exists`);
+    }
+    return row.tmux_session ? "push" : "pull_required";
+}
+export function insertRoutedNotificationSync(database, options) {
+    const state = options.state ?? "pending";
+    if (!["pending", "delivered", "failed", "suppressed"].includes(state)) {
+        throw new RoutedNotificationError(`invalid routed notification state: ${state}`);
+    }
+    const deliveryMode = options.deliveryMode ?? "push";
+    if (!["push", "pull_required"].includes(deliveryMode)) {
+        throw new RoutedNotificationError(`invalid routed notification delivery mode: ${deliveryMode}`);
+    }
+    const createdAt = options.now ?? new Date().toISOString();
+    const claimedAt = options.claimedAt ?? (options.claimedBy ? createdAt : null);
+    const result = database.prepare(`
+    insert into routed_notifications(
+      task_id, binding_id, correlation_id, source_session_id, target_session_id,
+      signal_type, source_event_id, source_event_timestamp, dedupe_key, command_id,
+      created_at, state, payload_json, claimed_by, claimed_at, claim_expires_at,
+      delivery_mode
+    )
+    values (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+  `).run(options.taskId, options.bindingId, options.correlationId, options.sourceSessionId, options.targetSessionId, options.signalType, options.sourceEventId ?? null, options.sourceEventTimestamp ?? null, options.dedupeKey, options.commandId ?? null, createdAt, state, stableJson(options.payload), options.claimedBy ?? null, claimedAt, options.claimExpiresAt ?? null, deliveryMode);
+    return Number(result.lastInsertRowid);
+}
+export function finishRoutedNotificationSync(database, options) {
+    const deliveredAt = options.state === "delivered" ? options.now ?? new Date().toISOString() : null;
+    const completed = options.sideEffectCompleted ?? (options.state === "delivered");
+    database.prepare(`
+    update routed_notifications
+    set state = ?, delivered_at = ?, error = ?, side_effect_completed = ?
+    where id = ?
+  `).run(options.state, deliveredAt, options.error ?? null, completed ? 1 : 0, options.notificationId);
+}
+export function markRoutedNotificationSideEffectStartedSync(database, options) {
+    if (options.claimedBy === undefined && options.claimExpiresAt === undefined) {
+        database.prepare("update routed_notifications set side_effect_started = 1 where id = ?").run(options.notificationId);
+        return;
+    }
+    const timestamp = options.now ?? new Date().toISOString();
+    database.prepare(`
+    update routed_notifications
+    set side_effect_started = 1,
+        claimed_by = coalesce(?, claimed_by),
+        claimed_at = coalesce(claimed_at, ?),
+        claim_expires_at = coalesce(?, claim_expires_at)
+    where id = ?
+  `).run(options.claimedBy ?? null, timestamp, options.claimExpiresAt ?? null, options.notificationId);
+}
+export function deferRoutedNotificationBeforeSideEffectSync(database, options) {
+    database.prepare(`
+    update routed_notifications
+    set state = 'pending',
+        error = ?,
+        claimed_by = null,
+        claimed_at = null,
+        claim_expires_at = null,
+        side_effect_started = 0,
+        side_effect_completed = 0
+    where id = ?
+  `).run(options.error, options.notificationId);
+}
+export function routedNotificationsSync(database, options) {
+    const rows = options?.taskId
+        ? database.prepare(`${routedNotificationSelect()} where task_id = ? order by id`).all(options.taskId)
+        : database.prepare(`${routedNotificationSelect()} order by id`).all();
+    return rows.map(routedNotificationRecord);
+}
+export function sessionInboxSync(database, options) {
+    const session = sessionRow(database, options.sessionName);
+    const where = options.includeConsumed
+        ? "rn.target_session_id = ? and rn.state = 'delivered'"
+        : "rn.target_session_id = ? and rn.state = 'delivered' and rn.consumed_at is null";
+    const rows = database.prepare(`${sessionInboxQuery(where)} limit ?`).all(session.id, Math.max(1, options.limit ?? 10));
+    return rows.map(sessionInboxRecord);
+}
+export function consumeNextSessionInboxItemSync(database, options) {
+    const session = sessionRow(database, options.sessionName);
+    const row = database.prepare(`
+    select id
+    from routed_notifications
+    where target_session_id = ?
+      and state = 'delivered'
+      and consumed_at is null
+    order by created_at, id
+    limit 1
+  `).get(session.id);
+    if (!row) {
+        return null;
+    }
+    const result = database.prepare(`
+    update routed_notifications
+    set consumed_at = ?, consumed_by_session_id = ?
+    where id = ?
+      and target_session_id = ?
+      and state = 'delivered'
+      and consumed_at is null
+  `).run(options.now ?? new Date().toISOString(), session.id, row.id, session.id);
+    if (result.changes === 0) {
+        return null;
+    }
+    const consumed = database.prepare(sessionInboxQuery("rn.id = ?")).get(row.id);
+    return consumed ? sessionInboxRecord(consumed) : null;
+}
+function routedNotificationSelect() {
+    return `
+    select id, task_id, binding_id, correlation_id, source_session_id,
+           target_session_id, signal_type, source_event_id, source_event_timestamp,
+           dedupe_key, command_id, created_at, delivered_at, consumed_manager_cycle_id,
+           consumed_by_session_id, consumed_at, delivery_mode, state, claimed_by,
+           claimed_at, claim_expires_at, side_effect_started, side_effect_completed,
+           payload_json, error
+    from routed_notifications
+  `;
+}
+function sessionInboxQuery(whereClause) {
+    return `
+    select
+      rn.id, rn.task_id, rn.binding_id, rn.correlation_id,
+      rn.source_session_id, rn.target_session_id, rn.signal_type,
+      rn.source_event_id, rn.source_event_timestamp, rn.dedupe_key,
+      rn.command_id, rn.created_at, rn.delivered_at,
+      rn.consumed_manager_cycle_id, rn.consumed_by_session_id,
+      rn.consumed_at, rn.delivery_mode, rn.state, rn.claimed_by,
+      rn.claimed_at, rn.claim_expires_at, rn.side_effect_started,
+      rn.side_effect_completed, rn.payload_json, rn.error,
+      ss.name as source_session_name, ss.role as source_session_role,
+      ts.name as target_session_name, ts.role as target_session_role,
+      t.name as task_name
+    from routed_notifications rn
+    join sessions ss on ss.id = rn.source_session_id
+    join sessions ts on ts.id = rn.target_session_id
+    join tasks t on t.id = rn.task_id
+    where ${whereClause}
+    order by rn.created_at, rn.id
+  `;
+}
+function sessionInboxRecord(row) {
+    return {
+        ...routedNotificationRecord(row),
+        source_session_name: row.source_session_name,
+        source_session_role: row.source_session_role,
+        target_session_name: row.target_session_name,
+        target_session_role: row.target_session_role,
+        task_name: row.task_name,
+    };
+}
+function routedNotificationRecord(row) {
+    return {
+        binding_id: row.binding_id,
+        claimed_at: row.claimed_at,
+        claimed_by: row.claimed_by,
+        claim_expires_at: row.claim_expires_at,
+        command_id: row.command_id,
+        correlation_id: row.correlation_id,
+        created_at: row.created_at,
+        consumed_at: row.consumed_at,
+        consumed_by_session_id: row.consumed_by_session_id,
+        consumed_manager_cycle_id: row.consumed_manager_cycle_id,
+        dedupe_key: row.dedupe_key,
+        delivered_at: row.delivered_at,
+        delivery_mode: row.delivery_mode,
+        error: row.error,
+        id: row.id,
+        payload: JSON.parse(row.payload_json),
+        side_effect_completed: Boolean(row.side_effect_completed),
+        side_effect_started: Boolean(row.side_effect_started),
+        signal_type: row.signal_type,
+        source_event_id: row.source_event_id,
+        source_event_timestamp: row.source_event_timestamp,
+        source_session_id: row.source_session_id,
+        state: row.state,
+        target_session_id: row.target_session_id,
+        task_id: row.task_id,
+    };
+}
+function sessionRow(database, sessionName) {
+    const row = database.prepare("select id, name, role from sessions where name = ?").get(sessionName);
+    if (!row) {
+        throw new RoutedNotificationError(`no session registered with name ${JSON.stringify(sessionName)}`);
+    }
+    return row;
+}
+function stableJson(value) {
+    return JSON.stringify(sortJson(value));
+}
+function sortJson(value) {
+    if (Array.isArray(value)) {
+        return value.map(sortJson);
+    }
+    if (value !== null && typeof value === "object") {
+        return Object.fromEntries(Object.entries(value)
+            .sort(([left], [right]) => left.localeCompare(right))
+            .map(([key, item]) => [key, sortJson(item)]));
+    }
+    return value;
+}
+//# sourceMappingURL=notifications.js.map

package/dist/runtime/notifications.js.map

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

package/dist/runtime/replay.d.ts

@@ -0,0 +1,29 @@
+import type { TaskAuditResult } from "./audit.js";
+export type ReplayMode = "compact" | "timeline" | "transcript" | "full-transcript";
+export type ReplayRole = "all" | "worker" | "manager" | "reviewer" | "workerctl";
+export interface ReplayEntry {
+    actor: string;
+    details: Record<string, unknown>;
+    kind: string;
+    source: string;
+    source_id: number | string | null;
+    summary: string;
+    timestamp: string;
+}
+export interface ReplayResult {
+    entries: ReplayEntry[];
+    entry_count: number;
+    mode: ReplayMode;
+    role: ReplayRole;
+    task: TaskAuditResult["task"];
+}
+export declare function replayEntriesFromAudit(audit: TaskAuditResult, options?: {
+    mode?: ReplayMode;
+    role?: ReplayRole;
+}): ReplayEntry[];
+export declare function replayResultFromAudit(audit: TaskAuditResult, options?: {
+    limit?: number | null;
+    mode?: ReplayMode;
+    role?: ReplayRole;
+}): ReplayResult;
+export declare function renderReplayText(result: ReplayResult): string;

package/dist/runtime/replay.js

@@ -0,0 +1,331 @@
+export function replayEntriesFromAudit(audit, options = {}) {
+    const mode = options.mode ?? "timeline";
+    const role = options.role ?? "all";
+    const entries = [];
+    const includeObserves = mode !== "compact";
+    for (const command of audit.commands) {
+        const [actor, kind, summary] = commandSummary(command);
+        if (!roleIncludesActor(role, actor)) {
+            continue;
+        }
+        entries.push({
+            actor,
+            details: {
+                command_id: command.id,
+                state: command.state,
+                type: command.type,
+            },
+            kind,
+            source: "commands",
+            source_id: command.id,
+            summary,
+            timestamp: command.created_at,
+        });
+    }
+    for (const attempt of audit.command_attempts) {
+        if (role !== "all" && role !== "manager") {
+            continue;
+        }
+        entries.push(commandAttemptEntry(attempt));
+    }
+    for (const notification of audit.routed_notifications) {
+        if (role !== "all" && role !== "manager") {
+            continue;
+        }
+        entries.push(routedNotificationEntry(notification));
+    }
+    for (const chain of audit.correlation_chains) {
+        if (role !== "all" && role !== "manager") {
+            continue;
+        }
+        entries.push(correlationChainEntry(audit, chain));
+    }
+    for (const decision of audit.manager_decisions) {
+        if (role !== "all" && role !== "manager") {
+            continue;
+        }
+        entries.push(managerDecisionEntry(decision));
+    }
+    if (includeObserves) {
+        for (const event of audit.events) {
+            if (role !== "all" && role !== "manager") {
+                continue;
+            }
+            const summary = acceptanceCriterionSummary(event);
+            if (summary === null) {
+                continue;
+            }
+            entries.push({
+                actor: event.actor || "workerctl",
+                details: acceptanceCriterionDetails(event),
+                kind: "acceptance_criterion",
+                source: "events",
+                source_id: event.id,
+                summary,
+                timestamp: event.created_at,
+            });
+        }
+    }
+    return entries.sort((left, right) => {
+        const timestamp = left.timestamp.localeCompare(right.timestamp);
+        if (timestamp !== 0) {
+            return timestamp;
+        }
+        const source = left.source.localeCompare(right.source);
+        if (source !== 0) {
+            return source;
+        }
+        return String(left.source_id).localeCompare(String(right.source_id));
+    });
+}
+export function replayResultFromAudit(audit, options = {}) {
+    const mode = options.mode ?? "timeline";
+    const role = options.role ?? "all";
+    let entries = replayEntriesFromAudit(audit, { mode, role });
+    if (options.limit !== undefined && options.limit !== null) {
+        entries = entries.slice(-options.limit);
+    }
+    return {
+        entries,
+        entry_count: entries.length,
+        mode,
+        role,
+        task: audit.task,
+    };
+}
+export function renderReplayText(result) {
+    const lines = [
+        `Task: ${result.task.name}`,
+        `State: ${result.task.state}`,
+        `Mode: ${result.mode}`,
+        "",
+    ];
+    const finishEntries = result.entries.filter((entry) => entry.kind === "finish");
+    if ((result.task.state === "done" || result.task.state === "failed") && finishEntries.length > 0) {
+        const final = finishEntries[finishEntries.length - 1];
+        lines.push("Finished:", `- ${final.summary}`, "- Review: conveyor replay <task> --format compact", "- Audit: conveyor mutation-audit <task> --json", "");
+    }
+    for (const entry of result.entries) {
+        const hhmmss = entry.timestamp.split("T", 2).at(1)?.replace(/Z$/, "") ?? entry.timestamp;
+        lines.push(`${hhmmss}  ${entry.actor.padEnd(16, " ")} ${entry.summary}`);
+    }
+    return lines.join("\n");
+}
+function commandAttemptEntry(attempt) {
+    return {
+        actor: "dispatch",
+        details: {
+            attempt_id: attempt.id,
+            command_id: attempt.command_id,
+            correlation_id: attempt.correlation_id,
+            dispatcher_id: attempt.dispatcher_id,
+            error: attempt.error,
+            result: attempt.result,
+            side_effect_completed: attempt.side_effect_completed,
+            side_effect_started: attempt.side_effect_started,
+            state: attempt.state,
+        },
+        kind: "command_attempt",
+        source: "command_attempts",
+        source_id: attempt.id,
+        summary: `dispatch attempt ${attempt.state}: ${attempt.command_id}`,
+        timestamp: attempt.started_at,
+    };
+}
+function routedNotificationEntry(notification) {
+    return {
+        actor: "dispatch",
+        details: {
+            command_id: notification.command_id,
+            consumed_at: notification.consumed_at,
+            consumed_by_session_id: notification.consumed_by_session_id,
+            consumed_by_session_name: notification.consumed_by_session_name,
+            correlation_id: notification.correlation_id,
+            delivered_at: notification.delivered_at,
+            delivery_mode: notification.delivery_mode,
+            notification_id: notification.id,
+            signal_type: notification.signal_type,
+            source_session_id: notification.source_session_id,
+            source_session_name: notification.source_session_name,
+            state: notification.state,
+            target_session_id: notification.target_session_id,
+            target_session_name: notification.target_session_name,
+        },
+        kind: "routed_notification",
+        source: "routed_notifications",
+        source_id: notification.id,
+        summary: (`dispatch notification ${notification.signal_type}: `
+            + `${notification.state} via ${notification.delivery_mode ?? "unknown"}`),
+        timestamp: notification.delivered_at ?? notification.created_at,
+    };
+}
+function correlationChainEntry(audit, chain) {
+    const parts = [chain.command_type, chain.command_state];
+    if (chain.command_id === null && chain.source_event_id !== undefined && chain.source_event_id !== null) {
+        parts.push(`source event #${chain.source_event_id}`);
+    }
+    if (chain.manager_decision_id !== null) {
+        parts.push(`decision #${chain.manager_decision_id}`);
+    }
+    if (chain.manager_cycle_id !== null) {
+        parts.push(`cycle #${chain.manager_cycle_id}`);
+    }
+    if (chain.attempt_ids.length > 0) {
+        parts.push(`${chain.attempt_ids.length} attempt(s)`);
+    }
+    if (chain.routed_notification_ids.length > 0) {
+        parts.push(`${chain.routed_notification_ids.length} notification(s)`);
+    }
+    return {
+        actor: "dispatch",
+        details: chain,
+        kind: "correlation_chain",
+        source: "correlation_chains",
+        source_id: chain.command_id ?? chain.correlation_id ?? chain.source_event_id ?? null,
+        summary: parts.join(" -> "),
+        timestamp: commandCreatedAt(audit, chain.command_id) ?? chain.created_at ?? audit.task.created_at,
+    };
+}
+function managerDecisionEntry(decision) {
+    return {
+        actor: "manager",
+        details: {
+            decision: decision.decision,
+            manager_cycle_id: decision.manager_cycle_id,
+        },
+        kind: "decision",
+        source: "manager_decisions",
+        source_id: decision.id,
+        summary: `decision ${decision.decision}: ${shorten(decision.reason)}`,
+        timestamp: decision.created_at,
+    };
+}
+function commandCreatedAt(audit, commandId) {
+    if (commandId === null) {
+        return null;
+    }
+    return audit.commands.find((command) => command.id === commandId)?.created_at ?? null;
+}
+function commandSummary(command) {
+    const payload = command.payload;
+    const result = command.result ?? {};
+    if (command.type === "promote") {
+        return [
+            "system",
+            "command",
+            `promoted worker ${payload.worker ?? result.worker} and launched manager ${result.manager_session}`,
+        ];
+    }
+    if (command.type === "task_interrupt") {
+        const followup = stringValue(result.followup ?? payload.followup) ?? "interrupt";
+        return ["manager -> worker", "command", `sent interrupt: ${shorten(followup)}`];
+    }
+    if (command.type === "task_nudge") {
+        const message = stringValue(result.message ?? payload.message) ?? "nudge";
+        return ["manager -> worker", "command", `sent nudge: ${shorten(message)}`];
+    }
+    if (command.type === "finish_task") {
+        const reason = stringValue(result.reason ?? payload.reason) ?? "task finished";
+        const suffix = result.stop_manager ? "manager stopped" : "manager left open";
+        return ["manager", "finish", `finished task: ${shorten(reason)} (${suffix})`];
+    }
+    if (command.type === "close_manager") {
+        const reason = stringValue(result.reason ?? payload.reason) ?? "manager closed";
+        return ["workerctl", "command", `closed manager: ${shorten(reason)}`];
+    }
+    return ["workerctl", "command", `${command.type} ${command.state}`];
+}
+function acceptanceCriterionSummary(event) {
+    const payload = event.payload;
+    const criterionId = payload.criterion_id;
+    const criterionLabel = criterionId !== undefined && criterionId !== null ? `#${criterionId}` : "<unknown>";
+    const status = stringValue(payload.status);
+    const criterion = stringValue(payload.criterion) ?? "";
+    const previousStatus = stringValue(payload.previous_status);
+    const transition = previousStatus && status ? ` (${previousStatus} -> ${status})` : "";
+    if (event.type === "acceptance_criterion_added") {
+        if (status === "proposed") {
+            return `proposed criterion ${criterionLabel}: ${shorten(criterion)}`;
+        }
+        if (status === "accepted") {
+            return `accepted criterion ${criterionLabel}: ${shorten(criterion)}`;
+        }
+        if (status === "satisfied") {
+            const proof = stringValue(payload.proof);
+            return proof
+                ? `satisfied criterion ${criterionLabel}: proof recorded (${shorten(proof)})`
+                : `satisfied criterion ${criterionLabel}: proof recorded`;
+        }
+        if (status === "deferred") {
+            return `deferred criterion ${criterionLabel}: ${shorten(stringValue(payload.rationale) ?? criterion)}`;
+        }
+        if (status === "rejected") {
+            return `rejected criterion ${criterionLabel}: ${shorten(stringValue(payload.rationale) ?? criterion)}`;
+        }
+        return `added ${status ?? "unknown"} criterion ${criterionLabel}: ${shorten(criterion)}`;
+    }
+    if (event.type !== "acceptance_criterion_updated") {
+        return null;
+    }
+    if (status === "accepted") {
+        return `accepted criterion ${criterionLabel}${transition}: ${shorten(criterion)}`;
+    }
+    if (status === "satisfied") {
+        const proof = stringValue(payload.proof);
+        return proof
+            ? `satisfied criterion ${criterionLabel}${transition}: proof recorded (${shorten(proof)})`
+            : `satisfied criterion ${criterionLabel}${transition}: proof recorded`;
+    }
+    if (status === "deferred") {
+        return `deferred criterion ${criterionLabel}${transition}: ${shorten(stringValue(payload.rationale) ?? criterion)}`;
+    }
+    if (status === "rejected") {
+        return `rejected criterion ${criterionLabel}${transition}: ${shorten(stringValue(payload.rationale) ?? criterion)}`;
+    }
+    const fallbackTransition = previousStatus ? `${previousStatus} -> ${status}` : status ?? "updated";
+    return `updated criterion ${criterionLabel}: ${fallbackTransition}`;
+}
+function acceptanceCriterionDetails(event) {
+    const details = { event_type: event.type };
+    const keys = [
+        "criterion_id",
+        "criterion",
+        "status",
+        "previous_status",
+        "source",
+        "task_id",
+        "proof",
+        "previous_proof",
+        "rationale",
+        "previous_rationale",
+        "evidence",
+        "previous_evidence",
+        "created",
+    ];
+    for (const key of keys) {
+        if (key in event.payload) {
+            details[key] = event.payload[key];
+        }
+    }
+    return details;
+}
+function roleIncludesActor(role, actor) {
+    if (role === "all") {
+        return true;
+    }
+    if (actor === role || actor === `manager -> ${role}` || actor === `${role} -> manager`) {
+        return true;
+    }
+    return role === "manager" && (actor === "workerctl" || actor === "system");
+}
+function shorten(value, maxLength = 220) {
+    const text = value.split(/\s+/).filter(Boolean).join(" ");
+    if (text.length <= maxLength) {
+        return text;
+    }
+    return `${text.slice(0, maxLength - 1).trimEnd()}...`;
+}
+function stringValue(value) {
+    return typeof value === "string" ? value : null;
+}
+//# sourceMappingURL=replay.js.map