{
"item_type": "subsection",
"chapter_id": "configuration",
"subsection_id": "default-values-reference",
"subsection_title": "Default Values Reference",
"subsection_file": "book/src/configuration/default-values-reference.md",
"feature_mappings": [],
"drift_detected": true,
"severity": "medium",
"quality_assessment": "Documentation provides comprehensive default value tables but contains several inaccuracies compared to implementation. Memory storage default is incorrect (documented 100MB vs actual 1GB), and some documented defaults don't exist in the codebase (plugins, max_concurrent_specs, workflow defaults). Tables are well-organized but need accuracy fixes.",
"issues": [
{
"type": "incorrect_information",
"severity": "medium",
"section": "Memory Storage Defaults",
"description": "Memory storage max_memory default value is incorrect",
"current_content": "`max_memory` | `104857600` (100MB)",
"should_be": "`max_memory` | `1073741824` (1GB)",
"fix_suggestion": "Update memory storage default to match implementation in src/storage/config.rs:201",
"source_reference": "src/storage/config.rs:200-202"
},
{
"type": "missing_content",
"severity": "low",
"section": "Global Configuration Defaults",
"description": "Several documented global config defaults don't exist in implementation",
"current_content": "Documents plugins.enabled, plugins.directory, plugins.auto_load, max_concurrent_specs",
"should_be": "These fields exist in GlobalConfig struct but have no defaults or usage in implementation",
"fix_suggestion": "Add note that plugin system and max_concurrent_specs are legacy/placeholder features not currently used",
"source_reference": "src/config/mod.rs:50-59, 88-99"
},
{
"type": "missing_content",
"severity": "low",
"section": "Workflow Defaults",
"description": "Documented workflow defaults (max_iterations, timeout, continue_on_error) don't have corresponding implementation defaults",
"current_content": "Documents max_iterations: None, timeout: None, continue_on_error: false",
"should_be": "These are workflow fields but no default values are set in WorkflowConfig implementation",
"fix_suggestion": "Clarify that these are workflow configuration options without built-in defaults, or verify against actual WorkflowConfig defaults",
"source_reference": "src/config/workflow.rs"
},
{
"type": "outdated_information",
"severity": "low",
"section": "Command Metadata Defaults",
"description": "Command timeout default documented as 300 seconds, which is correct for command defaults but may be misleading",
"current_content": "`timeout` | `300` | Command timeout (seconds)",
"should_be": "This is the default applied by CommandRegistry, not a global default",
"fix_suggestion": "Add clarification that this is the default applied by command validator when command metadata doesn't specify timeout",
"source_reference": "src/config/command_validator.rs:477-479"
}
],
"positive_aspects": [
"Well-organized table format makes defaults easy to reference",
"Comprehensive coverage of storage, retry, and cache configuration defaults",
"Clear precedence flow example showing configuration override hierarchy",
"Good cross-references to related configuration documentation",
"All internal links are valid and point to existing files",
"Storage configuration defaults accurately documented (except memory max_memory)",
"Retry policy defaults correctly documented (max_retries: 3, initial_delay: 1s, etc.)",
"Cache configuration defaults correctly documented (max_entries: 1000, ttl: 3600s)",
"Environment variable mappings accurately reflect implementation"
],
"improvement_suggestions": [
"Add a note distinguishing between 'implemented and used defaults' vs 'legacy/placeholder fields'",
"Consider adding examples showing how to override defaults via config files",
"Add cross-reference to workflow configuration documentation for workflow-specific defaults",
"Consider adding a 'Default Values by Component' section to group related defaults",
"Add note about platform-specific paths for prodigy_home (uses ProjectDirs)",
"Clarify difference between storage backend defaults vs file storage implementation defaults"
],
"cross_references": [
"environment-variables",
"configuration-precedence-rules",
"global-configuration-structure",
"project-configuration-structure",
"storage-configuration"
],
"metadata": {
"analyzed_at": "2025-01-11T11:42:00Z",
"feature_inventory": ".prodigy/book-analysis/features.json",
"topics_covered": [
"Default Values Reference",
"Global Configuration Defaults",
"Project Configuration Defaults",
"Storage Configuration Defaults",
"File Storage Defaults",
"Memory Storage Defaults",
"Retry Policy Defaults",
"Cache Configuration Defaults",
"Environment Variable Defaults",
"Workflow Defaults",
"Command Metadata Defaults"
],
"validation_focus": "Check default values reference documentation matches implementation"
}
}