{
  "analysis_date": "2025-12-26T23:35:00Z",
  "project": "Debtmap",
  "chapters_analyzed": 32,
  "thresholds": {
    "size_threshold": 500,
    "section_threshold": 100
  },
  "summary": {
    "oversized_chapters": 13,
    "large_chapters": 6,
    "well_sized_chapters": 12,
    "multi_subsection_chapters": 1
  },
  "recommendations": [
    {
      "chapter_id": "troubleshooting",
      "chapter_title": "Troubleshooting",
      "current_file": "book/src/troubleshooting.md",
      "priority": "high",
      "issue": "oversized",
      "metrics": {
        "total_lines": 2553,
        "h2_sections": 17,
        "code_block_markers": 246,
        "code_block_ratio": 0.48
      },
      "recommended_action": "split_into_subsections",
      "proposed_structure": {
        "type": "multi-subsection",
        "index_file": "book/src/troubleshooting/index.md",
        "subsections": [
          {"id": "quick-fixes", "title": "Quick Fixes", "estimated_lines": 340, "source_sections": ["Quick Fixes for Common Issues", "Common Issues"]},
          {"id": "debug-mode", "title": "Debug Mode", "estimated_lines": 140, "source_sections": ["Debug Mode", "Performance Tips"]},
          {"id": "context-providers", "title": "Context Provider Issues", "estimated_lines": 280, "source_sections": ["Context Provider Troubleshooting"]},
          {"id": "advanced-analysis", "title": "Advanced Analysis Issues", "estimated_lines": 620, "source_sections": ["Advanced Analysis Troubleshooting"]},
          {"id": "error-messages", "title": "Error Messages Reference", "estimated_lines": 370, "source_sections": ["Error Messages Reference", "Language-Specific Issues"]},
          {"id": "output-issues", "title": "Output and Command Issues", "estimated_lines": 380, "source_sections": ["Output Formatting Issues", "Compare Command Issues", "Validate Command Issues", "Validate-Improvement Command Issues"]},
          {"id": "faq", "title": "FAQ", "estimated_lines": 420, "source_sections": ["FAQ", "When to File Bug Reports", "Troubleshooting Checklist"]}
        ]
      }
    },
    {
      "chapter_id": "scoring-strategies",
      "chapter_title": "Scoring Strategies",
      "current_file": "book/src/scoring-strategies.md",
      "priority": "high",
      "issue": "oversized",
      "metrics": {
        "total_lines": 1868,
        "h2_sections": 11,
        "code_block_markers": 198,
        "code_block_ratio": 0.53
      },
      "recommended_action": "split_into_subsections",
      "proposed_structure": {
        "type": "multi-subsection",
        "index_file": "book/src/scoring-strategies/index.md",
        "subsections": [
          {"id": "file-level-scoring", "title": "File-Level Scoring", "estimated_lines": 200, "source_sections": ["Overview", "File-Level Scoring"]},
          {"id": "function-level-scoring", "title": "Function-Level Scoring", "estimated_lines": 510, "source_sections": ["Function-Level Scoring"]},
          {"id": "comparison-guide", "title": "Comparison Guide", "estimated_lines": 190, "source_sections": ["When to Use Each Approach", "Comparison Examples", "Score Normalization", "Best Practices", "Troubleshooting"]},
          {"id": "rebalanced-scoring", "title": "Rebalanced Debt Scoring", "estimated_lines": 300, "source_sections": ["Rebalanced Debt Scoring (Spec 136)"]},
          {"id": "exponential-scaling", "title": "Exponential Scaling", "estimated_lines": 295, "source_sections": ["Score-Based Prioritization with Exponential Scaling (Spec 171)"]},
          {"id": "data-flow-scoring", "title": "Data Flow Scoring", "estimated_lines": 290, "source_sections": ["Data Flow Scoring (Spec 218)"]}
        ]
      }
    },
    {
      "chapter_id": "configuration",
      "chapter_title": "Configuration",
      "current_file": "book/src/configuration.md",
      "priority": "high",
      "issue": "oversized",
      "metrics": {
        "total_lines": 1489,
        "h2_sections": 15,
        "code_block_markers": 128,
        "code_block_ratio": 0.43
      },
      "recommended_action": "split_into_subsections",
      "proposed_structure": {
        "type": "multi-subsection",
        "index_file": "book/src/configuration/index.md",
        "subsections": [
          {"id": "basics", "title": "Configuration Basics", "estimated_lines": 200, "source_sections": ["Config Files", "Scoring Configuration"]},
          {"id": "thresholds", "title": "Threshold Configuration", "estimated_lines": 150, "source_sections": ["Thresholds Configuration", "Language Configuration"]},
          {"id": "exclusions", "title": "Exclusion Patterns", "estimated_lines": 100, "source_sections": ["Exclusion Patterns", "Display Configuration", "Output Configuration", "Normalization Configuration"]},
          {"id": "advanced", "title": "Advanced Configuration", "estimated_lines": 750, "source_sections": ["Advanced Configuration"]},
          {"id": "cli-integration", "title": "CLI Integration", "estimated_lines": 130, "source_sections": ["CLI Integration", "Configuration Validation"]},
          {"id": "examples", "title": "Configuration Examples", "estimated_lines": 160, "source_sections": ["Complete Configuration Example", "Configuration Best Practices", "Troubleshooting"]}
        ]
      }
    },
    {
      "chapter_id": "prodigy-integration",
      "chapter_title": "Prodigy Integration",
      "current_file": "book/src/prodigy-integration.md",
      "priority": "high",
      "issue": "oversized",
      "metrics": {
        "total_lines": 1460,
        "h2_sections": 17,
        "code_block_markers": 114,
        "code_block_ratio": 0.39
      },
      "recommended_action": "split_into_subsections",
      "proposed_structure": {
        "type": "multi-subsection",
        "index_file": "book/src/prodigy-integration/index.md",
        "subsections": [
          {"id": "overview", "title": "Overview", "estimated_lines": 180, "source_sections": ["Prerequisites Checklist", "What is Prodigy?", "Benefits", "Prerequisites"]},
          {"id": "quick-start", "title": "Quick Start", "estimated_lines": 190, "source_sections": ["Quick Start", "Useful Prodigy Commands"]},
          {"id": "workflow-configuration", "title": "Workflow Configuration", "estimated_lines": 250, "source_sections": ["Workflow Configuration", "Claude Slash Commands", "Target Selection"]},
          {"id": "mapreduce-workflows", "title": "MapReduce Workflows", "estimated_lines": 340, "source_sections": ["MapReduce Workflows", "Iteration Strategy"]},
          {"id": "validation", "title": "Validation and Metrics", "estimated_lines": 180, "source_sections": ["Validation", "Output and Metrics"]},
          {"id": "cicd-integration", "title": "CI/CD Integration", "estimated_lines": 140, "source_sections": ["Integration with CI/CD", "Best Practices"]},
          {"id": "troubleshooting", "title": "Troubleshooting", "estimated_lines": 300, "source_sections": ["Troubleshooting", "Example Workflows"]}
        ]
      }
    },
    {
      "chapter_id": "output-formats",
      "chapter_title": "Output Formats",
      "current_file": "book/src/output-formats.md",
      "priority": "high",
      "issue": "oversized",
      "metrics": {
        "total_lines": 1375,
        "h2_sections": 16,
        "code_block_markers": 102,
        "code_block_ratio": 0.37
      },
      "recommended_action": "split_into_subsections",
      "proposed_structure": {
        "type": "multi-subsection",
        "index_file": "book/src/output-formats/index.md",
        "subsections": [
          {"id": "terminal-output", "title": "Terminal Output", "estimated_lines": 300, "source_sections": ["Format Selection", "Terminal Output"]},
          {"id": "json-output", "title": "JSON Output", "estimated_lines": 260, "source_sections": ["JSON Output"]},
          {"id": "markdown-output", "title": "Markdown and Executive Summary", "estimated_lines": 240, "source_sections": ["Markdown Output", "Executive Summary", "Complexity Analysis", "Technical Debt", "Dependencies", "Recommendations"]},
          {"id": "data-flow-output", "title": "Data Flow Analysis", "estimated_lines": 250, "source_sections": ["Data Flow Analysis", "HTML Output"]},
          {"id": "tool-integration", "title": "Tool Integration", "estimated_lines": 350, "source_sections": ["Tool Integration", "Output Filtering"]},
          {"id": "best-practices", "title": "Best Practices", "estimated_lines": 110, "source_sections": ["Best Practices", "Troubleshooting"]}
        ]
      }
    },
    {
      "chapter_id": "examples",
      "chapter_title": "Examples",
      "current_file": "book/src/examples.md",
      "priority": "high",
      "issue": "oversized",
      "metrics": {
        "total_lines": 1342,
        "h2_sections": 12,
        "code_block_markers": 108,
        "code_block_ratio": 0.40
      },
      "recommended_action": "split_into_subsections",
      "proposed_structure": {
        "type": "multi-subsection",
        "index_file": "book/src/examples/index.md",
        "subsections": [
          {"id": "rust-projects", "title": "Rust Projects", "estimated_lines": 280, "source_sections": ["Overview", "Table of Contents", "Analyzing Rust Projects"]},
          {"id": "python-projects", "title": "Python Analysis", "estimated_lines": 135, "source_sections": ["Python Analysis", "JavaScript/TypeScript"]},
          {"id": "ci-integration", "title": "CI Integration", "estimated_lines": 300, "source_sections": ["CI Integration", "Output Formats"]},
          {"id": "advanced-usage", "title": "Advanced Usage", "estimated_lines": 420, "source_sections": ["Advanced Usage", "Configuration Examples"]},
          {"id": "compare-examples", "title": "Compare Examples", "estimated_lines": 200, "source_sections": ["Compare Command", "Tips and Best Practices"]}
        ]
      }
    },
    {
      "chapter_id": "parallel-processing",
      "chapter_title": "Parallel Processing",
      "current_file": "book/src/parallel-processing.md",
      "priority": "high",
      "issue": "oversized",
      "metrics": {
        "total_lines": 1262,
        "h2_sections": 17,
        "code_block_markers": 96,
        "code_block_ratio": 0.38
      },
      "recommended_action": "split_into_subsections",
      "proposed_structure": {
        "type": "multi-subsection",
        "index_file": "book/src/parallel-processing/index.md",
        "subsections": [
          {"id": "overview", "title": "Overview", "estimated_lines": 200, "source_sections": ["Overview", "Performance Characteristics", "CLI Flags for Parallelization"]},
          {"id": "rayon-iterators", "title": "Rayon Parallel Iterators", "estimated_lines": 280, "source_sections": ["Rayon Parallel Iterators", "DashMap for Lock-Free Concurrency"]},
          {"id": "call-graph", "title": "Parallel Call Graph", "estimated_lines": 260, "source_sections": ["Parallel Call Graph Statistics", "Cross-File Call Resolution", "Concurrent Merging"]},
          {"id": "coverage-optimization", "title": "Coverage Optimization", "estimated_lines": 230, "source_sections": ["Coverage Index Optimization", "Performance Tuning"]},
          {"id": "scaling-tuning", "title": "Scaling and Tuning", "estimated_lines": 180, "source_sections": ["Scaling Strategies", "Tuning Guidelines", "Profiling and Debugging"]},
          {"id": "troubleshooting", "title": "Troubleshooting", "estimated_lines": 140, "source_sections": ["Best Practices", "Troubleshooting", "Summary"]}
        ]
      }
    },
    {
      "chapter_id": "error-handling-analysis",
      "chapter_title": "Error Handling Analysis",
      "current_file": "book/src/error-handling-analysis.md",
      "priority": "high",
      "issue": "oversized",
      "metrics": {
        "total_lines": 1093,
        "h2_sections": 13,
        "code_block_markers": 82,
        "code_block_ratio": 0.38
      },
      "recommended_action": "split_into_subsections",
      "proposed_structure": {
        "type": "multi-subsection",
        "index_file": "book/src/error-handling-analysis/index.md",
        "subsections": [
          {"id": "overview", "title": "Overview", "estimated_lines": 150, "source_sections": ["Implementation Status", "Overview"]},
          {"id": "rust-patterns", "title": "Rust Error Handling", "estimated_lines": 290, "source_sections": ["Rust Error Handling Analysis"]},
          {"id": "python-patterns", "title": "Python Error Handling", "estimated_lines": 155, "source_sections": ["Python Error Handling Analysis (Planned)"]},
          {"id": "async-patterns", "title": "Async Error Handling", "estimated_lines": 200, "source_sections": ["Async Error Handling"]},
          {"id": "configuration", "title": "Configuration and Best Practices", "estimated_lines": 220, "source_sections": ["Severity Levels and Prioritization", "Configuration", "Detection Examples", "Suppression Patterns", "Best Practices"]},
          {"id": "improving-handling", "title": "Improving Error Handling", "estimated_lines": 160, "source_sections": ["Improving Rust Error Handling Based on Debtmap Reports", "Troubleshooting"]}
        ]
      }
    },
    {
      "chapter_id": "context-providers",
      "chapter_title": "Context Providers",
      "current_file": "book/src/context-providers.md",
      "priority": "high",
      "issue": "oversized",
      "metrics": {
        "total_lines": 1039,
        "h2_sections": 16,
        "code_block_markers": 78,
        "code_block_ratio": 0.38
      },
      "recommended_action": "split_into_subsections",
      "proposed_structure": {
        "type": "multi-subsection",
        "index_file": "book/src/context-providers/index.md",
        "subsections": [
          {"id": "overview", "title": "Overview", "estimated_lines": 120, "source_sections": ["Overview"]},
          {"id": "critical-path", "title": "Critical Path Provider", "estimated_lines": 180, "source_sections": ["Critical Path Provider", "Dependency Provider"]},
          {"id": "git-history", "title": "Git History Provider", "estimated_lines": 300, "source_sections": ["Git History Provider", "Enabling Context Providers", "Provider Weights"]},
          {"id": "scoring-impact", "title": "How Context Affects Scoring", "estimated_lines": 200, "source_sections": ["How Context Affects Scoring", "Context Details Structure", "Practical Examples"]},
          {"id": "configuration", "title": "Configuration", "estimated_lines": 160, "source_sections": ["Configuration", "Performance Considerations", "Troubleshooting"]},
          {"id": "advanced", "title": "Advanced Usage", "estimated_lines": 120, "source_sections": ["Advanced Usage", "Future Enhancements", "Best Practices", "Summary"]}
        ]
      }
    },
    {
      "chapter_id": "compare-analysis",
      "chapter_title": "Compare Analysis",
      "current_file": "book/src/compare-analysis.md",
      "priority": "high",
      "issue": "oversized",
      "metrics": {
        "total_lines": 992,
        "h2_sections": 17,
        "code_block_markers": 74,
        "code_block_ratio": 0.37
      },
      "recommended_action": "split_into_subsections",
      "proposed_structure": {
        "type": "multi-subsection",
        "index_file": "book/src/compare-analysis/index.md",
        "subsections": [
          {"id": "overview", "title": "Overview", "estimated_lines": 180, "source_sections": ["Implementation Status", "Overview", "Basic Usage", "Target Location Tracking"]},
          {"id": "problem-analysis", "title": "Problem Analysis", "estimated_lines": 200, "source_sections": ["Target Item", "Problem Analysis", "Proposed Solution", "Project Health Metrics"]},
          {"id": "regression-detection", "title": "Regression Detection", "estimated_lines": 200, "source_sections": ["Regression Detection", "Improvement Tracking", "Before/After Metrics"]},
          {"id": "output-formats", "title": "Output Formats", "estimated_lines": 180, "source_sections": ["Output Formats", "CI/CD Integration"]},
          {"id": "examples", "title": "Practical Examples", "estimated_lines": 280, "source_sections": ["Practical Examples", "Troubleshooting"]}
        ]
      }
    },
    {
      "chapter_id": "design-patterns",
      "chapter_title": "Design Pattern Detection",
      "current_file": "book/src/design-patterns.md",
      "priority": "high",
      "issue": "oversized",
      "metrics": {
        "total_lines": 962,
        "h2_sections": 12,
        "code_block_markers": 72,
        "code_block_ratio": 0.38
      },
      "recommended_action": "split_into_subsections",
      "proposed_structure": {
        "type": "multi-subsection",
        "index_file": "book/src/design-patterns/index.md",
        "subsections": [
          {"id": "overview", "title": "Overview", "estimated_lines": 150, "source_sections": ["Overview"]},
          {"id": "behavioral-patterns", "title": "Behavioral Patterns", "estimated_lines": 250, "source_sections": ["Pattern Detection Details"]},
          {"id": "creational-patterns", "title": "Creational Patterns", "estimated_lines": 200, "source_sections": ["Internal Pattern Detection"]},
          {"id": "configuration", "title": "Configuration", "estimated_lines": 200, "source_sections": ["Configuration", "Confidence Scoring", "Cross-File Pattern Detection"]},
          {"id": "rust-specific", "title": "Rust-Specific Patterns", "estimated_lines": 150, "source_sections": ["Rust-Specific Pattern Detection", "Integration with Complexity Analysis"]},
          {"id": "examples", "title": "Examples and Use Cases", "estimated_lines": 180, "source_sections": ["Practical Examples", "Use Cases", "Troubleshooting", "Best Practices"]}
        ]
      }
    },
    {
      "chapter_id": "cli-reference",
      "chapter_title": "CLI Reference",
      "current_file": "book/src/cli-reference.md",
      "priority": "high",
      "issue": "oversized",
      "metrics": {
        "total_lines": 951,
        "h2_sections": 11,
        "code_block_markers": 68,
        "code_block_ratio": 0.36
      },
      "recommended_action": "split_into_subsections",
      "proposed_structure": {
        "type": "multi-subsection",
        "index_file": "book/src/cli-reference/index.md",
        "subsections": [
          {"id": "quick-start", "title": "Quick Start", "estimated_lines": 140, "source_sections": ["Quick Start"]},
          {"id": "commands", "title": "Commands", "estimated_lines": 280, "source_sections": ["Commands"]},
          {"id": "options", "title": "Options Reference", "estimated_lines": 220, "source_sections": ["Options", "Configuration"]},
          {"id": "workflows", "title": "Common Workflows", "estimated_lines": 230, "source_sections": ["Common Workflows", "Examples"]},
          {"id": "reference", "title": "Reference", "estimated_lines": 200, "source_sections": ["Command Compatibility Matrix", "Troubleshooting", "Best Practices", "Additional Tools"]}
        ]
      }
    },
    {
      "chapter_id": "functional-analysis",
      "chapter_title": "Functional Composition Analysis",
      "current_file": "book/src/functional-analysis.md",
      "priority": "medium",
      "issue": "large",
      "metrics": {
        "total_lines": 949,
        "h2_sections": 14,
        "code_block_markers": 68,
        "code_block_ratio": 0.36
      },
      "recommended_action": "consider_subsections",
      "proposed_structure": {
        "type": "multi-subsection",
        "index_file": "book/src/functional-analysis/index.md",
        "subsections": [
          {"id": "overview", "title": "Overview and Configuration", "estimated_lines": 200, "source_sections": ["Overview", "Configuration Profiles"]},
          {"id": "detection", "title": "Detection Algorithms", "estimated_lines": 280, "source_sections": ["Pure Function Detection", "Pipeline Detection", "Purity Analysis"]},
          {"id": "side-effects", "title": "Side Effect Analysis", "estimated_lines": 200, "source_sections": ["Side Effect Detection", "Composition Pattern Recognition", "Composition Quality Scoring"]},
          {"id": "examples", "title": "Examples and Best Practices", "estimated_lines": 260, "source_sections": ["Practical Examples", "Best Practices", "Use Cases", "Troubleshooting"]}
        ]
      }
    },
    {
      "chapter_id": "validation-gates",
      "chapter_title": "Validation and Quality Gates",
      "current_file": "book/src/validation-gates.md",
      "priority": "medium",
      "issue": "large",
      "metrics": {
        "total_lines": 940,
        "h2_sections": 14,
        "code_block_markers": 72,
        "code_block_ratio": 0.38
      },
      "recommended_action": "consider_subsections",
      "proposed_structure": {
        "type": "multi-subsection",
        "index_file": "book/src/validation-gates/index.md",
        "subsections": [
          {"id": "overview", "title": "Overview", "estimated_lines": 200, "source_sections": ["Table of Contents", "Validate vs Analyze", "Quick Start", "Understanding Density-Based Validation"]},
          {"id": "configuration", "title": "Configuration", "estimated_lines": 200, "source_sections": ["Configuration Setup", "Validation Metrics", "Exit Codes and CI Integration"]},
          {"id": "coverage", "title": "Coverage Integration", "estimated_lines": 120, "source_sections": ["Coverage Integration", "Context-Aware Validation"]},
          {"id": "cicd", "title": "CI/CD Examples", "estimated_lines": 230, "source_sections": ["CI/CD Examples", "Migrating from Deprecated Thresholds"]},
          {"id": "troubleshooting", "title": "Troubleshooting and Best Practices", "estimated_lines": 200, "source_sections": ["Troubleshooting", "Best Practices"]}
        ]
      }
    },
    {
      "chapter_id": "coverage-integration",
      "chapter_title": "Coverage Integration",
      "current_file": "book/src/coverage-integration.md",
      "priority": "medium",
      "issue": "large",
      "metrics": {
        "total_lines": 851,
        "h2_sections": 13,
        "code_block_markers": 62,
        "code_block_ratio": 0.36
      },
      "recommended_action": "consider_subsections",
      "proposed_structure": {
        "type": "multi-subsection",
        "index_file": "book/src/coverage-integration/index.md",
        "subsections": [
          {"id": "overview", "title": "Overview", "estimated_lines": 180, "source_sections": ["Why Coverage Matters", "LCOV Format: The Universal Standard", "Generating Coverage Data"]},
          {"id": "role-based", "title": "Role-Based Coverage", "estimated_lines": 180, "source_sections": ["Role-Based Coverage Expectations", "How Coverage Affects Scoring", "Transitive Coverage Propagation"]},
          {"id": "performance", "title": "Performance and Configuration", "estimated_lines": 160, "source_sections": ["Performance Characteristics", "CLI Options Reference"]},
          {"id": "troubleshooting", "title": "Troubleshooting", "estimated_lines": 200, "source_sections": ["Troubleshooting Coverage Integration", "Best Practices"]},
          {"id": "language-examples", "title": "Language Examples", "estimated_lines": 120, "source_sections": ["Complete Language Examples", "FAQ"]}
        ]
      }
    },
    {
      "chapter_id": "dead-code-analysis",
      "chapter_title": "Dead Code Analysis",
      "current_file": "book/src/dead-code-analysis.md",
      "priority": "medium",
      "issue": "large",
      "metrics": {
        "total_lines": 769,
        "h2_sections": 15,
        "code_block_markers": 58,
        "code_block_ratio": 0.38
      },
      "recommended_action": "consider_subsections",
      "proposed_structure": {
        "type": "multi-subsection",
        "index_file": "book/src/dead-code-analysis/index.md",
        "subsections": [
          {"id": "detection", "title": "Detection and Scoring", "estimated_lines": 250, "source_sections": ["Overview", "Confidence Scoring", "Public API Detection", "Framework Support"]},
          {"id": "configuration", "title": "Configuration", "estimated_lines": 250, "source_sections": ["Confidence Thresholds", "Suppressing False Positives", "Coverage Integration", "Configuration Reference"]},
          {"id": "usage", "title": "Usage and Best Practices", "estimated_lines": 260, "source_sections": ["Understanding Results", "Common Patterns", "Best Practices", "Limitations", "Troubleshooting", "Examples"]}
        ]
      }
    },
    {
      "chapter_id": "multi-pass-analysis",
      "chapter_title": "Multi-Pass Analysis",
      "current_file": "book/src/multi-pass-analysis.md",
      "priority": "medium",
      "issue": "large",
      "metrics": {
        "total_lines": 715,
        "h2_sections": 12,
        "code_block_markers": 52,
        "code_block_ratio": 0.36
      },
      "recommended_action": "consider_subsections",
      "proposed_structure": {
        "type": "multi-subsection",
        "index_file": "book/src/multi-pass-analysis/index.md",
        "subsections": [
          {"id": "overview", "title": "Overview", "estimated_lines": 200, "source_sections": ["Overview", "How It Works", "CLI Usage"]},
          {"id": "attribution", "title": "Attribution Engine", "estimated_lines": 260, "source_sections": ["Attribution Engine", "Understanding Attribution Output", "Insights and Recommendations"]},
          {"id": "advanced", "title": "Advanced Usage", "estimated_lines": 250, "source_sections": ["Performance Considerations", "Comparative Analysis", "Configuration Options", "Use Cases"]}
        ]
      }
    }
  ],
  "well_organized_chapters": [
    {
      "chapter_id": "analysis-guide",
      "type": "multi-subsection",
      "metrics": {
        "subsection_count": 8,
        "total_lines": 3667,
        "average_subsection_lines": 458,
        "subsections": {
          "advanced-features.md": 570,
          "analyzer-types.md": 147,
          "complexity-metrics.md": 302,
          "debt-patterns.md": 517,
          "example-outputs.md": 525,
          "index.md": 16,
          "interpreting-results.md": 765,
          "overview.md": 182,
          "risk-scoring.md": 643
        },
        "largest_subsection": "interpreting-results.md (765 lines)"
      },
      "notes": "Already organized as multi-subsection. interpreting-results.md could be further split."
    },
    {
      "chapter_id": "architectural-analysis",
      "metrics": {"total_lines": 687, "h2_sections": 19},
      "notes": "At threshold boundary. Well-structured with many sections."
    },
    {
      "chapter_id": "god-object-detection",
      "metrics": {"total_lines": 677, "h2_sections": 17},
      "notes": "At threshold boundary. Well-structured."
    },
    {
      "chapter_id": "responsibility-analysis",
      "metrics": {"total_lines": 657, "h2_sections": 10},
      "notes": "At threshold boundary. Manageable structure."
    },
    {
      "chapter_id": "suppression-patterns",
      "metrics": {"total_lines": 621, "h2_sections": 8},
      "notes": "At threshold boundary. Good section balance."
    },
    {
      "chapter_id": "threshold-configuration",
      "metrics": {"total_lines": 599, "h2_sections": 10},
      "notes": "At threshold boundary. Well-organized."
    },
    {
      "chapter_id": "architecture",
      "metrics": {"total_lines": 580, "h2_sections": 8},
      "notes": "At threshold boundary. Good structure."
    },
    {
      "chapter_id": "entropy-analysis",
      "metrics": {"total_lines": 530, "h2_sections": 10},
      "notes": "At threshold boundary. Well-organized."
    },
    {
      "chapter_id": "boilerplate-vs-complexity",
      "metrics": {"total_lines": 505, "h2_sections": 8},
      "notes": "At threshold boundary. Focused content."
    },
    {
      "chapter_id": "llm-integration",
      "metrics": {"total_lines": 455, "h2_sections": 6},
      "notes": "Well-sized. No action needed."
    },
    {
      "chapter_id": "tui-guide",
      "metrics": {"total_lines": 392, "h2_sections": 5},
      "notes": "Well-sized. No action needed."
    },
    {
      "chapter_id": "metrics-reference",
      "metrics": {"total_lines": 395, "h2_sections": 7},
      "notes": "Well-sized. No action needed."
    },
    {
      "chapter_id": "tiered-prioritization",
      "metrics": {"total_lines": 381, "h2_sections": 7},
      "notes": "Well-sized. No action needed."
    },
    {
      "chapter_id": "getting-started",
      "metrics": {"total_lines": 353, "h2_sections": 6},
      "notes": "Well-sized. No action needed."
    },
    {
      "chapter_id": "faq",
      "metrics": {"total_lines": 292, "h2_sections": 5},
      "notes": "Well-sized. No action needed."
    },
    {
      "chapter_id": "call-graph-analysis",
      "metrics": {"total_lines": 291, "h2_sections": 6},
      "notes": "Well-sized. No action needed."
    },
    {
      "chapter_id": "coverage-analysis",
      "metrics": {"total_lines": 261, "h2_sections": 5},
      "notes": "Well-sized. No action needed."
    },
    {
      "chapter_id": "boilerplate-detection",
      "metrics": {"total_lines": 256, "h2_sections": 4},
      "notes": "Well-sized. No action needed."
    },
    {
      "chapter_id": "why-debtmap",
      "metrics": {"total_lines": 196, "h2_sections": 3},
      "notes": "Well-sized. No action needed."
    },
    {
      "chapter_id": "introduction",
      "metrics": {"total_lines": 100, "h2_sections": 2},
      "notes": "Well-sized. No action needed."
    }
  ],
  "statistics": {
    "total_lines": 34254,
    "average_lines_per_chapter": 1070,
    "median_lines_per_chapter": 700,
    "largest_chapter": {"id": "troubleshooting", "lines": 2553},
    "smallest_complete_chapter": {"id": "introduction", "lines": 100},
    "chapters_over_1000_lines": 8,
    "chapters_over_500_lines": 25,
    "total_h2_sections": 245
  }
}
