@sentropic/h2a-cli 0.74.0 → 0.78.0

package/dist/runtime/escalation/index.d.ts

@@ -1,2 +0,0 @@
-export { recordEscalation, readEscalation, listEscalations, clearEscalation, type H2AEscalationRecord, type H2AEscalationReason, type RecordEscalationInput } from "./registry.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/runtime/escalation/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/escalation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,eAAe,EACf,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC3B,MAAM,eAAe,CAAC"}

package/dist/runtime/escalation/index.js

@@ -1,2 +0,0 @@
-export { recordEscalation, readEscalation, listEscalations, clearEscalation } from "./registry.js";
-//# sourceMappingURL=index.js.map

package/dist/runtime/escalation/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/runtime/escalation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,eAAe,EAIhB,MAAM,eAAe,CAAC"}

package/dist/runtime/escalation/registry.d.ts

@@ -1,44 +0,0 @@
-/**
- * Durable escalation registry (DEC-095, Drumbeat D7). When an agent exhausts its
- * relance budget (DEC-086 `scanDrumbeat` → `exhausted`), the daemon must stop
- * looping and **escalate to the PRINCIPAL** (DEC-084: the engagement owner, not
- * EXECUTIF) over the `alert` channel (DEC-040). The relance cap is the anti-loop
- * guard; this registry is the escalation that replaces further relances.
- *
- * Parallel to the drumbeat/blockage registries: `<root>/.h2a/escalation/<safe-instance>.json`.
- */
-/**
- * Why the escalation fired. `relance-exhausted` (D7, relance budget spent);
- * `watchdog-escalate` / `reroute-suggested` (D5, the reflexive watchdog decided
- * a human must look, or that the work should be reassigned).
- */
-export type H2AEscalationReason = "relance-exhausted" | "watchdog-escalate" | "reroute-suggested";
-export interface H2AEscalationRecord {
-    readonly instance: string;
-    readonly reason: H2AEscalationReason;
-    /** Relance count at the time the budget was exhausted. */
-    readonly relanceCount: number;
-    /** Escalation channel (DEC-040). Defaults to `alert`. */
-    readonly channel: string;
-    /** Symbolic target — the scope's competent authority. Defaults to `PRINCIPAL` (DEC-084). */
-    readonly to: string;
-    readonly at: string;
-}
-export interface RecordEscalationInput {
-    readonly instance: string;
-    readonly reason: H2AEscalationReason;
-    readonly relanceCount: number;
-    readonly channel?: string;
-    readonly to?: string;
-}
-/**
- * Record (upsert) an escalation. Idempotent per instance: a repeated escalation
- * for the same exhausted instance overwrites with the latest count/time rather
- * than piling up — the PRINCIPAL needs one open alert per agent, not a flood.
- */
-export declare function recordEscalation(root: string, input: RecordEscalationInput, now?: number): H2AEscalationRecord;
-export declare function readEscalation(root: string, instance: string): H2AEscalationRecord | undefined;
-export declare function listEscalations(root: string): H2AEscalationRecord[];
-/** Clear an escalation — call when the agent is cleanly resumed/finished. */
-export declare function clearEscalation(root: string, instance: string): void;
-//# sourceMappingURL=registry.d.ts.map

package/dist/runtime/escalation/registry.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/runtime/escalation/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,mBAAmB,GAAG,mBAAmB,GAAG,mBAAmB,CAAC;AAElG,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,0DAA0D;IAC1D,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,yDAAyD;IACzD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,4FAA4F;IAC5F,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAMD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,qBAAqB,EAC5B,GAAG,GAAE,MAAmB,GACvB,mBAAmB,CAYrB;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAQ9F;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,EAAE,CAmBnE;AAED,6EAA6E;AAC7E,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAMpE"}

package/dist/runtime/escalation/registry.js

@@ -1,79 +0,0 @@
-/**
- * Durable escalation registry (DEC-095, Drumbeat D7). When an agent exhausts its
- * relance budget (DEC-086 `scanDrumbeat` → `exhausted`), the daemon must stop
- * looping and **escalate to the PRINCIPAL** (DEC-084: the engagement owner, not
- * EXECUTIF) over the `alert` channel (DEC-040). The relance cap is the anti-loop
- * guard; this registry is the escalation that replaces further relances.
- *
- * Parallel to the drumbeat/blockage registries: `<root>/.h2a/escalation/<safe-instance>.json`.
- */
-import { existsSync, mkdirSync, readFileSync, readdirSync, unlinkSync, writeFileSync } from "node:fs";
-import { join } from "node:path";
-import { localStorePaths, safePathSegment } from "../local-files/paths.js";
-function entryFile(root, instance) {
-    return join(localStorePaths(root).escalation, `${safePathSegment(instance)}.json`);
-}
-/**
- * Record (upsert) an escalation. Idempotent per instance: a repeated escalation
- * for the same exhausted instance overwrites with the latest count/time rather
- * than piling up — the PRINCIPAL needs one open alert per agent, not a flood.
- */
-export function recordEscalation(root, input, now = Date.now()) {
-    mkdirSync(localStorePaths(root).escalation, { recursive: true });
-    const record = {
-        instance: input.instance,
-        reason: input.reason,
-        relanceCount: input.relanceCount,
-        channel: input.channel ?? "alert",
-        to: input.to ?? "PRINCIPAL",
-        at: new Date(now).toISOString()
-    };
-    writeFileSync(entryFile(root, input.instance), `${JSON.stringify(record, null, 2)}\n`, "utf8");
-    return record;
-}
-export function readEscalation(root, instance) {
-    const file = entryFile(root, instance);
-    if (!existsSync(file))
-        return undefined;
-    try {
-        return JSON.parse(readFileSync(file, "utf8"));
-    }
-    catch {
-        return undefined;
-    }
-}
-export function listEscalations(root) {
-    const dir = localStorePaths(root).escalation;
-    let names;
-    try {
-        names = readdirSync(dir);
-    }
-    catch (err) {
-        if (err.code === "ENOENT")
-            return [];
-        throw err;
-    }
-    const out = [];
-    for (const name of names) {
-        if (!name.endsWith(".json"))
-            continue;
-        try {
-            out.push(JSON.parse(readFileSync(join(dir, name), "utf8")));
-        }
-        catch {
-            // skip malformed
-        }
-    }
-    return out;
-}
-/** Clear an escalation — call when the agent is cleanly resumed/finished. */
-export function clearEscalation(root, instance) {
-    try {
-        unlinkSync(entryFile(root, instance));
-    }
-    catch (err) {
-        if (err.code !== "ENOENT")
-            throw err;
-    }
-}
-//# sourceMappingURL=registry.js.map

package/dist/runtime/escalation/registry.js.map

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

package/dist/runtime/governance/claims.d.ts

@@ -1,43 +0,0 @@
-/**
- * Governance primitive: append-only conductor-claims store (WP-G1b).
- *
- * A claim event signals that an instance is asserting the conductor role for
- * a workspace; a release event cancels it. The store is a plain JSONL file at
- * `<root>/.h2a/governance/conductor-claims.jsonl`. The fold over events is
- * `activeConductorClaims`: an instance has an active claim iff its latest event
- * (by `at`) for (workspaceId, instance) is a `claim` (a `release` cancels it).
- *
- * This is additive/reversible — append-only, no deletion, no enforcement.
- */
-export interface ConductorClaimEvent {
-    readonly type: "claim" | "release";
-    readonly workspaceId: string;
-    readonly instance: string;
-    /** ISO 8601 timestamp of the event. */
-    readonly at: string;
-}
-/**
- * Append a conductor claim or release event to the JSONL store.
- * Creates the governance directory if it does not exist.
- */
-export declare function appendConductorClaim(root: string, event: ConductorClaimEvent): void;
-/**
- * Read all conductor claim/release events from the store.
- * Returns an empty array if the file does not exist. Skips malformed lines.
- */
-export declare function listConductorClaims(root: string): ConductorClaimEvent[];
-/**
- * Fold the claim/release log to find active claimants for a workspace.
- *
- * An instance has an **active** claim for `workspaceId` iff its latest event
- * (by `at`) for the pair `(workspaceId, instance)` is a `claim` (a subsequent
- * `release` cancels it).
- *
- * Returns active claimants sorted by their claim `at` ASCENDING (earliest
- * claimant first — the tiebreaker for the conductor election).
- */
-export declare function activeConductorClaims(root: string, workspaceId: string): Array<{
-    instance: string;
-    at: string;
-}>;
-//# sourceMappingURL=claims.d.ts.map

package/dist/runtime/governance/claims.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"claims.d.ts","sourceRoot":"","sources":["../../../src/runtime/governance/claims.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAWH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,uCAAuC;IACvC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAkBD;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,mBAAmB,GACzB,IAAI,CAIN;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,EAAE,CAavE;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,GAClB,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,CA4BzC"}

package/dist/runtime/governance/claims.js

@@ -1,93 +0,0 @@
-/**
- * Governance primitive: append-only conductor-claims store (WP-G1b).
- *
- * A claim event signals that an instance is asserting the conductor role for
- * a workspace; a release event cancels it. The store is a plain JSONL file at
- * `<root>/.h2a/governance/conductor-claims.jsonl`. The fold over events is
- * `activeConductorClaims`: an instance has an active claim iff its latest event
- * (by `at`) for (workspaceId, instance) is a `claim` (a `release` cancels it).
- *
- * This is additive/reversible — append-only, no deletion, no enforcement.
- */
-import { appendFileSync, existsSync, mkdirSync, readFileSync } from "node:fs";
-import { join } from "node:path";
-import { canonicalAddress, localStorePaths } from "../local-files/index.js";
-// ---------------------------------------------------------------------------
-// Paths
-// ---------------------------------------------------------------------------
-function governanceDir(root) {
-    return join(localStorePaths(root).root, "governance");
-}
-function claimsFile(root) {
-    return join(governanceDir(root), "conductor-claims.jsonl");
-}
-// ---------------------------------------------------------------------------
-// Store operations
-// ---------------------------------------------------------------------------
-/**
- * Append a conductor claim or release event to the JSONL store.
- * Creates the governance directory if it does not exist.
- */
-export function appendConductorClaim(root, event) {
-    const dir = governanceDir(root);
-    mkdirSync(dir, { recursive: true });
-    appendFileSync(claimsFile(root), `${JSON.stringify(event)}\n`, "utf8");
-}
-/**
- * Read all conductor claim/release events from the store.
- * Returns an empty array if the file does not exist. Skips malformed lines.
- */
-export function listConductorClaims(root) {
-    const file = claimsFile(root);
-    if (!existsSync(file))
-        return [];
-    const out = [];
-    for (const line of readFileSync(file, "utf8").split("\n")) {
-        if (!line.trim())
-            continue;
-        try {
-            out.push(JSON.parse(line));
-        }
-        catch {
-            // skip malformed line
-        }
-    }
-    return out;
-}
-/**
- * Fold the claim/release log to find active claimants for a workspace.
- *
- * An instance has an **active** claim for `workspaceId` iff its latest event
- * (by `at`) for the pair `(workspaceId, instance)` is a `claim` (a subsequent
- * `release` cancels it).
- *
- * Returns active claimants sorted by their claim `at` ASCENDING (earliest
- * claimant first — the tiebreaker for the conductor election).
- */
-export function activeConductorClaims(root, workspaceId) {
-    const events = listConductorClaims(root);
-    // Compare workspace ids CANONICALLY so a claim stored raw still matches a
-    // canonicalized lookup (conductorFor passes canonicalAddress(workspaceId)).
-    const wantWs = canonicalAddress(workspaceId);
-    // Build a map: instance → { type, at } of the LATEST event for this workspaceId.
-    const latest = new Map();
-    for (const ev of events) {
-        if (canonicalAddress(ev.workspaceId) !== wantWs)
-            continue;
-        const prev = latest.get(ev.instance);
-        if (!prev || ev.at >= prev.at) {
-            latest.set(ev.instance, { type: ev.type, at: ev.at });
-        }
-    }
-    // Retain only instances whose latest event is a `claim`.
-    const active = [];
-    for (const [instance, { type, at }] of latest) {
-        if (type === "claim") {
-            active.push({ instance, at });
-        }
-    }
-    // Sort ascending by `at` so the earliest claimant is first.
-    active.sort((a, b) => a.at.localeCompare(b.at));
-    return active;
-}
-//# sourceMappingURL=claims.js.map

package/dist/runtime/governance/claims.js.map

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

package/dist/runtime/governance/conductor.d.ts

@@ -1,79 +0,0 @@
-/**
- * Governance primitive: conductor/owner resolver for a workspace.
- *
- * WP-G1 — Read-only, pure over presence + registry + claims. No writes.
- *
- * The "CONDUCTOR of workspace W" is resolved in precedence order:
- * 1. The EARLIEST active-claim instance (from activeConductorClaims) that is
- *    also a live in-workspace candidate (WP-G1b — claim-based election).
- * 2. (back-compat) A live candidate whose registration roles include
- *    "CONDUCTOR" (WP-G1a — role-based).
- * 3. null (the common state: agents auto-register as AGENTS).
- */
-/** One live in-workspace agent. */
-export interface ConductorCandidate {
-    /** Perennial instance id (host:slug:uuid12). */
-    readonly instance: string;
-    /** Host (claude, codex, gemini, agy, remote, …). */
-    readonly host?: string;
-    /** Display name, if set on the session. */
-    readonly name?: string;
-    /**
-     * Roles from the registry registration. Empty array if the instance has no
-     * registration (unregistered presence).
-     */
-    readonly roles: string[];
-    /** ISO timestamp when the session was opened. */
-    readonly startedAt: string;
-    /** ISO timestamp of the last heartbeat. */
-    readonly heartbeatAt: string;
-}
-export interface ConductorResolution {
-    /** The workspace id that was resolved (canonical form). */
-    readonly workspaceId: string;
-    /**
-     * The live CONDUCTOR: resolved in precedence order (claim > role > null).
-     * null if no live in-workspace candidate holds either a claim or the role.
-     */
-    readonly conductor: string | null;
-    /**
-     * The instance that holds an active claim and is live in-workspace, or null
-     * if the conductor was resolved by role or is null. Exposes claim provenance.
-     */
-    readonly claimedBy: string | null;
-    /**
-     * All live sessions whose workspace.id matches (canonical-compared) the
-     * requested workspaceId. The conductor (if any) is also in this list.
-     */
-    readonly candidates: ConductorCandidate[];
-    /** true if at least one candidate is live (candidates.length > 0). */
-    readonly live: boolean;
-}
-export interface ConductorForOptions {
-    readonly root: string;
-    readonly workspaceId: string;
-    /** Optional: override the freshness expiry window in ms (default 90000). */
-    readonly expiryMs?: number;
-    /** Optional: reference instant for freshness (default Date.now()). */
-    readonly now?: number;
-}
-/**
- * Resolve the live conductor/owner of a workspace.
- *
- * Algorithm:
- * 1. List all fresh presence records (90s freshness by default).
- * 2. Retain sessions whose `workspace.id` matches the requested workspaceId
- *    (case-insensitive / slug-stable via canonicalAddress on both sides).
- * 3. For each candidate, look up the registry to read its roles.
- * 4. Read active conductor claims for the workspace.
- * 5. conductor =
- *    a. The EARLIEST active-claim instance (by claim `at`) that is also a
- *       live in-workspace candidate (claim-based election, WP-G1b); OR
- *    b. (back-compat) the FIRST (by startedAt) live candidate whose roles
- *       include "CONDUCTOR" (role-based, WP-G1a); OR
- *    c. null.
- * 6. claimedBy = the instance resolved via path (a), or null.
- * 7. live = candidates.length > 0.
- */
-export declare function conductorFor(opts: ConductorForOptions): ConductorResolution;
-//# sourceMappingURL=conductor.d.ts.map

package/dist/runtime/governance/conductor.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"conductor.d.ts","sourceRoot":"","sources":["../../../src/runtime/governance/conductor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,mCAAmC;AACnC,MAAM,WAAW,kBAAkB;IACjC,gDAAgD;IAChD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,oDAAoD;IACpD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,2CAA2C;IAC3C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;IACzB,iDAAiD;IACjD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,2CAA2C;IAC3C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,mBAAmB;IAClC,2DAA2D;IAC3D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,kBAAkB,EAAE,CAAC;IAC1C,sEAAsE;IACtE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,4EAA4E;IAC5E,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,sEAAsE;IACtE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,mBAAmB,GAAG,mBAAmB,CA4E3E"}

package/dist/runtime/governance/conductor.js

@@ -1,106 +0,0 @@
-/**
- * Governance primitive: conductor/owner resolver for a workspace.
- *
- * WP-G1 — Read-only, pure over presence + registry + claims. No writes.
- *
- * The "CONDUCTOR of workspace W" is resolved in precedence order:
- * 1. The EARLIEST active-claim instance (from activeConductorClaims) that is
- *    also a live in-workspace candidate (WP-G1b — claim-based election).
- * 2. (back-compat) A live candidate whose registration roles include
- *    "CONDUCTOR" (WP-G1a — role-based).
- * 3. null (the common state: agents auto-register as AGENTS).
- */
-import { canonicalAddress, listPresence } from "../local-files/index.js";
-import { createLocalStore } from "../local-files/store.js";
-import { activeConductorClaims } from "./claims.js";
-/**
- * Resolve the live conductor/owner of a workspace.
- *
- * Algorithm:
- * 1. List all fresh presence records (90s freshness by default).
- * 2. Retain sessions whose `workspace.id` matches the requested workspaceId
- *    (case-insensitive / slug-stable via canonicalAddress on both sides).
- * 3. For each candidate, look up the registry to read its roles.
- * 4. Read active conductor claims for the workspace.
- * 5. conductor =
- *    a. The EARLIEST active-claim instance (by claim `at`) that is also a
- *       live in-workspace candidate (claim-based election, WP-G1b); OR
- *    b. (back-compat) the FIRST (by startedAt) live candidate whose roles
- *       include "CONDUCTOR" (role-based, WP-G1a); OR
- *    c. null.
- * 6. claimedBy = the instance resolved via path (a), or null.
- * 7. live = candidates.length > 0.
- */
-export function conductorFor(opts) {
-    const { root, expiryMs, now } = opts;
-    const targetId = canonicalAddress(opts.workspaceId);
-    // Read live sessions
-    const sessions = listPresence(root, {
-        ...(expiryMs !== undefined ? { expiryMs } : {}),
-        ...(now !== undefined ? { now } : {})
-    });
-    // Filter to sessions in the target workspace
-    const inWorkspace = sessions.filter((s) => {
-        if (!s.workspace?.id)
-            return false;
-        return canonicalAddress(s.workspace.id) === targetId;
-    });
-    // Read registry lazily (only if there are candidates; avoids I/O on empty)
-    // Build a map: canonical(instance) → roles[]
-    const rolesMap = new Map();
-    if (inWorkspace.length > 0) {
-        try {
-            const store = createLocalStore({ root, allowVersionMismatch: true });
-            for (const reg of store.listInstances()) {
-                rolesMap.set(canonicalAddress(reg.id), reg.roles ?? []);
-            }
-        }
-        catch {
-            // If the store is unreadable, proceed with empty roles
-        }
-    }
-    // Build candidates
-    const candidates = inWorkspace.map((s) => ({
-        instance: s.instance,
-        ...(s.host !== undefined ? { host: s.host } : {}),
-        ...(s.name !== undefined ? { name: s.name } : {}),
-        roles: rolesMap.get(canonicalAddress(s.instance)) ?? [],
-        startedAt: s.startedAt,
-        heartbeatAt: s.heartbeatAt
-    }));
-    // Build a set of live in-workspace instance canonical ids for quick lookup.
-    const liveSet = new Set(candidates.map((c) => canonicalAddress(c.instance)));
-    // 5a. Claim-based election: earliest active claim from a live candidate.
-    let conductor = null;
-    let claimedBy = null;
-    try {
-        const claims = activeConductorClaims(root, targetId);
-        for (const claim of claims) {
-            if (liveSet.has(canonicalAddress(claim.instance))) {
-                conductor = claim.instance;
-                claimedBy = claim.instance;
-                break;
-            }
-        }
-    }
-    catch {
-        // If claims are unreadable, fall through to role-based resolution
-    }
-    // 5b. Role-based election (back-compat): earliest-startedAt with role CONDUCTOR.
-    if (conductor === null) {
-        const conductorCandidates = candidates
-            .filter((c) => c.roles.includes("CONDUCTOR"))
-            .sort((a, b) => a.startedAt.localeCompare(b.startedAt));
-        if (conductorCandidates.length > 0) {
-            conductor = conductorCandidates[0].instance;
-        }
-    }
-    return {
-        workspaceId: targetId,
-        conductor,
-        claimedBy,
-        candidates,
-        live: candidates.length > 0
-    };
-}
-//# sourceMappingURL=conductor.js.map

package/dist/runtime/governance/conductor.js.map

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

package/dist/runtime/governance/index.d.ts

@@ -1,5 +0,0 @@
-export { conductorFor, type ConductorCandidate, type ConductorForOptions, type ConductorResolution } from "./conductor.js";
-export { appendConductorClaim, listConductorClaims, activeConductorClaims, type ConductorClaimEvent } from "./claims.js";
-export { recommendConductorLaunch, conductorLaunchCheck, type ConductorLaunchRecommendation, type ConductorLaunchCheckOpts, type ConductorLaunchCheckResult, type RecommendConductorLaunchOpts, type StalledItem } from "./launch-check.js";
-export { recordSpawnRequest, lastSpawnRequestAt, spawnAllowed, type SpawnRequestEvent, type SpawnAllowedOpts } from "./spawns.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/runtime/governance/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/governance/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACzB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACrB,KAAK,mBAAmB,EACzB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,KAAK,6BAA6B,EAClC,KAAK,wBAAwB,EAC7B,KAAK,0BAA0B,EAC/B,KAAK,4BAA4B,EACjC,KAAK,WAAW,EACjB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,YAAY,EACZ,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACtB,MAAM,aAAa,CAAC"}

package/dist/runtime/governance/index.js

@@ -1,5 +0,0 @@
-export { conductorFor } from "./conductor.js";
-export { appendConductorClaim, listConductorClaims, activeConductorClaims } from "./claims.js";
-export { recommendConductorLaunch, conductorLaunchCheck } from "./launch-check.js";
-export { recordSpawnRequest, lastSpawnRequestAt, spawnAllowed } from "./spawns.js";
-//# sourceMappingURL=index.js.map

package/dist/runtime/governance/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/runtime/governance/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EAIb,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EAEtB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EAMrB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,YAAY,EAGb,MAAM,aAAa,CAAC"}

package/dist/runtime/governance/launch-check.d.ts

@@ -1,93 +0,0 @@
-/**
- * Governance D3 — Conductor Launch Check (DRY-RUN, read-only).
- *
- * h2a polls `track workspace-activity` and RECOMMENDS launching a conductor
- * where work is durably stalled and no conductor is live.
- *
- * The module has two layers:
- *
- * 1. `recommendConductorLaunch` — pure function, no I/O.  Derives the
- *    recommendation from two booleans: whether a conductor is already live and
- *    how many stalled items were found.
- *
- * 2. `conductorLaunchCheck` — the I/O gatherer.  Calls `track
- *    workspace-activity`, calls `conductorFor`, computes the recommendation,
- *    and returns a single result object.  Never writes, never spawns.
- *
- * IMPORTANT — DRY-RUN policy
- * --------------------------
- * h2a does NOT spawn anything.  A `recommendation === "launch"` output is
- * purely advisory.  The actual conductor launch is **parked** pending a
- * spawn-policy decision and remote-trigger support.
- */
-export interface RecommendConductorLaunchOpts {
-    /** true when conductorFor returned a non-null conductor that is live. */
-    readonly conductorLive: boolean;
-    /** Number of stalled items returned by track workspace-activity. */
-    readonly stalledCount: number;
-}
-export interface ConductorLaunchRecommendation {
-    /** "launch" = h2a recommends someone starts a conductor; "none" = no action needed. */
-    readonly recommendation: "launch" | "none";
-    /** Human-readable reason behind the recommendation. */
-    readonly reason: string;
-    /** Preferred host order for the launch (only present when recommendation === "launch"). */
-    readonly suggestedHosts?: string[];
-}
-/**
- * Pure function: derive a conductor-launch recommendation from pre-gathered
- * facts.  No I/O.
- *
- * Rules (in precedence order):
- * 1. conductorLive === true → none (a live conductor already owns the workspace).
- * 2. conductorLive === false AND stalledCount > 0 → launch.
- * 3. else → none (no stalled work detected).
- */
-export declare function recommendConductorLaunch(opts: RecommendConductorLaunchOpts): ConductorLaunchRecommendation;
-export interface StalledItem {
-    readonly id?: string;
-    readonly title?: string;
-    readonly reason?: string;
-    readonly since?: string;
-}
-export interface ConductorLaunchCheckOpts {
-    /** h2a store root (the `.h2a` directory). */
-    readonly root: string;
-    /** Workspace id in `ws:<uuid>` form. */
-    readonly workspaceId: string;
-    /** Idle threshold passed to `track workspace-activity --idle-ms`. Default 86400000 (24h). */
-    readonly idleMs?: number;
-    /** Override `Date.now()` for test determinism. */
-    readonly now?: () => number;
-    /**
-     * Injectable replacement for the real `track workspace-activity` call.
-     * When absent, the default implementation runs the `track` binary.
-     * Return `undefined` to signal that track is unavailable / errored.
-     */
-    readonly runTrackActivity?: (workspaceId: string, idleMs: number) => {
-        pending: number;
-        stalled: StalledItem[];
-        latestEventAt?: string;
-    } | undefined;
-}
-export interface ConductorLaunchCheckResult {
-    readonly workspaceId: string;
-    /** false when track is absent or errored (graceful degradation). */
-    readonly trackAvailable: boolean;
-    /** The live conductor instance id, or null. */
-    readonly conductor: string | null;
-    readonly conductorLive: boolean;
-    readonly pending: number;
-    readonly stalled: StalledItem[];
-    readonly latestEventAt?: string;
-    readonly recommendation: "launch" | "none";
-    readonly reason: string;
-    readonly suggestedHosts?: string[];
-}
-/**
- * Gather all facts and derive a conductor-launch recommendation.
- *
- * Read-only: no writes, no spawns.
- */
-export declare function conductorLaunchCheck(opts: ConductorLaunchCheckOpts): ConductorLaunchCheckResult;
-//# sourceMappingURL=launch-check.d.ts.map

package/dist/runtime/governance/launch-check.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"launch-check.d.ts","sourceRoot":"","sources":["../../../src/runtime/governance/launch-check.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AASH,MAAM,WAAW,4BAA4B;IAC3C,yEAAyE;IACzE,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,oEAAoE;IACpE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,6BAA6B;IAC5C,uFAAuF;IACvF,QAAQ,CAAC,cAAc,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC3C,uDAAuD;IACvD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,2FAA2F;IAC3F,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CACpC;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,4BAA4B,GACjC,6BAA6B,CAsB/B;AAMD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAMD,MAAM,WAAW,wBAAwB;IACvC,6CAA6C;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,6FAA6F;IAC7F,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,kDAAkD;IAClD,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAC1B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,KACX;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,WAAW,EAAE,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;CACtF;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,oEAAoE;IACpE,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,+CAA+C;IAC/C,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,WAAW,EAAE,CAAC;IAChC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC3C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CACpC;AA+BD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,wBAAwB,GAAG,0BAA0B,CAyC/F"}