@probelabs/visor 0.1.106 → 0.1.107

package/dist/examples/calculator-sdk-test.ts

@@ -0,0 +1,148 @@
+#!/usr/bin/env ts-node
+/**
+ * Automated test for calculator SDK example
+ * Tests fail_if validation with outputs from previous checks
+ */
+
+import { runChecks } from '../src/sdk';
+import { HumanInputCheckProvider } from '../src/providers/human-input-check-provider';
+import type { VisorConfig, HumanInputRequest } from '../src/types/config';
+
+// Calculator configuration
+const calculatorConfig: VisorConfig = {
+  version: '1.0',
+  checks: {
+    'get-number1': {
+      type: 'human-input',
+      prompt: 'Enter the first number:',
+      placeholder: 'e.g., 42',
+      allow_empty: false,
+    },
+
+    'store-number1': {
+      type: 'memory',
+      depends_on: ['get-number1'],
+      operation: 'set',
+      namespace: 'calculator',
+      key: 'number1',
+      value_js: "parseFloat(outputs['get-number1'])",
+    },
+
+    'get-number2': {
+      type: 'human-input',
+      depends_on: ['store-number1'],
+      prompt: 'Enter the second number:',
+      placeholder: 'e.g., 7',
+      allow_empty: false,
+    },
+
+    'store-number2': {
+      type: 'memory',
+      depends_on: ['get-number2'],
+      operation: 'set',
+      namespace: 'calculator',
+      key: 'number2',
+      value_js: "parseFloat(outputs['get-number2'])",
+    },
+
+    'get-operation': {
+      type: 'human-input',
+      depends_on: ['store-number2'],
+      prompt: 'Select operation (+, -, *, /):',
+      placeholder: 'Enter one of: + - * /',
+      allow_empty: false,
+    },
+
+    'store-operation': {
+      type: 'memory',
+      depends_on: ['get-operation'],
+      operation: 'set',
+      namespace: 'calculator',
+      key: 'operation',
+      value_js: "outputs['get-operation'].trim()",
+      // THIS IS THE KEY TEST: fail_if should have access to outputs['get-operation']
+      fail_if: "!['+', '-', '*', '/'].includes(outputs['get-operation'].trim())",
+    },
+
+    'calculate': {
+      type: 'script',
+      depends_on: ['store-operation'],
+      content: `
+        const num1 = memory.get('number1', 'calculator');
+        const num2 = memory.get('number2', 'calculator');
+        const op = memory.get('operation', 'calculator');
+
+        log('🔢 Calculating:', num1, op, num2);
+
+        let result;
+        switch(op) {
+          case '+': result = num1 + num2; break;
+          case '-': result = num1 - num2; break;
+          case '*': result = num1 * num2; break;
+          case '/': result = num1 / num2; break;
+          default: throw new Error('Invalid operation');
+        }
+
+        log('✅ Result:', result);
+        return result;
+      `,
+    },
+
+    'show-result': {
+      type: 'log',
+      depends_on: ['calculate'],
+      message: `Result: {{ outputs['get-number1'] }} {{ outputs['get-operation'] }} {{ outputs['get-number2'] }} = {{ outputs['calculate'] }}`,
+    },
+  },
+};
+
+async function runCalculatorTest() {
+  console.log('Testing calculator with fail_if validation...\n');
+
+  // Simulated user inputs
+  const inputs = {
+    'get-number1': '10',
+    'get-number2': '5',
+    'get-operation': '+',
+  };
+
+  let currentCheckId = '';
+
+  // Set up human-input hook
+  HumanInputCheckProvider.setHooks({
+    onHumanInput: async (request: HumanInputRequest) => {
+      currentCheckId = request.checkId;
+      const input = inputs[request.checkId as keyof typeof inputs];
+      console.log(`📝 ${request.prompt}`);
+      console.log(`   → ${input}\n`);
+      return input;
+    },
+  });
+
+  try {
+    // Execute checks using SDK
+    const result = await runChecks({
+      config: calculatorConfig,
+      checks: Object.keys(calculatorConfig.checks!),
+      outputFormat: 'table',
+      maxParallelism: 1,
+    });
+
+    console.log('\n✅ Test PASSED: All checks completed successfully!');
+    console.log(`   No fail_if errors detected`);
+    console.log(`   Result: 10 + 5 = 15\n`);
+
+    return 0;
+  } catch (error) {
+    console.error('\n❌ Test FAILED:', error);
+    return 1;
+  }
+}
+
+// Run test
+runCalculatorTest()
+  .then((code) => process.exit(code))
+  .catch((error) => {
+    console.error('Unexpected error:', error);
+    process.exit(1);
+  });

package/dist/examples/claude-code-config.yaml

@@ -0,0 +1,191 @@
+# Claude Code Provider Configuration Example
+# This example demonstrates how to use the Claude Code provider
+# for advanced AI-powered code reviews with MCP tools
+
+version: "1.0"
+project: claude-code-example
+language: typescript
+
+# Claude Code checks with various configurations
+steps:
+  # Basic Claude Code analysis
+  claude_security_review:
+    type: claude-code
+    group: security
+    prompt: |
+      Analyze this code for security vulnerabilities including:
+      - SQL injection risks
+      - XSS vulnerabilities
+      - Authentication/authorization issues
+      - Sensitive data exposure
+      - Input validation problems
+    claude_code:
+      allowedTools: ['Grep', 'Read']
+      maxTurns: 3
+      systemPrompt: "You are a senior security engineer conducting a thorough security audit."
+    on: [pr_opened, pr_updated]
+
+  # Architecture analysis with MCP tools
+  claude_architecture:
+    type: claude-code
+    group: architecture
+    prompt: |
+      Analyze the code architecture and provide insights on:
+      - Code organization and structure
+      - Design patterns usage
+      - Coupling and cohesion
+      - Modularity and maintainability
+    claude_code:
+      allowedTools:
+        - Read
+        - Grep
+        - analyze_file_structure
+        - detect_patterns
+        - calculate_complexity
+      maxTurns: 5
+      systemPrompt: "You are a software architect reviewing code for best practices."
+    on: [pr_opened, pr_updated]
+
+  # Performance analysis with custom MCP server
+  claude_performance:
+    type: claude-code
+    group: performance
+    prompt: |
+      Review the code for performance issues:
+      - Algorithm efficiency
+      - Database query optimization
+      - Memory leaks and management
+      - Caching opportunities
+      - Async/await patterns
+    claude_code:
+      allowedTools:
+        - Read
+        - Grep
+        - calculate_complexity
+        - suggest_improvements
+      maxTurns: 4
+      systemPrompt: "Focus on performance bottlenecks and optimization opportunities."
+      # Custom MCP server for performance profiling
+      mcpServers:
+        perf_analyzer:
+          command: "node"
+          args: ["./tools/performance-analyzer.js"]
+          env:
+            PROFILE_MODE: "detailed"
+    on: [pr_opened, pr_updated]
+
+  # Code quality with web search
+  claude_quality:
+    type: claude-code
+    group: quality
+    prompt: |
+      Assess overall code quality:
+      - Naming conventions and readability
+      - Documentation completeness
+      - Test coverage assessment
+      - Error handling
+      - Code duplication
+      Search for best practices if needed.
+    claude_code:
+      allowedTools:
+        - Read
+        - Grep
+        - WebSearch
+        - detect_patterns
+        - suggest_improvements
+      maxTurns: 6
+      systemPrompt: "You are a code quality expert. Use web search to find current best practices when needed."
+    on: [pr_opened, pr_updated]
+
+  # Dependency analysis with session reuse
+  claude_dependencies:
+    type: claude-code
+    group: dependencies
+    prompt: |
+      Analyze the project dependencies:
+      - Outdated packages
+      - Security vulnerabilities in dependencies
+      - Unused dependencies
+      - Missing peer dependencies
+    claude_code:
+      allowedTools:
+        - Read
+        - Grep
+        - WebSearch
+      maxTurns: 3
+    depends_on: [claude_quality]
+    reuse_ai_session: true  # Reuse session from quality check
+    on: [pr_opened, pr_updated]
+
+  # Advanced review with subagent
+  claude_comprehensive:
+    type: claude-code
+    group: comprehensive
+    prompt: |
+      Perform a comprehensive code review covering all aspects.
+      Delegate specific tasks to specialized subagents as needed.
+    claude_code:
+      allowedTools:
+        - Read
+        - Grep
+        - WebSearch
+        - analyze_file_structure
+        - detect_patterns
+        - calculate_complexity
+        - suggest_improvements
+      maxTurns: 10
+      systemPrompt: "You are the lead code reviewer. Use all available tools and delegate to subagents."
+      # Subagent for specialized tasks
+      subagent: "./.claude/agents/code-reviewer.md"
+      # Hooks for custom processing
+      hooks:
+        onStart: "echo 'Starting comprehensive Claude Code review'"
+        onToolUse: "./hooks/log-tool-usage.sh"
+        onEnd: "echo 'Comprehensive review complete'"
+    on: [manual]  # Run manually due to high resource usage
+
+# Output configuration
+output:
+  # PR comment format
+  pr_comment:
+    enabled: true
+    update_existing: true
+    group_by: group
+
+  # Multiple output formats
+  format: table
+
+  # Save detailed reports
+  file:
+    enabled: true
+    path: "./reports/claude-review-{{date}}.md"
+    format: markdown
+
+# Global AI settings (fallback for non-Claude checks)
+ai_provider: google
+ai_model: gemini-pro
+
+# Failure conditions
+fail_if: "criticalIssues > 0 || securityIssues > 5"
+
+# Custom MCP server configuration
+# This can be extended in .mcp.json for more servers
+mcp_config:
+  servers:
+    code_analyzer:
+      command: "python"
+      args: ["./mcp/analyzer.py"]
+      env:
+        ANALYSIS_LEVEL: "deep"
+
+    security_scanner:
+      command: "node"
+      args: ["./mcp/security.js"]
+      env:
+        SCAN_MODE: "full"
+
+# Environment variables for checks
+env:
+  ANALYSIS_DEPTH: "comprehensive"
+  INCLUDE_SUGGESTIONS: "true"
+  MAX_FILE_SIZE: "1000000"

package/dist/examples/cron-webhook-config.yaml

@@ -0,0 +1,215 @@
+version: "1.0"
+
+# Global HTTP server configuration for receiving webhooks
+# Note: ${...} syntax reads from environment variables
+# This server is automatically disabled when running in GitHub Actions
+http_server:
+  enabled: true
+  port: 8080
+  host: "0.0.0.0"
+  auth:
+    type: bearer_token
+    secret: "${WEBHOOK_SECRET}"  # Read from WEBHOOK_SECRET environment variable
+  endpoints:
+    - path: "/deploy"
+      name: "deployment-webhook"
+      transform: |
+        {
+          "environment": "{{ webhook.environment }}",
+          "version": "{{ webhook.version }}",
+          "service": "{{ webhook.service }}",
+          "timestamp": "{{ webhook.timestamp | default: timestamp }}"
+        }
+    - path: "/ci-complete"
+      name: "ci-webhook"
+
+steps:
+  # Scheduled nightly security scan
+  nightly-security-scan:
+    type: ai
+    schedule: "0 2 * * *"  # Every night at 2 AM
+    prompt: |
+      Perform a comprehensive security audit of the codebase.
+      Focus on:
+      - SQL injection vulnerabilities
+      - XSS vulnerabilities
+      - Authentication/authorization issues
+      - Sensitive data exposure
+      - Dependency vulnerabilities
+    group: security
+    schema: code-review
+
+  # Send security scan results to Slack
+  security-to-slack:
+    type: http
+    depends_on: [nightly-security-scan]
+    url: "${SLACK_WEBHOOK_URL}"  # Read from SLACK_WEBHOOK_URL environment variable
+    method: POST
+    headers:
+      Content-Type: "application/json"
+    body: |
+      {
+        "text": "🔒 Nightly Security Scan Results",
+        "blocks": [
+          {
+            "type": "header",
+            "text": {
+              "type": "plain_text",
+              "text": "Security Scan Report"
+            }
+          },
+          {
+            "type": "section",
+            "text": {
+              "type": "mrkdwn",
+              "text": "*Total Issues:* {{ outputs['nightly-security-scan'].totalIssues }}\n*Critical:* {{ outputs['nightly-security-scan'].criticalIssues }}\n*Errors:* {{ outputs['nightly-security-scan'].errorIssues }}"
+            }
+          },
+          {% if outputs['nightly-security-scan'].issues %}
+          {
+            "type": "section",
+            "text": {
+              "type": "mrkdwn",
+              "text": "*Top Issues:*\n{% for issue in outputs['nightly-security-scan'].issues | slice: 0, 3 %}• {{ issue.message | truncate: 80 }}\n{% endfor %}"
+            }
+          },
+          {% endif %}
+          {
+            "type": "context",
+            "elements": [
+              {
+                "type": "mrkdwn",
+                "text": "Scan completed at {{ timestamp }}"
+              }
+            ]
+          }
+        ]
+      }
+
+  # Weekly performance analysis
+  weekly-performance:
+    type: ai
+    schedule: "0 0 * * 0"  # Sunday at midnight
+    prompt: |
+      Analyze the codebase for performance issues:
+      - Inefficient algorithms (O(n²) or worse)
+      - Database N+1 queries
+      - Memory leaks
+      - Unnecessary re-renders (React/Vue)
+      - Bundle size issues
+    group: performance
+    schema: code-review
+
+  # Webhook input for deployment notifications
+  deployment-webhook:
+    type: http_input
+    endpoint: "/deploy"
+    on: [webhook_received]
+
+  # Post-deployment validation check
+  post-deploy-validation:
+    type: ai
+    depends_on: [deployment-webhook]
+    prompt: |
+      Deployment notification received:
+      - Environment: {{ outputs['deployment-webhook'].environment }}
+      - Version: {{ outputs['deployment-webhook'].version }}
+      - Service: {{ outputs['deployment-webhook'].service }}
+
+      Analyze the deployed version for:
+      1. Configuration drift from expected state
+      2. Security implications of the deployment
+      3. Potential compatibility issues
+      4. Required post-deployment tasks
+
+      Generate actionable recommendations.
+    group: deployment
+    schema: plain
+
+  # Send deployment analysis to ops team
+  notify-ops-team:
+    type: http
+    depends_on: [post-deploy-validation]
+    url: "${OPS_WEBHOOK_URL}"  # Read from OPS_WEBHOOK_URL environment variable
+    method: POST
+    headers:
+      Content-Type: "application/json"
+      X-API-Key: "${OPS_API_KEY}"  # Read from OPS_API_KEY environment variable
+    body: |
+      {
+        "deployment": {
+          "environment": "{{ outputs['deployment-webhook'].environment }}",
+          "version": "{{ outputs['deployment-webhook'].version }}",
+          "service": "{{ outputs['deployment-webhook'].service }}"
+        },
+        "analysis": {
+          "issues": {{ outputs['post-deploy-validation'].issues | json }},
+          "recommendations": {{ outputs['post-deploy-validation'].suggestions | json }},
+          "severity": "{% if outputs['post-deploy-validation'].criticalIssues > 0 %}critical{% elsif outputs['post-deploy-validation'].errorIssues > 0 %}error{% elsif outputs['post-deploy-validation'].warningIssues > 0 %}warning{% else %}info{% endif %}"
+        },
+        "timestamp": "{{ timestamp }}",
+        "visor_version": "1.0"
+      }
+
+  # CI completion webhook input
+  ci-completion:
+    type: http_input
+    endpoint: "/ci-complete"
+    transform: |
+      {
+        "build_id": "{{ webhook.build_id }}",
+        "status": "{{ webhook.status }}",
+        "branch": "{{ webhook.branch }}",
+        "commit": "{{ webhook.commit }}",
+        "test_results": {{ webhook.test_results | json }}
+      }
+
+  # Analyze CI results
+  ci-analysis:
+    type: ai
+    depends_on: [ci-completion]
+    prompt: |
+      CI build completed:
+      - Status: {{ outputs['ci-completion'].status }}
+      - Branch: {{ outputs['ci-completion'].branch }}
+      - Test Results: {{ outputs['ci-completion'].test_results }}
+
+      {% if outputs['ci-completion'].status == 'failed' %}
+      Analyze the failure and provide:
+      1. Root cause analysis
+      2. Suggested fixes
+      3. Impact assessment
+      {% else %}
+      Review the successful build for:
+      1. Test coverage improvements
+      2. Performance metrics
+      3. Code quality trends
+      {% endif %}
+
+  # Hourly monitoring check (business hours only)
+  business-hours-monitor:
+    type: command
+    schedule: "0 9-17 * * 1-5"  # Every hour 9 AM - 5 PM, Monday-Friday
+    exec: "curl -s https://api.example.com/health"
+    group: monitoring
+
+  # Send monitoring alerts
+  monitoring-alert:
+    type: http
+    depends_on: [business-hours-monitor]
+    url: "${ALERT_WEBHOOK_URL}"  # Read from ALERT_WEBHOOK_URL environment variable
+    body: |
+      {
+        "service": "API Health Check",
+        "status": "{{ outputs['business-hours-monitor'].exitCode == 0 ? 'healthy' : 'unhealthy' }}",
+        "timestamp": "{{ timestamp }}",
+        "details": {{ outputs['business-hours-monitor'] | json }}
+      }
+    if: "outputs['business-hours-monitor'].exitCode != 0"
+
+output:
+  pr_comment:
+    format: markdown
+    group_by: check
+    collapse: true
+  suppressionEnabled: true

package/dist/examples/custom-template.liquid

@@ -0,0 +1,57 @@
+# 🔍 {{ checkName | capitalize }} Review Results
+
+{% if issues.size == 0 %}
+## ✅ No Issues Found
+Great job! No issues were detected in this check.
+{% else %}
+## 📋 Issues Summary
+Found **{{ issues.size }}** issue{% if issues.size > 1 %}s{% endif %} to review:
+
+{% assign critical_issues = issues | where: "severity", "critical" %}
+{% assign error_issues = issues | where: "severity", "error" %}
+{% assign warning_issues = issues | where: "severity", "warning" %}
+{% assign info_issues = issues | where: "severity", "info" %}
+
+{% if critical_issues.size > 0 %}
+### 🚨 Critical Issues ({{ critical_issues.size }})
+{% for issue in critical_issues %}
+- **{{ issue.file }}:{{ issue.line }}** - {{ issue.message }}
+  {% if issue.suggestion %}
+  💡 **Suggestion:** {{ issue.suggestion }}
+  {% endif %}
+{% endfor %}
+{% endif %}
+
+{% if error_issues.size > 0 %}
+### ❌ Errors ({{ error_issues.size }})
+{% for issue in error_issues %}
+- **{{ issue.file }}:{{ issue.line }}** - {{ issue.message }}
+  {% if issue.suggestion %}
+  💡 **Suggestion:** {{ issue.suggestion }}
+  {% endif %}
+{% endfor %}
+{% endif %}
+
+{% if warning_issues.size > 0 %}
+### ⚠️ Warnings ({{ warning_issues.size }})
+{% for issue in warning_issues %}
+- **{{ issue.file }}:{{ issue.line }}** - {{ issue.message }}
+  {% if issue.suggestion %}
+  💡 **Suggestion:** {{ issue.suggestion }}
+  {% endif %}
+{% endfor %}
+{% endif %}
+
+{% if info_issues.size > 0 %}
+### ℹ️ Info ({{ info_issues.size }})
+{% for issue in info_issues %}
+- **{{ issue.file }}:{{ issue.line }}** - {{ issue.message }}
+  {% if issue.suggestion %}
+  💡 **Suggestion:** {{ issue.suggestion }}
+  {% endif %}
+{% endfor %}
+{% endif %}
+
+---
+*Powered by Custom Template*
+{% endif %}