@bridge_gpt/mcp-server 0.2.49 → 0.2.51

package/build/conduct-epic/bridge-client.js

@@ -28,7 +28,7 @@
  * No MCP tool is registered from this module — the `tools/list` token budget is
  * effectively frozen.
  */
-import { buildConductorJiraUrl, fetchConductorJsonPostWithTimeout, fetchConductorJsonPutWithTimeout, fetchConductorJsonWithTimeout, fetchConductorReadiness, fetchEffectiveSupervisorConfig, fetchEffectiveSupervisorSetup, fetchEpicRunState, fetchParseStatus, fetchPrReviewStatus, pollCiChecksForCommit, ConductorBridgeApiError, CONDUCTOR_FETCH_TIMEOUT_MS, } from "../conductor/bridge-api-client.js";
+import { buildConductorJiraUrl, buildConductorVcsUrl, fetchConductorJsonPostWithTimeout, fetchConductorJsonPutWithTimeout, fetchConductorJsonWithTimeout, fetchConductorReadiness, fetchEffectiveSupervisorConfig, fetchEffectiveSupervisorSetup, fetchEpicRunState, fetchParseStatus, fetchPrReviewStatus, pollCiChecksForCommit, ConductorBridgeApiError, CONDUCTOR_FETCH_TIMEOUT_MS, } from "../conductor/bridge-api-client.js";
 /**
  * The one message returned for any failure whose cause cannot be described
  * without risking the credential. Stable so callers can match on it.
@@ -657,3 +657,117 @@ export async function reclaimIndexScope(access, request, fetchImpl = globalThis.
         },
     };
 }
+/**
+ * Epic-run statuses that mean a v2 conductor may still be driving the run.
+ *
+ * These are the NON-TERMINAL members of the server's `EpicRunStatus` vocabulary
+ * (`api/models/epic_run.py`: `planning | pending_approval | active | blocked |
+ * abandoned | done`); only `abandoned` and `done` are terminal. `active` is the
+ * state a run spends nearly all of its life in, so omitting it would make this
+ * whole advisory silent for exactly the overlap it exists to surface.
+ *
+ * The vocabulary matters and is easy to get wrong: `running`/`queued` belong to
+ * `ExecutorJobStatusValue` and `paused` to `RunControlState`, and none of the
+ * three is ever an `epic_runs.status`. Status alone is not liveness either — the
+ * caller additionally requires an unexpired lease, so a `blocked` run whose lease
+ * has lapsed is correctly read as wreckage rather than as a live conductor.
+ */
+const ACTIVE_EPIC_RUN_STATUSES = [
+    "planning",
+    "pending_approval",
+    "active",
+    "blocked",
+];
+/**
+ * `GET /automation/health?repo_name=` — read-only parse-dispatcher liveness.
+ *
+ * Root-mounted, NOT under `/jira`. The response is narrowed to two safe fields;
+ * signals, stale-ticket samples, queue contents, and every timestamp are
+ * deliberately dropped — an advisory line needs a verdict, not a report.
+ *
+ * `absent` is claimed ONLY on positive evidence: a `stale` or `never_seen`
+ * heartbeat together with a responding process that is not itself sweeping.
+ * Every other shape — `unknown`, a missing field, a malformed body, any read
+ * failure — is `unavailable`.
+ */
+export async function getParseDispatcherHealth(access, fetchImpl = globalThis.fetch) {
+    const result = await wrap(access, () => {
+        const url = new URL(buildConductorVcsUrl(access.baseUrl, "/automation/health"));
+        url.searchParams.set("repo_name", access.repoName);
+        return fetchConductorJsonWithTimeout(url.toString(), getHeaders(access), CONDUCTOR_FETCH_TIMEOUT_MS, fetchImpl);
+    });
+    if (!result.ok)
+        return result;
+    if (!isRecord(result.value)) {
+        return {
+            ok: true,
+            value: { observation: "unavailable", heartbeatState: null, respondingSchedulerRunning: false },
+        };
+    }
+    const reconciler = isRecord(result.value["reconciler"]) ? result.value["reconciler"] : null;
+    const scheduler = isRecord(result.value["scheduler"]) ? result.value["scheduler"] : null;
+    const rawState = reconciler === null ? undefined : reconciler["state"];
+    const heartbeatState = typeof rawState === "string" ? rawState : null;
+    const respondingSchedulerRunning = scheduler !== null &&
+        scheduler["running"] === true &&
+        typeof scheduler["job_count"] === "number" &&
+        scheduler["job_count"] > 0;
+    let observation;
+    if (heartbeatState === "fresh" || respondingSchedulerRunning) {
+        observation = "observed";
+    }
+    else if (heartbeatState === "stale" || heartbeatState === "never_seen") {
+        observation = "absent";
+    }
+    else {
+        observation = "unavailable";
+    }
+    return { ok: true, value: { observation, heartbeatState, respondingSchedulerRunning } };
+}
+/**
+ * `GET /jira/epic-runs/runs?repo_name=` — live v2 conductor runs on THIS repo.
+ *
+ * Scoped by the authenticated repository identity carried on `access`; no caller
+ * ever names a repository here. Liveness is judged on the LEASE, not on the
+ * status alone: an `active` row whose lease expired is a crashed run, and calling
+ * that a concurrent conductor would make the advisory cry wolf on exactly the
+ * wreckage `recover` exists to clean up.
+ *
+ * Only `epic_key` and a controlled state survive into the result. Lease owners,
+ * run ids, policies, and timestamps are dropped.
+ */
+export async function getLiveRepositoryConductors(access, now, fetchImpl = globalThis.fetch) {
+    const result = await wrap(access, () => {
+        const url = buildConductorJiraUrl(access.baseUrl, "/epic-runs/runs", {
+            repo_name: access.repoName,
+        });
+        return fetchConductorJsonWithTimeout(url, getHeaders(access), CONDUCTOR_FETCH_TIMEOUT_MS, fetchImpl);
+    });
+    if (!result.ok)
+        return result;
+    if (!isRecord(result.value) || !Array.isArray(result.value["runs"])) {
+        return { ok: true, value: { observation: "unavailable", conductors: [] } };
+    }
+    const nowMs = now.getTime();
+    const conductors = [];
+    for (const entry of result.value["runs"]) {
+        if (!isRecord(entry))
+            continue;
+        const status = entry["status"];
+        if (typeof status !== "string" || !ACTIVE_EPIC_RUN_STATUSES.includes(status))
+            continue;
+        const leaseRaw = nullableString(entry["lease_expires_at"]);
+        if (typeof leaseRaw !== "string")
+            continue;
+        const leaseMs = Date.parse(leaseRaw);
+        if (!Number.isFinite(leaseMs) || leaseMs <= nowMs)
+            continue;
+        conductors.push({
+            kind: "v2",
+            epicKey: nullableString(entry["epic_key"]) ?? null,
+            state: status,
+            livenessSource: "lease",
+        });
+    }
+    return { ok: true, value: { observation: conductors.length > 0 ? "observed" : "absent", conductors } };
+}