@probelabs/visor 0.1.106 → 0.1.111

package/dist/examples/reusable-tools.yaml

@@ -0,0 +1,92 @@
+version: "1.0"
+
+# Reusable Tools Library
+# This file defines custom tools that can be imported and reused across multiple configurations.
+
+tools:
+  fetch-jira-issue:
+    name: fetch-jira-issue
+    description: Fetch JIRA issue details by issue key
+    inputSchema:
+      type: object
+      properties:
+        issue_key:
+          type: string
+          description: JIRA issue key (e.g., PROJ-123)
+      required: [issue_key]
+    exec: |
+      # In production, this would call JIRA API
+      # For demo, we simulate fetching issue data
+      ISSUE_KEY="{{ args.issue_key }}"
+      echo "{
+        \"key\": \"$ISSUE_KEY\",
+        \"summary\": \"Example issue for $ISSUE_KEY\",
+        \"priority\": \"high\",
+        \"assignee\": \"alice\",
+        \"status\": \"in-progress\"
+      }"
+    parseJson: true
+    timeout: 5000
+
+  fetch-external-data:
+    name: fetch-external-data
+    description: Fetch data from various external sources
+    inputSchema:
+      type: object
+      properties:
+        source:
+          type: string
+          description: Data source identifier
+        format:
+          type: string
+          enum: [json, xml, text]
+          default: json
+      required: [source]
+    exec: |
+      SOURCE="{{ args.source }}"
+      FORMAT="{{ args.format }}"
+
+      case $SOURCE in
+        "user-db")
+          echo '{"source":"user-db","data":{"users":["alice","bob"],"count":2}}'
+          ;;
+        "config-service")
+          echo '{"source":"config-service","data":{"environment":"production","version":"1.2.3"}}'
+          ;;
+        "metrics-api")
+          echo '{"source":"metrics-api","data":{"cpu":45,"memory":78,"requests":1523}}'
+          ;;
+        *)
+          echo '{"source":"'$SOURCE'","data":"mock-data","format":"'$FORMAT'"}'
+          ;;
+      esac
+    parseJson: true
+    timeout: 5000
+
+  validate-data:
+    name: validate-data
+    description: Validate data against rules
+    inputSchema:
+      type: object
+      properties:
+        data:
+          type: object
+          description: Data to validate
+        rules:
+          type: array
+          description: Validation rules
+      required: [data]
+    exec: |
+      # Simple validation check
+      DATA='{{ args.data | json }}'
+      echo "{
+        \"valid\": true,
+        \"checked_at\": \"$(date -u +%Y-%m-%dT%H:%M:%SZ)\",
+        \"data\": $DATA
+      }"
+    parseJson: true
+    timeout: 2000
+
+# This file is meant to be imported via "extends:" in other configurations.
+# No steps are defined here - only reusable tools.
+steps: {}

package/dist/examples/reusable-workflows.yaml

@@ -0,0 +1,88 @@
+version: "1.0"
+
+# Reusable Workflows Library
+# This file defines workflows that can be imported and reused across multiple configurations.
+
+workflows:
+  data-enrichment:
+    name: data-enrichment
+    description: Fetch and enrich data from multiple sources
+    steps:
+      - id: fetch-primary
+        type: command
+        exec: |
+          echo '{"primary":"data","value":42}'
+
+      - id: fetch-secondary
+        type: command
+        exec: |
+          echo '{"secondary":"metadata","timestamp":"2024-01-01"}'
+
+      - id: merge-results
+        type: command
+        exec: |
+          echo '{"enriched":true,"primary":{{ outputs["fetch-primary"] | json }},"secondary":{{ outputs["fetch-secondary"] | json }}}'
+        parseJson: true
+
+    output_mapping:
+      enriched_data: "{{ outputs['merge-results'] }}"
+
+  issue-triage:
+    name: issue-triage
+    description: Triage and categorize issues
+    steps:
+      - id: analyze-issue
+        type: command
+        exec: |
+          echo '{"category":"bug","priority":"high","labels":["security","urgent"]}'
+        parseJson: true
+
+      - id: assign-owner
+        type: command
+        exec: |
+          PRIORITY='{{ outputs["analyze-issue"].priority }}'
+          if [ "$PRIORITY" = "high" ]; then
+            echo '{"owner":"senior-dev","team":"security"}'
+          else
+            echo '{"owner":"junior-dev","team":"support"}'
+          fi
+        parseJson: true
+
+    output_mapping:
+      triage_result: "{{ outputs['analyze-issue'] }}"
+      assignment: "{{ outputs['assign-owner'] }}"
+
+  multi-step-validation:
+    name: multi-step-validation
+    description: Validate data through multiple steps
+    steps:
+      - id: schema-check
+        type: command
+        exec: |
+          echo '{"schema_valid":true,"errors":[]}'
+        parseJson: true
+
+      - id: business-rules
+        type: command
+        exec: |
+          echo '{"rules_passed":true,"warnings":["minor-issue"]}'
+        parseJson: true
+
+      - id: final-verdict
+        type: command
+        exec: |
+          SCHEMA_VALID='{{ outputs["schema-check"].schema_valid }}'
+          RULES_PASSED='{{ outputs["business-rules"].rules_passed }}'
+          if [ "$SCHEMA_VALID" = "true" ] && [ "$RULES_PASSED" = "true" ]; then
+            echo '{"valid":true,"status":"approved"}'
+          else
+            echo '{"valid":false,"status":"rejected"}'
+          fi
+        parseJson: true
+
+    output_mapping:
+      validation_result: "{{ outputs['final-verdict'] }}"
+
+# This file is meant to be imported via "extends:" in other configurations.
+# No steps are defined here - only reusable workflows.
+steps: {}

package/dist/examples/routing-basic.yaml

@@ -0,0 +1,35 @@
+version: "2.0"
+
+# Basic failure routing: retry + goto ancestor
+routing:
+  max_loops: 5
+  defaults:
+    on_fail:
+      retry:
+        max: 1
+        backoff: { mode: exponential, delay_ms: 400 }
+
+steps:
+  setup-env:
+    type: command
+    exec: "echo '[setup] preparing environment'"
+
+  flaky:
+    type: command
+    depends_on: [setup-env]
+    exec: |
+      FLAG=".visor_demo_flaky"
+      if [ ! -f "$FLAG" ]; then
+        echo "first attempt failing" >&2
+        touch "$FLAG"
+        exit 1
+      fi
+      echo "second attempt OK"
+    on_fail:
+      goto: setup-env
+
+  cleanup:
+    type: command
+    depends_on: [flaky]
+    exec: "rm -f .visor_demo_flaky && echo '[cleanup] done'"
+

package/dist/examples/routing-dynamic-js.yaml

@@ -0,0 +1,46 @@
+version: "2.0"
+
+# Dynamic routing using *_js hooks
+routing:
+  max_loops: 6
+
+steps:
+  setup:
+    type: command
+    exec: "echo '[setup] install deps'"
+
+  lint-fix:
+    type: command
+    exec: "echo '[lint-fix] apply fixes'"
+
+  target:
+    type: command
+    depends_on: [setup]
+    exec: |
+      # Simulate a missing module error on first try
+      FLAG=".visor_demo_dynamic"
+      if [ ! -f "$FLAG" ]; then
+        echo "module not found: axios" >&2
+        touch "$FLAG"
+        exit 1
+      fi
+      echo "[target] succeeded"
+    on_fail:
+      goto_js: |
+        // If we see a missing module message, jump back to setup
+        if ((error.message||'').toLowerCase().includes('module not found')) return 'setup';
+        if ((error.stderr||'').toLowerCase().includes('module not found')) return 'setup';
+        return null;
+      run_js: |
+        // If lint is mentioned, add lint-fix dynamically
+        const out = [];
+        const s = (error.stderr||'').toLowerCase();
+        if (s.includes('lint')) out.push('lint-fix');
+        return out;
+      retry: { max: 1, backoff: { mode: fixed, delay_ms: 200 } }
+
+  cleanup:
+    type: command
+    depends_on: [target]
+    exec: "rm -f .visor_demo_dynamic && echo '[cleanup] done'"
+

package/dist/examples/routing-foreach.yaml

@@ -0,0 +1,34 @@
+version: "2.0"
+
+# forEach + failure routing: remediate missing markers, then retry
+routing:
+  max_loops: 6
+
+steps:
+  list:
+    type: command
+    exec: "echo '[\"alpha\",\"beta\"]'"
+    forEach: true
+
+  mark:
+    type: command
+    depends_on: [list]
+    exec: "touch .visor_demo_marker_{{ outputs.list }} && echo '[mark] {{ outputs.list }}'"
+
+  process:
+    type: command
+    depends_on: [list]
+    exec: |
+      FILE=".visor_demo_marker_{{ outputs.list }}"
+      if [ -f "$FILE" ]; then echo "[process] {{ outputs.list }} ready"; exit 0; fi
+      echo "[process] missing marker for {{ outputs.list }}" >&2
+      exit 1
+    on_fail:
+      run: [mark]
+      retry: { max: 1, backoff: { mode: fixed, delay_ms: 200 } }
+
+  cleanup:
+    type: command
+    depends_on: [process]
+    exec: "rm -f .visor_demo_marker_* && echo '[cleanup] done'"
+

package/dist/examples/routing-goto-event.yaml

@@ -0,0 +1,34 @@
+version: "2.0"
+
+steps:
+  # A typical PR overview step that runs on PR events
+  overview:
+    type: ai
+    on: [pr_opened, pr_updated]
+    schema: overview
+    prompt: |
+      Return JSON matching the `overview` schema with a concise markdown summary.
+
+  # A downstream check that, after succeeding, wants to refresh overview as if a PR update occurred
+  quality:
+    type: ai
+    depends_on: [overview]
+    on: [pr_opened, pr_updated]
+    prompt: |
+      Analyze code quality aspects.
+    on_success:
+      goto: overview        # Jump to ancestor
+      goto_event: pr_updated
+
+  # A command demonstrating conditional jumps based on state
+  validate:
+    type: command
+    depends_on: [quality]
+    exec: |
+      echo "validate"
+    on_fail:
+      goto_js: |
+        // Demonstration: dynamically pick an ancestor once
+        return attempt === 1 ? 'overview' : null
+      goto_event: pr_updated
+

package/dist/examples/routing-on-success.yaml

@@ -0,0 +1,25 @@
+version: "2.0"
+
+# Success routing: run post-steps and jump back once to re-validate
+routing:
+  max_loops: 5
+
+steps:
+  unit-tests:
+    type: command
+    exec: "echo '[unit] ok'"
+
+  build:
+    type: command
+    depends_on: [unit-tests]
+    exec: "echo '[build] ok'"
+    on_success:
+      run: [notify]
+      goto_js: |
+        // Jump back only once to re-run unit-tests after build
+        return attempt === 1 ? 'unit-tests' : null;
+
+  notify:
+    type: command
+    exec: "echo '[notify] sent'"
+

package/dist/examples/run-calculator-demo.sh

@@ -0,0 +1,71 @@
+#!/bin/bash
+
+# Interactive Calculator Demo Script
+# This script demonstrates the calculator example using piped input
+
+echo "╔═══════════════════════════════════════════╗"
+echo "║   Visor Calculator Demo                  ║"
+echo "║   Human Input + Memory + JavaScript      ║"
+echo "╚═══════════════════════════════════════════╝"
+echo ""
+
+echo "This demo will calculate: 42 + 7"
+echo ""
+echo "Running with piped input (non-interactive):"
+echo "  First number: 42"
+echo "  Second number: 7"
+echo "  Operation: +"
+echo ""
+echo "Press Enter to run..."
+read
+
+# Note: This would work if visor was built and the checks run sequentially
+# For now, this is a demonstration of how it would work
+
+echo "Command that would run:"
+echo ""
+echo "  echo '42' | visor --config examples/calculator-config.yaml --check get-number1"
+echo "  echo '7' | visor --config examples/calculator-config.yaml --check get-number2"
+echo "  echo '+' | visor --config examples/calculator-config.yaml --check get-operation"
+echo ""
+
+echo "Or interactively:"
+echo ""
+echo "  visor --config examples/calculator-config.yaml"
+echo ""
+
+echo "This would prompt you for each input with a beautiful UI like:"
+echo ""
+echo "┌─────────────────────────────────────────┐"
+echo "│ 💬 Human Input Required                 │"
+echo "├─────────────────────────────────────────┤"
+echo "│                                         │"
+echo "│ Enter the first number:                 │"
+echo "│                                         │"
+echo "│ ┌─────────────────────────────────────┐ │"
+echo "│ │ e.g., 42                            │ │"
+echo "│ │                                     │ │"
+echo "│ │ (Type your response and press Enter)│ │"
+echo "│ └─────────────────────────────────────┘ │"
+echo "│                                         │"
+echo "└─────────────────────────────────────────┘"
+echo ""
+echo "> 42"
+echo ""
+
+echo "Then the result would be:"
+echo ""
+echo "╔════════════════════════════════════════╗"
+echo "║          CALCULATION RESULT            ║"
+echo "╠════════════════════════════════════════╣"
+echo "║                                        ║"
+echo "║  42 + 7 = 49                           ║"
+echo "║                                        ║"
+echo "╚════════════════════════════════════════╝"
+echo ""
+
+echo "✨ Once Visor is built, you can run the actual calculator with:"
+echo ""
+echo "  npm run build"
+echo "  ./dist/cli-main.js --config examples/calculator-config.yaml"
+echo ""

package/dist/examples/sdk-basic.mjs

@@ -0,0 +1,10 @@
+import { loadConfig, runChecks } from '../dist/sdk/sdk.mjs';
+
+async function main() {
+  // Load config from object - validation and defaults applied automatically
+  const config = await loadConfig({ version: '1.0', checks: {} });
+  const res = await runChecks({ config, checks: [], output: { format: 'json' }, debug: false });
+  console.log(JSON.stringify({ totalIssues: res.reviewSummary.issues?.length || 0 }, null, 2));
+}
+
+main().catch(err => { console.error(err); process.exit(1); });

package/dist/examples/sdk-cjs.cjs

@@ -0,0 +1,10 @@
+const { loadConfig, runChecks } = require('../dist/sdk/sdk.js');
+
+async function main() {
+  // Load config from object - validation and defaults applied automatically
+  const config = await loadConfig({ version: '1.0', checks: {} });
+  const res = await runChecks({ config, checks: [], output: { format: 'json' } });
+  console.log('Issues:', res.reviewSummary.issues?.length || 0);
+}
+
+main().catch(err => { console.error(err); process.exit(1); });

package/dist/examples/sdk-comprehensive.mjs

@@ -0,0 +1,175 @@
+/**
+ * Comprehensive SDK Example
+ *
+ * Demonstrates:
+ * - loadConfig() with raw object
+ * - Complex check dependencies (depends_on)
+ * - Check execution order
+ * - Different check types
+ * - Tag filtering
+ * - Parallel execution control
+ * - Error handling and results inspection
+ */
+
+import { loadConfig, runChecks, resolveChecks } from '../dist/sdk/sdk.mjs';
+
+async function main() {
+  console.log('=== Visor SDK - Comprehensive Example ===\n');
+
+  // Create a complex config with dependencies
+  const config = await loadConfig({
+    version: '1.0',
+    checks: {
+      // Step 1: Setup/preparation check
+      'setup': {
+        type: 'command',
+        exec: 'echo "Setup: Installing dependencies..."',
+        tags: ['setup'],
+      },
+
+      // Step 2: Run tests (depends on setup)
+      'unit-tests': {
+        type: 'command',
+        exec: 'echo "Running unit tests..."',
+        depends_on: ['setup'],
+        tags: ['tests'],
+      },
+
+      // Step 3: Integration tests (depends on setup)
+      'integration-tests': {
+        type: 'command',
+        exec: 'echo "Running integration tests..."',
+        depends_on: ['setup'],
+        tags: ['tests'],
+      },
+
+      // Step 4: Security scan (depends on setup)
+      'security-scan': {
+        type: 'command',
+        exec: 'echo "Running security scan..."',
+        depends_on: ['setup'],
+        tags: ['security', 'critical'],
+      },
+
+      // Step 5: Linting (depends on setup)
+      'lint': {
+        type: 'command',
+        exec: 'echo "Running linter..."',
+        depends_on: ['setup'],
+        tags: ['quality'],
+      },
+
+      // Step 6: Build (depends on all tests passing)
+      'build': {
+        type: 'command',
+        exec: 'echo "Building application..."',
+        depends_on: ['unit-tests', 'integration-tests', 'lint'],
+        tags: ['build'],
+      },
+
+      // Step 7: Deploy check (depends on build and security)
+      'deploy-check': {
+        type: 'command',
+        exec: 'echo "Checking deployment readiness..."',
+        depends_on: ['build', 'security-scan'],
+        tags: ['deployment'],
+      },
+
+      // Step 8: Final report (depends on everything)
+      'report': {
+        type: 'command',
+        exec: 'echo "Generating final report..."',
+        depends_on: ['deploy-check'],
+        tags: ['reporting'],
+      },
+    },
+    max_parallelism: 3,
+    fail_fast: false,
+  });
+
+  console.log('📋 Config loaded with', Object.keys(config.checks).length, 'checks\n');
+
+  // Example 1: Resolve dependencies
+  console.log('=== Example 1: Dependency Resolution ===');
+  const reportDeps = resolveChecks(['report'], config);
+  console.log('To run "report", these checks execute in order:');
+  reportDeps.forEach((check, idx) => {
+    console.log(`  ${idx + 1}. ${check}`);
+  });
+
+  // Example 2: Run specific checks
+  console.log('\n=== Example 2: Run Specific Checks ===');
+  const testResult = await runChecks({
+    config,
+    checks: ['setup', 'unit-tests', 'integration-tests'],
+    output: { format: 'json' },
+    debug: false,
+  });
+  console.log('✅ Executed:', testResult.checksExecuted.join(', '));
+  console.log('⏱️  Time:', testResult.executionTime, 'ms');
+
+  // Example 3: Tag filtering
+  console.log('\n=== Example 3: Tag Filtering ===');
+  const securityResult = await runChecks({
+    config,
+    checks: Object.keys(config.checks),
+    tagFilter: { include: ['critical'] },
+    output: { format: 'json' },
+    debug: false,
+  });
+  console.log('✅ Critical checks:', securityResult.checksExecuted.join(', '));
+  console.log('⏱️  Time:', securityResult.executionTime, 'ms');
+
+  // Example 4: Full pipeline
+  console.log('\n=== Example 4: Full Pipeline ===');
+  const fullResult = await runChecks({
+    config,
+    checks: Object.keys(config.checks),
+    output: { format: 'json' },
+    maxParallelism: 3,
+    debug: false,
+  });
+
+  console.log('📊 Results:');
+  console.log('  Checks:', fullResult.checksExecuted.length);
+  console.log('  Time:', fullResult.executionTime, 'ms');
+  console.log('  Issues:', fullResult.reviewSummary.issues?.length || 0);
+
+  console.log('\n  Execution order:');
+  fullResult.checksExecuted.forEach((check, idx) => {
+    console.log(`    ${idx + 1}. ${check}`);
+  });
+
+  // Example 5: Strict validation
+  console.log('\n=== Example 5: Strict Validation ===');
+  try {
+    await loadConfig({
+      version: '1.0',
+      checks: { test: { type: 'command', exec: 'echo test' } },
+      typo_field: 'error!',
+    }, { strict: true });
+    console.log('❌ Should have thrown');
+  } catch (error) {
+    console.log('✅ Caught:', error.message.substring(0, 50) + '...');
+  }
+
+  // Example 6: Dependency graph
+  console.log('\n=== Example 6: Dependency Graph ===');
+  for (const name of Object.keys(config.checks)) {
+    const deps = config.checks[name].depends_on || [];
+    const tags = config.checks[name].tags || [];
+    const tagStr = tags.length ? ` [${tags.join(',')}]` : '';
+    if (deps.length) {
+      console.log(`  ${name}${tagStr} → ${deps.join(', ')}`);
+    } else {
+      console.log(`  ${name}${tagStr} → (root)`);
+    }
+  }
+
+  console.log('\n✅ All examples complete!\n');
+}
+
+main().catch(err => {
+  console.error('❌ Error:', err.message);
+  process.exit(1);
+});