File Layout
Boundline relies on specific directories and files to manage the AI session lifecycle and store configuration safely. By default, these files are kept inside the .boundline directory at the root of your workspace.
Core Directories
.boundline/: The root directory for Boundline's local state and configuration. It is recommended to add.boundline/tracesand.boundline/session.jsonto.gitignore..boundline/traces/: Stores trace files generated during execution, tracking all operations, validations, and decisions made..boundline/checkpoints/: Holds rollback manifests and state copies created before mutative operations, allowing seamless recovery in case of failure.
Configuration & State Files
.boundline/session.json: The active session state file. Boundline maintains context and pointers for the ongoing delivery iteration here..boundline/config.toml: Workspace configuration. Contains overriding rules for guardians, guidance configurations, and routing settings.