@probelabs/visor 0.1.106 → 0.1.111

package/dist/event-bus/types.d.ts

@@ -0,0 +1,71 @@
+export type IntegrationEvent = {
+    type: 'CheckStatusRequested';
+    checkId?: string;
+    checkName: string;
+    status: 'queued' | 'in_progress' | 'completed' | 'cancelled';
+    conclusion?: 'success' | 'failure' | 'neutral' | 'skipped';
+    output?: {
+        title?: string;
+        summary?: string;
+        text?: string;
+        annotations?: any[];
+    };
+    idempotencyKey?: string;
+} | {
+    type: 'CommentRequested';
+    body: string;
+    threadKey?: string;
+    commentId?: string;
+    idempotencyKey?: string;
+} | {
+    type: 'CheckStatusCompleted';
+    checkId?: string;
+    success: boolean;
+    error?: {
+        message: string;
+        stack?: string;
+        name?: string;
+    };
+} | {
+    type: 'HumanInputRequested';
+    checkId: string;
+    prompt: string;
+    channel?: string;
+    threadTs?: string;
+    threadKey?: string;
+} | {
+    type: 'SnapshotSaved';
+    checkId: string;
+    channel?: string;
+    threadTs?: string;
+    threadKey?: string;
+    filePath: string;
+} | {
+    type: 'CommentPosted';
+    threadKey?: string;
+    commentId: string;
+    success: boolean;
+    error?: {
+        message: string;
+        stack?: string;
+        name?: string;
+    };
+};
+export interface EventEnvelope<T = any> {
+    id: string;
+    version: 1;
+    timestamp: string;
+    runId: string;
+    workflowId?: string;
+    caseId?: string;
+    wave?: number;
+    attempt?: number;
+    checkId?: string;
+    traceId?: string;
+    spanId?: string;
+    causationId?: string;
+    correlationId?: string;
+    payload: T;
+}
+export type AnyEvent = any;
+//# sourceMappingURL=types.d.ts.map

package/dist/event-bus/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["file:///home/runner/work/visor/visor/src/event-bus/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GACxB;IACE,IAAI,EAAE,sBAAsB,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,QAAQ,GAAG,aAAa,GAAG,WAAW,GAAG,WAAW,CAAC;IAC7D,UAAU,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IAC3D,MAAM,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,GAAG,EAAE,CAAA;KAAE,CAAC;IAClF,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GACD;IACE,IAAI,EAAE,kBAAkB,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GACD;IACE,IAAI,EAAE,sBAAsB,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5D,GACD;IACE,IAAI,EAAE,qBAAqB,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IAEf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GACD;IACE,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB,GACD;IACE,IAAI,EAAE,eAAe,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5D,CAAC;AAEN,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,GAAG;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,CAAC,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAElB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,CAAC,CAAC;CACZ;AAED,MAAM,MAAM,QAAQ,GAAG,GAAG,CAAC"}

package/dist/examples/.claude/agents/code-reviewer.md

@@ -0,0 +1,69 @@
+# Code Reviewer Subagent
+
+You are a specialized code review subagent for Visor. Your role is to perform deep, comprehensive code reviews with a focus on:
+
+## Primary Responsibilities
+
+1. **Security Analysis**
+   - Identify potential security vulnerabilities
+   - Check for proper input validation
+   - Review authentication and authorization logic
+   - Detect sensitive data exposure risks
+
+2. **Performance Review**
+   - Identify performance bottlenecks
+   - Suggest algorithmic improvements
+   - Review database query efficiency
+   - Check for memory leaks
+
+3. **Code Quality**
+   - Assess code readability and maintainability
+   - Check naming conventions
+   - Review documentation completeness
+   - Identify code duplication
+
+4. **Architecture Assessment**
+   - Evaluate design patterns usage
+   - Check for proper separation of concerns
+   - Review module boundaries
+   - Assess coupling and cohesion
+
+## Review Process
+
+When reviewing code:
+
+1. Start with a high-level overview of the changes
+2. Identify the most critical issues first
+3. Provide specific, actionable feedback
+4. Include code examples for suggested improvements
+5. Reference best practices and industry standards
+
+## Output Format
+
+Structure your review as:
+
+```
+## Overview
+Brief summary of the changes
+
+## Critical Issues
+- Issue 1: [Description and fix]
+- Issue 2: [Description and fix]
+
+## Improvements
+- Suggestion 1: [Description]
+- Suggestion 2: [Description]
+
+## Positive Aspects
+- What was done well
+```
+
+## Tools Available
+
+You have access to:
+- `Grep`: Search for patterns in code
+- `Read`: Read file contents
+- `WebSearch`: Search for best practices
+- MCP tools for specialized analysis
+
+Use these tools effectively to provide thorough, evidence-based reviews.

package/dist/examples/.mcp.json

@@ -0,0 +1,34 @@
+{
+  "mcpServers": {
+    "code_analyzer": {
+      "command": "python3",
+      "args": ["./mcp/analyzer.py"],
+      "env": {
+        "ANALYSIS_LEVEL": "comprehensive"
+      }
+    },
+    "security_scanner": {
+      "command": "node",
+      "args": ["./mcp/security.js"],
+      "env": {
+        "SCAN_DEPTH": "full",
+        "INCLUDE_DEPENDENCIES": "true"
+      }
+    },
+    "performance_profiler": {
+      "command": "node",
+      "args": ["./tools/performance-analyzer.js"],
+      "env": {
+        "PROFILE_MODE": "detailed",
+        "OUTPUT_FORMAT": "json"
+      }
+    },
+    "dependency_checker": {
+      "command": "npx",
+      "args": ["npm-check", "--json"],
+      "env": {
+        "CHECK_UNUSED": "true"
+      }
+    }
+  }
+}

package/dist/examples/CALCULATOR-SDK.md

@@ -0,0 +1,364 @@
+# Calculator SDK Example - Quick Reference
+
+## Overview
+
+`calculator-sdk-real.ts` is a complete, runnable example showing how to use Visor SDK programmatically with the human-input provider.
+
+## Features
+
+✅ **Real SDK Usage** - Actual imports and execution, not mocked
+✅ **Inline Configuration** - No YAML files needed
+✅ **Custom Input Hook** - Shows how to implement your own input handler
+✅ **Complete Workflow** - 8 checks with dependencies, memory, and JavaScript
+✅ **Error Handling** - Validation and error recovery
+✅ **Two Modes** - Interactive (manual input) and automated (for testing)
+
+## Quick Start
+
+### Interactive Mode
+
+```bash
+# Build the project first
+npm run build
+
+# Run the example
+ts-node examples/calculator-sdk-real.ts
+```
+
+You'll be prompted for:
+1. First number (e.g., 42)
+2. Second number (e.g., 7)
+3. Operation (+, -, *, /)
+
+### Automated Mode (Testing)
+
+```bash
+# Provide inputs as arguments: <num1> <num2> <operation>
+ts-node examples/calculator-sdk-real.ts 42 7 +
+
+# Examples:
+ts-node examples/calculator-sdk-real.ts 100 25 -
+ts-node examples/calculator-sdk-real.ts 6 7 "*"
+ts-node examples/calculator-sdk-real.ts 81 9 /
+```
+
+## Code Structure
+
+### 1. Configuration (Inline)
+
+```typescript
+const calculatorConfig: VisorConfig = {
+  version: "1.0",
+  memory: {
+    storage: 'memory',
+    namespace: 'calculator'
+  },
+  checks: {
+    "get-number1": { type: "human-input", prompt: "Enter the first number:" },
+    "store-number1": { type: "memory", operation: "set", key: "number1", ... },
+    "get-number2": { type: "human-input", prompt: "Enter the second number:" },
+    "store-number2": { type: "memory", operation: "set", key: "number2", ... },
+    "get-operation": { type: "human-input", prompt: "Select operation:" },
+    "store-operation": { type: "memory", operation: "set", key: "operation", ... },
+    "calculate": { type: "script", content: "..." },
+    "show-result": { type: "log", message: "..." }
+  },
+  output: { pr_comment: { format: "markdown", group_by: "check", collapse: false } }
+};
+```
+
+### 2. Custom Hook Implementation
+
+```typescript
+async function customHumanInputHandler(request: HumanInputRequest): Promise<string> {
+  return new Promise((resolve, reject) => {
+    const rl = readline.createInterface({
+      input: process.stdin,
+      output: process.stdout
+    });
+
+    // Display prompt
+    console.log(`💬 ${request.prompt}`);
+
+    rl.question('> ', (answer) => {
+      rl.close();
+      const trimmed = answer.trim();
+
+      if (!trimmed && !request.allowEmpty) {
+        reject(new Error('Empty input not allowed'));
+      } else {
+        resolve(trimmed || request.default || '');
+      }
+    });
+  });
+}
+```
+
+### 3. SDK Execution
+
+```typescript
+async function main() {
+  // 1. Set up the hook
+  HumanInputCheckProvider.setHooks({
+    onHumanInput: customHumanInputHandler
+  });
+
+  // 2. Create execution engine
+  const engine = new CheckExecutionEngine();
+
+  // 3. Execute checks
+  const result = await engine.executeChecks({
+    checks: Object.keys(calculatorConfig.checks || {}),
+    config: calculatorConfig,
+    outputFormat: 'table',
+    maxParallelism: 1, // Run sequentially for human input
+    debug: false
+  });
+
+  // 4. Process results
+  console.log('✅ Workflow completed!');
+  console.log(`Execution time: ${result.executionTime}ms`);
+
+  // 5. Access memory store for final values
+  const { MemoryStore } = await import('../src/memory-store');
+  const memoryStore = MemoryStore.getInstance(calculatorConfig.memory);
+  const keys = memoryStore.list('calculator');
+  for (const key of keys) {
+    console.log(`${key}: ${memoryStore.get(key, 'calculator')}`);
+  }
+}
+```
+
+## Workflow Diagram
+
+```
+┌─────────────────┐
+│  get-number1    │ ← User inputs: 42
+│  (human-input)  │
+└────────┬────────┘
+         │
+         ▼
+┌─────────────────┐
+│ store-number1   │ ← Stores parseFloat(42) in memory
+│   (memory)      │
+└────────┬────────┘
+         │
+         ▼
+┌─────────────────┐
+│  get-number2    │ ← User inputs: 7
+│  (human-input)  │
+└────────┬────────┘
+         │
+         ▼
+┌─────────────────┐
+│ store-number2   │ ← Stores parseFloat(7) in memory
+│   (memory)      │
+└────────┬────────┘
+         │
+         ▼
+┌─────────────────┐
+│ get-operation   │ ← User inputs: +
+│  (human-input)  │
+└────────┬────────┘
+         │
+         ▼
+┌─────────────────┐
+│ store-operation │ ← Stores "+" in memory, validates
+│   (memory)      │
+└────────┬────────┘
+         │
+         ▼
+┌─────────────────┐
+│   calculate     │ ← JavaScript: 42 + 7 = 49
+│   (memory)      │    Stores result in memory
+└────────┬────────┘
+         │
+         ▼
+┌─────────────────┐
+│  show-result    │ ← Displays formatted output
+│     (log)       │
+└─────────────────┘
+```
+
+## Key Concepts Demonstrated
+
+### 1. Human Input Integration
+- Custom hook implementation
+- Prompt customization
+- Input validation
+- Error handling
+
+### 2. Memory Provider
+- Storing values between checks
+- Namespace isolation
+- JavaScript value transformation (`value_js`)
+- Script provider (`type: script`)
+
+### 3. Dependency Management
+- Sequential workflow with `depends_on`
+- Output passing between checks
+- Memory access in JavaScript
+
+### 4. Error Handling
+- Input validation with `fail_if`
+- Division by zero protection
+- Invalid operation detection
+- Timeout handling
+
+## Customization Examples
+
+### Change Input Method
+
+Replace readline with any input source:
+
+```typescript
+// Slack bot
+async function slackInputHandler(request: HumanInputRequest): Promise<string> {
+  const response = await slack.askUser(request.checkId, request.prompt);
+  return response.text;
+}
+
+// Web API
+async function apiInputHandler(request: HumanInputRequest): Promise<string> {
+  const response = await fetch('/api/input', {
+    method: 'POST',
+    body: JSON.stringify(request)
+  });
+  return (await response.json()).value;
+}
+
+// GUI Dialog
+async function guiInputHandler(request: HumanInputRequest): Promise<string> {
+  return await electron.dialog.showInputBox({
+    title: request.checkId,
+    message: request.prompt
+  });
+}
+```
+
+### Add More Operations
+
+Extend the calculator in the `calculate` step:
+
+```typescript
+content: `
+  const num1 = memory.get('number1', 'calculator');
+  const num2 = memory.get('number2', 'calculator');
+  const op = memory.get('operation', 'calculator');
+
+  let result;
+  switch(op) {
+    case '+': result = num1 + num2; break;
+    case '-': result = num1 - num2; break;
+    case '*': result = num1 * num2; break;
+    case '/':
+      if (num2 === 0) throw new Error('Division by zero');
+      result = num1 / num2;
+      break;
+    case '**': result = Math.pow(num1, num2); break;  // Power
+    case '%': result = num1 % num2; break;             // Modulo
+    case 'sqrt': result = Math.sqrt(num1); break;     // Square root
+    default: throw new Error('Invalid operation');
+  }
+
+  memory.set('result', result, 'calculator');
+  return result;
+`
+```
+
+### Add Input History
+
+Store previous calculations:
+
+```typescript
+checks: {
+  // ... existing checks ...
+
+  "save-to-history": {
+    type: "memory",
+    depends_on: ["calculate"],
+    operation: "append",
+    namespace: "calculator",
+    key: "history",
+    value_js: `{
+      num1: memory.get('number1', 'calculator'),
+      num2: memory.get('number2', 'calculator'),
+      operation: memory.get('operation', 'calculator'),
+      result: memory.get('result', 'calculator'),
+      timestamp: new Date().toISOString()
+    }`
+  },
+
+  "show-history": {
+    type: "log",
+    depends_on: ["save-to-history"],
+    message: "Previous calculations: {{ memory.get('history', 'calculator') | json }}"
+  }
+}
+```
+
+## Real-World Use Cases
+
+This pattern can be adapted for:
+
+1. **Approval Workflows**
+   - Deployment approvals
+   - Code review confirmations
+   - Release gate checks
+
+2. **Interactive Debugging**
+   - Runtime parameter input
+   - Configuration selection
+   - Environment validation
+
+3. **Data Collection**
+   - User feedback gathering
+   - Bug report details
+   - Configuration wizards
+
+4. **Quality Gates**
+   - Manual test verification
+   - Performance sign-off
+   - Security review approval
+
+## Tips
+
+1. **Always validate input** - Use `fail_if` or JavaScript validation
+2. **Provide defaults** - For optional inputs or timeouts
+3. **Use memory** - For complex workflows with multiple steps
+4. **Handle errors** - Try/catch in JavaScript, validation in checks
+5. **Test automated mode** - Use predefined inputs for CI/CD testing
+
+## Troubleshooting
+
+### "Empty input not allowed"
+- Check `allow_empty: true` in config
+- Provide a `default` value
+- Ensure your hook doesn't return empty strings
+
+### "Division by zero"
+- The example includes validation for this
+- Add similar checks for your operations
+
+### "Invalid operation"
+- Check the `fail_if` validation in `store-operation`
+- Ensure allowed operations match your JavaScript switch
+
+### Hook not being called
+- Verify `HumanInputCheckProvider.setHooks()` is called before `engine.executeChecks()`
+- Check that check type is `"human-input"`
+- Ensure the hook returns a Promise<string>
+
+## Next Steps
+
+- Modify the calculator for your use case
+- Implement a custom input handler (Slack, GUI, etc.)
+- Add more complex workflows with branching
+- Integrate with your existing tools and services
+
+## See Also
+
+- `examples/calculator-config.yaml` - YAML version for CLI usage
+- `examples/human-input-example.yaml` - Basic human-input patterns
+- `docs/human-input-feature-plan.md` - Complete feature specification
+- `docs/human-input-implementation-summary.md` - Implementation details