Skip to content

CONTRIBUTING.md

Latest commit

 

History

History
19 lines (15 loc) · 804 Bytes

CONTRIBUTING.md

File metadata and controls

19 lines (15 loc) · 804 Bytes
Raw

Contributing

Contributions are welcome, especially minimal reproductions for missed destructive commands or avoidable false positives.

Before opening a pull request:

  1. Add or update a case in tests/cases/guard_cases.json for every policy change, false positive, or missed command.
  2. Run python3 -m unittest discover -s tests -v.
  3. Run both python3 scripts/validate_repo.py and python3 -O scripts/validate_repo.py.
  4. Test plugin discovery with the Codex CLI version pinned in CI.
  5. Optionally run python3 scripts/benchmark_guard.py.
  6. Do not include secrets, production endpoints, or destructive live tests.

Policy changes should prefer clear, reviewable regular expressions. Avoid network access, telemetry, opaque dependencies, and automatic execution of user-provided code.