Changelog

All notable changes to GodotIQ are documented here. Releases follow semantic versioning.

v0.5.1 Latest

Website activation surface overhaul

New /pro/, /manage/, /troubleshooting/, /how-licensing-works/, /support/ pages
Single metadata source (src/data/site.ts) replaces scattered hardcoded values
Shared ConfigSnippetTabs component unifies install snippets across homepage, install docs, and all client guides
/thank-you/ post-purchase page wired to Polar success_url
Legal pages (MVP): /privacy/, /terms/, /refund-policy/
Cookie consent banner for GA4 (EU GDPR/ePrivacy)
CI guards: route smoke, link crawl, placeholder lint, GitHub Actions
Product-side changes (package version bump, error-code fix) tracked separately at github.com/salvo10f/godotiq releases

v0.4.0

Pro Bundle Architecture

Pro bundle distribution: public package now ships Community tools + Pro stubs, not full Pro implementation code
Pro activation via GODOTIQ_LICENSE_KEY: automatic Pro bundle download and local cache on first valid Pro run
Worker + R2 delivery path for Pro bundle distribution
platformdirs added as 4th runtime dependency for cross-platform license state and bundle cache paths
Offline support: after initial bundle download, Pro works from local cache without network access
Community/Pro messaging refresh across docs and site

v0.3.9

Click Fix

Hotfix: click_at and click_at_world used device=-2 (DEVICE_ID_INTERNAL, reserved by Godot), so synthetic clicks never reached game nodes. Changed to device=0 (default device).

v0.3.8

Click Simulation + Type Coercion

node_ops value parameter aliasing: accepts value as generic key alongside specific names (position, rotation, etc.)
Type coercion helpers: auto-converts dictionaries {"x": 1, "y": 2} to native Vector2/Vector3/Color
click_at and click_at_world input commands: simulate clicks at viewport or world coordinates
MCP prompt v0.4.0: selective rewrite with updated rules

v0.3.7

In-editor update popup: new version triggers a dialog with update instructions (not just the dock label)
UndoRedo compatibility fix: MERGE_DISABLE replaced with numeric value 0 for cross-version Godot compatibility

v0.3.6

GLB Intelligence

GLB bounding box parser: reads real model dimensions from .glb files without opening Godot
node_ops persistence fix: modifications now persist correctly after save
Grid key normalization + bounds checking to prevent placement errors
Explore tour smart grouping
suggest_scale with GLB bounds: suggestions based on actual model dimensions
build_scene auto-spacing: automatic object spacing using GLB bounding boxes
exec_editor timeout increased and clamped
MCP prompt improvements

v0.3.5

Hardening

Same content as v0.3.4 with clean PyPI tag (re-tag).

v0.3.4

Bug Sweep

5 critical bugs found and fixed from the “Crystal Keep” stress test:

Exec security hardening: tighter sandboxing for exec_editor
run no longer writes main_scene: eliminated side effect that modified project.godot
Session cache freshness: stale data was served after file changes
suggest_scale fallback: no longer crashes when reference model is missing
Z-fighting noise fix: spatial_audit no longer reports false positives on overlapping sibling nodes

v0.3.3

First Stable Tag

First stable release. Includes all work from the initial sprints:

Complete TSCN/TRES/GD parser with state machine
Scene resolver + project index with cross-reference maps
World transforms and spatial queries
Session layer: unified project state for all tools
9 MCP tools: project_summary, file_context, dependency_graph, scene_map, animation_info, animation_audit, signal_map, suggest_scale, explore
WebSocket bridge with Godot addon: bidirectional editor-Python protocol
Runtime tools: node_ops, scene_tree, script_ops, file_ops, build_scene, check_errors, run, exec_editor, screenshot, input
Placement tool with constraint solving
UI map for runtime UI elements
Trace flow: recursive signal tracing across the project
Spatial validation on node_ops with batch blocking
MCP prompt for AI agent guidance
CLI: install-addon, --version, PyPI packaging
Dev key hashing SHA-256, security audit
1,000+ tests

v0.3.1

Multi-Client Auto-Setup

godotiq install-addon now auto-injects development rules for all major AI clients
Supported: Claude Code (CLAUDE.md), OpenAI Codex (AGENTS.md), Cursor (.cursorrules), Windsurf (.windsurfrules), GitHub Copilot (.github/copilot-instructions.md)
Uses marker-based injection: safe to re-run, updates without duplicating
1,311 tests passing

v0.3.0

Explore & Agent Polish

godotiq_explore tool for autonomous visual inspection via drone camera (tour + inspect modes)
Agent prompt improvements and workflow refinements
Tool count: 36 total (22 free, 14 PRO)

v0.1.9

Sprint 12a: Quality & Polish

CLI --version warning suppression
Version sync script across pyproject.toml, plugin.cfg, godotiq_server.gd
node_ops rename and get_property operations
input mouse motion command
screenshot crop region support
save_scene feedback fields
scene_map disk warning note
asset_registry fuzzy match suggestions
exec await/timeout warning and error detail extraction
check_errors confidence annotation
build_scene parent path stripping, scene-derived node names, offset parameter

v0.1.5 to v0.1.7

PyPI Distribution Sprint

README with PyPI installation instructions
Build verification tests and wheel validation
install-addon subcommand with file copying
CLI module with argparse and lazy imports
Dynamic __version__ from package metadata
Packaging configuration for PyPI distribution (Hatchling)

v0.1.4

Sprint 11a, Reliability & Runtime

Fresh MCP development prompt
verify_motion tool for proving movement/animation
Adaptive timeout based on GLB asset count
node_names field added to build_scene response
Script reload handler + script_ops integration
Reliable scene launch rewrite (_handle_run)
set_main_scene GDScript handler

Sprint 10a/10b, Error Checking & QA

Edge case tests for check_errors
Prompt updates for error checking and gameplay testing
Python check_errors bridge tool and MCP registration
Pre-run script check gate in _handle_run
check_errors GDScript handler with script validation
Logger + error buffer for script error capture
QA checklist and efficiency rules added to MCP prompt
Grid connectivity validation for build_scene
Pre-flight scene checks for node_ops and build_scene
_editor_state added to every bridge response for ambient context

Sprint 9a, Build Scene

build_scene creation workflow prompt
GDScript build_scene handler
Python-side build_scene tool with registration and timeout tests

Sprint 8a, Output Control & Detail

Token budget integration tests
detail parameter added to all tools (brief/normal/full)
detail added to placement, suggest_scale, bridge tools
impact_check detail renamed to change_description
Enhanced output_limit.py

Sprint 7, Prompt & Config Rewrite

Directive agent guidance rewrite for all 35 tool docstrings
detail parameter system + config system enhancement

Sprint 6, UI, Placement, File Ops

UID conversion, anchor presets, script rename with reference updates
placement tool: smart object placement with constraint solving
ui_map: runtime UI element mapping

Sprint 5, Spatial Validation & Screenshot

Spatial validator module for node_ops validation
Editor screenshot with synchronous handler + WS buffer auto-downscale
Editor screenshot and camera control
Editor exec + save scene
MCP prompt overhaul

Sprint 4, Bridge Layer

file_ops filesystem tool
script_ops filesystem tool
node_ops Python bridge tool + GDScript handler
scene_tree Python bridge tool + GDScript handler
Protocol and plugin wiring
WebSocket server with request dispatch
Godot addon plugin configuration and lifecycle
Bridge tool test suite + session manager + tool registration

Sprint 3, Analysis & Parsers

trace_flow tool: recursive tracing, failure detection, trigger finding, signal listener map
Spatial audit severity filtering + sibling z-fighting downgrade
suggest_scale reference mode without model
scene_map detail-dependent caps and compact output
project_summary architectural enrichment
signal_map false positive fixes from event bus pattern
animation_audit tool + animation_info tool with test suites
Animation extraction helpers and test fixtures
scene_map tool with spatial intelligence
dependency_graph tool with signal cross-referencing
file_context tool for deep file analysis
project_summary tool with 3 detail levels
Server integration with FastMCP lifespan
Session layer for unified project state
GDScript parser: body patterns, state machine core, dataclasses

Sprint 2, Scene & Spatial Foundation

Project index with cross-reference maps
World transforms and spatial queries
Scene resolver core
Value parser raw key addition

Sprint 1, Foundation

Sprint 0 + Sprint 1A: initial project structure, parsers, test fixtures

v0.1.1

Website-only Patch

Website: fixed all placeholder links, added real GitHub/PyPI/checkout URLs
Website: removed Discord references
Website: corrected license activation limit (3 machines)
Website: added “Activate Pro” section to installation docs
Website: added free tool examples to quickstart
Website: fixed mobile overflow issues

v0.1.0

GodotIQ Launch

36 tools across 11 categories
1,245 automated tests
22 free tools: raw operations (read, write, execute, query), scene editing, visual debugging, runtime monitoring, editor integration, I/O, animation data, health check
13 PRO tools: intelligence layer (analyze, reason, predict, suggest), spatial analysis, code understanding, flow tracing, project memory, asset management, animation auditing
.godotiq.json configuration system
Token optimization with brief/normal/full detail levels
Pure GDScript addon (~500 lines, no compilation needed)
Local-first Community package (MIT-licensed, no analytics in the library itself; website analytics wiring lands in a later website release — see /privacy/)
MIT license