dxai-cli 1.0.0

package/src/registry/data/mcp-servers.json

@@ -0,0 +1,451 @@
+{
+  "categories": [
+    {
+      "id": "essential",
+      "label": "🔧 Essential",
+      "description": "Core tools every developer should have"
+    },
+    {
+      "id": "code-git",
+      "label": "💻 Code & Git",
+      "description": "Source control and code intelligence"
+    },
+    {
+      "id": "design",
+      "label": "🎨 Design",
+      "description": "Design-to-code workflows"
+    },
+    {
+      "id": "productivity",
+      "label": "📋 Productivity",
+      "description": "Project management and communication"
+    },
+    {
+      "id": "database",
+      "label": "🗄️  Database",
+      "description": "Database access and management"
+    },
+    {
+      "id": "browser",
+      "label": "🌐 Browser & Testing",
+      "description": "Browser automation and testing"
+    },
+    {
+      "id": "cloud",
+      "label": "☁️  Cloud & Deploy",
+      "description": "Deployment and infrastructure"
+    },
+    {
+      "id": "advanced",
+      "label": "⚡ Advanced",
+      "description": "Agent orchestration and specialized tools"
+    }
+  ],
+  "servers": [
+    {
+      "id": "context7",
+      "name": "Context7",
+      "description": "Live, version-specific library documentation",
+      "category": "essential",
+      "recommended": true,
+      "registry": {
+        "name": "io.github.upstash/context7",
+        "resolved": {
+          "version": "4.0.5",
+          "at": "2026-09-05T13:19:09.627Z",
+          "fields": [
+            "transport",
+            "requiresEnv",
+            "requiresInput",
+            "version",
+            "stale",
+            "staleReason"
+          ]
+        }
+      },
+      "transport": {
+        "type": "http",
+        "url": "https://mcp.context7.com/mcp"
+      }
+    },
+    {
+      "id": "sequential-thinking",
+      "name": "Sequential Thinking",
+      "description": "Multi-step structured reasoning for complex problems",
+      "category": "essential",
+      "recommended": true,
+      "version": "2025.12.18",
+      "transport": {
+        "type": "stdio",
+        "command": "npx",
+        "args": [
+          "-y",
+          "@modelcontextprotocol/server-sequential-thinking"
+        ]
+      }
+    },
+    {
+      "id": "github",
+      "name": "GitHub",
+      "description": "PRs, issues, repos, code search (official remote MCP, OAuth)",
+      "category": "code-git",
+      "recommended": true,
+      "registry": {
+        "name": "io.github.github/github-mcp-server",
+        "prefer": {
+          "transport": "remote"
+        },
+        "resolved": {
+          "version": "1.12.0",
+          "at": "2026-09-05T13:19:09.627Z",
+          "fields": [
+            "transport",
+            "requiresEnv",
+            "requiresInput",
+            "version",
+            "stale",
+            "staleReason"
+          ]
+        }
+      },
+      "transport": {
+        "type": "http",
+        "url": "https://api.githubcopilot.com/mcp/"
+      }
+    },
+    {
+      "id": "gitlab",
+      "name": "GitLab",
+      "description": "Merge requests, issues, pipelines (official remote MCP)",
+      "category": "code-git",
+      "registry": {
+        "name": "com.gitlab/mcp",
+        "resolved": {
+          "version": "0.0.1",
+          "at": "2026-09-05T13:19:09.627Z",
+          "fields": [
+            "transport",
+            "requiresEnv",
+            "requiresInput",
+            "version",
+            "stale",
+            "staleReason"
+          ]
+        }
+      },
+      "transport": {
+        "type": "http",
+        "url": "https://gitlab.com/api/v4/mcp"
+      }
+    },
+    {
+      "id": "claude-code-mcp",
+      "name": "Claude Code as MCP",
+      "description": "Use Claude Code as a sub-agent inside other editors",
+      "category": "code-git",
+      "transport": {
+        "type": "stdio",
+        "command": "npx",
+        "args": [
+          "-y",
+          "@anthropic-ai/claude-code-mcp"
+        ]
+      },
+      "excludeAgents": [
+        "claude-code",
+        "codex"
+      ]
+    },
+    {
+      "id": "figma",
+      "name": "Figma",
+      "description": "Design-to-code from Figma components",
+      "category": "design",
+      "registry": {
+        "name": "com.figma.mcp/mcp",
+        "resolved": {
+          "version": "1.0.3",
+          "at": "2026-09-05T13:19:09.627Z",
+          "fields": [
+            "transport",
+            "requiresEnv",
+            "requiresInput",
+            "version",
+            "stale",
+            "staleReason"
+          ]
+        }
+      },
+      "transport": {
+        "type": "http",
+        "url": "https://mcp.figma.com/mcp"
+      }
+    },
+    {
+      "id": "notion",
+      "name": "Notion",
+      "description": "Read/write Notion pages and databases",
+      "category": "productivity",
+      "registry": {
+        "name": "com.notion/mcp",
+        "resolved": {
+          "version": "1.0.1",
+          "at": "2026-09-05T13:19:09.627Z",
+          "fields": [
+            "transport",
+            "requiresEnv",
+            "requiresInput",
+            "version",
+            "stale",
+            "staleReason"
+          ]
+        }
+      },
+      "transport": {
+        "type": "http",
+        "url": "https://mcp.notion.com/mcp"
+      }
+    },
+    {
+      "id": "slack",
+      "name": "Slack",
+      "description": "Search messages, channels, send notifications",
+      "category": "productivity",
+      "stale": true,
+      "staleReason": "Upstream @modelcontextprotocol/server-slack is archived; no official remote MCP yet. Kept working for now.",
+      "requiresEnv": {
+        "SLACK_BOT_TOKEN": "Slack Bot OAuth Token"
+      },
+      "transport": {
+        "type": "stdio",
+        "command": "npx",
+        "args": [
+          "-y",
+          "@modelcontextprotocol/server-slack"
+        ]
+      }
+    },
+    {
+      "id": "linear",
+      "name": "Linear",
+      "description": "Issues, projects, cycles management (official remote MCP, OAuth)",
+      "category": "productivity",
+      "registry": {
+        "name": "app.linear/linear",
+        "resolved": {
+          "version": "1.0.1",
+          "at": "2026-09-05T13:19:09.627Z",
+          "fields": [
+            "transport",
+            "requiresEnv",
+            "requiresInput",
+            "version",
+            "stale",
+            "staleReason"
+          ]
+        }
+      },
+      "transport": {
+        "type": "http",
+        "url": "https://mcp.linear.app/mcp"
+      }
+    },
+    {
+      "id": "supabase",
+      "name": "Supabase",
+      "description": "Supabase database, auth, storage (official remote MCP)",
+      "category": "database",
+      "registry": {
+        "name": "com.supabase/mcp",
+        "resolved": {
+          "version": "0.12.0",
+          "at": "2026-09-05T13:19:09.627Z",
+          "fields": [
+            "transport",
+            "requiresEnv",
+            "requiresInput",
+            "version",
+            "stale",
+            "staleReason"
+          ]
+        }
+      },
+      "transport": {
+        "type": "http",
+        "url": "https://mcp.supabase.com/mcp"
+      }
+    },
+    {
+      "id": "neon",
+      "name": "Neon Postgres",
+      "description": "Serverless Postgres database",
+      "category": "database",
+      "requiresEnv": {
+        "NEON_API_KEY": "Neon API Key"
+      },
+      "transport": {
+        "type": "stdio",
+        "command": "npx",
+        "args": [
+          "-y",
+          "@neondatabase/mcp-server-neon"
+        ]
+      }
+    },
+    {
+      "id": "playwright",
+      "name": "Playwright",
+      "description": "Browser automation, E2E testing, screenshots",
+      "category": "browser",
+      "recommended": true,
+      "registry": {
+        "name": "io.github.microsoft/playwright-mcp",
+        "resolved": {
+          "version": "0.0.79",
+          "at": "2026-09-05T13:19:09.627Z",
+          "fields": [
+            "transport",
+            "requiresEnv",
+            "requiresInput",
+            "version",
+            "stale",
+            "staleReason"
+          ]
+        }
+      },
+      "transport": {
+        "type": "stdio",
+        "command": "npx",
+        "args": [
+          "-y",
+          "@playwright/mcp"
+        ]
+      }
+    },
+    {
+      "id": "browserbase",
+      "name": "Browserbase",
+      "description": "Cloud browser sessions for testing",
+      "category": "browser",
+      "registry": {
+        "name": "io.github.browserbase/mcp-server-browserbase",
+        "resolved": {
+          "version": "2.1.1",
+          "at": "2026-09-05T13:19:09.627Z",
+          "fields": [
+            "transport",
+            "requiresEnv",
+            "requiresInput",
+            "version",
+            "stale",
+            "staleReason"
+          ]
+        }
+      },
+      "requiresEnv": {
+        "BROWSERBASE_API_KEY": "Your Browserbase API key",
+        "BROWSERBASE_PROJECT_ID": "Your Browserbase Project ID",
+        "GEMINI_API_KEY": "Your Gemini API key (default model)"
+      },
+      "transport": {
+        "type": "stdio",
+        "command": "npx",
+        "args": [
+          "-y",
+          "@browserbasehq/mcp-server-browserbase"
+        ]
+      }
+    },
+    {
+      "id": "vercel",
+      "name": "Vercel",
+      "description": "Deploy, manage projects, domains (official remote MCP)",
+      "category": "cloud",
+      "registry": {
+        "name": "com.vercel/vercel-mcp",
+        "resolved": {
+          "version": "0.0.3",
+          "at": "2026-09-05T13:19:09.627Z",
+          "fields": [
+            "transport",
+            "requiresEnv",
+            "requiresInput",
+            "version",
+            "stale",
+            "staleReason"
+          ]
+        }
+      },
+      "transport": {
+        "type": "http",
+        "url": "https://mcp.vercel.com"
+      }
+    },
+    {
+      "id": "cloudflare",
+      "name": "Cloudflare",
+      "description": "Workers bindings: KV, D1, R2, Durable Objects (official remote MCP)",
+      "category": "cloud",
+      "registry": {
+        "name": "com.cloudflare.mcp/mcp",
+        "prefer": {
+          "remote": "bindings.mcp.cloudflare.com"
+        },
+        "resolved": {
+          "version": "1.0.0",
+          "at": "2026-09-05T13:19:09.627Z",
+          "fields": [
+            "transport",
+            "requiresEnv",
+            "requiresInput",
+            "version",
+            "stale",
+            "staleReason"
+          ]
+        }
+      },
+      "transport": {
+        "type": "http",
+        "url": "https://bindings.mcp.cloudflare.com/mcp"
+      }
+    },
+    {
+      "id": "filesystem",
+      "name": "Filesystem",
+      "description": "Secure file access outside project root",
+      "category": "advanced",
+      "version": "2026.1.14",
+      "requiresInput": {
+        "allowedPath": {
+          "prompt": "Path the filesystem MCP is allowed to access",
+          "default": "~",
+          "placeholder": "/path/to/allowed"
+        }
+      },
+      "transport": {
+        "type": "stdio",
+        "command": "npx",
+        "args": [
+          "-y",
+          "@modelcontextprotocol/server-filesystem",
+          "/path/to/allowed"
+        ]
+      }
+    },
+    {
+      "id": "memory",
+      "name": "Memory",
+      "description": "Persistent memory across agent sessions",
+      "category": "advanced",
+      "version": "2026.1.26",
+      "transport": {
+        "type": "stdio",
+        "command": "npx",
+        "args": [
+          "-y",
+          "@modelcontextprotocol/server-memory"
+        ]
+      }
+    }
+  ]
+}

package/src/registry/data/skills.json

@@ -0,0 +1,132 @@
+{
+  "categories": [
+    {
+      "id": "anthropic",
+      "label": "🔵 Anthropic Official"
+    },
+    {
+      "id": "vercel",
+      "label": "▲ Vercel Labs"
+    },
+    {
+      "id": "community",
+      "label": "🌍 Community"
+    }
+  ],
+  "skills": [
+    {
+      "id": "frontend-design",
+      "name": "Frontend Design",
+      "description": "Production-grade UI with high design quality",
+      "category": "anthropic",
+      "recommended": true,
+      "repo": "anthropics/skills",
+      "path": "skills/frontend-design"
+    },
+    {
+      "id": "skill-creator",
+      "name": "Skill Creator",
+      "description": "Create, test, and optimize custom skills",
+      "category": "anthropic",
+      "recommended": true,
+      "repo": "anthropics/skills",
+      "path": "skills/skill-creator"
+    },
+    {
+      "id": "docx",
+      "name": "Document (docx)",
+      "description": "Professional Word document generation",
+      "category": "anthropic",
+      "repo": "anthropics/skills",
+      "path": "skills/docx"
+    },
+    {
+      "id": "pdf",
+      "name": "PDF",
+      "description": "PDF creation, extraction, and manipulation",
+      "category": "anthropic",
+      "repo": "anthropics/skills",
+      "path": "skills/pdf"
+    },
+    {
+      "id": "pptx",
+      "name": "Presentation (pptx)",
+      "description": "Slide deck and presentation creation",
+      "category": "anthropic",
+      "repo": "anthropics/skills",
+      "path": "skills/pptx"
+    },
+    {
+      "id": "xlsx",
+      "name": "Spreadsheet (xlsx)",
+      "description": "Excel/spreadsheet generation",
+      "category": "anthropic",
+      "repo": "anthropics/skills",
+      "path": "skills/xlsx"
+    },
+    {
+      "id": "algorithmic-art",
+      "name": "Algorithmic Art",
+      "description": "Generative art and creative coding",
+      "category": "anthropic",
+      "repo": "anthropics/skills",
+      "path": "skills/algorithmic-art"
+    },
+    {
+      "id": "canvas-design",
+      "name": "Canvas Design",
+      "description": "HTML Canvas-based visual design",
+      "category": "anthropic",
+      "repo": "anthropics/skills",
+      "path": "skills/canvas-design"
+    },
+    {
+      "id": "mcp-builder",
+      "name": "MCP Server Builder",
+      "description": "Build custom MCP servers",
+      "category": "anthropic",
+      "repo": "anthropics/skills",
+      "path": "skills/mcp-builder"
+    },
+    {
+      "id": "webapp-testing",
+      "name": "Web App Testing",
+      "description": "Automated testing for web applications",
+      "category": "anthropic",
+      "repo": "anthropics/skills",
+      "path": "skills/webapp-testing"
+    },
+    {
+      "id": "claude-api",
+      "name": "Claude API",
+      "description": "Build apps with the Claude API",
+      "category": "anthropic",
+      "repo": "anthropics/skills",
+      "path": "skills/claude-api"
+    },
+    {
+      "id": "web-artifacts-builder",
+      "name": "Web Artifacts Builder",
+      "description": "Build interactive web artifacts",
+      "category": "anthropic",
+      "repo": "anthropics/skills",
+      "path": "skills/web-artifacts-builder"
+    },
+    {
+      "id": "find-skills",
+      "name": "Find Skills",
+      "description": "Discover and install agent skills",
+      "category": "vercel",
+      "repo": "vercel-labs/skills",
+      "path": "skills/find-skills"
+    },
+    {
+      "id": "better-auth",
+      "name": "Better Auth",
+      "description": "Authentication best practices",
+      "category": "community",
+      "repo": "better-auth/skills",
+      "path": "better-auth/best-practices"
+    }
+  ]
+}

package/src/registry/loader.js

@@ -0,0 +1,102 @@
+// Registry loader — overlays remote/cached registry on top of bundled JSON.
+//
+// Resolution order at module init (synchronous):
+//   1. Cache at ~/.dxai/cache/<name>.json  (written by `dxai update`)
+//   2. Bundled snapshot at src/registry/data/<name>.json
+//
+// `dxai update` does the actual remote fetch and writes the cache. Reading is
+// always synchronous so we don't impose top-level await on consumers.
+
+import fs from 'fs-extra';
+import path from 'path';
+import os from 'os';
+import { fileURLToPath } from 'node:url';
+import { isSafeVersionRef } from './validate.js';
+import { writeJsonAtomic } from '../fs-atomic.js';
+import { fetchJson } from '../net.js';
+
+// Default timeout for a registry fetch, so `dxai update` can't hang forever on a
+// stalled connection.
+const DEFAULT_FETCH_TIMEOUT_MS = 15000;
+
+const HOME = os.homedir();
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+export const CACHE_DIR = path.join(HOME, '.dxai', 'cache');
+const BUNDLED_DIR = path.join(__dirname, 'data');
+
+// Default remote URL — points at the bundled JSON in the repo. Overridable
+// via the DXAI_REGISTRY_URL env var; that's the supported escape hatch for
+// teams who want to host a fork.
+export const DEFAULT_REGISTRY_BASE =
+  process.env.DXAI_REGISTRY_URL ||
+  'https://raw.githubusercontent.com/nandha-kumar-hajari/dxai/main/src/registry/data';
+
+// Resolve the registry base URL for a fetch. Precedence:
+//   explicit url  >  version ref (swaps the branch segment of the default)  >  default.
+// When DXAI_REGISTRY_URL is set but carries no `/main/` segment, a version ref is a no-op.
+export function registryBaseFor({ version, url } = {}) {
+  if (url) return url;
+  if (version) {
+    // `version` is substituted into the fetch URL path; a "../.." here could
+    // repoint the fetch at a different repo. Only allow a clean branch/tag ref.
+    if (!isSafeVersionRef(version)) {
+      throw new Error(`Invalid registry version ref: ${version}`);
+    }
+    return DEFAULT_REGISTRY_BASE.replace(/\/main\//, `/${version}/`);
+  }
+  return DEFAULT_REGISTRY_BASE;
+}
+
+function readJsonOr(filePath, fallback) {
+  if (!fs.existsSync(filePath)) return fallback;
+  try {
+    return fs.readJsonSync(filePath);
+  } catch {
+    return fallback;
+  }
+}
+
+// Synchronously load a registry file: cache > bundled. Returns parsed JSON.
+// DXAI_REGISTRY_SOURCE=bundled skips the cache — the test runner, doc
+// generators and catalogue scripts set it so a developer's stale ~/.dxai cache
+// can never stand in for the JSON that is actually in the repo.
+export function loadRegistry(name) {
+  const cachePath = path.join(CACHE_DIR, `${name}.json`);
+  const bundledPath = path.join(BUNDLED_DIR, `${name}.json`);
+
+  const bundled = readJsonOr(bundledPath, null);
+  if (!bundled) {
+    throw new Error(`Bundled registry missing: ${bundledPath}`);
+  }
+
+  if (process.env.DXAI_REGISTRY_SOURCE === 'bundled') return bundled;
+  const cached = readJsonOr(cachePath, null);
+  return cached ?? bundled;
+}
+
+// Remote fetch — used by `dxai update`. Async, since we hit the network.
+// timeoutMs (optional) aborts a slow fetch; used by the background auto-refresh
+// so a stale network never blocks an interactive run for long.
+export async function fetchRegistry(name, baseUrl = DEFAULT_REGISTRY_BASE, { timeoutMs = DEFAULT_FETCH_TIMEOUT_MS, retries } = {}) {
+  const url = `${baseUrl.replace(/\/$/, '')}/${name}.json`;
+  const data = await fetchJson(url, { timeoutMs, retries });
+  return { url, data };
+}
+
+export function writeRegistryCache(name, data) {
+  const cachePath = path.join(CACHE_DIR, `${name}.json`);
+  writeJsonAtomic(cachePath, data, { spaces: 2 });
+  return cachePath;
+}
+
+// Diff two registry payloads; returns added/removed entries by ID.
+// Works on { servers: [...] } / { skills: [...] } / generic { items: [...] }.
+export function diffRegistry(prev, next, key) {
+  const prevIds = new Set((prev?.[key] || []).map((x) => x.id));
+  const nextIds = new Set((next?.[key] || []).map((x) => x.id));
+  const added = [...nextIds].filter((id) => !prevIds.has(id));
+  const removed = [...prevIds].filter((id) => !nextIds.has(id));
+  return { added, removed };
+}