Samples — runnable copy of the harness

docs / samples / README

← all docs

Samples — runnable copy of the harness

This folder holds a working copy of the public repository, used as the reference implementation for the process document and runbooks in ../docs/process/.

samples/
└── visa-vulnerability-agentic-harness/   ← full source tree (commit 3d972f67)

Source: visa/visa-vulnerability-agentic-harness (Apache-2.0). Cloned as-is, minus build/run artifacts (.git/, graphify-out/, .codegraph/, security-scan/, security-remediation/, batch-workspace/, __pycache__/).

Why it's here: every command in the process document and runbooks is written to be run from inside this folder against a target codebase — having the real vvaharness/, docs/, inputs/*.example.*, and vvaharness/config/profiles/*.yaml on disk means the commands can be copy-pasted and actually work, instead of being abstract instructions.

Quick orientation

Path What it is
vvaharness/cli.py Entry point — dispatches setup / doctor / estimate / gc / scan / remediate / validate.
vvaharness/config/profiles/*.yaml The four shipped profiles (default, sdk, full, taint).
inputs/*.example.* Templates for known_cves.json, design_controls.yaml, cmdb.csv, remediation_policy.yaml, remediation_playbook.yaml, validator_hints.yaml.
docs/ The harness's own upstream docs (USER_GUIDE.md, SETUP_GUIDE.md, configuration.md, remediation.md, validation.md).

Installing it locally (once, before running any runbook)

cd samples/visa-vulnerability-agentic-harness
python3 -m venv .venv && source .venv/bin/activate
pip install -e .                      # base install (cli backend)
pip install -e ".[sdk,validation]"    # add SDK backend + s11 validation extra, as needed
cp .env.example .env                  # fill in credentials — see setup-and-credentials.md

See ../docs/process/runbooks/setup-and-credentials.md for the full, verified procedure.

Refreshing this copy

cd samples
rm -rf visa-vulnerability-agentic-harness
git clone https://github.com/visa/visa-vulnerability-agentic-harness.git visa-vulnerability-agentic-harness
rm -rf visa-vulnerability-agentic-harness/.git

Re-run the graph tools afterwards if you want updated diagrams (see ../tool-outputs/README.md).