@vizzly-testing/cli 0.23.0 → 0.23.2

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);
-});

package/claude-plugin/mcp/vizzly-server/cloud-api-provider.js

@@ -1,399 +0,0 @@
-/**
- * Provider for Vizzly Cloud API integration
- */
-export class CloudAPIProvider {
-  constructor() {
-    this.defaultApiUrl = process.env.VIZZLY_API_URL || 'https://app.vizzly.dev';
-  }
-
-  /**
-   * Make API request to Vizzly
-   */
-  async makeRequest(path, apiToken, apiUrl = this.defaultApiUrl) {
-    if (!apiToken) {
-      throw new Error(
-        'API token required. Set VIZZLY_TOKEN environment variable or provide via apiToken parameter.'
-      );
-    }
-
-    let url = `${apiUrl}${path}`;
-    let response = await fetch(url, {
-      headers: {
-        Authorization: `Bearer ${apiToken}`,
-        'User-Agent': 'Vizzly-Claude-Plugin/0.1.0'
-      }
-    });
-
-    if (!response.ok) {
-      let error = await response.text();
-      throw new Error(`API request failed (${response.status}): ${error}`);
-    }
-
-    return response.json();
-  }
-
-  /**
-   * Get build status and details
-   */
-  async getBuildStatus(buildId, apiToken, apiUrl) {
-    if (!buildId || typeof buildId !== 'string') {
-      throw new Error('buildId is required and must be a non-empty string');
-    }
-
-    let data = await this.makeRequest(
-      `/api/sdk/builds/${buildId}?include=comparisons`,
-      apiToken,
-      apiUrl
-    );
-
-    let { build } = data;
-
-    // Calculate comparison summary
-    // Note: API returns 'result' field (not 'status'), and doesn't have 'has_diff'
-    // result can be: 'identical', 'changed', 'new', 'removed', 'error', 'missing', 'returning'
-    let comparisons = build.comparisons || [];
-
-    // Calculate basic comparison summary
-    let changedComparisons = comparisons.filter((c) => c.result === 'changed' || (c.diff_percentage && c.diff_percentage > 0));
-
-    let summary = {
-      total: comparisons.length,
-      new: comparisons.filter((c) => c.result === 'new').length,
-      changed: changedComparisons.length,
-      identical: comparisons.filter((c) => c.result === 'identical' || (c.result !== 'new' && c.result !== 'changed' && (!c.diff_percentage || c.diff_percentage === 0))).length,
-      // Approval status breakdown
-      approval: {
-        pending: comparisons.filter((c) => c.approval_status === 'pending').length,
-        approved: comparisons.filter((c) => c.approval_status === 'approved').length,
-        rejected: comparisons.filter((c) => c.approval_status === 'rejected').length,
-        autoApproved: comparisons.filter((c) => c.approval_status === 'auto_approved').length
-      },
-      // Flaky screenshot count
-      flaky: comparisons.filter((c) => c.is_flaky).length
-    };
-
-    // Keep minimal for token efficiency - use read_comparison_details for full metadata
-    let failedComparisons = comparisons
-      .filter((c) => c.result === 'changed' || (c.diff_percentage && c.diff_percentage > 0))
-      .map((c) => ({
-        id: c.id,
-        name: c.current_name || c.name,
-        diffPercentage: c.diff_percentage,
-        approvalStatus: c.approval_status,
-        // Include hot spot coverage % for quick triage (single number)
-        hotSpotCoverage: c.analysis_metadata?.hot_spot_coverage || null
-      }));
-
-    let newComparisons = comparisons
-      .filter((c) => c.result === 'new')
-      .map((c) => ({
-        name: c.name,
-        currentUrl: c.current_screenshot?.original_url
-      }));
-
-    return {
-      build: {
-        id: build.id,
-        name: build.name,
-        branch: build.branch,
-        status: build.status,
-        url: build.url,
-        organizationSlug: build.organizationSlug,
-        projectSlug: build.projectSlug,
-        createdAt: build.created_at,
-        // Include commit details for debugging
-        commitSha: build.commit_sha,
-        commitMessage: build.commit_message,
-        commonAncestorSha: build.common_ancestor_sha
-      },
-      summary,
-      failedComparisons,
-      newComparisons
-    };
-  }
-
-  /**
-   * List recent builds
-   */
-  async listRecentBuilds(apiToken, options = {}) {
-    let { limit = 10, branch, apiUrl } = options;
-
-    let queryParams = new URLSearchParams({
-      limit: limit.toString()
-    });
-
-    if (branch) {
-      queryParams.append('branch', branch);
-    }
-
-    let data = await this.makeRequest(`/api/sdk/builds?${queryParams}`, apiToken, apiUrl);
-
-    return {
-      builds: data.builds.map((b) => ({
-        id: b.id,
-        name: b.name,
-        branch: b.branch,
-        status: b.status,
-        environment: b.environment,
-        createdAt: b.created_at
-      })),
-      pagination: data.pagination
-    };
-  }
-
-  /**
-   * Get token context (organization and project info)
-   */
-  async getTokenContext(apiToken, apiUrl) {
-    return await this.makeRequest('/api/sdk/token/context', apiToken, apiUrl);
-  }
-
-  /**
-   * Get comparison details
-   */
-  async getComparison(comparisonId, apiToken, apiUrl) {
-    if (!comparisonId || typeof comparisonId !== 'string') {
-      throw new Error('comparisonId is required and must be a non-empty string');
-    }
-
-    let data = await this.makeRequest(`/api/sdk/comparisons/${comparisonId}`, apiToken, apiUrl);
-
-    return data.comparison;
-  }
-
-  /**
-   * Search for comparisons by name across builds
-   */
-  async searchComparisons(name, apiToken, options = {}) {
-    if (!name || typeof name !== 'string') {
-      throw new Error('name is required and must be a non-empty string');
-    }
-
-    let { branch, limit = 50, offset = 0, apiUrl } = options;
-
-    let queryParams = new URLSearchParams({
-      name,
-      limit: limit.toString(),
-      offset: offset.toString()
-    });
-
-    if (branch) {
-      queryParams.append('branch', branch);
-    }
-
-    let data = await this.makeRequest(
-      `/api/sdk/comparisons/search?${queryParams}`,
-      apiToken,
-      apiUrl
-    );
-
-    return data;
-  }
-
-  // ==================================================================
-  // BUILD COMMENTS
-  // ==================================================================
-
-  /**
-   * Create a comment on a build
-   */
-  async createBuildComment(buildId, content, type, apiToken, apiUrl) {
-    if (!buildId || typeof buildId !== 'string') {
-      throw new Error('buildId is required and must be a non-empty string');
-    }
-    if (!content || typeof content !== 'string') {
-      throw new Error('content is required and must be a non-empty string');
-    }
-
-    let url = `${apiUrl || this.defaultApiUrl}/api/sdk/builds/${buildId}/comments`;
-    let response = await fetch(url, {
-      method: 'POST',
-      headers: {
-        Authorization: `Bearer ${apiToken}`,
-        'User-Agent': 'Vizzly-Claude-Plugin/0.1.0',
-        'Content-Type': 'application/json'
-      },
-      body: JSON.stringify({ content, type })
-    });
-
-    if (!response.ok) {
-      let error = await response.text();
-      throw new Error(`Failed to create comment (${response.status}): ${error}`);
-    }
-
-    return response.json();
-  }
-
-  /**
-   * List comments for a build
-   */
-  async listBuildComments(buildId, apiToken, apiUrl) {
-    if (!buildId || typeof buildId !== 'string') {
-      throw new Error('buildId is required and must be a non-empty string');
-    }
-
-    let data = await this.makeRequest(`/api/sdk/builds/${buildId}/comments`, apiToken, apiUrl);
-
-    // Filter out unnecessary fields from comments for MCP
-    let filterComment = (comment) => {
-      // eslint-disable-next-line no-unused-vars
-      let { profile_photo_url, email, ...filtered } = comment;
-      // Recursively filter replies if they exist
-      if (filtered.replies && Array.isArray(filtered.replies)) {
-        filtered.replies = filtered.replies.map(filterComment);
-      }
-      return filtered;
-    };
-
-    return {
-      ...data,
-      comments: data.comments ? data.comments.map(filterComment) : []
-    };
-  }
-
-  // ==================================================================
-  // COMPARISON APPROVALS
-  // ==================================================================
-
-  /**
-   * Approve a comparison
-   */
-  async approveComparison(comparisonId, comment, apiToken, apiUrl) {
-    if (!comparisonId || typeof comparisonId !== 'string') {
-      throw new Error('comparisonId is required and must be a non-empty string');
-    }
-
-    let url = `${apiUrl || this.defaultApiUrl}/api/sdk/comparisons/${comparisonId}/approve`;
-    let response = await fetch(url, {
-      method: 'POST',
-      headers: {
-        Authorization: `Bearer ${apiToken}`,
-        'User-Agent': 'Vizzly-Claude-Plugin/0.1.0',
-        'Content-Type': 'application/json'
-      },
-      body: JSON.stringify({ comment })
-    });
-
-    if (!response.ok) {
-      let error = await response.text();
-      throw new Error(`Failed to approve comparison (${response.status}): ${error}`);
-    }
-
-    return response.json();
-  }
-
-  /**
-   * Reject a comparison
-   */
-  async rejectComparison(comparisonId, reason, apiToken, apiUrl) {
-    if (!comparisonId || typeof comparisonId !== 'string') {
-      throw new Error('comparisonId is required and must be a non-empty string');
-    }
-    if (!reason || typeof reason !== 'string') {
-      throw new Error('reason is required and must be a non-empty string');
-    }
-
-    let url = `${apiUrl || this.defaultApiUrl}/api/sdk/comparisons/${comparisonId}/reject`;
-    let response = await fetch(url, {
-      method: 'POST',
-      headers: {
-        Authorization: `Bearer ${apiToken}`,
-        'User-Agent': 'Vizzly-Claude-Plugin/0.1.0',
-        'Content-Type': 'application/json'
-      },
-      body: JSON.stringify({ reason })
-    });
-
-    if (!response.ok) {
-      let error = await response.text();
-      throw new Error(`Failed to reject comparison (${response.status}): ${error}`);
-    }
-
-    return response.json();
-  }
-
-  /**
-   * Update comparison approval status
-   */
-  async updateComparisonApproval(comparisonId, approvalStatus, comment, apiToken, apiUrl) {
-    let url = `${apiUrl || this.defaultApiUrl}/api/sdk/comparisons/${comparisonId}/approval`;
-    let response = await fetch(url, {
-      method: 'PUT',
-      headers: {
-        Authorization: `Bearer ${apiToken}`,
-        'User-Agent': 'Vizzly-Claude-Plugin/0.1.0',
-        'Content-Type': 'application/json'
-      },
-      body: JSON.stringify({ approval_status: approvalStatus, comment })
-    });
-
-    if (!response.ok) {
-      let error = await response.text();
-      throw new Error(`Failed to update comparison approval (${response.status}): ${error}`);
-    }
-
-    return response.json();
-  }
-
-  // ==================================================================
-  // REVIEW STATUS
-  // ==================================================================
-
-  /**
-   * Get review summary for a build
-   */
-  async getReviewSummary(buildId, apiToken, apiUrl) {
-    if (!buildId || typeof buildId !== 'string') {
-      throw new Error('buildId is required and must be a non-empty string');
-    }
-
-    let data = await this.makeRequest(
-      `/api/sdk/builds/${buildId}/review-summary`,
-      apiToken,
-      apiUrl
-    );
-
-    return data;
-  }
-
-  // ==================================================================
-  // TDD WORKFLOW
-  // ==================================================================
-
-  /**
-   * Download baseline screenshots from a cloud build
-   * Returns screenshot data that can be saved locally
-   */
-  async downloadBaselines(buildId, screenshotNames, apiToken, apiUrl) {
-    if (!buildId || typeof buildId !== 'string') {
-      throw new Error('buildId is required and must be a non-empty string');
-    }
-
-    let data = await this.makeRequest(
-      `/api/sdk/builds/${buildId}?include=screenshots`,
-      apiToken,
-      apiUrl
-    );
-
-    let { build } = data;
-    let screenshots = build.screenshots || [];
-
-    // Filter by screenshot names if provided
-    if (screenshotNames && screenshotNames.length > 0) {
-      screenshots = screenshots.filter((s) => screenshotNames.includes(s.name));
-    }
-
-    return {
-      buildId: build.id,
-      buildName: build.name,
-      screenshots: screenshots.map((s) => ({
-        name: s.name,
-        url: s.original_url,
-        sha256: s.sha256,
-        width: s.viewport_width,
-        height: s.viewport_height,
-        browser: s.browser
-      }))
-    };
-  }
-}