@vizzly-testing/cli 0.23.1 → 0.23.2

package/claude-plugin/mcp/vizzly-docs-server/README.md

@@ -1,95 +0,0 @@
-# Vizzly Docs MCP Server
-
-MCP server that provides Claude Code with easy access to Vizzly documentation.
-
-## How It Works
-
-This server fetches documentation from the deployed `docs.vizzly.dev` site, making it easy for LLMs to:
-- Browse all available docs
-- Search documentation by keyword
-- Retrieve full markdown content
-- Understand the documentation structure
-
-## Tools
-
-### `list_docs`
-List all available documentation pages with optional category filtering.
-
-**Arguments:**
-- `category` (optional): Filter by category (e.g., "Integration > CLI", "Features")
-
-**Example:**
-```javascript
-list_docs({ category: "CLI" })
-```
-
-### `get_doc`
-Get the full markdown content of a specific documentation page.
-
-**Arguments:**
-- `path` (required): The document path (e.g., "integration/cli/overview.mdx") or slug (e.g., "integration/cli/overview")
-
-**Example:**
-```javascript
-get_doc({ path: "integration/cli/tdd-mode" })
-```
-
-### `search_docs`
-Search documentation by keyword. Searches in titles, descriptions, and categories.
-
-**Arguments:**
-- `query` (required): Search query
-- `limit` (optional): Maximum number of results (default: 10)
-
-**Example:**
-```javascript
-search_docs({ query: "parallel builds", limit: 5 })
-```
-
-### `get_sidebar`
-Get the complete sidebar navigation structure.
-
-**Example:**
-```javascript
-get_sidebar()
-```
-
-## Architecture
-
-The server works in a hybrid model:
-1. **Index** - Fetches a pre-built JSON index from `docs.vizzly.dev/api/mcp-index.json`
-2. **Content** - Fetches individual doc content on-demand from `docs.vizzly.dev/api/content/{path}`
-3. **Caching** - Index is cached for 5 minutes to minimize network requests
-
-This approach ensures:
-- Fast browsing/searching (uses cached index)
-- Always up-to-date content (fetched from live site)
-- Minimal network overhead
-- No local file dependencies
-
-## Data Flow
-
-```
-Claude Code
-    ↓
-MCP Server (this)
-    ↓
-docs.vizzly.dev API
-    ↓
-Statically generated at build time (Astro)
-```
-
-## Development
-
-To test the server locally:
-
-```bash
-# The server is automatically loaded by Claude Code when the plugin is active
-# Check .mcp.json for configuration
-```
-
-## Files
-
-- `index.js` - Main MCP server implementation
-- `docs-fetcher.js` - Utilities for fetching and searching docs
-- `README.md` - This file

package/claude-plugin/mcp/vizzly-docs-server/docs-fetcher.js

@@ -1,110 +0,0 @@
-/**
- * Fetches documentation from docs.vizzly.dev
- */
-
-let BASE_URL = 'https://docs.vizzly.dev';
-let INDEX_URL = `${BASE_URL}/api/mcp-index.json`;
-
-/**
- * Fetch the documentation index
- */
-export async function fetchDocsIndex() {
-  try {
-    let response = await fetch(INDEX_URL);
-
-    if (!response.ok) {
-      throw new Error(`Failed to fetch docs index: ${response.status} ${response.statusText}`);
-    }
-
-    let index = await response.json();
-    return index;
-  } catch (error) {
-    throw new Error(`Failed to load documentation index: ${error.message}`);
-  }
-}
-
-/**
- * Fetch the content of a specific document
- */
-export async function fetchDocContent(path) {
-  // Normalize path (remove leading slash, ensure it doesn't end with .md/.mdx)
-  let cleanPath = path.replace(/^\//, '').replace(/\.(mdx?|md)$/, '');
-
-  let contentUrl = `${BASE_URL}/api/content/${cleanPath}`;
-
-  try {
-    let response = await fetch(contentUrl);
-
-    if (!response.ok) {
-      // Try with .mdx extension if not found
-      if (response.status === 404 && !path.endsWith('.mdx')) {
-        contentUrl = `${BASE_URL}/api/content/${cleanPath}.mdx`;
-        response = await fetch(contentUrl);
-      }
-
-      if (!response.ok) {
-        throw new Error(`Document not found: ${path} (${response.status})`);
-      }
-    }
-
-    let content = await response.text();
-    return content;
-  } catch (error) {
-    throw new Error(`Failed to fetch document content: ${error.message}`);
-  }
-}
-
-/**
- * Search documents by query
- * Simple client-side search through titles and descriptions
- */
-export function searchDocs(docs, query, limit = 10) {
-  let lowerQuery = query.toLowerCase();
-  let terms = lowerQuery.split(/\s+/);
-
-  let results = docs
-    .map(doc => {
-      let titleLower = doc.title.toLowerCase();
-      let descLower = (doc.description || '').toLowerCase();
-      let categoryLower = doc.category.toLowerCase();
-
-      let score = 0;
-
-      // Exact phrase match in title (highest score)
-      if (titleLower.includes(lowerQuery)) {
-        score += 10;
-      }
-
-      // Exact phrase match in description
-      if (descLower.includes(lowerQuery)) {
-        score += 5;
-      }
-
-      // Exact phrase match in category
-      if (categoryLower.includes(lowerQuery)) {
-        score += 3;
-      }
-
-      // Individual term matches
-      for (let term of terms) {
-        if (titleLower.includes(term)) score += 3;
-        if (descLower.includes(term)) score += 1;
-        if (categoryLower.includes(term)) score += 0.5;
-      }
-
-      return { doc, score };
-    })
-    .filter(result => result.score > 0)
-    .sort((a, b) => b.score - a.score)
-    .slice(0, limit);
-
-  // Normalize scores to 0-1 range
-  if (results.length > 0) {
-    let maxScore = results[0].score;
-    for (let result of results) {
-      result.score = result.score / maxScore;
-    }
-  }
-
-  return results;
-}

package/claude-plugin/mcp/vizzly-docs-server/index.js

@@ -1,283 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Vizzly Docs MCP Server
- * Provides Claude Code with easy access to Vizzly documentation
- *
- * This server fetches docs from the deployed docs.vizzly.dev site,
- * making it easy for LLMs to navigate and retrieve documentation content.
- */
-
-import { Server } from '@modelcontextprotocol/sdk/server/index.js';
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
-import { fetchDocsIndex, fetchDocContent, searchDocs } from './docs-fetcher.js';
-
-class VizzlyDocsMCPServer {
-  constructor() {
-    this.server = new Server(
-      {
-        name: 'vizzly-docs',
-        version: '1.0.0'
-      },
-      {
-        capabilities: {
-          tools: {}
-        }
-      }
-    );
-
-    // Cache the index for the session
-    this.indexCache = null;
-    this.indexFetchTime = null;
-    this.CACHE_TTL = 5 * 60 * 1000; // 5 minutes
-
-    this.setupHandlers();
-  }
-
-  /**
-   * Get the docs index (with caching)
-   */
-  async getIndex() {
-    let now = Date.now();
-
-    if (!this.indexCache || !this.indexFetchTime || now - this.indexFetchTime > this.CACHE_TTL) {
-      this.indexCache = await fetchDocsIndex();
-      this.indexFetchTime = now;
-    }
-
-    return this.indexCache;
-  }
-
-  setupHandlers() {
-    // List available tools
-    this.server.setRequestHandler(ListToolsRequestSchema, async () => ({
-      tools: [
-        {
-          name: 'list_docs',
-          description:
-            'List all available Vizzly documentation pages. Returns title, description, category, and URL for each doc. Optionally filter by category.',
-          inputSchema: {
-            type: 'object',
-            properties: {
-              category: {
-                type: 'string',
-                description:
-                  'Optional category filter (e.g., "Integration > CLI", "Features"). Case-insensitive partial match.'
-              }
-            }
-          }
-        },
-        {
-          name: 'get_doc',
-          description:
-            'Get the full markdown content of a specific documentation page. Returns the raw MDX/markdown with frontmatter. Use the path or slug from list_docs.',
-          inputSchema: {
-            type: 'object',
-            properties: {
-              path: {
-                type: 'string',
-                description:
-                  'The document path (e.g., "integration/cli/overview.mdx") or slug (e.g., "integration/cli/overview"). Get this from list_docs or search_docs.'
-              }
-            },
-            required: ['path']
-          }
-        },
-        {
-          name: 'search_docs',
-          description:
-            'Search documentation by keyword. Searches in titles and descriptions. Returns matching docs with relevance scores.',
-          inputSchema: {
-            type: 'object',
-            properties: {
-              query: {
-                type: 'string',
-                description: 'Search query (e.g., "TDD mode", "authentication", "parallel builds")'
-              },
-              limit: {
-                type: 'number',
-                description: 'Maximum number of results to return (default: 10)',
-                default: 10
-              }
-            },
-            required: ['query']
-          }
-        },
-        {
-          name: 'get_sidebar',
-          description:
-            'Get the complete sidebar navigation structure. Useful for understanding how docs are organized and finding related pages.',
-          inputSchema: {
-            type: 'object',
-            properties: {}
-          }
-        }
-      ]
-    }));
-
-    // Handle tool calls
-    this.server.setRequestHandler(CallToolRequestSchema, async request => {
-      try {
-        switch (request.params.name) {
-          case 'list_docs':
-            return await this.handleListDocs(request.params.arguments);
-
-          case 'get_doc':
-            return await this.handleGetDoc(request.params.arguments);
-
-          case 'search_docs':
-            return await this.handleSearchDocs(request.params.arguments);
-
-          case 'get_sidebar':
-            return await this.handleGetSidebar();
-
-          default:
-            throw new Error(`Unknown tool: ${request.params.name}`);
-        }
-      } catch (error) {
-        return {
-          content: [
-            {
-              type: 'text',
-              text: `Error: ${error.message}`
-            }
-          ],
-          isError: true
-        };
-      }
-    });
-  }
-
-  async handleListDocs(args) {
-    let index = await this.getIndex();
-    let { category } = args || {};
-
-    let docs = index.docs;
-
-    // Filter by category if provided
-    if (category) {
-      let lowerCategory = category.toLowerCase();
-      docs = docs.filter(doc => doc.category.toLowerCase().includes(lowerCategory));
-    }
-
-    // Format response
-    let response = `# Vizzly Documentation (${docs.length} docs)\n\n`;
-
-    if (category) {
-      response += `Filtered by category: "${category}"\n\n`;
-    }
-
-    // Group by category
-    let byCategory = {};
-    for (let doc of docs) {
-      if (!byCategory[doc.category]) {
-        byCategory[doc.category] = [];
-      }
-      byCategory[doc.category].push(doc);
-    }
-
-    for (let [cat, catDocs] of Object.entries(byCategory)) {
-      response += `## ${cat}\n\n`;
-      for (let doc of catDocs) {
-        response += `- **${doc.title}**\n`;
-        response += `  - Path: \`${doc.path}\`\n`;
-        response += `  - Slug: \`${doc.slug}\`\n`;
-        if (doc.description) {
-          response += `  - ${doc.description}\n`;
-        }
-        response += `  - URL: ${doc.url}\n\n`;
-      }
-    }
-
-    return {
-      content: [
-        {
-          type: 'text',
-          text: response
-        }
-      ]
-    };
-  }
-
-  async handleGetDoc(args) {
-    let { path } = args;
-
-    if (!path) {
-      throw new Error('path parameter is required');
-    }
-
-    let content = await fetchDocContent(path);
-
-    return {
-      content: [
-        {
-          type: 'text',
-          text: content
-        }
-      ]
-    };
-  }
-
-  async handleSearchDocs(args) {
-    let { query, limit = 10 } = args;
-
-    if (!query) {
-      throw new Error('query parameter is required');
-    }
-
-    let index = await this.getIndex();
-    let results = searchDocs(index.docs, query, limit);
-
-    let response = `# Search Results for "${query}"\n\n`;
-    response += `Found ${results.length} matching docs:\n\n`;
-
-    for (let result of results) {
-      response += `## ${result.doc.title}\n`;
-      response += `- **Category:** ${result.doc.category}\n`;
-      response += `- **Path:** \`${result.doc.path}\`\n`;
-      response += `- **Relevance:** ${Math.round(result.score * 100)}%\n`;
-      if (result.doc.description) {
-        response += `- **Description:** ${result.doc.description}\n`;
-      }
-      response += `- **URL:** ${result.doc.url}\n\n`;
-    }
-
-    return {
-      content: [
-        {
-          type: 'text',
-          text: response
-        }
-      ]
-    };
-  }
-
-  async handleGetSidebar() {
-    let index = await this.getIndex();
-
-    let response = `# Vizzly Documentation Structure\n\n`;
-    response += JSON.stringify(index.sidebar, null, 2);
-
-    return {
-      content: [
-        {
-          type: 'text',
-          text: response
-        }
-      ]
-    };
-  }
-
-  async run() {
-    let transport = new StdioServerTransport();
-    await this.server.connect(transport);
-  }
-}
-
-// Start the server
-let server = new VizzlyDocsMCPServer();
-server.run().catch(error => {
-  console.error('Server error:', error);
-  process.exit(1);
-});