feat(desktop): implement workspace foundation + desktop-client skeleton

Plan 0 (workspaces): add workspaces + workspace_memberships schema, extend JWT/Actor/claims with primary_workspace_id, seed default workspace per tenant, thread workspace_id through tenant monitoring quota. Plan A (desktop skeleton): new Electron app (apps/desktop-client) with main/ preload/renderer, shared Vue component package (packages/ui-shared), and server surface — desktop client registration + token rotation + heartbeat, SSE task event stream, desktop accounts/tasks/content handlers, publish job endpoint, and supporting repositories, services, sqlc queries, and migrations. Hard cutover per plan: remove browser-extension monitoring callback endpoints, stub legacy media API in admin-web, and delete monitoring_callback_handler.go.
2026-04-19 14:18:20 +08:00
parent 98f9e95875
commit b16e9f0bd1
141 changed files with 21533 additions and 357 deletions
@@ -0,0 +1,90 @@
+interface LeaseSnapshot {
+  activeLeaseId: string | null;
+  activeTaskId: string | null;
+  attemptId: string | null;
+  startedAt: number | null;
+  leaseExpiresAt: number | null;
+  lastExtendedAt: number | null;
+  lastReleasedAt: number | null;
+  lastOutcome: "leased" | "extended" | "parked" | "completed" | "failed" | "cleared" | null;
+}
+
+interface ActiveLeaseState {
+  taskId: string;
+  attemptId: string | null;
+  leaseExpiresAt: number | null;
+}
+
+const leaseState: LeaseSnapshot = {
+  activeLeaseId: null,
+  activeTaskId: null,
+  attemptId: null,
+  startedAt: null,
+  leaseExpiresAt: null,
+  lastExtendedAt: null,
+  lastReleasedAt: null,
+  lastOutcome: null,
+};
+
+function normalizeLeaseExpiresAt(value: number | string | null | undefined): number | null {
+  if (typeof value === "number") {
+    return Number.isFinite(value) ? value : null;
+  }
+
+  if (typeof value !== "string" || !value.trim()) {
+    return null;
+  }
+
+  const timestamp = Date.parse(value);
+  return Number.isNaN(timestamp) ? null : timestamp;
+}
+
+export function setActiveLease(input: {
+  taskId: string;
+  attemptId?: string | null;
+  leaseExpiresAt?: number | string | null;
+} | null): void {
+  if (!input) {
+    leaseState.activeLeaseId = null;
+    leaseState.activeTaskId = null;
+    leaseState.attemptId = null;
+    leaseState.startedAt = null;
+    leaseState.leaseExpiresAt = null;
+    leaseState.lastOutcome = "cleared";
+    leaseState.lastReleasedAt = Date.now();
+    return;
+  }
+
+  const normalized: ActiveLeaseState = {
+    taskId: input.taskId,
+    attemptId: input.attemptId ?? null,
+    leaseExpiresAt: normalizeLeaseExpiresAt(input.leaseExpiresAt),
+  };
+
+  leaseState.activeLeaseId = normalized.taskId;
+  leaseState.activeTaskId = normalized.taskId;
+  leaseState.attemptId = normalized.attemptId;
+  leaseState.startedAt = Date.now();
+  leaseState.leaseExpiresAt = normalized.leaseExpiresAt;
+  leaseState.lastOutcome = "leased";
+}
+
+export function noteLeaseExtended(leaseExpiresAt?: number | string | null): void {
+  leaseState.lastExtendedAt = Date.now();
+  leaseState.leaseExpiresAt = normalizeLeaseExpiresAt(leaseExpiresAt) ?? leaseState.leaseExpiresAt;
+  leaseState.lastOutcome = "extended";
+}
+
+export function noteLeaseReleased(reason: Exclude<LeaseSnapshot["lastOutcome"], "leased" | "extended" | null>): void {
+  leaseState.activeLeaseId = null;
+  leaseState.activeTaskId = null;
+  leaseState.attemptId = null;
+  leaseState.startedAt = null;
+  leaseState.leaseExpiresAt = null;
+  leaseState.lastReleasedAt = Date.now();
+  leaseState.lastOutcome = reason;
+}
+
+export function getLeaseManagerSnapshot(): LeaseSnapshot {
+  return { ...leaseState };
+}