feat: v0.0.2 - consolidate tooling, services, and docs (#3)

[it-timo]

📦 v0.0.2 – Testing Framework & Quality Enforcement

Release Summary:

This marks a transformational release for goboot, elevating it from a scaffolding tool into a production-grade code generation platform with enforced quality standards.

Where v0.0.1 enabled practical hygiene and linting workflows, v0.0.2 introduces comprehensive testing infrastructure, intelligent template generation, and architectural validation — establishing goboot as a framework that doesn't just create projects, but ensures they meet gold-standard quality from day zero.

---

🚀 What's Included

🧪 Testing Infrastructure (89.9% Coverage)

• Complete BDD test suite across all packages using Ginkgo/Gomega
• Race detection enabled on all tests (-race flag)
• E2E validation suite ensuring generated projects pass all quality gates
• Test helper patterns with proper cleanup (t.TempDir())
• Table-driven test structure with parallel execution

🎯 New Service: base_test

• Auto-generation of test scaffolding for new projects
• Support for both stdlib testing and BDD (Ginkgo/Gomega) patterns
• Intelligent test file placement matching project structure
• Configurable test styles via base_test.yml
• Template-driven test generation with best practices built-in

🎨 Template System Overhaul

• All templates now use .tmpl suffix for clarity (ADR-030)
• Conditional logic for BDD framework detection
• Custom template functions: oneLine, indent, slice
• Dynamic linter configuration based on project dependencies
• Cross-platform command translation (Make/Taskfile/shell/pre-commit)

🏗️ Architectural Improvements

• Package restructuring: pkg/types → pkg/goboottypes, pkg/utils → pkg/gobootutils
• Secure filesystem model with proper resource cleanup (defer root.Close())
• Path escaping validation to prevent directory traversal
• Explicit dependency injection patterns throughout

📚 Documentation Expansion

• 5 new ADRs (027-031) documenting testing strategy and template policies
• Consolidated and renumbered existing ADRs (28 → 31 total)
• New TESTING.md explaining test architecture
• Third-party architectural validation confirming ADR compliance
• Updated ROADMAP.md reflecting completed milestones

🎭 Intelligent Code Generation

• Makefiles with conditional parallelization (splits targets for 5+ linters)
• Pre-commit hooks with Docker-based tooling
• Linter configs that adapt to project dependencies
• Test templates teaching Go best practices
• Security-conscious defaults (no exec permissions, secret awareness)

---

📊 Quality Metrics

• Test Coverage: 89.9% with race detection
• Linters Enforced: 7 tools (golangci-lint, yamllint, markdownlint, shellcheck, shfmt, checkmake)
• ADRs: 31 documented architectural decisions
• Services: 4 (baseproject, baselint, baselocal, basetest)
• Template Files: 40+ with intelligent conditionals

---

🔄 Breaking Changes

• Package Renaming:
  • pkg/types → pkg/goboottypes (avoids naming conflicts)
  • pkg/utils → pkg/gobootutils (clearer namespacing)
• Template Suffix Policy: All templates now use .tmpl extension
• Config Structure: Minor field adjustments for base_test service

Migration: Projects generated with v0.0.1 remain compatible. Only goboot's internal structure changed.

---

📌 Status

This version completes the pre-alpha foundation (v0.0.x) and positions goboot for CI/CD integration in v0.1.0.

It represents a shift from working tooling to enforced quality standards.

Next up:

• ✅ GitHub Actions CI/CD pipeline (v0.1.0)
• ✅ Structured logging replacement (v0.1.1)
• ✅ Docker support for generated projects (v0.2.0)

---

🎯 Validation

This release has been validated by:

• Multiple independent AI code reviews (Gemini, Claude, Codex)
• Third-party architectural compliance audit
• E2E testing of generated projects
• All quality gates passing (linting, testing, coverage)

Generated projects from goboot v0.0.2 achieve:

• ✅ Zero linter violations on first commit
• ✅ Production-ready architecture patterns
• ✅ Comprehensive documentation

---

📜 Changelog

Commit summary:

feat: v0.0.2 - consolidate tooling, services, and docs
142 files changed, 13852 insertions(+), 820 deletions(-)

Key commits:

• Complete BDD test suite implementation
• base_test service creation
• Template system refactor with .tmpl suffix
• Package restructuring for clarity
• ADR expansion and consolidation
• E2E validation framework

🔗 Links

• Documentation: See /doc directory for ADRs and architecture diagrams
• Issues: [GitHub Issues](https://github.com/it-timo/goboot/issues)

---

This discussion was created from the release feat: v0.0.2 - consolidate tooling, services, and docs (#3).