chainlesschain 0.132.0 → 0.143.0

package/src/lib/pipeline-orchestrator.js

@@ -926,3 +926,108 @@ export function getStats(db) {
     deploysByStrategy: deployByStrategy,
   };
 }
+
+
+// ===== V2 Surface: Pipeline Orchestrator governance overlay (CLI v0.137.0) =====
+export const PIPELINE_MATURITY_V2 = Object.freeze({
+  PENDING: "pending", ACTIVE: "active", PAUSED: "paused", ARCHIVED: "archived",
+});
+export const PIPELINE_RUN_LIFECYCLE_V2 = Object.freeze({
+  QUEUED: "queued", RUNNING: "running", COMPLETED: "completed", FAILED: "failed", CANCELLED: "cancelled",
+});
+
+const _pipTrans = new Map([
+  [PIPELINE_MATURITY_V2.PENDING, new Set([PIPELINE_MATURITY_V2.ACTIVE, PIPELINE_MATURITY_V2.ARCHIVED])],
+  [PIPELINE_MATURITY_V2.ACTIVE, new Set([PIPELINE_MATURITY_V2.PAUSED, PIPELINE_MATURITY_V2.ARCHIVED])],
+  [PIPELINE_MATURITY_V2.PAUSED, new Set([PIPELINE_MATURITY_V2.ACTIVE, PIPELINE_MATURITY_V2.ARCHIVED])],
+  [PIPELINE_MATURITY_V2.ARCHIVED, new Set()],
+]);
+const _pipTerminal = new Set([PIPELINE_MATURITY_V2.ARCHIVED]);
+const _pipRunTrans = new Map([
+  [PIPELINE_RUN_LIFECYCLE_V2.QUEUED, new Set([PIPELINE_RUN_LIFECYCLE_V2.RUNNING, PIPELINE_RUN_LIFECYCLE_V2.CANCELLED])],
+  [PIPELINE_RUN_LIFECYCLE_V2.RUNNING, new Set([PIPELINE_RUN_LIFECYCLE_V2.COMPLETED, PIPELINE_RUN_LIFECYCLE_V2.FAILED, PIPELINE_RUN_LIFECYCLE_V2.CANCELLED])],
+  [PIPELINE_RUN_LIFECYCLE_V2.COMPLETED, new Set()],
+  [PIPELINE_RUN_LIFECYCLE_V2.FAILED, new Set()],
+  [PIPELINE_RUN_LIFECYCLE_V2.CANCELLED, new Set()],
+]);
+
+const _pips = new Map();
+const _pipRuns = new Map();
+let _pipMaxActivePerOwner = 10;
+let _pipMaxPendingPerPip = 20;
+let _pipIdleMs = 3 * 24 * 60 * 60 * 1000;
+let _pipRunStuckMs = 10 * 60 * 1000;
+
+function _pipPos(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 setMaxActivePipelinesPerOwnerV2(n) { _pipMaxActivePerOwner = _pipPos(n, "maxActivePipelinesPerOwner"); }
+export function getMaxActivePipelinesPerOwnerV2() { return _pipMaxActivePerOwner; }
+export function setMaxPendingPipelineRunsPerPipelineV2(n) { _pipMaxPendingPerPip = _pipPos(n, "maxPendingPipelineRunsPerPipeline"); }
+export function getMaxPendingPipelineRunsPerPipelineV2() { return _pipMaxPendingPerPip; }
+export function setPipelineIdleMsV2(n) { _pipIdleMs = _pipPos(n, "pipelineIdleMs"); }
+export function getPipelineIdleMsV2() { return _pipIdleMs; }
+export function setPipelineRunStuckMsV2(n) { _pipRunStuckMs = _pipPos(n, "pipelineRunStuckMs"); }
+export function getPipelineRunStuckMsV2() { return _pipRunStuckMs; }
+
+export function _resetStatePipelineOrchestratorV2() {
+  _pips.clear(); _pipRuns.clear();
+  _pipMaxActivePerOwner = 10; _pipMaxPendingPerPip = 20;
+  _pipIdleMs = 3 * 24 * 60 * 60 * 1000; _pipRunStuckMs = 10 * 60 * 1000;
+}
+
+export function registerPipelineV2({ id, owner, name, metadata } = {}) {
+  if (!id || typeof id !== "string") throw new Error("id is required");
+  if (!owner || typeof owner !== "string") throw new Error("owner is required");
+  if (_pips.has(id)) throw new Error(`pipeline ${id} already registered`);
+  const now = Date.now();
+  const p = { id, owner, name: name || id, status: PIPELINE_MATURITY_V2.PENDING, createdAt: now, updatedAt: now, activatedAt: null, archivedAt: null, lastTouchedAt: now, metadata: { ...(metadata || {}) } };
+  _pips.set(id, p);
+  return { ...p, metadata: { ...p.metadata } };
+}
+function _pipCheckP(from, to) { const a = _pipTrans.get(from); if (!a || !a.has(to)) throw new Error(`invalid pipeline transition ${from} → ${to}`); }
+function _pipCountActive(owner) { let n = 0; for (const p of _pips.values()) if (p.owner === owner && p.status === PIPELINE_MATURITY_V2.ACTIVE) n++; return n; }
+
+export function activatePipelineV2(id) {
+  const p = _pips.get(id); if (!p) throw new Error(`pipeline ${id} not found`);
+  _pipCheckP(p.status, PIPELINE_MATURITY_V2.ACTIVE);
+  const recovery = p.status === PIPELINE_MATURITY_V2.PAUSED;
+  if (!recovery) { const c = _pipCountActive(p.owner); if (c >= _pipMaxActivePerOwner) throw new Error(`max active pipelines per owner (${_pipMaxActivePerOwner}) reached for ${p.owner}`); }
+  const now = Date.now(); p.status = PIPELINE_MATURITY_V2.ACTIVE; p.updatedAt = now; p.lastTouchedAt = now; if (!p.activatedAt) p.activatedAt = now;
+  return { ...p, metadata: { ...p.metadata } };
+}
+export function pausePipelineV2(id) { const p = _pips.get(id); if (!p) throw new Error(`pipeline ${id} not found`); _pipCheckP(p.status, PIPELINE_MATURITY_V2.PAUSED); p.status = PIPELINE_MATURITY_V2.PAUSED; p.updatedAt = Date.now(); return { ...p, metadata: { ...p.metadata } }; }
+export function archivePipelineV2(id) { const p = _pips.get(id); if (!p) throw new Error(`pipeline ${id} not found`); _pipCheckP(p.status, PIPELINE_MATURITY_V2.ARCHIVED); const now = Date.now(); p.status = PIPELINE_MATURITY_V2.ARCHIVED; p.updatedAt = now; if (!p.archivedAt) p.archivedAt = now; return { ...p, metadata: { ...p.metadata } }; }
+export function touchPipelineV2(id) { const p = _pips.get(id); if (!p) throw new Error(`pipeline ${id} not found`); if (_pipTerminal.has(p.status)) throw new Error(`cannot touch terminal pipeline ${id}`); const now = Date.now(); p.lastTouchedAt = now; p.updatedAt = now; return { ...p, metadata: { ...p.metadata } }; }
+export function getPipelineV2(id) { const p = _pips.get(id); if (!p) return null; return { ...p, metadata: { ...p.metadata } }; }
+export function listPipelinesV2() { return [..._pips.values()].map((p) => ({ ...p, metadata: { ...p.metadata } })); }
+
+function _pipCountPendingRuns(pid) { let n = 0; for (const r of _pipRuns.values()) if (r.pipelineId === pid && (r.status === PIPELINE_RUN_LIFECYCLE_V2.QUEUED || r.status === PIPELINE_RUN_LIFECYCLE_V2.RUNNING)) n++; return n; }
+
+export function createPipelineRunV2({ id, pipelineId, trigger, metadata } = {}) {
+  if (!id || typeof id !== "string") throw new Error("id is required");
+  if (!pipelineId || typeof pipelineId !== "string") throw new Error("pipelineId is required");
+  if (_pipRuns.has(id)) throw new Error(`pipeline run ${id} already exists`);
+  if (!_pips.has(pipelineId)) throw new Error(`pipeline ${pipelineId} not found`);
+  const pending = _pipCountPendingRuns(pipelineId);
+  if (pending >= _pipMaxPendingPerPip) throw new Error(`max pending pipeline runs per pipeline (${_pipMaxPendingPerPip}) reached for ${pipelineId}`);
+  const now = Date.now();
+  const r = { id, pipelineId, trigger: trigger || "manual", status: PIPELINE_RUN_LIFECYCLE_V2.QUEUED, createdAt: now, updatedAt: now, startedAt: null, settledAt: null, metadata: { ...(metadata || {}) } };
+  _pipRuns.set(id, r);
+  return { ...r, metadata: { ...r.metadata } };
+}
+function _pipCheckR(from, to) { const a = _pipRunTrans.get(from); if (!a || !a.has(to)) throw new Error(`invalid pipeline run transition ${from} → ${to}`); }
+export function startPipelineRunV2(id) { const r = _pipRuns.get(id); if (!r) throw new Error(`pipeline run ${id} not found`); _pipCheckR(r.status, PIPELINE_RUN_LIFECYCLE_V2.RUNNING); const now = Date.now(); r.status = PIPELINE_RUN_LIFECYCLE_V2.RUNNING; r.updatedAt = now; if (!r.startedAt) r.startedAt = now; return { ...r, metadata: { ...r.metadata } }; }
+export function completePipelineRunV2(id) { const r = _pipRuns.get(id); if (!r) throw new Error(`pipeline run ${id} not found`); _pipCheckR(r.status, PIPELINE_RUN_LIFECYCLE_V2.COMPLETED); const now = Date.now(); r.status = PIPELINE_RUN_LIFECYCLE_V2.COMPLETED; r.updatedAt = now; if (!r.settledAt) r.settledAt = now; return { ...r, metadata: { ...r.metadata } }; }
+export function failPipelineRunV2(id, reason) { const r = _pipRuns.get(id); if (!r) throw new Error(`pipeline run ${id} not found`); _pipCheckR(r.status, PIPELINE_RUN_LIFECYCLE_V2.FAILED); const now = Date.now(); r.status = PIPELINE_RUN_LIFECYCLE_V2.FAILED; r.updatedAt = now; if (!r.settledAt) r.settledAt = now; if (reason) r.metadata.failReason = String(reason); return { ...r, metadata: { ...r.metadata } }; }
+export function cancelPipelineRunV2(id, reason) { const r = _pipRuns.get(id); if (!r) throw new Error(`pipeline run ${id} not found`); _pipCheckR(r.status, PIPELINE_RUN_LIFECYCLE_V2.CANCELLED); const now = Date.now(); r.status = PIPELINE_RUN_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 getPipelineRunV2(id) { const r = _pipRuns.get(id); if (!r) return null; return { ...r, metadata: { ...r.metadata } }; }
+export function listPipelineRunsV2() { return [..._pipRuns.values()].map((r) => ({ ...r, metadata: { ...r.metadata } })); }
+
+export function autoPauseIdlePipelinesV2({ now } = {}) { const t = now ?? Date.now(); const flipped = []; for (const p of _pips.values()) if (p.status === PIPELINE_MATURITY_V2.ACTIVE && (t - p.lastTouchedAt) >= _pipIdleMs) { p.status = PIPELINE_MATURITY_V2.PAUSED; p.updatedAt = t; flipped.push(p.id); } return { flipped, count: flipped.length }; }
+export function autoFailStuckPipelineRunsV2({ now } = {}) { const t = now ?? Date.now(); const flipped = []; for (const r of _pipRuns.values()) if (r.status === PIPELINE_RUN_LIFECYCLE_V2.RUNNING && r.startedAt != null && (t - r.startedAt) >= _pipRunStuckMs) { r.status = PIPELINE_RUN_LIFECYCLE_V2.FAILED; r.updatedAt = t; if (!r.settledAt) r.settledAt = t; r.metadata.failReason = "auto-fail-stuck"; flipped.push(r.id); } return { flipped, count: flipped.length }; }
+
+export function getPipelineOrchestratorGovStatsV2() {
+  const pipelinesByStatus = {}; for (const s of Object.values(PIPELINE_MATURITY_V2)) pipelinesByStatus[s] = 0; for (const p of _pips.values()) pipelinesByStatus[p.status]++;
+  const runsByStatus = {}; for (const s of Object.values(PIPELINE_RUN_LIFECYCLE_V2)) runsByStatus[s] = 0; for (const r of _pipRuns.values()) runsByStatus[r.status]++;
+  return { totalPipelinesV2: _pips.size, totalRunsV2: _pipRuns.size, maxActivePipelinesPerOwner: _pipMaxActivePerOwner, maxPendingPipelineRunsPerPipeline: _pipMaxPendingPerPip, pipelineIdleMs: _pipIdleMs, pipelineRunStuckMs: _pipRunStuckMs, pipelinesByStatus, runsByStatus };
+}

package/src/lib/plan-mode.js

@@ -544,3 +544,84 @@ export function destroyPlanModeManager() {
     _instance = null;
   }
 }
+
+// ===== V2 Surface: Plan Mode governance overlay (CLI v0.141.0) =====
+export const PLAN_PROFILE_MATURITY_V2 = Object.freeze({
+  PENDING: "pending", ACTIVE: "active", PAUSED: "paused", ARCHIVED: "archived",
+});
+export const PLAN_STEP_LIFECYCLE_V2 = Object.freeze({
+  QUEUED: "queued", RUNNING: "running", COMPLETED: "completed", FAILED: "failed", CANCELLED: "cancelled",
+});
+const _planPTrans = new Map([
+  [PLAN_PROFILE_MATURITY_V2.PENDING, new Set([PLAN_PROFILE_MATURITY_V2.ACTIVE, PLAN_PROFILE_MATURITY_V2.ARCHIVED])],
+  [PLAN_PROFILE_MATURITY_V2.ACTIVE, new Set([PLAN_PROFILE_MATURITY_V2.PAUSED, PLAN_PROFILE_MATURITY_V2.ARCHIVED])],
+  [PLAN_PROFILE_MATURITY_V2.PAUSED, new Set([PLAN_PROFILE_MATURITY_V2.ACTIVE, PLAN_PROFILE_MATURITY_V2.ARCHIVED])],
+  [PLAN_PROFILE_MATURITY_V2.ARCHIVED, new Set()],
+]);
+const _planPTerminal = new Set([PLAN_PROFILE_MATURITY_V2.ARCHIVED]);
+const _planSTrans = new Map([
+  [PLAN_STEP_LIFECYCLE_V2.QUEUED, new Set([PLAN_STEP_LIFECYCLE_V2.RUNNING, PLAN_STEP_LIFECYCLE_V2.CANCELLED])],
+  [PLAN_STEP_LIFECYCLE_V2.RUNNING, new Set([PLAN_STEP_LIFECYCLE_V2.COMPLETED, PLAN_STEP_LIFECYCLE_V2.FAILED, PLAN_STEP_LIFECYCLE_V2.CANCELLED])],
+  [PLAN_STEP_LIFECYCLE_V2.COMPLETED, new Set()],
+  [PLAN_STEP_LIFECYCLE_V2.FAILED, new Set()],
+  [PLAN_STEP_LIFECYCLE_V2.CANCELLED, new Set()],
+]);
+const _planPsV2 = new Map();
+const _planSsV2 = new Map();
+let _planMaxActivePerOwner = 6, _planMaxPendingStepsPerProfile = 15, _planIdleMs = 7 * 24 * 60 * 60 * 1000, _planStuckMs = 30 * 60 * 1000;
+function _planPos(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 _planCheckP(from, to) { const a = _planPTrans.get(from); if (!a || !a.has(to)) throw new Error(`invalid plan profile transition ${from} → ${to}`); }
+function _planCheckS(from, to) { const a = _planSTrans.get(from); if (!a || !a.has(to)) throw new Error(`invalid plan step transition ${from} → ${to}`); }
+export function setMaxActivePlanProfilesPerOwnerV2(n) { _planMaxActivePerOwner = _planPos(n, "maxActivePlanProfilesPerOwner"); }
+export function getMaxActivePlanProfilesPerOwnerV2() { return _planMaxActivePerOwner; }
+export function setMaxPendingPlanStepsPerProfileV2(n) { _planMaxPendingStepsPerProfile = _planPos(n, "maxPendingPlanStepsPerProfile"); }
+export function getMaxPendingPlanStepsPerProfileV2() { return _planMaxPendingStepsPerProfile; }
+export function setPlanProfileIdleMsV2(n) { _planIdleMs = _planPos(n, "planProfileIdleMs"); }
+export function getPlanProfileIdleMsV2() { return _planIdleMs; }
+export function setPlanStepStuckMsV2(n) { _planStuckMs = _planPos(n, "planStepStuckMs"); }
+export function getPlanStepStuckMsV2() { return _planStuckMs; }
+export function _resetStatePlanModeV2() { _planPsV2.clear(); _planSsV2.clear(); _planMaxActivePerOwner = 6; _planMaxPendingStepsPerProfile = 15; _planIdleMs = 7 * 24 * 60 * 60 * 1000; _planStuckMs = 30 * 60 * 1000; }
+export function registerPlanProfileV2({ id, owner, goal, metadata } = {}) {
+  if (!id) throw new Error("plan profile id required"); if (!owner) throw new Error("plan profile owner required");
+  if (_planPsV2.has(id)) throw new Error(`plan profile ${id} already registered`);
+  const now = Date.now();
+  const p = { id, owner, goal: goal || "", status: PLAN_PROFILE_MATURITY_V2.PENDING, createdAt: now, updatedAt: now, activatedAt: null, archivedAt: null, lastTouchedAt: now, metadata: { ...(metadata || {}) } };
+  _planPsV2.set(id, p); return { ...p, metadata: { ...p.metadata } };
+}
+function _planCountActive(owner) { let n = 0; for (const p of _planPsV2.values()) if (p.owner === owner && p.status === PLAN_PROFILE_MATURITY_V2.ACTIVE) n++; return n; }
+export function activatePlanProfileV2(id) {
+  const p = _planPsV2.get(id); if (!p) throw new Error(`plan profile ${id} not found`);
+  _planCheckP(p.status, PLAN_PROFILE_MATURITY_V2.ACTIVE);
+  const recovery = p.status === PLAN_PROFILE_MATURITY_V2.PAUSED;
+  if (!recovery && _planCountActive(p.owner) >= _planMaxActivePerOwner) throw new Error(`max active plan profiles for owner ${p.owner} reached`);
+  const now = Date.now(); p.status = PLAN_PROFILE_MATURITY_V2.ACTIVE; p.updatedAt = now; p.lastTouchedAt = now; if (!p.activatedAt) p.activatedAt = now;
+  return { ...p, metadata: { ...p.metadata } };
+}
+export function pausePlanProfileV2(id) { const p = _planPsV2.get(id); if (!p) throw new Error(`plan profile ${id} not found`); _planCheckP(p.status, PLAN_PROFILE_MATURITY_V2.PAUSED); p.status = PLAN_PROFILE_MATURITY_V2.PAUSED; p.updatedAt = Date.now(); return { ...p, metadata: { ...p.metadata } }; }
+export function archivePlanProfileV2(id) { const p = _planPsV2.get(id); if (!p) throw new Error(`plan profile ${id} not found`); _planCheckP(p.status, PLAN_PROFILE_MATURITY_V2.ARCHIVED); const now = Date.now(); p.status = PLAN_PROFILE_MATURITY_V2.ARCHIVED; p.updatedAt = now; if (!p.archivedAt) p.archivedAt = now; return { ...p, metadata: { ...p.metadata } }; }
+export function touchPlanProfileV2(id) { const p = _planPsV2.get(id); if (!p) throw new Error(`plan profile ${id} not found`); if (_planPTerminal.has(p.status)) throw new Error(`cannot touch terminal plan profile ${id}`); const now = Date.now(); p.lastTouchedAt = now; p.updatedAt = now; return { ...p, metadata: { ...p.metadata } }; }
+export function getPlanProfileV2(id) { const p = _planPsV2.get(id); if (!p) return null; return { ...p, metadata: { ...p.metadata } }; }
+export function listPlanProfilesV2() { return [..._planPsV2.values()].map((p) => ({ ...p, metadata: { ...p.metadata } })); }
+function _planCountPending(profileId) { let n = 0; for (const s of _planSsV2.values()) if (s.profileId === profileId && (s.status === PLAN_STEP_LIFECYCLE_V2.QUEUED || s.status === PLAN_STEP_LIFECYCLE_V2.RUNNING)) n++; return n; }
+export function createPlanStepV2({ id, profileId, action, metadata } = {}) {
+  if (!id) throw new Error("plan step id required"); if (!profileId) throw new Error("plan step profileId required");
+  if (_planSsV2.has(id)) throw new Error(`plan step ${id} already exists`);
+  if (!_planPsV2.has(profileId)) throw new Error(`plan profile ${profileId} not found`);
+  if (_planCountPending(profileId) >= _planMaxPendingStepsPerProfile) throw new Error(`max pending plan steps for profile ${profileId} reached`);
+  const now = Date.now();
+  const s = { id, profileId, action: action || "", status: PLAN_STEP_LIFECYCLE_V2.QUEUED, createdAt: now, updatedAt: now, startedAt: null, settledAt: null, metadata: { ...(metadata || {}) } };
+  _planSsV2.set(id, s); return { ...s, metadata: { ...s.metadata } };
+}
+export function startPlanStepV2(id) { const s = _planSsV2.get(id); if (!s) throw new Error(`plan step ${id} not found`); _planCheckS(s.status, PLAN_STEP_LIFECYCLE_V2.RUNNING); const now = Date.now(); s.status = PLAN_STEP_LIFECYCLE_V2.RUNNING; s.updatedAt = now; if (!s.startedAt) s.startedAt = now; return { ...s, metadata: { ...s.metadata } }; }
+export function completePlanStepV2(id) { const s = _planSsV2.get(id); if (!s) throw new Error(`plan step ${id} not found`); _planCheckS(s.status, PLAN_STEP_LIFECYCLE_V2.COMPLETED); const now = Date.now(); s.status = PLAN_STEP_LIFECYCLE_V2.COMPLETED; s.updatedAt = now; if (!s.settledAt) s.settledAt = now; return { ...s, metadata: { ...s.metadata } }; }
+export function failPlanStepV2(id, reason) { const s = _planSsV2.get(id); if (!s) throw new Error(`plan step ${id} not found`); _planCheckS(s.status, PLAN_STEP_LIFECYCLE_V2.FAILED); const now = Date.now(); s.status = PLAN_STEP_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 cancelPlanStepV2(id, reason) { const s = _planSsV2.get(id); if (!s) throw new Error(`plan step ${id} not found`); _planCheckS(s.status, PLAN_STEP_LIFECYCLE_V2.CANCELLED); const now = Date.now(); s.status = PLAN_STEP_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 getPlanStepV2(id) { const s = _planSsV2.get(id); if (!s) return null; return { ...s, metadata: { ...s.metadata } }; }
+export function listPlanStepsV2() { return [..._planSsV2.values()].map((s) => ({ ...s, metadata: { ...s.metadata } })); }
+export function autoPauseIdlePlanProfilesV2({ now } = {}) { const t = now ?? Date.now(); const flipped = []; for (const p of _planPsV2.values()) if (p.status === PLAN_PROFILE_MATURITY_V2.ACTIVE && (t - p.lastTouchedAt) >= _planIdleMs) { p.status = PLAN_PROFILE_MATURITY_V2.PAUSED; p.updatedAt = t; flipped.push(p.id); } return { flipped, count: flipped.length }; }
+export function autoFailStuckPlanStepsV2({ now } = {}) { const t = now ?? Date.now(); const flipped = []; for (const s of _planSsV2.values()) if (s.status === PLAN_STEP_LIFECYCLE_V2.RUNNING && s.startedAt != null && (t - s.startedAt) >= _planStuckMs) { s.status = PLAN_STEP_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 getPlanModeGovStatsV2() {
+  const profilesByStatus = {}; for (const v of Object.values(PLAN_PROFILE_MATURITY_V2)) profilesByStatus[v] = 0; for (const p of _planPsV2.values()) profilesByStatus[p.status]++;
+  const stepsByStatus = {}; for (const v of Object.values(PLAN_STEP_LIFECYCLE_V2)) stepsByStatus[v] = 0; for (const s of _planSsV2.values()) stepsByStatus[s.status]++;
+  return { totalPlanProfilesV2: _planPsV2.size, totalPlanStepsV2: _planSsV2.size, maxActivePlanProfilesPerOwner: _planMaxActivePerOwner, maxPendingPlanStepsPerProfile: _planMaxPendingStepsPerProfile, planProfileIdleMs: _planIdleMs, planStepStuckMs: _planStuckMs, profilesByStatus, stepsByStatus };
+}

package/src/lib/prompt-compressor.js

@@ -9,13 +9,4 @@
  * in new code.
  */
 
-export {
-  estimateTokens,
-  estimateMessagesTokens,
-  CONTEXT_WINDOWS,
-  getContextWindow,
-  COMPRESSION_VARIANTS,
-  getCompressionVariant,
-  adaptiveThresholds,
-  PromptCompressor,
-} from "../harness/prompt-compressor.js";
+export * from "../harness/prompt-compressor.js";

package/src/lib/service-container.js

@@ -181,3 +181,84 @@ export class ServiceContainer {
 export function createServiceContainer() {
   return new ServiceContainer();
 }
+
+// ===== V2 Surface: Service Container governance overlay (CLI v0.141.0) =====
+export const SVC_CONTAINER_MATURITY_V2 = Object.freeze({
+  PENDING: "pending", ACTIVE: "active", DEGRADED: "degraded", DECOMMISSIONED: "decommissioned",
+});
+export const SVC_RESOLUTION_LIFECYCLE_V2 = Object.freeze({
+  QUEUED: "queued", RESOLVING: "resolving", RESOLVED: "resolved", FAILED: "failed", CANCELLED: "cancelled",
+});
+const _svcCTrans = new Map([
+  [SVC_CONTAINER_MATURITY_V2.PENDING, new Set([SVC_CONTAINER_MATURITY_V2.ACTIVE, SVC_CONTAINER_MATURITY_V2.DECOMMISSIONED])],
+  [SVC_CONTAINER_MATURITY_V2.ACTIVE, new Set([SVC_CONTAINER_MATURITY_V2.DEGRADED, SVC_CONTAINER_MATURITY_V2.DECOMMISSIONED])],
+  [SVC_CONTAINER_MATURITY_V2.DEGRADED, new Set([SVC_CONTAINER_MATURITY_V2.ACTIVE, SVC_CONTAINER_MATURITY_V2.DECOMMISSIONED])],
+  [SVC_CONTAINER_MATURITY_V2.DECOMMISSIONED, new Set()],
+]);
+const _svcCTerminal = new Set([SVC_CONTAINER_MATURITY_V2.DECOMMISSIONED]);
+const _svcRTrans = new Map([
+  [SVC_RESOLUTION_LIFECYCLE_V2.QUEUED, new Set([SVC_RESOLUTION_LIFECYCLE_V2.RESOLVING, SVC_RESOLUTION_LIFECYCLE_V2.CANCELLED])],
+  [SVC_RESOLUTION_LIFECYCLE_V2.RESOLVING, new Set([SVC_RESOLUTION_LIFECYCLE_V2.RESOLVED, SVC_RESOLUTION_LIFECYCLE_V2.FAILED, SVC_RESOLUTION_LIFECYCLE_V2.CANCELLED])],
+  [SVC_RESOLUTION_LIFECYCLE_V2.RESOLVED, new Set()],
+  [SVC_RESOLUTION_LIFECYCLE_V2.FAILED, new Set()],
+  [SVC_RESOLUTION_LIFECYCLE_V2.CANCELLED, new Set()],
+]);
+const _svcCsV2 = new Map();
+const _svcRsV2 = new Map();
+let _svcMaxActivePerOwner = 8, _svcMaxPendingResPerContainer = 25, _svcIdleMs = 60 * 60 * 1000, _svcStuckMs = 30 * 1000;
+function _svcPos(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 _svcCheckC(from, to) { const a = _svcCTrans.get(from); if (!a || !a.has(to)) throw new Error(`invalid svc container transition ${from} → ${to}`); }
+function _svcCheckR(from, to) { const a = _svcRTrans.get(from); if (!a || !a.has(to)) throw new Error(`invalid svc resolution transition ${from} → ${to}`); }
+export function setMaxActiveSvcContainersPerOwnerV2(n) { _svcMaxActivePerOwner = _svcPos(n, "maxActiveSvcContainersPerOwner"); }
+export function getMaxActiveSvcContainersPerOwnerV2() { return _svcMaxActivePerOwner; }
+export function setMaxPendingSvcResolutionsPerContainerV2(n) { _svcMaxPendingResPerContainer = _svcPos(n, "maxPendingSvcResolutionsPerContainer"); }
+export function getMaxPendingSvcResolutionsPerContainerV2() { return _svcMaxPendingResPerContainer; }
+export function setSvcContainerIdleMsV2(n) { _svcIdleMs = _svcPos(n, "svcContainerIdleMs"); }
+export function getSvcContainerIdleMsV2() { return _svcIdleMs; }
+export function setSvcResolutionStuckMsV2(n) { _svcStuckMs = _svcPos(n, "svcResolutionStuckMs"); }
+export function getSvcResolutionStuckMsV2() { return _svcStuckMs; }
+export function _resetStateServiceContainerV2() { _svcCsV2.clear(); _svcRsV2.clear(); _svcMaxActivePerOwner = 8; _svcMaxPendingResPerContainer = 25; _svcIdleMs = 60 * 60 * 1000; _svcStuckMs = 30 * 1000; }
+export function registerSvcContainerV2({ id, owner, scope, metadata } = {}) {
+  if (!id) throw new Error("svc container id required"); if (!owner) throw new Error("svc container owner required");
+  if (_svcCsV2.has(id)) throw new Error(`svc container ${id} already registered`);
+  const now = Date.now();
+  const c = { id, owner, scope: scope || "default", status: SVC_CONTAINER_MATURITY_V2.PENDING, createdAt: now, updatedAt: now, activatedAt: null, decommissionedAt: null, lastTouchedAt: now, metadata: { ...(metadata || {}) } };
+  _svcCsV2.set(id, c); return { ...c, metadata: { ...c.metadata } };
+}
+function _svcCountActive(owner) { let n = 0; for (const c of _svcCsV2.values()) if (c.owner === owner && c.status === SVC_CONTAINER_MATURITY_V2.ACTIVE) n++; return n; }
+export function activateSvcContainerV2(id) {
+  const c = _svcCsV2.get(id); if (!c) throw new Error(`svc container ${id} not found`);
+  _svcCheckC(c.status, SVC_CONTAINER_MATURITY_V2.ACTIVE);
+  const recovery = c.status === SVC_CONTAINER_MATURITY_V2.DEGRADED;
+  if (!recovery && _svcCountActive(c.owner) >= _svcMaxActivePerOwner) throw new Error(`max active svc containers for owner ${c.owner} reached`);
+  const now = Date.now(); c.status = SVC_CONTAINER_MATURITY_V2.ACTIVE; c.updatedAt = now; c.lastTouchedAt = now; if (!c.activatedAt) c.activatedAt = now;
+  return { ...c, metadata: { ...c.metadata } };
+}
+export function degradeSvcContainerV2(id) { const c = _svcCsV2.get(id); if (!c) throw new Error(`svc container ${id} not found`); _svcCheckC(c.status, SVC_CONTAINER_MATURITY_V2.DEGRADED); c.status = SVC_CONTAINER_MATURITY_V2.DEGRADED; c.updatedAt = Date.now(); return { ...c, metadata: { ...c.metadata } }; }
+export function decommissionSvcContainerV2(id) { const c = _svcCsV2.get(id); if (!c) throw new Error(`svc container ${id} not found`); _svcCheckC(c.status, SVC_CONTAINER_MATURITY_V2.DECOMMISSIONED); const now = Date.now(); c.status = SVC_CONTAINER_MATURITY_V2.DECOMMISSIONED; c.updatedAt = now; if (!c.decommissionedAt) c.decommissionedAt = now; return { ...c, metadata: { ...c.metadata } }; }
+export function touchSvcContainerV2(id) { const c = _svcCsV2.get(id); if (!c) throw new Error(`svc container ${id} not found`); if (_svcCTerminal.has(c.status)) throw new Error(`cannot touch terminal svc container ${id}`); const now = Date.now(); c.lastTouchedAt = now; c.updatedAt = now; return { ...c, metadata: { ...c.metadata } }; }
+export function getSvcContainerV2(id) { const c = _svcCsV2.get(id); if (!c) return null; return { ...c, metadata: { ...c.metadata } }; }
+export function listSvcContainersV2() { return [..._svcCsV2.values()].map((c) => ({ ...c, metadata: { ...c.metadata } })); }
+function _svcCountPending(containerId) { let n = 0; for (const r of _svcRsV2.values()) if (r.containerId === containerId && (r.status === SVC_RESOLUTION_LIFECYCLE_V2.QUEUED || r.status === SVC_RESOLUTION_LIFECYCLE_V2.RESOLVING)) n++; return n; }
+export function createSvcResolutionV2({ id, containerId, token, metadata } = {}) {
+  if (!id) throw new Error("svc resolution id required"); if (!containerId) throw new Error("svc resolution containerId required");
+  if (_svcRsV2.has(id)) throw new Error(`svc resolution ${id} already exists`);
+  if (!_svcCsV2.has(containerId)) throw new Error(`svc container ${containerId} not found`);
+  if (_svcCountPending(containerId) >= _svcMaxPendingResPerContainer) throw new Error(`max pending svc resolutions for container ${containerId} reached`);
+  const now = Date.now();
+  const r = { id, containerId, token: token || "", status: SVC_RESOLUTION_LIFECYCLE_V2.QUEUED, createdAt: now, updatedAt: now, startedAt: null, settledAt: null, metadata: { ...(metadata || {}) } };
+  _svcRsV2.set(id, r); return { ...r, metadata: { ...r.metadata } };
+}
+export function resolvingSvcResolutionV2(id) { const r = _svcRsV2.get(id); if (!r) throw new Error(`svc resolution ${id} not found`); _svcCheckR(r.status, SVC_RESOLUTION_LIFECYCLE_V2.RESOLVING); const now = Date.now(); r.status = SVC_RESOLUTION_LIFECYCLE_V2.RESOLVING; r.updatedAt = now; if (!r.startedAt) r.startedAt = now; return { ...r, metadata: { ...r.metadata } }; }
+export function resolveSvcResolutionV2(id) { const r = _svcRsV2.get(id); if (!r) throw new Error(`svc resolution ${id} not found`); _svcCheckR(r.status, SVC_RESOLUTION_LIFECYCLE_V2.RESOLVED); const now = Date.now(); r.status = SVC_RESOLUTION_LIFECYCLE_V2.RESOLVED; r.updatedAt = now; if (!r.settledAt) r.settledAt = now; return { ...r, metadata: { ...r.metadata } }; }
+export function failSvcResolutionV2(id, reason) { const r = _svcRsV2.get(id); if (!r) throw new Error(`svc resolution ${id} not found`); _svcCheckR(r.status, SVC_RESOLUTION_LIFECYCLE_V2.FAILED); const now = Date.now(); r.status = SVC_RESOLUTION_LIFECYCLE_V2.FAILED; r.updatedAt = now; if (!r.settledAt) r.settledAt = now; if (reason) r.metadata.failReason = String(reason); return { ...r, metadata: { ...r.metadata } }; }
+export function cancelSvcResolutionV2(id, reason) { const r = _svcRsV2.get(id); if (!r) throw new Error(`svc resolution ${id} not found`); _svcCheckR(r.status, SVC_RESOLUTION_LIFECYCLE_V2.CANCELLED); const now = Date.now(); r.status = SVC_RESOLUTION_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 getSvcResolutionV2(id) { const r = _svcRsV2.get(id); if (!r) return null; return { ...r, metadata: { ...r.metadata } }; }
+export function listSvcResolutionsV2() { return [..._svcRsV2.values()].map((r) => ({ ...r, metadata: { ...r.metadata } })); }
+export function autoDegradeIdleSvcContainersV2({ now } = {}) { const t = now ?? Date.now(); const flipped = []; for (const c of _svcCsV2.values()) if (c.status === SVC_CONTAINER_MATURITY_V2.ACTIVE && (t - c.lastTouchedAt) >= _svcIdleMs) { c.status = SVC_CONTAINER_MATURITY_V2.DEGRADED; c.updatedAt = t; flipped.push(c.id); } return { flipped, count: flipped.length }; }
+export function autoFailStuckSvcResolutionsV2({ now } = {}) { const t = now ?? Date.now(); const flipped = []; for (const r of _svcRsV2.values()) if (r.status === SVC_RESOLUTION_LIFECYCLE_V2.RESOLVING && r.startedAt != null && (t - r.startedAt) >= _svcStuckMs) { r.status = SVC_RESOLUTION_LIFECYCLE_V2.FAILED; r.updatedAt = t; if (!r.settledAt) r.settledAt = t; r.metadata.failReason = "auto-fail-stuck"; flipped.push(r.id); } return { flipped, count: flipped.length }; }
+export function getServiceContainerGovStatsV2() {
+  const containersByStatus = {}; for (const v of Object.values(SVC_CONTAINER_MATURITY_V2)) containersByStatus[v] = 0; for (const c of _svcCsV2.values()) containersByStatus[c.status]++;
+  const resolutionsByStatus = {}; for (const v of Object.values(SVC_RESOLUTION_LIFECYCLE_V2)) resolutionsByStatus[v] = 0; for (const r of _svcRsV2.values()) resolutionsByStatus[r.status]++;
+  return { totalSvcContainersV2: _svcCsV2.size, totalSvcResolutionsV2: _svcRsV2.size, maxActiveSvcContainersPerOwner: _svcMaxActivePerOwner, maxPendingSvcResolutionsPerContainer: _svcMaxPendingResPerContainer, svcContainerIdleMs: _svcIdleMs, svcResolutionStuckMs: _svcStuckMs, containersByStatus, resolutionsByStatus };
+}

package/src/lib/session-consolidator.js

@@ -123,3 +123,108 @@ 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,84 @@ 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 };
+}

package/src/lib/session-search.js

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