Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[Unreleased]

Added

  • Comprehensive test suite with pytest
  • Structured logging system with rotating file handlers
  • Configuration file support (.prrc)
  • Token and cost tracking across sessions
  • Session persistence (save/load/export)
  • CI/CD pipeline with GitHub Actions
  • Custom exception hierarchy
  • Plugin system for custom tools
  • Multiple output formats (text, JSON, structured)
  • Input validation system
  • Progress indicators for long operations
  • Pre-commit hooks configuration
  • Comprehensive documentation (README, CONTRIBUTING, CHANGELOG)
  • Version flag (--version)
  • Better help text with examples
  • Session management commands
  • Usage statistics tracking

Changed

  • Improved argument parser with better help text
  • Enhanced error handling throughout codebase
  • Modular architecture with clear separation of concerns

Fixed

  • N/A (initial professional release)

[1.0.0] - 2025-01-XX

Added

  • Initial release with core functionality
  • Interactive and single-message modes
  • Autonomous execution mode
  • 16 built-in tools (filesystem, command, web, database, Python)
  • OpenRouter API integration
  • Context window management with summarization
  • Markdown rendering with syntax highlighting
  • Tool call visualization
  • Command history with readline
  • File versioning in SQLite database
  • Multiple context file support
  • Environment variable configuration
  • Model switching support
  • Verbose mode
  • API mode for specialized interaction

Core Features

  • Assistant Core: Main orchestrator with REPL loop
  • API Communication: OpenRouter integration with streaming
  • Tool System: Parallel execution with ThreadPoolExecutor
  • Autonomous Mode: Max 50 iterations with completion detection
  • Context Management: Automatic compression at 30 message threshold
  • UI Components: ANSI colors, markdown rendering, fancy displays

Tools Included

  • File Operations: read, write, list, mkdir, chdir, getpwd, index
  • Commands: run_command, run_command_interactive
  • Web: http_fetch, web_search, web_search_news
  • Database: db_set, db_get, db_query
  • Python: python_exec with persistent context

Configuration

  • Default model: x-ai/grok-code-fast-1
  • Temperature: 0.7
  • Max tokens: 8096
  • Context threshold: 30 messages
  • Max autonomous iterations: 50

Version History

Version Numbering

  • Major (X.0.0): Breaking changes
  • Minor (1.X.0): New features, backwards compatible
  • Patch (1.0.X): Bug fixes, backwards compatible

Release Schedule

  • Major releases: As needed for breaking changes
  • Minor releases: Monthly or when significant features are ready
  • Patch releases: As needed for bug fixes

Migration Guides

Upgrading to 1.0.0

This is the initial professional release. If upgrading from development version:

  1. Install with pip install -e .
  2. Run pr --create-config to generate configuration file
  3. Set OPENROUTER_API_KEY environment variable
  4. Existing data in ~/.assistant_db.sqlite will continue to work

Deprecation Notices

None currently.

Known Issues

None currently.

Future Releases

Planned for 2.0.0

  • Multi-model conversations
  • Enhanced plugin API with hooks
  • Web UI dashboard
  • Team collaboration features

Under Consideration

  • Docker containerization
  • Cloud deployment options
  • IDE integrations
  • Advanced code analysis tools

Legend:

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