foxctl-code-complexity

name	foxctl Code Complexity
description	Analyze code complexity metrics - cyclomatic, cognitive, nesting depth, function length. Find hotspots and quality issues.

Code Complexity Analysis

Measure and analyze code complexity to identify quality hotspots.

Quick Start

Find complexity hotspots in your codebase:

foxctl run code/complexity --input '{
  "path": ".",
  "analysis_mode": "hotspots"
}'

Parameters

Parameter	Type	Required	Default	Description
path	string	No	.	File or directory to analyze
analysis_mode	string	No	hotspots	Mode: file, function, aggregate, hotspots
metric	string	No	cyclomatic	Metric: cyclomatic, cognitive, all
threshold	integer	No	10	Complexity threshold for hotspot detection
language	string	No	auto	Language: go, python, javascript, typescript, auto
include_tests	boolean	No	false	Include test files
max_results	integer	No	100	Maximum results to return

Analysis Modes

Hotspots (Default)

Find functions exceeding complexity threshold:

foxctl run code/complexity --input '{
  "path": "internal/",
  "analysis_mode": "hotspots",
  "threshold": 15
}'

Per-Function

Detailed metrics for each function:

foxctl run code/complexity --input '{
  "path": "main.go",
  "analysis_mode": "function"
}'

Per-File

Aggregate complexity by file:

foxctl run code/complexity --input '{
  "path": "src/",
  "analysis_mode": "file"
}'

Aggregate

Project-wide summary statistics:

foxctl run code/complexity --input '{
  "path": ".",
  "analysis_mode": "aggregate"
}'

Metrics

Cyclomatic Complexity

Measures independent paths through code:

foxctl run code/complexity --input '{
  "path": ".",
  "metric": "cyclomatic",
  "threshold": 10
}'

• 1-10: Simple, low risk
• 11-20: Moderate complexity
• 21-50: High complexity, consider refactoring
• 51+: Very high risk, should refactor

Cognitive Complexity

Measures how hard code is to understand:

foxctl run code/complexity --input '{
  "path": ".",
  "metric": "cognitive"
}'

All Metrics

Get both cyclomatic and cognitive:

foxctl run code/complexity --input '{
  "path": ".",
  "metric": "all"
}'

Language-Specific

# Go
foxctl run code/complexity --input '{"path": ".", "language": "go"}'

# Python
foxctl run code/complexity --input '{"path": ".", "language": "python"}'

# TypeScript
foxctl run code/complexity --input '{"path": ".", "language": "typescript"}'

Use Cases

• Code review: Identify complex functions needing attention
• Refactoring: Find candidates for simplification
• Quality gates: Enforce complexity thresholds in CI
• Technical debt: Track complexity trends over time