chainlesschain 0.132.0 → 0.145.0

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

@@ -218,3 +218,362 @@ 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,336 @@ 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,
+  };
+}