lorenz 0.1.0

package/packages/dispatch/dist/index.js

@@ -0,0 +1,117 @@
+import { ensembleSize, isTerminalState } from "@lorenz/issue";
+import { normalizeRouteName, normalizeStateName, settingsForIssueState } from "@lorenz/config";
+export function routeNames(issue, settings) {
+    const prefix = settings.tracker.dispatch.routeLabelPrefix.trim().toLowerCase();
+    return issue.labels
+        .filter((label) => label.toLowerCase().startsWith(prefix))
+        .map((label) => normalizeRouteName(label.slice(prefix.length)))
+        .filter((route) => route !== "");
+}
+export function hasRouteLabel(issue, settings) {
+    const prefix = settings.tracker.dispatch.routeLabelPrefix.trim().toLowerCase();
+    return issue.labels.some((label) => label.toLowerCase().startsWith(prefix));
+}
+export function issueIsActive(issue, settings) {
+    return (stateIn(issue.state, settings.tracker.activeStates) &&
+        !stateIn(issue.state, settings.tracker.terminalStates));
+}
+export function issueHasOpenBlockers(issue, settings) {
+    if (issue.stateType !== "unstarted")
+        return false;
+    return issue.blockers.some((blocker) => !isTerminalState(blocker.state, settings.tracker.terminalStates));
+}
+export function routedToThisWorker(issue, settings) {
+    if (issue.assignedToWorker === false)
+        return false;
+    const routes = routeNames(issue, settings);
+    const dispatch = settings.tracker.dispatch;
+    if (routes.length === 0)
+        return hasRouteLabel(issue, settings) ? false : dispatch.acceptUnrouted;
+    if (dispatch.onlyRoutes === null)
+        return true;
+    if (dispatch.onlyRoutes.length === 0)
+        return false;
+    const allowed = new Set(dispatch.onlyRoutes.map(normalizeRouteName));
+    return routes.some((route) => allowed.has(route));
+}
+export function dispatchBlockReason(issue, settings, state) {
+    if (!issue.id || !issue.identifier || !issue.title || !issue.state)
+        return null;
+    if (!issueIsActive(issue, settings))
+        return null;
+    if (!routedToThisWorker(issue, settings))
+        return null;
+    if (issueHasOpenBlockers(issue, settings))
+        return null;
+    if (state.runningCount >= settings.agent.maxConcurrentAgents)
+        return "global_concurrency_cap";
+    const effective = settingsForIssueState(settings, issue.state);
+    const stateCount = state.runningByState?.get(normalizeStateName(issue.state)) ?? 0;
+    if (stateCount >= effective.agent.maxConcurrentAgents)
+        return "local_concurrency_cap";
+    if (state.workerCapacityAvailable === false)
+        return "worker_host_capacity";
+    return null;
+}
+export function shouldDispatchIssue(issue, settings, state) {
+    if (!issue.id || !issue.identifier || !issue.title || !issue.state)
+        return false;
+    if (!issueIsActive(issue, settings))
+        return false;
+    if (!routedToThisWorker(issue, settings))
+        return false;
+    if (issueHasOpenBlockers(issue, settings))
+        return false;
+    if (dispatchBlockReason(issue, settings, state))
+        return false;
+    const size = ensembleSize(issue) ?? settings.agent.ensembleSize;
+    const claimed = state.claimedSlots ?? new Set();
+    for (let slot = 0; slot < size; slot += 1) {
+        if (!claimed.has(slotKey(issue.id, slot)))
+            return true;
+    }
+    return false;
+}
+export function firstUnclaimedSlot(issue, settings, claimedSlots, preferredSlotIndex) {
+    const size = ensembleSize(issue) ?? settings.agent.ensembleSize;
+    if (preferredSlotIndex !== undefined &&
+        preferredSlotIndex !== null &&
+        Number.isInteger(preferredSlotIndex) &&
+        preferredSlotIndex >= 0 &&
+        preferredSlotIndex < size &&
+        !claimedSlots.has(slotKey(issue.id, preferredSlotIndex))) {
+        return preferredSlotIndex;
+    }
+    for (let slot = 0; slot < size; slot += 1) {
+        if (!claimedSlots.has(slotKey(issue.id, slot)))
+            return slot;
+    }
+    return null;
+}
+export function slotKey(issueId, slotIndex) {
+    return `${issueId}:${slotIndex}`;
+}
+export function sortForDispatch(issues) {
+    return [...issues].sort((left, right) => {
+        const priority = prioritySort(left.priority) - prioritySort(right.priority);
+        if (priority !== 0)
+            return priority;
+        const created = createdAtSort(left.createdAt) - createdAtSort(right.createdAt);
+        if (created !== 0)
+            return created;
+        return left.identifier.localeCompare(right.identifier);
+    });
+}
+function createdAtSort(value) {
+    if (value === null || value === undefined || value === "")
+        return Number.MAX_SAFE_INTEGER;
+    const parsed = Date.parse(value);
+    return Number.isNaN(parsed) ? Number.MAX_SAFE_INTEGER : parsed;
+}
+function stateIn(state, states) {
+    return states.some((candidate) => candidate.trim().toLowerCase() === state.trim().toLowerCase());
+}
+function prioritySort(priority) {
+    return priority ?? Number.MAX_SAFE_INTEGER;
+}
+//# sourceMappingURL=index.js.map

package/packages/dispatch/dist/index.js.map

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

package/packages/dispatch/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "@lorenz/dispatch",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "dependencies": {
+    "@lorenz/config": "file:../config",
+    "@lorenz/domain": "file:../domain",
+    "@lorenz/issue": "file:../issue"
+  }
+}

package/packages/dispatch-coordinator/dist/coordinator.d.ts

@@ -0,0 +1,158 @@
+import type { WorkerPoolSettings } from "@lorenz/domain";
+import type { WorkerPool, WorkerPoolSnapshot } from "@lorenz/worker-pool";
+import type { AcquireRunSlotRequest, McpEndpointManager, RunSlot } from "./types.js";
+/**
+ * The typed `no_capacity` reasons the coordinator surfaces. In STEP 1 these are
+ * exactly the pool's reasons (passed through verbatim); the `tunnel_exhausted`
+ * reason is reserved for the STEP 3 per-run tunnel ceiling and never produced by
+ * this passthrough. The runtime maps EVERY one of these onto the single
+ * `worker_host_capacity` dispatch_skipped event (no per-reason differentiation),
+ * matching today's behaviour.
+ */
+export type NoCapacityReason = "acquire_timeout" | "spend_cap" | "pool_disabled" | "driver_error" | "tunnel_exhausted";
+/** Discriminated result of {@link DispatchCoordinator.acquireRunSlot}. */
+export type AcquireRunSlotResult = {
+    status: "bound";
+    slot: RunSlot;
+} | {
+    status: "no_capacity";
+    reason: NoCapacityReason;
+};
+/**
+ * Thrown by {@link DispatchCoordinator.acquireRunSlot} when the per-run MCP
+ * endpoint fails to OPEN after the WorkerLease was already bound. The just-bound
+ * lease has been settled HEALTHY before this is thrown (the worker itself is fine -
+ * only the endpoint failed - so it must NOT be poisoned), and NO half-open ssh
+ * child / RunSlot is left behind. The runtime catches this exactly like any other
+ * thrown acquire fault and emits `worker_pool_acquire_error` (never a partial run).
+ * `cause` carries the underlying manager error; `workerHost`/`runKey` identify the
+ * run the endpoint was being opened for.
+ */
+export declare class EndpointOpenError extends Error {
+    readonly cause: unknown;
+    readonly workerHost: string;
+    readonly runKey: string;
+    constructor(args: {
+        cause: unknown;
+        workerHost: string;
+        runKey: string;
+    });
+}
+/**
+ * Thrown by {@link DispatchCoordinator.acquireRunSlot} when a freshly-bound lease
+ * would place a SECOND live RunSlot with the SAME `(issueId, slotIndex)` on the
+ * SAME machine. `(issueId, slotIndex)` is the key that feeds both the per-run
+ * `runKey` (`${slotIndex}`) AND the workspace slot suffix, so two co-resident slots
+ * sharing it would collide on BOTH the per-run endpoint/tunnel key and the
+ * workspace dir. Rather than silently disambiguate (openQuestion #1), the
+ * coordinator ASSERTS-AND-REJECTS: the just-bound lease is settled HEALTHY (the worker
+ * itself is fine) and NO slot is registered, so this invariant violation surfaces
+ * loudly. The runtime maps the throw to `worker_pool_acquire_error` exactly like any
+ * other acquire fault, leaving the first slot untouched.
+ */
+export declare class RunSlotCollisionError extends Error {
+    readonly issueId: string;
+    readonly slotIndex: number;
+    readonly machineLeaseId: string;
+    constructor(args: {
+        issueId: string;
+        slotIndex: number;
+        machineLeaseId: string;
+    });
+}
+/**
+ * One entry in the coordinator snapshot's `slots` view. STEP 1 always reports an
+ * empty list (no live per-run accounting yet); the shape is fixed now so the
+ * runtime/observability surface is stable across the later steps that populate it.
+ */
+export interface RunSlotSnapshotEntry {
+    slotId: string;
+    machineLeaseId: string;
+    issueId: string;
+    slotIndex: number;
+    workerHost: string;
+    remotePort: number | null;
+}
+/** The coordinator snapshot: the pool snapshot extended with a `slots` view. */
+export type DispatchCoordinatorSnapshot = WorkerPoolSnapshot & {
+    slots: ReadonlyArray<RunSlotSnapshotEntry>;
+};
+/**
+ * The lifetime-installed capacity gate the orchestrator delegates worker-host
+ * decisions to. Identical shape to the orchestrator's `CapacityProbe`; the
+ * coordinator itself satisfies it (a reload-surviving singleton, so the
+ * orchestrator's captured reference is stable across reconcile).
+ */
+export interface CapacityProbe {
+    /** Whether the live pool currently governs worker-host capacity (`pool.isEnabled()`). */
+    governs(): boolean;
+    /** Whether a run slot could be acquired right now (`pool.canAcquire()`). */
+    canAcquire(): boolean;
+}
+/**
+ * The runtime-facing coordinator over the machine {@link WorkerPool}. It is also
+ * the orchestrator's capacity authority ({@link CapacityProbe}): `governs()` /
+ * `canAcquire()` re-read live pool state on each call.
+ */
+export interface DispatchCoordinator extends CapacityProbe {
+    acquireRunSlot(req: AcquireRunSlotRequest): Promise<AcquireRunSlotResult>;
+    /**
+     * Registers a callback fired when the pool frees (or grows) leasable capacity,
+     * forwarded to {@link WorkerPool.onCapacityAvailable} when the pool provides the
+     * hook (a no-op otherwise). The runtime uses it to nudge its poll so a
+     * capacity-skipped issue re-dispatches without waiting out the poll interval.
+     */
+    onCapacityAvailable(cb: () => void): void;
+    readonly capabilities: {
+        readonly perRunEndpoint: boolean;
+    };
+    /**
+     * Reconciles the live pool (and the coordinator-owned settings) onto `next`.
+     * Async ONLY for the injected `driverLoader` (out-of-tree driver modules are
+     * dynamic-imported BEFORE the pool reconcile); the pool reconcile itself
+     * stays synchronous and transactional. A rejection (module load failure or a
+     * pool rollback) leaves both the pool and the coordinator on last-good.
+     */
+    reconcile(next: WorkerPoolSettings): Promise<void>;
+    drain(opts: {
+        deadlineMs: number;
+        signal?: AbortSignal;
+    }): Promise<void>;
+    hydrate(): Promise<void>;
+    snapshot(): DispatchCoordinatorSnapshot;
+}
+/** Constructor dependencies for {@link createDispatchCoordinator}. */
+export interface CreateDispatchCoordinatorDeps {
+    pool: WorkerPool;
+    mcpEndpointManager: McpEndpointManager;
+    settings: WorkerPoolSettings;
+    /**
+     * Optional structured-event sink for BEST-EFFORT cleanup faults the settle path
+     * must never throw to the caller (e.g. an endpoint/tunnel close that rejects
+     * while the worker lease is still being settled). When absent the fault is swallowed
+     * (the lease still settles regardless); the production runtime injects the same
+     * `logEvent` it threads into the underlying WorkerPool. Mirrors the pool's
+     * `(event) => void` shape so observability is uniform across the two layers.
+     */
+    logEvent?: (event: Record<string, unknown>) => void;
+    /**
+     * Optional out-of-tree driver loader awaited by {@link DispatchCoordinator.reconcile}
+     * BEFORE `pool.reconcile` when the next settings are enabled. The daemon
+     * injects `ensureWorkerDriverLoaded` here so a reload that changes the configured
+     * worker-pool driver to a module specifier dynamic-imports and
+     * registers it first, keeping the pool's registry resolution synchronous. A
+     * rejection aborts the reconcile (the pool is never touched), so the
+     * runtime's transactional reload keeps last-good settings.
+     */
+    driverLoader?: (driver: string) => Promise<void>;
+}
+/**
+ * Constructs the STEP 1 passthrough {@link DispatchCoordinator}. `settings` is
+ * retained for the later reconcile/co-residence paths; in STEP 1 it is not read
+ * past construction (the pool owns the live settings). The injected
+ * `mcpEndpointManager` is the null passthrough in STEP 1, so every minted slot
+ * carries `mcpEndpoint = null` and the coordinator advertises
+ * `perRunEndpoint = false`.
+ */
+export declare function createDispatchCoordinator(deps: CreateDispatchCoordinatorDeps): DispatchCoordinator;
+//# sourceMappingURL=coordinator.d.ts.map

package/packages/dispatch-coordinator/dist/coordinator.d.ts.map

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