# Changelog

All notable changes to Gonzo are documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

### [Unreleased](https://github.com/control-theory/gonzo/compare/v0.1.6...HEAD)

#### Added

* Additional documentation and examples
* Enhanced GitBook documentation site

#### Changed

* Improved error messages and user feedback

#### Fixed

* Various bug fixes and stability improvements

### [0.1.6](https://github.com/control-theory/gonzo/releases/tag/v0.1.6) - 2024-08-27

#### Added

* Full screen log viewing with `f` key
* Extended character limit for search and filter (200 chars)
* Increased OTLP receive message size for larger log payloads

#### Changed

* Improved search and filter input handling
* Enhanced OTLP receiver performance

#### Fixed

* Search and filter character limit issues
* OTLP message size limitations

#### Contributors

* @destari - Full screen viewing feature
* @rbg - OTLP message size improvements
* @jon-spyder - Search/filter character limit
* @vine-mxm - Documentation updates

### [0.1.5](https://github.com/control-theory/gonzo/releases/tag/v0.1.5) - 2024-08-24

#### Fixed

* OTLP handling now matches stdin processing
* Improved OTLP log receiver stability

#### Changed

* Unified OTLP and stdin log processing pipeline
* Better error handling for OTLP connections

#### Contributors

* @destari - OTLP handling fixes

### [0.1.4](https://github.com/control-theory/gonzo/releases/tag/v0.1.4) - 2024-08-21

#### Added

* Enhanced pattern extraction with drain3 algorithm
* Improved service distribution tracking
* Better severity-specific pattern analysis

#### Changed

* Optimized pattern detection performance
* Improved Counts modal visualization

#### Fixed

* Pattern extraction accuracy improvements
* Service tracking edge cases

### [0.1.3](https://github.com/control-theory/gonzo/releases/tag/v0.1.3) - 2024-08-15

#### Added

* AI model selection modal (`m` key)
* Support for multiple AI providers (OpenAI, Ollama, LM Studio)
* Automatic model detection and selection
* AI chat mode for interactive log analysis

#### Changed

* Improved AI integration architecture
* Better model compatibility checking
* Enhanced AI response formatting

#### Fixed

* AI provider connection issues
* Model switching stability

### [0.1.2](https://github.com/control-theory/gonzo/releases/tag/v0.1.2) - 2024-08-10

#### Added

* Custom log format support
* Format configuration via YAML files
* Built-in formats for Loki and common log types
* Format auto-detection improvements

#### Changed

* Enhanced log parsing flexibility
* Improved format detection accuracy

#### Fixed

* Format detection edge cases
* Custom format loading issues

### [0.1.1](https://github.com/control-theory/gonzo/releases/tag/v0.1.1) - 2024-08-05

#### Added

* Custom skins/themes support
* Multiple built-in themes (Dracula, Nord, Monokai, etc.)
* Theme configuration via YAML
* ControlTheory branded themes

#### Changed

* Improved color scheme architecture
* Better theme switching performance

#### Fixed

* Theme rendering issues
* Color contrast problems

### [0.1.0](https://github.com/control-theory/gonzo/releases/tag/v0.1.0) - 2024-08-01

#### Added

* Initial public release
* Real-time log analysis TUI
* OTLP receiver (gRPC and HTTP)
* AI-powered log insights
* Pattern detection with drain3
* Word frequency tracking
* Attribute extraction and analysis
* Counts modal with heatmap visualization
* File input with glob support
* Follow mode (tail -f behavior)
* Multiple log format support (JSON, logfmt, plain text)
* Configurable update intervals
* Pause/resume functionality
* Search and filter capabilities
* Vim-style navigation
* Mouse support
* 11+ built-in themes
* Configuration file support

#### Technical Details

* Built with Bubble Tea TUI framework
* Lipgloss for styling
* Cobra for CLI
* Viper for configuration
* OpenTelemetry OTLP support
* Go 1.21+ required

### Version History Summary

| Version | Date       | Highlights                           |
| ------- | ---------- | ------------------------------------ |
| 0.1.6   | 2024-08-27 | Full screen viewing, extended search |
| 0.1.5   | 2024-08-24 | OTLP handling improvements           |
| 0.1.4   | 2024-08-21 | Enhanced pattern extraction          |
| 0.1.3   | 2024-08-15 | AI model selection, multi-provider   |
| 0.1.2   | 2024-08-10 | Custom log formats                   |
| 0.1.1   | 2024-08-05 | Custom skins/themes                  |
| 0.1.0   | 2024-08-01 | Initial release                      |

### Upgrade Notes

#### Upgrading to 0.1.6

**No breaking changes**. New features available immediately:

* Press `f` in log viewer for full screen mode
* Search and filter now support up to 200 characters
* OTLP receiver handles larger messages

#### Upgrading to 0.1.5

**No breaking changes**. OTLP improvements are automatic.

#### Upgrading to 0.1.4

**No breaking changes**. Pattern extraction improvements are automatic.

#### Upgrading to 0.1.3

**New AI features**:

* Press `m` to select AI models
* Automatic model detection for Ollama and LM Studio
* No configuration changes needed

#### Upgrading to 0.1.2

**Custom formats now supported**:

* Place format files in `~/.config/gonzo/formats/`
* Use `--format=name` to specify custom format
* See documentation for format syntax

#### Upgrading to 0.1.1

**Custom skins now supported**:

* Place skin files in `~/.config/gonzo/skins/`
* Use `--skin=name` or set in config file
* See documentation for skin syntax

#### Upgrading to 0.1.0

Initial release - no upgrade path.

### Installation Methods

#### Go Install

```bash
go install github.com/control-theory/gonzo/cmd/gonzo@latest
```

#### Homebrew

```bash
brew tap control-theory/gonzo
brew install gonzo
```

#### Binary Download

Download from [GitHub Releases](https://github.com/control-theory/gonzo/releases)

#### Build from Source

```bash
git clone https://github.com/control-theory/gonzo.git
cd gonzo
make build
```

### Deprecations

No features have been deprecated yet.

### Breaking Changes

No breaking changes in any release to date.

### Known Issues

#### Current Known Issues

* **Custom formats**: Some complex regex patterns may have performance impact
* **OTLP**: Very large batch sizes may cause memory spikes
* **AI**: Rate limiting may occur with high-frequency analysis requests
* **Terminal**: Some older terminals may have limited mouse support

See [GitHub Issues](https://github.com/control-theory/gonzo/issues) for complete list.

### Roadmap

#### Upcoming Features

**Short-term (Next Release)**:

* Performance optimizations for high-volume logs
* Additional built-in log formats
* Enhanced AI prompt templates
* Better error messages

**Medium-term (3-6 months)**:

* Plugin system for custom extensions
* Export and reporting capabilities
* Additional AI provider support
* Advanced filtering DSL

**Long-term (6+ months)**:

* Distributed log analysis
* Web-based interface option
* Log aggregation features
* Enterprise features

See [GitHub Projects](https://github.com/control-theory/gonzo/projects) for detailed roadmap.

### Contributing

We welcome contributions! See:

* Contributing Guidelines
* Development Setup
* [GitHub Issues](https://github.com/control-theory/gonzo/issues)

### Release Process

1. **Version Bump**: Update version in code
2. **Changelog**: Update this file
3. **Tag**: Create git tag (e.g., `v0.1.6`)
4. **Push**: Push tag to GitHub
5. **Build**: GitHub Actions builds binaries
6. **Release**: Automated release creation
7. **Announce**: Community announcement

### Support

* **Documentation**: <https://docs.controltheory.com/gonzo>
* **Issues**: <https://github.com/control-theory/gonzo/issues>
* **Discussions**: <https://github.com/control-theory/gonzo/discussions>
* **Email**: <support@controltheory.com>

### License

Gonzo is licensed under the MIT License. See [LICENSE](https://github.com/control-theory/gonzo/blob/main/LICENSE) for details.

### Credits

#### Core Team

* [ControlTheory](https://github.com/control-theory) - Development and maintenance

#### Contributors

Thanks to all contributors! See [Contributors](https://github.com/control-theory/gonzo/graphs/contributors) for complete list.

#### Special Thanks

* [Charm](https://charm.sh/) - Bubble Tea, Lipgloss, Bubbles
* [OpenTelemetry](https://opentelemetry.io/) - OTLP specification
* [k9s](https://k9scli.io/) - TUI inspiration
* Community contributors and users

### Archive

For historical versions before 0.1.0, see the [Git history](https://github.com/control-theory/gonzo/commits/main).

***

### Changelog Format

This changelog follows these conventions:

* **Added**: New features
* **Changed**: Changes to existing functionality
* **Deprecated**: Soon-to-be removed features
* **Removed**: Removed features
* **Fixed**: Bug fixes
* **Security**: Security fixes

**Version Format**: `MAJOR.MINOR.PATCH`

* **MAJOR**: Breaking changes
* **MINOR**: New features (backward compatible)
* **PATCH**: Bug fixes (backward compatible)

***

{% hint style="info" %}
**Stay Updated**: Watch the [GitHub repository](https://github.com/control-theory/gonzo) to be notified of new releases.
{% endhint %}

{% hint style="success" %}
**Latest Version**: Check [Releases](https://github.com/control-theory/gonzo/releases) for the most recent version and download links.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.controltheory.com/backup/changelog.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
