@openrig/cli 0.5.0 → 0.5.2

package/node_modules/@openrig/daemon/dist/domain/context-usage-store.js

@@ -0,0 +1,403 @@
+import Database from "better-sqlite3";
+import { join } from "node:path";
+import os from "node:os";
+import { closeSync, existsSync, openSync, readFileSync, readSync, readdirSync, statSync, unlinkSync } from "node:fs";
+/** Freshness threshold: samples older than this are considered stale for compact displays. */
+export const FRESHNESS_THRESHOLD_MS = 600_000; // 10 minutes per PM spec
+export class ContextUsageStore {
+    db;
+    stateDir;
+    codexHomeDir;
+    resolveOccupantBootAt;
+    constructor(db, opts) {
+        this.db = db;
+        this.stateDir = opts.stateDir;
+        this.codexHomeDir = opts.codexHomeDir ?? safeHomeDir();
+        this.resolveOccupantBootAt = opts.resolveOccupantBootAt;
+    }
+    /**
+     * GHOST-STAGE (c-id): is this reading from a generation PRIOR to the node's live occupant?
+     * A reading sampled strictly before the current occupant booted belongs to a retired tenure
+     * (the frozen-88% specimen in the mixed-gen window after handover, where the name is reused so
+     * session_mismatch cannot catch it). Returns false when boot time is UNKNOWN or the reading has
+     * no sampled_at — the gate is inert (note-2: never treat unknown as stale), leaving
+     * session_mismatch + freshness as the remaining guards. Date.parse tolerates the format skew
+     * between the collector's ISO sampled_at and SQLite datetime('now') boot_at.
+     */
+    isPriorGenerationReading(nodeId, sampledAt) {
+        if (!sampledAt)
+            return false;
+        const bootAt = this.resolveOccupantBootAt?.(nodeId) ?? null;
+        if (!bootAt)
+            return false;
+        const sampled = Date.parse(sampledAt);
+        const boot = Date.parse(bootAt);
+        if (Number.isNaN(sampled) || Number.isNaN(boot))
+            return false;
+        return sampled < boot;
+    }
+    /** Get the sidecar file path for a session. */
+    getSidecarPath(sessionName) {
+        // Sanitize session name for filesystem safety
+        const safe = sessionName.replace(/[^a-zA-Z0-9@._-]/g, "_");
+        return join(this.stateDir, "context", `${safe}.json`);
+    }
+    /**
+     * GHOST-STAGE (e) Class-A 2a: remove a retiring occupant's name-keyed context sidecar so a
+     * same-name successor does not read the predecessor's frozen telemetry sample (the "gen-1 88%
+     * resurfaced as a live threshold flag" specimen). Safe by TIMING — the cutover seam
+     * (OccupantInvalidator) calls this inside SeatHandoverService.commit(), BEFORE the successor
+     * writes its own sidecar. Missing file = no-op; best-effort (a leftover is caught downstream by
+     * the freshness gate). NOTE: this is the DISK sidecar (name-keyed); the context_usage DB table is
+     * node_id-keyed + already session_mismatch-gated, so it needs no invalidation here.
+     */
+    invalidateOccupantSidecar(sessionName) {
+        const filePath = this.getSidecarPath(sessionName);
+        try {
+            if (existsSync(filePath))
+                unlinkSync(filePath);
+        }
+        catch {
+            /* best-effort — a stale leftover is still gated by isFresh downstream */
+        }
+    }
+    /** Read and parse a sidecar JSON file. Returns discriminated result. */
+    readSidecar(sessionName) {
+        const filePath = this.getSidecarPath(sessionName);
+        try {
+            if (!existsSync(filePath))
+                return { ok: false, reason: "missing_sidecar" };
+            const content = readFileSync(filePath, "utf-8");
+            const parsed = JSON.parse(content);
+            return { ok: true, data: parsed };
+        }
+        catch {
+            return { ok: false, reason: "parse_error" };
+        }
+    }
+    /** Read sidecar and normalize into ContextUsage in one step. */
+    readAndNormalize(sessionName) {
+        const result = this.readSidecar(sessionName);
+        if (!result.ok)
+            return this.unknownUsage(result.reason);
+        return this.normalizeSample(result.data);
+    }
+    /** Read the latest Codex token_count event for a thread and normalize it. */
+    readCodexAndNormalize(input) {
+        const threadId = input.threadId?.trim();
+        if (!threadId)
+            return this.unknownUsage("no_data");
+        const thread = this.readCodexThread(threadId);
+        if (!thread?.rollout_path)
+            return this.unknownUsage("no_data");
+        const tokenEvent = this.readLatestCodexTokenCount(thread.rollout_path);
+        if (!tokenEvent)
+            return this.unknownUsage("no_data");
+        return this.normalizeCodexTokenCount({
+            event: tokenEvent,
+            sessionName: input.sessionName,
+            threadId,
+            transcriptPath: thread.rollout_path,
+        });
+    }
+    /** Normalize raw sidecar data into a ContextUsage record. */
+    normalizeSample(raw) {
+        if (!raw) {
+            return this.unknownUsage("missing_sidecar");
+        }
+        const cw = raw.context_window;
+        if (!cw || typeof cw.used_percentage !== "number") {
+            return this.unknownUsage("parse_error");
+        }
+        const sampledAt = raw.sampled_at ?? null;
+        const fresh = sampledAt ? this.isFresh(sampledAt) : false;
+        return {
+            availability: "known",
+            reason: null,
+            source: "claude_statusline_json",
+            usedPercentage: cw.used_percentage ?? null,
+            remainingPercentage: cw.remaining_percentage ?? null,
+            contextWindowSize: cw.context_window_size ?? null,
+            totalInputTokens: cw.total_input_tokens ?? null,
+            totalOutputTokens: cw.total_output_tokens ?? null,
+            currentUsage: this.normalizeCurrentUsage(cw.current_usage),
+            transcriptPath: raw.transcript_path ?? null,
+            sessionId: raw.session_id ?? null,
+            sessionName: raw.session_name ?? null,
+            sampledAt,
+            fresh,
+        };
+    }
+    /** Normalize a Codex token_count JSONL event into ContextUsage. */
+    normalizeCodexTokenCount(input) {
+        const info = input.event.payload?.info;
+        const usage = info?.last_token_usage;
+        const contextWindowSize = info?.model_context_window;
+        if (!usage || typeof contextWindowSize !== "number" || contextWindowSize <= 0) {
+            return this.unknownUsage("parse_error");
+        }
+        const inputTokens = typeof usage.input_tokens === "number" ? usage.input_tokens : null;
+        const outputTokens = typeof usage.output_tokens === "number" ? usage.output_tokens : null;
+        const totalTokens = typeof usage.total_tokens === "number"
+            ? usage.total_tokens
+            : (inputTokens ?? 0) + (outputTokens ?? 0);
+        const usedPercentage = clampPercentage(Math.round((totalTokens / contextWindowSize) * 100));
+        const remainingPercentage = clampPercentage(100 - usedPercentage);
+        const sampledAt = input.event.timestamp ?? null;
+        return {
+            availability: "known",
+            reason: null,
+            source: "codex_token_count_jsonl",
+            usedPercentage,
+            remainingPercentage,
+            contextWindowSize,
+            totalInputTokens: inputTokens,
+            totalOutputTokens: outputTokens,
+            currentUsage: this.normalizeCurrentUsage({
+                last_token_usage: usage,
+                model_context_window: contextWindowSize,
+            }),
+            transcriptPath: input.transcriptPath,
+            sessionId: input.threadId,
+            sessionName: input.sessionName,
+            sampledAt,
+            fresh: sampledAt ? this.isFresh(sampledAt) : false,
+        };
+    }
+    /** Persist a context usage record for a node. Upserts. */
+    persist(nodeId, usage) {
+        this.db.prepare(`
+      INSERT INTO context_usage (
+        node_id, session_id, session_name, availability, reason, source,
+        used_percentage, remaining_percentage, context_window_size,
+        total_input_tokens, total_output_tokens, current_usage,
+        transcript_path, sampled_at, updated_at
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, datetime('now'))
+      ON CONFLICT(node_id) DO UPDATE SET
+        session_id = excluded.session_id,
+        session_name = excluded.session_name,
+        availability = excluded.availability,
+        reason = excluded.reason,
+        source = excluded.source,
+        used_percentage = excluded.used_percentage,
+        remaining_percentage = excluded.remaining_percentage,
+        context_window_size = excluded.context_window_size,
+        total_input_tokens = excluded.total_input_tokens,
+        total_output_tokens = excluded.total_output_tokens,
+        current_usage = excluded.current_usage,
+        transcript_path = excluded.transcript_path,
+        sampled_at = excluded.sampled_at,
+        updated_at = datetime('now')
+    `).run(nodeId, usage.sessionId, usage.sessionName, usage.availability, usage.reason, usage.source, usage.usedPercentage, usage.remainingPercentage, usage.contextWindowSize, usage.totalInputTokens, usage.totalOutputTokens, usage.currentUsage, usage.transcriptPath, usage.sampledAt);
+    }
+    /** Get context usage for a single node. Session-aware: mismatched session returns unknown. */
+    getForNode(nodeId, currentSessionName) {
+        if (!currentSessionName)
+            return this.unknownUsage("not_managed");
+        const row = this.db.prepare("SELECT * FROM context_usage WHERE node_id = ?").get(nodeId);
+        if (!row)
+            return this.unknownUsage("no_data");
+        // Session mismatch guard: prevent stale cross-session inheritance
+        if (row.session_name && row.session_name !== currentSessionName) {
+            return this.unknownUsage("session_mismatch");
+        }
+        // GHOST-STAGE (c-id): generation guard. Under handover the name is REUSED, so session_mismatch
+        // passes while the table still holds the retiree's pre-boot reading (the mixed-gen window).
+        // Reject readings from before the live occupant booted → insufficient-data, evaluate current-gen only.
+        if (this.isPriorGenerationReading(nodeId, row.sampled_at)) {
+            return this.unknownUsage("stale_generation");
+        }
+        return this.rowToUsage(row);
+    }
+    /** Batch get context usage for multiple nodes. Session-aware per entry. */
+    getForNodes(entries) {
+        const result = new Map();
+        if (entries.length === 0)
+            return result;
+        const nodeIds = entries.map((e) => e.nodeId);
+        const sessionMap = new Map(entries.map((e) => [e.nodeId, e.currentSessionName]));
+        const rows = this.db.prepare(`SELECT * FROM context_usage WHERE node_id IN (${nodeIds.map(() => "?").join(",")})`).all(...nodeIds);
+        const rowMap = new Map(rows.map((r) => [r.node_id, r]));
+        for (const entry of entries) {
+            if (!entry.currentSessionName) {
+                result.set(entry.nodeId, this.unknownUsage("not_managed"));
+                continue;
+            }
+            const row = rowMap.get(entry.nodeId);
+            if (!row) {
+                result.set(entry.nodeId, this.unknownUsage("no_data"));
+                continue;
+            }
+            if (row.session_name && row.session_name !== entry.currentSessionName) {
+                result.set(entry.nodeId, this.unknownUsage("session_mismatch"));
+                continue;
+            }
+            // GHOST-STAGE (c-id): generation guard — see getForNode. Reject pre-boot (prior-gen) readings.
+            if (this.isPriorGenerationReading(entry.nodeId, row.sampled_at)) {
+                result.set(entry.nodeId, this.unknownUsage("stale_generation"));
+                continue;
+            }
+            result.set(entry.nodeId, this.rowToUsage(row));
+        }
+        return result;
+    }
+    /** Create an unknown ContextUsage with an honest reason. */
+    unknownUsage(reason) {
+        return {
+            availability: "unknown",
+            reason,
+            source: null,
+            usedPercentage: null,
+            remainingPercentage: null,
+            contextWindowSize: null,
+            totalInputTokens: null,
+            totalOutputTokens: null,
+            currentUsage: null,
+            transcriptPath: null,
+            sessionId: null,
+            sessionName: null,
+            sampledAt: null,
+            fresh: false,
+        };
+    }
+    /** Check if a sample timestamp is fresh. */
+    isFresh(sampledAt) {
+        try {
+            const age = Date.now() - new Date(sampledAt).getTime();
+            return age < FRESHNESS_THRESHOLD_MS;
+        }
+        catch {
+            return false;
+        }
+    }
+    /** Convert a DB row to a ContextUsage, applying freshness. */
+    rowToUsage(row) {
+        const fresh = row.sampled_at ? this.isFresh(row.sampled_at) : false;
+        return {
+            availability: row.availability,
+            reason: row.reason,
+            source: row.source,
+            usedPercentage: row.used_percentage,
+            remainingPercentage: row.remaining_percentage,
+            contextWindowSize: row.context_window_size,
+            totalInputTokens: row.total_input_tokens,
+            totalOutputTokens: row.total_output_tokens,
+            currentUsage: row.current_usage,
+            transcriptPath: row.transcript_path,
+            sessionId: row.session_id,
+            sessionName: row.session_name,
+            sampledAt: row.sampled_at,
+            fresh,
+        };
+    }
+    normalizeCurrentUsage(value) {
+        if (value == null)
+            return null;
+        if (typeof value === "string")
+            return value;
+        try {
+            return JSON.stringify(value);
+        }
+        catch {
+            return String(value);
+        }
+    }
+    readCodexThread(threadId) {
+        for (const dbPath of this.resolveCodexStateDbPaths()) {
+            try {
+                const codexDb = new Database(dbPath, { readonly: true });
+                try {
+                    const row = codexDb.prepare("SELECT id, rollout_path FROM threads WHERE id = ? LIMIT 1").get(threadId);
+                    if (row?.rollout_path)
+                        return row;
+                }
+                finally {
+                    codexDb.close();
+                }
+            }
+            catch {
+                continue;
+            }
+        }
+        return null;
+    }
+    resolveCodexStateDbPaths() {
+        if (!this.codexHomeDir)
+            return [];
+        const codexDir = join(this.codexHomeDir, ".codex");
+        const discovered = [];
+        try {
+            for (const entry of readdirSync(codexDir)) {
+                const match = entry.match(/^state_(\d+)\.sqlite$/);
+                if (!match)
+                    continue;
+                discovered.push({
+                    version: Number(match[1]),
+                    path: join(codexDir, entry),
+                });
+            }
+        }
+        catch {
+            // Best-effort only; fall back to the current common filename below.
+        }
+        if (discovered.length === 0) {
+            discovered.push({ version: 5, path: join(codexDir, "state_5.sqlite") });
+        }
+        return discovered
+            .sort((a, b) => b.version - a.version)
+            .map((entry) => entry.path)
+            .filter((path, index, paths) => paths.indexOf(path) === index)
+            .filter((path) => existsSync(path));
+    }
+    readLatestCodexTokenCount(rolloutPath) {
+        let content;
+        try {
+            content = this.readTail(rolloutPath, 4_000_000);
+        }
+        catch {
+            return null;
+        }
+        const lines = content.trimEnd().split("\n").reverse();
+        for (const line of lines) {
+            if (!line.includes("\"token_count\""))
+                continue;
+            try {
+                const parsed = JSON.parse(line);
+                if (parsed.payload?.type === "token_count")
+                    return parsed;
+            }
+            catch {
+                continue;
+            }
+        }
+        return null;
+    }
+    readTail(filePath, maxBytes) {
+        const stat = statSync(filePath);
+        const start = Math.max(0, stat.size - maxBytes);
+        const length = stat.size - start;
+        const fd = openSync(filePath, "r");
+        try {
+            const buffer = Buffer.alloc(length);
+            readSync(fd, buffer, 0, length, start);
+            return buffer.toString("utf-8");
+        }
+        finally {
+            closeSync(fd);
+        }
+    }
+}
+function clampPercentage(value) {
+    if (!Number.isFinite(value))
+        return 0;
+    return Math.min(100, Math.max(0, value));
+}
+function safeHomeDir() {
+    try {
+        return os.homedir();
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=context-usage-store.js.map

package/node_modules/@openrig/daemon/dist/domain/context-usage-store.js.map

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

package/node_modules/@openrig/daemon/dist/domain/crash-cart-conductor.d.ts

@@ -0,0 +1,173 @@
+/** The shipped closed per-rig union (never widened at the fleet layer). `not_attempted`
+ *  is first-class — a rig the conductor did not reach (no usable snapshot, or cancelled). */
+export type PerRigOutcome = "fully_restored" | "partially_restored" | "failed" | "not_attempted";
+/** One rig's conductor result. `receiptRef` references the durable restore event/attempt
+ *  seq (the ledger lineage) — the conductor RENDERS receipts, it never re-authors them. */
+export interface ConductorRigResult {
+    rigId: string;
+    outcome: PerRigOutcome;
+    receiptRef?: string | number;
+    /** Per-rig triage rows (seats needing operator action) — the fleet
+     *  attention_required is the UNION of these across the sequence. */
+    attention?: AttentionRow[];
+    /** R3 — for a `not_attempted` rig, WHY it was skipped (no honest gap left blank). */
+    reason?: string;
+    /** R3 — the operator action that would let this rig be restored next time. */
+    remediation?: string;
+}
+export interface RestoreConductorDeps {
+    /** Rigs in restore order — KERNEL FIRST (the supervisor), then the rest. */
+    listRigsInOrder: () => Array<{
+        rigId: string;
+        isKernel: boolean;
+    }>;
+    /** Restore ONE rig. Default (wired at the route) = findLatestRestoreUsable(rigId) →
+     *  RestoreOrchestrator.restore(snapshotId) → rollupRestoreRigResult; a rig with no
+     *  usable snapshot returns `not_attempted` (never a silent older/partial substitute). */
+    restoreRig: (rigId: string) => Promise<{
+        outcome: PerRigOutcome;
+        receiptRef?: string | number;
+        attention?: AttentionRow[];
+        reason?: string;
+        remediation?: string;
+    }>;
+    /** Cancel signal, polled at each rig BOUNDARY (stop-before-next-rig). Optional. */
+    isCancelled?: () => boolean;
+}
+export declare class RestoreConductor {
+    private readonly deps;
+    constructor(deps: RestoreConductorDeps);
+    /** Restore the fleet, kernel-first, best-effort, honoring stop-before-next-rig cancel.
+     *  Returns the ordered per-rig sequence (Atom C aggregates it into the FleetRollup). */
+    restoreFleet(opts?: {
+        onRigDone?: (result: ConductorRigResult) => void;
+    }): Promise<ConductorRigResult[]>;
+}
+/** Deps for the DEFAULT per-rig restore — structurally typed so the conductor stays
+ *  decoupled from the full orchestrator (the real wiring passes
+ *  `snapshotRepo.findLatestRestoreUsable` and `RestoreOrchestrator.restore`, whose
+ *  RestoreOutcome satisfies this shape). */
+export interface RestoreRigDeps {
+    /** Newest restore-usable snapshot for the rig, or null (→ `not_attempted`; never a silent substitute). */
+    findLatestRestoreUsable: (rigId: string) => {
+        id: string;
+    } | null;
+    /** The shipped per-rig restore. `onAttemptStarted` yields the restore-started event seq = the receipt ref. */
+    restore: (snapshotId: string, opts?: {
+        onAttemptStarted?: (attemptId: number) => void;
+    }) => Promise<{
+        ok: boolean;
+        result?: {
+            rigResult: PerRigOutcome;
+            nodes?: RestoreNodeLite[];
+        };
+    }>;
+}
+/** One seat of the subset-launch result, structurally the shipped RestoreNodeResult
+ *  subset the triage mapper reads. */
+export interface AdoptSubsetSeat extends RestoreNodeLite {
+    logicalId: string;
+}
+/** Structural slice of RestoreOrchestrator.launchNodeSubset's result — the shipped
+ *  per-seat resume-verification machinery (FR-7: an unverifiable resume fail-closes
+ *  to awaiting-decision carrying the exact `--fresh <logicalId>` remediation). */
+export interface AdoptSubsetResult {
+    ok: boolean;
+    code?: string;
+    message?: string;
+    launched?: AdoptSubsetSeat[];
+    held?: Array<{
+        logicalId: string;
+        reason: string;
+    }>;
+    alreadyRunning?: Array<{
+        logicalId: string;
+    }>;
+    failedTargets?: Array<{
+        logicalId: string;
+        reason: string;
+    }>;
+}
+export interface AdoptRigDeps {
+    /** The rig's DB-running sessions whose tmux panes are ALIVE — the same
+     *  classification restore's 409 guard runs (sessionRegistry rows ×
+     *  tmuxAdapter.hasSession); the conductor never invents a probe. */
+    probeLiveSessions: (rigId: string) => Promise<Array<{
+        sessionName: string;
+        logicalId: string;
+    }>>;
+    /** The shipped no-launch adopt (ClaimService.reconcileSession — the
+     *  `rig reconcile-session` precedent): session state only, never input. */
+    reconcileSession: (sessionName: string) => Promise<{
+        ok: boolean;
+        code?: string;
+        message?: string;
+    }>;
+    /** The rig's full seat roster (logical ids) — adoption's complement is what
+     *  per-seat resume verification must cover. */
+    listRigSeats: (rigId: string) => string[];
+    /** The shipped subset launcher over the NOT-adopted seats. */
+    launchNodeSubset: (rigId: string, logicalIds: string[]) => Promise<AdoptSubsetResult>;
+}
+/** Build the default `restoreRig` dep: COMPOSE findLatestRestoreUsable → restore →
+ *  rigResult. A rig with no usable snapshot is `not_attempted` (restore never runs);
+ *  a restore that fails outright is `failed`. Never re-authors restore logic.
+ *  With `adoptDeps` wired (Amendment 2), a rig whose panes survived takes the ADOPT
+ *  branch above; DEAD panes (and callers without adoptDeps) run unchanged. */
+export declare function createDefaultRestoreRig(_deps: RestoreRigDeps, adoptDeps?: AdoptRigDeps): (rigId: string) => Promise<{
+    outcome: PerRigOutcome;
+    receiptRef?: number;
+    attention?: AttentionRow[];
+    reason?: string;
+    remediation?: string;
+}>;
+export interface RigOrderDeps {
+    /** All (non-archived) rigs on this host — the conductor's fleet scope, v1. */
+    listRigs: () => Array<{
+        id: string;
+        name: string;
+    }>;
+}
+/** R2 — the founder's order: the KERNEL rig (the supervisor, name "kernel") restores
+ *  FIRST, then the remaining rigs in listRigs order. No kernel rig → all rigs, none
+ *  flagged kernel (honest, never fabricated). This is the `listRigsInOrder` source the
+ *  conductor consumes. */
+export declare function listRigsInKernelFirstOrder(deps: RigOrderDeps): Array<{
+    rigId: string;
+    isKernel: boolean;
+}>;
+/** A triage row: a seat + exactly what it needs (picker/auth/remediation), sourced
+ *  from the shipped per-rig restore-check attention projection. The fleet
+ *  `attention_required` is the UNION of these across rigs — a VIEW, not a parallel record. */
+export interface AttentionRow {
+    rigId: string;
+    seat: string;
+    need: string;
+}
+/** Fleet rollup — PURE AGGREGATION over the conductor's per-rig sequence. The per-rig
+ *  outcome stays the shipped CLOSED union (never widened). NO fleet verdict is stored
+ *  here — a stored verdict could drift from the per-rig truth; derive it on demand via
+ *  {@link deriveFleetVerdict}. `not_attempted` is first-class (never folded into failed). */
+export interface FleetRollup {
+    counts: Record<PerRigOutcome, number>;
+    sequence: ConductorRigResult[];
+    attention_required: AttentionRow[];
+}
+/** The fleet verdict is a DERIVED function of the counts — never a stored field. */
+export type FleetVerdict = "all_fully_restored" | "all_failed" | "none_attempted" | "mixed";
+/** A restore node (structural subset of the shipped RestoreNodeResult) — enough to
+ *  build a triage row from the seats that need operator action. */
+export interface RestoreNodeLite {
+    logicalId: string;
+    status: string;
+    error?: string;
+    attentionEvidence?: string | null;
+}
+/** R5 — map a rig's restore nodes → triage rows: the seats needing operator action
+ *  (a LIVE runtime prompt, an unresumable session, or a hard failure), each with its
+ *  EXACT need. Running/resumed nodes are excluded. Never fabricates a need. */
+export declare function attentionRowsFromNodes(rigId: string, nodes: RestoreNodeLite[]): AttentionRow[];
+export declare function aggregateFleetRollup(sequence: ConductorRigResult[]): FleetRollup;
+/** DERIVED f(counts) — computed, never stored (a stored verdict could drift). */
+export declare function deriveFleetVerdict(counts: Record<PerRigOutcome, number>): FleetVerdict;
+//# sourceMappingURL=crash-cart-conductor.d.ts.map

package/node_modules/@openrig/daemon/dist/domain/crash-cart-conductor.d.ts.map

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