Release Notes

Track the evolution of Goca through detailed release notes. Each release includes new features, bug fixes, improvements, and migration guides.

---

v1.22.0Latest

March 27, 2026

Analyze, Cache, CI & Middleware — Largest release to date: goca analyze with 30 rules across 6 categories (AST-based static analysis), Redis cache decorator pattern, GitHub Actions CI generation, 7 composable middleware types, and MCP server for AI assistant integration.

Key Changes:

• goca analyze — 30-rule deep audit: architecture boundaries, security (OWASP A03), test quality, dependency hygiene
• --cache flag on feature, repository, di — generates Cached<Entity>Repository decorator with Redis
• goca ci — generates GitHub Actions workflows with auto-detected Go version and database services
• goca middleware <name> — 7 middleware types: CORS, logging, auth, rate-limit, recovery, request-id, timeout
• goca mcp-server — MCP server exposing all Goca tools to GitHub Copilot, Claude Desktop, Cursor, Zed
• Domain purity fix: internal/domain/user.go no longer imports gorm.io/gorm
• Test quality: all hardcoded /tmp paths replaced with t.TempDir()

v1.19.0 — v1.21.0

March 24–26, 2026

MCP server, comprehensive test coverage, integration test generation improvements, and repository generation enhancements. Features from these releases are consolidated in v1.22.0.

Key Changes:

• --cache flag on feature, repository, and di — generates Cached<Entity>Repository decorator with Redis caching
• goca ci — generates GitHub Actions workflows (test, build, deploy) with auto-detected Go version
• goca middleware <name> — generates 7 middleware types: CORS, logging, auth, rate-limit, recovery, request-id, timeout
• DI container wires cache decorators with NewContainer(db, redisClient)
• Handler auto-detects and imports middleware package
• 51 new tests across 4 test files

v1.18.7

March 24, 2026

Universal Safety Flags - --dry-run, --force, and --backup now correctly wired through all 12 file-generating commands. SafetyManager fully connected to every sub-generator.

Key Changes:

• Fixed goca init --dry-run failing with "unknown flag" error
• --dry-run, --force, --backup registered on all 12 commands: entity, usecase, repository, handler, di, messages, interfaces, mocks, init, integrate, feature, test-integration
• writeFile() and writeGoFile() now accept variadic *SafetyManager — backward-compatible
• SafetyManager forwarded from feature into all 8 sub-generators
• SafetyManager threaded through integrate DI and main.go generation paths
• 15 files modified across cmd/ package

v1.18.1 — v1.18.6

March 24–25, 2026

Patch series: interactive wizard fix, version display fix, goca doctor, goca upgrade, global --quiet/--verbose flags, improved dry-run table, and CI fixes.

Key Changes:

• v1.18.1: goca init no-arg wizard fix; goca version reads correct installed version via runtime/debug.ReadBuildInfo
• v1.18.2: New goca doctor command (6 health checks, --fix); new goca upgrade command; --quiet/--verbose global flags; improved 3-column dry-run table
• v1.18.3: Resolved CI failures from v1.18.2
• v1.18.4: Removed conflicting -v shorthand from --validation flag
• v1.18.5: Restored missing --business-rules and --dry-run flags in feature command
• v1.18.6: YAML workflow formatting fix

v1.18.0

March 24, 2026

CLI UX Overhaul - Centralized output rendering system, interactive initialization wizard, global --no-color and --no-interactive flags, unified English output, and multiple bug fixes.

Key Changes:

• New UIRenderer system replaces all raw fmt.Printf calls across every command
• Interactive wizard for goca init using huh forms
• Global --no-color and --no-interactive flags on every command
• Table output for generated file summaries in entity, feature, and di commands
• Spinner animations for long-running operations
• goca handler now auto-injects go-playground/validator/v10 when validation is enabled
• Removed duplicate configCmd registration and spurious DEBUG: output

v1.17.2

February 1, 2026

Database Defaults and MongoDB Fixes - Changed default database to SQLite and fixed MongoDB code generation issues.

Key Changes:

• 🎯 SQLite is now the default database (was PostgreSQL)
• ✅ Fixed MongoDB code generation to use mongo-driver correctly
• ✅ MongoDB projects no longer import GORM incorrectly
• 🧪 Added comprehensive database initialization tests

v1.17.1

January 11, 2026

Critical Bug Fix - SQLite and other database drivers now properly configured during project initialization. Resolves issue #31.

Bug Fixes:

• ✅ Fixed database driver configuration during goca init
• ✅ SQLite, MySQL, SQL Server, MongoDB, DynamoDB, and Elasticsearch now generate correct dependencies
• ✅ Main.go now imports and uses correct database driver package
• ✅ All 8 supported database types verified working

v1.14.1

October 27, 2025

Test Suite Improvements - Fixed Windows path handling, test working directory management, and module dependencies. Test success rate improved to 99.04%.

Key Improvements:

• Fixed Windows path handling in BackupFile
• Improved test working directory management
• Updated test message validation
• Fixed module dependencies for testify

---

Release Versioning

Goca follows Semantic Versioning:

• Major (X.0.0): Breaking changes
• Minor (1.X.0): New features (backward compatible)
• Patch (1.14.X): Bug fixes and minor improvements

Stay Updated

• Watch the GitHub repository for release notifications
• View the complete CHANGELOG
• Subscribe to GitHub Releases