v1.6.0

GDMetrics for Godot 4 — v1.0.0

Pride Versioning PROUD release (1.0.0). Stable report/config contract.

Highlights

• Schema freeze: JSON report "version": "1.0" and config keys documented in docs/SCHEMA.md
• Shared core: calculators, detectors, gates, history, errors, logger under addons/gdscript_complexity/src/core/ (canonical in g4; sync with scripts/sync_core.ps1)
• Editor annotations: after Analyze Project, functions at or above cc/cog threshold_fail get ScriptEditor annotations via add_error_annotation (Godot 4.2+)
• Prior DEFAULT features retained: HTML/CSV/JSON, history JSONL, CLI --diff / --fail-on-diff-regression, structural gates

Install

1. Download gdmetrics-v1.0.0.zip
2. Copy addons/gdscript_complexity/ and cli/ into your Godot 4 project
3. Project → Project Settings → Plugins → enable GDScript Complexity Analyzer
4. Optional: copy examples/github-actions/complexity-check.yml into .github/workflows/

CLI

godot --headless --script cli/analyze_project.gd -- \
  --project-path . --output report.json --csv-output report.csv --html-output report.html

godot --headless --script cli/analyze_project.gd -- \
  --project-path . --output report.json --diff

godot --headless --script cli/analyze_project.gd -- \
  --project-path . --output report.json --baseline baseline.jsonl --fail-on-diff-regression

Docs

See README.md, docs/SCHEMA.md, docs/USER_GUIDE.md, docs/DISTRIBUTION.md, and docs/COMPATIBILITY.md.

Breaking

See docs/BREAKING_CHANGES.md (1.0.0): core load paths moved to src/core/; schema is frozen until 2.0.0.

v1.0.0

GDMetrics for Godot 4 — v1.0.0

Pride Versioning PROUD release (1.0.0). Stable report/config contract.

Highlights

• Schema freeze: JSON report "version": "1.0" and config keys documented in docs/SCHEMA.md
• Shared core: calculators, detectors, gates, history, errors, logger under addons/gdscript_complexity/src/core/ (canonical in g4; sync with scripts/sync_core.ps1)
• Editor annotations: after Analyze Project, functions at or above cc/cog threshold_fail get ScriptEditor annotations via add_error_annotation (Godot 4.2+)
• Prior DEFAULT features retained: HTML/CSV/JSON, history JSONL, CLI --diff / --fail-on-diff-regression, structural gates

Install

1. Download gdmetrics-v1.0.0.zip
2. Copy addons/gdscript_complexity/ and cli/ into your Godot 4 project
3. Project → Project Settings → Plugins → enable GDScript Complexity Analyzer
4. Optional: copy examples/github-actions/complexity-check.yml into .github/workflows/

CLI

godot --headless --script cli/analyze_project.gd -- \
  --project-path . --output report.json --csv-output report.csv --html-output report.html

godot --headless --script cli/analyze_project.gd -- \
  --project-path . --output report.json --diff

godot --headless --script cli/analyze_project.gd -- \
  --project-path . --output report.json --baseline baseline.jsonl --fail-on-diff-regression

Docs

See README.md, docs/SCHEMA.md, docs/USER_GUIDE.md, docs/DISTRIBUTION.md, and docs/COMPATIBILITY.md.

Breaking

See docs/BREAKING_CHANGES.md (1.0.0): core load paths moved to src/core/; schema is frozen until 2.0.0.

v0.4.0

GDMetrics for Godot 4 — v0.4.0

Pride Versioning DEFAULT release (PROUD.DEFAULT.SHAME). Early / pre-stable until 1.0.0.

Highlights

• Append-only history: successful analyses append a JSON line to complexity_history.jsonl (configurable via report.history_path)
• CLI diff: --diff prints Δ totals/averages and fail_count vs previous history line or --baseline; --fail-on-diff-regression exits 1 when avg_cog or fail_count increases
• CI matrix: GitHub Actions tests on Godot 4.0.4 and 4.2.0

Install

1. Download gdmetrics-v0.4.0.zip
2. Copy addons/gdscript_complexity/ and cli/ into your Godot 4 project
3. Project → Project Settings → Plugins → enable GDScript Complexity Analyzer
4. Optional: copy examples/github-actions/complexity-check.yml into .github/workflows/

CLI

godot --headless --script cli/analyze_project.gd -- \
  --project-path . --output report.json --csv-output report.csv --html-output report.html

# Trend vs previous history line
godot --headless --script cli/analyze_project.gd -- \
  --project-path . --output report.json --diff

# Fail CI on avg_cog / fail_count regression vs baseline snapshot
godot --headless --script cli/analyze_project.gd -- \
  --project-path . --output report.json --baseline baseline.jsonl --fail-on-diff-regression

Docs

See README.md, docs/USER_GUIDE.md, docs/DISTRIBUTION.md, and docs/COMPATIBILITY.md in the zip.

v0.3.0

GDMetrics for Godot 4 — v0.3.0

Pride Versioning DEFAULT release (PROUD.DEFAULT.SHAME). Early / pre-stable until 1.0.0.

Highlights

• HTML report: self-contained HTML with totals, top offenders, per-file table, and SVG C-COG bars (--html-output / Export HTML)
• Dock secondary metrics: Nest, Params, LOC columns on file rows
• Structural gates: structural config keys for NEST / PARAMS / LOC warn+fail thresholds
• JSON per-function CC: each function entry includes "cc" alongside "cog"
• CI threshold gates for CC / C-COG / structural metrics (exit code 1 on fail)

Install

1. Download gdmetrics-v0.3.0.zip
2. Copy addons/gdscript_complexity/ and cli/ into your Godot 4 project
3. Project → Project Settings → Plugins → enable GDScript Complexity Analyzer
4. Optional: copy examples/github-actions/complexity-check.yml into .github/workflows/

CLI

godot --headless --script cli/analyze_project.gd -- \
  --project-path . --output report.json --csv-output report.csv --html-output report.html

Docs

See README.md, docs/USER_GUIDE.md, docs/DISTRIBUTION.md, and docs/COMPATIBILITY.md in the zip.

v0.2.0

GDMetrics for Godot 4 — v0.2.0

Pride Versioning DEFAULT release (PROUD.DEFAULT.SHAME). Early / pre-stable until 1.0.0.

Highlights

• CI threshold gates: cc.threshold_fail / cog.threshold_fail return exit code 1 with a breach summary
• Consumer CLI: cli/analyze_project.gd (exit 0 / 1 / 2)
• Release zip includes cli/ and examples/github-actions/
• Drop-in GitHub Actions template for PR complexity gates
• Docs: Pride Versioning + distribution notes (docs/DISTRIBUTION.md)

Install

1. Download gdmetrics-v0.2.0.zip
2. Copy addons/gdscript_complexity/ and cli/ into your Godot 4 project
3. Project → Project Settings → Plugins → enable GDScript Complexity Analyzer
4. Optional: copy examples/github-actions/complexity-check.yml into .github/workflows/

CLI

godot --headless --script cli/analyze_project.gd -- \
  --project-path . --output report.json --csv-output report.csv

Docs

See README.md, docs/USER_GUIDE.md, docs/DISTRIBUTION.md, and docs/COMPATIBILITY.md in the zip.

v0.1.3

GDMetrics for Godot 4 — v0.1.3

Early release / pre-stable. Breaking changes may still occur before v1.0.

Highlights

• Match/when arms, lambdas, raw strings, %Unique / &"…" / ^"…" / @"…"
• Godot 4 multiline regular "…" / '…' strings (engine-accepted newlines)
• Line-continuation and triple-string trail/\ fixes shared with the g3 line
• External project host CLI (tests/analyze_external.gd)
• Edge-case fixtures + corpus validation against real Godot 4 projects (D:\test-4: 12/12, 0 soft token errors)

Install

1. Download gdmetrics-v0.1.3.zip
2. Copy addons/gdscript_complexity/ into your Godot 4 project
3. Project → Project Settings → Plugins → enable GDScript Complexity Analyzer

Docs

See README.md, docs/USER_GUIDE.md, docs/EDGE_CASES.md, and docs/COMPATIBILITY.md in the zip.

v0.1.2

Self-contained addon structure

v0.1.1

gdmetrics v0.1.1