chainlesschain 0.132.0 → 0.145.0

package/src/lib/session-consolidator.js

@@ -123,3 +123,355 @@ export async function consolidateJsonlSession(sessionId, options = {}) {
     },
   );
 }
+
+// ===== V2 Surface: Session Consolidator governance overlay (CLI v0.134.0) =====
+export const CONSOL_PROFILE_MATURITY_V2 = Object.freeze({
+  PENDING: "pending",
+  ACTIVE: "active",
+  PAUSED: "paused",
+  ARCHIVED: "archived",
+});
+export const CONSOL_JOB_LIFECYCLE_V2 = Object.freeze({
+  QUEUED: "queued",
+  RUNNING: "running",
+  COMPLETED: "completed",
+  FAILED: "failed",
+  CANCELLED: "cancelled",
+});
+
+const _scProfTrans = new Map([
+  [
+    CONSOL_PROFILE_MATURITY_V2.PENDING,
+    new Set([
+      CONSOL_PROFILE_MATURITY_V2.ACTIVE,
+      CONSOL_PROFILE_MATURITY_V2.ARCHIVED,
+    ]),
+  ],
+  [
+    CONSOL_PROFILE_MATURITY_V2.ACTIVE,
+    new Set([
+      CONSOL_PROFILE_MATURITY_V2.PAUSED,
+      CONSOL_PROFILE_MATURITY_V2.ARCHIVED,
+    ]),
+  ],
+  [
+    CONSOL_PROFILE_MATURITY_V2.PAUSED,
+    new Set([
+      CONSOL_PROFILE_MATURITY_V2.ACTIVE,
+      CONSOL_PROFILE_MATURITY_V2.ARCHIVED,
+    ]),
+  ],
+  [CONSOL_PROFILE_MATURITY_V2.ARCHIVED, new Set()],
+]);
+const _scProfTerminal = new Set([CONSOL_PROFILE_MATURITY_V2.ARCHIVED]);
+const _scJobTrans = new Map([
+  [
+    CONSOL_JOB_LIFECYCLE_V2.QUEUED,
+    new Set([
+      CONSOL_JOB_LIFECYCLE_V2.RUNNING,
+      CONSOL_JOB_LIFECYCLE_V2.CANCELLED,
+    ]),
+  ],
+  [
+    CONSOL_JOB_LIFECYCLE_V2.RUNNING,
+    new Set([
+      CONSOL_JOB_LIFECYCLE_V2.COMPLETED,
+      CONSOL_JOB_LIFECYCLE_V2.FAILED,
+      CONSOL_JOB_LIFECYCLE_V2.CANCELLED,
+    ]),
+  ],
+  [CONSOL_JOB_LIFECYCLE_V2.COMPLETED, new Set()],
+  [CONSOL_JOB_LIFECYCLE_V2.FAILED, new Set()],
+  [CONSOL_JOB_LIFECYCLE_V2.CANCELLED, new Set()],
+]);
+
+const _scProfiles = new Map();
+const _scJobs = new Map();
+let _scMaxActivePerOwner = 8;
+let _scMaxPendingPerProfile = 12;
+let _scProfileIdleMs = 7 * 24 * 60 * 60 * 1000;
+let _scJobStuckMs = 10 * 60 * 1000;
+
+function _scPos(n, lbl) {
+  const v = Math.floor(Number(n));
+  if (!Number.isFinite(v) || v <= 0)
+    throw new Error(`${lbl} must be positive integer`);
+  return v;
+}
+
+export function setMaxActiveConsolProfilesPerOwnerV2(n) {
+  _scMaxActivePerOwner = _scPos(n, "maxActiveConsolProfilesPerOwner");
+}
+export function getMaxActiveConsolProfilesPerOwnerV2() {
+  return _scMaxActivePerOwner;
+}
+export function setMaxPendingConsolJobsPerProfileV2(n) {
+  _scMaxPendingPerProfile = _scPos(n, "maxPendingConsolJobsPerProfile");
+}
+export function getMaxPendingConsolJobsPerProfileV2() {
+  return _scMaxPendingPerProfile;
+}
+export function setConsolProfileIdleMsV2(n) {
+  _scProfileIdleMs = _scPos(n, "consolProfileIdleMs");
+}
+export function getConsolProfileIdleMsV2() {
+  return _scProfileIdleMs;
+}
+export function setConsolJobStuckMsV2(n) {
+  _scJobStuckMs = _scPos(n, "consolJobStuckMs");
+}
+export function getConsolJobStuckMsV2() {
+  return _scJobStuckMs;
+}
+
+export function _resetStateSessionConsolidatorV2() {
+  _scProfiles.clear();
+  _scJobs.clear();
+  _scMaxActivePerOwner = 8;
+  _scMaxPendingPerProfile = 12;
+  _scProfileIdleMs = 7 * 24 * 60 * 60 * 1000;
+  _scJobStuckMs = 10 * 60 * 1000;
+}
+
+export function registerConsolProfileV2({ id, owner, scope, metadata } = {}) {
+  if (!id || typeof id !== "string") throw new Error("id is required");
+  if (!owner || typeof owner !== "string") throw new Error("owner is required");
+  if (_scProfiles.has(id))
+    throw new Error(`consol profile ${id} already registered`);
+  const now = Date.now();
+  const p = {
+    id,
+    owner,
+    scope: scope || "agent",
+    status: CONSOL_PROFILE_MATURITY_V2.PENDING,
+    createdAt: now,
+    updatedAt: now,
+    activatedAt: null,
+    archivedAt: null,
+    lastTouchedAt: now,
+    metadata: { ...(metadata || {}) },
+  };
+  _scProfiles.set(id, p);
+  return { ...p, metadata: { ...p.metadata } };
+}
+function _scCheckP(from, to) {
+  const a = _scProfTrans.get(from);
+  if (!a || !a.has(to))
+    throw new Error(`invalid consol profile transition ${from} → ${to}`);
+}
+function _scCountActive(owner) {
+  let n = 0;
+  for (const p of _scProfiles.values())
+    if (p.owner === owner && p.status === CONSOL_PROFILE_MATURITY_V2.ACTIVE)
+      n++;
+  return n;
+}
+
+export function activateConsolProfileV2(id) {
+  const p = _scProfiles.get(id);
+  if (!p) throw new Error(`consol profile ${id} not found`);
+  _scCheckP(p.status, CONSOL_PROFILE_MATURITY_V2.ACTIVE);
+  const recovery = p.status === CONSOL_PROFILE_MATURITY_V2.PAUSED;
+  if (!recovery) {
+    const a = _scCountActive(p.owner);
+    if (a >= _scMaxActivePerOwner)
+      throw new Error(
+        `max active consol profiles per owner (${_scMaxActivePerOwner}) reached for ${p.owner}`,
+      );
+  }
+  const now = Date.now();
+  p.status = CONSOL_PROFILE_MATURITY_V2.ACTIVE;
+  p.updatedAt = now;
+  p.lastTouchedAt = now;
+  if (!p.activatedAt) p.activatedAt = now;
+  return { ...p, metadata: { ...p.metadata } };
+}
+export function pauseConsolProfileV2(id) {
+  const p = _scProfiles.get(id);
+  if (!p) throw new Error(`consol profile ${id} not found`);
+  _scCheckP(p.status, CONSOL_PROFILE_MATURITY_V2.PAUSED);
+  p.status = CONSOL_PROFILE_MATURITY_V2.PAUSED;
+  p.updatedAt = Date.now();
+  return { ...p, metadata: { ...p.metadata } };
+}
+export function archiveConsolProfileV2(id) {
+  const p = _scProfiles.get(id);
+  if (!p) throw new Error(`consol profile ${id} not found`);
+  _scCheckP(p.status, CONSOL_PROFILE_MATURITY_V2.ARCHIVED);
+  const now = Date.now();
+  p.status = CONSOL_PROFILE_MATURITY_V2.ARCHIVED;
+  p.updatedAt = now;
+  if (!p.archivedAt) p.archivedAt = now;
+  return { ...p, metadata: { ...p.metadata } };
+}
+export function touchConsolProfileV2(id) {
+  const p = _scProfiles.get(id);
+  if (!p) throw new Error(`consol profile ${id} not found`);
+  if (_scProfTerminal.has(p.status))
+    throw new Error(`cannot touch terminal consol profile ${id}`);
+  const now = Date.now();
+  p.lastTouchedAt = now;
+  p.updatedAt = now;
+  return { ...p, metadata: { ...p.metadata } };
+}
+export function getConsolProfileV2(id) {
+  const p = _scProfiles.get(id);
+  if (!p) return null;
+  return { ...p, metadata: { ...p.metadata } };
+}
+export function listConsolProfilesV2() {
+  return [..._scProfiles.values()].map((p) => ({
+    ...p,
+    metadata: { ...p.metadata },
+  }));
+}
+
+function _scCountPending(pid) {
+  let n = 0;
+  for (const j of _scJobs.values())
+    if (
+      j.profileId === pid &&
+      (j.status === CONSOL_JOB_LIFECYCLE_V2.QUEUED ||
+        j.status === CONSOL_JOB_LIFECYCLE_V2.RUNNING)
+    )
+      n++;
+  return n;
+}
+
+export function createConsolJobV2({ id, profileId, sessionId, metadata } = {}) {
+  if (!id || typeof id !== "string") throw new Error("id is required");
+  if (!profileId || typeof profileId !== "string")
+    throw new Error("profileId is required");
+  if (_scJobs.has(id)) throw new Error(`consol job ${id} already exists`);
+  if (!_scProfiles.has(profileId))
+    throw new Error(`consol profile ${profileId} not found`);
+  const pending = _scCountPending(profileId);
+  if (pending >= _scMaxPendingPerProfile)
+    throw new Error(
+      `max pending consol jobs per profile (${_scMaxPendingPerProfile}) reached for ${profileId}`,
+    );
+  const now = Date.now();
+  const j = {
+    id,
+    profileId,
+    sessionId: sessionId || null,
+    status: CONSOL_JOB_LIFECYCLE_V2.QUEUED,
+    createdAt: now,
+    updatedAt: now,
+    startedAt: null,
+    settledAt: null,
+    metadata: { ...(metadata || {}) },
+  };
+  _scJobs.set(id, j);
+  return { ...j, metadata: { ...j.metadata } };
+}
+function _scCheckJ(from, to) {
+  const a = _scJobTrans.get(from);
+  if (!a || !a.has(to))
+    throw new Error(`invalid consol job transition ${from} → ${to}`);
+}
+export function startConsolJobV2(id) {
+  const j = _scJobs.get(id);
+  if (!j) throw new Error(`consol job ${id} not found`);
+  _scCheckJ(j.status, CONSOL_JOB_LIFECYCLE_V2.RUNNING);
+  const now = Date.now();
+  j.status = CONSOL_JOB_LIFECYCLE_V2.RUNNING;
+  j.updatedAt = now;
+  if (!j.startedAt) j.startedAt = now;
+  return { ...j, metadata: { ...j.metadata } };
+}
+export function completeConsolJobV2(id) {
+  const j = _scJobs.get(id);
+  if (!j) throw new Error(`consol job ${id} not found`);
+  _scCheckJ(j.status, CONSOL_JOB_LIFECYCLE_V2.COMPLETED);
+  const now = Date.now();
+  j.status = CONSOL_JOB_LIFECYCLE_V2.COMPLETED;
+  j.updatedAt = now;
+  if (!j.settledAt) j.settledAt = now;
+  return { ...j, metadata: { ...j.metadata } };
+}
+export function failConsolJobV2(id, reason) {
+  const j = _scJobs.get(id);
+  if (!j) throw new Error(`consol job ${id} not found`);
+  _scCheckJ(j.status, CONSOL_JOB_LIFECYCLE_V2.FAILED);
+  const now = Date.now();
+  j.status = CONSOL_JOB_LIFECYCLE_V2.FAILED;
+  j.updatedAt = now;
+  if (!j.settledAt) j.settledAt = now;
+  if (reason) j.metadata.failReason = String(reason);
+  return { ...j, metadata: { ...j.metadata } };
+}
+export function cancelConsolJobV2(id, reason) {
+  const j = _scJobs.get(id);
+  if (!j) throw new Error(`consol job ${id} not found`);
+  _scCheckJ(j.status, CONSOL_JOB_LIFECYCLE_V2.CANCELLED);
+  const now = Date.now();
+  j.status = CONSOL_JOB_LIFECYCLE_V2.CANCELLED;
+  j.updatedAt = now;
+  if (!j.settledAt) j.settledAt = now;
+  if (reason) j.metadata.cancelReason = String(reason);
+  return { ...j, metadata: { ...j.metadata } };
+}
+export function getConsolJobV2(id) {
+  const j = _scJobs.get(id);
+  if (!j) return null;
+  return { ...j, metadata: { ...j.metadata } };
+}
+export function listConsolJobsV2() {
+  return [..._scJobs.values()].map((j) => ({
+    ...j,
+    metadata: { ...j.metadata },
+  }));
+}
+
+export function autoPauseIdleConsolProfilesV2({ now } = {}) {
+  const t = now ?? Date.now();
+  const flipped = [];
+  for (const p of _scProfiles.values())
+    if (
+      p.status === CONSOL_PROFILE_MATURITY_V2.ACTIVE &&
+      t - p.lastTouchedAt >= _scProfileIdleMs
+    ) {
+      p.status = CONSOL_PROFILE_MATURITY_V2.PAUSED;
+      p.updatedAt = t;
+      flipped.push(p.id);
+    }
+  return { flipped, count: flipped.length };
+}
+export function autoFailStuckConsolJobsV2({ now } = {}) {
+  const t = now ?? Date.now();
+  const flipped = [];
+  for (const j of _scJobs.values())
+    if (
+      j.status === CONSOL_JOB_LIFECYCLE_V2.RUNNING &&
+      j.startedAt != null &&
+      t - j.startedAt >= _scJobStuckMs
+    ) {
+      j.status = CONSOL_JOB_LIFECYCLE_V2.FAILED;
+      j.updatedAt = t;
+      if (!j.settledAt) j.settledAt = t;
+      j.metadata.failReason = "auto-fail-stuck";
+      flipped.push(j.id);
+    }
+  return { flipped, count: flipped.length };
+}
+
+export function getSessionConsolidatorStatsV2() {
+  const profilesByStatus = {};
+  for (const s of Object.values(CONSOL_PROFILE_MATURITY_V2))
+    profilesByStatus[s] = 0;
+  for (const p of _scProfiles.values()) profilesByStatus[p.status]++;
+  const jobsByStatus = {};
+  for (const s of Object.values(CONSOL_JOB_LIFECYCLE_V2)) jobsByStatus[s] = 0;
+  for (const j of _scJobs.values()) jobsByStatus[j.status]++;
+  return {
+    totalProfilesV2: _scProfiles.size,
+    totalJobsV2: _scJobs.size,
+    maxActiveConsolProfilesPerOwner: _scMaxActivePerOwner,
+    maxPendingConsolJobsPerProfile: _scMaxPendingPerProfile,
+    consolProfileIdleMs: _scProfileIdleMs,
+    consolJobStuckMs: _scJobStuckMs,
+    profilesByStatus,
+    jobsByStatus,
+  };
+}

package/src/lib/session-hooks.js

@@ -229,3 +229,343 @@ function withTimeout(promise, ms, label) {
   });
   return Promise.race([promise, timeout]).finally(() => clearTimeout(t));
 }
+
+// ===== V2 Surface: Session Hooks governance overlay (CLI v0.142.0) =====
+export const SHOK_PROFILE_MATURITY_V2 = Object.freeze({
+  PENDING: "pending",
+  ACTIVE: "active",
+  DISABLED: "disabled",
+  RETIRED: "retired",
+});
+export const SHOK_INVOCATION_LIFECYCLE_V2 = Object.freeze({
+  QUEUED: "queued",
+  RUNNING: "running",
+  COMPLETED: "completed",
+  FAILED: "failed",
+  CANCELLED: "cancelled",
+});
+const _shokPTrans = new Map([
+  [
+    SHOK_PROFILE_MATURITY_V2.PENDING,
+    new Set([
+      SHOK_PROFILE_MATURITY_V2.ACTIVE,
+      SHOK_PROFILE_MATURITY_V2.RETIRED,
+    ]),
+  ],
+  [
+    SHOK_PROFILE_MATURITY_V2.ACTIVE,
+    new Set([
+      SHOK_PROFILE_MATURITY_V2.DISABLED,
+      SHOK_PROFILE_MATURITY_V2.RETIRED,
+    ]),
+  ],
+  [
+    SHOK_PROFILE_MATURITY_V2.DISABLED,
+    new Set([
+      SHOK_PROFILE_MATURITY_V2.ACTIVE,
+      SHOK_PROFILE_MATURITY_V2.RETIRED,
+    ]),
+  ],
+  [SHOK_PROFILE_MATURITY_V2.RETIRED, new Set()],
+]);
+const _shokPTerminal = new Set([SHOK_PROFILE_MATURITY_V2.RETIRED]);
+const _shokITrans = new Map([
+  [
+    SHOK_INVOCATION_LIFECYCLE_V2.QUEUED,
+    new Set([
+      SHOK_INVOCATION_LIFECYCLE_V2.RUNNING,
+      SHOK_INVOCATION_LIFECYCLE_V2.CANCELLED,
+    ]),
+  ],
+  [
+    SHOK_INVOCATION_LIFECYCLE_V2.RUNNING,
+    new Set([
+      SHOK_INVOCATION_LIFECYCLE_V2.COMPLETED,
+      SHOK_INVOCATION_LIFECYCLE_V2.FAILED,
+      SHOK_INVOCATION_LIFECYCLE_V2.CANCELLED,
+    ]),
+  ],
+  [SHOK_INVOCATION_LIFECYCLE_V2.COMPLETED, new Set()],
+  [SHOK_INVOCATION_LIFECYCLE_V2.FAILED, new Set()],
+  [SHOK_INVOCATION_LIFECYCLE_V2.CANCELLED, new Set()],
+]);
+const _shokPsV2 = new Map();
+const _shokIsV2 = new Map();
+let _shokMaxActive = 12,
+  _shokMaxPending = 25,
+  _shokIdleMs = 30 * 24 * 60 * 60 * 1000,
+  _shokStuckMs = 30 * 1000;
+function _shokPos(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 _shokCheckP(from, to) {
+  const a = _shokPTrans.get(from);
+  if (!a || !a.has(to))
+    throw new Error(`invalid shok profile transition ${from} → ${to}`);
+}
+function _shokCheckI(from, to) {
+  const a = _shokITrans.get(from);
+  if (!a || !a.has(to))
+    throw new Error(`invalid shok invocation transition ${from} → ${to}`);
+}
+export function setMaxActiveShokProfilesPerOwnerV2(n) {
+  _shokMaxActive = _shokPos(n, "maxActiveShokProfilesPerOwner");
+}
+export function getMaxActiveShokProfilesPerOwnerV2() {
+  return _shokMaxActive;
+}
+export function setMaxPendingShokInvocationsPerProfileV2(n) {
+  _shokMaxPending = _shokPos(n, "maxPendingShokInvocationsPerProfile");
+}
+export function getMaxPendingShokInvocationsPerProfileV2() {
+  return _shokMaxPending;
+}
+export function setShokProfileIdleMsV2(n) {
+  _shokIdleMs = _shokPos(n, "shokProfileIdleMs");
+}
+export function getShokProfileIdleMsV2() {
+  return _shokIdleMs;
+}
+export function setShokInvocationStuckMsV2(n) {
+  _shokStuckMs = _shokPos(n, "shokInvocationStuckMs");
+}
+export function getShokInvocationStuckMsV2() {
+  return _shokStuckMs;
+}
+export function _resetStateSessionHooksV2() {
+  _shokPsV2.clear();
+  _shokIsV2.clear();
+  _shokMaxActive = 12;
+  _shokMaxPending = 25;
+  _shokIdleMs = 30 * 24 * 60 * 60 * 1000;
+  _shokStuckMs = 30 * 1000;
+}
+export function registerShokProfileV2({ id, owner, event, metadata } = {}) {
+  if (!id) throw new Error("shok profile id required");
+  if (!owner) throw new Error("shok profile owner required");
+  if (_shokPsV2.has(id))
+    throw new Error(`shok profile ${id} already registered`);
+  const now = Date.now();
+  const p = {
+    id,
+    owner,
+    event: event || "preTurn",
+    status: SHOK_PROFILE_MATURITY_V2.PENDING,
+    createdAt: now,
+    updatedAt: now,
+    activatedAt: null,
+    retiredAt: null,
+    lastTouchedAt: now,
+    metadata: { ...(metadata || {}) },
+  };
+  _shokPsV2.set(id, p);
+  return { ...p, metadata: { ...p.metadata } };
+}
+function _shokCountActive(owner) {
+  let n = 0;
+  for (const p of _shokPsV2.values())
+    if (p.owner === owner && p.status === SHOK_PROFILE_MATURITY_V2.ACTIVE) n++;
+  return n;
+}
+export function activateShokProfileV2(id) {
+  const p = _shokPsV2.get(id);
+  if (!p) throw new Error(`shok profile ${id} not found`);
+  _shokCheckP(p.status, SHOK_PROFILE_MATURITY_V2.ACTIVE);
+  const recovery = p.status === SHOK_PROFILE_MATURITY_V2.DISABLED;
+  if (!recovery && _shokCountActive(p.owner) >= _shokMaxActive)
+    throw new Error(`max active shok profiles for owner ${p.owner} reached`);
+  const now = Date.now();
+  p.status = SHOK_PROFILE_MATURITY_V2.ACTIVE;
+  p.updatedAt = now;
+  p.lastTouchedAt = now;
+  if (!p.activatedAt) p.activatedAt = now;
+  return { ...p, metadata: { ...p.metadata } };
+}
+export function disableShokProfileV2(id) {
+  const p = _shokPsV2.get(id);
+  if (!p) throw new Error(`shok profile ${id} not found`);
+  _shokCheckP(p.status, SHOK_PROFILE_MATURITY_V2.DISABLED);
+  p.status = SHOK_PROFILE_MATURITY_V2.DISABLED;
+  p.updatedAt = Date.now();
+  return { ...p, metadata: { ...p.metadata } };
+}
+export function retireShokProfileV2(id) {
+  const p = _shokPsV2.get(id);
+  if (!p) throw new Error(`shok profile ${id} not found`);
+  _shokCheckP(p.status, SHOK_PROFILE_MATURITY_V2.RETIRED);
+  const now = Date.now();
+  p.status = SHOK_PROFILE_MATURITY_V2.RETIRED;
+  p.updatedAt = now;
+  if (!p.retiredAt) p.retiredAt = now;
+  return { ...p, metadata: { ...p.metadata } };
+}
+export function touchShokProfileV2(id) {
+  const p = _shokPsV2.get(id);
+  if (!p) throw new Error(`shok profile ${id} not found`);
+  if (_shokPTerminal.has(p.status))
+    throw new Error(`cannot touch terminal shok profile ${id}`);
+  const now = Date.now();
+  p.lastTouchedAt = now;
+  p.updatedAt = now;
+  return { ...p, metadata: { ...p.metadata } };
+}
+export function getShokProfileV2(id) {
+  const p = _shokPsV2.get(id);
+  if (!p) return null;
+  return { ...p, metadata: { ...p.metadata } };
+}
+export function listShokProfilesV2() {
+  return [..._shokPsV2.values()].map((p) => ({
+    ...p,
+    metadata: { ...p.metadata },
+  }));
+}
+function _shokCountPending(profileId) {
+  let n = 0;
+  for (const i of _shokIsV2.values())
+    if (
+      i.profileId === profileId &&
+      (i.status === SHOK_INVOCATION_LIFECYCLE_V2.QUEUED ||
+        i.status === SHOK_INVOCATION_LIFECYCLE_V2.RUNNING)
+    )
+      n++;
+  return n;
+}
+export function createShokInvocationV2({
+  id,
+  profileId,
+  payload,
+  metadata,
+} = {}) {
+  if (!id) throw new Error("shok invocation id required");
+  if (!profileId) throw new Error("shok invocation profileId required");
+  if (_shokIsV2.has(id))
+    throw new Error(`shok invocation ${id} already exists`);
+  if (!_shokPsV2.has(profileId))
+    throw new Error(`shok profile ${profileId} not found`);
+  if (_shokCountPending(profileId) >= _shokMaxPending)
+    throw new Error(
+      `max pending shok invocations for profile ${profileId} reached`,
+    );
+  const now = Date.now();
+  const i = {
+    id,
+    profileId,
+    payload: payload || "",
+    status: SHOK_INVOCATION_LIFECYCLE_V2.QUEUED,
+    createdAt: now,
+    updatedAt: now,
+    startedAt: null,
+    settledAt: null,
+    metadata: { ...(metadata || {}) },
+  };
+  _shokIsV2.set(id, i);
+  return { ...i, metadata: { ...i.metadata } };
+}
+export function runningShokInvocationV2(id) {
+  const i = _shokIsV2.get(id);
+  if (!i) throw new Error(`shok invocation ${id} not found`);
+  _shokCheckI(i.status, SHOK_INVOCATION_LIFECYCLE_V2.RUNNING);
+  const now = Date.now();
+  i.status = SHOK_INVOCATION_LIFECYCLE_V2.RUNNING;
+  i.updatedAt = now;
+  if (!i.startedAt) i.startedAt = now;
+  return { ...i, metadata: { ...i.metadata } };
+}
+export function completeShokInvocationV2(id) {
+  const i = _shokIsV2.get(id);
+  if (!i) throw new Error(`shok invocation ${id} not found`);
+  _shokCheckI(i.status, SHOK_INVOCATION_LIFECYCLE_V2.COMPLETED);
+  const now = Date.now();
+  i.status = SHOK_INVOCATION_LIFECYCLE_V2.COMPLETED;
+  i.updatedAt = now;
+  if (!i.settledAt) i.settledAt = now;
+  return { ...i, metadata: { ...i.metadata } };
+}
+export function failShokInvocationV2(id, reason) {
+  const i = _shokIsV2.get(id);
+  if (!i) throw new Error(`shok invocation ${id} not found`);
+  _shokCheckI(i.status, SHOK_INVOCATION_LIFECYCLE_V2.FAILED);
+  const now = Date.now();
+  i.status = SHOK_INVOCATION_LIFECYCLE_V2.FAILED;
+  i.updatedAt = now;
+  if (!i.settledAt) i.settledAt = now;
+  if (reason) i.metadata.failReason = String(reason);
+  return { ...i, metadata: { ...i.metadata } };
+}
+export function cancelShokInvocationV2(id, reason) {
+  const i = _shokIsV2.get(id);
+  if (!i) throw new Error(`shok invocation ${id} not found`);
+  _shokCheckI(i.status, SHOK_INVOCATION_LIFECYCLE_V2.CANCELLED);
+  const now = Date.now();
+  i.status = SHOK_INVOCATION_LIFECYCLE_V2.CANCELLED;
+  i.updatedAt = now;
+  if (!i.settledAt) i.settledAt = now;
+  if (reason) i.metadata.cancelReason = String(reason);
+  return { ...i, metadata: { ...i.metadata } };
+}
+export function getShokInvocationV2(id) {
+  const i = _shokIsV2.get(id);
+  if (!i) return null;
+  return { ...i, metadata: { ...i.metadata } };
+}
+export function listShokInvocationsV2() {
+  return [..._shokIsV2.values()].map((i) => ({
+    ...i,
+    metadata: { ...i.metadata },
+  }));
+}
+export function autoDisableIdleShokProfilesV2({ now } = {}) {
+  const t = now ?? Date.now();
+  const flipped = [];
+  for (const p of _shokPsV2.values())
+    if (
+      p.status === SHOK_PROFILE_MATURITY_V2.ACTIVE &&
+      t - p.lastTouchedAt >= _shokIdleMs
+    ) {
+      p.status = SHOK_PROFILE_MATURITY_V2.DISABLED;
+      p.updatedAt = t;
+      flipped.push(p.id);
+    }
+  return { flipped, count: flipped.length };
+}
+export function autoFailStuckShokInvocationsV2({ now } = {}) {
+  const t = now ?? Date.now();
+  const flipped = [];
+  for (const i of _shokIsV2.values())
+    if (
+      i.status === SHOK_INVOCATION_LIFECYCLE_V2.RUNNING &&
+      i.startedAt != null &&
+      t - i.startedAt >= _shokStuckMs
+    ) {
+      i.status = SHOK_INVOCATION_LIFECYCLE_V2.FAILED;
+      i.updatedAt = t;
+      if (!i.settledAt) i.settledAt = t;
+      i.metadata.failReason = "auto-fail-stuck";
+      flipped.push(i.id);
+    }
+  return { flipped, count: flipped.length };
+}
+export function getSessionHooksGovStatsV2() {
+  const profilesByStatus = {};
+  for (const v of Object.values(SHOK_PROFILE_MATURITY_V2))
+    profilesByStatus[v] = 0;
+  for (const p of _shokPsV2.values()) profilesByStatus[p.status]++;
+  const invocationsByStatus = {};
+  for (const v of Object.values(SHOK_INVOCATION_LIFECYCLE_V2))
+    invocationsByStatus[v] = 0;
+  for (const i of _shokIsV2.values()) invocationsByStatus[i.status]++;
+  return {
+    totalShokProfilesV2: _shokPsV2.size,
+    totalShokInvocationsV2: _shokIsV2.size,
+    maxActiveShokProfilesPerOwner: _shokMaxActive,
+    maxPendingShokInvocationsPerProfile: _shokMaxPending,
+    shokProfileIdleMs: _shokIdleMs,
+    shokInvocationStuckMs: _shokStuckMs,
+    profilesByStatus,
+    invocationsByStatus,
+  };
+}