chainlesschain 0.132.0 → 0.143.0

package/src/lib/sub-agent-registry.js

@@ -218,3 +218,113 @@ export class SubAgentRegistry {
     };
   }
 }
+
+
+// ===== V2 Surface: Sub-Agent Registry governance overlay (CLI v0.133.0) =====
+export const SUBAGENT_PROFILE_MATURITY_V2 = Object.freeze({
+  PENDING: "pending", ACTIVE: "active", PAUSED: "paused", RETIRED: "retired",
+});
+export const SUBAGENT_TASK_LIFECYCLE_V2 = Object.freeze({
+  QUEUED: "queued", RUNNING: "running", COMPLETED: "completed", FAILED: "failed", CANCELLED: "cancelled",
+});
+
+const _saProfileTrans = new Map([
+  [SUBAGENT_PROFILE_MATURITY_V2.PENDING, new Set([SUBAGENT_PROFILE_MATURITY_V2.ACTIVE, SUBAGENT_PROFILE_MATURITY_V2.RETIRED])],
+  [SUBAGENT_PROFILE_MATURITY_V2.ACTIVE, new Set([SUBAGENT_PROFILE_MATURITY_V2.PAUSED, SUBAGENT_PROFILE_MATURITY_V2.RETIRED])],
+  [SUBAGENT_PROFILE_MATURITY_V2.PAUSED, new Set([SUBAGENT_PROFILE_MATURITY_V2.ACTIVE, SUBAGENT_PROFILE_MATURITY_V2.RETIRED])],
+  [SUBAGENT_PROFILE_MATURITY_V2.RETIRED, new Set()],
+]);
+const _saProfileTerminal = new Set([SUBAGENT_PROFILE_MATURITY_V2.RETIRED]);
+const _saTaskTrans = new Map([
+  [SUBAGENT_TASK_LIFECYCLE_V2.QUEUED, new Set([SUBAGENT_TASK_LIFECYCLE_V2.RUNNING, SUBAGENT_TASK_LIFECYCLE_V2.CANCELLED])],
+  [SUBAGENT_TASK_LIFECYCLE_V2.RUNNING, new Set([SUBAGENT_TASK_LIFECYCLE_V2.COMPLETED, SUBAGENT_TASK_LIFECYCLE_V2.FAILED, SUBAGENT_TASK_LIFECYCLE_V2.CANCELLED])],
+  [SUBAGENT_TASK_LIFECYCLE_V2.COMPLETED, new Set()],
+  [SUBAGENT_TASK_LIFECYCLE_V2.FAILED, new Set()],
+  [SUBAGENT_TASK_LIFECYCLE_V2.CANCELLED, new Set()],
+]);
+
+const _saProfiles = new Map();
+const _saTasks = new Map();
+let _saMaxActivePerOwner = 12;
+let _saMaxPendingPerProfile = 24;
+let _saProfileIdleMs = 2 * 60 * 60 * 1000;
+let _saTaskStuckMs = 5 * 60 * 1000;
+
+function _saPos(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 setMaxActiveSubagentsPerOwnerV2(n) { _saMaxActivePerOwner = _saPos(n, "maxActiveSubagentsPerOwner"); }
+export function getMaxActiveSubagentsPerOwnerV2() { return _saMaxActivePerOwner; }
+export function setMaxPendingTasksPerSubagentV2(n) { _saMaxPendingPerProfile = _saPos(n, "maxPendingTasksPerSubagent"); }
+export function getMaxPendingTasksPerSubagentV2() { return _saMaxPendingPerProfile; }
+export function setSubagentIdleMsV2(n) { _saProfileIdleMs = _saPos(n, "subagentIdleMs"); }
+export function getSubagentIdleMsV2() { return _saProfileIdleMs; }
+export function setSubagentTaskStuckMsV2(n) { _saTaskStuckMs = _saPos(n, "subagentTaskStuckMs"); }
+export function getSubagentTaskStuckMsV2() { return _saTaskStuckMs; }
+
+export function _resetStateSubAgentRegistryV2() {
+  _saProfiles.clear(); _saTasks.clear();
+  _saMaxActivePerOwner = 12; _saMaxPendingPerProfile = 24;
+  _saProfileIdleMs = 2 * 60 * 60 * 1000; _saTaskStuckMs = 5 * 60 * 1000;
+}
+
+export function registerSubagentProfileV2({ id, owner, role, metadata } = {}) {
+  if (!id || typeof id !== "string") throw new Error("id is required");
+  if (!owner || typeof owner !== "string") throw new Error("owner is required");
+  if (_saProfiles.has(id)) throw new Error(`subagent profile ${id} already registered`);
+  const now = Date.now();
+  const p = { id, owner, role: role || "generic", status: SUBAGENT_PROFILE_MATURITY_V2.PENDING,
+    createdAt: now, updatedAt: now, activatedAt: null, retiredAt: null, lastTouchedAt: now,
+    metadata: { ...(metadata || {}) } };
+  _saProfiles.set(id, p);
+  return { ...p, metadata: { ...p.metadata } };
+}
+
+function _saCheckP(from, to) { const allowed = _saProfileTrans.get(from); if (!allowed || !allowed.has(to)) throw new Error(`invalid subagent profile transition ${from} → ${to}`); }
+function _saCountActiveByOwner(owner) { let n = 0; for (const p of _saProfiles.values()) if (p.owner === owner && p.status === SUBAGENT_PROFILE_MATURITY_V2.ACTIVE) n++; return n; }
+
+export function activateSubagentProfileV2(id) {
+  const p = _saProfiles.get(id); if (!p) throw new Error(`subagent profile ${id} not found`);
+  _saCheckP(p.status, SUBAGENT_PROFILE_MATURITY_V2.ACTIVE);
+  const recovery = p.status === SUBAGENT_PROFILE_MATURITY_V2.PAUSED;
+  if (!recovery) { const a = _saCountActiveByOwner(p.owner); if (a >= _saMaxActivePerOwner) throw new Error(`max active subagents per owner (${_saMaxActivePerOwner}) reached for ${p.owner}`); }
+  const now = Date.now(); p.status = SUBAGENT_PROFILE_MATURITY_V2.ACTIVE; p.updatedAt = now; p.lastTouchedAt = now;
+  if (!p.activatedAt) p.activatedAt = now;
+  return { ...p, metadata: { ...p.metadata } };
+}
+export function pauseSubagentProfileV2(id) { const p = _saProfiles.get(id); if (!p) throw new Error(`subagent profile ${id} not found`); _saCheckP(p.status, SUBAGENT_PROFILE_MATURITY_V2.PAUSED); p.status = SUBAGENT_PROFILE_MATURITY_V2.PAUSED; p.updatedAt = Date.now(); return { ...p, metadata: { ...p.metadata } }; }
+export function retireSubagentProfileV2(id) { const p = _saProfiles.get(id); if (!p) throw new Error(`subagent profile ${id} not found`); _saCheckP(p.status, SUBAGENT_PROFILE_MATURITY_V2.RETIRED); const now = Date.now(); p.status = SUBAGENT_PROFILE_MATURITY_V2.RETIRED; p.updatedAt = now; if (!p.retiredAt) p.retiredAt = now; return { ...p, metadata: { ...p.metadata } }; }
+export function touchSubagentProfileV2(id) { const p = _saProfiles.get(id); if (!p) throw new Error(`subagent profile ${id} not found`); if (_saProfileTerminal.has(p.status)) throw new Error(`cannot touch terminal subagent profile ${id}`); const now = Date.now(); p.lastTouchedAt = now; p.updatedAt = now; return { ...p, metadata: { ...p.metadata } }; }
+export function getSubagentProfileV2(id) { const p = _saProfiles.get(id); if (!p) return null; return { ...p, metadata: { ...p.metadata } }; }
+export function listSubagentProfilesV2() { return [..._saProfiles.values()].map((p) => ({ ...p, metadata: { ...p.metadata } })); }
+
+function _saCountPendingByProfile(pid) { let n = 0; for (const t of _saTasks.values()) if (t.profileId === pid && (t.status === SUBAGENT_TASK_LIFECYCLE_V2.QUEUED || t.status === SUBAGENT_TASK_LIFECYCLE_V2.RUNNING)) n++; return n; }
+
+export function createSubagentTaskV2({ id, profileId, description, metadata } = {}) {
+  if (!id || typeof id !== "string") throw new Error("id is required");
+  if (!profileId || typeof profileId !== "string") throw new Error("profileId is required");
+  if (_saTasks.has(id)) throw new Error(`subagent task ${id} already exists`);
+  if (!_saProfiles.has(profileId)) throw new Error(`subagent profile ${profileId} not found`);
+  const pending = _saCountPendingByProfile(profileId);
+  if (pending >= _saMaxPendingPerProfile) throw new Error(`max pending tasks per subagent (${_saMaxPendingPerProfile}) reached for ${profileId}`);
+  const now = Date.now();
+  const t = { id, profileId, description: description || "", status: SUBAGENT_TASK_LIFECYCLE_V2.QUEUED,
+    createdAt: now, updatedAt: now, startedAt: null, settledAt: null, metadata: { ...(metadata || {}) } };
+  _saTasks.set(id, t);
+  return { ...t, metadata: { ...t.metadata } };
+}
+function _saCheckT(from, to) { const allowed = _saTaskTrans.get(from); if (!allowed || !allowed.has(to)) throw new Error(`invalid subagent task transition ${from} → ${to}`); }
+export function startSubagentTaskV2(id) { const t = _saTasks.get(id); if (!t) throw new Error(`subagent task ${id} not found`); _saCheckT(t.status, SUBAGENT_TASK_LIFECYCLE_V2.RUNNING); const now = Date.now(); t.status = SUBAGENT_TASK_LIFECYCLE_V2.RUNNING; t.updatedAt = now; if (!t.startedAt) t.startedAt = now; return { ...t, metadata: { ...t.metadata } }; }
+export function completeSubagentTaskV2(id) { const t = _saTasks.get(id); if (!t) throw new Error(`subagent task ${id} not found`); _saCheckT(t.status, SUBAGENT_TASK_LIFECYCLE_V2.COMPLETED); const now = Date.now(); t.status = SUBAGENT_TASK_LIFECYCLE_V2.COMPLETED; t.updatedAt = now; if (!t.settledAt) t.settledAt = now; return { ...t, metadata: { ...t.metadata } }; }
+export function failSubagentTaskV2(id, reason) { const t = _saTasks.get(id); if (!t) throw new Error(`subagent task ${id} not found`); _saCheckT(t.status, SUBAGENT_TASK_LIFECYCLE_V2.FAILED); const now = Date.now(); t.status = SUBAGENT_TASK_LIFECYCLE_V2.FAILED; t.updatedAt = now; if (!t.settledAt) t.settledAt = now; if (reason) t.metadata.failReason = String(reason); return { ...t, metadata: { ...t.metadata } }; }
+export function cancelSubagentTaskV2(id, reason) { const t = _saTasks.get(id); if (!t) throw new Error(`subagent task ${id} not found`); _saCheckT(t.status, SUBAGENT_TASK_LIFECYCLE_V2.CANCELLED); const now = Date.now(); t.status = SUBAGENT_TASK_LIFECYCLE_V2.CANCELLED; t.updatedAt = now; if (!t.settledAt) t.settledAt = now; if (reason) t.metadata.cancelReason = String(reason); return { ...t, metadata: { ...t.metadata } }; }
+export function getSubagentTaskV2(id) { const t = _saTasks.get(id); if (!t) return null; return { ...t, metadata: { ...t.metadata } }; }
+export function listSubagentTasksV2() { return [..._saTasks.values()].map((t) => ({ ...t, metadata: { ...t.metadata } })); }
+
+export function autoPauseIdleSubagentsV2({ now } = {}) { const t = now ?? Date.now(); const flipped = []; for (const p of _saProfiles.values()) if (p.status === SUBAGENT_PROFILE_MATURITY_V2.ACTIVE && (t - p.lastTouchedAt) >= _saProfileIdleMs) { p.status = SUBAGENT_PROFILE_MATURITY_V2.PAUSED; p.updatedAt = t; flipped.push(p.id); } return { flipped, count: flipped.length }; }
+export function autoFailStuckSubagentTasksV2({ now } = {}) { const t = now ?? Date.now(); const flipped = []; for (const k of _saTasks.values()) if (k.status === SUBAGENT_TASK_LIFECYCLE_V2.RUNNING && k.startedAt != null && (t - k.startedAt) >= _saTaskStuckMs) { k.status = SUBAGENT_TASK_LIFECYCLE_V2.FAILED; k.updatedAt = t; if (!k.settledAt) k.settledAt = t; k.metadata.failReason = "auto-fail-stuck"; flipped.push(k.id); } return { flipped, count: flipped.length }; }
+
+export function getSubAgentRegistryStatsV2() {
+  const profilesByStatus = {}; for (const s of Object.values(SUBAGENT_PROFILE_MATURITY_V2)) profilesByStatus[s] = 0; for (const p of _saProfiles.values()) profilesByStatus[p.status]++;
+  const tasksByStatus = {}; for (const s of Object.values(SUBAGENT_TASK_LIFECYCLE_V2)) tasksByStatus[s] = 0; for (const t of _saTasks.values()) tasksByStatus[t.status]++;
+  return { totalProfilesV2: _saProfiles.size, totalTasksV2: _saTasks.size, maxActiveSubagentsPerOwner: _saMaxActivePerOwner, maxPendingTasksPerSubagent: _saMaxPendingPerProfile, subagentIdleMs: _saProfileIdleMs, subagentTaskStuckMs: _saTaskStuckMs, profilesByStatus, tasksByStatus };
+}

package/src/lib/task-model-selector.js

@@ -242,3 +242,84 @@ export function getTaskName(taskType) {
 export function getTaskTypes() {
   return { ...TaskType };
 }
+
+// ===== V2 Surface: Task Model Selector governance overlay (CLI v0.141.0) =====
+export const TMS_PROFILE_MATURITY_V2 = Object.freeze({
+  PENDING: "pending", ACTIVE: "active", STALE: "stale", DECOMMISSIONED: "decommissioned",
+});
+export const TMS_SELECTION_LIFECYCLE_V2 = Object.freeze({
+  QUEUED: "queued", SCORING: "scoring", COMPLETED: "completed", FAILED: "failed", CANCELLED: "cancelled",
+});
+const _tmsPTrans = new Map([
+  [TMS_PROFILE_MATURITY_V2.PENDING, new Set([TMS_PROFILE_MATURITY_V2.ACTIVE, TMS_PROFILE_MATURITY_V2.DECOMMISSIONED])],
+  [TMS_PROFILE_MATURITY_V2.ACTIVE, new Set([TMS_PROFILE_MATURITY_V2.STALE, TMS_PROFILE_MATURITY_V2.DECOMMISSIONED])],
+  [TMS_PROFILE_MATURITY_V2.STALE, new Set([TMS_PROFILE_MATURITY_V2.ACTIVE, TMS_PROFILE_MATURITY_V2.DECOMMISSIONED])],
+  [TMS_PROFILE_MATURITY_V2.DECOMMISSIONED, new Set()],
+]);
+const _tmsPTerminal = new Set([TMS_PROFILE_MATURITY_V2.DECOMMISSIONED]);
+const _tmsSTrans = new Map([
+  [TMS_SELECTION_LIFECYCLE_V2.QUEUED, new Set([TMS_SELECTION_LIFECYCLE_V2.SCORING, TMS_SELECTION_LIFECYCLE_V2.CANCELLED])],
+  [TMS_SELECTION_LIFECYCLE_V2.SCORING, new Set([TMS_SELECTION_LIFECYCLE_V2.COMPLETED, TMS_SELECTION_LIFECYCLE_V2.FAILED, TMS_SELECTION_LIFECYCLE_V2.CANCELLED])],
+  [TMS_SELECTION_LIFECYCLE_V2.COMPLETED, new Set()],
+  [TMS_SELECTION_LIFECYCLE_V2.FAILED, new Set()],
+  [TMS_SELECTION_LIFECYCLE_V2.CANCELLED, new Set()],
+]);
+const _tmsPsV2 = new Map();
+const _tmsSsV2 = new Map();
+let _tmsMaxActivePerOwner = 8, _tmsMaxPendingSelPerProfile = 16, _tmsIdleMs = 14 * 24 * 60 * 60 * 1000, _tmsStuckMs = 2 * 60 * 1000;
+function _tmsPos(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 _tmsCheckP(from, to) { const a = _tmsPTrans.get(from); if (!a || !a.has(to)) throw new Error(`invalid tms profile transition ${from} → ${to}`); }
+function _tmsCheckS(from, to) { const a = _tmsSTrans.get(from); if (!a || !a.has(to)) throw new Error(`invalid tms selection transition ${from} → ${to}`); }
+export function setMaxActiveTmsProfilesPerOwnerV2(n) { _tmsMaxActivePerOwner = _tmsPos(n, "maxActiveTmsProfilesPerOwner"); }
+export function getMaxActiveTmsProfilesPerOwnerV2() { return _tmsMaxActivePerOwner; }
+export function setMaxPendingTmsSelectionsPerProfileV2(n) { _tmsMaxPendingSelPerProfile = _tmsPos(n, "maxPendingTmsSelectionsPerProfile"); }
+export function getMaxPendingTmsSelectionsPerProfileV2() { return _tmsMaxPendingSelPerProfile; }
+export function setTmsProfileIdleMsV2(n) { _tmsIdleMs = _tmsPos(n, "tmsProfileIdleMs"); }
+export function getTmsProfileIdleMsV2() { return _tmsIdleMs; }
+export function setTmsSelectionStuckMsV2(n) { _tmsStuckMs = _tmsPos(n, "tmsSelectionStuckMs"); }
+export function getTmsSelectionStuckMsV2() { return _tmsStuckMs; }
+export function _resetStateTaskModelSelectorV2() { _tmsPsV2.clear(); _tmsSsV2.clear(); _tmsMaxActivePerOwner = 8; _tmsMaxPendingSelPerProfile = 16; _tmsIdleMs = 14 * 24 * 60 * 60 * 1000; _tmsStuckMs = 2 * 60 * 1000; }
+export function registerTmsProfileV2({ id, owner, strategy, metadata } = {}) {
+  if (!id) throw new Error("tms profile id required"); if (!owner) throw new Error("tms profile owner required");
+  if (_tmsPsV2.has(id)) throw new Error(`tms profile ${id} already registered`);
+  const now = Date.now();
+  const p = { id, owner, strategy: strategy || "default", status: TMS_PROFILE_MATURITY_V2.PENDING, createdAt: now, updatedAt: now, activatedAt: null, decommissionedAt: null, lastTouchedAt: now, metadata: { ...(metadata || {}) } };
+  _tmsPsV2.set(id, p); return { ...p, metadata: { ...p.metadata } };
+}
+function _tmsCountActive(owner) { let n = 0; for (const p of _tmsPsV2.values()) if (p.owner === owner && p.status === TMS_PROFILE_MATURITY_V2.ACTIVE) n++; return n; }
+export function activateTmsProfileV2(id) {
+  const p = _tmsPsV2.get(id); if (!p) throw new Error(`tms profile ${id} not found`);
+  _tmsCheckP(p.status, TMS_PROFILE_MATURITY_V2.ACTIVE);
+  const recovery = p.status === TMS_PROFILE_MATURITY_V2.STALE;
+  if (!recovery && _tmsCountActive(p.owner) >= _tmsMaxActivePerOwner) throw new Error(`max active tms profiles for owner ${p.owner} reached`);
+  const now = Date.now(); p.status = TMS_PROFILE_MATURITY_V2.ACTIVE; p.updatedAt = now; p.lastTouchedAt = now; if (!p.activatedAt) p.activatedAt = now;
+  return { ...p, metadata: { ...p.metadata } };
+}
+export function staleTmsProfileV2(id) { const p = _tmsPsV2.get(id); if (!p) throw new Error(`tms profile ${id} not found`); _tmsCheckP(p.status, TMS_PROFILE_MATURITY_V2.STALE); p.status = TMS_PROFILE_MATURITY_V2.STALE; p.updatedAt = Date.now(); return { ...p, metadata: { ...p.metadata } }; }
+export function decommissionTmsProfileV2(id) { const p = _tmsPsV2.get(id); if (!p) throw new Error(`tms profile ${id} not found`); _tmsCheckP(p.status, TMS_PROFILE_MATURITY_V2.DECOMMISSIONED); const now = Date.now(); p.status = TMS_PROFILE_MATURITY_V2.DECOMMISSIONED; p.updatedAt = now; if (!p.decommissionedAt) p.decommissionedAt = now; return { ...p, metadata: { ...p.metadata } }; }
+export function touchTmsProfileV2(id) { const p = _tmsPsV2.get(id); if (!p) throw new Error(`tms profile ${id} not found`); if (_tmsPTerminal.has(p.status)) throw new Error(`cannot touch terminal tms profile ${id}`); const now = Date.now(); p.lastTouchedAt = now; p.updatedAt = now; return { ...p, metadata: { ...p.metadata } }; }
+export function getTmsProfileV2(id) { const p = _tmsPsV2.get(id); if (!p) return null; return { ...p, metadata: { ...p.metadata } }; }
+export function listTmsProfilesV2() { return [..._tmsPsV2.values()].map((p) => ({ ...p, metadata: { ...p.metadata } })); }
+function _tmsCountPending(profileId) { let n = 0; for (const s of _tmsSsV2.values()) if (s.profileId === profileId && (s.status === TMS_SELECTION_LIFECYCLE_V2.QUEUED || s.status === TMS_SELECTION_LIFECYCLE_V2.SCORING)) n++; return n; }
+export function createTmsSelectionV2({ id, profileId, task, metadata } = {}) {
+  if (!id) throw new Error("tms selection id required"); if (!profileId) throw new Error("tms selection profileId required");
+  if (_tmsSsV2.has(id)) throw new Error(`tms selection ${id} already exists`);
+  if (!_tmsPsV2.has(profileId)) throw new Error(`tms profile ${profileId} not found`);
+  if (_tmsCountPending(profileId) >= _tmsMaxPendingSelPerProfile) throw new Error(`max pending tms selections for profile ${profileId} reached`);
+  const now = Date.now();
+  const s = { id, profileId, task: task || "", status: TMS_SELECTION_LIFECYCLE_V2.QUEUED, createdAt: now, updatedAt: now, startedAt: null, settledAt: null, metadata: { ...(metadata || {}) } };
+  _tmsSsV2.set(id, s); return { ...s, metadata: { ...s.metadata } };
+}
+export function scoreTmsSelectionV2(id) { const s = _tmsSsV2.get(id); if (!s) throw new Error(`tms selection ${id} not found`); _tmsCheckS(s.status, TMS_SELECTION_LIFECYCLE_V2.SCORING); const now = Date.now(); s.status = TMS_SELECTION_LIFECYCLE_V2.SCORING; s.updatedAt = now; if (!s.startedAt) s.startedAt = now; return { ...s, metadata: { ...s.metadata } }; }
+export function completeTmsSelectionV2(id) { const s = _tmsSsV2.get(id); if (!s) throw new Error(`tms selection ${id} not found`); _tmsCheckS(s.status, TMS_SELECTION_LIFECYCLE_V2.COMPLETED); const now = Date.now(); s.status = TMS_SELECTION_LIFECYCLE_V2.COMPLETED; s.updatedAt = now; if (!s.settledAt) s.settledAt = now; return { ...s, metadata: { ...s.metadata } }; }
+export function failTmsSelectionV2(id, reason) { const s = _tmsSsV2.get(id); if (!s) throw new Error(`tms selection ${id} not found`); _tmsCheckS(s.status, TMS_SELECTION_LIFECYCLE_V2.FAILED); const now = Date.now(); s.status = TMS_SELECTION_LIFECYCLE_V2.FAILED; s.updatedAt = now; if (!s.settledAt) s.settledAt = now; if (reason) s.metadata.failReason = String(reason); return { ...s, metadata: { ...s.metadata } }; }
+export function cancelTmsSelectionV2(id, reason) { const s = _tmsSsV2.get(id); if (!s) throw new Error(`tms selection ${id} not found`); _tmsCheckS(s.status, TMS_SELECTION_LIFECYCLE_V2.CANCELLED); const now = Date.now(); s.status = TMS_SELECTION_LIFECYCLE_V2.CANCELLED; s.updatedAt = now; if (!s.settledAt) s.settledAt = now; if (reason) s.metadata.cancelReason = String(reason); return { ...s, metadata: { ...s.metadata } }; }
+export function getTmsSelectionV2(id) { const s = _tmsSsV2.get(id); if (!s) return null; return { ...s, metadata: { ...s.metadata } }; }
+export function listTmsSelectionsV2() { return [..._tmsSsV2.values()].map((s) => ({ ...s, metadata: { ...s.metadata } })); }
+export function autoStaleIdleTmsProfilesV2({ now } = {}) { const t = now ?? Date.now(); const flipped = []; for (const p of _tmsPsV2.values()) if (p.status === TMS_PROFILE_MATURITY_V2.ACTIVE && (t - p.lastTouchedAt) >= _tmsIdleMs) { p.status = TMS_PROFILE_MATURITY_V2.STALE; p.updatedAt = t; flipped.push(p.id); } return { flipped, count: flipped.length }; }
+export function autoFailStuckTmsSelectionsV2({ now } = {}) { const t = now ?? Date.now(); const flipped = []; for (const s of _tmsSsV2.values()) if (s.status === TMS_SELECTION_LIFECYCLE_V2.SCORING && s.startedAt != null && (t - s.startedAt) >= _tmsStuckMs) { s.status = TMS_SELECTION_LIFECYCLE_V2.FAILED; s.updatedAt = t; if (!s.settledAt) s.settledAt = t; s.metadata.failReason = "auto-fail-stuck"; flipped.push(s.id); } return { flipped, count: flipped.length }; }
+export function getTaskModelSelectorGovStatsV2() {
+  const profilesByStatus = {}; for (const v of Object.values(TMS_PROFILE_MATURITY_V2)) profilesByStatus[v] = 0; for (const p of _tmsPsV2.values()) profilesByStatus[p.status]++;
+  const selectionsByStatus = {}; for (const v of Object.values(TMS_SELECTION_LIFECYCLE_V2)) selectionsByStatus[v] = 0; for (const s of _tmsSsV2.values()) selectionsByStatus[s.status]++;
+  return { totalTmsProfilesV2: _tmsPsV2.size, totalTmsSelectionsV2: _tmsSsV2.size, maxActiveTmsProfilesPerOwner: _tmsMaxActivePerOwner, maxPendingTmsSelectionsPerProfile: _tmsMaxPendingSelPerProfile, tmsProfileIdleMs: _tmsIdleMs, tmsSelectionStuckMs: _tmsStuckMs, profilesByStatus, selectionsByStatus };
+}

package/src/lib/todo-manager.js

@@ -106,3 +106,108 @@ export function resetAllStores() {
 }
 
 export const _deps = { _stores };
+
+
+// ===== V2 Surface: Todo Manager governance overlay (CLI v0.133.0) =====
+export const TODO_LIST_MATURITY_V2 = Object.freeze({
+  DRAFT: "draft", ACTIVE: "active", PAUSED: "paused", ARCHIVED: "archived",
+});
+export const TODO_ITEM_LIFECYCLE_V2 = Object.freeze({
+  PENDING: "pending", IN_PROGRESS: "in_progress", COMPLETED: "completed", FAILED: "failed", CANCELLED: "cancelled",
+});
+
+const _tlListTrans = new Map([
+  [TODO_LIST_MATURITY_V2.DRAFT, new Set([TODO_LIST_MATURITY_V2.ACTIVE, TODO_LIST_MATURITY_V2.ARCHIVED])],
+  [TODO_LIST_MATURITY_V2.ACTIVE, new Set([TODO_LIST_MATURITY_V2.PAUSED, TODO_LIST_MATURITY_V2.ARCHIVED])],
+  [TODO_LIST_MATURITY_V2.PAUSED, new Set([TODO_LIST_MATURITY_V2.ACTIVE, TODO_LIST_MATURITY_V2.ARCHIVED])],
+  [TODO_LIST_MATURITY_V2.ARCHIVED, new Set()],
+]);
+const _tlListTerminal = new Set([TODO_LIST_MATURITY_V2.ARCHIVED]);
+const _tlItemTrans = new Map([
+  [TODO_ITEM_LIFECYCLE_V2.PENDING, new Set([TODO_ITEM_LIFECYCLE_V2.IN_PROGRESS, TODO_ITEM_LIFECYCLE_V2.CANCELLED])],
+  [TODO_ITEM_LIFECYCLE_V2.IN_PROGRESS, new Set([TODO_ITEM_LIFECYCLE_V2.COMPLETED, TODO_ITEM_LIFECYCLE_V2.FAILED, TODO_ITEM_LIFECYCLE_V2.CANCELLED])],
+  [TODO_ITEM_LIFECYCLE_V2.COMPLETED, new Set()],
+  [TODO_ITEM_LIFECYCLE_V2.FAILED, new Set()],
+  [TODO_ITEM_LIFECYCLE_V2.CANCELLED, new Set()],
+]);
+
+const _tlLists = new Map();
+const _tlItems = new Map();
+let _tlMaxActivePerOwner = 10;
+let _tlMaxPendingPerList = 40;
+let _tlListIdleMs = 7 * 24 * 60 * 60 * 1000;
+let _tlItemStuckMs = 24 * 60 * 60 * 1000;
+
+function _tlPos(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 setMaxActiveTodoListsPerOwnerV2(n) { _tlMaxActivePerOwner = _tlPos(n, "maxActiveTodoListsPerOwner"); }
+export function getMaxActiveTodoListsPerOwnerV2() { return _tlMaxActivePerOwner; }
+export function setMaxPendingItemsPerTodoListV2(n) { _tlMaxPendingPerList = _tlPos(n, "maxPendingItemsPerTodoList"); }
+export function getMaxPendingItemsPerTodoListV2() { return _tlMaxPendingPerList; }
+export function setTodoListIdleMsV2(n) { _tlListIdleMs = _tlPos(n, "todoListIdleMs"); }
+export function getTodoListIdleMsV2() { return _tlListIdleMs; }
+export function setTodoItemStuckMsV2(n) { _tlItemStuckMs = _tlPos(n, "todoItemStuckMs"); }
+export function getTodoItemStuckMsV2() { return _tlItemStuckMs; }
+
+export function _resetStateTodoManagerV2() {
+  _tlLists.clear(); _tlItems.clear();
+  _tlMaxActivePerOwner = 10; _tlMaxPendingPerList = 40;
+  _tlListIdleMs = 7 * 24 * 60 * 60 * 1000; _tlItemStuckMs = 24 * 60 * 60 * 1000;
+}
+
+export function registerTodoListV2({ id, owner, title, metadata } = {}) {
+  if (!id || typeof id !== "string") throw new Error("id is required");
+  if (!owner || typeof owner !== "string") throw new Error("owner is required");
+  if (_tlLists.has(id)) throw new Error(`todo list ${id} already registered`);
+  const now = Date.now();
+  const l = { id, owner, title: title || id, status: TODO_LIST_MATURITY_V2.DRAFT, createdAt: now, updatedAt: now, activatedAt: null, archivedAt: null, lastTouchedAt: now, metadata: { ...(metadata || {}) } };
+  _tlLists.set(id, l);
+  return { ...l, metadata: { ...l.metadata } };
+}
+function _tlCheckL(from, to) { const allowed = _tlListTrans.get(from); if (!allowed || !allowed.has(to)) throw new Error(`invalid todo list transition ${from} → ${to}`); }
+function _tlCountActive(owner) { let n = 0; for (const l of _tlLists.values()) if (l.owner === owner && l.status === TODO_LIST_MATURITY_V2.ACTIVE) n++; return n; }
+
+export function activateTodoListV2(id) {
+  const l = _tlLists.get(id); if (!l) throw new Error(`todo list ${id} not found`);
+  _tlCheckL(l.status, TODO_LIST_MATURITY_V2.ACTIVE);
+  const recovery = l.status === TODO_LIST_MATURITY_V2.PAUSED;
+  if (!recovery) { const a = _tlCountActive(l.owner); if (a >= _tlMaxActivePerOwner) throw new Error(`max active todo lists per owner (${_tlMaxActivePerOwner}) reached for ${l.owner}`); }
+  const now = Date.now(); l.status = TODO_LIST_MATURITY_V2.ACTIVE; l.updatedAt = now; l.lastTouchedAt = now; if (!l.activatedAt) l.activatedAt = now;
+  return { ...l, metadata: { ...l.metadata } };
+}
+export function pauseTodoListV2(id) { const l = _tlLists.get(id); if (!l) throw new Error(`todo list ${id} not found`); _tlCheckL(l.status, TODO_LIST_MATURITY_V2.PAUSED); l.status = TODO_LIST_MATURITY_V2.PAUSED; l.updatedAt = Date.now(); return { ...l, metadata: { ...l.metadata } }; }
+export function archiveTodoListV2(id) { const l = _tlLists.get(id); if (!l) throw new Error(`todo list ${id} not found`); _tlCheckL(l.status, TODO_LIST_MATURITY_V2.ARCHIVED); const now = Date.now(); l.status = TODO_LIST_MATURITY_V2.ARCHIVED; l.updatedAt = now; if (!l.archivedAt) l.archivedAt = now; return { ...l, metadata: { ...l.metadata } }; }
+export function touchTodoListV2(id) { const l = _tlLists.get(id); if (!l) throw new Error(`todo list ${id} not found`); if (_tlListTerminal.has(l.status)) throw new Error(`cannot touch terminal todo list ${id}`); const now = Date.now(); l.lastTouchedAt = now; l.updatedAt = now; return { ...l, metadata: { ...l.metadata } }; }
+export function getTodoListV2(id) { const l = _tlLists.get(id); if (!l) return null; return { ...l, metadata: { ...l.metadata } }; }
+export function listTodoListsV2() { return [..._tlLists.values()].map((l) => ({ ...l, metadata: { ...l.metadata } })); }
+
+function _tlCountPending(lid) { let n = 0; for (const it of _tlItems.values()) if (it.listId === lid && (it.status === TODO_ITEM_LIFECYCLE_V2.PENDING || it.status === TODO_ITEM_LIFECYCLE_V2.IN_PROGRESS)) n++; return n; }
+
+export function createTodoItemV2({ id, listId, description, metadata } = {}) {
+  if (!id || typeof id !== "string") throw new Error("id is required");
+  if (!listId || typeof listId !== "string") throw new Error("listId is required");
+  if (_tlItems.has(id)) throw new Error(`todo item ${id} already exists`);
+  if (!_tlLists.has(listId)) throw new Error(`todo list ${listId} not found`);
+  const pending = _tlCountPending(listId);
+  if (pending >= _tlMaxPendingPerList) throw new Error(`max pending items per todo list (${_tlMaxPendingPerList}) reached for ${listId}`);
+  const now = Date.now();
+  const it = { id, listId, description: description || "", status: TODO_ITEM_LIFECYCLE_V2.PENDING, createdAt: now, updatedAt: now, startedAt: null, settledAt: null, metadata: { ...(metadata || {}) } };
+  _tlItems.set(id, it);
+  return { ...it, metadata: { ...it.metadata } };
+}
+function _tlCheckI(from, to) { const allowed = _tlItemTrans.get(from); if (!allowed || !allowed.has(to)) throw new Error(`invalid todo item transition ${from} → ${to}`); }
+export function startTodoItemV2(id) { const it = _tlItems.get(id); if (!it) throw new Error(`todo item ${id} not found`); _tlCheckI(it.status, TODO_ITEM_LIFECYCLE_V2.IN_PROGRESS); const now = Date.now(); it.status = TODO_ITEM_LIFECYCLE_V2.IN_PROGRESS; it.updatedAt = now; if (!it.startedAt) it.startedAt = now; return { ...it, metadata: { ...it.metadata } }; }
+export function completeTodoItemV2(id) { const it = _tlItems.get(id); if (!it) throw new Error(`todo item ${id} not found`); _tlCheckI(it.status, TODO_ITEM_LIFECYCLE_V2.COMPLETED); const now = Date.now(); it.status = TODO_ITEM_LIFECYCLE_V2.COMPLETED; it.updatedAt = now; if (!it.settledAt) it.settledAt = now; return { ...it, metadata: { ...it.metadata } }; }
+export function failTodoItemV2(id, reason) { const it = _tlItems.get(id); if (!it) throw new Error(`todo item ${id} not found`); _tlCheckI(it.status, TODO_ITEM_LIFECYCLE_V2.FAILED); const now = Date.now(); it.status = TODO_ITEM_LIFECYCLE_V2.FAILED; it.updatedAt = now; if (!it.settledAt) it.settledAt = now; if (reason) it.metadata.failReason = String(reason); return { ...it, metadata: { ...it.metadata } }; }
+export function cancelTodoItemV2(id, reason) { const it = _tlItems.get(id); if (!it) throw new Error(`todo item ${id} not found`); _tlCheckI(it.status, TODO_ITEM_LIFECYCLE_V2.CANCELLED); const now = Date.now(); it.status = TODO_ITEM_LIFECYCLE_V2.CANCELLED; it.updatedAt = now; if (!it.settledAt) it.settledAt = now; if (reason) it.metadata.cancelReason = String(reason); return { ...it, metadata: { ...it.metadata } }; }
+export function getTodoItemV2(id) { const it = _tlItems.get(id); if (!it) return null; return { ...it, metadata: { ...it.metadata } }; }
+export function listTodoItemsV2() { return [..._tlItems.values()].map((it) => ({ ...it, metadata: { ...it.metadata } })); }
+
+export function autoPauseIdleTodoListsV2({ now } = {}) { const t = now ?? Date.now(); const flipped = []; for (const l of _tlLists.values()) if (l.status === TODO_LIST_MATURITY_V2.ACTIVE && (t - l.lastTouchedAt) >= _tlListIdleMs) { l.status = TODO_LIST_MATURITY_V2.PAUSED; l.updatedAt = t; flipped.push(l.id); } return { flipped, count: flipped.length }; }
+export function autoFailStuckTodoItemsV2({ now } = {}) { const t = now ?? Date.now(); const flipped = []; for (const it of _tlItems.values()) if (it.status === TODO_ITEM_LIFECYCLE_V2.IN_PROGRESS && it.startedAt != null && (t - it.startedAt) >= _tlItemStuckMs) { it.status = TODO_ITEM_LIFECYCLE_V2.FAILED; it.updatedAt = t; if (!it.settledAt) it.settledAt = t; it.metadata.failReason = "auto-fail-stuck"; flipped.push(it.id); } return { flipped, count: flipped.length }; }
+
+export function getTodoManagerStatsV2() {
+  const listsByStatus = {}; for (const s of Object.values(TODO_LIST_MATURITY_V2)) listsByStatus[s] = 0; for (const l of _tlLists.values()) listsByStatus[l.status]++;
+  const itemsByStatus = {}; for (const s of Object.values(TODO_ITEM_LIFECYCLE_V2)) itemsByStatus[s] = 0; for (const it of _tlItems.values()) itemsByStatus[it.status]++;
+  return { totalListsV2: _tlLists.size, totalItemsV2: _tlItems.size, maxActiveTodoListsPerOwner: _tlMaxActivePerOwner, maxPendingItemsPerTodoList: _tlMaxPendingPerList, todoListIdleMs: _tlListIdleMs, todoItemStuckMs: _tlItemStuckMs, listsByStatus, itemsByStatus };
+}

package/src/lib/topic-classifier.js

@@ -398,3 +398,108 @@ export function classifyTopic(text, opts = {}) {
 export function _resetState() {
   _customLexicons.clear();
 }
+
+
+// ===== V2 Surface: Topic Classifier governance overlay (CLI v0.140.0) =====
+export const TOPIC_CLS_PROFILE_MATURITY_V2 = Object.freeze({
+  PENDING: "pending", ACTIVE: "active", STALE: "stale", ARCHIVED: "archived",
+});
+export const TOPIC_CLS_JOB_LIFECYCLE_V2 = Object.freeze({
+  QUEUED: "queued", RUNNING: "running", COMPLETED: "completed", FAILED: "failed", CANCELLED: "cancelled",
+});
+
+const _tcpTrans = new Map([
+  [TOPIC_CLS_PROFILE_MATURITY_V2.PENDING, new Set([TOPIC_CLS_PROFILE_MATURITY_V2.ACTIVE, TOPIC_CLS_PROFILE_MATURITY_V2.ARCHIVED])],
+  [TOPIC_CLS_PROFILE_MATURITY_V2.ACTIVE, new Set([TOPIC_CLS_PROFILE_MATURITY_V2.STALE, TOPIC_CLS_PROFILE_MATURITY_V2.ARCHIVED])],
+  [TOPIC_CLS_PROFILE_MATURITY_V2.STALE, new Set([TOPIC_CLS_PROFILE_MATURITY_V2.ACTIVE, TOPIC_CLS_PROFILE_MATURITY_V2.ARCHIVED])],
+  [TOPIC_CLS_PROFILE_MATURITY_V2.ARCHIVED, new Set()],
+]);
+const _tcpTerminal = new Set([TOPIC_CLS_PROFILE_MATURITY_V2.ARCHIVED]);
+const _tcjTrans = new Map([
+  [TOPIC_CLS_JOB_LIFECYCLE_V2.QUEUED, new Set([TOPIC_CLS_JOB_LIFECYCLE_V2.RUNNING, TOPIC_CLS_JOB_LIFECYCLE_V2.CANCELLED])],
+  [TOPIC_CLS_JOB_LIFECYCLE_V2.RUNNING, new Set([TOPIC_CLS_JOB_LIFECYCLE_V2.COMPLETED, TOPIC_CLS_JOB_LIFECYCLE_V2.FAILED, TOPIC_CLS_JOB_LIFECYCLE_V2.CANCELLED])],
+  [TOPIC_CLS_JOB_LIFECYCLE_V2.COMPLETED, new Set()],
+  [TOPIC_CLS_JOB_LIFECYCLE_V2.FAILED, new Set()],
+  [TOPIC_CLS_JOB_LIFECYCLE_V2.CANCELLED, new Set()],
+]);
+
+const _tcpsV2 = new Map();
+const _tcjsV2 = new Map();
+let _tcpMaxActivePerOwner = 8;
+let _tcpMaxPendingJobsPerProfile = 20;
+let _tcpIdleMs = 14 * 24 * 60 * 60 * 1000;
+let _tcjStuckMs = 5 * 60 * 1000;
+
+function _tcpPos(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 setMaxActiveTopicClsProfilesPerOwnerV2(n) { _tcpMaxActivePerOwner = _tcpPos(n, "maxActiveTopicClsProfilesPerOwner"); }
+export function getMaxActiveTopicClsProfilesPerOwnerV2() { return _tcpMaxActivePerOwner; }
+export function setMaxPendingTopicClsJobsPerProfileV2(n) { _tcpMaxPendingJobsPerProfile = _tcpPos(n, "maxPendingTopicClsJobsPerProfile"); }
+export function getMaxPendingTopicClsJobsPerProfileV2() { return _tcpMaxPendingJobsPerProfile; }
+export function setTopicClsProfileIdleMsV2(n) { _tcpIdleMs = _tcpPos(n, "topicClsProfileIdleMs"); }
+export function getTopicClsProfileIdleMsV2() { return _tcpIdleMs; }
+export function setTopicClsJobStuckMsV2(n) { _tcjStuckMs = _tcpPos(n, "topicClsJobStuckMs"); }
+export function getTopicClsJobStuckMsV2() { return _tcjStuckMs; }
+
+export function _resetStateTopicClsV2() {
+  _tcpsV2.clear(); _tcjsV2.clear();
+  _tcpMaxActivePerOwner = 8; _tcpMaxPendingJobsPerProfile = 20;
+  _tcpIdleMs = 14 * 24 * 60 * 60 * 1000; _tcjStuckMs = 5 * 60 * 1000;
+}
+
+export function registerTopicClsProfileV2({ id, owner, model, metadata } = {}) {
+  if (!id || typeof id !== "string") throw new Error("id is required");
+  if (!owner || typeof owner !== "string") throw new Error("owner is required");
+  if (_tcpsV2.has(id)) throw new Error(`topic cls profile ${id} already registered`);
+  const now = Date.now();
+  const p = { id, owner, model: model || "default", status: TOPIC_CLS_PROFILE_MATURITY_V2.PENDING, createdAt: now, updatedAt: now, activatedAt: null, archivedAt: null, lastTouchedAt: now, metadata: { ...(metadata || {}) } };
+  _tcpsV2.set(id, p);
+  return { ...p, metadata: { ...p.metadata } };
+}
+function _tcpCheckP(from, to) { const a = _tcpTrans.get(from); if (!a || !a.has(to)) throw new Error(`invalid topic cls profile transition ${from} → ${to}`); }
+function _tcpCountActive(owner) { let n = 0; for (const p of _tcpsV2.values()) if (p.owner === owner && p.status === TOPIC_CLS_PROFILE_MATURITY_V2.ACTIVE) n++; return n; }
+
+export function activateTopicClsProfileV2(id) {
+  const p = _tcpsV2.get(id); if (!p) throw new Error(`topic cls profile ${id} not found`);
+  _tcpCheckP(p.status, TOPIC_CLS_PROFILE_MATURITY_V2.ACTIVE);
+  const recovery = p.status === TOPIC_CLS_PROFILE_MATURITY_V2.STALE;
+  if (!recovery) { const c = _tcpCountActive(p.owner); if (c >= _tcpMaxActivePerOwner) throw new Error(`max active topic cls profiles per owner (${_tcpMaxActivePerOwner}) reached for ${p.owner}`); }
+  const now = Date.now(); p.status = TOPIC_CLS_PROFILE_MATURITY_V2.ACTIVE; p.updatedAt = now; p.lastTouchedAt = now; if (!p.activatedAt) p.activatedAt = now;
+  return { ...p, metadata: { ...p.metadata } };
+}
+export function staleTopicClsProfileV2(id) { const p = _tcpsV2.get(id); if (!p) throw new Error(`topic cls profile ${id} not found`); _tcpCheckP(p.status, TOPIC_CLS_PROFILE_MATURITY_V2.STALE); p.status = TOPIC_CLS_PROFILE_MATURITY_V2.STALE; p.updatedAt = Date.now(); return { ...p, metadata: { ...p.metadata } }; }
+export function archiveTopicClsProfileV2(id) { const p = _tcpsV2.get(id); if (!p) throw new Error(`topic cls profile ${id} not found`); _tcpCheckP(p.status, TOPIC_CLS_PROFILE_MATURITY_V2.ARCHIVED); const now = Date.now(); p.status = TOPIC_CLS_PROFILE_MATURITY_V2.ARCHIVED; p.updatedAt = now; if (!p.archivedAt) p.archivedAt = now; return { ...p, metadata: { ...p.metadata } }; }
+export function touchTopicClsProfileV2(id) { const p = _tcpsV2.get(id); if (!p) throw new Error(`topic cls profile ${id} not found`); if (_tcpTerminal.has(p.status)) throw new Error(`cannot touch terminal topic cls profile ${id}`); const now = Date.now(); p.lastTouchedAt = now; p.updatedAt = now; return { ...p, metadata: { ...p.metadata } }; }
+export function getTopicClsProfileV2(id) { const p = _tcpsV2.get(id); if (!p) return null; return { ...p, metadata: { ...p.metadata } }; }
+export function listTopicClsProfilesV2() { return [..._tcpsV2.values()].map((p) => ({ ...p, metadata: { ...p.metadata } })); }
+
+function _tcjCountPending(profileId) { let n = 0; for (const j of _tcjsV2.values()) if (j.profileId === profileId && (j.status === TOPIC_CLS_JOB_LIFECYCLE_V2.QUEUED || j.status === TOPIC_CLS_JOB_LIFECYCLE_V2.RUNNING)) n++; return n; }
+
+export function createTopicClsJobV2({ id, profileId, text, metadata } = {}) {
+  if (!id || typeof id !== "string") throw new Error("id is required");
+  if (!profileId || typeof profileId !== "string") throw new Error("profileId is required");
+  if (_tcjsV2.has(id)) throw new Error(`topic cls job ${id} already exists`);
+  if (!_tcpsV2.has(profileId)) throw new Error(`topic cls profile ${profileId} not found`);
+  const pending = _tcjCountPending(profileId);
+  if (pending >= _tcpMaxPendingJobsPerProfile) throw new Error(`max pending topic cls jobs per profile (${_tcpMaxPendingJobsPerProfile}) reached for ${profileId}`);
+  const now = Date.now();
+  const j = { id, profileId, text: text || "", status: TOPIC_CLS_JOB_LIFECYCLE_V2.QUEUED, createdAt: now, updatedAt: now, startedAt: null, settledAt: null, metadata: { ...(metadata || {}) } };
+  _tcjsV2.set(id, j);
+  return { ...j, metadata: { ...j.metadata } };
+}
+function _tcjCheckJ(from, to) { const a = _tcjTrans.get(from); if (!a || !a.has(to)) throw new Error(`invalid topic cls job transition ${from} → ${to}`); }
+export function startTopicClsJobV2(id) { const j = _tcjsV2.get(id); if (!j) throw new Error(`topic cls job ${id} not found`); _tcjCheckJ(j.status, TOPIC_CLS_JOB_LIFECYCLE_V2.RUNNING); const now = Date.now(); j.status = TOPIC_CLS_JOB_LIFECYCLE_V2.RUNNING; j.updatedAt = now; if (!j.startedAt) j.startedAt = now; return { ...j, metadata: { ...j.metadata } }; }
+export function completeTopicClsJobV2(id) { const j = _tcjsV2.get(id); if (!j) throw new Error(`topic cls job ${id} not found`); _tcjCheckJ(j.status, TOPIC_CLS_JOB_LIFECYCLE_V2.COMPLETED); const now = Date.now(); j.status = TOPIC_CLS_JOB_LIFECYCLE_V2.COMPLETED; j.updatedAt = now; if (!j.settledAt) j.settledAt = now; return { ...j, metadata: { ...j.metadata } }; }
+export function failTopicClsJobV2(id, reason) { const j = _tcjsV2.get(id); if (!j) throw new Error(`topic cls job ${id} not found`); _tcjCheckJ(j.status, TOPIC_CLS_JOB_LIFECYCLE_V2.FAILED); const now = Date.now(); j.status = TOPIC_CLS_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 cancelTopicClsJobV2(id, reason) { const j = _tcjsV2.get(id); if (!j) throw new Error(`topic cls job ${id} not found`); _tcjCheckJ(j.status, TOPIC_CLS_JOB_LIFECYCLE_V2.CANCELLED); const now = Date.now(); j.status = TOPIC_CLS_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 getTopicClsJobV2(id) { const j = _tcjsV2.get(id); if (!j) return null; return { ...j, metadata: { ...j.metadata } }; }
+export function listTopicClsJobsV2() { return [..._tcjsV2.values()].map((j) => ({ ...j, metadata: { ...j.metadata } })); }
+
+export function autoStaleIdleTopicClsProfilesV2({ now } = {}) { const t = now ?? Date.now(); const flipped = []; for (const p of _tcpsV2.values()) if (p.status === TOPIC_CLS_PROFILE_MATURITY_V2.ACTIVE && (t - p.lastTouchedAt) >= _tcpIdleMs) { p.status = TOPIC_CLS_PROFILE_MATURITY_V2.STALE; p.updatedAt = t; flipped.push(p.id); } return { flipped, count: flipped.length }; }
+export function autoFailStuckTopicClsJobsV2({ now } = {}) { const t = now ?? Date.now(); const flipped = []; for (const j of _tcjsV2.values()) if (j.status === TOPIC_CLS_JOB_LIFECYCLE_V2.RUNNING && j.startedAt != null && (t - j.startedAt) >= _tcjStuckMs) { j.status = TOPIC_CLS_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 getTopicClassifierGovStatsV2() {
+  const profilesByStatus = {}; for (const s of Object.values(TOPIC_CLS_PROFILE_MATURITY_V2)) profilesByStatus[s] = 0; for (const p of _tcpsV2.values()) profilesByStatus[p.status]++;
+  const jobsByStatus = {}; for (const s of Object.values(TOPIC_CLS_JOB_LIFECYCLE_V2)) jobsByStatus[s] = 0; for (const j of _tcjsV2.values()) jobsByStatus[j.status]++;
+  return { totalTopicClsProfilesV2: _tcpsV2.size, totalTopicClsJobsV2: _tcjsV2.size, maxActiveTopicClsProfilesPerOwner: _tcpMaxActivePerOwner, maxPendingTopicClsJobsPerProfile: _tcpMaxPendingJobsPerProfile, topicClsProfileIdleMs: _tcpIdleMs, topicClsJobStuckMs: _tcjStuckMs, profilesByStatus, jobsByStatus };
+}

package/src/lib/user-profile.js

@@ -170,3 +170,84 @@ export async function consolidateUserProfile(llmFn) {
 // ─── Exports ────────────────────────────────────────────────────────────────
 
 export const MAX_USER_PROFILE_LENGTH = MAX_PROFILE_LENGTH;
+
+// ===== V2 Surface: User Profile governance overlay (CLI v0.141.0) =====
+export const USER_PROFILE_MATURITY_V2 = Object.freeze({
+  PENDING: "pending", ACTIVE: "active", DORMANT: "dormant", ARCHIVED: "archived",
+});
+export const USER_PREF_LIFECYCLE_V2 = Object.freeze({
+  PROPOSED: "proposed", APPLIED: "applied", REJECTED: "rejected", SUPERSEDED: "superseded", CANCELLED: "cancelled",
+});
+const _upTrans = new Map([
+  [USER_PROFILE_MATURITY_V2.PENDING, new Set([USER_PROFILE_MATURITY_V2.ACTIVE, USER_PROFILE_MATURITY_V2.ARCHIVED])],
+  [USER_PROFILE_MATURITY_V2.ACTIVE, new Set([USER_PROFILE_MATURITY_V2.DORMANT, USER_PROFILE_MATURITY_V2.ARCHIVED])],
+  [USER_PROFILE_MATURITY_V2.DORMANT, new Set([USER_PROFILE_MATURITY_V2.ACTIVE, USER_PROFILE_MATURITY_V2.ARCHIVED])],
+  [USER_PROFILE_MATURITY_V2.ARCHIVED, new Set()],
+]);
+const _upTerminal = new Set([USER_PROFILE_MATURITY_V2.ARCHIVED]);
+const _uprefTrans = new Map([
+  [USER_PREF_LIFECYCLE_V2.PROPOSED, new Set([USER_PREF_LIFECYCLE_V2.APPLIED, USER_PREF_LIFECYCLE_V2.REJECTED, USER_PREF_LIFECYCLE_V2.CANCELLED])],
+  [USER_PREF_LIFECYCLE_V2.APPLIED, new Set([USER_PREF_LIFECYCLE_V2.SUPERSEDED])],
+  [USER_PREF_LIFECYCLE_V2.REJECTED, new Set()],
+  [USER_PREF_LIFECYCLE_V2.SUPERSEDED, new Set()],
+  [USER_PREF_LIFECYCLE_V2.CANCELLED, new Set()],
+]);
+const _upsV2 = new Map();
+const _uprefsV2 = new Map();
+let _upMaxActivePerOwner = 5, _upMaxPendingPrefsPerProfile = 20, _upIdleMs = 90 * 24 * 60 * 60 * 1000, _uprefStuckMs = 7 * 24 * 60 * 60 * 1000;
+function _upPos(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 _upCheckP(from, to) { const a = _upTrans.get(from); if (!a || !a.has(to)) throw new Error(`invalid user profile transition ${from} → ${to}`); }
+function _uprefCheck(from, to) { const a = _uprefTrans.get(from); if (!a || !a.has(to)) throw new Error(`invalid user pref transition ${from} → ${to}`); }
+export function setMaxActiveUserProfilesPerOwnerV2(n) { _upMaxActivePerOwner = _upPos(n, "maxActiveUserProfilesPerOwner"); }
+export function getMaxActiveUserProfilesPerOwnerV2() { return _upMaxActivePerOwner; }
+export function setMaxPendingUserPrefsPerProfileV2(n) { _upMaxPendingPrefsPerProfile = _upPos(n, "maxPendingUserPrefsPerProfile"); }
+export function getMaxPendingUserPrefsPerProfileV2() { return _upMaxPendingPrefsPerProfile; }
+export function setUserProfileIdleMsV2(n) { _upIdleMs = _upPos(n, "userProfileIdleMs"); }
+export function getUserProfileIdleMsV2() { return _upIdleMs; }
+export function setUserPrefStuckMsV2(n) { _uprefStuckMs = _upPos(n, "userPrefStuckMs"); }
+export function getUserPrefStuckMsV2() { return _uprefStuckMs; }
+export function _resetStateUserProfileV2() { _upsV2.clear(); _uprefsV2.clear(); _upMaxActivePerOwner = 5; _upMaxPendingPrefsPerProfile = 20; _upIdleMs = 90 * 24 * 60 * 60 * 1000; _uprefStuckMs = 7 * 24 * 60 * 60 * 1000; }
+export function registerUserProfileV2({ id, owner, handle, metadata } = {}) {
+  if (!id) throw new Error("user profile id required"); if (!owner) throw new Error("user profile owner required");
+  if (_upsV2.has(id)) throw new Error(`user profile ${id} already registered`);
+  const now = Date.now();
+  const p = { id, owner, handle: handle || id, status: USER_PROFILE_MATURITY_V2.PENDING, createdAt: now, updatedAt: now, activatedAt: null, archivedAt: null, lastTouchedAt: now, metadata: { ...(metadata || {}) } };
+  _upsV2.set(id, p); return { ...p, metadata: { ...p.metadata } };
+}
+function _upCountActive(owner) { let n = 0; for (const p of _upsV2.values()) if (p.owner === owner && p.status === USER_PROFILE_MATURITY_V2.ACTIVE) n++; return n; }
+export function activateUserProfileV2(id) {
+  const p = _upsV2.get(id); if (!p) throw new Error(`user profile ${id} not found`);
+  _upCheckP(p.status, USER_PROFILE_MATURITY_V2.ACTIVE);
+  const recovery = p.status === USER_PROFILE_MATURITY_V2.DORMANT;
+  if (!recovery && _upCountActive(p.owner) >= _upMaxActivePerOwner) throw new Error(`max active user profiles for owner ${p.owner} reached`);
+  const now = Date.now(); p.status = USER_PROFILE_MATURITY_V2.ACTIVE; p.updatedAt = now; p.lastTouchedAt = now; if (!p.activatedAt) p.activatedAt = now;
+  return { ...p, metadata: { ...p.metadata } };
+}
+export function dormantUserProfileV2(id) { const p = _upsV2.get(id); if (!p) throw new Error(`user profile ${id} not found`); _upCheckP(p.status, USER_PROFILE_MATURITY_V2.DORMANT); p.status = USER_PROFILE_MATURITY_V2.DORMANT; p.updatedAt = Date.now(); return { ...p, metadata: { ...p.metadata } }; }
+export function archiveUserProfileV2(id) { const p = _upsV2.get(id); if (!p) throw new Error(`user profile ${id} not found`); _upCheckP(p.status, USER_PROFILE_MATURITY_V2.ARCHIVED); const now = Date.now(); p.status = USER_PROFILE_MATURITY_V2.ARCHIVED; p.updatedAt = now; if (!p.archivedAt) p.archivedAt = now; return { ...p, metadata: { ...p.metadata } }; }
+export function touchUserProfileV2(id) { const p = _upsV2.get(id); if (!p) throw new Error(`user profile ${id} not found`); if (_upTerminal.has(p.status)) throw new Error(`cannot touch terminal user profile ${id}`); const now = Date.now(); p.lastTouchedAt = now; p.updatedAt = now; return { ...p, metadata: { ...p.metadata } }; }
+export function getUserProfileV2(id) { const p = _upsV2.get(id); if (!p) return null; return { ...p, metadata: { ...p.metadata } }; }
+export function listUserProfilesV2() { return [..._upsV2.values()].map((p) => ({ ...p, metadata: { ...p.metadata } })); }
+function _uprefCountPending(profileId) { let n = 0; for (const r of _uprefsV2.values()) if (r.profileId === profileId && r.status === USER_PREF_LIFECYCLE_V2.PROPOSED) n++; return n; }
+export function createUserPrefV2({ id, profileId, key, metadata } = {}) {
+  if (!id) throw new Error("user pref id required"); if (!profileId) throw new Error("user pref profileId required");
+  if (_uprefsV2.has(id)) throw new Error(`user pref ${id} already exists`);
+  if (!_upsV2.has(profileId)) throw new Error(`user profile ${profileId} not found`);
+  if (_uprefCountPending(profileId) >= _upMaxPendingPrefsPerProfile) throw new Error(`max pending user prefs for profile ${profileId} reached`);
+  const now = Date.now();
+  const r = { id, profileId, key: key || "", status: USER_PREF_LIFECYCLE_V2.PROPOSED, createdAt: now, updatedAt: now, startedAt: now, settledAt: null, metadata: { ...(metadata || {}) } };
+  _uprefsV2.set(id, r); return { ...r, metadata: { ...r.metadata } };
+}
+export function applyUserPrefV2(id) { const r = _uprefsV2.get(id); if (!r) throw new Error(`user pref ${id} not found`); _uprefCheck(r.status, USER_PREF_LIFECYCLE_V2.APPLIED); const now = Date.now(); r.status = USER_PREF_LIFECYCLE_V2.APPLIED; r.updatedAt = now; if (!r.settledAt) r.settledAt = now; return { ...r, metadata: { ...r.metadata } }; }
+export function rejectUserPrefV2(id, reason) { const r = _uprefsV2.get(id); if (!r) throw new Error(`user pref ${id} not found`); _uprefCheck(r.status, USER_PREF_LIFECYCLE_V2.REJECTED); const now = Date.now(); r.status = USER_PREF_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 supersedeUserPrefV2(id) { const r = _uprefsV2.get(id); if (!r) throw new Error(`user pref ${id} not found`); _uprefCheck(r.status, USER_PREF_LIFECYCLE_V2.SUPERSEDED); const now = Date.now(); r.status = USER_PREF_LIFECYCLE_V2.SUPERSEDED; r.updatedAt = now; if (!r.settledAt) r.settledAt = now; return { ...r, metadata: { ...r.metadata } }; }
+export function cancelUserPrefV2(id, reason) { const r = _uprefsV2.get(id); if (!r) throw new Error(`user pref ${id} not found`); _uprefCheck(r.status, USER_PREF_LIFECYCLE_V2.CANCELLED); const now = Date.now(); r.status = USER_PREF_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 getUserPrefV2(id) { const r = _uprefsV2.get(id); if (!r) return null; return { ...r, metadata: { ...r.metadata } }; }
+export function listUserPrefsV2() { return [..._uprefsV2.values()].map((r) => ({ ...r, metadata: { ...r.metadata } })); }
+export function autoDormantIdleUserProfilesV2({ now } = {}) { const t = now ?? Date.now(); const flipped = []; for (const p of _upsV2.values()) if (p.status === USER_PROFILE_MATURITY_V2.ACTIVE && (t - p.lastTouchedAt) >= _upIdleMs) { p.status = USER_PROFILE_MATURITY_V2.DORMANT; p.updatedAt = t; flipped.push(p.id); } return { flipped, count: flipped.length }; }
+export function autoCancelStaleUserPrefsV2({ now } = {}) { const t = now ?? Date.now(); const flipped = []; for (const r of _uprefsV2.values()) if (r.status === USER_PREF_LIFECYCLE_V2.PROPOSED && (t - r.startedAt) >= _uprefStuckMs) { r.status = USER_PREF_LIFECYCLE_V2.CANCELLED; r.updatedAt = t; if (!r.settledAt) r.settledAt = t; r.metadata.cancelReason = "auto-cancel-stale"; flipped.push(r.id); } return { flipped, count: flipped.length }; }
+export function getUserProfileGovStatsV2() {
+  const profilesByStatus = {}; for (const v of Object.values(USER_PROFILE_MATURITY_V2)) profilesByStatus[v] = 0; for (const p of _upsV2.values()) profilesByStatus[p.status]++;
+  const prefsByStatus = {}; for (const v of Object.values(USER_PREF_LIFECYCLE_V2)) prefsByStatus[v] = 0; for (const r of _uprefsV2.values()) prefsByStatus[r.status]++;
+  return { totalUserProfilesV2: _upsV2.size, totalUserPrefsV2: _uprefsV2.size, maxActiveUserProfilesPerOwner: _upMaxActivePerOwner, maxPendingUserPrefsPerProfile: _upMaxPendingPrefsPerProfile, userProfileIdleMs: _upIdleMs, userPrefStuckMs: _uprefStuckMs, profilesByStatus, prefsByStatus };
+}

package/src/lib/version-checker.js

@@ -98,3 +98,84 @@ function filterByChannel(releases, channel) {
 }
 
 export { fetchReleases, filterByChannel };
+
+
+// =====================================================================
+// Version Checker V2 governance overlay
+// =====================================================================
+export const VCHK_PROFILE_MATURITY_V2 = Object.freeze({ PENDING: "pending", ACTIVE: "active", STALE: "stale", ARCHIVED: "archived" });
+export const VCHK_CHECK_LIFECYCLE_V2 = Object.freeze({ QUEUED: "queued", CHECKING: "checking", COMPLETED: "completed", FAILED: "failed", CANCELLED: "cancelled" });
+const _vchkPTrans = new Map([
+  [VCHK_PROFILE_MATURITY_V2.PENDING, new Set([VCHK_PROFILE_MATURITY_V2.ACTIVE, VCHK_PROFILE_MATURITY_V2.ARCHIVED])],
+  [VCHK_PROFILE_MATURITY_V2.ACTIVE, new Set([VCHK_PROFILE_MATURITY_V2.STALE, VCHK_PROFILE_MATURITY_V2.ARCHIVED])],
+  [VCHK_PROFILE_MATURITY_V2.STALE, new Set([VCHK_PROFILE_MATURITY_V2.ACTIVE, VCHK_PROFILE_MATURITY_V2.ARCHIVED])],
+  [VCHK_PROFILE_MATURITY_V2.ARCHIVED, new Set()],
+]);
+const _vchkPTerminal = new Set([VCHK_PROFILE_MATURITY_V2.ARCHIVED]);
+const _vchkCTrans = new Map([
+  [VCHK_CHECK_LIFECYCLE_V2.QUEUED, new Set([VCHK_CHECK_LIFECYCLE_V2.CHECKING, VCHK_CHECK_LIFECYCLE_V2.CANCELLED])],
+  [VCHK_CHECK_LIFECYCLE_V2.CHECKING, new Set([VCHK_CHECK_LIFECYCLE_V2.COMPLETED, VCHK_CHECK_LIFECYCLE_V2.FAILED, VCHK_CHECK_LIFECYCLE_V2.CANCELLED])],
+  [VCHK_CHECK_LIFECYCLE_V2.COMPLETED, new Set()],
+  [VCHK_CHECK_LIFECYCLE_V2.FAILED, new Set()],
+  [VCHK_CHECK_LIFECYCLE_V2.CANCELLED, new Set()],
+]);
+const _vchkPsV2 = new Map();
+const _vchkCsV2 = new Map();
+let _vchkMaxActive = 5, _vchkMaxPending = 10, _vchkIdleMs = 30 * 24 * 60 * 60 * 1000, _vchkStuckMs = 30 * 1000;
+function _vchkPos(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 _vchkCheckP(from, to) { const a = _vchkPTrans.get(from); if (!a || !a.has(to)) throw new Error(`invalid vchk profile transition ${from} → ${to}`); }
+function _vchkCheckC(from, to) { const a = _vchkCTrans.get(from); if (!a || !a.has(to)) throw new Error(`invalid vchk check transition ${from} → ${to}`); }
+function _vchkCountActive(owner) { let c = 0; for (const p of _vchkPsV2.values()) if (p.owner === owner && p.status === VCHK_PROFILE_MATURITY_V2.ACTIVE) c++; return c; }
+function _vchkCountPending(profileId) { let c = 0; for (const x of _vchkCsV2.values()) if (x.profileId === profileId && (x.status === VCHK_CHECK_LIFECYCLE_V2.QUEUED || x.status === VCHK_CHECK_LIFECYCLE_V2.CHECKING)) c++; return c; }
+export function setMaxActiveVchkProfilesPerOwnerV2(n) { _vchkMaxActive = _vchkPos(n, "maxActiveVchkProfilesPerOwner"); }
+export function getMaxActiveVchkProfilesPerOwnerV2() { return _vchkMaxActive; }
+export function setMaxPendingVchkChecksPerProfileV2(n) { _vchkMaxPending = _vchkPos(n, "maxPendingVchkChecksPerProfile"); }
+export function getMaxPendingVchkChecksPerProfileV2() { return _vchkMaxPending; }
+export function setVchkProfileIdleMsV2(n) { _vchkIdleMs = _vchkPos(n, "vchkProfileIdleMs"); }
+export function getVchkProfileIdleMsV2() { return _vchkIdleMs; }
+export function setVchkCheckStuckMsV2(n) { _vchkStuckMs = _vchkPos(n, "vchkCheckStuckMs"); }
+export function getVchkCheckStuckMsV2() { return _vchkStuckMs; }
+export function _resetStateVersionCheckerV2() { _vchkPsV2.clear(); _vchkCsV2.clear(); _vchkMaxActive = 5; _vchkMaxPending = 10; _vchkIdleMs = 30 * 24 * 60 * 60 * 1000; _vchkStuckMs = 30 * 1000; }
+export function registerVchkProfileV2({ id, owner, channel, metadata } = {}) {
+  if (!id || !owner) throw new Error("id and owner required");
+  if (_vchkPsV2.has(id)) throw new Error(`vchk profile ${id} already exists`);
+  const now = Date.now();
+  const p = { id, owner, channel: channel || "stable", status: VCHK_PROFILE_MATURITY_V2.PENDING, createdAt: now, updatedAt: now, lastTouchedAt: now, activatedAt: null, archivedAt: null, metadata: { ...(metadata || {}) } };
+  _vchkPsV2.set(id, p); return { ...p, metadata: { ...p.metadata } };
+}
+export function activateVchkProfileV2(id) {
+  const p = _vchkPsV2.get(id); if (!p) throw new Error(`vchk profile ${id} not found`);
+  const isInitial = p.status === VCHK_PROFILE_MATURITY_V2.PENDING;
+  _vchkCheckP(p.status, VCHK_PROFILE_MATURITY_V2.ACTIVE);
+  if (isInitial && _vchkCountActive(p.owner) >= _vchkMaxActive) throw new Error(`max active vchk profiles for owner ${p.owner} reached`);
+  const now = Date.now(); p.status = VCHK_PROFILE_MATURITY_V2.ACTIVE; p.updatedAt = now; p.lastTouchedAt = now;
+  if (!p.activatedAt) p.activatedAt = now;
+  return { ...p, metadata: { ...p.metadata } };
+}
+export function staleVchkProfileV2(id) { const p = _vchkPsV2.get(id); if (!p) throw new Error(`vchk profile ${id} not found`); _vchkCheckP(p.status, VCHK_PROFILE_MATURITY_V2.STALE); p.status = VCHK_PROFILE_MATURITY_V2.STALE; p.updatedAt = Date.now(); return { ...p, metadata: { ...p.metadata } }; }
+export function archiveVchkProfileV2(id) { const p = _vchkPsV2.get(id); if (!p) throw new Error(`vchk profile ${id} not found`); _vchkCheckP(p.status, VCHK_PROFILE_MATURITY_V2.ARCHIVED); const now = Date.now(); p.status = VCHK_PROFILE_MATURITY_V2.ARCHIVED; p.updatedAt = now; if (!p.archivedAt) p.archivedAt = now; return { ...p, metadata: { ...p.metadata } }; }
+export function touchVchkProfileV2(id) { const p = _vchkPsV2.get(id); if (!p) throw new Error(`vchk profile ${id} not found`); if (_vchkPTerminal.has(p.status)) throw new Error(`cannot touch terminal vchk profile ${id}`); const now = Date.now(); p.lastTouchedAt = now; p.updatedAt = now; return { ...p, metadata: { ...p.metadata } }; }
+export function getVchkProfileV2(id) { const p = _vchkPsV2.get(id); if (!p) return null; return { ...p, metadata: { ...p.metadata } }; }
+export function listVchkProfilesV2() { return [..._vchkPsV2.values()].map((p) => ({ ...p, metadata: { ...p.metadata } })); }
+export function createVchkCheckV2({ id, profileId, currentVersion, metadata } = {}) {
+  if (!id || !profileId) throw new Error("id and profileId required");
+  if (_vchkCsV2.has(id)) throw new Error(`vchk check ${id} already exists`);
+  if (!_vchkPsV2.has(profileId)) throw new Error(`vchk profile ${profileId} not found`);
+  if (_vchkCountPending(profileId) >= _vchkMaxPending) throw new Error(`max pending vchk checks for profile ${profileId} reached`);
+  const now = Date.now();
+  const c = { id, profileId, currentVersion: currentVersion || "", status: VCHK_CHECK_LIFECYCLE_V2.QUEUED, createdAt: now, updatedAt: now, startedAt: null, settledAt: null, metadata: { ...(metadata || {}) } };
+  _vchkCsV2.set(id, c); return { ...c, metadata: { ...c.metadata } };
+}
+export function checkingVchkCheckV2(id) { const c = _vchkCsV2.get(id); if (!c) throw new Error(`vchk check ${id} not found`); _vchkCheckC(c.status, VCHK_CHECK_LIFECYCLE_V2.CHECKING); const now = Date.now(); c.status = VCHK_CHECK_LIFECYCLE_V2.CHECKING; c.updatedAt = now; if (!c.startedAt) c.startedAt = now; return { ...c, metadata: { ...c.metadata } }; }
+export function completeVchkCheckV2(id) { const c = _vchkCsV2.get(id); if (!c) throw new Error(`vchk check ${id} not found`); _vchkCheckC(c.status, VCHK_CHECK_LIFECYCLE_V2.COMPLETED); const now = Date.now(); c.status = VCHK_CHECK_LIFECYCLE_V2.COMPLETED; c.updatedAt = now; if (!c.settledAt) c.settledAt = now; return { ...c, metadata: { ...c.metadata } }; }
+export function failVchkCheckV2(id, reason) { const c = _vchkCsV2.get(id); if (!c) throw new Error(`vchk check ${id} not found`); _vchkCheckC(c.status, VCHK_CHECK_LIFECYCLE_V2.FAILED); const now = Date.now(); c.status = VCHK_CHECK_LIFECYCLE_V2.FAILED; c.updatedAt = now; if (!c.settledAt) c.settledAt = now; if (reason) c.metadata.failReason = String(reason); return { ...c, metadata: { ...c.metadata } }; }
+export function cancelVchkCheckV2(id, reason) { const c = _vchkCsV2.get(id); if (!c) throw new Error(`vchk check ${id} not found`); _vchkCheckC(c.status, VCHK_CHECK_LIFECYCLE_V2.CANCELLED); const now = Date.now(); c.status = VCHK_CHECK_LIFECYCLE_V2.CANCELLED; c.updatedAt = now; if (!c.settledAt) c.settledAt = now; if (reason) c.metadata.cancelReason = String(reason); return { ...c, metadata: { ...c.metadata } }; }
+export function getVchkCheckV2(id) { const c = _vchkCsV2.get(id); if (!c) return null; return { ...c, metadata: { ...c.metadata } }; }
+export function listVchkChecksV2() { return [..._vchkCsV2.values()].map((c) => ({ ...c, metadata: { ...c.metadata } })); }
+export function autoStaleIdleVchkProfilesV2({ now } = {}) { const t = now ?? Date.now(); const flipped = []; for (const p of _vchkPsV2.values()) if (p.status === VCHK_PROFILE_MATURITY_V2.ACTIVE && (t - p.lastTouchedAt) >= _vchkIdleMs) { p.status = VCHK_PROFILE_MATURITY_V2.STALE; p.updatedAt = t; flipped.push(p.id); } return { flipped, count: flipped.length }; }
+export function autoFailStuckVchkChecksV2({ now } = {}) { const t = now ?? Date.now(); const flipped = []; for (const c of _vchkCsV2.values()) if (c.status === VCHK_CHECK_LIFECYCLE_V2.CHECKING && c.startedAt != null && (t - c.startedAt) >= _vchkStuckMs) { c.status = VCHK_CHECK_LIFECYCLE_V2.FAILED; c.updatedAt = t; if (!c.settledAt) c.settledAt = t; c.metadata.failReason = "auto-fail-stuck"; flipped.push(c.id); } return { flipped, count: flipped.length }; }
+export function getVersionCheckerGovStatsV2() {
+  const profilesByStatus = {}; for (const v of Object.values(VCHK_PROFILE_MATURITY_V2)) profilesByStatus[v] = 0; for (const p of _vchkPsV2.values()) profilesByStatus[p.status]++;
+  const checksByStatus = {}; for (const v of Object.values(VCHK_CHECK_LIFECYCLE_V2)) checksByStatus[v] = 0; for (const c of _vchkCsV2.values()) checksByStatus[c.status]++;
+  return { totalVchkProfilesV2: _vchkPsV2.size, totalVchkChecksV2: _vchkCsV2.size, maxActiveVchkProfilesPerOwner: _vchkMaxActive, maxPendingVchkChecksPerProfile: _vchkMaxPending, vchkProfileIdleMs: _vchkIdleMs, vchkCheckStuckMs: _vchkStuckMs, profilesByStatus, checksByStatus };
+}