{
  "item_type": "chapter",
  "chapter_id": "examples",
  "chapter_title": "Examples",
  "chapter_file": "book/src/examples.md",
  "drift_detected": true,
  "severity": "low",
  "quality_assessment": "Excellent comprehensive examples with mostly current CLI syntax. All previous major issues (broken links, incorrect threshold table, missing --output-format) have been fixed. Only one minor issue remains with an outdated --multi-pass flag reference.",
  "issues": [
    {
      "type": "outdated_information",
      "severity": "low",
      "section": "Multi-Pass Analysis",
      "description": "Example on line 243 uses non-existent --multi-pass flag",
      "current_content": "debtmap analyze . --multi-pass --attribution",
      "should_be": "debtmap analyze . --attribution",
      "fix_suggestion": "Remove --multi-pass from the example since multi-pass is enabled by default. The command should be: 'debtmap analyze . --attribution'. This section (lines 808-836) already correctly explains that multi-pass is default and only --no-multi-pass exists.",
      "source_reference": "src/cli/args.rs:234-236"
    }
  ],
  "positive_aspects": [
    "Comprehensive coverage of all major use cases (Rust, Python, JavaScript/TypeScript)",
    "Excellent CI/CD integration examples for GitHub Actions, GitLab CI, CircleCI",
    "Clear progression from basic to advanced usage",
    "Good use of real-world examples from debtmap's own CI workflow",
    "Helpful interpretation guidance for output and metrics",
    "Well-organized table of contents and cross-references",
    "Examples are copy-paste ready with proper syntax",
    "Good coverage of filtering, grouping, and output format options",
    "Comprehensive compare command documentation",
    "Excellent explanation of purity-weighted god object scoring",
    "Correct threshold preset table with accurate values verified against source code",
    "Good coverage of --show-splits option for god object decomposition",
    "Comprehensive Multi-Pass Analysis section with --no-multi-pass flag",
    "All internal links are valid (cli-reference.md, entropy-analysis.md, analysis-guide/index.md, configuration.md)",
    "Added documentation for verbosity levels (-v, -vv, -vvv)",
    "Added --explain-metrics documentation",
    "Added AST functional analysis documentation",
    "Added design pattern detection documentation",
    "Added dead code and public API analysis documentation",
    "Good detail level documentation (summary, standard, comprehensive, debug)"
  ],
  "improvement_suggestions": [
    "Fix the --multi-pass flag on line 243 (it should just be --attribution since multi-pass is default)",
    "Consider consolidating the two Multi-Pass Analysis sections (lines 231-244 and 808-836) to avoid confusion",
    "Consider adding more examples for the streaming mode (--streaming, --stream-to)"
  ],
  "progress_from_previous": {
    "issues_fixed": [
      "Broken link to analysis-guide.md - now correctly links to analysis-guide/index.md",
      "Incorrect threshold preset table - now shows correct values matching ComplexityThresholds::from_preset",
      "Missing --show-splits example - now documented in God Object Detection section",
      "Missing --no-multi-pass example - now documented in Multi-Pass Analysis section"
    ],
    "issues_remaining": [
      "Invalid --multi-pass flag on line 243 (new issue, was hidden in previous report)"
    ]
  },
  "metadata": {
    "analyzed_at": "2025-12-27T08:30:00Z",
    "feature_inventory": ".prodigy/book-analysis/features.json",
    "topics_covered": [
      "Analyzing Rust projects",
      "Python analysis",
      "JavaScript/TypeScript",
      "CI integration"
    ],
    "validation_focus": "Ensure examples use current CLI syntax and options",
    "links_validated": {
      "total_internal_links": 4,
      "broken_links": 0,
      "valid_links": 4
    },
    "cli_verified_against": "src/cli/args.rs"
  }
}
