Merge pull request #1137 from EpicenterHQ/braden-w/rm-hocuspocus

chore(epicenter): remove hocuspocus provider and dependencies

Author: braden-w

bun.lock

@@ -219,8 +219,6 @@
       },
       "dependencies": {
         "@elysiajs/openapi": "^1.4.11",
-        "@hocuspocus/provider": "^3.4.0",
-        "@hocuspocus/server": "^3.4.0",
         "@standard-community/standard-json": "^0.3.5",
         "@standard-schema/spec": "^1.0.0",
         "@tursodatabase/database": "^0.3.2",
@@ -229,10 +227,12 @@
         "diff": "^8.0.2",
         "drizzle-orm": "catalog:",
         "elysia": "^1.2.25",
+        "lib0": "^0.2.99",
         "mime": "catalog:",
         "nanoid": "catalog:",
         "wellcrafted": "catalog:",
         "y-indexeddb": "^9.0.12",
+        "y-protocols": "^1.0.6",
         "yargs": "catalog:",
         "yjs": "^13.6.27",
       },
@@ -581,12 +581,6 @@
 
     "@google/generative-ai": ["@google/[email protected]", "", {}, "sha512-MqO+MLfM6kjxcKoy0p1wRzG3b4ZZXtPI+z2IE26UogS2Cm/XHO+7gGRBh6gcJsOiIVoH93UwKvW4HdgiOZCy9Q=="],
 
-    "@hocuspocus/common": ["@hocuspocus/[email protected]", "", { "dependencies": { "lib0": "^0.2.87" } }, "sha512-29Dpa3nslBvM4dksIoskovYt/aecJomEeWE5Wmzr+lNFJje15P/L/47WcogguRd/IqYIu2auNTyKlouvSRrDAQ=="],
-
-    "@hocuspocus/provider": ["@hocuspocus/[email protected]", "", { "dependencies": { "@hocuspocus/common": "^3.4.1", "@lifeomic/attempt": "^3.0.2", "lib0": "^0.2.87", "ws": "^8.17.1" }, "peerDependencies": { "y-protocols": "^1.0.6", "yjs": "^13.6.8" } }, "sha512-lFNxXf2NsyhT8fvxX/N6caki97hbUUGOM79tAoeJty/Y6hKfQyY6ythvkeVdqk+yvx/RiVogrW4PLjazRGprGg=="],
-
-    "@hocuspocus/server": ["@hocuspocus/[email protected]", "", { "dependencies": { "@hocuspocus/common": "^3.4.1", "async-lock": "^1.3.1", "async-mutex": "^0.5.0", "kleur": "^4.1.4", "lib0": "^0.2.47", "ws": "^8.5.0" }, "peerDependencies": { "y-protocols": "^1.0.6", "yjs": "^13.6.8" } }, "sha512-VgHmu71CFwyCYOlkLovAqaFrUKGq+OSsIw13PaMLMUrnLT3EdMqFzfkw9b82Qbf23WoN3yvMCPklNjnjg5/Brg=="],
-
     "@humanfs/core": ["@humanfs/[email protected]", "", {}, "sha512-5DyQ4+1JEUzejeK1JGICcideyfUbGixgS9jNgex5nqkW+cY7WZhxBigmieN5Qnw9ZosSNVC9KQKyb+GUaGyKUA=="],
 
     "@humanfs/node": ["@humanfs/[email protected]", "", { "dependencies": { "@humanfs/core": "^0.19.1", "@humanwhocodes/retry": "^0.4.0" } }, "sha512-/zUx+yOsIrG4Y43Eh2peDeKCxlRt/gET6aHfaKpuq267qXdYDFViVHfMaLyygZOnl0kGWxFIgsBy8QFuTLUXEQ=="],
@@ -681,8 +675,6 @@
 
     "@libsql/win32-x64-msvc": ["@libsql/[email protected]", "", { "os": "win32", "cpu": "x64" }, "sha512-7pJzOWzPm6oJUxml+PCDRzYQ4A1hTMHAciTAHfFK4fkbDZX33nWPVG7Y3vqdKtslcwAzwmrNDc6sXy2nwWnbiw=="],
 
-    "@lifeomic/attempt": ["@lifeomic/[email protected]", "", {}, "sha512-QZqem4QuAnAyzfz+Gj5/+SLxqwCAw2qmt7732ZXodr6VDWGeYLG6w1i/vYLa55JQM9wRuBKLmXmiZ2P0LtE5rw=="],
-
     "@lucide/astro": ["@lucide/[email protected]", "", { "peerDependencies": { "astro": "^4 || ^5" } }, "sha512-YtnEpWuk+ETun3kcLFbfYlPWuE5fhStg76u8dmhOUsRHk7E1ZsXbtxY612GobgJRiD9tqXmhcg1qu0yVuceTvw=="],
 
     "@lucide/svelte": ["@lucide/[email protected]", "", { "peerDependencies": { "svelte": "^5" } }, "sha512-aqTOMjBjf/HNwrhggRdb83T0QslZdpJTyTwr/chtXTGw7u4Hcu4zQb/5uA+csF0KKawKWVnsNI1MdHEHeEXTcQ=="],
@@ -1057,10 +1049,6 @@
 
     "astro": ["[email protected]", "", { "dependencies": { "@astrojs/compiler": "^2.13.0", "@astrojs/internal-helpers": "0.7.5", "@astrojs/markdown-remark": "6.3.10", "@astrojs/telemetry": "3.3.0", "@capsizecss/unpack": "^3.0.1", "@oslojs/encoding": "^1.1.0", "@rollup/pluginutils": "^5.3.0", "acorn": "^8.15.0", "aria-query": "^5.3.2", "axobject-query": "^4.1.0", "boxen": "8.0.1", "ci-info": "^4.3.1", "clsx": "^2.1.1", "common-ancestor-path": "^1.0.1", "cookie": "^1.0.2", "cssesc": "^3.0.0", "debug": "^4.4.3", "deterministic-object-hash": "^2.0.2", "devalue": "^5.5.0", "diff": "^5.2.0", "dlv": "^1.1.3", "dset": "^3.1.4", "es-module-lexer": "^1.7.0", "esbuild": "^0.25.0", "estree-walker": "^3.0.3", "flattie": "^1.1.1", "fontace": "~0.3.1", "github-slugger": "^2.0.0", "html-escaper": "3.0.3", "http-cache-semantics": "^4.2.0", "import-meta-resolve": "^4.2.0", "js-yaml": "^4.1.1", "magic-string": "^0.30.21", "magicast": "^0.5.1", "mrmime": "^2.0.1", "neotraverse": "^0.6.18", "p-limit": "^6.2.0", "p-queue": "^8.1.1", "package-manager-detector": "^1.5.0", "piccolore": "^0.1.3", "picomatch": "^4.0.3", "prompts": "^2.4.2", "rehype": "^13.0.2", "semver": "^7.7.3", "shiki": "^3.15.0", "smol-toml": "^1.5.2", "svgo": "^4.0.0", "tinyexec": "^1.0.2", "tinyglobby": "^0.2.15", "tsconfck": "^3.1.6", "ultrahtml": "^1.6.0", "unifont": "~0.6.0", "unist-util-visit": "^5.0.0", "unstorage": "^1.17.3", "vfile": "^6.0.3", "vite": "^6.4.1", "vitefu": "^1.1.1", "xxhash-wasm": "^1.1.0", "yargs-parser": "^21.1.1", "yocto-spinner": "^0.2.3", "zod": "^3.25.76", "zod-to-json-schema": "^3.25.0", "zod-to-ts": "^1.2.0" }, "optionalDependencies": { "sharp": "^0.34.0" }, "bin": { "astro": "astro.js" } }, "sha512-QeuM4xzTR0QuXFDNlGVW0BW7rcquKFIkylaPeM4ufii0/RRiPTYtwxDYVZ3KfiMRuuc+nbLD0214kMKTvz/yvQ=="],
 
-    "async-lock": ["[email protected]", "", {}, "sha512-Az2ZTpuytrtqENulXwO3GGv1Bztugx6TT37NIo7imr/Qo0gsYiGtSdBa2B6fsXhTpVZDNfu1Qn3pk531e3q+nQ=="],
-
-    "async-mutex": ["[email protected]", "", { "dependencies": { "tslib": "^2.4.0" } }, "sha512-1A94B18jkJ3DYq284ohPxoXbfTA5HsQ7/Mf4DEhcyLx3Bz27Rh59iScbB6EPiP+B+joue6YCxcMXSbFC1tZKwA=="],
-
     "asynckit": ["[email protected]", "", {}, "sha512-Oei9OH4tRh0YqU3GxhX79dM/mwVgvbZJaSNaRk+bshkj0S5cfHcgYakreBjrHwatXKbz+IoIdYLxrKim2MjW0Q=="],
 
     "audio-recorder-polyfill": ["[email protected]", "", {}, "sha512-SS4qVOzuVwlS/tjQdd0uR+9cCKBTkx4jsAdjM+rMNqoTEWf6bMnBSTfv+FO4Zn9ngxviJOxhkgRWWXsAMqM96Q=="],

packages/epicenter/README.md

@@ -216,13 +216,10 @@ providers: {
   persistence: setupPersistence,
   sqlite: (c) => sqliteProvider(c),
 
-  // Option A: WebRTC sync (P2P, server as peer)
-  sync: createWebrtcSyncProvider({
-    signaling: ['ws://localhost:3913/signaling'],
+  // WebSocket sync (y-websocket protocol)
+  sync: createWebsocketSyncProvider({
+    url: 'ws://localhost:3913/sync',
   }),
-
-  // Option B: Hocuspocus WebSocket sync (server as hub)
-  sync: createHocuspocusProvider({ url: 'ws://localhost:3913' }),
 }
 ```
 
@@ -851,24 +848,6 @@ Yjs supports multiple providers simultaneously. Changes merge automatically via
 
 See [SYNC_ARCHITECTURE.md](./SYNC_ARCHITECTURE.md) for complete multi-device sync documentation.
 
-### Hocuspocus Provider
-
-Alternative WebSocket-based sync using the Hocuspocus server.
-
-**Setup:**
-
-```typescript
-import { createHocuspocusProvider } from '@epicenter/hq';
-
-providers: {
-  sync: createHocuspocusProvider({
-    url: 'ws://localhost:1234',
-  })
-}
-```
-
-See [@hocuspocus/provider documentation](https://tiptap.dev/docs/hocuspocus/provider) for configuration options.
-
 ## Workspace Dependencies
 
 Workspaces can depend on other workspaces, enabling modular architecture.
@@ -1134,7 +1113,7 @@ type ProviderContext = {
 ```typescript
 import { setupPersistence } from '@epicenter/hq/providers';
 import { sqliteProvider, markdownProvider } from '@epicenter/hq';
-import { HocuspocusProvider } from '@hocuspocus/provider';
+import { createWebsocketSyncProvider } from '@epicenter/hq/providers/websocket-sync';
 
 providers: {
   // Filesystem persistence (Node.js) or IndexedDB (browser)
@@ -1146,11 +1125,9 @@ providers: {
   // Markdown materializer
   markdown: (c) => markdownProvider(c),
 
-  // WebSocket sync provider
-  sync: ({ ydoc }) => new HocuspocusProvider({
-    url: 'wss://collab.example.com',
-    name: 'my-workspace',
-    document: ydoc,
+  // WebSocket sync provider (y-websocket protocol)
+  sync: createWebsocketSyncProvider({
+    url: 'ws://localhost:3913/sync',
   }),
 
   // Custom provider

packages/epicenter/package.json

@@ -9,7 +9,6 @@
 			"node": "./src/index.node.ts",
 			"default": "./src/index.node.ts"
 		},
-		"./providers/hocuspocus": "./src/providers/hocuspocus.ts",
 		"./providers/persistence": {
 			"browser": "./src/providers/persistence/index.browser.ts",
 			"node": "./src/providers/persistence/index.node.ts",
@@ -31,8 +30,6 @@
 	},
 	"dependencies": {
 		"mime": "catalog:",
-		"@hocuspocus/provider": "^3.4.0",
-		"@hocuspocus/server": "^3.4.0",
 		"@elysiajs/openapi": "^1.4.11",
 		"@standard-community/standard-json": "^0.3.5",
 		"@standard-schema/spec": "^1.0.0",

packages/epicenter/src/core/epicenter/README.md

@@ -34,7 +34,7 @@ Create an Epicenter client directly for standalone scripts:
 The server is just a wrapper around `createEpicenterClient` that:
 1. Creates an Epicenter client
 2. Keeps it alive
-3. Maps REST, MCP, and Hocuspocus endpoints to client actions
+3. Maps REST, MCP, and WebSocket Sync endpoints to client actions
 
 ```typescript
 // Server (long-running)

packages/epicenter/src/providers/hocuspocus.ts

@@ -8,7 +8,7 @@ Expose your Epicenter workspaces as REST APIs and AI-accessible tools.
 
 1. **Creates an Epicenter client** (same initialization as scripts)
 2. **Keeps it alive** (doesn't dispose until you stop the server)
-3. **Maps HTTP endpoints** to each client action (REST, MCP, Hocuspocus)
+3. **Maps HTTP endpoints** to each client action (REST, MCP, WebSocket Sync)
 
 The key difference from running scripts:
 
@@ -60,7 +60,7 @@ Bun.serve({ fetch: app.fetch, port: 3913 });
 
 - Web applications
 - API backends
-- Real-time collaboration (Hocuspocus)
+- Real-time collaboration (WebSocket Sync)
 - Multiple concurrent clients (via HTTP)
 
 **Benefits:**

packages/epicenter/src/server/README.md

@@ -41,12 +41,12 @@ export default defineWorkspace({
 
 ### Real-Time Collaboration
 
-Each workspace can be synchronized across multiple users via Yjs and a collaboration provider like Hocuspocus:
+Each workspace can be synchronized across multiple users via Yjs and a WebSocket sync provider:
 
 ```typescript
 import { runPlugin } from '@epicenter/vault';
 import * as Y from 'yjs';
-import { HocuspocusProvider } from '@hocuspocus/provider';
+import { createWebsocketSyncProvider } from '@epicenter/hq/providers/websocket-sync';
 
 // Load workspace config
 const workspace = await import('./users/epicenter.config.ts');
@@ -55,11 +55,9 @@ const workspace = await import('./users/epicenter.config.ts');
 const ydoc = new Y.Doc({ guid: workspace.default.id });
 
 // Connect to collaboration server
-const provider = new HocuspocusProvider({
-  url: 'wss://collab.example.com',
-  name: workspace.default.id, // Use workspace ID as document name
-  document: ydoc
-});
+createWebsocketSyncProvider({
+  url: 'wss://collab.example.com/sync',
+})({ ydoc });
 
 // Run plugin with sync enabled
 const api = await runPlugin(workspace.default, {
@@ -144,7 +142,7 @@ Share only specific workspaces:
 - [ ] Add Yjs document support to `runPlugin`
 - [ ] Implement CRDT-based table operations
 - [ ] Add conflict resolution strategies
-- [ ] Create Hocuspocus adapter
+- [x] Create WebSocket sync adapter
 
 ### Phase 3: Collaboration Features (Future)
 - [ ] Real-time presence indicators

specs/20251001T175148 vault-collaborative-workspaces.md

@@ -15,7 +15,7 @@ Looking at the codebase structure, I see several distinct modules:
 
 1. **Core exports** (already in main barrel): workspace, schema, actions, epicenter, db
 2. **Index implementations**: markdown, sqlite (partially exported)
-3. **Providers**: persistence, hocuspocus (already has `/providers` subpath)
+3. **Providers**: persistence, websocket-sync (already has `/providers` subpath)
 4. **Platform-specific**: cli, desktop, web (already have subpaths)
 5. **Server**: REST API and MCP server (already has subpath indirectly)
 6. **Missing exports**: Helper functions, error types from index implementations

specs/20251105T150000_subpath-exports.md

@@ -89,8 +89,7 @@ defineWorkspace({
 - [ ] Update `packages/epicenter/src/providers/persistence/web.ts`
   - Same changes as desktop.ts
 
-- [ ] Update `packages/epicenter/src/providers/hocuspocus.ts` (if exists)
-  - Update to use new `ProviderContext` shape
+- [x] ~~Update `packages/epicenter/src/providers/hocuspocus.ts` (if exists)~~ (removed - replaced by websocket-sync)
 
 ### Phase 4: Index → Provider Migration