@probelabs/visor 0.1.106 → 0.1.111

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 %}

package/dist/examples/custom-tools-example.yaml

@@ -0,0 +1,281 @@
+version: "1.0"
+
+# Custom Tool Definitions
+# These tools can be used in any MCP block with transport: custom
+tools:
+  # Simple grep tool for finding patterns in files
+  grep-pattern:
+    name: grep-pattern
+    description: Search for patterns in files using grep
+    inputSchema:
+      type: object
+      properties:
+        pattern:
+          type: string
+          description: Regular expression pattern to search for
+        files:
+          type: array
+          items:
+            type: string
+          description: List of files to search in
+      required: [pattern]
+    exec: 'grep -n "{{ args.pattern }}" {{ args.files | join: " " }}'
+    transform_js: |
+      // Parse grep output into structured format
+      const lines = output.trim().split('\n').filter(l => l);
+      return lines.map(line => {
+        const match = line.match(/^([^:]+):(\d+):(.*)$/);
+        if (!match) return null;
+        return {
+          file: match[1],
+          line: parseInt(match[2]),
+          content: match[3].trim()
+        };
+      }).filter(Boolean);
+
+  # Tool to count lines of code
+  count-lines:
+    name: count-lines
+    description: Count lines of code in files
+    inputSchema:
+      type: object
+      properties:
+        files:
+          type: array
+          items:
+            type: string
+          description: Files to count lines in
+        exclude_blank:
+          type: boolean
+          description: Exclude blank lines from count
+    exec: |
+      {% if args.exclude_blank %}
+        cat {{ args.files | join: " " }} | grep -v "^$" | wc -l
+      {% else %}
+        cat {{ args.files | join: " " }} | wc -l
+      {% endif %}
+    transform_js: 'return parseInt(output.trim());'
+
+  # Tool to check if a file contains sensitive data patterns
+  check-secrets:
+    name: check-secrets
+    description: Check for potential secrets in files
+    inputSchema:
+      type: object
+      properties:
+        file:
+          type: string
+          description: File to check
+      required: [file]
+    exec: |
+      grep -E "(api[_-]?key|secret|token|password|pwd|auth|credential)" -i "{{ args.file }}" || echo "No secrets found"
+    transform_js: |
+      if (output.includes("No secrets found")) {
+        return { safe: true, issues: [] };
+      }
+      const lines = output.trim().split('\n');
+      return {
+        safe: false,
+        issues: lines.map(line => ({
+          type: 'potential_secret',
+          content: line.substring(0, 100) // Truncate for safety
+        }))
+      };
+
+  # Tool to analyze code complexity
+  analyze-complexity:
+    name: analyze-complexity
+    description: Analyze code complexity metrics
+    inputSchema:
+      type: object
+      properties:
+        file:
+          type: string
+          description: Source code file to analyze
+        language:
+          type: string
+          description: Programming language (js, py, go, etc.)
+      required: [file]
+    exec: |
+      echo "Analyzing {{ args.file }}"
+      # Count functions/methods
+      {% if args.language == "js" or args.language == "ts" %}
+        grep -c "function\|=>" "{{ args.file }}" || echo "0"
+      {% elsif args.language == "py" %}
+        grep -c "def " "{{ args.file }}" || echo "0"
+      {% elsif args.language == "go" %}
+        grep -c "func " "{{ args.file }}" || echo "0"
+      {% else %}
+        echo "0"
+      {% endif %}
+    transform_js: |
+      const functionCount = parseInt(output.trim().split('\n').pop() || '0');
+      return {
+        file: args.file,
+        language: args.language || 'unknown',
+        metrics: {
+          functionCount: functionCount,
+          complexity: functionCount > 10 ? 'high' : functionCount > 5 ? 'medium' : 'low'
+        }
+      };
+
+  # Tool to validate JSON/YAML files
+  validate-config:
+    name: validate-config
+    description: Validate configuration file syntax
+    inputSchema:
+      type: object
+      properties:
+        file:
+          type: string
+          description: Configuration file to validate
+        type:
+          type: string
+          enum: [json, yaml]
+          description: File type to validate
+      required: [file, type]
+    exec: |
+      {% if args.type == "json" %}
+        python3 -m json.tool "{{ args.file }}" > /dev/null 2>&1 && echo "Valid JSON" || echo "Invalid JSON"
+      {% else %}
+        python3 -c "import yaml; yaml.safe_load(open('{{ args.file }}'))" 2>&1 && echo "Valid YAML" || echo "Invalid YAML"
+      {% endif %}
+    parseJson: false
+    transform_js: |
+      const isValid = output.includes("Valid");
+      return {
+        file: args.file,
+        type: args.type,
+        valid: isValid,
+        message: output.trim()
+      };
+
+  # Tool to generate file statistics
+  file-stats:
+    name: file-stats
+    description: Generate statistics about files
+    inputSchema:
+      type: object
+      properties:
+        pattern:
+          type: string
+          description: Glob pattern for files to analyze
+    exec: |
+      find . -name "{{ args.pattern }}" -type f | xargs wc -l | tail -1
+    transform_js: |
+      const parts = output.trim().split(/\s+/);
+      return {
+        totalLines: parseInt(parts[0] || '0'),
+        fileCount: Math.max(0, parts.length - 2) // Subtract total line
+      };
+
+# Example usage of custom tools in checks
+steps:
+  # Use custom tool to find TODO comments
+  find-todos:
+    type: mcp
+    transport: custom
+    method: grep-pattern
+    methodArgs:
+      pattern: "TODO|FIXME|HACK"
+      files: ["*.js", "*.ts", "*.py"]
+    transform_js: |
+      // Convert grep results to issues
+      output.map(match => ({
+        file: match.file,
+        line: match.line,
+        message: `Found comment: ${match.content}`,
+        severity: match.content.includes('FIXME') ? 'warning' : 'info',
+        category: 'documentation',
+        ruleId: 'todo-comment'
+      }))
+
+  # Check for secrets using custom tool
+  security-check:
+    type: mcp
+    transport: custom
+    method: check-secrets
+    forEach: "{{ files | map: 'filename' }}"
+    methodArgs:
+      file: "{{ item }}"
+    transform_js: |
+      if (!output.safe) {
+        return output.issues.map(issue => ({
+          file: args.file,
+          line: 0,
+          message: `Potential secret detected: ${issue.type}`,
+          severity: 'critical',
+          category: 'security',
+          ruleId: 'potential-secret'
+        }));
+      }
+      return [];
+
+  # Analyze code complexity
+  complexity-analysis:
+    type: mcp
+    transport: custom
+    method: analyze-complexity
+    forEach: "{{ files | where: 'filename', 'endsWith', '.js' }}"
+    methodArgs:
+      file: "{{ item.filename }}"
+      language: "js"
+    transform_js: |
+      const complexity = output.metrics.complexity;
+      if (complexity === 'high') {
+        return [{
+          file: output.file,
+          line: 0,
+          message: `High complexity detected: ${output.metrics.functionCount} functions`,
+          severity: 'warning',
+          category: 'performance',
+          ruleId: 'high-complexity'
+        }];
+      }
+      return [];
+
+  # Validate all JSON config files
+  validate-json-configs:
+    type: mcp
+    transport: custom
+    method: validate-config
+    forEach: "{{ files | where: 'filename', 'endsWith', '.json' }}"
+    methodArgs:
+      file: "{{ item.filename }}"
+      type: "json"
+    fail_if: "!output.valid"
+    transform_js: |
+      if (!output.valid) {
+        return [{
+          file: output.file,
+          line: 0,
+          message: output.message,
+          severity: 'error',
+          category: 'style',
+          ruleId: 'invalid-json'
+        }];
+      }
+      return [];
+
+  # Get repository statistics
+  repo-stats:
+    type: mcp
+    transport: custom
+    method: file-stats
+    methodArgs:
+      pattern: "*.{js,ts,py,go}"
+    transform_js: |
+      // Create informational message about repo size
+      [{
+        file: 'repository',
+        line: 0,
+        message: `Repository contains ${output.fileCount} source files with ${output.totalLines} total lines`,
+        severity: 'info',
+        category: 'documentation',
+        ruleId: 'repo-stats'
+      }]
+
+# Output configuration
+output:
+  format: table
+  groupBy: severity