Skip to content

v1.3.3 Documentation and Debuggability Release

Choose a tag to compare

@ricomariani ricomariani released this 15 Jan 02:23
· 95 commits to main since this release

v1.3.3 Documentation and Debuggability Release

This release focuses on comprehensive developer documentation, improved AST debugging, and project infrastructure enhancements.

🚀 Release Summary

📚 Developer Documentation

• Comprehensive developer guide updates covering all 11 chapters
• New query plan generation documentation (Chapter 9)
• Lua code generation comparison and implementation notes (Chapter 10)
• Python JSON utilities documentation (new appendix)
• User FAQ and Developer FAQ added to repository root
• Complete version history document (HISTORY.md)

🔍 AST & Debugging Improvements

• AST flag decoding now 100% enforced - all option nodes must have decoders
• Human-readable flag output in AST dumps (temp, if_not_exists, without_rowid, eponymous, window flags, trigger flags)
• Detail node renaming (was new_ast_option) for consistency and clarity
• Table-driven AST output formatting for maintainability

🛡️ Security & Infrastructure

• Security reporting via GitHub (SECURITY.md) with proper reporting channels
• README files added throughout project directories for better navigation
• Improved documentation organization and formatting

🧹 Code Quality

• UTF-8 support in JSON strings
• @strict control directives documentation
• Enum and const group attributes now supported in JSON schema output
• Shared fragments documentation reformatted and clarified
• #define references updated to @macro throughout documentation

📖 Documentation Improvements

• Pipeline operators appendix enhanced with better examples
• JSON procedure documentation updated
• CQL in 20 minutes guide refined
• Consistent formatting applied to shared fragments documentation
• Removed stale references to deprecated features

Full Changelog: v1.3.2...v1.3.3