chainlesschain 0.81.0 → 0.143.0

package/src/lib/nl-programming.js

@@ -593,3 +593,346 @@ export function _resetState() {
   _translations.clear();
   _conventions.clear();
 }
+
+/* ═════════════════════════════════════════════════════════ *
+ *  Phase 28 V2 — Spec Maturity + Dialogue Lifecycle
+ * ═════════════════════════════════════════════════════════ */
+
+export const SPEC_MATURITY_V2 = Object.freeze({
+  DRAFT: "draft",
+  REFINING: "refining",
+  APPROVED: "approved",
+  IMPLEMENTED: "implemented",
+  ARCHIVED: "archived",
+});
+
+export const DIALOGUE_TURN_V2 = Object.freeze({
+  PENDING: "pending",
+  ANSWERED: "answered",
+  DISMISSED: "dismissed",
+  ESCALATED: "escalated",
+});
+
+const SPEC_TRANSITIONS_V2 = new Map([
+  ["draft", new Set(["refining", "approved", "archived"])],
+  ["refining", new Set(["draft", "approved", "archived"])],
+  ["approved", new Set(["refining", "implemented", "archived"])],
+  ["implemented", new Set(["archived"])],
+]);
+const SPEC_TERMINALS_V2 = new Set(["archived"]);
+
+const DIALOGUE_TRANSITIONS_V2 = new Map([
+  ["pending", new Set(["answered", "dismissed", "escalated"])],
+  ["escalated", new Set(["answered", "dismissed"])],
+]);
+const DIALOGUE_TERMINALS_V2 = new Set(["answered", "dismissed"]);
+
+export const NLPROG_DEFAULT_MAX_ACTIVE_SPECS_PER_AUTHOR = 30;
+export const NLPROG_DEFAULT_MAX_PENDING_TURNS_PER_SPEC = 20;
+export const NLPROG_DEFAULT_SPEC_IDLE_MS = 45 * 86400000; // 45d
+export const NLPROG_DEFAULT_TURN_PENDING_MS = 7 * 86400000; // 7d
+
+let _maxActiveSpecsPerAuthorV2 = NLPROG_DEFAULT_MAX_ACTIVE_SPECS_PER_AUTHOR;
+let _maxPendingTurnsPerSpecV2 = NLPROG_DEFAULT_MAX_PENDING_TURNS_PER_SPEC;
+let _specIdleMsV2 = NLPROG_DEFAULT_SPEC_IDLE_MS;
+let _turnPendingMsV2 = NLPROG_DEFAULT_TURN_PENDING_MS;
+
+function _positiveIntV2(n, label) {
+  const v = Math.floor(Number(n));
+  if (!Number.isFinite(v) || v <= 0)
+    throw new Error(`${label} must be a positive integer`);
+  return v;
+}
+
+export function getDefaultMaxActiveSpecsPerAuthorV2() {
+  return NLPROG_DEFAULT_MAX_ACTIVE_SPECS_PER_AUTHOR;
+}
+export function getMaxActiveSpecsPerAuthorV2() {
+  return _maxActiveSpecsPerAuthorV2;
+}
+export function setMaxActiveSpecsPerAuthorV2(n) {
+  return (_maxActiveSpecsPerAuthorV2 = _positiveIntV2(
+    n,
+    "maxActiveSpecsPerAuthor",
+  ));
+}
+export function getDefaultMaxPendingTurnsPerSpecV2() {
+  return NLPROG_DEFAULT_MAX_PENDING_TURNS_PER_SPEC;
+}
+export function getMaxPendingTurnsPerSpecV2() {
+  return _maxPendingTurnsPerSpecV2;
+}
+export function setMaxPendingTurnsPerSpecV2(n) {
+  return (_maxPendingTurnsPerSpecV2 = _positiveIntV2(
+    n,
+    "maxPendingTurnsPerSpec",
+  ));
+}
+export function getDefaultSpecIdleMsV2() {
+  return NLPROG_DEFAULT_SPEC_IDLE_MS;
+}
+export function getSpecIdleMsV2() {
+  return _specIdleMsV2;
+}
+export function setSpecIdleMsV2(ms) {
+  return (_specIdleMsV2 = _positiveIntV2(ms, "specIdleMs"));
+}
+export function getDefaultTurnPendingMsV2() {
+  return NLPROG_DEFAULT_TURN_PENDING_MS;
+}
+export function getTurnPendingMsV2() {
+  return _turnPendingMsV2;
+}
+export function setTurnPendingMsV2(ms) {
+  return (_turnPendingMsV2 = _positiveIntV2(ms, "turnPendingMs"));
+}
+
+const _specsV2 = new Map();
+const _turnsV2 = new Map();
+
+function _isActiveSpec(s) {
+  return (
+    s === SPEC_MATURITY_V2.DRAFT ||
+    s === SPEC_MATURITY_V2.REFINING ||
+    s === SPEC_MATURITY_V2.APPROVED
+  );
+}
+
+export function registerSpecV2(
+  _db,
+  { specId, authorId, title, initialStatus, metadata } = {},
+) {
+  if (!specId) throw new Error("specId is required");
+  if (!authorId) throw new Error("authorId is required");
+  if (_specsV2.has(specId)) throw new Error(`Spec ${specId} already exists`);
+  const status = initialStatus || SPEC_MATURITY_V2.DRAFT;
+  if (!Object.values(SPEC_MATURITY_V2).includes(status))
+    throw new Error(`Invalid initial status: ${status}`);
+  if (SPEC_TERMINALS_V2.has(status))
+    throw new Error(`Cannot register in terminal status: ${status}`);
+  if (_isActiveSpec(status)) {
+    if (getActiveSpecCount(authorId) >= _maxActiveSpecsPerAuthorV2)
+      throw new Error(
+        `Author ${authorId} reached active-spec cap (${_maxActiveSpecsPerAuthorV2})`,
+      );
+  }
+  const now = _now();
+  const record = {
+    specId,
+    authorId,
+    title: title || "",
+    status,
+    metadata: metadata || {},
+    createdAt: now,
+    updatedAt: now,
+    lastActivityAt: now,
+  };
+  _specsV2.set(specId, record);
+  return { ...record, metadata: { ...record.metadata } };
+}
+
+export function getSpecV2(specId) {
+  const r = _specsV2.get(specId);
+  return r ? { ...r, metadata: { ...r.metadata } } : null;
+}
+
+export function setSpecMaturityV2(_db, specId, newStatus, patch = {}) {
+  const record = _specsV2.get(specId);
+  if (!record) throw new Error(`Unknown spec: ${specId}`);
+  if (!Object.values(SPEC_MATURITY_V2).includes(newStatus))
+    throw new Error(`Invalid status: ${newStatus}`);
+  const allowed = SPEC_TRANSITIONS_V2.get(record.status) || new Set();
+  if (!allowed.has(newStatus))
+    throw new Error(`Invalid transition: ${record.status} -> ${newStatus}`);
+  if (_isActiveSpec(newStatus) && !_isActiveSpec(record.status)) {
+    if (getActiveSpecCount(record.authorId) >= _maxActiveSpecsPerAuthorV2)
+      throw new Error(
+        `Author ${record.authorId} reached active-spec cap (${_maxActiveSpecsPerAuthorV2})`,
+      );
+  }
+  record.status = newStatus;
+  record.updatedAt = _now();
+  if (patch.reason !== undefined) record.lastReason = patch.reason;
+  if (patch.metadata)
+    record.metadata = { ...record.metadata, ...patch.metadata };
+  return { ...record, metadata: { ...record.metadata } };
+}
+
+export function refineSpec(db, id, reason) {
+  return setSpecMaturityV2(db, id, SPEC_MATURITY_V2.REFINING, { reason });
+}
+export function approveSpec(db, id, reason) {
+  return setSpecMaturityV2(db, id, SPEC_MATURITY_V2.APPROVED, { reason });
+}
+export function implementSpec(db, id, reason) {
+  return setSpecMaturityV2(db, id, SPEC_MATURITY_V2.IMPLEMENTED, { reason });
+}
+export function archiveSpec(db, id, reason) {
+  return setSpecMaturityV2(db, id, SPEC_MATURITY_V2.ARCHIVED, { reason });
+}
+
+export function touchSpecActivity(specId) {
+  const record = _specsV2.get(specId);
+  if (!record) throw new Error(`Unknown spec: ${specId}`);
+  record.lastActivityAt = _now();
+  record.updatedAt = record.lastActivityAt;
+  return { ...record, metadata: { ...record.metadata } };
+}
+
+export function registerDialogueTurnV2(
+  _db,
+  { turnId, specId, role, question, initialStatus, metadata } = {},
+) {
+  if (!turnId) throw new Error("turnId is required");
+  if (!specId) throw new Error("specId is required");
+  if (!_specsV2.has(specId)) throw new Error(`Unknown spec: ${specId}`);
+  if (_turnsV2.has(turnId)) throw new Error(`Turn ${turnId} already exists`);
+  const status = initialStatus || DIALOGUE_TURN_V2.PENDING;
+  if (!Object.values(DIALOGUE_TURN_V2).includes(status))
+    throw new Error(`Invalid initial status: ${status}`);
+  if (DIALOGUE_TERMINALS_V2.has(status))
+    throw new Error(`Cannot register in terminal status: ${status}`);
+  if (status === DIALOGUE_TURN_V2.PENDING) {
+    if (getPendingTurnCount(specId) >= _maxPendingTurnsPerSpecV2)
+      throw new Error(
+        `Spec ${specId} reached pending-turn cap (${_maxPendingTurnsPerSpecV2})`,
+      );
+  }
+  const now = _now();
+  const record = {
+    turnId,
+    specId,
+    role: role || "user",
+    question: question || "",
+    status,
+    metadata: metadata || {},
+    createdAt: now,
+    updatedAt: now,
+  };
+  _turnsV2.set(turnId, record);
+  return { ...record, metadata: { ...record.metadata } };
+}
+
+export function getDialogueTurnV2(turnId) {
+  const r = _turnsV2.get(turnId);
+  return r ? { ...r, metadata: { ...r.metadata } } : null;
+}
+
+export function setDialogueTurnStatusV2(_db, turnId, newStatus, patch = {}) {
+  const record = _turnsV2.get(turnId);
+  if (!record) throw new Error(`Unknown turn: ${turnId}`);
+  if (!Object.values(DIALOGUE_TURN_V2).includes(newStatus))
+    throw new Error(`Invalid status: ${newStatus}`);
+  const allowed = DIALOGUE_TRANSITIONS_V2.get(record.status) || new Set();
+  if (!allowed.has(newStatus))
+    throw new Error(`Invalid transition: ${record.status} -> ${newStatus}`);
+  record.status = newStatus;
+  record.updatedAt = _now();
+  if (patch.answer !== undefined) record.answer = patch.answer;
+  if (patch.reason !== undefined) record.lastReason = patch.reason;
+  if (patch.metadata)
+    record.metadata = { ...record.metadata, ...patch.metadata };
+  return { ...record, metadata: { ...record.metadata } };
+}
+
+export function answerTurn(db, id, answer, reason) {
+  return setDialogueTurnStatusV2(db, id, DIALOGUE_TURN_V2.ANSWERED, {
+    answer,
+    reason,
+  });
+}
+export function dismissTurn(db, id, reason) {
+  return setDialogueTurnStatusV2(db, id, DIALOGUE_TURN_V2.DISMISSED, {
+    reason,
+  });
+}
+export function escalateTurn(db, id, reason) {
+  return setDialogueTurnStatusV2(db, id, DIALOGUE_TURN_V2.ESCALATED, {
+    reason,
+  });
+}
+
+export function getActiveSpecCount(authorId) {
+  let n = 0;
+  for (const r of _specsV2.values()) {
+    if (!_isActiveSpec(r.status)) continue;
+    if (authorId && r.authorId !== authorId) continue;
+    n++;
+  }
+  return n;
+}
+
+export function getPendingTurnCount(specId) {
+  let n = 0;
+  for (const r of _turnsV2.values()) {
+    if (r.status !== DIALOGUE_TURN_V2.PENDING) continue;
+    if (specId && r.specId !== specId) continue;
+    n++;
+  }
+  return n;
+}
+
+export function autoArchiveIdleSpecs(_db, nowMs) {
+  const now = nowMs ?? _now();
+  const flipped = [];
+  for (const r of _specsV2.values()) {
+    if (
+      r.status === SPEC_MATURITY_V2.DRAFT ||
+      r.status === SPEC_MATURITY_V2.REFINING ||
+      r.status === SPEC_MATURITY_V2.APPROVED ||
+      r.status === SPEC_MATURITY_V2.IMPLEMENTED
+    ) {
+      if (now - r.lastActivityAt > _specIdleMsV2) {
+        r.status = SPEC_MATURITY_V2.ARCHIVED;
+        r.updatedAt = now;
+        r.lastReason = "idle";
+        flipped.push(r.specId);
+      }
+    }
+  }
+  return { flipped, count: flipped.length };
+}
+
+export function autoDismissStalePendingTurns(_db, nowMs) {
+  const now = nowMs ?? _now();
+  const flipped = [];
+  for (const r of _turnsV2.values()) {
+    if (r.status === DIALOGUE_TURN_V2.PENDING) {
+      if (now - r.createdAt > _turnPendingMsV2) {
+        r.status = DIALOGUE_TURN_V2.DISMISSED;
+        r.updatedAt = now;
+        r.lastReason = "pending_timeout";
+        flipped.push(r.turnId);
+      }
+    }
+  }
+  return { flipped, count: flipped.length };
+}
+
+export function getNlProgrammingStatsV2() {
+  const specsByStatus = {};
+  for (const s of Object.values(SPEC_MATURITY_V2)) specsByStatus[s] = 0;
+  const turnsByStatus = {};
+  for (const s of Object.values(DIALOGUE_TURN_V2)) turnsByStatus[s] = 0;
+  for (const r of _specsV2.values()) specsByStatus[r.status]++;
+  for (const r of _turnsV2.values()) turnsByStatus[r.status]++;
+  return {
+    totalSpecsV2: _specsV2.size,
+    totalTurnsV2: _turnsV2.size,
+    maxActiveSpecsPerAuthor: _maxActiveSpecsPerAuthorV2,
+    maxPendingTurnsPerSpec: _maxPendingTurnsPerSpecV2,
+    specIdleMs: _specIdleMsV2,
+    turnPendingMs: _turnPendingMsV2,
+    specsByStatus,
+    turnsByStatus,
+  };
+}
+
+export function _resetStateV2() {
+  _maxActiveSpecsPerAuthorV2 = NLPROG_DEFAULT_MAX_ACTIVE_SPECS_PER_AUTHOR;
+  _maxPendingTurnsPerSpecV2 = NLPROG_DEFAULT_MAX_PENDING_TURNS_PER_SPEC;
+  _specIdleMsV2 = NLPROG_DEFAULT_SPEC_IDLE_MS;
+  _turnPendingMsV2 = NLPROG_DEFAULT_TURN_PENDING_MS;
+  _specsV2.clear();
+  _turnsV2.clear();
+}

package/src/lib/nostr-bridge.js

@@ -369,3 +369,108 @@ export function _resetState() {
   _keypairs.clear();
   _didMappings.clear();
 }
+
+
+// ===== V2 Surface: Nostr Bridge governance overlay (CLI v0.134.0) =====
+export const NOSTR_RELAY_MATURITY_V2 = Object.freeze({
+  PENDING: "pending", ACTIVE: "active", OFFLINE: "offline", RETIRED: "retired",
+});
+export const NOSTR_EVENT_LIFECYCLE_V2 = Object.freeze({
+  QUEUED: "queued", PUBLISHING: "publishing", PUBLISHED: "published", FAILED: "failed", CANCELLED: "cancelled",
+});
+
+const _nsRelayTrans = new Map([
+  [NOSTR_RELAY_MATURITY_V2.PENDING, new Set([NOSTR_RELAY_MATURITY_V2.ACTIVE, NOSTR_RELAY_MATURITY_V2.RETIRED])],
+  [NOSTR_RELAY_MATURITY_V2.ACTIVE, new Set([NOSTR_RELAY_MATURITY_V2.OFFLINE, NOSTR_RELAY_MATURITY_V2.RETIRED])],
+  [NOSTR_RELAY_MATURITY_V2.OFFLINE, new Set([NOSTR_RELAY_MATURITY_V2.ACTIVE, NOSTR_RELAY_MATURITY_V2.RETIRED])],
+  [NOSTR_RELAY_MATURITY_V2.RETIRED, new Set()],
+]);
+const _nsRelayTerminal = new Set([NOSTR_RELAY_MATURITY_V2.RETIRED]);
+const _nsEventTrans = new Map([
+  [NOSTR_EVENT_LIFECYCLE_V2.QUEUED, new Set([NOSTR_EVENT_LIFECYCLE_V2.PUBLISHING, NOSTR_EVENT_LIFECYCLE_V2.CANCELLED])],
+  [NOSTR_EVENT_LIFECYCLE_V2.PUBLISHING, new Set([NOSTR_EVENT_LIFECYCLE_V2.PUBLISHED, NOSTR_EVENT_LIFECYCLE_V2.FAILED, NOSTR_EVENT_LIFECYCLE_V2.CANCELLED])],
+  [NOSTR_EVENT_LIFECYCLE_V2.PUBLISHED, new Set()],
+  [NOSTR_EVENT_LIFECYCLE_V2.FAILED, new Set()],
+  [NOSTR_EVENT_LIFECYCLE_V2.CANCELLED, new Set()],
+]);
+
+const _nsRelays = new Map();
+const _nsEvents = new Map();
+let _nsMaxActivePerOwner = 10;
+let _nsMaxPendingPerRelay = 30;
+let _nsRelayIdleMs = 60 * 60 * 1000;
+let _nsEventStuckMs = 2 * 60 * 1000;
+
+function _nsPos(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 setMaxActiveNostrRelaysPerOwnerV2(n) { _nsMaxActivePerOwner = _nsPos(n, "maxActiveNostrRelaysPerOwner"); }
+export function getMaxActiveNostrRelaysPerOwnerV2() { return _nsMaxActivePerOwner; }
+export function setMaxPendingNostrEventsPerRelayV2(n) { _nsMaxPendingPerRelay = _nsPos(n, "maxPendingNostrEventsPerRelay"); }
+export function getMaxPendingNostrEventsPerRelayV2() { return _nsMaxPendingPerRelay; }
+export function setNostrRelayIdleMsV2(n) { _nsRelayIdleMs = _nsPos(n, "nostrRelayIdleMs"); }
+export function getNostrRelayIdleMsV2() { return _nsRelayIdleMs; }
+export function setNostrEventStuckMsV2(n) { _nsEventStuckMs = _nsPos(n, "nostrEventStuckMs"); }
+export function getNostrEventStuckMsV2() { return _nsEventStuckMs; }
+
+export function _resetStateNostrBridgeV2() {
+  _nsRelays.clear(); _nsEvents.clear();
+  _nsMaxActivePerOwner = 10; _nsMaxPendingPerRelay = 30;
+  _nsRelayIdleMs = 60 * 60 * 1000; _nsEventStuckMs = 2 * 60 * 1000;
+}
+
+export function registerNostrRelayV2({ id, owner, url, metadata } = {}) {
+  if (!id || typeof id !== "string") throw new Error("id is required");
+  if (!owner || typeof owner !== "string") throw new Error("owner is required");
+  if (_nsRelays.has(id)) throw new Error(`nostr relay ${id} already registered`);
+  const now = Date.now();
+  const r = { id, owner, url: url || "", status: NOSTR_RELAY_MATURITY_V2.PENDING, createdAt: now, updatedAt: now, activatedAt: null, retiredAt: null, lastTouchedAt: now, metadata: { ...(metadata || {}) } };
+  _nsRelays.set(id, r);
+  return { ...r, metadata: { ...r.metadata } };
+}
+function _nsCheckR(from, to) { const a = _nsRelayTrans.get(from); if (!a || !a.has(to)) throw new Error(`invalid nostr relay transition ${from} → ${to}`); }
+function _nsCountActive(owner) { let n = 0; for (const r of _nsRelays.values()) if (r.owner === owner && r.status === NOSTR_RELAY_MATURITY_V2.ACTIVE) n++; return n; }
+
+export function activateNostrRelayV2(id) {
+  const r = _nsRelays.get(id); if (!r) throw new Error(`nostr relay ${id} not found`);
+  _nsCheckR(r.status, NOSTR_RELAY_MATURITY_V2.ACTIVE);
+  const recovery = r.status === NOSTR_RELAY_MATURITY_V2.OFFLINE;
+  if (!recovery) { const a = _nsCountActive(r.owner); if (a >= _nsMaxActivePerOwner) throw new Error(`max active nostr relays per owner (${_nsMaxActivePerOwner}) reached for ${r.owner}`); }
+  const now = Date.now(); r.status = NOSTR_RELAY_MATURITY_V2.ACTIVE; r.updatedAt = now; r.lastTouchedAt = now; if (!r.activatedAt) r.activatedAt = now;
+  return { ...r, metadata: { ...r.metadata } };
+}
+export function offlineNostrRelayV2(id) { const r = _nsRelays.get(id); if (!r) throw new Error(`nostr relay ${id} not found`); _nsCheckR(r.status, NOSTR_RELAY_MATURITY_V2.OFFLINE); r.status = NOSTR_RELAY_MATURITY_V2.OFFLINE; r.updatedAt = Date.now(); return { ...r, metadata: { ...r.metadata } }; }
+export function retireNostrRelayV2(id) { const r = _nsRelays.get(id); if (!r) throw new Error(`nostr relay ${id} not found`); _nsCheckR(r.status, NOSTR_RELAY_MATURITY_V2.RETIRED); const now = Date.now(); r.status = NOSTR_RELAY_MATURITY_V2.RETIRED; r.updatedAt = now; if (!r.retiredAt) r.retiredAt = now; return { ...r, metadata: { ...r.metadata } }; }
+export function touchNostrRelayV2(id) { const r = _nsRelays.get(id); if (!r) throw new Error(`nostr relay ${id} not found`); if (_nsRelayTerminal.has(r.status)) throw new Error(`cannot touch terminal nostr relay ${id}`); const now = Date.now(); r.lastTouchedAt = now; r.updatedAt = now; return { ...r, metadata: { ...r.metadata } }; }
+export function getNostrRelayV2(id) { const r = _nsRelays.get(id); if (!r) return null; return { ...r, metadata: { ...r.metadata } }; }
+export function listNostrRelaysV2() { return [..._nsRelays.values()].map((r) => ({ ...r, metadata: { ...r.metadata } })); }
+
+function _nsCountPending(rid) { let n = 0; for (const e of _nsEvents.values()) if (e.relayId === rid && (e.status === NOSTR_EVENT_LIFECYCLE_V2.QUEUED || e.status === NOSTR_EVENT_LIFECYCLE_V2.PUBLISHING)) n++; return n; }
+
+export function createNostrEventV2({ id, relayId, kind, metadata } = {}) {
+  if (!id || typeof id !== "string") throw new Error("id is required");
+  if (!relayId || typeof relayId !== "string") throw new Error("relayId is required");
+  if (_nsEvents.has(id)) throw new Error(`nostr event ${id} already exists`);
+  if (!_nsRelays.has(relayId)) throw new Error(`nostr relay ${relayId} not found`);
+  const pending = _nsCountPending(relayId);
+  if (pending >= _nsMaxPendingPerRelay) throw new Error(`max pending nostr events per relay (${_nsMaxPendingPerRelay}) reached for ${relayId}`);
+  const now = Date.now();
+  const e = { id, relayId, kind: typeof kind === "number" ? kind : 1, status: NOSTR_EVENT_LIFECYCLE_V2.QUEUED, createdAt: now, updatedAt: now, startedAt: null, settledAt: null, metadata: { ...(metadata || {}) } };
+  _nsEvents.set(id, e);
+  return { ...e, metadata: { ...e.metadata } };
+}
+function _nsCheckE(from, to) { const a = _nsEventTrans.get(from); if (!a || !a.has(to)) throw new Error(`invalid nostr event transition ${from} → ${to}`); }
+export function startNostrEventV2(id) { const e = _nsEvents.get(id); if (!e) throw new Error(`nostr event ${id} not found`); _nsCheckE(e.status, NOSTR_EVENT_LIFECYCLE_V2.PUBLISHING); const now = Date.now(); e.status = NOSTR_EVENT_LIFECYCLE_V2.PUBLISHING; e.updatedAt = now; if (!e.startedAt) e.startedAt = now; return { ...e, metadata: { ...e.metadata } }; }
+export function publishNostrEventV2(id) { const e = _nsEvents.get(id); if (!e) throw new Error(`nostr event ${id} not found`); _nsCheckE(e.status, NOSTR_EVENT_LIFECYCLE_V2.PUBLISHED); const now = Date.now(); e.status = NOSTR_EVENT_LIFECYCLE_V2.PUBLISHED; e.updatedAt = now; if (!e.settledAt) e.settledAt = now; return { ...e, metadata: { ...e.metadata } }; }
+export function failNostrEventV2(id, reason) { const e = _nsEvents.get(id); if (!e) throw new Error(`nostr event ${id} not found`); _nsCheckE(e.status, NOSTR_EVENT_LIFECYCLE_V2.FAILED); const now = Date.now(); e.status = NOSTR_EVENT_LIFECYCLE_V2.FAILED; e.updatedAt = now; if (!e.settledAt) e.settledAt = now; if (reason) e.metadata.failReason = String(reason); return { ...e, metadata: { ...e.metadata } }; }
+export function cancelNostrEventV2(id, reason) { const e = _nsEvents.get(id); if (!e) throw new Error(`nostr event ${id} not found`); _nsCheckE(e.status, NOSTR_EVENT_LIFECYCLE_V2.CANCELLED); const now = Date.now(); e.status = NOSTR_EVENT_LIFECYCLE_V2.CANCELLED; e.updatedAt = now; if (!e.settledAt) e.settledAt = now; if (reason) e.metadata.cancelReason = String(reason); return { ...e, metadata: { ...e.metadata } }; }
+export function getNostrEventV2(id) { const e = _nsEvents.get(id); if (!e) return null; return { ...e, metadata: { ...e.metadata } }; }
+export function listNostrEventsV2() { return [..._nsEvents.values()].map((e) => ({ ...e, metadata: { ...e.metadata } })); }
+
+export function autoOfflineIdleNostrRelaysV2({ now } = {}) { const t = now ?? Date.now(); const flipped = []; for (const r of _nsRelays.values()) if (r.status === NOSTR_RELAY_MATURITY_V2.ACTIVE && (t - r.lastTouchedAt) >= _nsRelayIdleMs) { r.status = NOSTR_RELAY_MATURITY_V2.OFFLINE; r.updatedAt = t; flipped.push(r.id); } return { flipped, count: flipped.length }; }
+export function autoFailStuckNostrEventsV2({ now } = {}) { const t = now ?? Date.now(); const flipped = []; for (const e of _nsEvents.values()) if (e.status === NOSTR_EVENT_LIFECYCLE_V2.PUBLISHING && e.startedAt != null && (t - e.startedAt) >= _nsEventStuckMs) { e.status = NOSTR_EVENT_LIFECYCLE_V2.FAILED; e.updatedAt = t; if (!e.settledAt) e.settledAt = t; e.metadata.failReason = "auto-fail-stuck"; flipped.push(e.id); } return { flipped, count: flipped.length }; }
+
+export function getNostrBridgeStatsV2() {
+  const relaysByStatus = {}; for (const s of Object.values(NOSTR_RELAY_MATURITY_V2)) relaysByStatus[s] = 0; for (const r of _nsRelays.values()) relaysByStatus[r.status]++;
+  const eventsByStatus = {}; for (const s of Object.values(NOSTR_EVENT_LIFECYCLE_V2)) eventsByStatus[s] = 0; for (const e of _nsEvents.values()) eventsByStatus[e.status]++;
+  return { totalRelaysV2: _nsRelays.size, totalEventsV2: _nsEvents.size, maxActiveNostrRelaysPerOwner: _nsMaxActivePerOwner, maxPendingNostrEventsPerRelay: _nsMaxPendingPerRelay, nostrRelayIdleMs: _nsRelayIdleMs, nostrEventStuckMs: _nsEventStuckMs, relaysByStatus, eventsByStatus };
+}