@probelabs/visor 0.1.106 → 0.1.107

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

package/dist/examples/sdk-manual-config.mjs

@@ -0,0 +1,65 @@
+/**
+ * Example: SDK with manually constructed config object
+ * This demonstrates using loadConfig() with a raw config object
+ * instead of loading from a file.
+ */
+
+import { loadConfig, runChecks } from '../dist/sdk/sdk.mjs';
+
+async function main() {
+  // Load and validate config from an object (not a file!)
+  // loadConfig() validates, applies defaults, and returns a complete config
+  const config = await loadConfig({
+    version: '1.0',
+    checks: {
+      'security-check': {
+        type: 'command',
+        exec: 'echo "Running security scan..."',
+      },
+      'lint-check': {
+        type: 'command',
+        exec: 'echo "Running linter..."',
+        depends_on: ['security-check'],
+      },
+    },
+  });
+
+  console.log('Running checks with manually constructed config...\n');
+
+  // Run all checks defined in the config
+  const result = await runChecks({
+    config,
+    checks: Object.keys(config.checks),
+    output: { format: 'json' },
+    debug: false,
+  });
+
+  // Display results
+  console.log('Execution summary:');
+  console.log(`  Total checks executed: ${result.checksExecuted.length}`);
+  console.log(`  Total issues found: ${result.reviewSummary.issues?.length || 0}`);
+  console.log(`  Execution time: ${result.executionTime}ms`);
+  console.log(`  Timestamp: ${result.timestamp}`);
+
+  // Display check results
+  console.log('\nCheck results:');
+  for (const checkName of result.checksExecuted) {
+    console.log(`  ✓ ${checkName}`);
+  }
+
+  // Display any issues found
+  if (result.reviewSummary.issues && result.reviewSummary.issues.length > 0) {
+    console.log('\nIssues found:');
+    result.reviewSummary.issues.forEach((issue, idx) => {
+      console.log(`  ${idx + 1}. [${issue.severity}] ${issue.message}`);
+      console.log(`     File: ${issue.file}:${issue.line}`);
+    });
+  }
+
+  return result;
+}
+
+main().catch((err) => {
+  console.error('Error:', err);
+  process.exit(1);
+});

package/dist/examples/sdk-typescript.js

@@ -0,0 +1,81 @@
+/**
+ * TypeScript SDK Example
+ *
+ * Demonstrates:
+ * - Type-safe config construction
+ * - TypeScript type inference
+ * - Compile-time type checking
+ * - Using exported types
+ */
+// Import from the package for full TypeScript type definitions
+// In a real project, you would use: '@probelabs/visor/sdk'
+// For this example, we import from the built SDK with type definitions
+import { loadConfig, runChecks } from '../dist/sdk/sdk.js';
+async function main() {
+    console.log('=== Visor SDK - TypeScript Example ===\n');
+    // Type-safe config construction (note: VisorConfig is exported from SDK)
+    const rawConfig = {
+        version: '1.0',
+        checks: {
+            'type-check': {
+                type: 'command',
+                exec: 'echo "Running TypeScript compiler..."',
+                tags: ['typescript', 'build'],
+            },
+            'unit-tests': {
+                type: 'command',
+                exec: 'echo "Running unit tests..."',
+                depends_on: ['type-check'],
+                tags: ['testing'],
+            },
+            'build': {
+                type: 'command',
+                exec: 'echo "Building application..."',
+                depends_on: ['type-check', 'unit-tests'],
+                tags: ['build'],
+            },
+        },
+        max_parallelism: 2,
+        fail_fast: false,
+    };
+    // Load and validate config with full type safety
+    const config = await loadConfig(rawConfig);
+    console.log('✅ Config validated and loaded');
+    console.log(`   Checks: ${Object.keys(config.checks).length}`);
+    console.log(`   Max parallelism: ${config.max_parallelism}\n`);
+    // Run checks with type-safe options
+    const result = await runChecks({
+        config,
+        checks: ['type-check', 'unit-tests', 'build'],
+        output: { format: 'json' },
+        maxParallelism: 2,
+        debug: false,
+        tagFilter: { include: ['typescript', 'testing', 'build'] },
+    });
+    // Type-safe result inspection
+    console.log('📊 Results:');
+    console.log(`   Checks executed: ${result.checksExecuted.length}`);
+    console.log(`   Execution time: ${result.executionTime}ms`);
+    console.log(`   Issues found: ${result.reviewSummary.issues?.length ?? 0}`);
+    console.log(`   Timestamp: ${result.timestamp}`);
+    // Type-safe iteration over results
+    console.log('\n   Executed checks:');
+    result.checksExecuted.forEach((checkName, index) => {
+        console.log(`     ${index + 1}. ${checkName}`);
+    });
+    // Demonstrate type checking with issues
+    if (result.reviewSummary.issues && result.reviewSummary.issues.length > 0) {
+        console.log('\n   Issues:');
+        result.reviewSummary.issues.forEach((issue) => {
+            // TypeScript knows the structure of issue
+            console.log(`     ${issue.file}:${issue.line} - ${issue.message}`);
+            console.log(`     Severity: ${issue.severity}`);
+        });
+    }
+    console.log('\n✅ TypeScript example complete!\n');
+}
+// Run with proper error handling
+main().catch((error) => {
+    console.error('❌ Error:', error.message);
+    process.exit(1);
+});

package/dist/examples/sdk-typescript.ts

@@ -0,0 +1,92 @@
+/**
+ * TypeScript SDK Example
+ *
+ * Demonstrates:
+ * - Type-safe config construction
+ * - TypeScript type inference
+ * - Compile-time type checking
+ * - Using exported types
+ */
+
+// Import from the package for full TypeScript type definitions
+// In a real project, you would use: '@probelabs/visor/sdk'
+// For this example, we import from the built SDK with type definitions
+import { loadConfig, runChecks, type VisorConfig, type RunOptions } from '../dist/sdk/sdk.js';
+
+async function main(): Promise<void> {
+  console.log('=== Visor SDK - TypeScript Example ===\n');
+
+  // Type-safe config construction (note: VisorConfig is exported from SDK)
+  const rawConfig: Partial<VisorConfig> = {
+    version: '1.0',
+    checks: {
+      'type-check': {
+        type: 'command',
+        exec: 'echo "Running TypeScript compiler..."',
+        tags: ['typescript', 'build'],
+      },
+      'unit-tests': {
+        type: 'command',
+        exec: 'echo "Running unit tests..."',
+        depends_on: ['type-check'],
+        tags: ['testing'],
+      },
+      'build': {
+        type: 'command',
+        exec: 'echo "Building application..."',
+        depends_on: ['type-check', 'unit-tests'],
+        tags: ['build'],
+      },
+    },
+    max_parallelism: 2,
+    fail_fast: false,
+  };
+
+  // Load and validate config with full type safety
+  const config = await loadConfig(rawConfig);
+
+  console.log('✅ Config validated and loaded');
+  console.log(`   Checks: ${Object.keys(config.checks).length}`);
+  console.log(`   Max parallelism: ${config.max_parallelism}\n`);
+
+  // Run checks with type-safe options
+  const result = await runChecks({
+    config,
+    checks: ['type-check', 'unit-tests', 'build'],
+    output: { format: 'json' },
+    maxParallelism: 2,
+    debug: false,
+    tagFilter: { include: ['typescript', 'testing', 'build'] },
+  });
+
+  // Type-safe result inspection
+  console.log('📊 Results:');
+  console.log(`   Checks executed: ${result.checksExecuted.length}`);
+  console.log(`   Execution time: ${result.executionTime}ms`);
+  console.log(`   Issues found: ${result.reviewSummary.issues?.length ?? 0}`);
+  console.log(`   Timestamp: ${result.timestamp}`);
+
+  // Type-safe iteration over results
+  console.log('\n   Executed checks:');
+  result.checksExecuted.forEach((checkName: string, index: number) => {
+    console.log(`     ${index + 1}. ${checkName}`);
+  });
+
+  // Demonstrate type checking with issues
+  if (result.reviewSummary.issues && result.reviewSummary.issues.length > 0) {
+    console.log('\n   Issues:');
+    result.reviewSummary.issues.forEach((issue) => {
+      // TypeScript knows the structure of issue
+      console.log(`     ${issue.file}:${issue.line} - ${issue.message}`);
+      console.log(`     Severity: ${issue.severity}`);
+    });
+  }
+
+  console.log('\n✅ TypeScript example complete!\n');
+}
+
+// Run with proper error handling
+main().catch((error: Error) => {
+  console.error('❌ Error:', error.message);
+  process.exit(1);
+});

package/dist/examples/session-reuse-config.yaml

@@ -0,0 +1,151 @@
+# Example configuration demonstrating AI session reuse functionality
+# This allows subsequent checks to continue conversations with AI models
+
+version: "1.0"
+
+# Example 1: Simple session reuse for follow-up analysis
+steps:
+  # Initial security analysis - creates a new AI session
+  security-analysis:
+    type: ai
+    prompt: |
+      You are a security expert reviewing code changes. Analyze the provided code for:
+
+      1. Authentication and authorization issues
+      2. Input validation vulnerabilities
+      3. Data exposure risks
+      4. Cryptographic weaknesses
+      5. Injection vulnerabilities
+
+      Provide specific examples and recommendations for each issue found.
+    on:
+      - pr_opened
+      - pr_updated
+    ai:
+      provider: anthropic  # or google, openai
+      model: claude-3-sonnet-20240229
+
+  # Follow-up check that reuses the previous AI session
+  security-remediation:
+    type: ai
+    prompt: |
+      Based on our previous security analysis discussion, now provide:
+
+      1. Detailed remediation steps for each identified security issue
+      2. Code examples showing secure implementations
+      3. Best practices specific to this codebase
+      4. Priority ranking of fixes needed
+
+      Build upon the context we established in our previous conversation.
+    on:
+      - pr_opened
+      - pr_updated
+    depends_on:
+      - security-analysis
+    reuse_ai_session: true  # This will reuse the AI session from security-analysis
+
+# Example 2: Multi-level session reuse chain
+  architecture-review:
+    type: ai
+    prompt: |
+      Analyze the architectural patterns and design decisions in this code.
+      Identify the main components, their interactions, and design quality.
+    on:
+      - pr_opened
+    ai:
+      provider: anthropic
+      model: claude-3-sonnet-20240229
+
+  performance-analysis:
+    type: ai
+    prompt: |
+      Continuing our architectural discussion, now focus on performance aspects.
+      Consider the architectural patterns we identified and analyze:
+
+      1. Performance bottlenecks
+      2. Scalability concerns
+      3. Resource usage efficiency
+      4. Optimization opportunities
+    on:
+      - pr_opened
+    depends_on:
+      - architecture-review
+    reuse_ai_session: true
+
+  recommendations-summary:
+    type: ai
+    prompt: |
+      Based on our complete analysis covering architecture and performance,
+      provide a prioritized summary of recommendations with:
+
+      1. Critical issues requiring immediate attention
+      2. Medium-term improvements
+      3. Long-term architectural considerations
+      4. Implementation roadmap
+    on:
+      - pr_opened
+    depends_on:
+      - performance-analysis
+    reuse_ai_session: true
+
+# Example 3: Mixed session reuse and independent checks
+  code-style:
+    type: ai
+    prompt: |
+      Review code style, formatting, and maintainability concerns.
+      Focus on readability, naming conventions, and code organization.
+    on:
+      - pr_opened
+    ai:
+      provider: openai
+      model: gpt-4
+
+  documentation-review:
+    type: ai
+    prompt: |
+      Review documentation quality including:
+      - Code comments
+      - README updates
+      - API documentation
+      - Inline documentation
+    on:
+      - pr_opened
+    # This runs independently - no session reuse
+
+  comprehensive-summary:
+    type: ai
+    prompt: |
+      Create a comprehensive summary combining insights from all previous analyses.
+      Provide an executive summary with key findings and recommendations.
+    on:
+      - pr_opened
+    depends_on:
+      - security-remediation
+      - recommendations-summary
+      - code-style
+      - documentation-review
+    reuse_ai_session: true  # Reuses session from security-remediation (first dependency)
+
+# Output configuration
+output:
+  pr_comment:
+    format: markdown
+    group_by: check
+    collapse: true
+    debug:
+      enabled: true
+      includePrompts: false
+      includeRawResponses: false
+      includeTiming: true
+      includeProviderInfo: true
+
+# Execution settings
+max_parallelism: 3  # Session reuse checks will still run sequentially when needed
+fail_fast: false
+
+# Notes:
+# 1. reuse_ai_session: true REQUIRES depends_on to be specified
+# 2. Checks with session reuse will force sequential execution within their dependency chain
+# 3. Session IDs are automatically managed and cleaned up after execution
+# 4. Sessions maintain conversation context, allowing for more sophisticated analysis
+# 5. Mix session reuse with independent checks for optimal performance and context