chainlesschain 0.143.0 → 0.145.0

package/src/lib/todo-manager.js

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