chainlesschain 0.81.0 → 0.143.0

package/src/lib/session-manager.js

@@ -262,3 +262,332 @@ export function exportSessionMarkdown(session) {
 
   return lines.join("\n");
 }
+
+/* ═══════════════════════════════════════════════════════════════
+ * V2 Surface — Session governance layer.
+ * Tracks conversation maturity + turn lifecycle independent of
+ * legacy llm_sessions SQLite store above.
+ * ═══════════════════════════════════════════════════════════════ */
+
+export const CONVERSATION_MATURITY_V2 = Object.freeze({
+  DRAFT: "draft",
+  ACTIVE: "active",
+  PAUSED: "paused",
+  ARCHIVED: "archived",
+});
+
+export const TURN_LIFECYCLE_V2 = Object.freeze({
+  PENDING: "pending",
+  STREAMING: "streaming",
+  COMPLETED: "completed",
+  FAILED: "failed",
+  CANCELLED: "cancelled",
+});
+
+const CONV_TRANSITIONS_V2 = new Map([
+  ["draft", new Set(["active", "archived"])],
+  ["active", new Set(["paused", "archived"])],
+  ["paused", new Set(["active", "archived"])],
+  ["archived", new Set()],
+]);
+const CONV_TERMINALS_V2 = new Set(["archived"]);
+
+const TURN_TRANSITIONS_V2 = new Map([
+  ["pending", new Set(["streaming", "cancelled"])],
+  ["streaming", new Set(["completed", "failed", "cancelled"])],
+  ["completed", new Set()],
+  ["failed", new Set()],
+  ["cancelled", new Set()],
+]);
+const TURN_TERMINALS_V2 = new Set(["completed", "failed", "cancelled"]);
+
+export const SESSION_DEFAULT_MAX_ACTIVE_CONV_PER_USER = 50;
+export const SESSION_DEFAULT_MAX_PENDING_TURNS_PER_CONV = 3;
+export const SESSION_DEFAULT_CONV_IDLE_MS = 1000 * 60 * 60 * 24 * 14; // 14 days
+export const SESSION_DEFAULT_TURN_STUCK_MS = 1000 * 60 * 5; // 5 min
+
+const _conversationsV2 = new Map();
+const _turnsV2 = new Map();
+let _maxActiveConvPerUserV2 = SESSION_DEFAULT_MAX_ACTIVE_CONV_PER_USER;
+let _maxPendingTurnsPerConvV2 = SESSION_DEFAULT_MAX_PENDING_TURNS_PER_CONV;
+let _convIdleMsV2 = SESSION_DEFAULT_CONV_IDLE_MS;
+let _turnStuckMsV2 = SESSION_DEFAULT_TURN_STUCK_MS;
+
+function _posIntSessionV2(n, label) {
+  const v = Math.floor(Number(n));
+  if (!Number.isFinite(v) || v <= 0)
+    throw new Error(`${label} must be a positive integer`);
+  return v;
+}
+
+export function getMaxActiveConvPerUserV2() {
+  return _maxActiveConvPerUserV2;
+}
+export function setMaxActiveConvPerUserV2(n) {
+  _maxActiveConvPerUserV2 = _posIntSessionV2(n, "maxActiveConvPerUser");
+}
+export function getMaxPendingTurnsPerConvV2() {
+  return _maxPendingTurnsPerConvV2;
+}
+export function setMaxPendingTurnsPerConvV2(n) {
+  _maxPendingTurnsPerConvV2 = _posIntSessionV2(n, "maxPendingTurnsPerConv");
+}
+export function getConvIdleMsV2() {
+  return _convIdleMsV2;
+}
+export function setConvIdleMsV2(n) {
+  _convIdleMsV2 = _posIntSessionV2(n, "convIdleMs");
+}
+export function getTurnStuckMsV2() {
+  return _turnStuckMsV2;
+}
+export function setTurnStuckMsV2(n) {
+  _turnStuckMsV2 = _posIntSessionV2(n, "turnStuckMs");
+}
+
+export function getActiveConvCountV2(userId) {
+  let n = 0;
+  for (const c of _conversationsV2.values()) {
+    if (c.userId === userId && c.status === "active") n += 1;
+  }
+  return n;
+}
+
+export function getPendingTurnCountV2(conversationId) {
+  let n = 0;
+  for (const t of _turnsV2.values()) {
+    if (
+      t.conversationId === conversationId &&
+      (t.status === "pending" || t.status === "streaming")
+    )
+      n += 1;
+  }
+  return n;
+}
+
+function _copyConvV2(c) {
+  return { ...c, metadata: { ...c.metadata } };
+}
+function _copyTurnV2(t) {
+  return { ...t, metadata: { ...t.metadata } };
+}
+
+export function registerConversationV2(
+  id,
+  { userId, model, metadata = {}, now = Date.now() } = {},
+) {
+  if (!id || typeof id !== "string") throw new Error("id must be a string");
+  if (!userId || typeof userId !== "string")
+    throw new Error("userId must be a string");
+  if (!model || typeof model !== "string")
+    throw new Error("model must be a string");
+  if (_conversationsV2.has(id))
+    throw new Error(`conversation ${id} already exists`);
+  const c = {
+    id,
+    userId,
+    model,
+    status: "draft",
+    createdAt: now,
+    lastSeenAt: now,
+    activatedAt: null,
+    archivedAt: null,
+    metadata: { ...metadata },
+  };
+  _conversationsV2.set(id, c);
+  return _copyConvV2(c);
+}
+
+export function getConversationV2(id) {
+  const c = _conversationsV2.get(id);
+  return c ? _copyConvV2(c) : null;
+}
+
+export function listConversationsV2({ userId, status } = {}) {
+  const out = [];
+  for (const c of _conversationsV2.values()) {
+    if (userId && c.userId !== userId) continue;
+    if (status && c.status !== status) continue;
+    out.push(_copyConvV2(c));
+  }
+  return out;
+}
+
+export function setConversationStatusV2(id, next, { now = Date.now() } = {}) {
+  const c = _conversationsV2.get(id);
+  if (!c) throw new Error(`conversation ${id} not found`);
+  if (!CONV_TRANSITIONS_V2.has(next))
+    throw new Error(`unknown conversation status: ${next}`);
+  if (CONV_TERMINALS_V2.has(c.status))
+    throw new Error(`conversation ${id} is in terminal state ${c.status}`);
+  const allowed = CONV_TRANSITIONS_V2.get(c.status);
+  if (!allowed.has(next))
+    throw new Error(
+      `cannot transition conversation from ${c.status} to ${next}`,
+    );
+  if (next === "active") {
+    if (c.status === "draft") {
+      const count = getActiveConvCountV2(c.userId);
+      if (count >= _maxActiveConvPerUserV2)
+        throw new Error(
+          `user ${c.userId} already at active-conversation cap (${_maxActiveConvPerUserV2})`,
+        );
+    }
+    if (!c.activatedAt) c.activatedAt = now;
+  }
+  if (next === "archived" && !c.archivedAt) c.archivedAt = now;
+  c.status = next;
+  c.lastSeenAt = now;
+  return _copyConvV2(c);
+}
+
+export function activateConversationV2(id, opts) {
+  return setConversationStatusV2(id, "active", opts);
+}
+export function pauseConversationV2(id, opts) {
+  return setConversationStatusV2(id, "paused", opts);
+}
+export function archiveConversationV2(id, opts) {
+  return setConversationStatusV2(id, "archived", opts);
+}
+
+export function touchConversationV2(id, { now = Date.now() } = {}) {
+  const c = _conversationsV2.get(id);
+  if (!c) throw new Error(`conversation ${id} not found`);
+  c.lastSeenAt = now;
+  return _copyConvV2(c);
+}
+
+export function createTurnV2(
+  id,
+  { conversationId, role = "user", metadata = {}, now = Date.now() } = {},
+) {
+  if (!id || typeof id !== "string") throw new Error("id must be a string");
+  if (!conversationId || typeof conversationId !== "string")
+    throw new Error("conversationId must be a string");
+  if (_turnsV2.has(id)) throw new Error(`turn ${id} already exists`);
+  const count = getPendingTurnCountV2(conversationId);
+  if (count >= _maxPendingTurnsPerConvV2)
+    throw new Error(
+      `conversation ${conversationId} already at pending-turn cap (${_maxPendingTurnsPerConvV2})`,
+    );
+  const t = {
+    id,
+    conversationId,
+    role,
+    status: "pending",
+    createdAt: now,
+    lastSeenAt: now,
+    streamingStartedAt: null,
+    settledAt: null,
+    metadata: { ...metadata },
+  };
+  _turnsV2.set(id, t);
+  return _copyTurnV2(t);
+}
+
+export function getTurnV2(id) {
+  const t = _turnsV2.get(id);
+  return t ? _copyTurnV2(t) : null;
+}
+
+export function listTurnsV2({ conversationId, status } = {}) {
+  const out = [];
+  for (const t of _turnsV2.values()) {
+    if (conversationId && t.conversationId !== conversationId) continue;
+    if (status && t.status !== status) continue;
+    out.push(_copyTurnV2(t));
+  }
+  return out;
+}
+
+export function setTurnStatusV2(id, next, { now = Date.now() } = {}) {
+  const t = _turnsV2.get(id);
+  if (!t) throw new Error(`turn ${id} not found`);
+  if (!TURN_TRANSITIONS_V2.has(next))
+    throw new Error(`unknown turn status: ${next}`);
+  if (TURN_TERMINALS_V2.has(t.status))
+    throw new Error(`turn ${id} is in terminal state ${t.status}`);
+  const allowed = TURN_TRANSITIONS_V2.get(t.status);
+  if (!allowed.has(next))
+    throw new Error(`cannot transition turn from ${t.status} to ${next}`);
+  if (next === "streaming" && !t.streamingStartedAt) t.streamingStartedAt = now;
+  if (TURN_TERMINALS_V2.has(next) && !t.settledAt) t.settledAt = now;
+  t.status = next;
+  t.lastSeenAt = now;
+  return _copyTurnV2(t);
+}
+
+export function streamTurnV2(id, opts) {
+  return setTurnStatusV2(id, "streaming", opts);
+}
+export function completeTurnV2(id, opts) {
+  return setTurnStatusV2(id, "completed", opts);
+}
+export function failTurnV2(id, opts) {
+  return setTurnStatusV2(id, "failed", opts);
+}
+export function cancelTurnV2(id, opts) {
+  return setTurnStatusV2(id, "cancelled", opts);
+}
+
+export function autoArchiveIdleConversationsV2({ now = Date.now() } = {}) {
+  const flipped = [];
+  for (const c of _conversationsV2.values()) {
+    if (c.status === "archived" || c.status === "draft") continue;
+    if (now - c.lastSeenAt > _convIdleMsV2) {
+      c.status = "archived";
+      c.lastSeenAt = now;
+      if (!c.archivedAt) c.archivedAt = now;
+      flipped.push(_copyConvV2(c));
+    }
+  }
+  return flipped;
+}
+
+export function autoFailStuckTurnsV2({ now = Date.now() } = {}) {
+  const flipped = [];
+  for (const t of _turnsV2.values()) {
+    if (t.status !== "streaming") continue;
+    const ref = t.streamingStartedAt ?? t.lastSeenAt;
+    if (now - ref > _turnStuckMsV2) {
+      t.status = "failed";
+      t.lastSeenAt = now;
+      if (!t.settledAt) t.settledAt = now;
+      flipped.push(_copyTurnV2(t));
+    }
+  }
+  return flipped;
+}
+
+export function getSessionManagerStatsV2() {
+  const conversationsByStatus = {};
+  for (const v of Object.values(CONVERSATION_MATURITY_V2))
+    conversationsByStatus[v] = 0;
+  for (const c of _conversationsV2.values())
+    conversationsByStatus[c.status] += 1;
+
+  const turnsByStatus = {};
+  for (const v of Object.values(TURN_LIFECYCLE_V2)) turnsByStatus[v] = 0;
+  for (const t of _turnsV2.values()) turnsByStatus[t.status] += 1;
+
+  return {
+    totalConversationsV2: _conversationsV2.size,
+    totalTurnsV2: _turnsV2.size,
+    maxActiveConvPerUser: _maxActiveConvPerUserV2,
+    maxPendingTurnsPerConv: _maxPendingTurnsPerConvV2,
+    convIdleMs: _convIdleMsV2,
+    turnStuckMs: _turnStuckMsV2,
+    conversationsByStatus,
+    turnsByStatus,
+  };
+}
+
+export function _resetStateSessionManagerV2() {
+  _conversationsV2.clear();
+  _turnsV2.clear();
+  _maxActiveConvPerUserV2 = SESSION_DEFAULT_MAX_ACTIVE_CONV_PER_USER;
+  _maxPendingTurnsPerConvV2 = SESSION_DEFAULT_MAX_PENDING_TURNS_PER_CONV;
+  _convIdleMsV2 = SESSION_DEFAULT_CONV_IDLE_MS;
+  _turnStuckMsV2 = SESSION_DEFAULT_TURN_STUCK_MS;
+}

package/src/lib/session-search.js

@@ -191,3 +191,84 @@ export class SessionSearchIndex {
     }
   }
 }
+
+// ===== V2 Surface: Session Search governance overlay (CLI v0.142.0) =====
+export const SSCH_PROFILE_MATURITY_V2 = Object.freeze({
+  PENDING: "pending", ACTIVE: "active", STALE: "stale", ARCHIVED: "archived",
+});
+export const SSCH_QUERY_LIFECYCLE_V2 = Object.freeze({
+  QUEUED: "queued", SEARCHING: "searching", COMPLETED: "completed", FAILED: "failed", CANCELLED: "cancelled",
+});
+const _sschPTrans = new Map([
+  [SSCH_PROFILE_MATURITY_V2.PENDING, new Set([SSCH_PROFILE_MATURITY_V2.ACTIVE, SSCH_PROFILE_MATURITY_V2.ARCHIVED])],
+  [SSCH_PROFILE_MATURITY_V2.ACTIVE, new Set([SSCH_PROFILE_MATURITY_V2.STALE, SSCH_PROFILE_MATURITY_V2.ARCHIVED])],
+  [SSCH_PROFILE_MATURITY_V2.STALE, new Set([SSCH_PROFILE_MATURITY_V2.ACTIVE, SSCH_PROFILE_MATURITY_V2.ARCHIVED])],
+  [SSCH_PROFILE_MATURITY_V2.ARCHIVED, new Set()],
+]);
+const _sschPTerminal = new Set([SSCH_PROFILE_MATURITY_V2.ARCHIVED]);
+const _sschQTrans = new Map([
+  [SSCH_QUERY_LIFECYCLE_V2.QUEUED, new Set([SSCH_QUERY_LIFECYCLE_V2.SEARCHING, SSCH_QUERY_LIFECYCLE_V2.CANCELLED])],
+  [SSCH_QUERY_LIFECYCLE_V2.SEARCHING, new Set([SSCH_QUERY_LIFECYCLE_V2.COMPLETED, SSCH_QUERY_LIFECYCLE_V2.FAILED, SSCH_QUERY_LIFECYCLE_V2.CANCELLED])],
+  [SSCH_QUERY_LIFECYCLE_V2.COMPLETED, new Set()],
+  [SSCH_QUERY_LIFECYCLE_V2.FAILED, new Set()],
+  [SSCH_QUERY_LIFECYCLE_V2.CANCELLED, new Set()],
+]);
+const _sschPsV2 = new Map();
+const _sschQsV2 = new Map();
+let _sschMaxActive = 8, _sschMaxPending = 20, _sschIdleMs = 30 * 24 * 60 * 60 * 1000, _sschStuckMs = 30 * 1000;
+function _sschPos(n, label) { const v = Math.floor(Number(n)); if (!Number.isFinite(v) || v <= 0) throw new Error(`${label} must be positive integer`); return v; }
+function _sschCheckP(from, to) { const a = _sschPTrans.get(from); if (!a || !a.has(to)) throw new Error(`invalid ssch profile transition ${from} → ${to}`); }
+function _sschCheckQ(from, to) { const a = _sschQTrans.get(from); if (!a || !a.has(to)) throw new Error(`invalid ssch query transition ${from} → ${to}`); }
+export function setMaxActiveSschProfilesPerOwnerV2(n) { _sschMaxActive = _sschPos(n, "maxActiveSschProfilesPerOwner"); }
+export function getMaxActiveSschProfilesPerOwnerV2() { return _sschMaxActive; }
+export function setMaxPendingSschQueriesPerProfileV2(n) { _sschMaxPending = _sschPos(n, "maxPendingSschQueriesPerProfile"); }
+export function getMaxPendingSschQueriesPerProfileV2() { return _sschMaxPending; }
+export function setSschProfileIdleMsV2(n) { _sschIdleMs = _sschPos(n, "sschProfileIdleMs"); }
+export function getSschProfileIdleMsV2() { return _sschIdleMs; }
+export function setSschQueryStuckMsV2(n) { _sschStuckMs = _sschPos(n, "sschQueryStuckMs"); }
+export function getSschQueryStuckMsV2() { return _sschStuckMs; }
+export function _resetStateSessionSearchV2() { _sschPsV2.clear(); _sschQsV2.clear(); _sschMaxActive = 8; _sschMaxPending = 20; _sschIdleMs = 30 * 24 * 60 * 60 * 1000; _sschStuckMs = 30 * 1000; }
+export function registerSschProfileV2({ id, owner, scope, metadata } = {}) {
+  if (!id) throw new Error("ssch profile id required"); if (!owner) throw new Error("ssch profile owner required");
+  if (_sschPsV2.has(id)) throw new Error(`ssch profile ${id} already registered`);
+  const now = Date.now();
+  const p = { id, owner, scope: scope || "all", status: SSCH_PROFILE_MATURITY_V2.PENDING, createdAt: now, updatedAt: now, activatedAt: null, archivedAt: null, lastTouchedAt: now, metadata: { ...(metadata || {}) } };
+  _sschPsV2.set(id, p); return { ...p, metadata: { ...p.metadata } };
+}
+function _sschCountActive(owner) { let n = 0; for (const p of _sschPsV2.values()) if (p.owner === owner && p.status === SSCH_PROFILE_MATURITY_V2.ACTIVE) n++; return n; }
+export function activateSschProfileV2(id) {
+  const p = _sschPsV2.get(id); if (!p) throw new Error(`ssch profile ${id} not found`);
+  _sschCheckP(p.status, SSCH_PROFILE_MATURITY_V2.ACTIVE);
+  const recovery = p.status === SSCH_PROFILE_MATURITY_V2.STALE;
+  if (!recovery && _sschCountActive(p.owner) >= _sschMaxActive) throw new Error(`max active ssch profiles for owner ${p.owner} reached`);
+  const now = Date.now(); p.status = SSCH_PROFILE_MATURITY_V2.ACTIVE; p.updatedAt = now; p.lastTouchedAt = now; if (!p.activatedAt) p.activatedAt = now;
+  return { ...p, metadata: { ...p.metadata } };
+}
+export function staleSschProfileV2(id) { const p = _sschPsV2.get(id); if (!p) throw new Error(`ssch profile ${id} not found`); _sschCheckP(p.status, SSCH_PROFILE_MATURITY_V2.STALE); p.status = SSCH_PROFILE_MATURITY_V2.STALE; p.updatedAt = Date.now(); return { ...p, metadata: { ...p.metadata } }; }
+export function archiveSschProfileV2(id) { const p = _sschPsV2.get(id); if (!p) throw new Error(`ssch profile ${id} not found`); _sschCheckP(p.status, SSCH_PROFILE_MATURITY_V2.ARCHIVED); const now = Date.now(); p.status = SSCH_PROFILE_MATURITY_V2.ARCHIVED; p.updatedAt = now; if (!p.archivedAt) p.archivedAt = now; return { ...p, metadata: { ...p.metadata } }; }
+export function touchSschProfileV2(id) { const p = _sschPsV2.get(id); if (!p) throw new Error(`ssch profile ${id} not found`); if (_sschPTerminal.has(p.status)) throw new Error(`cannot touch terminal ssch profile ${id}`); const now = Date.now(); p.lastTouchedAt = now; p.updatedAt = now; return { ...p, metadata: { ...p.metadata } }; }
+export function getSschProfileV2(id) { const p = _sschPsV2.get(id); if (!p) return null; return { ...p, metadata: { ...p.metadata } }; }
+export function listSschProfilesV2() { return [..._sschPsV2.values()].map((p) => ({ ...p, metadata: { ...p.metadata } })); }
+function _sschCountPending(profileId) { let n = 0; for (const q of _sschQsV2.values()) if (q.profileId === profileId && (q.status === SSCH_QUERY_LIFECYCLE_V2.QUEUED || q.status === SSCH_QUERY_LIFECYCLE_V2.SEARCHING)) n++; return n; }
+export function createSschQueryV2({ id, profileId, q, metadata } = {}) {
+  if (!id) throw new Error("ssch query id required"); if (!profileId) throw new Error("ssch query profileId required");
+  if (_sschQsV2.has(id)) throw new Error(`ssch query ${id} already exists`);
+  if (!_sschPsV2.has(profileId)) throw new Error(`ssch profile ${profileId} not found`);
+  if (_sschCountPending(profileId) >= _sschMaxPending) throw new Error(`max pending ssch queries for profile ${profileId} reached`);
+  const now = Date.now();
+  const r = { id, profileId, q: q || "", status: SSCH_QUERY_LIFECYCLE_V2.QUEUED, createdAt: now, updatedAt: now, startedAt: null, settledAt: null, metadata: { ...(metadata || {}) } };
+  _sschQsV2.set(id, r); return { ...r, metadata: { ...r.metadata } };
+}
+export function searchingSschQueryV2(id) { const r = _sschQsV2.get(id); if (!r) throw new Error(`ssch query ${id} not found`); _sschCheckQ(r.status, SSCH_QUERY_LIFECYCLE_V2.SEARCHING); const now = Date.now(); r.status = SSCH_QUERY_LIFECYCLE_V2.SEARCHING; r.updatedAt = now; if (!r.startedAt) r.startedAt = now; return { ...r, metadata: { ...r.metadata } }; }
+export function completeSschQueryV2(id) { const r = _sschQsV2.get(id); if (!r) throw new Error(`ssch query ${id} not found`); _sschCheckQ(r.status, SSCH_QUERY_LIFECYCLE_V2.COMPLETED); const now = Date.now(); r.status = SSCH_QUERY_LIFECYCLE_V2.COMPLETED; r.updatedAt = now; if (!r.settledAt) r.settledAt = now; return { ...r, metadata: { ...r.metadata } }; }
+export function failSschQueryV2(id, reason) { const r = _sschQsV2.get(id); if (!r) throw new Error(`ssch query ${id} not found`); _sschCheckQ(r.status, SSCH_QUERY_LIFECYCLE_V2.FAILED); const now = Date.now(); r.status = SSCH_QUERY_LIFECYCLE_V2.FAILED; r.updatedAt = now; if (!r.settledAt) r.settledAt = now; if (reason) r.metadata.failReason = String(reason); return { ...r, metadata: { ...r.metadata } }; }
+export function cancelSschQueryV2(id, reason) { const r = _sschQsV2.get(id); if (!r) throw new Error(`ssch query ${id} not found`); _sschCheckQ(r.status, SSCH_QUERY_LIFECYCLE_V2.CANCELLED); const now = Date.now(); r.status = SSCH_QUERY_LIFECYCLE_V2.CANCELLED; r.updatedAt = now; if (!r.settledAt) r.settledAt = now; if (reason) r.metadata.cancelReason = String(reason); return { ...r, metadata: { ...r.metadata } }; }
+export function getSschQueryV2(id) { const r = _sschQsV2.get(id); if (!r) return null; return { ...r, metadata: { ...r.metadata } }; }
+export function listSschQueriesV2() { return [..._sschQsV2.values()].map((r) => ({ ...r, metadata: { ...r.metadata } })); }
+export function autoStaleIdleSschProfilesV2({ now } = {}) { const t = now ?? Date.now(); const flipped = []; for (const p of _sschPsV2.values()) if (p.status === SSCH_PROFILE_MATURITY_V2.ACTIVE && (t - p.lastTouchedAt) >= _sschIdleMs) { p.status = SSCH_PROFILE_MATURITY_V2.STALE; p.updatedAt = t; flipped.push(p.id); } return { flipped, count: flipped.length }; }
+export function autoFailStuckSschQueriesV2({ now } = {}) { const t = now ?? Date.now(); const flipped = []; for (const r of _sschQsV2.values()) if (r.status === SSCH_QUERY_LIFECYCLE_V2.SEARCHING && r.startedAt != null && (t - r.startedAt) >= _sschStuckMs) { r.status = SSCH_QUERY_LIFECYCLE_V2.FAILED; r.updatedAt = t; if (!r.settledAt) r.settledAt = t; r.metadata.failReason = "auto-fail-stuck"; flipped.push(r.id); } return { flipped, count: flipped.length }; }
+export function getSessionSearchGovStatsV2() {
+  const profilesByStatus = {}; for (const v of Object.values(SSCH_PROFILE_MATURITY_V2)) profilesByStatus[v] = 0; for (const p of _sschPsV2.values()) profilesByStatus[p.status]++;
+  const queriesByStatus = {}; for (const v of Object.values(SSCH_QUERY_LIFECYCLE_V2)) queriesByStatus[v] = 0; for (const r of _sschQsV2.values()) queriesByStatus[r.status]++;
+  return { totalSschProfilesV2: _sschPsV2.size, totalSschQueriesV2: _sschQsV2.size, maxActiveSschProfilesPerOwner: _sschMaxActive, maxPendingSschQueriesPerProfile: _sschMaxPending, sschProfileIdleMs: _sschIdleMs, sschQueryStuckMs: _sschStuckMs, profilesByStatus, queriesByStatus };
+}

package/src/lib/session-tail.js

@@ -126,3 +126,84 @@ export async function* followSession(sessionId, options = {}) {
     await new Promise((r) => setTimeout(r, pollMs));
   }
 }
+
+// ===== V2 Surface: Session Tail governance overlay (CLI v0.142.0) =====
+export const STAIL_SUB_MATURITY_V2 = Object.freeze({
+  PENDING: "pending", ACTIVE: "active", PAUSED: "paused", CLOSED: "closed",
+});
+export const STAIL_EVENT_LIFECYCLE_V2 = Object.freeze({
+  QUEUED: "queued", TAILING: "tailing", COMPLETED: "completed", FAILED: "failed", CANCELLED: "cancelled",
+});
+const _stailSTrans = new Map([
+  [STAIL_SUB_MATURITY_V2.PENDING, new Set([STAIL_SUB_MATURITY_V2.ACTIVE, STAIL_SUB_MATURITY_V2.CLOSED])],
+  [STAIL_SUB_MATURITY_V2.ACTIVE, new Set([STAIL_SUB_MATURITY_V2.PAUSED, STAIL_SUB_MATURITY_V2.CLOSED])],
+  [STAIL_SUB_MATURITY_V2.PAUSED, new Set([STAIL_SUB_MATURITY_V2.ACTIVE, STAIL_SUB_MATURITY_V2.CLOSED])],
+  [STAIL_SUB_MATURITY_V2.CLOSED, new Set()],
+]);
+const _stailSTerminal = new Set([STAIL_SUB_MATURITY_V2.CLOSED]);
+const _stailETrans = new Map([
+  [STAIL_EVENT_LIFECYCLE_V2.QUEUED, new Set([STAIL_EVENT_LIFECYCLE_V2.TAILING, STAIL_EVENT_LIFECYCLE_V2.CANCELLED])],
+  [STAIL_EVENT_LIFECYCLE_V2.TAILING, new Set([STAIL_EVENT_LIFECYCLE_V2.COMPLETED, STAIL_EVENT_LIFECYCLE_V2.FAILED, STAIL_EVENT_LIFECYCLE_V2.CANCELLED])],
+  [STAIL_EVENT_LIFECYCLE_V2.COMPLETED, new Set()],
+  [STAIL_EVENT_LIFECYCLE_V2.FAILED, new Set()],
+  [STAIL_EVENT_LIFECYCLE_V2.CANCELLED, new Set()],
+]);
+const _stailSsV2 = new Map();
+const _stailEsV2 = new Map();
+let _stailMaxActive = 10, _stailMaxPending = 30, _stailIdleMs = 24 * 60 * 60 * 1000, _stailStuckMs = 60 * 1000;
+function _stailPos(n, label) { const v = Math.floor(Number(n)); if (!Number.isFinite(v) || v <= 0) throw new Error(`${label} must be positive integer`); return v; }
+function _stailCheckS(from, to) { const a = _stailSTrans.get(from); if (!a || !a.has(to)) throw new Error(`invalid stail subscription transition ${from} → ${to}`); }
+function _stailCheckE(from, to) { const a = _stailETrans.get(from); if (!a || !a.has(to)) throw new Error(`invalid stail event transition ${from} → ${to}`); }
+export function setMaxActiveStailSubsPerOwnerV2(n) { _stailMaxActive = _stailPos(n, "maxActiveStailSubsPerOwner"); }
+export function getMaxActiveStailSubsPerOwnerV2() { return _stailMaxActive; }
+export function setMaxPendingStailEventsPerSubV2(n) { _stailMaxPending = _stailPos(n, "maxPendingStailEventsPerSub"); }
+export function getMaxPendingStailEventsPerSubV2() { return _stailMaxPending; }
+export function setStailSubIdleMsV2(n) { _stailIdleMs = _stailPos(n, "stailSubIdleMs"); }
+export function getStailSubIdleMsV2() { return _stailIdleMs; }
+export function setStailEventStuckMsV2(n) { _stailStuckMs = _stailPos(n, "stailEventStuckMs"); }
+export function getStailEventStuckMsV2() { return _stailStuckMs; }
+export function _resetStateSessionTailV2() { _stailSsV2.clear(); _stailEsV2.clear(); _stailMaxActive = 10; _stailMaxPending = 30; _stailIdleMs = 24 * 60 * 60 * 1000; _stailStuckMs = 60 * 1000; }
+export function registerStailSubV2({ id, owner, sessionId, metadata } = {}) {
+  if (!id) throw new Error("stail sub id required"); if (!owner) throw new Error("stail sub owner required");
+  if (_stailSsV2.has(id)) throw new Error(`stail sub ${id} already registered`);
+  const now = Date.now();
+  const s = { id, owner, sessionId: sessionId || "*", status: STAIL_SUB_MATURITY_V2.PENDING, createdAt: now, updatedAt: now, activatedAt: null, closedAt: null, lastTouchedAt: now, metadata: { ...(metadata || {}) } };
+  _stailSsV2.set(id, s); return { ...s, metadata: { ...s.metadata } };
+}
+function _stailCountActive(owner) { let n = 0; for (const s of _stailSsV2.values()) if (s.owner === owner && s.status === STAIL_SUB_MATURITY_V2.ACTIVE) n++; return n; }
+export function activateStailSubV2(id) {
+  const s = _stailSsV2.get(id); if (!s) throw new Error(`stail sub ${id} not found`);
+  _stailCheckS(s.status, STAIL_SUB_MATURITY_V2.ACTIVE);
+  const recovery = s.status === STAIL_SUB_MATURITY_V2.PAUSED;
+  if (!recovery && _stailCountActive(s.owner) >= _stailMaxActive) throw new Error(`max active stail subs for owner ${s.owner} reached`);
+  const now = Date.now(); s.status = STAIL_SUB_MATURITY_V2.ACTIVE; s.updatedAt = now; s.lastTouchedAt = now; if (!s.activatedAt) s.activatedAt = now;
+  return { ...s, metadata: { ...s.metadata } };
+}
+export function pauseStailSubV2(id) { const s = _stailSsV2.get(id); if (!s) throw new Error(`stail sub ${id} not found`); _stailCheckS(s.status, STAIL_SUB_MATURITY_V2.PAUSED); s.status = STAIL_SUB_MATURITY_V2.PAUSED; s.updatedAt = Date.now(); return { ...s, metadata: { ...s.metadata } }; }
+export function closeStailSubV2(id) { const s = _stailSsV2.get(id); if (!s) throw new Error(`stail sub ${id} not found`); _stailCheckS(s.status, STAIL_SUB_MATURITY_V2.CLOSED); const now = Date.now(); s.status = STAIL_SUB_MATURITY_V2.CLOSED; s.updatedAt = now; if (!s.closedAt) s.closedAt = now; return { ...s, metadata: { ...s.metadata } }; }
+export function touchStailSubV2(id) { const s = _stailSsV2.get(id); if (!s) throw new Error(`stail sub ${id} not found`); if (_stailSTerminal.has(s.status)) throw new Error(`cannot touch terminal stail sub ${id}`); const now = Date.now(); s.lastTouchedAt = now; s.updatedAt = now; return { ...s, metadata: { ...s.metadata } }; }
+export function getStailSubV2(id) { const s = _stailSsV2.get(id); if (!s) return null; return { ...s, metadata: { ...s.metadata } }; }
+export function listStailSubsV2() { return [..._stailSsV2.values()].map((s) => ({ ...s, metadata: { ...s.metadata } })); }
+function _stailCountPending(subId) { let n = 0; for (const e of _stailEsV2.values()) if (e.subId === subId && (e.status === STAIL_EVENT_LIFECYCLE_V2.QUEUED || e.status === STAIL_EVENT_LIFECYCLE_V2.TAILING)) n++; return n; }
+export function createStailEventV2({ id, subId, cursor, metadata } = {}) {
+  if (!id) throw new Error("stail event id required"); if (!subId) throw new Error("stail event subId required");
+  if (_stailEsV2.has(id)) throw new Error(`stail event ${id} already exists`);
+  if (!_stailSsV2.has(subId)) throw new Error(`stail sub ${subId} not found`);
+  if (_stailCountPending(subId) >= _stailMaxPending) throw new Error(`max pending stail events for sub ${subId} reached`);
+  const now = Date.now();
+  const e = { id, subId, cursor: cursor || "0", status: STAIL_EVENT_LIFECYCLE_V2.QUEUED, createdAt: now, updatedAt: now, startedAt: null, settledAt: null, metadata: { ...(metadata || {}) } };
+  _stailEsV2.set(id, e); return { ...e, metadata: { ...e.metadata } };
+}
+export function tailingStailEventV2(id) { const e = _stailEsV2.get(id); if (!e) throw new Error(`stail event ${id} not found`); _stailCheckE(e.status, STAIL_EVENT_LIFECYCLE_V2.TAILING); const now = Date.now(); e.status = STAIL_EVENT_LIFECYCLE_V2.TAILING; e.updatedAt = now; if (!e.startedAt) e.startedAt = now; return { ...e, metadata: { ...e.metadata } }; }
+export function completeStailEventV2(id) { const e = _stailEsV2.get(id); if (!e) throw new Error(`stail event ${id} not found`); _stailCheckE(e.status, STAIL_EVENT_LIFECYCLE_V2.COMPLETED); const now = Date.now(); e.status = STAIL_EVENT_LIFECYCLE_V2.COMPLETED; e.updatedAt = now; if (!e.settledAt) e.settledAt = now; return { ...e, metadata: { ...e.metadata } }; }
+export function failStailEventV2(id, reason) { const e = _stailEsV2.get(id); if (!e) throw new Error(`stail event ${id} not found`); _stailCheckE(e.status, STAIL_EVENT_LIFECYCLE_V2.FAILED); const now = Date.now(); e.status = STAIL_EVENT_LIFECYCLE_V2.FAILED; e.updatedAt = now; if (!e.settledAt) e.settledAt = now; if (reason) e.metadata.failReason = String(reason); return { ...e, metadata: { ...e.metadata } }; }
+export function cancelStailEventV2(id, reason) { const e = _stailEsV2.get(id); if (!e) throw new Error(`stail event ${id} not found`); _stailCheckE(e.status, STAIL_EVENT_LIFECYCLE_V2.CANCELLED); const now = Date.now(); e.status = STAIL_EVENT_LIFECYCLE_V2.CANCELLED; e.updatedAt = now; if (!e.settledAt) e.settledAt = now; if (reason) e.metadata.cancelReason = String(reason); return { ...e, metadata: { ...e.metadata } }; }
+export function getStailEventV2(id) { const e = _stailEsV2.get(id); if (!e) return null; return { ...e, metadata: { ...e.metadata } }; }
+export function listStailEventsV2() { return [..._stailEsV2.values()].map((e) => ({ ...e, metadata: { ...e.metadata } })); }
+export function autoPauseIdleStailSubsV2({ now } = {}) { const t = now ?? Date.now(); const flipped = []; for (const s of _stailSsV2.values()) if (s.status === STAIL_SUB_MATURITY_V2.ACTIVE && (t - s.lastTouchedAt) >= _stailIdleMs) { s.status = STAIL_SUB_MATURITY_V2.PAUSED; s.updatedAt = t; flipped.push(s.id); } return { flipped, count: flipped.length }; }
+export function autoFailStuckStailEventsV2({ now } = {}) { const t = now ?? Date.now(); const flipped = []; for (const e of _stailEsV2.values()) if (e.status === STAIL_EVENT_LIFECYCLE_V2.TAILING && e.startedAt != null && (t - e.startedAt) >= _stailStuckMs) { e.status = STAIL_EVENT_LIFECYCLE_V2.FAILED; e.updatedAt = t; if (!e.settledAt) e.settledAt = t; e.metadata.failReason = "auto-fail-stuck"; flipped.push(e.id); } return { flipped, count: flipped.length }; }
+export function getSessionTailGovStatsV2() {
+  const subsByStatus = {}; for (const v of Object.values(STAIL_SUB_MATURITY_V2)) subsByStatus[v] = 0; for (const s of _stailSsV2.values()) subsByStatus[s.status]++;
+  const eventsByStatus = {}; for (const v of Object.values(STAIL_EVENT_LIFECYCLE_V2)) eventsByStatus[v] = 0; for (const e of _stailEsV2.values()) eventsByStatus[e.status]++;
+  return { totalStailSubsV2: _stailSsV2.size, totalStailEventsV2: _stailEsV2.size, maxActiveStailSubsPerOwner: _stailMaxActive, maxPendingStailEventsPerSub: _stailMaxPending, stailSubIdleMs: _stailIdleMs, stailEventStuckMs: _stailStuckMs, subsByStatus, eventsByStatus };
+}

package/src/lib/session-usage.js

@@ -164,3 +164,86 @@ export function allSessionsUsage({ limit = 1000 } = {}) {
     ),
   };
 }
+
+// ===== V2 Surface: Session Usage governance overlay (CLI v0.142.0) =====
+export const SUSE_BUDGET_MATURITY_V2 = Object.freeze({
+  PENDING: "pending", ACTIVE: "active", EXHAUSTED: "exhausted", ARCHIVED: "archived",
+});
+export const SUSE_RECORD_LIFECYCLE_V2 = Object.freeze({
+  QUEUED: "queued", RECORDING: "recording", RECORDED: "recorded", REJECTED: "rejected", CANCELLED: "cancelled",
+});
+const _suseBTrans = new Map([
+  [SUSE_BUDGET_MATURITY_V2.PENDING, new Set([SUSE_BUDGET_MATURITY_V2.ACTIVE, SUSE_BUDGET_MATURITY_V2.ARCHIVED])],
+  [SUSE_BUDGET_MATURITY_V2.ACTIVE, new Set([SUSE_BUDGET_MATURITY_V2.EXHAUSTED, SUSE_BUDGET_MATURITY_V2.ARCHIVED])],
+  [SUSE_BUDGET_MATURITY_V2.EXHAUSTED, new Set([SUSE_BUDGET_MATURITY_V2.ACTIVE, SUSE_BUDGET_MATURITY_V2.ARCHIVED])],
+  [SUSE_BUDGET_MATURITY_V2.ARCHIVED, new Set()],
+]);
+const _suseBTerminal = new Set([SUSE_BUDGET_MATURITY_V2.ARCHIVED]);
+const _suseRTrans = new Map([
+  [SUSE_RECORD_LIFECYCLE_V2.QUEUED, new Set([SUSE_RECORD_LIFECYCLE_V2.RECORDING, SUSE_RECORD_LIFECYCLE_V2.CANCELLED])],
+  [SUSE_RECORD_LIFECYCLE_V2.RECORDING, new Set([SUSE_RECORD_LIFECYCLE_V2.RECORDED, SUSE_RECORD_LIFECYCLE_V2.REJECTED, SUSE_RECORD_LIFECYCLE_V2.CANCELLED])],
+  [SUSE_RECORD_LIFECYCLE_V2.RECORDED, new Set()],
+  [SUSE_RECORD_LIFECYCLE_V2.REJECTED, new Set()],
+  [SUSE_RECORD_LIFECYCLE_V2.CANCELLED, new Set()],
+]);
+const _suseBsV2 = new Map();
+const _suseRsV2 = new Map();
+let _suseMaxActive = 5, _suseMaxPending = 50, _suseIdleMs = 30 * 24 * 60 * 60 * 1000, _suseStuckMs = 30 * 1000;
+function _susePos(n, label) { const v = Math.floor(Number(n)); if (!Number.isFinite(v) || v <= 0) throw new Error(`${label} must be positive integer`); return v; }
+function _suseCheckB(from, to) { const a = _suseBTrans.get(from); if (!a || !a.has(to)) throw new Error(`invalid suse budget transition ${from} → ${to}`); }
+function _suseCheckR(from, to) { const a = _suseRTrans.get(from); if (!a || !a.has(to)) throw new Error(`invalid suse record transition ${from} → ${to}`); }
+export function setMaxActiveSuseBudgetsPerOwnerV2(n) { _suseMaxActive = _susePos(n, "maxActiveSuseBudgetsPerOwner"); }
+export function getMaxActiveSuseBudgetsPerOwnerV2() { return _suseMaxActive; }
+export function setMaxPendingSuseRecordsPerBudgetV2(n) { _suseMaxPending = _susePos(n, "maxPendingSuseRecordsPerBudget"); }
+export function getMaxPendingSuseRecordsPerBudgetV2() { return _suseMaxPending; }
+export function setSuseBudgetIdleMsV2(n) { _suseIdleMs = _susePos(n, "suseBudgetIdleMs"); }
+export function getSuseBudgetIdleMsV2() { return _suseIdleMs; }
+export function setSuseRecordStuckMsV2(n) { _suseStuckMs = _susePos(n, "suseRecordStuckMs"); }
+export function getSuseRecordStuckMsV2() { return _suseStuckMs; }
+export function _resetStateSessionUsageV2() { _suseBsV2.clear(); _suseRsV2.clear(); _suseMaxActive = 5; _suseMaxPending = 50; _suseIdleMs = 30 * 24 * 60 * 60 * 1000; _suseStuckMs = 30 * 1000; }
+export function registerSuseBudgetV2({ id, owner, limit, metadata } = {}) {
+  if (!id) throw new Error("suse budget id required"); if (!owner) throw new Error("suse budget owner required");
+  if (_suseBsV2.has(id)) throw new Error(`suse budget ${id} already registered`);
+  const now = Date.now();
+  const lim = limit == null ? 1000 : Math.max(1, Math.floor(Number(limit)) || 1);
+  const b = { id, owner, limit: lim, status: SUSE_BUDGET_MATURITY_V2.PENDING, createdAt: now, updatedAt: now, activatedAt: null, archivedAt: null, lastTouchedAt: now, metadata: { ...(metadata || {}) } };
+  _suseBsV2.set(id, b); return { ...b, metadata: { ...b.metadata } };
+}
+function _suseCountActive(owner) { let n = 0; for (const b of _suseBsV2.values()) if (b.owner === owner && b.status === SUSE_BUDGET_MATURITY_V2.ACTIVE) n++; return n; }
+export function activateSuseBudgetV2(id) {
+  const b = _suseBsV2.get(id); if (!b) throw new Error(`suse budget ${id} not found`);
+  _suseCheckB(b.status, SUSE_BUDGET_MATURITY_V2.ACTIVE);
+  const recovery = b.status === SUSE_BUDGET_MATURITY_V2.EXHAUSTED;
+  if (!recovery && _suseCountActive(b.owner) >= _suseMaxActive) throw new Error(`max active suse budgets for owner ${b.owner} reached`);
+  const now = Date.now(); b.status = SUSE_BUDGET_MATURITY_V2.ACTIVE; b.updatedAt = now; b.lastTouchedAt = now; if (!b.activatedAt) b.activatedAt = now;
+  return { ...b, metadata: { ...b.metadata } };
+}
+export function exhaustSuseBudgetV2(id) { const b = _suseBsV2.get(id); if (!b) throw new Error(`suse budget ${id} not found`); _suseCheckB(b.status, SUSE_BUDGET_MATURITY_V2.EXHAUSTED); b.status = SUSE_BUDGET_MATURITY_V2.EXHAUSTED; b.updatedAt = Date.now(); return { ...b, metadata: { ...b.metadata } }; }
+export function archiveSuseBudgetV2(id) { const b = _suseBsV2.get(id); if (!b) throw new Error(`suse budget ${id} not found`); _suseCheckB(b.status, SUSE_BUDGET_MATURITY_V2.ARCHIVED); const now = Date.now(); b.status = SUSE_BUDGET_MATURITY_V2.ARCHIVED; b.updatedAt = now; if (!b.archivedAt) b.archivedAt = now; return { ...b, metadata: { ...b.metadata } }; }
+export function touchSuseBudgetV2(id) { const b = _suseBsV2.get(id); if (!b) throw new Error(`suse budget ${id} not found`); if (_suseBTerminal.has(b.status)) throw new Error(`cannot touch terminal suse budget ${id}`); const now = Date.now(); b.lastTouchedAt = now; b.updatedAt = now; return { ...b, metadata: { ...b.metadata } }; }
+export function getSuseBudgetV2(id) { const b = _suseBsV2.get(id); if (!b) return null; return { ...b, metadata: { ...b.metadata } }; }
+export function listSuseBudgetsV2() { return [..._suseBsV2.values()].map((b) => ({ ...b, metadata: { ...b.metadata } })); }
+function _suseCountPending(budgetId) { let n = 0; for (const r of _suseRsV2.values()) if (r.budgetId === budgetId && (r.status === SUSE_RECORD_LIFECYCLE_V2.QUEUED || r.status === SUSE_RECORD_LIFECYCLE_V2.RECORDING)) n++; return n; }
+export function createSuseRecordV2({ id, budgetId, amount, metadata } = {}) {
+  if (!id) throw new Error("suse record id required"); if (!budgetId) throw new Error("suse record budgetId required");
+  if (_suseRsV2.has(id)) throw new Error(`suse record ${id} already exists`);
+  if (!_suseBsV2.has(budgetId)) throw new Error(`suse budget ${budgetId} not found`);
+  if (_suseCountPending(budgetId) >= _suseMaxPending) throw new Error(`max pending suse records for budget ${budgetId} reached`);
+  const now = Date.now();
+  const amt = amount == null ? 0 : Math.max(0, Number(amount) || 0);
+  const r = { id, budgetId, amount: amt, status: SUSE_RECORD_LIFECYCLE_V2.QUEUED, createdAt: now, updatedAt: now, startedAt: null, settledAt: null, metadata: { ...(metadata || {}) } };
+  _suseRsV2.set(id, r); return { ...r, metadata: { ...r.metadata } };
+}
+export function recordingSuseRecordV2(id) { const r = _suseRsV2.get(id); if (!r) throw new Error(`suse record ${id} not found`); _suseCheckR(r.status, SUSE_RECORD_LIFECYCLE_V2.RECORDING); const now = Date.now(); r.status = SUSE_RECORD_LIFECYCLE_V2.RECORDING; r.updatedAt = now; if (!r.startedAt) r.startedAt = now; return { ...r, metadata: { ...r.metadata } }; }
+export function recordSuseRecordV2(id) { const r = _suseRsV2.get(id); if (!r) throw new Error(`suse record ${id} not found`); _suseCheckR(r.status, SUSE_RECORD_LIFECYCLE_V2.RECORDED); const now = Date.now(); r.status = SUSE_RECORD_LIFECYCLE_V2.RECORDED; r.updatedAt = now; if (!r.settledAt) r.settledAt = now; return { ...r, metadata: { ...r.metadata } }; }
+export function rejectSuseRecordV2(id, reason) { const r = _suseRsV2.get(id); if (!r) throw new Error(`suse record ${id} not found`); _suseCheckR(r.status, SUSE_RECORD_LIFECYCLE_V2.REJECTED); const now = Date.now(); r.status = SUSE_RECORD_LIFECYCLE_V2.REJECTED; r.updatedAt = now; if (!r.settledAt) r.settledAt = now; if (reason) r.metadata.rejectReason = String(reason); return { ...r, metadata: { ...r.metadata } }; }
+export function cancelSuseRecordV2(id, reason) { const r = _suseRsV2.get(id); if (!r) throw new Error(`suse record ${id} not found`); _suseCheckR(r.status, SUSE_RECORD_LIFECYCLE_V2.CANCELLED); const now = Date.now(); r.status = SUSE_RECORD_LIFECYCLE_V2.CANCELLED; r.updatedAt = now; if (!r.settledAt) r.settledAt = now; if (reason) r.metadata.cancelReason = String(reason); return { ...r, metadata: { ...r.metadata } }; }
+export function getSuseRecordV2(id) { const r = _suseRsV2.get(id); if (!r) return null; return { ...r, metadata: { ...r.metadata } }; }
+export function listSuseRecordsV2() { return [..._suseRsV2.values()].map((r) => ({ ...r, metadata: { ...r.metadata } })); }
+export function autoExhaustIdleSuseBudgetsV2({ now } = {}) { const t = now ?? Date.now(); const flipped = []; for (const b of _suseBsV2.values()) if (b.status === SUSE_BUDGET_MATURITY_V2.ACTIVE && (t - b.lastTouchedAt) >= _suseIdleMs) { b.status = SUSE_BUDGET_MATURITY_V2.EXHAUSTED; b.updatedAt = t; flipped.push(b.id); } return { flipped, count: flipped.length }; }
+export function autoRejectStuckSuseRecordsV2({ now } = {}) { const t = now ?? Date.now(); const flipped = []; for (const r of _suseRsV2.values()) if (r.status === SUSE_RECORD_LIFECYCLE_V2.RECORDING && r.startedAt != null && (t - r.startedAt) >= _suseStuckMs) { r.status = SUSE_RECORD_LIFECYCLE_V2.REJECTED; r.updatedAt = t; if (!r.settledAt) r.settledAt = t; r.metadata.rejectReason = "auto-reject-stuck"; flipped.push(r.id); } return { flipped, count: flipped.length }; }
+export function getSessionUsageGovStatsV2() {
+  const budgetsByStatus = {}; for (const v of Object.values(SUSE_BUDGET_MATURITY_V2)) budgetsByStatus[v] = 0; for (const b of _suseBsV2.values()) budgetsByStatus[b.status]++;
+  const recordsByStatus = {}; for (const v of Object.values(SUSE_RECORD_LIFECYCLE_V2)) recordsByStatus[v] = 0; for (const r of _suseRsV2.values()) recordsByStatus[r.status]++;
+  return { totalSuseBudgetsV2: _suseBsV2.size, totalSuseRecordsV2: _suseRsV2.size, maxActiveSuseBudgetsPerOwner: _suseMaxActive, maxPendingSuseRecordsPerBudget: _suseMaxPending, suseBudgetIdleMs: _suseIdleMs, suseRecordStuckMs: _suseStuckMs, budgetsByStatus, recordsByStatus };
+}