@unified-product-graph/cloud-server 0.6.0

package/docker/Dockerfile

@@ -0,0 +1,14 @@
+FROM node:22-slim AS builder
+WORKDIR /app
+COPY package.json tsconfig.json ./
+RUN npm install
+COPY src/ ./src/
+RUN npx tsup
+
+FROM node:22-slim
+WORKDIR /app
+COPY --from=builder /app/dist ./dist
+COPY --from=builder /app/node_modules ./node_modules
+COPY package.json ./
+COPY migrations/ ./migrations/
+ENTRYPOINT ["node", "dist/index.js"]

package/docker/docker-compose.yml

@@ -0,0 +1,33 @@
+version: '3.8'
+
+services:
+  postgres:
+    image: postgres:16-alpine
+    environment:
+      POSTGRES_DB: upg
+      POSTGRES_USER: upg
+      POSTGRES_PASSWORD: upg
+    ports:
+      - "5433:5432"
+    volumes:
+      - pgdata:/var/lib/postgresql/data
+      - ../migrations:/docker-entrypoint-initdb.d
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U upg"]
+      interval: 5s
+      timeout: 5s
+      retries: 5
+
+  upg-cloud:
+    build:
+      context: ..
+      dockerfile: docker/Dockerfile
+    depends_on:
+      postgres:
+        condition: service_healthy
+    environment:
+      UPG_DATABASE_URL: postgres://upg:upg@postgres:5432/upg
+    stdin_open: true
+
+volumes:
+  pgdata:

package/migrations/001_initial.sql

@@ -0,0 +1,70 @@
+-- UPG Cloud Server: Initial Schema
+-- Run this against your Postgres database before starting the server.
+
+CREATE SCHEMA IF NOT EXISTS upg;
+
+-- Products
+CREATE TABLE upg.products (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  title TEXT NOT NULL,
+  description TEXT,
+  stage TEXT DEFAULT 'idea' CHECK (stage IN ('idea', 'mvp', 'growth', 'scale')),
+  metadata JSONB DEFAULT '{}',
+  created_at TIMESTAMPTZ DEFAULT now(),
+  updated_at TIMESTAMPTZ DEFAULT now()
+);
+
+-- Nodes (entities)
+CREATE TABLE upg.nodes (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  product_id UUID NOT NULL REFERENCES upg.products(id) ON DELETE CASCADE,
+  type TEXT NOT NULL,
+  title TEXT NOT NULL,
+  description TEXT,
+  status TEXT DEFAULT 'active',
+  tags TEXT[] DEFAULT '{}',
+  data JSONB DEFAULT '{}',
+  created_at TIMESTAMPTZ DEFAULT now(),
+  updated_at TIMESTAMPTZ DEFAULT now()
+);
+
+-- Edges (relationships)
+CREATE TABLE upg.edges (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  product_id UUID NOT NULL REFERENCES upg.products(id) ON DELETE CASCADE,
+  source UUID NOT NULL REFERENCES upg.nodes(id) ON DELETE CASCADE,
+  target UUID NOT NULL REFERENCES upg.nodes(id) ON DELETE CASCADE,
+  type TEXT NOT NULL,
+  metadata JSONB DEFAULT '{}',
+  created_at TIMESTAMPTZ DEFAULT now()
+);
+
+-- Full-text search on nodes
+CREATE INDEX idx_nodes_fts ON upg.nodes USING gin(
+  to_tsvector('english', coalesce(title, '') || ' ' || coalesce(description, ''))
+);
+
+-- Performance indexes
+CREATE INDEX idx_nodes_product ON upg.nodes(product_id);
+CREATE INDEX idx_nodes_type ON upg.nodes(product_id, type);
+CREATE INDEX idx_edges_product ON upg.edges(product_id);
+CREATE INDEX idx_edges_source ON upg.edges(source);
+CREATE INDEX idx_edges_target ON upg.edges(target);
+CREATE INDEX idx_edges_type ON upg.edges(product_id, type);
+
+-- Updated_at trigger
+CREATE OR REPLACE FUNCTION upg.update_updated_at()
+RETURNS TRIGGER AS $$
+BEGIN
+  NEW.updated_at = now();
+  RETURN NEW;
+END;
+$$ LANGUAGE plpgsql;
+
+CREATE TRIGGER trg_products_updated_at
+  BEFORE UPDATE ON upg.products
+  FOR EACH ROW EXECUTE FUNCTION upg.update_updated_at();
+
+CREATE TRIGGER trg_nodes_updated_at
+  BEFORE UPDATE ON upg.nodes
+  FOR EACH ROW EXECUTE FUNCTION upg.update_updated_at();

package/migrations/002_collaboration.sql

@@ -0,0 +1,41 @@
+-- Collaboration primitives: audit log, comments, access control
+
+-- Audit log: who changed what, when
+CREATE TABLE upg.audit_log (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  product_id UUID NOT NULL REFERENCES upg.products(id) ON DELETE CASCADE,
+  user_id TEXT,
+  action TEXT NOT NULL CHECK (action IN ('create', 'update', 'delete')),
+  entity_type TEXT NOT NULL CHECK (entity_type IN ('node', 'edge', 'product')),
+  entity_id UUID NOT NULL,
+  changes JSONB,
+  created_at TIMESTAMPTZ DEFAULT now()
+);
+
+CREATE INDEX idx_audit_log_product ON upg.audit_log(product_id, created_at DESC);
+CREATE INDEX idx_audit_log_entity ON upg.audit_log(entity_id);
+
+-- Comments on entities
+CREATE TABLE upg.comments (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  product_id UUID NOT NULL REFERENCES upg.products(id) ON DELETE CASCADE,
+  node_id UUID REFERENCES upg.nodes(id) ON DELETE CASCADE,
+  user_id TEXT NOT NULL,
+  body TEXT NOT NULL,
+  created_at TIMESTAMPTZ DEFAULT now()
+);
+
+CREATE INDEX idx_comments_node ON upg.comments(node_id, created_at DESC);
+
+-- Access control
+CREATE TABLE upg.access (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  product_id UUID NOT NULL REFERENCES upg.products(id) ON DELETE CASCADE,
+  user_id TEXT NOT NULL,
+  role TEXT NOT NULL CHECK (role IN ('owner', 'editor', 'viewer')),
+  created_at TIMESTAMPTZ DEFAULT now(),
+  UNIQUE(product_id, user_id)
+);
+
+CREATE INDEX idx_access_product ON upg.access(product_id);
+CREATE INDEX idx_access_user ON upg.access(user_id);

package/migrations/003_webhooks.sql

@@ -0,0 +1,14 @@
+-- Webhook event system
+
+CREATE TABLE upg.webhooks (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  product_id UUID NOT NULL REFERENCES upg.products(id) ON DELETE CASCADE,
+  event TEXT NOT NULL,
+  url TEXT NOT NULL,
+  secret TEXT,
+  active BOOLEAN DEFAULT true,
+  created_at TIMESTAMPTZ DEFAULT now()
+);
+
+CREATE INDEX idx_webhooks_product ON upg.webhooks(product_id);
+CREATE INDEX idx_webhooks_event ON upg.webhooks(product_id, event);

package/migrations/004_cross_product_edges.sql

@@ -0,0 +1,22 @@
+-- Cross-product edges: portfolio-level relationships between products.
+-- Supports the portfolio family of tools and `repair_dangling_edges`.
+--
+-- In local .upg files, cross-product edges live in portfolio.cross_edges[].
+-- Cloud needs a dedicated table because products are rows, not files.
+-- IDs are TEXT (nanoid-prefixed, matching the cloud server's id minting pattern)
+-- rather than UUID, matching how the MCP server generates IDs at the tool layer.
+
+CREATE TABLE IF NOT EXISTS upg.cross_product_edges (
+  id TEXT PRIMARY KEY,
+  source TEXT NOT NULL,                     -- qualified: "{product_id}/{node_id}"
+  target TEXT NOT NULL,                     -- qualified: "{product_id}/{node_id}"
+  type TEXT NOT NULL,                       -- must be in UPG_CROSS_EDGE_TYPES
+  created_by_product_id TEXT NOT NULL,      -- which product "owns" this cross-edge
+  created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+CREATE INDEX IF NOT EXISTS idx_cross_product_edges_owner
+  ON upg.cross_product_edges(created_by_product_id);
+
+CREATE INDEX IF NOT EXISTS idx_cross_product_edges_type
+  ON upg.cross_product_edges(type);

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "@unified-product-graph/cloud-server",
+  "version": "0.6.0",
+  "description": "Postgres-backed MCP server for the Unified Product Graph \u2014 self-hostable, open source",
+  "license": "MIT",
+  "author": "The Product Creator <hello@theproductcreator.com>",
+  "homepage": "https://unifiedproductgraph.org",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/unified-product-graph/cloud-server.git"
+  },
+  "type": "module",
+  "bin": {
+    "upg-cloud-server": "dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "migrations",
+    "docker",
+    "CHANGELOG.md",
+    "SELF-HOSTING.md"
+  ],
+  "scripts": {
+    "prebuild": "npm run build --workspace=@unified-product-graph/mcp-tooling 2>/dev/null || true",
+    "pregenerate-tools": "npm run build --workspace=@unified-product-graph/mcp-tooling 2>/dev/null || true",
+    "build": "tsup",
+    "postbuild": "npm run generate-tools",
+    "dev": "tsx src/index.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:integration": "vitest run --config vitest.integration.config.ts",
+    "generate-tools": "tsx scripts/generate-tool-reference.ts",
+    "generate-tools:check": "tsx scripts/generate-tool-reference.ts --check",
+    "type-check": "tsc --noEmit",
+    "lint": "eslint src/",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.0",
+    "@unified-product-graph/core": "*",
+    "@unified-product-graph/sdk": "*",
+    "nanoid": "^5.1.0",
+    "pg": "^8.13.0"
+  },
+  "devDependencies": {
+    "@types/pg": "^8.11.0",
+    "tsup": "^8.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.8.0",
+    "typescript-eslint": "^8.0.0",
+    "eslint": "^9.0.0",
+    "@unified-product-graph/mcp-tooling": "*"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "bugs": {
+    "url": "https://github.com/unified-product-graph/cloud-server/issues"
+  },
+  "keywords": [
+    "mcp",
+    "upg",
+    "unified-product-graph",
+    "product-management",
+    "model-context-protocol",
+    "knowledge-graph",
+    "postgres",
+    "self-hosted"
+  ]
+}