v1.6.1

GDMetrics for Godot 3 — 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 gdmetrics-g4; sync with scripts/sync_core.ps1)
• Editor: on-demand Analyze Project only — no real-time ScriptEditor annotations on Godot 3 (use gdmetrics-g4 for add_error_annotation after analyze)
• 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 3.x project
3. Project → Project Settings → Plugins → enable GDScript Complexity Analyzer
4. Optional: copy examples/github-actions/complexity-check.yml into .github/workflows/

CLI

godot --no-window -s cli/analyze_project.gd -- \
  --project-path . --output report.json --csv-output report.csv --html-output report.html

godot --no-window -s cli/analyze_project.gd -- \
  --project-path . --output report.json --diff

godot --no-window -s 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.6.0

GDMetrics for Godot 3 — 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 gdmetrics-g4; sync with scripts/sync_core.ps1)
• Editor: on-demand Analyze Project only — no real-time ScriptEditor annotations on Godot 3 (use gdmetrics-g4 for add_error_annotation after analyze)
• 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 3.x project
3. Project → Project Settings → Plugins → enable GDScript Complexity Analyzer
4. Optional: copy examples/github-actions/complexity-check.yml into .github/workflows/

CLI

godot --no-window -s cli/analyze_project.gd -- \
  --project-path . --output report.json --csv-output report.csv --html-output report.html

godot --no-window -s cli/analyze_project.gd -- \
  --project-path . --output report.json --diff

godot --no-window -s 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 3 — 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 gdmetrics-g4; sync with scripts/sync_core.ps1)
• Editor: on-demand Analyze Project only — no real-time ScriptEditor annotations on Godot 3 (use gdmetrics-g4 for add_error_annotation after analyze)
• 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 3.x project
3. Project → Project Settings → Plugins → enable GDScript Complexity Analyzer
4. Optional: copy examples/github-actions/complexity-check.yml into .github/workflows/

CLI

godot --no-window -s cli/analyze_project.gd -- \
  --project-path . --output report.json --csv-output report.csv --html-output report.html

godot --no-window -s cli/analyze_project.gd -- \
  --project-path . --output report.json --diff

godot --no-window -s 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 3 — 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

Install

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

CLI

godot --no-window -s cli/analyze_project.gd -- \
  --project-path . --output report.json --csv-output report.csv --html-output report.html

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

# Fail CI on avg_cog / fail_count regression vs baseline snapshot
godot --no-window -s 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 3 — 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 3.x project
3. Project → Project Settings → Plugins → enable GDScript Complexity Analyzer
4. Optional: copy examples/github-actions/complexity-check.yml into .github/workflows/

CLI

godot --no-window -s 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 3 — 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 (Godot 3.5.3 headless)
• 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 3.x project
3. Project → Project Settings → Plugins → enable GDScript Complexity Analyzer
4. Optional: copy examples/github-actions/complexity-check.yml into .github/workflows/

CLI

godot --no-window -s 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 3 — v0.1.3

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

Highlights

• Line-continuation (\), match-arm scoring, ternary/&&/|| handling
• Tokenizer fixes for $ paths, annotations, triple-string trail/\ cases
• External project host CLI (tests/analyze_external.gd)
• Edge-case fixtures + corpus validation against real Godot 3 projects (D:\test-3: 21/21, 0 soft token errors)

Install

1. Download gdmetrics-v0.1.3.zip
2. Copy addons/gdscript_complexity/ into your Godot 3 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.