Expand description
Centralized constants for the Ralph CLI.
This module consolidates all magic numbers, limits, and default values to improve maintainability and prevent drift between duplicated values.
Responsibilities:
- Provide a single source of truth for compile-time constants.
- Organize constants by domain (buffers, limits, timeouts, UI, etc.).
- Prevent accidental drift between duplicated constant definitions.
Not handled here:
- Runtime configuration values (see
crate::config). - User-customizable thresholds (see
crate::contracts::Config).
Invariants/assumptions:
- All constants are
pubwithin their submodule; visibility is controlled by module exports. - Constants that appear in multiple places must be defined here and imported elsewhere.
Modulesยง
- agents_
md - AGENTS.md section requirements.
- buffers
- Buffer size limits for output handling and memory management.
- custom_
fields - Custom field keys for analytics/observability data.
- defaults
- Default values for models and configuration.
- error_
messages - Error message templates for consistent error formatting.
- git
- Git-related constants.
- limits
- Operational limits and thresholds.
- milestones
- Milestone and achievement thresholds.
- paths
- File paths and directory names.
- queue
- Queue configuration constants.
- runner
- Runner-related constants.
- spinners
- Spinner animation frames.
- status_
keywords - Status classification keywords for theme/styling.
- symbols
- UI symbols and emoji.
- timeouts
- Timeout and interval durations.
- ui
- UI layout and dimension constants.
- versions
- Version constants for schemas and templates.