viteboard 0.1.3 → 0.1.5

package/dist/index.html

@@ -6,8 +6,8 @@
     <link rel="describedby" href="/llms.txt" />
     <link rel="alternate" type="application/json" href="/.well-known/viteboard.json" />
     <title>ViteBoard</title>
-    <script type="module" crossorigin src="/assets/index-D2W76uu9.js"></script>
-    <link rel="stylesheet" crossorigin href="/assets/index-rMkUjGXP.css">
+    <script type="module" crossorigin src="/assets/index-DUCBvK-t.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-2x-lv2vK.css">
   </head>
   <body>
     <div id="app"></div>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "viteboard",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Local-first documentation workspace and infinite-canvas whiteboard. Markdown docs, boards, and capability specs as plain files on disk.",
   "license": "MIT",
   "type": "module",

package/vite.config.ts

@@ -39,8 +39,6 @@ const MIME_EXT: Record<string, string> = {
   "image/svg+xml": ".svg",
 };
 const MANAGED_ASSET_RE = /^assets\/[a-f0-9]{64}\.(png|jpe?g|webp|gif|svg)$/i;
-const ACTOR_TTL_MS = 30000;
-const LOCK_TTL_MS = 30000;
 const ROOT_LINK_HEADER = '</llms.txt>; rel="describedby"; type="text/plain", </.well-known/viteboard.json>; rel="alternate"; type="application/json"';
 
 const execFileAsync = promisify(execFile);
@@ -88,51 +86,12 @@ type TreeNode =
   | { type: "file"; name: string; path: string }
   | { type: "dir"; name: string; path: string; children: TreeNode[] };
 
-type ActorState =
-  | "idle"
-  | "viewing-doc"
-  | "editing-doc"
-  | "viewing-board"
-  | "editing-board"
-  | "viewing-project"
-  | "writing";
-
-type ActorSessionRecord = {
-  actorId: string;
-  actorType: "human" | "agent";
-  label: string;
-  route: string;
-  state: ActorState;
-  rootId?: string;
-  projectId?: string;
-  docPath?: string;
-  boardId?: string;
-  updatedAt: number;
-  expiresAt: number;
-};
-
-type LockRecord = {
-  lockId: string;
-  actorId: string;
-  actorType: "human" | "agent";
-  label: string;
-  targetType: "doc" | "board";
-  rootId: string;
-  path?: string;
-  boardId?: string;
-  acquiredAt: number;
-  expiresAt: number;
-};
-
 function contentApiPlugin(): Plugin {
   const cwd = process.cwd();
   const packageRoot = path.dirname(fileURLToPath(import.meta.url));
   const workspaceDir = path.resolve(cwd, WORKSPACE_DIR);
   const workspaceFile = path.join(workspaceDir, WORKSPACE_FILE);
   const machineDir = path.join(packageRoot, "content", "machine");
-  const actorSessions = new Map<string, ActorSessionRecord>();
-  const locks = new Map<string, LockRecord>();
-  const sseClients = new Set<ServerResponse>();
 
   function send(res: ServerResponse, status: number, body: unknown): void {
     res.statusCode = status;
@@ -146,77 +105,6 @@ function contentApiPlugin(): Plugin {
     res.end(body);
   }
 
-  function sendSse(res: ServerResponse, event: string, body: unknown): void {
-    res.write(`event: ${event}\n`);
-    res.write(`data: ${JSON.stringify(body)}\n\n`);
-  }
-
-  function broadcast(event: string, body: unknown): void {
-    for (const client of sseClients) {
-      try {
-        sendSse(client, event, body);
-      } catch {
-        sseClients.delete(client);
-      }
-    }
-  }
-
-  function actorFromHeaders(req: IncomingMessage): { actorId: string; actorType: "human" | "agent"; label: string } | null {
-    const actorId = String(req.headers["x-viteboard-actor-id"] ?? "").trim();
-    if (!actorId) return null;
-    const actorType = String(req.headers["x-viteboard-actor-type"] ?? "human") === "agent" ? "agent" : "human";
-    const label = String(req.headers["x-viteboard-actor-label"] ?? "").trim() || (actorType === "agent" ? "Agent" : "ViteBoard UI");
-    return { actorId, actorType, label };
-  }
-
-  function lockKey(target: { targetType: "doc" | "board"; rootId: string; path?: string; boardId?: string }): string {
-    const suffix = target.targetType === "doc" ? target.path ?? "" : target.boardId ?? "";
-    return `${target.targetType}:${target.rootId}:${suffix}`;
-  }
-
-  function activeActors(): ActorSessionRecord[] {
-    return [...actorSessions.values()].sort((a, b) => a.label.localeCompare(b.label));
-  }
-
-  function activeLocks(): LockRecord[] {
-    return [...locks.values()].sort((a, b) => a.acquiredAt - b.acquiredAt);
-  }
-
-  function broadcastPresence(): void {
-    broadcast("presence", { actors: activeActors(), locks: activeLocks() });
-  }
-
-  function broadcastLocks(): void {
-    broadcast("lock-changed", { locks: activeLocks() });
-  }
-
-  function pruneEphemeral(): void {
-    const now = Date.now();
-    let changedPresence = false;
-    let changedLocks = false;
-    for (const [actorId, actor] of actorSessions) {
-      if (actor.expiresAt <= now) {
-        actorSessions.delete(actorId);
-        changedPresence = true;
-      }
-    }
-    for (const [key, lock] of locks) {
-      if (lock.expiresAt <= now || !actorSessions.has(lock.actorId)) {
-        locks.delete(key);
-        changedLocks = true;
-      }
-    }
-    if (changedPresence) broadcastPresence();
-    else if (changedLocks) broadcastLocks();
-  }
-
-  function extendActorLocks(actorId: string): void {
-    const now = Date.now();
-    for (const lock of locks.values()) {
-      if (lock.actorId === actorId) lock.expiresAt = now + LOCK_TTL_MS;
-    }
-  }
-
   async function readMachineAsset(fileName: string): Promise<string> {
     return fs.readFile(path.join(machineDir, fileName), "utf-8");
   }
@@ -225,8 +113,6 @@ function contentApiPlugin(): Plugin {
     return createHash("sha1").update(content).digest("hex");
   }
 
-  setInterval(pruneEphemeral, 10000).unref?.();
-
   function readBody(req: IncomingMessage): Promise<string> {
     return new Promise((resolve, reject) => {
       let data = "";
@@ -755,169 +641,11 @@ function contentApiPlugin(): Plugin {
     void (async () => {
       try {
         const method = (req.method ?? "GET").toUpperCase();
-        const actor = actorFromHeaders(req);
-        pruneEphemeral();
 
         if (route === "/__api/workspace" && method === "GET") {
           return send(res, 200, await toWorkspaceResponse(await getWorkspace()));
         }
 
-        if (route === "/__api/events" && method === "GET") {
-          res.statusCode = 200;
-          res.setHeader("Content-Type", "text/event-stream; charset=utf-8");
-          res.setHeader("Cache-Control", "no-cache, no-transform");
-          res.setHeader("Connection", "keep-alive");
-          res.write(": connected\n\n");
-          sseClients.add(res);
-          sendSse(res, "hello", { actors: activeActors(), locks: activeLocks() });
-          req.on("close", () => {
-            sseClients.delete(res);
-          });
-          return;
-        }
-
-        if (route === "/__api/actors/session" && method === "GET") {
-          return send(res, 200, { actors: activeActors() });
-        }
-
-        if (route === "/__api/actors/session" && method === "POST") {
-          const body = JSON.parse(await readBody(req));
-          const actorId = String(body.actorId ?? actor?.actorId ?? "").trim();
-          if (!actorId) return send(res, 400, { error: "actorId is required" });
-          const actorType = String(body.actorType ?? actor?.actorType ?? "human") === "agent" ? "agent" : "human";
-          const label = String(body.label ?? actor?.label ?? "").trim() || (actorType === "agent" ? "Agent" : "ViteBoard UI");
-          const now = Date.now();
-          actorSessions.set(actorId, {
-            actorId,
-            actorType,
-            label,
-            route: String(body.route ?? "#/"),
-            state: String(body.state ?? "idle") as ActorState,
-            rootId: typeof body.rootId === "string" ? body.rootId : undefined,
-            projectId: typeof body.projectId === "string" ? body.projectId : undefined,
-            docPath: typeof body.docPath === "string" ? body.docPath : undefined,
-            boardId: typeof body.boardId === "string" ? body.boardId : undefined,
-            selectedElementIds: Array.isArray(body.selectedElementIds)
-              ? body.selectedElementIds.filter((item: unknown): item is string => typeof item === "string")
-              : undefined,
-            updatedAt: now,
-            expiresAt: now + ACTOR_TTL_MS,
-          });
-          extendActorLocks(actorId);
-          broadcastPresence();
-          return send(res, 200, { ok: true });
-        }
-
-        if (route === "/__api/actors/heartbeat" && method === "POST") {
-          const body = JSON.parse(await readBody(req));
-          const actorId = String(body.actorId ?? actor?.actorId ?? "").trim();
-          if (!actorId) return send(res, 400, { error: "actorId is required" });
-          const current = actorSessions.get(actorId);
-          if (!current) return send(res, 404, { error: "Actor session not found" });
-          const now = Date.now();
-          const next: ActorSessionRecord = {
-            ...current,
-            route: typeof body.route === "string" ? body.route : current.route,
-            state: typeof body.state === "string" ? (body.state as ActorState) : current.state,
-            rootId: typeof body.rootId === "string" ? body.rootId : current.rootId,
-            projectId: typeof body.projectId === "string" ? body.projectId : current.projectId,
-            docPath: typeof body.docPath === "string" ? body.docPath : current.docPath,
-            boardId: typeof body.boardId === "string" ? body.boardId : current.boardId,
-            selectedElementIds: Array.isArray(body.selectedElementIds)
-              ? body.selectedElementIds.filter((item: unknown): item is string => typeof item === "string")
-              : current.selectedElementIds,
-            updatedAt: now,
-            expiresAt: now + ACTOR_TTL_MS,
-          };
-          actorSessions.set(actorId, next);
-          extendActorLocks(actorId);
-          broadcastPresence();
-          return send(res, 200, { ok: true });
-        }
-
-        if (route === "/__api/actors/session" && method === "DELETE") {
-          const actorId = parsed.searchParams.get("actorId") ?? actor?.actorId ?? "";
-          if (!actorId) return send(res, 400, { error: "actorId is required" });
-          actorSessions.delete(actorId);
-          let changedLocks = false;
-          for (const [key, lock] of locks) {
-            if (lock.actorId === actorId) {
-              locks.delete(key);
-              changedLocks = true;
-            }
-          }
-          if (changedLocks) broadcastLocks();
-          broadcastPresence();
-          return send(res, 200, { ok: true });
-        }
-
-        if (route === "/__api/locks" && method === "GET") {
-          return send(res, 200, { locks: activeLocks() });
-        }
-
-        if (route === "/__api/locks/acquire" && method === "POST") {
-          const body = JSON.parse(await readBody(req));
-          if (!actor?.actorId) return send(res, 400, { error: "actor identity is required" });
-          const targetType = body.targetType === "board" ? "board" : body.targetType === "doc" ? "doc" : null;
-          const rootId = String(body.rootId ?? "").trim();
-          if (!targetType || !rootId) return send(res, 400, { error: "targetType and rootId are required" });
-          const resolved = await resolveRoot(rootId);
-          if (!resolved) return send(res, 404, { error: "Docs root not found" });
-          const targetPath = targetType === "doc" ? String(body.path ?? "").trim() : undefined;
-          const targetBoardId = targetType === "board" ? String(body.boardId ?? "").trim() : undefined;
-          const targetAbs = targetType === "doc"
-            ? safeResolve(resolved.root.absPath, targetPath ?? "")
-            : safeResolve(resolved.root.absPath, `${targetBoardId}.board.json`);
-          if (!targetAbs) {
-            return send(res, 400, { error: targetType === "doc" ? "Invalid path" : "Invalid boardId" });
-          }
-          const key = lockKey({ targetType, rootId, path: targetPath, boardId: targetBoardId });
-          const now = Date.now();
-          const existing = locks.get(key);
-          if (existing && existing.actorId !== actor.actorId && existing.expiresAt > now) {
-            return send(res, 409, { error: `${existing.label} is editing this ${targetType}.`, lock: existing });
-          }
-          const nextLock: LockRecord = existing && existing.actorId === actor.actorId
-            ? { ...existing, expiresAt: now + LOCK_TTL_MS }
-            : {
-                lockId: `lock-${hashPath(`${key}:${now}`)}`,
-                actorId: actor.actorId,
-                actorType: actor.actorType,
-                label: actor.label,
-                targetType,
-                rootId,
-                path: targetPath,
-                boardId: targetBoardId,
-                acquiredAt: now,
-                expiresAt: now + LOCK_TTL_MS,
-              };
-          locks.set(key, nextLock);
-          broadcastLocks();
-          broadcastPresence();
-          return send(res, 200, { ok: true, lock: nextLock });
-        }
-
-        if (route === "/__api/locks/release" && method === "POST") {
-          const body = JSON.parse(await readBody(req));
-          if (!actor?.actorId) return send(res, 400, { error: "actor identity is required" });
-          const targetType = body.targetType === "board" ? "board" : body.targetType === "doc" ? "doc" : null;
-          const rootId = String(body.rootId ?? "").trim();
-          if (!targetType || !rootId) return send(res, 400, { error: "targetType and rootId are required" });
-          const key = lockKey({
-            targetType,
-            rootId,
-            path: targetType === "doc" ? String(body.path ?? "").trim() : undefined,
-            boardId: targetType === "board" ? String(body.boardId ?? "").trim() : undefined,
-          });
-          const existing = locks.get(key);
-          if (!existing) return send(res, 200, { ok: true });
-          if (existing.actorId !== actor.actorId) return send(res, 403, { error: "Lock owned by another actor" });
-          locks.delete(key);
-          broadcastLocks();
-          broadcastPresence();
-          return send(res, 200, { ok: true });
-        }
-
         if (route === "/__api/workspace/project" && method === "POST") {
           const { rootPath, label } = JSON.parse(await readBody(req));
           const absRoot = await canonicalizeProjectRoot(String(rootPath ?? "").trim());
@@ -938,7 +666,6 @@ function contentApiPlugin(): Plugin {
           if (existingIndex === -1) manifest.projects.push(project);
           else manifest.projects.splice(existingIndex, 1, project);
           await saveManifest(manifest);
-          broadcast("workspace-changed", { action: "project-added", projectId: project.id, actorId: actor?.actorId ?? null });
           return send(res, 200, await toWorkspaceResponse(await getWorkspace()));
         }
 
@@ -961,7 +688,6 @@ function contentApiPlugin(): Plugin {
           if (existingIndex === -1) manifest.projects.push(project);
           else manifest.projects.splice(existingIndex, 1, project);
           await saveManifest(manifest);
-          broadcast("workspace-changed", { action: "project-added", projectId: project.id, actorId: actor?.actorId ?? null });
           return send(res, 200, { cancelled: false, workspace: await toWorkspaceResponse(await getWorkspace()), addedProjectId: project.id });
         }
 
@@ -977,7 +703,6 @@ function contentApiPlugin(): Plugin {
           const root = refreshedProject?.docsRoots.find((item) => item.absPath === docsPath)
             ?? refreshedProject?.docsRoots[0];
           if (!root) return send(res, 500, { error: "Could not create docs root" });
-          broadcast("workspace-changed", { action: "docs-root-created", projectId: project.id, rootId: root.id, actorId: actor?.actorId ?? null });
           return send(res, 200, {
             root: {
               id: root.id,
@@ -1002,7 +727,6 @@ function contentApiPlugin(): Plugin {
           const refreshedProject = workspace.find((item) => item.id === project.id);
           const root = refreshedProject?.docsRoots.find((item) => item.absPath === docsPath);
           if (!root) return send(res, 500, { error: "Could not create docs area" });
-          broadcast("workspace-changed", { action: "docs-area-created", projectId: project.id, rootId: root.id, actorId: actor?.actorId ?? null });
           return send(res, 200, {
             root: {
               id: root.id,
@@ -1022,7 +746,6 @@ function contentApiPlugin(): Plugin {
           if (!project) return send(res, 404, { error: "Project not found" });
           const docsPath = path.join(project.rootPath, String(parentPath ?? ""), "docs");
           await fs.mkdir(docsPath, { recursive: true });
-          broadcast("workspace-changed", { action: "docs-folder-created", projectId: project.id, actorId: actor?.actorId ?? null });
           return send(res, 200, { ok: true, workspace: await toWorkspaceResponse(await getWorkspace()) });
         }
 
@@ -1031,7 +754,6 @@ function contentApiPlugin(): Plugin {
           const manifest = await loadManifest();
           manifest.projects = manifest.projects.filter((item) => item.id !== id);
           await saveManifest(manifest);
-          broadcast("workspace-changed", { action: "project-removed", projectId: id, actorId: actor?.actorId ?? null });
           return send(res, 200, await toWorkspaceResponse(await getWorkspace()));
         }
 
@@ -1091,7 +813,6 @@ function contentApiPlugin(): Plugin {
           const nextContent = String(content ?? "");
           await fs.writeFile(abs, nextContent, "utf-8");
           const revision = revisionForText(nextContent);
-          broadcast("file-changed", { rootId: resolved.root.id, path: String(rel), action: "write", actorId: actor?.actorId ?? null });
           return send(res, 200, { ok: true, path: rel, revision });
         }
 
@@ -1102,7 +823,6 @@ function contentApiPlugin(): Plugin {
           const abs = safeResolve(resolved.root.absPath, String(rel));
           if (!abs) return send(res, 400, { error: "Invalid path" });
           await fs.mkdir(abs, { recursive: true });
-          broadcast("workspace-changed", { action: "directory-created", rootId: resolved.root.id, path: String(rel), actorId: actor?.actorId ?? null });
           return send(res, 200, { ok: true, path: rel });
         }
 
@@ -1118,7 +838,6 @@ function contentApiPlugin(): Plugin {
           } catch (err) {
             if ((err as NodeJS.ErrnoException).code !== "ENOENT") throw err;
           }
-          broadcast("file-changed", { rootId: resolved.root.id, path: rel, action: "delete", actorId: actor?.actorId ?? null });
           return send(res, 200, { ok: true });
         }
 
@@ -1139,7 +858,6 @@ function contentApiPlugin(): Plugin {
             }
             throw err;
           }
-          broadcast("file-changed", { rootId: resolved.root.id, path: String(newPath), oldPath: String(oldPath), action: "rename", actorId: actor?.actorId ?? null });
           return send(res, 200, { ok: true, path: newPath });
         }
 
@@ -1182,7 +900,6 @@ function contentApiPlugin(): Plugin {
           const nextContent = JSON.stringify(doc, null, 2) + "\n";
           await fs.writeFile(abs, nextContent, "utf-8");
           const revision = revisionForText(nextContent);
-          broadcast("board-changed", { rootId: resolved.root.id, boardId: String(id), action: "write", actorId: actor?.actorId ?? null });
           return send(res, 200, { ok: true, id, revision });
         }
 
@@ -1198,7 +915,6 @@ function contentApiPlugin(): Plugin {
           } catch (err) {
             if ((err as NodeJS.ErrnoException).code !== "ENOENT") throw err;
           }
-          broadcast("board-changed", { rootId: resolved.root.id, boardId: id, action: "delete", actorId: actor?.actorId ?? null });
           return send(res, 200, { ok: true, id });
         }
 
@@ -1236,7 +952,6 @@ function contentApiPlugin(): Plugin {
           } catch {
             await fs.writeFile(abs, bytes);
           }
-          broadcast("asset-changed", { rootId: resolved.root.id, path: rel, action: "write", actorId: actor?.actorId ?? null });
           return send(res, 200, { ok: true, path: rel });
         }
 
@@ -1248,7 +963,6 @@ function contentApiPlugin(): Plugin {
             resolved.root.absPath,
             Array.isArray(preservePaths) ? preservePaths.filter((item): item is string => typeof item === "string") : []
           );
-          if (removed > 0) broadcast("asset-changed", { rootId: resolved.root.id, action: "cleanup", removed, actorId: actor?.actorId ?? null });
           return send(res, 200, { ok: true, removed });
         }