@develosaur/mcp 1.0.0

package/dist/yjs/YjsProjectSession.d.ts

@@ -0,0 +1,45 @@
+import * as Y from 'yjs';
+import type { SupabaseClient } from '@supabase/supabase-js';
+export declare class YjsProjectSession {
+    private yDoc;
+    private channel;
+    private supabase;
+    private projectId;
+    private connected;
+    constructor(supabase: SupabaseClient, projectId: string);
+    /**
+     * Load project state: snapshot + incremental updates
+     * Uses the EXISTING load_yjs_state_efficient RPC (no modifications)
+     */
+    load(): Promise<{
+        nodeCount: number;
+        edgeCount: number;
+    }>;
+    /**
+     * Connect to Realtime channel for bidirectional sync
+     */
+    connectRealtime(): Promise<void>;
+    /**
+     * Apply a mutation to the Y.Doc, save the delta, and broadcast
+     * Uses the EXISTING save_yjs_update RPC (no modifications)
+     */
+    applyChange(fn: (doc: Y.Doc) => void): Promise<number>;
+    /**
+     * Broadcast an update via Realtime channel
+     */
+    private broadcast;
+    /**
+     * Disconnect from Realtime
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Access the Y.Doc for read operations
+     */
+    getDoc(): Y.Doc;
+    /**
+     * Check if Realtime is connected
+     */
+    isConnected(): boolean;
+    getProjectId(): string;
+}
+//# sourceMappingURL=YjsProjectSession.d.ts.map

package/dist/yjs/YjsProjectSession.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"YjsProjectSession.d.ts","sourceRoot":"","sources":["../../src/yjs/YjsProjectSession.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,KAAK,EAAE,cAAc,EAAmB,MAAM,uBAAuB,CAAC;AAG7E,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,IAAI,CAAQ;IACpB,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAS;gBAEd,QAAQ,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM;IAMvD;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAuC/D;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBtC;;;OAGG;IACG,WAAW,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,KAAK,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC;IAkC5D;;OAEG;YACW,SAAS;IAkBvB;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAQjC;;OAEG;IACH,MAAM,IAAI,CAAC,CAAC,GAAG;IAIf;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB,YAAY,IAAI,MAAM;CAGvB"}

package/dist/yjs/YjsProjectSession.js

@@ -0,0 +1,129 @@
+import * as Y from 'yjs';
+import { uint8ArrayToBase64, base64ToUint8Array } from './BinaryEncoding.js';
+export class YjsProjectSession {
+    yDoc;
+    channel = null;
+    supabase;
+    projectId;
+    connected = false;
+    constructor(supabase, projectId) {
+        this.supabase = supabase;
+        this.projectId = projectId;
+        this.yDoc = new Y.Doc();
+    }
+    /**
+     * Load project state: snapshot + incremental updates
+     * Uses the EXISTING load_yjs_state_efficient RPC (no modifications)
+     */
+    async load() {
+        const { data, error } = await this.supabase.rpc('load_yjs_state_efficient', {
+            p_project_id: this.projectId,
+        });
+        if (error) {
+            throw new Error(`Failed to load project: ${error.message}`);
+        }
+        if (data && data.length > 0) {
+            const state = data[0];
+            // Apply snapshot
+            if (state.snapshot_base64) {
+                Y.applyUpdate(this.yDoc, base64ToUint8Array(state.snapshot_base64), 'remote');
+            }
+            // Apply incremental updates
+            if (state.updates && Array.isArray(state.updates)) {
+                for (const updateBase64 of state.updates) {
+                    Y.applyUpdate(this.yDoc, base64ToUint8Array(updateBase64), 'remote');
+                }
+            }
+        }
+        const nodeCount = this.yDoc.getMap('nodes').size;
+        const edgeCount = this.yDoc.getMap('edges').size;
+        return { nodeCount, edgeCount };
+    }
+    /**
+     * Connect to Realtime channel for bidirectional sync
+     */
+    async connectRealtime() {
+        this.channel = this.supabase.channel(`yjs-project-${this.projectId}`);
+        // Listen for updates from the web app
+        this.channel.on('broadcast', { event: 'yjs-update' }, ({ payload }) => {
+            if (payload.clientId === this.yDoc.clientID)
+                return; // Skip own
+            Y.applyUpdate(this.yDoc, new Uint8Array(payload.update), 'remote');
+        });
+        await this.channel.subscribe();
+        this.connected = true;
+    }
+    /**
+     * Apply a mutation to the Y.Doc, save the delta, and broadcast
+     * Uses the EXISTING save_yjs_update RPC (no modifications)
+     */
+    async applyChange(fn) {
+        let capturedUpdate = null;
+        const listener = (update, origin) => {
+            if (origin !== 'remote') {
+                capturedUpdate = update;
+            }
+        };
+        this.yDoc.on('update', listener);
+        this.yDoc.transact(() => fn(this.yDoc), 'local');
+        this.yDoc.off('update', listener);
+        if (!capturedUpdate)
+            return -1; // No-op
+        // Save to DB via existing RPC
+        const { data, error } = await this.supabase.rpc('save_yjs_update', {
+            p_project_id: this.projectId,
+            p_update_base64: uint8ArrayToBase64(capturedUpdate),
+            p_client_id: this.yDoc.clientID,
+        });
+        if (error) {
+            throw new Error(`Failed to save update: ${error.message}`);
+        }
+        const sequenceNumber = data;
+        // Broadcast to web app
+        await this.broadcast(capturedUpdate, sequenceNumber);
+        return sequenceNumber;
+    }
+    /**
+     * Broadcast an update via Realtime channel
+     */
+    async broadcast(update, seq) {
+        if (!this.channel)
+            return;
+        await this.channel.send({
+            type: 'broadcast',
+            event: 'yjs-update',
+            payload: {
+                sequence: seq,
+                update: Array.from(update),
+                clientId: this.yDoc.clientID,
+                timestamp: Date.now(),
+            },
+        });
+    }
+    /**
+     * Disconnect from Realtime
+     */
+    async disconnect() {
+        if (this.channel) {
+            await this.supabase.removeChannel(this.channel);
+            this.channel = null;
+        }
+        this.connected = false;
+    }
+    /**
+     * Access the Y.Doc for read operations
+     */
+    getDoc() {
+        return this.yDoc;
+    }
+    /**
+     * Check if Realtime is connected
+     */
+    isConnected() {
+        return this.connected;
+    }
+    getProjectId() {
+        return this.projectId;
+    }
+}
+//# sourceMappingURL=YjsProjectSession.js.map

package/dist/yjs/YjsProjectSession.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"YjsProjectSession.js","sourceRoot":"","sources":["../../src/yjs/YjsProjectSession.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@develosaur/mcp",
+  "version": "1.0.0",
+  "description": "Develosaur MCP server — AI agents track development progress in real-time",
+  "type": "module",
+  "main": "./dist/index.js",
+  "bin": {
+    "develosaur-mcp": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "@supabase/supabase-js": "^2.49.4",
+    "yjs": "^13.6.24"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "@types/node": "^22.0.0"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "mcp",
+    "develosaur",
+    "project-management",
+    "ai-agent",
+    "model-context-protocol"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}