🎉 AINative Code v0.1.12

Release Date: 2026-01-14
Status: Production-Ready

📋 Executive Summary

This release includes a comprehensive Bubble Tea UI/UX refactor (Phase 1-3), significant test coverage improvements (55.4% → 76.7%), and 3 bug fixes discovered during user acceptance testing.

Key Highlights:

• ✨ 43 new files, 16 files modified (~31,000 lines impacted)
• 🧪 607 new tests added (total: 746 tests, 100% pass rate)
• 📈 Test coverage improved by 21.3% (now 76.7% average)
• 🐛 3 bugs fixed and verified
• 🎨 Complete UI/UX component system
• 🔄 Zero breaking changes

✨ What's New

Phase 1: Foundation (Issues #131-#133)

Component Interface System

• 14 core interfaces (Component, Sizeable, Focusable, Stateful, etc.)
• 8 popup component interfaces
• Lifecycle management system
• NON-BREAKING: Wrapper-based implementation

Layout Abstraction System

• LayoutManager with constraint-based positioning
• BoxLayout (vertical/horizontal)
• ResponsiveLayout with breakpoints (<40, 40-80, 80-100, 100+)
• Replaced all hard-coded magic numbers (no more height - 4)

Dialog System

• Stack-based modal management (LIFO behavior)
• 3 dialog types: ConfirmDialog, InputDialog, SelectDialog
• Layer-based rendering with lipgloss
• Z-index support and focus management

Phase 2: Enhancement (Issues #134-#136)

Animation System

• 60 FPS physics-based animations using harmonica
• AnimatedComponent wrapper for any component
• Smooth transitions with configurable spring physics

Advanced Modal Features

• Backdrop styles (blur, dim, solid, custom)
• Focus trap for keyboard navigation
• Close on ESC/backdrop click
• Max width/height constraints

Golden Test Framework

• Snapshot testing for UI regression detection
• 48 golden tests (100% pass rate)
• UPDATE_GOLDEN environment variable support

Phase 3: Polish (Issues #137-#139)

Theme System

• 3 built-in themes (AINative, Dark, Light)
• Hot-reload theme switching
• 50+ semantic colors
• ThemeManager with listener notifications
• Theme persistence

Toast Notification System

• Queue-based notification management
• 4 toast types (Info, Success, Warning, Error)
• Auto-dismiss with configurable timeouts
• Position support (top-right, top-left, bottom-right, bottom-left)
• Animated entry/exit with opacity

Advanced Components

• DraggableComponent (mouse + keyboard)
• ResizableComponent (8-direction handles)
• SplitView (horizontal/vertical with drag divider)
• MultiColumnLayout (multi-pane with focus management)

🐛 Bug Fixes

Bug #1: Double "v" in Version Display

Issue: Version command showed "vv0.1.11" instead of "v0.1.11"
Fix: Added strings.TrimPrefix() in internal/cmd/version.go
Impact: Clean version display across all output formats
Commit: a6a3bec

Bug #2: Empty Config Keys Displayed

Issue: Config list showed malformed empty/whitespace-only keys
Fix: Added validation to skip empty keys in internal/cmd/config_masking.go
Impact: Clean config output without confusing empty entries
Commit: 930db55

Bug #3: Missing --name Flag Alias

Issue: Users expected --name flag but only --title was available
Fix: Added --name as full alias with precedence handling in internal/cmd/session.go
Impact: Improved UX while maintaining backward compatibility
Commit: 2c63419

🧪 Test Coverage Improvements

Before vs After

Test Statistics

• New Tests Added: 607 tests
• Total Tests: 746 tests
• Pass Rate: 100% (746/746)
• Test Code Volume: ~6,500 new lines
• Test Files Created: 7 new files
• Test Files Modified: 4 existing files

Key Improvements

• Fixed 9 compilation errors blocking test suite
• Added comprehensive toast tests (102 new tests)
• Added animation, lifecycle, and edge case tests (398 new tests)
• Added dialog View() and keyboard navigation tests (89 new tests)
• Added theme style generation and error handling tests (18 new tests)

📚 Documentation

New Documentation Files

• BUBBLETEA_UI_UX_GAP_ANALYSIS.md (27KB) - VS Crush comparison
• DEEP_CODEBASE_ANALYSIS.md (15KB) - 381 file analysis
• TEST_COVERAGE_REPORT.md (11KB) - Initial coverage analysis
• FINAL_TEST_COVERAGE_REPORT.md (12KB) - Complete coverage report
• BUGS_FOUND_UAT.md (400 lines) - UAT bug report
• BUGS_FIXED_SUMMARY.md (429 lines) - Bug fix verification

🔄 Breaking Changes

None. This release maintains 100% backward compatibility with v0.1.11.

📦 Migration Guide

No migration required. All changes are additive and non-breaking.

🙏 Acknowledgments

Built by AINative Studio with 5 parallel AI agents:

• Agent 1: Fixed broken test suite
• Agent 2: Improved toast package coverage
• Agent 3: Improved components package coverage
• Agent 4: Improved dialogs package coverage
• Agent 5: Improved theme package coverage

📊 Full Changelog

Features:

• feat: add Component interface system for TUI elements (b632072)
• feat: add dialog system with stack management (aef227a)
• feat: integrate dialog system with TUI (2e8ebd4)
• feat: add layout abstraction system (c1056be)
• feat: add advanced modal manager with z-index and focus trapping (2441d4b)
• feat: add animation component wrapper for smooth 60 FPS animations (e0b9822)
• feat: add centralized theme system with hot-reload switching (715cb36)
• feat: add advanced components (draggable, resizable, splitview) (5f504e6)
• feat: add toast/notification system with queue management (2ff9181)
• feat: add --name alias for --title in session create (2c63419)

Bug Fixes:

• fix: resolve 9 test compilation errors in internal/tui (901a34b)
• fix: remove double-v prefix in version display (a6a3bec)
• fix: skip empty/whitespace config keys in list command (930db55)

Tests:

• test: comprehensive user acceptance testing for v0.1.11 (dcc83f4)
• test: add golden test framework for UI regression detection (fef5373)
• test: improve theme package coverage from 62.9% to 91.4% (46dde4b)
• test: improve dialogs package coverage to 75.5% (3c2f303)
• test: improve toast package coverage from 47.4% to 81.5% (2b32a5d)
• test: improve components package coverage from 46.1% to 64.9% (654015c)

Documentation:

• docs: add Phase 1 & 2 analysis and implementation documentation (7f77ce3)
• docs: add comprehensive theme system documentation (1c2cea4)
• docs: add comprehensive theme system demo and showcase (c0a0b65)
• docs: add comprehensive test coverage reports (b1c2645)
• docs: add UAT bug report - 3 minor bugs found (a2453c9)
• docs: add comprehensive bug fix summary report (dd6a999)

🚀 Installation

```bash

Download from releases

Or build from source:

git clone https://github.com/AINative-Studio/ainative-code.git
cd ainative-code
git checkout v0.1.12
make build
```

Full Diff: v0.1.11...v0.1.12

AINative Code v0.1.11

Welcome to this new release of AINative Code!

Changelog

Bug Fixes

• a7d7af0: fix: v0.1.11 - Complete JSON functionality fixes (#127, #128, #129) ( <>)

Installation

Quick Install (Linux/macOS)

curl -fsSL https://raw.githubusercontent.com/AINative-Studio/ainative-code/main/install.sh | bash

Quick Install (Windows PowerShell)

irm https://raw.githubusercontent.com/AINative-Studio/ainative-code/main/install.ps1 | iex

Homebrew (macOS/Linux)

brew tap ainative-studio/tap
brew install ainative-code

Manual Installation

1. Download the appropriate archive for your platform from the assets below
2. Extract the archive
3. Move the binary to a directory in your PATH
4. Verify the installation: ainative-code version

Full Changelog: v0.1.10...v0.1.11

AINative Code v0.1.10 - Critical CGO Fix + JSON Output

🚨 Critical Bug Fix

SQLite/CGO Issue Resolved

Problem: v0.1.9 binaries were built with CGO_ENABLED=0, which completely broke all SQLite functionality. All session-related commands failed with:

Binary was compiled with 'CGO_ENABLED=0', go-sqlite3 requires cgo to work

Solution:

• ✅ Fixed Makefile to enable CGO for SQLite-dependent builds
• ✅ All session commands now work correctly
• ✅ Documented CGO cross-compilation limitations

Impact: This was a blocker bug that made v0.1.9 unusable for session management.

✨ New Feature

#124 - Session List JSON Output

Added --json flag to session list command for machine-readable output, consistent with session search --json.

Use Cases:

• ✅ Scripting and automation
• ✅ Piping to jq for filtering
• ✅ Integration with other tools
• ✅ CI/CD pipelines

Examples:

# Output as JSON
ainative-code session list --json

# Pipe to jq for filtering
ainative-code session list --json | jq '.[0].id'

# Get all sessions as JSON
ainative-code session list --all --json

# Count total sessions
ainative-code session list --all --json | jq '. | length'

JSON Structure:

[
  {
    "id": "abc123...",
    "name": "My Session",
    "created_at": "2026-01-11T10:00:00Z",
    "updated_at": "2026-01-11T10:30:00Z",
    "status": "active",
    "settings": {...}
  }
]

📦 Available Binaries

Note: Due to CGO requirements for SQLite, cross-platform builds require proper toolchains. Currently providing:

• ✅ macOS Intel (darwin/amd64)
• ✅ macOS Apple Silicon (darwin/arm64)

For other platforms (Linux, Windows), please build from source with CGO enabled. See docs/BUILD_NOTES_CGO.md for details.

📊 Changes Summary

Files Changed: 6
Critical Fixes: 1 (CGO/SQLite)
Features Added: 1 (JSON output)
Tests Added: 1 integration test suite
Documentation: 2 new docs

🔧 Building from Source

# Clone repository
git clone https://github.com/AINative-studio/ainative-code.git
cd ainative-code

# Build (CGO enabled by default)
make build

# The binary will be in ./build/ainative-code

📚 Full Changelog

See CHANGELOG.md for complete details.

⚠️ Important Notes

1. v0.1.9 users: Please upgrade immediately - v0.1.9 had broken SQLite functionality
2. Cross-platform builds: Requires proper CGO toolchains - see documentation
3. Backward compatibility: 100% compatible with existing configurations

🤖 Generated with Claude Code

AINative Code v0.1.9 - Critical Bug Fixes

This release resolves 9 critical bug issues reported by testers, improving setup wizard reliability, configuration consistency, command usability, and input validation.

🔥 Critical/P0 Fixes

#117 - Setup Wizard Model Validation

• Fixed: Setup wizard offering outdated Claude 3.5 models that chat command rejects
• Updated: Now uses Claude 4.5 models (sonnet-4-5-20250929, haiku-4-5-20251001, opus-4-1)
• Default: Set to latest recommended model (claude-sonnet-4-5-20250929)
• Tests: 9 comprehensive tests for model synchronization
• Impact: Setup now completes successfully and chat works immediately ✅

⚡ P1/High Priority Fixes

#125 - ZeroDB Config Path Mismatch

• Fixed: Configuration path inconsistency between setup wizard and ZeroDB commands
• Standardized: All paths now use services.zerodb.*
• Environment: Updated to AINATIVE_CODE_SERVICES_ZERODB_* format
• Tests: 8 integration tests for end-to-end validation
• Impact: Setup → ZeroDB commands workflow now works seamlessly ✅

#120 - MCP Server Persistence

• Fixed: MCP servers not being persisted to disk
• Implementation: Persistent storage with ~/.mcp.json configuration file
• Features: Atomic writes with rollback mechanism for data integrity
• Tests: 65 comprehensive tests (51 unit + 14 integration)
• Impact: Servers survive application restarts ✅

🔧 Medium Priority Fixes

#126 - Meta Llama Provider Validation

• Added: Meta Llama to supported provider validation
• Implementation: ValidateMetaLlamaKey() method with API key validation
• Support: Both "meta_llama" and "meta" provider aliases
• Impact: All 5 providers now have consistent validation ✅

#122 - Config Validation Provider Check

• Fixed: Config validate checking wrong provider field
• Updated: Now validates llm.default_provider (new structure)
• Support: All 8 providers (anthropic, openai, google, bedrock, azure, ollama, meta_llama, meta)
• Compatibility: Maintained backward compatibility with legacy root provider field
• Tests: 13 comprehensive test cases
• Impact: Validation passes after successful setup ✅

#121 - Flag Naming Inconsistency

• Standardized: All file operations now use -f, --file flag
• Backward Compatible: Old -o, --output flag still works with deprecation warnings
• Updated Commands: rlhf export, design extract, design generate, session export
• Enhanced: Added file input flag to design validate command
• Tests: 28 integration tests for flag standardization
• Impact: Consistent and intuitive command interface ✅

🐛 Low Priority Fixes

#119 - Chat Empty Message Validation

• Added: Local validation for empty chat messages before API calls
• Performance: 500x faster error response (<1ms vs ~500ms)
• Coverage: Catches empty strings, whitespace, tabs, newlines, mixed whitespace
• Tests: 10 comprehensive tests
• Impact: Better UX and reduced API costs ✅

#123 - Session List Negative Limit Validation

• Added: Validation for session list limit parameter
• Validation: Rejects negative and zero limit values with clear error
• Tests: Comprehensive unit and E2E tests
• Impact: Prevents potential performance issues ✅

#110 - Config File Existence Validation

• Added: Validation for explicitly provided config files
• Behavior: Validates file existence and type when --config flag is used
• Messages: Clear error messages for missing files or directories
• Compatibility: Maintains graceful fallback for default config paths
• Tests: 13 comprehensive tests
• Impact: Better debugging and user experience ✅

📊 Statistics

• Issues Fixed: 9/9 (100%)
• Files Changed: 61 files
• Code Added: 11,152 insertions, 111 deletions
• Tests Added: 200+ new tests
• Test Pass Rate: 100%
• Breaking Changes: 0 (all backward compatible)
• Documentation: 25+ comprehensive fix reports and guides

🚀 Upgrade Instructions

# Pull latest changes
git pull origin main

# Or download the release binary for your platform
# All existing configurations are fully compatible

📚 Full Changelog

See CHANGELOG.md for complete details.

🙏 Credits

Special thanks to all testers who reported these issues!

🤖 Generated with Claude Code

AINative Code v0.1.8

Welcome to this new release of AINative Code!

Changelog

Bug Fixes

• 46c5c09: fix: MCP command improvements with production API tests (issues #108, #107) ( <>)
• 544d0dd: fix: add validation to reject empty/invalid config keys (issue #113) ( <>)
• 6e98ee7: fix: config reading from nested format after setup wizard (issue #96) ( <>)
• 8e69292: fix: enhanced error message for session search command (issue #111) ( <>)
• d7ce145: fix: implement file writing for RLHF export with multiple formats (issue #114) ( <>)
• 05fc9b5: fix: implement file writing for design export and add path validation (issues #114, #109) ( <>)
• 35a52cf: fix: prevent crash from empty/whitespace session search queries (issue #111) ( <>)
• 4dc5514: fix: setup wizard enhancements with production API verification (issues #105, #103, #116) ( <>)
• 0483acd: fix: update auth endpoints to use production API (issue #115) ( <>)
• 1e44a7d: fix: update to Claude 4.5 models and improve error handling (issue #112) ( <>)

Documentation

• e7b7dee: docs: add comprehensive fix reports and test scripts for all issues ( <>)

Installation

Quick Install (Linux/macOS)

curl -fsSL https://raw.githubusercontent.com/AINative-Studio/ainative-code/main/install.sh | bash

Quick Install (Windows PowerShell)

irm https://raw.githubusercontent.com/AINative-Studio/ainative-code/main/install.ps1 | iex

Homebrew (macOS/Linux)

brew tap ainative-studio/tap
brew install ainative-code

Manual Installation

1. Download the appropriate archive for your platform from the assets below
2. Extract the archive
3. Move the binary to a directory in your PATH
4. Verify the installation: ainative-code version

Full Changelog: v0.1.7...v0.1.8

AINative Code v0.1.7

Welcome to this new release of AINative Code!

Changelog

Bug Fixes

• 38b1eb7: fix: update version to 0.1.7 ( <>)

Installation

Quick Install (Linux/macOS)

curl -fsSL https://raw.githubusercontent.com/AINative-Studio/ainative-code/main/install.sh | bash

Quick Install (Windows PowerShell)

irm https://raw.githubusercontent.com/AINative-Studio/ainative-code/main/install.ps1 | iex

Homebrew (macOS/Linux)

brew tap ainative-studio/tap
brew install ainative-code

Manual Installation

1. Download the appropriate archive for your platform from the assets below
2. Extract the archive
3. Move the binary to a directory in your PATH
4. Verify the installation: ainative-code version

Full Changelog: v0.1.6...v0.1.7

AINative Code v0.1.6

Welcome to this new release of AINative Code!

Changelog

Features

• f096003: feat: add Meta Llama API support and fix setup --force flag (v0.1.5) ( <>)
• d24ace4: feat: implement critical UX improvements to match Crush CLI ( <>)

Bug Fixes

• 092df36: fix: resolve 10 critical issues and add UX gap analysis ( <>)

Installation

Quick Install (Linux/macOS)

curl -fsSL https://raw.githubusercontent.com/AINative-Studio/ainative-code/main/install.sh | bash

Quick Install (Windows PowerShell)

irm https://raw.githubusercontent.com/AINative-Studio/ainative-code/main/install.ps1 | iex

Homebrew (macOS/Linux)

brew tap ainative-studio/tap
brew install ainative-code

Manual Installation

1. Download the appropriate archive for your platform from the assets below
2. Extract the archive
3. Move the binary to a directory in your PATH
4. Verify the installation: ainative-code version

Full Changelog: v0.1.4...v0.1.6

AINative Code v0.1.4

Welcome to this new release of AINative Code!

Changelog

Bug Fixes

• 843855a: fix: resolve 10 critical issues and MCP test failures for v0.1.4 ( <>)

Installation

Quick Install (Linux/macOS)

curl -fsSL https://raw.githubusercontent.com/AINative-Studio/ainative-code/main/install.sh | bash

Quick Install (Windows PowerShell)

irm https://raw.githubusercontent.com/AINative-Studio/ainative-code/main/install.ps1 | iex

Homebrew (macOS/Linux)

brew tap ainative-studio/tap
brew install ainative-code

Manual Installation

1. Download the appropriate archive for your platform from the assets below
2. Extract the archive
3. Move the binary to a directory in your PATH
4. Verify the installation: ainative-code version

Full Changelog: v0.1.3...v0.1.4

AINative Code v0.1.3

Welcome to this new release of AINative Code!

Changelog

Bug Fixes

• d5af241: fix: resolve setup wizard keyboard input and install script PATH issues ( <>)

Installation

Quick Install (Linux/macOS)

curl -fsSL https://raw.githubusercontent.com/AINative-Studio/ainative-code/main/install.sh | bash

Quick Install (Windows PowerShell)

irm https://raw.githubusercontent.com/AINative-Studio/ainative-code/main/install.ps1 | iex

Homebrew (macOS/Linux)

brew tap ainative-studio/tap
brew install ainative-code

Manual Installation

1. Download the appropriate archive for your platform from the assets below
2. Extract the archive
3. Move the binary to a directory in your PATH
4. Verify the installation: ainative-code version

Full Changelog: v0.1.2...v0.1.3

AINative Code v0.1.2

Welcome to this new release of AINative Code!

Changelog

Bug Fixes

• 2b7a3c5: fix: resolve issues #89, #90, #91 ( <>)

Installation

Quick Install (Linux/macOS)

curl -fsSL https://raw.githubusercontent.com/AINative-Studio/ainative-code/main/install.sh | bash

Quick Install (Windows PowerShell)

irm https://raw.githubusercontent.com/AINative-Studio/ainative-code/main/install.ps1 | iex

Homebrew (macOS/Linux)

brew tap ainative-studio/tap
brew install ainative-code

Manual Installation

1. Download the appropriate archive for your platform from the assets below
2. Extract the archive
3. Move the binary to a directory in your PATH
4. Verify the installation: ainative-code version

Full Changelog: v0.1.1...v0.1.2