Highlights

• Test discovery and filtering with include/exclude expressions and metadata support.

• Dependency injection with session/package/test lifecycles and centralized resource management.

• Structured execution sequencing with diagnostics and result recording.

• JSON result recording plus result browsing support.

• Click-based CLI for running and managing tests.

Repository Structure

• development/ - Runtime environment scripts.

• repository-setup/ - Repository homing and setup scripts.

• source/packages/ - Package source code.

• source/tests/ - unittest-based tests.

• source/testroots/ - TestBase framework self-tests (testroot).

• specs/ - Requirements, design, and task documentation.

• userguide/ - Standards, conventions, and documentation.

Environment Setup

When working in a Codex container, use the setup script below:

./development/setup-agent-container

For local development environments, run the repository homing and virtual environment setup scripts:

./repository-setup/rehome-repository
./development/setup-envrionment

Running Tests

Activate the virtual environment first:

source .venv/bin/activate

Run unittest tests:

python -m unittest discover -s source/tests -p "test_*.py"

Run TestBase tests:

testbase testing run --root "source/testroots" --include ccai

Standards and Conventions

• Naming conventions: userguide/10-02-naming-conventions.rst

• Code organization: userguide/10-01-code-organization.rst

• Coding standards: userguide/10-00-coding-standards.rst

Additional Resources

• User guide entry point: userguide/userguide.rst

• Design documentation: specs/design.md

• Requirements: specs/requirements.md