validation-operations

name: validation-operations description: Validate 3Lens contracts and run regression tests. Use when checking contract compliance, validating attribution coverage, or running CI validation checks.

Validation Operations

Validation operations ensure code changes comply with 3Lens contracts and don't introduce regressions.

When to Use

• Before submitting a PR
• Running CI checks
• Validating attribution coverage
• Ensuring contract compliance

Commands

Validate Specific Contract

# Validate Inspector contract
3lens validate inspector

# Validate Capture contract
3lens validate capture

# Validate Entity Graph contract
3lens validate entity-graph

# Validate Attribution contract
3lens validate attribution

# Validate Fidelity contract
3lens validate fidelity

# Validate Overhead contract
3lens validate overhead

Validate All Contracts

# Run all contract validations
3lens validate all

# Verbose output
3lens validate all --verbose

Validate Attribution Coverage

# Ensure all metrics have culprit paths
3lens validate attribution

Fails if any metrics exist without a clickable path to culprit entities.

Available Contracts

CI Integration

Add validation to your CI workflow:

# .github/workflows/ci.yml
- name: Validate Contracts
  run: pnpm 3lens validate all

Validation Output

{
  contract: string,
  passed: boolean,
  checks: {
    name: string,
    passed: boolean,
    message?: string
  }[],
  summary: {
    total: number,
    passed: number,
    failed: number
  }
}

Agent Use Cases

1. Pre-PR check: "Validate all contracts before I submit this PR"
2. Specific contract: "Check if my changes comply with the attribution contract"
3. CI setup: "Add contract validation to the CI workflow"
4. Coverage check: "Ensure all metrics have attribution paths"

Contract Locations

Contracts are defined in .cursor/contracts/:

• inspector.md - Inspector contract
• capture.md - Capture contract
• entity-graph.md - Entity graph contract
• attribution.md - Attribution contract
• fidelity.md - Fidelity contract
• overhead.md - Overhead contract
• shader-graph.md - Shader graph contract

Additional Resources

• For detailed command syntax, see .cursor/commands/
• For PR checklist, see .cursor/agents/code-reviewer.md (PR Checklist section)
• Command: validate-contracts
• Agent: code-reviewer
• Agent: test-generator
• Playbook: write-tests
• Skill: testing-operations