@askexenow/exe-os 0.9.365 → 0.9.368

package/dist/{capability-cards-57FURUMR.js → capability-cards-6KAC5D2Z.js}

@@ -1,11 +1,11 @@
 import {
   getIdentity,
   loadEmployeesSync
-} from "./chunk-BRLS5OLZ.js";
+} from "./chunk-OBESOWFJ.js";
 import "./chunk-TKDITWDN.js";
 import "./chunk-BBMTVAE3.js";
 import "./chunk-5YEUPUV4.js";
-import "./chunk-NO3M2AFM.js";
+import "./chunk-JDPV7W2L.js";
 import "./chunk-YYB5PMTK.js";
 import {
   getRoleCapabilities

package/dist/{capacity-monitor-QEL62JDO.js → capacity-monitor-J2Y4SFLA.js}

@@ -8,27 +8,28 @@ import {
   isAtCapacity,
   isWithinRelaunchCooldown,
   pollCapacityDead
-} from "./chunk-KRUYQFSH.js";
-import "./chunk-ANPE3TT3.js";
-import "./chunk-ORNCMRIX.js";
-import "./chunk-ESTR7QUP.js";
-import "./chunk-FXPAUDCZ.js";
-import "./chunk-QFIVK3G5.js";
+} from "./chunk-DYPKSVB7.js";
+import "./chunk-BTGR55GX.js";
+import "./chunk-Y4AYNLXU.js";
+import "./chunk-BTSWFMEH.js";
+import "./chunk-P3PAD6AA.js";
+import "./chunk-KGPWS4KE.js";
+import "./chunk-KYVIV54Y.js";
 import "./chunk-WT4RI36X.js";
-import "./chunk-C3UAQ3JG.js";
 import "./chunk-KI5PFRG6.js";
+import "./chunk-QAEWWYHL.js";
 import "./chunk-EIKATSE4.js";
 import "./chunk-E23LNUWJ.js";
-import "./chunk-QAEWWYHL.js";
-import "./chunk-EHHMNKOA.js";
+import "./chunk-CSBD7QLZ.js";
 import "./chunk-GBNB4EWD.js";
 import "./chunk-UXLO7VHX.js";
 import "./chunk-DSOQUQTV.js";
-import "./chunk-WR75WUEP.js";
+import "./chunk-BFL3UB77.js";
 import "./chunk-AJIXH5JF.js";
+import "./chunk-PVWM2WMM.js";
 import "./chunk-XTWHNLGD.js";
 import "./chunk-AM7S2TY6.js";
-import "./chunk-2FYIMTQE.js";
+import "./chunk-PGF5I7EV.js";
 import "./chunk-CVYC6DUW.js";
 import "./chunk-ZVTKWWLV.js";
 import "./chunk-CDUB5Q6J.js";
@@ -40,20 +41,20 @@ import "./chunk-W2IRQJ6R.js";
 import "./chunk-HYZV25LY.js";
 import "./chunk-GJV3WDWM.js";
 import "./chunk-MP2AFCGL.js";
-import "./chunk-BRLS5OLZ.js";
+import "./chunk-OBESOWFJ.js";
 import "./chunk-TKDITWDN.js";
 import "./chunk-BBMTVAE3.js";
 import "./chunk-5YEUPUV4.js";
-import "./chunk-NO3M2AFM.js";
+import "./chunk-JDPV7W2L.js";
 import "./chunk-YYB5PMTK.js";
 import "./chunk-NJFJWQNN.js";
 import "./chunk-V3W3SATA.js";
 import "./chunk-JY5GAZYC.js";
 import "./chunk-FXU7JOXK.js";
 import "./chunk-WNBZJSQT.js";
-import "./chunk-ZDUO6QBH.js";
+import "./chunk-6UZ3DEQI.js";
 import "./chunk-A7XLR3K7.js";
-import "./chunk-VS4LPG66.js";
+import "./chunk-MQ5RUHNZ.js";
 import "./chunk-QILQ5FCG.js";
 import "./chunk-ARX6TAGN.js";
 import "./chunk-QMSEL5YS.js";

package/dist/{catchup-brief-PMXTCASA.js → catchup-brief-F2HKF2CU.js}

@@ -1,37 +1,38 @@
 import {
   lightweightSearch
-} from "./chunk-EMZHB767.js";
+} from "./chunk-6EXOW5ZA.js";
 import "./chunk-VMHZSZQJ.js";
-import "./chunk-4QKKLK3C.js";
-import "./chunk-QYECRPGD.js";
+import "./chunk-ELY5WBZX.js";
+import "./chunk-FDA45THL.js";
 import "./chunk-CHCA3ZM2.js";
 import "./chunk-OTVEIJUQ.js";
-import "./chunk-7DMCAGSC.js";
+import "./chunk-5U4UJGTW.js";
 import "./chunk-5MOYSU5A.js";
 import "./chunk-4QCFFW2H.js";
 import "./chunk-76CJBM36.js";
 import {
   sessionScopeFilter,
   strictSessionScopeFilter
-} from "./chunk-ORNCMRIX.js";
-import "./chunk-ESTR7QUP.js";
-import "./chunk-FXPAUDCZ.js";
-import "./chunk-QFIVK3G5.js";
+} from "./chunk-Y4AYNLXU.js";
+import "./chunk-BTSWFMEH.js";
+import "./chunk-P3PAD6AA.js";
+import "./chunk-KGPWS4KE.js";
+import "./chunk-KYVIV54Y.js";
 import "./chunk-WT4RI36X.js";
-import "./chunk-C3UAQ3JG.js";
 import "./chunk-KI5PFRG6.js";
+import "./chunk-QAEWWYHL.js";
 import "./chunk-EIKATSE4.js";
 import "./chunk-E23LNUWJ.js";
-import "./chunk-QAEWWYHL.js";
-import "./chunk-EHHMNKOA.js";
+import "./chunk-CSBD7QLZ.js";
 import "./chunk-GBNB4EWD.js";
 import "./chunk-UXLO7VHX.js";
 import "./chunk-DSOQUQTV.js";
-import "./chunk-WR75WUEP.js";
+import "./chunk-BFL3UB77.js";
 import "./chunk-AJIXH5JF.js";
+import "./chunk-PVWM2WMM.js";
 import "./chunk-XTWHNLGD.js";
 import "./chunk-AM7S2TY6.js";
-import "./chunk-2FYIMTQE.js";
+import "./chunk-PGF5I7EV.js";
 import "./chunk-CVYC6DUW.js";
 import "./chunk-ZVTKWWLV.js";
 import "./chunk-CDUB5Q6J.js";
@@ -45,11 +46,11 @@ import "./chunk-GJV3WDWM.js";
 import "./chunk-MP2AFCGL.js";
 import {
   getClient
-} from "./chunk-BRLS5OLZ.js";
+} from "./chunk-OBESOWFJ.js";
 import "./chunk-TKDITWDN.js";
 import "./chunk-BBMTVAE3.js";
 import "./chunk-5YEUPUV4.js";
-import "./chunk-NO3M2AFM.js";
+import "./chunk-JDPV7W2L.js";
 import "./chunk-YYB5PMTK.js";
 import "./chunk-NJFJWQNN.js";
 import "./chunk-V3W3SATA.js";
@@ -57,9 +58,9 @@ import "./chunk-JY5GAZYC.js";
 import "./chunk-FXU7JOXK.js";
 import "./chunk-HPXFKUGU.js";
 import "./chunk-WNBZJSQT.js";
-import "./chunk-ZDUO6QBH.js";
+import "./chunk-6UZ3DEQI.js";
 import "./chunk-A7XLR3K7.js";
-import "./chunk-VS4LPG66.js";
+import "./chunk-MQ5RUHNZ.js";
 import "./chunk-QILQ5FCG.js";
 import "./chunk-ARX6TAGN.js";
 import "./chunk-QMSEL5YS.js";
@@ -171,7 +172,7 @@ ${msgLines}`);
   } catch {
   }
   try {
-    const { getPendingProspective, markSurfaced } = await import("./prospective-memory-QLHSAPSG.js");
+    const { getPendingProspective, markSurfaced } = await import("./prospective-memory-HI3WUY4U.js");
     const due = await getPendingProspective(agentId, { projectName, limit: 5 });
     if (due.length > 0) {
       const now = Date.now();

package/dist/{chunk-5CBGH6RA.js → chunk-2AS6FG6C.js}

@@ -4,10 +4,10 @@ import {
 import {
   reserveVersions,
   vectorToBlob
-} from "./chunk-4QKKLK3C.js";
+} from "./chunk-ELY5WBZX.js";
 import {
   getClient
-} from "./chunk-BRLS5OLZ.js";
+} from "./chunk-OBESOWFJ.js";
 
 // src/lib/documents.ts
 import crypto from "crypto";
@@ -270,7 +270,7 @@ async function ingestDocument(input) {
   await client.batch([documentStmt, ...chunkStmts], "write");
   const embedded = vectors.filter((v) => v !== null).length;
   const originalTexts = input.chunks.map((c) => c.text);
-  import("./doc-graph-extractor-P46R4QME.js").then(
+  import("./doc-graph-extractor-6C5JBKPP.js").then(
     ({ extractAndStoreDocumentGraph }) => extractAndStoreDocumentGraph(documentId, originalTexts)
   ).catch((err) => {
     process.stderr.write(

package/dist/{chunk-TO6TB75E.js → chunk-2UBMXN4D.js}

@@ -1,6 +1,6 @@
 import {
   withScopedReadWindow
-} from "./chunk-DWAQOEXL.js";
+} from "./chunk-GILYOIMP.js";
 import {
   requireOrgPartnerBinding,
   resolvePartnerIdentities
@@ -22,7 +22,7 @@ import {
   sealMailboxEnvelope,
   unrecordedText,
   verifyManifest
-} from "./chunk-DYWGIPVP.js";
+} from "./chunk-AAL6CDMQ.js";
 import {
   queueMailboxDeposit
 } from "./chunk-4LWBC7CM.js";

package/dist/{chunk-J6I7X272.js → chunk-2UGU3V63.js}

@@ -1,6 +1,6 @@
 import {
   getClient
-} from "./chunk-BRLS5OLZ.js";
+} from "./chunk-OBESOWFJ.js";
 
 // src/lib/token-budget.ts
 var WARN_THRESHOLD = 0.8;

package/dist/{chunk-45EQTS7B.js → chunk-34BMZTWV.js}

@@ -1,6 +1,6 @@
 import {
   listReminders
-} from "./chunk-RD4E5G3B.js";
+} from "./chunk-RDIZSXXD.js";
 
 // src/mcp/tools/list-reminders.ts
 import { z } from "zod";

package/dist/{chunk-JYFYIGYK.js → chunk-4DGIOK6T.js}

@@ -4,7 +4,7 @@ import {
 import {
   flushBatch,
   writeMemory
-} from "./chunk-4QKKLK3C.js";
+} from "./chunk-ELY5WBZX.js";
 import {
   redactSecrets
 } from "./chunk-4QCFFW2H.js";

package/dist/{chunk-T6S45OLV.js → chunk-4GVJIMMK.js}

@@ -8,7 +8,7 @@ import {
 import {
   loadLicense,
   readCachedLicenseToken
-} from "./chunk-ZDUO6QBH.js";
+} from "./chunk-6UZ3DEQI.js";
 import {
   EXE_AI_DIR,
   loadConfig
@@ -213,18 +213,24 @@ async function maybeCloseAdmin(id, adminEndpoint, version, config) {
     const res = await fetch(`${adminEndpoint}/${encodeURIComponent(id)}`, {
       method: "PATCH",
       headers: { authorization: `Bearer ${token}`, "content-type": "application/json" },
+      // The smoke report is NOT a defect, so there is no fix commit and no defect
+      // absence to evidence — it can never produce a verification artifact, and
+      // `closed` now requires one (bug e9ba4b47). Resolving it as `wontfix` is the
+      // honest terminal state for a synthetic record and is deliberately ungated:
+      // declining to fix something is a judgement, not a claim that a defect is gone.
+      // Forging an artifact to keep the word "closed" would defeat the gate this
+      // health check exists alongside.
       body: JSON.stringify({
-        status: "closed",
-        triage_notes: "Auto-closed synthetic support smoke test.",
-        fixed_version: version
+        status: "wontfix",
+        triage_notes: `Synthetic support smoke test from exe-os ${version} \u2014 not a defect, auto-resolved.`
       }),
       signal: AbortSignal.timeout(1e4)
     });
     return {
       check: "askexe_admin_autoclose",
       level: res.ok ? "pass" : "warn",
-      detail: res.ok ? "closed" : `${res.status} ${await res.text()}`,
-      next: res.ok ? void 0 : "Report was sent; AskExe can close the smoke report manually."
+      detail: res.ok ? "resolved wontfix" : `${res.status} ${await res.text()}`,
+      next: res.ok ? void 0 : "Report was sent; AskExe can resolve the smoke report manually."
     };
   } catch (err) {
     return {

package/dist/{chunk-IXEFO6HD.js → chunk-4L732DE5.js}

@@ -4,17 +4,17 @@ import {
   resolveExeSession,
   sendIntercom,
   strictSessionScopeFilter
-} from "./chunk-ORNCMRIX.js";
+} from "./chunk-Y4AYNLXU.js";
 import {
   parseMessage,
   serializeMessage
 } from "./chunk-QAEWWYHL.js";
 import {
   recordOrchestrationEventBestEffort
-} from "./chunk-WR75WUEP.js";
+} from "./chunk-BFL3UB77.js";
 import {
   getClient
-} from "./chunk-BRLS5OLZ.js";
+} from "./chunk-OBESOWFJ.js";
 
 // src/lib/messaging.ts
 import crypto from "crypto";

package/dist/{chunk-MXEIZUXG.js → chunk-4RRMZJLG.js}

@@ -1,6 +1,6 @@
 import {
   getClient
-} from "./chunk-BRLS5OLZ.js";
+} from "./chunk-OBESOWFJ.js";
 
 // src/lib/boot-generation.ts
 var SYNC_META_KEY = "daemon_boot_generation";

package/dist/{chunk-3JNVB5LG.js → chunk-5IVLOOJR.js}

@@ -1,7 +1,7 @@
 import {
   checkLicense,
   loadLicense
-} from "./chunk-ZDUO6QBH.js";
+} from "./chunk-6UZ3DEQI.js";
 
 // src/lib/license-gate.ts
 var _cachedLicense = null;

package/dist/chunk-5YKNEL3W.js

@@ -0,0 +1,356 @@
+import {
+  getAgentLivenessReport
+} from "./chunk-PHUHIVD5.js";
+import {
+  isValidSessionScope
+} from "./chunk-BTSWFMEH.js";
+import {
+  leaseExpiryIso,
+  leaseNowIso
+} from "./chunk-E23LNUWJ.js";
+import {
+  getClient
+} from "./chunk-OBESOWFJ.js";
+
+// src/lib/work-claims.ts
+var CLAIM_TTL_MINUTES = 90;
+var CLAIM_GRACE_MINUTES = 30;
+var MAX_CLAIM_AGE_HOURS = 24;
+var UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/;
+var SHORT_ID_RE = /^[0-9a-f]{8}$/;
+function normalizeWorkRef(raw) {
+  const v = raw.trim().toLowerCase();
+  if (UUID_RE.test(v)) return v.slice(0, 8);
+  if (SHORT_ID_RE.test(v)) return v;
+  return v.replace(/\s+/g, " ");
+}
+function normalizePathTarget(raw, repoRoot) {
+  let v = raw.trim().replace(/\\/g, "/");
+  if (repoRoot) {
+    const root = repoRoot.replace(/\\/g, "/").replace(/\/+$/, "");
+    if (v.startsWith(root + "/")) v = v.slice(root.length + 1);
+  }
+  v = v.replace(/^\.\//, "").replace(/^\/+/, (m) => repoRoot ? "" : m);
+  return v;
+}
+function normalizeTarget(target, opts = {}) {
+  if (target.kind === "path") {
+    const rel = normalizePathTarget(target.value, opts.repoRoot);
+    const project = (opts.project ?? "").trim();
+    const key = project ? `${project}/${rel}` : rel;
+    return { kind: "path", key, label: project ? `${project}/${rel}` : rel };
+  }
+  return { kind: "work_ref", key: normalizeWorkRef(target.value), label: target.value.trim() };
+}
+function extractWorkRefCandidates(text) {
+  if (!text) return [];
+  const out = /* @__PURE__ */ new Set();
+  for (const m of text.toLowerCase().matchAll(/\b[0-9a-f]{8}(?:-[0-9a-f]{4}){3}-[0-9a-f]{12}\b/g)) {
+    out.add(m[0].slice(0, 8));
+  }
+  for (const m of text.toLowerCase().matchAll(/\b[0-9a-f]{8}\b/g)) {
+    out.add(m[0]);
+  }
+  return [...out];
+}
+function rootScope(sessionName) {
+  const raw = (sessionName ?? "").trim();
+  if (!raw) return "";
+  const lastDash = raw.lastIndexOf("-");
+  return lastDash >= 0 ? raw.slice(lastDash + 1) : raw;
+}
+function liveSessionScopes() {
+  const live = /* @__PURE__ */ new Set();
+  try {
+    for (const r of getAgentLivenessReport()) {
+      if (r.status === "dead") continue;
+      const root = rootScope(r.sessionName);
+      if (root) live.add(root);
+    }
+  } catch {
+  }
+  return live;
+}
+var SELECT_COLS = "id, claim_group, target_kind, target_key, target_label, task_id, holder_session, holder_agent, note, claimed_at, lease_expires_at, updated_at";
+function toRow(r) {
+  return {
+    id: String(r.id),
+    claimGroup: String(r.claim_group),
+    targetKind: String(r.target_kind),
+    targetKey: String(r.target_key),
+    targetLabel: r.target_label == null ? String(r.target_key) : String(r.target_label),
+    taskId: r.task_id == null ? null : String(r.task_id),
+    holderSession: String(r.holder_session),
+    holderAgent: r.holder_agent == null ? null : String(r.holder_agent),
+    note: r.note == null ? null : String(r.note),
+    claimedAt: String(r.claimed_at),
+    leaseExpiresAt: String(r.lease_expires_at),
+    updatedAt: String(r.updated_at)
+  };
+}
+function isUniqueViolation(err) {
+  const msg = err instanceof Error ? err.message : String(err);
+  return /UNIQUE constraint failed|SQLITE_CONSTRAINT_UNIQUE|duplicate key value/i.test(msg);
+}
+async function listClaims() {
+  const client = await getClient();
+  const res = await client.execute({
+    sql: `SELECT ${SELECT_COLS} FROM work_claims ORDER BY claimed_at DESC`,
+    args: []
+  });
+  return res.rows.map(toRow);
+}
+async function findConflicts(targets, holderSession) {
+  if (targets.length === 0) return [];
+  const client = await getClient();
+  const placeholders = targets.map(() => "(target_kind = ? AND target_key = ?)").join(" OR ");
+  const args = [];
+  for (const t of targets) args.push(t.kind, t.key);
+  const res = await client.execute({
+    sql: `SELECT ${SELECT_COLS} FROM work_claims WHERE (${placeholders})`,
+    args
+  });
+  const nowMs = Date.now();
+  const live = liveSessionScopes();
+  return res.rows.map(toRow).filter((r) => r.holderSession !== holderSession).filter((r) => {
+    const expiresMs = new Date(r.leaseExpiresAt).getTime();
+    if (Number.isNaN(expiresMs)) return true;
+    if (expiresMs >= nowMs) return true;
+    const ageMs = nowMs - new Date(r.claimedAt).getTime();
+    return live.has(r.holderSession) && ageMs < MAX_CLAIM_AGE_HOURS * 36e5;
+  });
+}
+async function findConflictsInText(text, holderSession) {
+  const candidates = extractWorkRefCandidates(text);
+  if (candidates.length === 0) return [];
+  return findConflicts(
+    candidates.map((c) => ({ kind: "work_ref", key: c, label: c })),
+    holderSession
+  );
+}
+async function acquireClaim(input) {
+  const holderSession = (input.holderSession ?? "").trim();
+  if (!isValidSessionScope(holderSession)) {
+    throw new Error(
+      `work-claims: refusing to claim for an invalid session scope "${holderSession}". A claim must name the owning coordinator session (e.g. exe2), not an agent or free text.`
+    );
+  }
+  if (input.force && !(input.reason ?? "").trim()) {
+    throw new Error(
+      "work-claims: force override requires a reason. Overriding another session's claim is a deliberate act and is recorded with who and why."
+    );
+  }
+  const targets = input.targets.map((t) => normalizeTarget(t, { repoRoot: input.repoRoot, project: input.project })).filter((t) => t.key.length > 0);
+  if (targets.length === 0) {
+    throw new Error("work-claims: no valid targets to claim.");
+  }
+  const seen = /* @__PURE__ */ new Set();
+  const unique = targets.filter((t) => {
+    const k = `${t.kind}\0${t.key}`;
+    if (seen.has(k)) return false;
+    seen.add(k);
+    return true;
+  });
+  const client = await getClient();
+  const now = leaseNowIso();
+  const nowMs = Date.parse(now);
+  const expiry = leaseExpiryIso(now, input.ttlMinutes ?? CLAIM_TTL_MINUTES);
+  const graceExpiry = leaseExpiryIso(now, CLAIM_GRACE_MINUTES);
+  const minClaimedAt = new Date(nowMs - MAX_CLAIM_AGE_HOURS * 36e5).toISOString();
+  const live = [...liveSessionScopes()];
+  const stmts = [];
+  if (live.length > 0) {
+    stmts.push({
+      sql: `UPDATE work_claims SET lease_expires_at = ?, updated_at = ? WHERE lease_expires_at < ? AND claimed_at > ? AND holder_session IN (${live.map(() => "?").join(",")})`,
+      args: [graceExpiry, now, now, minClaimedAt, ...live]
+    });
+  }
+  stmts.push({
+    sql: `DELETE FROM work_claims WHERE lease_expires_at < ?`,
+    args: [now]
+  });
+  for (const t of unique) {
+    if (input.force) {
+      stmts.push({
+        sql: `DELETE FROM work_claims WHERE target_kind = ? AND target_key = ?`,
+        args: [t.kind, t.key]
+      });
+    } else {
+      stmts.push({
+        sql: `DELETE FROM work_claims WHERE target_kind = ? AND target_key = ? AND holder_session = ?`,
+        args: [t.kind, t.key, holderSession]
+      });
+    }
+  }
+  const claimGroup = crypto.randomUUID();
+  for (const t of unique) {
+    stmts.push({
+      sql: `INSERT INTO work_claims (id, claim_group, target_kind, target_key, target_label, task_id, holder_session, holder_agent, note, claimed_at, lease_expires_at, updated_at) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+      args: [
+        crypto.randomUUID(),
+        claimGroup,
+        t.kind,
+        t.key,
+        t.label,
+        input.taskId ?? null,
+        holderSession,
+        input.holderAgent ?? null,
+        input.note ?? null,
+        now,
+        expiry,
+        now
+      ]
+    });
+  }
+  let displaced = [];
+  if (input.force) {
+    try {
+      displaced = await findConflicts(unique, holderSession);
+    } catch {
+    }
+  }
+  try {
+    await client.batch(stmts, "write");
+  } catch (err) {
+    if (!isUniqueViolation(err)) throw err;
+    if (live.length > 0) {
+      try {
+        await client.execute({
+          sql: `UPDATE work_claims SET lease_expires_at = ?, updated_at = ? WHERE lease_expires_at < ? AND claimed_at > ? AND holder_session IN (${live.map(() => "?").join(",")})`,
+          args: [graceExpiry, now, now, minClaimedAt, ...live]
+        });
+      } catch {
+      }
+    }
+    let conflicts = [];
+    try {
+      conflicts = await findConflicts(unique, holderSession);
+    } catch {
+    }
+    return { ok: false, claimGroup: null, claimed: [], conflicts };
+  }
+  await recordClaimEvent(
+    input.force ? "claim.override" : "claim.acquired",
+    holderSession,
+    input.holderAgent ?? null,
+    {
+      claimGroup,
+      targets: unique.map((t) => `${t.kind}:${t.key}`),
+      note: input.note ?? null,
+      reason: input.reason ?? null,
+      displaced: displaced.map((d) => ({
+        target: `${d.targetKind}:${d.targetKey}`,
+        holderSession: d.holderSession,
+        holderAgent: d.holderAgent,
+        claimedAt: d.claimedAt
+      }))
+    },
+    input.force ? "warn" : "info"
+  );
+  return { ok: true, claimGroup, claimed: unique, conflicts: [] };
+}
+async function releaseClaim(input) {
+  const holderSession = (input.holderSession ?? "").trim();
+  if (input.force && !(input.reason ?? "").trim()) {
+    throw new Error("work-claims: force release requires a reason.");
+  }
+  const client = await getClient();
+  let released = 0;
+  if (!input.claimGroup && !input.taskId && (input.targets ?? []).length === 0) {
+    return { released: 0 };
+  }
+  if (input.claimGroup) {
+    const sql = input.force ? `DELETE FROM work_claims WHERE claim_group = ?` : `DELETE FROM work_claims WHERE claim_group = ? AND holder_session = ?`;
+    const args = input.force ? [input.claimGroup] : [input.claimGroup, holderSession];
+    const res = await client.execute({ sql, args });
+    released += Number(res.rowsAffected ?? 0);
+  }
+  if (input.taskId) {
+    const sql = input.force ? `DELETE FROM work_claims WHERE task_id = ?` : `DELETE FROM work_claims WHERE task_id = ? AND holder_session = ?`;
+    const args = input.force ? [input.taskId] : [input.taskId, holderSession];
+    const res = await client.execute({ sql, args });
+    released += Number(res.rowsAffected ?? 0);
+  }
+  for (const raw of input.targets ?? []) {
+    const t = normalizeTarget(raw, { repoRoot: input.repoRoot, project: input.project });
+    if (!t.key) continue;
+    const sql = input.force ? `DELETE FROM work_claims WHERE target_kind = ? AND target_key = ?` : `DELETE FROM work_claims WHERE target_kind = ? AND target_key = ? AND holder_session = ?`;
+    const args = input.force ? [t.kind, t.key] : [t.kind, t.key, holderSession];
+    const res = await client.execute({ sql, args });
+    released += Number(res.rowsAffected ?? 0);
+  }
+  if (released > 0) {
+    await recordClaimEvent(
+      input.force ? "claim.force_released" : "claim.released",
+      holderSession,
+      null,
+      {
+        claimGroup: input.claimGroup ?? null,
+        taskId: input.taskId ?? null,
+        released,
+        reason: input.reason ?? null
+      },
+      input.force ? "warn" : "info"
+    );
+  }
+  return { released };
+}
+async function heartbeatClaims(holderSession, ttlMinutes = CLAIM_TTL_MINUTES) {
+  const client = await getClient();
+  const now = leaseNowIso();
+  const res = await client.execute({
+    sql: `UPDATE work_claims SET lease_expires_at = ?, updated_at = ? WHERE holder_session = ?`,
+    args: [leaseExpiryIso(now, ttlMinutes), now, holderSession]
+  });
+  return { renewed: Number(res.rowsAffected ?? 0) };
+}
+async function recordClaimEvent(eventType, sessionScope, agentId, payload, severity) {
+  try {
+    const { recordOrchestrationEventBestEffort } = await import("./orchestration-events-VBGCIQSS.js");
+    recordOrchestrationEventBestEffort({
+      eventType,
+      source: "work-claims",
+      severity,
+      sessionScope: sessionScope || null,
+      agentId: agentId ?? void 0,
+      payload
+    });
+  } catch {
+  }
+}
+async function resolveHolderSession() {
+  let raw = "";
+  try {
+    const { getAgentContext } = await import("./agent-context-AZTTMUHP.js");
+    raw = getAgentContext()?.sessionHint ?? "";
+  } catch {
+  }
+  if (!raw) raw = process.env.EXE_SESSION_NAME || process.env.EXE_SESSION || "";
+  const root = rootScope(raw);
+  return isValidSessionScope(root) ? root : "";
+}
+function describeConflict(row, nowMs = Date.now()) {
+  const ageMin = Math.max(0, Math.round((nowMs - new Date(row.claimedAt).getTime()) / 6e4));
+  const who = row.holderAgent ? `${row.holderSession} (${row.holderAgent})` : row.holderSession;
+  const note = row.note ? ` \u2014 "${row.note}"` : "";
+  return `${row.targetKind}:${row.targetLabel} held by ${who}, ${ageMin}m ago${note}`;
+}
+
+export {
+  CLAIM_TTL_MINUTES,
+  CLAIM_GRACE_MINUTES,
+  MAX_CLAIM_AGE_HOURS,
+  normalizeWorkRef,
+  normalizePathTarget,
+  normalizeTarget,
+  extractWorkRefCandidates,
+  liveSessionScopes,
+  listClaims,
+  findConflicts,
+  findConflictsInText,
+  acquireClaim,
+  releaseClaim,
+  heartbeatClaims,
+  resolveHolderSession,
+  describeConflict
+};