Highlights

• Domain primitives spanning packages, repositories, services, users, filesystems, storage, networking, and firewalls.

• Extended coverage for kernel parameters, logs, scheduled tasks, security compliance, containers, boot configuration, Cockpit, Insights, and subscriptions.

• Mutations routed through ICommandRunner and IFileOperator with uniform dry-run, auditing, and mocking.

• Local- and SSH-runner architecture for reaching hosts directly or over SSH.

• Layered architecture model documented in userguide/architecture-layers.md.

Repository Structure

• development/ - Runtime environment scripts.

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

• source/packages/ - Package source code.

• source/testroots/testbase/ - TestBase test roots.

• specs/ - Feature specifications, each prefixed with its architecture-layer number.

• userguide/ - Standards, conventions, and architecture documentation.

Environment Setup

When working in a Codex container:

./development/setup-agent-container

For local development:

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

Running Tests

Activate the virtual environment:

source .venv/bin/activate

Run TestBase tests (when test roots are populated):

testbase testing run --root source/testroots/testbase --includes=ccai --output=./.output

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

• Architecture layers: userguide/architecture-layers.md (brief version: userguide/architecture-layers-brief.md)

• Command runner architecture: specs/1-command-runner-architecture/