zeroclaw/docs/contributing
Simian Astronaut 7 d0781f31a5 test: restructure test suite into five-level taxonomy
Reorganize the flat tests/ directory into a structured taxonomy:
- component/ (174 tests): single-subsystem tests
- integration/ (65 tests): multi-component wiring tests
- system/ (5 tests): full-stack with real SQLite memory
- live/ (5 tests, #[ignore]): real external API tests
- manual/: shell/Python scripts for human-driven testing
- support/: shared mock infrastructure (MockProvider, EchoTool, etc.)
- fixtures/: JSON trace fixtures for declarative LLM replay

Deduplicates ~180 lines of identical mock code from agent_e2e.rs and
agent_loop_robustness.rs into shared support modules. Adds new component
tests for gateway (HMAC signature verification) and security (config
defaults, TOML round-trips). Adds system-level tests exercising the
full agent turn cycle with real SQLite memory.

Updates Cargo.toml with [[test]] entries, dev/ci.sh with level-specific
commands, and docs/contributing/testing.md with a comprehensive testing
guide.

Zero impact on src/.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-11 11:03:33 -04:00
..
actions-source-policy.md ci(workflows): rename workflow files and add lint + security jobs 2026-03-10 00:17:54 -04:00
adding-boards-and-tools.md docs: update all internal links to match topic-based directory layout 2026-03-09 23:09:09 -04:00
cargo-slicer-speedup.md docs: update all internal links to match topic-based directory layout 2026-03-09 23:09:09 -04:00
change-playbooks.md docs: add extension examples and update references in contributing materials 2026-03-10 15:11:28 -04:00
ci-map.md test: restructure test suite into five-level taxonomy 2026-03-11 11:03:33 -04:00
cla.md docs: update all internal links to match topic-based directory layout 2026-03-09 23:09:09 -04:00
custom-providers.md docs: restructure docs/ into topic-based directory layout 2026-03-09 22:25:20 -04:00
doc-template.md docs: restructure docs/ into topic-based directory layout 2026-03-09 22:25:20 -04:00
docs-contract.md refactor: Agents file done according to best practices (slim, light, project specific, avoids things the models already know) 2026-03-09 23:16:48 -04:00
extension-examples.md docs: add extension examples and update references in contributing materials 2026-03-10 15:11:28 -04:00
langgraph-integration.md docs: restructure docs/ into topic-based directory layout 2026-03-09 22:25:20 -04:00
pr-discipline.md refactor: Agents file done according to best practices (slim, light, project specific, avoids things the models already know) 2026-03-09 23:16:48 -04:00
pr-workflow.md fix(docs): correct broken path references in contributing docs 2026-03-11 03:31:14 -04:00
README.md test: restructure test suite into five-level taxonomy 2026-03-11 11:03:33 -04:00
release-process.md docs: restructure docs/ into topic-based directory layout 2026-03-09 22:25:20 -04:00
reviewer-playbook.md fix(docs): correct broken path references in contributing docs 2026-03-11 03:31:14 -04:00
testing-telegram.md test: restructure test suite into five-level taxonomy 2026-03-11 11:03:33 -04:00
testing.md test: restructure test suite into five-level taxonomy 2026-03-11 11:03:33 -04:00

Contributing, Review, and CI Docs

For contributors, reviewers, and maintainers.

Core Policies

Suggested Reading Order

  1. CONTRIBUTING.md
  2. pr-workflow.md
  3. reviewer-playbook.md
  4. ci-map.md