Command

bengal.utils.graph.report

Generate comprehensive site analysis report.

Combines multiple analyses into a single unified report:

  • Connectivity analysis (orphans, link density)
  • Link suggestions (top recommendations)
  • Bridge pages (navigation bottlenecks)
  • Communities (topic clusters)

Use this command to get a complete picture of your site's structure and actionable recommendations for improvement.

6Options1Argument

Usage

bengal.utils.graph.report [OPTIONS]

Options

Option Type Description
--brief flag BOOLEAN

Compact output for CI pipelines and quick checks
--ci flag BOOLEAN

CI mode: exit with code 1 if thresholds exceeded
--config PATH

Path to config file (default: bengal.toml)
--format, -f CHOICE

Output format (default: console)

Default:console
--threshold-isolated INTEGER

Max isolated pages before CI failure (default: 5)

Default:5
--threshold-lightly INTEGER

Max lightly-linked pages before CI warning (default: 20)

Default:20

Arguments

Argument Type Description
source PATH Default:.

Examples

    # Full analysis report
    bengal graph report
    # Quick summary for CI
    bengal graph report --brief
    # CI mode with thresholds
    bengal graph report --ci --threshold-isolated 5
    # Export as JSON
    bengal graph report --format json > report.json