Develop and contribute to the PinchTab project. Use when working on PinchTab source code, adding features, fixing bugs, running tests, or preparing PRs. Triggers on "work on pinchtab", "pinchtab development", "contribute to pinchtab", "fix pinchtab bug", "add pinchtab feature".

2026-03-227

pinchtab

lizi-Margin/bvr_sim

Use this skill when a task needs browser automation through PinchTab: open a website, inspect interactive elements, click through flows, fill out forms, scrape page text, log into sites with a persistent profile, export screenshots or PDFs, manage multiple browser instances, or fall back to the HTTP API when the CLI is unavailable. Prefer this skill for token-efficient browser work driven by stable accessibility refs such as `e5` and `e12`.

2026-03-227

name	test
description	Run unified test suite for BVR Sim. One-click testing with automatic build and validation.

BVR Sim Test Suite

Run comprehensive tests automatically from the project root.

Quick Start

Command	Description
`python run_tests.py`	Run full test suite (build + all tests)

What Gets Run

The unified test suite (run_tests.py) does:

Build C++ components (Windows: build_windows.bat, Linux: build_linux.sh)
Import local bvr_sim package directly (no pip install)
C++ unit tests - Low-level C++ functionality
C3Utils unit tests - C3Utils library tests
C++ core tests - C++ backend validation
Python core tests - Python backend validation

Benefits

Faster test runs - No pip install overhead, direct import of local changes
Instant feedback - Test local modifications immediately after build
Simple workflow - Single command from project root

Requirements

Windows: MSVC build tools
Linux: GCC or Clang
Python 3.8+

Usage

# From project root, run all tests
python run_tests.py

Troubleshooting

Use linux bash param style (-d), rather than dos style (/d).

Incorrect:

cd /d G:/bvr_sim && python run_tests.py  # Wrong - bash error cd: too many arguments

Correct (relative path):

python run_tests.py  # Right - works anywhere

Common Issues

Build fails: Check compiler is installed and in PATH
Import errors: Ensure build_windows.bat completed successfully (looks for bvr_sim_cpp.pyd in bvr_sim/)
C++ tests fail: Verify Eigen and pybind11 were downloaded during build