@probelabs/visor 0.1.106 → 0.1.111

package/dist/examples/visor-with-tags.yaml

@@ -0,0 +1,198 @@
+# Visor Configuration with Tags - Complete Example
+# This configuration demonstrates how to use tags for different execution profiles
+version: "1.0"
+
+# Global tag filter (can be overridden by CLI/GitHub Actions)
+tag_filter:
+  # Uncomment to set default filters:
+  # include: ["local", "fast"]
+  # exclude: ["experimental"]
+
+# Global settings
+ai_provider: google  # or anthropic, openai
+ai_model: gemini-1.5-flash  # or claude-3-opus, gpt-4
+
+# Check definitions with comprehensive tagging
+steps:
+  # ============================================
+  # SECURITY CHECKS
+  # ============================================
+
+  security-quick:
+    type: ai
+    group: security
+    schema: code-review
+    prompt: |
+      Quick security scan focusing on:
+      - Obvious vulnerabilities (hardcoded secrets, SQL injection)
+      - Authentication issues
+      - Common security anti-patterns
+      Return results quickly, prioritize critical issues.
+    tags: ["security", "fast", "local", "critical"]
+    on: [pr_opened, pr_updated, manual]
+
+  security-comprehensive:
+    type: ai
+    group: security
+    schema: code-review
+    prompt: |
+      Comprehensive security audit including:
+      - All OWASP Top 10 vulnerabilities
+      - Supply chain security issues
+      - Cryptographic weaknesses
+      - Access control problems
+      - Data exposure risks
+      - Third-party dependency vulnerabilities
+      Provide detailed analysis with remediation steps.
+    tags: ["security", "comprehensive", "slow", "remote", "critical"]
+    on: [pr_opened]
+    depends_on: [security-quick]  # Build on quick findings
+
+  security-dependencies:
+    type: command
+    group: security
+    exec: "npm audit --json"
+    tags: ["security", "dependencies", "fast", "local", "remote"]
+    on: [pr_opened, pr_updated]
+
+  # ============================================
+  # PERFORMANCE CHECKS
+  # ============================================
+
+  performance-basic:
+    type: ai
+    group: performance
+    schema: code-review
+    prompt: |
+      Basic performance analysis:
+      - Algorithm complexity (O(n²) or worse)
+      - Database query efficiency
+      - Memory leaks
+      - Caching opportunities
+    tags: ["performance", "fast", "local"]
+    on: [pr_opened, pr_updated]
+
+  performance-advanced:
+    type: ai
+    group: performance
+    schema: code-review
+    prompt: |
+      Advanced performance analysis:
+      - Concurrency issues and race conditions
+      - Resource pool exhaustion
+      - Micro-optimization opportunities
+      - Distributed system bottlenecks
+      - Load testing recommendations
+    tags: ["performance", "comprehensive", "slow", "remote"]
+    on: [pr_opened]
+    depends_on: [performance-basic]
+
+  # ============================================
+  # CODE QUALITY CHECKS
+  # ============================================
+
+  style-check:
+    type: ai
+    group: quality
+    schema: code-review
+    prompt: |
+      Code style and formatting:
+      - Naming conventions
+      - Code organization
+      - Documentation completeness
+      - Consistent patterns
+    tags: ["style", "fast", "local"]
+    on: [pr_opened, pr_updated]
+
+  architecture-review:
+    type: ai
+    group: quality
+    schema: code-review
+    prompt: |
+      Architecture and design patterns:
+      - SOLID principles adherence
+      - Design pattern usage
+      - Module boundaries
+      - Coupling and cohesion
+      - Technical debt identification
+    tags: ["architecture", "comprehensive", "remote"]
+    on: [pr_opened]
+
+  test-coverage:
+    type: command
+    group: quality
+    exec: "npm test -- --coverage --json"
+    tags: ["testing", "fast", "local", "ci"]
+    on: [pr_opened, pr_updated]
+
+  # ============================================
+  # EXPERIMENTAL/BETA CHECKS
+  # ============================================
+
+  ai-refactoring-suggestions:
+    type: claude-code
+    group: experimental
+    prompt: |
+      Analyze the code and suggest refactoring opportunities.
+      Use MCP tools to understand the codebase structure.
+      Provide specific, actionable refactoring suggestions.
+    tags: ["experimental", "refactoring", "claude", "slow"]
+    claude_code:
+      allowedTools: ['Grep', 'Read', 'analyze_file_structure']
+      maxTurns: 10
+    on: [manual]  # Only run when explicitly requested
+
+  accessibility-check:
+    type: ai
+    group: experimental
+    schema: code-review
+    prompt: "Check for accessibility issues in UI components"
+    tags: ["experimental", "accessibility", "frontend"]
+    on: [pr_opened]
+    if: "filesChanged.some(f => f.endsWith('.jsx') || f.endsWith('.tsx'))"
+
+  # ============================================
+  # REPORTING AND AGGREGATION
+  # ============================================
+
+  summary-report:
+    type: noop  # No-op provider for orchestration
+    group: summary
+    tags: ["reporting", "local", "remote"]
+    depends_on:
+      - security-quick
+      - performance-basic
+      - style-check
+    on: [pr_opened, pr_updated]
+
+  comprehensive-report:
+    type: noop
+    group: summary
+    tags: ["reporting", "comprehensive", "remote"]
+    depends_on:
+      - security-comprehensive
+      - performance-advanced
+      - architecture-review
+    on: [pr_opened]
+
+# Output configuration
+output:
+  pr_comment:
+    format: markdown
+    group_by: group
+    collapse: true
+
+  github_checks:
+    enabled: true
+    per_check: false  # Create one combined check
+
+# Environment-specific overrides (use with extends)
+# Example: .visor.dev.yaml could extend this and set:
+# tag_filter:
+#   include: ["local", "fast"]
+#   exclude: ["experimental", "comprehensive"]
+
+# Example: .visor.prod.yaml could extend this and set:
+# tag_filter:
+#   include: ["critical", "comprehensive", "remote"]
+#   exclude: ["experimental"]

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

@@ -0,0 +1,218 @@
+version: "1.0"
+
+# HTTP server for receiving external webhook events
+# Note: ${...} syntax reads from environment variables
+# This server is automatically disabled when running in GitHub Actions
+http_server:
+  enabled: true
+  port: 3000
+  host: "localhost"
+  auth:
+    type: hmac
+    secret: "${HMAC_SECRET}"  # Read from HMAC_SECRET environment variable
+  endpoints:
+    - path: "/github/push"
+      name: "github-push"
+      transform: |
+        {
+          "repository": "{{ webhook.repository.full_name }}",
+          "branch": "{{ webhook.ref | replace: 'refs/heads/', '' }}",
+          "commit": "{{ webhook.after }}",
+          "author": "{{ webhook.pusher.name }}",
+          "files": {{ webhook.commits | map: 'modified' | flatten | uniq | json }}
+        }
+    - path: "/jira/issue"
+      name: "jira-webhook"
+      transform: |
+        {
+          "issue_key": "{{ webhook.issue.key }}",
+          "status": "{{ webhook.issue.fields.status.name }}",
+          "assignee": "{{ webhook.issue.fields.assignee.displayName }}",
+          "priority": "{{ webhook.issue.fields.priority.name }}"
+        }
+
+steps:
+  # === GitHub Push Pipeline ===
+
+  # Receive GitHub push events
+  github-push-receiver:
+    type: http_input
+    endpoint: "/github/push"
+    on: [webhook_received]
+
+  # Analyze the pushed code
+  push-code-analysis:
+    type: ai
+    depends_on: [github-push-receiver]
+    prompt: |
+      GitHub push received:
+      - Repository: {{ outputs['github-push-receiver'].repository }}
+      - Branch: {{ outputs['github-push-receiver'].branch }}
+      - Commit: {{ outputs['github-push-receiver'].commit }}
+      - Modified files: {{ outputs['github-push-receiver'].files }}
+
+      Analyze the push for:
+      1. Breaking changes
+      2. Security vulnerabilities introduced
+      3. Code quality issues
+      4. Missing tests
+    schema: code-review
+    group: push-analysis
+
+  # Notify development team about push analysis
+  notify-dev-team:
+    type: http
+    depends_on: [push-code-analysis]
+    url: "${DEV_TEAM_WEBHOOK}"  # Read from DEV_TEAM_WEBHOOK environment variable
+    body: |
+      {
+        "channel": "#dev-notifications",
+        "username": "Visor Bot",
+        "icon_emoji": ":robot_face:",
+        "attachments": [
+          {
+            "color": "{% if outputs['push-code-analysis'].criticalIssues > 0 %}danger{% elsif outputs['push-code-analysis'].errorIssues > 0 %}warning{% else %}good{% endif %}",
+            "title": "Push Analysis for {{ outputs['github-push-receiver'].repository }}",
+            "fields": [
+              {
+                "title": "Branch",
+                "value": "{{ outputs['github-push-receiver'].branch }}",
+                "short": true
+              },
+              {
+                "title": "Commit",
+                "value": "{{ outputs['github-push-receiver'].commit | slice: 0, 8 }}",
+                "short": true
+              },
+              {
+                "title": "Issues Found",
+                "value": "{{ outputs['push-code-analysis'].totalIssues }}",
+                "short": true
+              },
+              {
+                "title": "Severity",
+                "value": "Critical: {{ outputs['push-code-analysis'].criticalIssues }}, High: {{ outputs['push-code-analysis'].errorIssues }}",
+                "short": false
+              }
+            ],
+            "footer": "Visor Analysis",
+            "footer_icon": "https://example.com/visor-icon.png",
+            "ts": {{ timestamp | date: '%s' }}
+          }
+        ]
+      }
+
+  # Create GitHub issue if critical problems found
+  create-github-issue:
+    type: http
+    depends_on: [push-code-analysis]
+    if: "outputs['push-code-analysis'].criticalIssues > 0"
+    url: "https://api.github.com/repos/{{ outputs['github-push-receiver'].repository }}/issues"
+    method: POST
+    headers:
+      Authorization: "token ${GITHUB_TOKEN}"  # Read from GITHUB_TOKEN environment variable
+      Accept: "application/vnd.github.v3+json"
+    body: |
+      {
+        "title": "Critical issues found in commit {{ outputs['github-push-receiver'].commit | slice: 0, 8 }}",
+        "body": "## Visor Analysis Report\n\n**Branch:** {{ outputs['github-push-receiver'].branch }}\n**Commit:** {{ outputs['github-push-receiver'].commit }}\n\n### Critical Issues Found\n\n{% for issue in outputs['push-code-analysis'].issues %}{% if issue.severity == 'critical' %}- **{{ issue.category }}**: {{ issue.message }}\n  - File: `{{ issue.file }}:{{ issue.line }}`\n{% endif %}{% endfor %}\n\n---\n*This issue was automatically created by Visor*",
+        "labels": ["critical", "automated", "security"],
+        "assignees": ["{{ outputs['github-push-receiver'].author }}"]
+      }
+
+  # === JIRA Integration Pipeline ===
+
+  # Receive JIRA webhook events
+  jira-receiver:
+    type: http_input
+    endpoint: "/jira/issue"
+    on: [webhook_received]
+
+  # Analyze JIRA issue for code implications
+  jira-code-impact:
+    type: ai
+    depends_on: [jira-receiver]
+    prompt: |
+      JIRA issue update:
+      - Key: {{ outputs['jira-receiver'].issue_key }}
+      - Status: {{ outputs['jira-receiver'].status }}
+      - Priority: {{ outputs['jira-receiver'].priority }}
+
+      {% if outputs['jira-receiver'].status == 'In Progress' %}
+      Generate a checklist of code areas that might be affected by this issue.
+      {% elsif outputs['jira-receiver'].status == 'Done' %}
+      Suggest verification steps and potential regression test areas.
+      {% endif %}
+    group: jira-analysis
+
+  # Update team dashboard
+  update-dashboard:
+    type: http
+    depends_on: [jira-code-impact]
+    url: "${DASHBOARD_WEBHOOK}"  # Read from DASHBOARD_WEBHOOK environment variable
+    method: PUT
+    body: |
+      {
+        "widget": "jira-updates",
+        "data": {
+          "issue": "{{ outputs['jira-receiver'].issue_key }}",
+          "status": "{{ outputs['jira-receiver'].status }}",
+          "analysis": {{ outputs['jira-code-impact'].suggestions | json }},
+          "updated_at": "{{ timestamp }}"
+        }
+      }
+
+  # === Multi-source Aggregation ===
+
+  # Daily summary combining multiple sources
+  daily-summary:
+    type: ai
+    schedule: "0 18 * * *"  # 6 PM daily
+    depends_on: []  # Will access historical data if available
+    prompt: |
+      Generate a daily development summary including:
+      1. Push activity from today
+      2. JIRA issues updated
+      3. Security scan results
+      4. Performance metrics
+
+      Format as an executive summary with key metrics and action items.
+    group: daily-report
+
+  # Send daily summary to multiple channels
+  broadcast-summary:
+    type: http
+    depends_on: [daily-summary]
+    url: "${BROADCAST_WEBHOOK}"  # Read from BROADCAST_WEBHOOK environment variable
+    body: |
+      {
+        "recipients": [
+          {
+            "channel": "email",
+            "to": "team@example.com",
+            "subject": "Daily Visor Summary - {{ timestamp | date: '%Y-%m-%d' }}"
+          },
+          {
+            "channel": "slack",
+            "to": "#daily-standup"
+          },
+          {
+            "channel": "teams",
+            "to": "Development Team"
+          }
+        ],
+        "content": {
+          "summary": {{ outputs['daily-summary'] | json }},
+          "metrics": {
+            "total_pushes": 0,
+            "issues_resolved": 0,
+            "critical_findings": 0
+          }
+        }
+      }
+
+output:
+  pr_comment:
+    format: markdown
+    group_by: check
+    collapse: true

package/dist/examples/workflows/calculator-workflow.yaml

@@ -0,0 +1,163 @@
+# Standalone executable workflow with inputs, outputs, and self-tests
+# Can be run directly: visor --config defaults/calculator-workflow.yaml
+# Or imported and used as a step in another config
+
+id: calculator
+name: Simple Calculator
+description: A simple calculator workflow that performs arithmetic operations
+version: "1.0.0"
+
+inputs:
+  - name: operation
+    description: The operation to perform (add, subtract, multiply, divide)
+    schema:
+      type: string
+      enum: [add, subtract, multiply, divide]
+    default: "add"
+
+  - name: a
+    description: First operand
+    schema:
+      type: number
+    default: 10
+
+  - name: b
+    description: Second operand
+    schema:
+      type: number
+    default: 5
+
+outputs:
+  - name: result
+    description: The calculated result
+    value_js: |
+      const calc = steps.calculate.output;
+      return calc ? calc.result : null;
+
+  - name: operation_performed
+    description: The operation that was performed
+    value_js: |
+      return inputs.operation;
+
+  - name: summary
+    description: Human readable summary
+    value_js: |
+      const calc = steps.calculate.output;
+      if (!calc) return "Calculation failed";
+      return `${inputs.a} ${inputs.operation} ${inputs.b} = ${calc.result}`;
+
+# Workflow steps - these define the workflow logic
+steps:
+  validate_inputs:
+    type: command
+    exec: |
+      echo '{"valid": true, "a": {{ inputs.a }}, "b": {{ inputs.b }}, "operation": "{{ inputs.operation }}"}'
+
+  calculate:
+    type: command
+    depends_on: [validate_inputs]
+    exec: |
+      #!/bin/bash
+      operation="{{ inputs.operation }}"
+      a={{ inputs.a }}
+      b={{ inputs.b }}
+
+      case $operation in
+        add)
+          result=$(echo "$a + $b" | bc -l)
+          ;;
+        subtract)
+          result=$(echo "$a - $b" | bc -l)
+          ;;
+        multiply)
+          result=$(echo "$a * $b" | bc -l)
+          ;;
+        divide)
+          if [ "$b" = "0" ]; then
+            echo '{"error": "Division by zero"}'
+            exit 1
+          fi
+          result=$(echo "scale=2; $a / $b" | bc -l)
+          ;;
+        *)
+          echo '{"error": "Unknown operation"}'
+          exit 1
+          ;;
+      esac
+
+      echo "{\"result\": $result, \"operation\": \"$operation\"}"
+
+  log_result:
+    type: log
+    depends_on: [calculate]
+    message: |
+      Calculator Result:
+      Operation: {{ inputs.operation }}
+      {{ inputs.a }} {{ inputs.operation }} {{ inputs.b }} = {{ steps.calculate.output.result }}
+
+# Tests - these are ONLY executed when running this file standalone
+# They are NOT imported when this workflow is used as a step in another config
+tests:
+  # Test 1: Default inputs (10 + 5 = 15)
+  test_default_addition:
+    type: workflow
+    workflow: calculator
+    # Uses default inputs (operation=add, a=10, b=5)
+
+  # Test 2: Subtraction
+  test_subtraction:
+    type: workflow
+    workflow: calculator
+    args:
+      operation: subtract
+      a: 20
+      b: 8
+    # Expected: 20 - 8 = 12
+
+  # Test 3: Multiplication
+  test_multiplication:
+    type: workflow
+    workflow: calculator
+    args:
+      operation: multiply
+      a: 6
+      b: 7
+    # Expected: 6 * 7 = 42
+
+  # Test 4: Division
+  test_division:
+    type: workflow
+    workflow: calculator
+    args:
+      operation: divide
+      a: 100
+      b: 4
+    # Expected: 100 / 4 = 25
+
+  # Validate all tests passed
+  validate_tests:
+    type: command
+    depends_on: [test_default_addition, test_subtraction, test_multiplication, test_division]
+    exec: |
+      #!/bin/bash
+      # Get results from each test
+      addition="{{ outputs.test_default_addition.result }}"
+      subtraction="{{ outputs.test_subtraction.result }}"
+      multiplication="{{ outputs.test_multiplication.result }}"
+      division="{{ outputs.test_division.result }}"
+
+      echo "Test Results:"
+      echo "  Addition (10 + 5): $addition (expected 15)"
+      echo "  Subtraction (20 - 8): $subtraction (expected 12)"
+      echo "  Multiplication (6 * 7): $multiplication (expected 42)"
+      echo "  Division (100 / 4): $division (expected 25)"
+
+      # Simple validation
+      if [ "$addition" = "15" ] && [ "$subtraction" = "12" ] && [ "$multiplication" = "42" ] && [ "$division" = "25" ]; then
+        echo '{"all_tests_passed": true}'
+        exit 0
+      else
+        echo '{"all_tests_passed": false, "error": "Some tests failed"}'
+        exit 1
+      fi
+    fail_if: output.all_tests_passed === false