0.6.3

What's Changed

• Experiments with programmatic agent documentation by @jeremiah-k in #121
• Initialization Enhancements by @jeremiah-k in #124

Full Changelog: 0.6.2...0.6.3

0.6.2

What's Changed

• 🔧 Fix broken links and inconsistencies in usage guide, snapshot system work by @jeremiah-k in #115
• Docs: General housekeeping and code cleanup for v0.6.2-dev by @jeremiah-k in #116
• Pre-release cleanup (0.6.2) by @jeremiah-k in #118

Full Changelog: 0.6.1...0.6.2

0.6.1

What's Changed

• Fix external tool integration by @jeremiah-k in #111
• External Integration & Unified Memory Architecture (WIP) by @jeremiah-k in #112

Full Changelog: 0.6.0...0.6.1

0.6.0

What's Changed

• Update usage-guide.md by @jeremiah-k in #102
• Update usage-guide.md by @jeremiah-k in #103
• Docs cleanup (hotkeys/roles) by @jeremiah-k in #104
• Add function reference tool - Terminology refactor by @jeremiah-k in #105
• 🔥 Remove terrible hotkey references - focus on core value by @jeremiah-k in #107
• 🔒 AGOR v0.6.0: Security-First Release with Single Memory Branch Architecture by @jeremiah-k in #108

Full Changelog: 0.5.1...0.6.0

0.5.1

See individual PRs and commits for detailed notes on changes.

What's Changed

• Dev tooling upgrades, documentation updates by @jeremiah-k in #98
• Trunk fixes by @jeremiah-k in #99

Full Changelog: 0.5.0...0.5.1

0.5.0

Big changes. See updated documentation and individual PR's and commits for details.

What's Changed

• Prepare for 0.5.0 - Refactor dev tooling and update documentation by @jeremiah-k in #93
• 🎯 AGOR 0.5.0 Pre-Release: Agent Workflow Optimization & Critical Architecture Education by @jeremiah-k in #95

Full Changelog: 0.4.4...0.5.0

0.4.4

What's Changed

• Memory branches now only contain .agor files by @jeremiah-k in #88

Full Changelog: 0.4.3...0.4.4

0.4.3

🚀 AGOR v0.4.3 Release Notes

📋 Overview

AGOR v0.4.3 represents a major refactoring and safety improvement release, addressing critical review findings and implementing comprehensive architectural improvements for better multi-agent coordination.

✨ Major Features

🛡️ Git Safety System

• New safe_git_push() function with comprehensive safety checks
• Protected branch validation - prevents force pushes to main/master/develop/production
• Upstream change detection - fetches and validates before pushing
• Explicit force confirmation - requires double confirmation for dangerous operations
• Enhanced error handling - detailed safety messaging and graceful failures

🏗️ Simplified Memory Branch Architecture

• Replaced complex orphan branches with simple 1-commit-behind-HEAD approach
• Easier navigation - memory branches now related to working branches
• Better performance - faster branch creation and switching
• Merge prevention - 1 commit behind prevents accidental merges
• Simpler logic - no complex empty tree creation required

🧩 Modular Development Tooling

• Broke down massive 2500+ line dev_tooling.py into focused modules:
  • git_operations.py - Safe git operations and timestamp utilities
  • memory_manager.py - Cross-branch memory commits and branch management
  • agent_handoffs.py - Agent coordination and handoff utilities
  • dev_testing.py - Testing utilities and environment detection
• 100% backward compatibility - all existing functions still work
• Enhanced organization - better maintainability and separation of concerns

👥 Enhanced Role System

• Simplified from 3 roles to 2 - Worker Agent + Project Coordinator
• Enhanced Project Coordinator role with strategic oversight emphasis
• Added code review responsibilities as core PC function
• Clear delegation model - PC focuses on oversight, not direct execution
• Updated all documentation consistently across the platform

🔧 Technical Improvements

Git Operations

• Cross-platform git detection using shutil.which() instead of manual subprocess
• Proper UTC timestamps - fixed local time issues in timestamp functions
• Remote branch detection - handles first push scenarios with --set-upstream
• "Nothing to commit" handling - treats clean working directory as success
• Environment variable support - git commands can use custom environments

Memory Management

• Fixed file descriptor handling - proper os.fdopen() usage
• Custom git index support - temporary index files for isolated operations
• Enhanced error handling - graceful fallback and transparent operation
• Cross-branch commits - commit to memory branches without switching
• Validated isolation - .agor directory only exists on memory branches

Agent Coordination

• Dynamic version detection - no more hardcoded version numbers
• Current branch detection - adapts to any branch name automatically
• Improved import handling - absolute imports for better reliability
• Input validation - robust parameter checking for handoff functions
• Clean unused imports - removed datetime and Optional where unused

📚 Critical Documentation Fixes

Memory Branch System Clarification

• Fixed major misunderstanding - .agor directory only exists on memory branches
• Updated all documentation to reflect dev tooling-only access
• Added temporary file cleanup guidelines for agents
• Command chaining recommendations to minimize tool calls

Multi-Agent Protocols

• Enhanced communication protocols with proper memory branch usage
• Updated session initialization to use dev tooling functions
• Improved handoff generation with automatic cleanup requirements
• Better coordination workflows using memory-based state management

Code Quality Improvements

• Fixed inverted git detection logic - proper success/failure handling
• Removed redundant git binary detection - centralized in run_git_command
• Fixed f-string without interpolation - removed unnecessary f prefix
• Improved augment detection - using importlib.util.find_spec
• Enhanced error handling - removed unnecessary else after return
• Fixed markdown formatting - proper heading syntax and en dashes
• URL formatting - wrapped bare URLs in angle brackets

🐛 Bug Fixes

Critical Fixes

• Fixed git detection logic inversion - proper success/failure handling in dev_testing.py
• Fixed file descriptor usage - proper os.fdopen() in memory_manager.py
• Fixed environment variable passing - git commands now use custom env properly
• Fixed hardcoded version numbers - dynamic detection in agent_handoffs.py
• Fixed import paths - absolute imports for better reliability

Quality Fixes

• Removed unused imports - datetime, tempfile, os where not needed
• Fixed f-string without interpolation - removed unnecessary f prefix
• Improved augment detection - using importlib.util.find_spec instead of try/except
• Enhanced input validation - robust parameter checking in handoff functions
• Fixed markdown formatting - proper heading syntax and en dash usage
• Fixed URL formatting - wrapped bare URLs in angle brackets

🧪 Comprehensive Testing

Memory System Validation

• ✅ Memory branches created automatically (1 commit behind HEAD)
• ✅ Cross-branch commits work without switching working branch
• ✅ .agor directory isolation - only exists on memory branches, never working branch
• ✅ Working directory remains clean - memory operations fully isolated
• ✅ Dev tooling provides seamless access to memory system
• ✅ Memory recall functionality working correctly

Quality Assurance

• All new modules tested and working correctly
• Backward compatibility verified - existing code unchanged
• Git safety tested with comprehensive scenarios
• Memory operations validated with new architecture
• Import functionality confirmed in all environments
• Documentation accuracy verified - .agor system properly explained

🎯 Benefits Achieved

1. Enhanced Safety - No more dangerous git operations without explicit confirmation
2. Better Architecture - Simplified memory branch management
3. Improved Coordination - Enhanced Project Coordinator role with code review
4. Better Maintainability - Modular code organization
5. Preserved Compatibility - Zero breaking changes to existing workflows
6. Clarified System - Proper understanding of memory branch isolation
7. Better Practices - Guidelines for clean temporary file usage
8. Higher Code Quality - Fixed numerous issues and improved robustness
9. Validated Functionality - Comprehensive testing confirms all systems working

📁 Files Changed

New Modules

• src/agor/tools/git_operations.py - Git safety and operations
• src/agor/tools/memory_manager.py - Memory branch management
• src/agor/tools/agent_handoffs.py - Agent coordination utilities
• src/agor/tools/dev_testing.py - Testing and environment detection

Updated Files

• src/agor/tools/dev_tooling.py - Modular imports with backward compatibility
• docs/multi-agent-protocols.md - Enhanced PC role, fixed .agor documentation
• src/agor/tools/README_ai.md - Updated role descriptions
• src/agor/tools/AGOR_INSTRUCTIONS.md - Simplified to 2-role system, fixed URL formatting
• docs/agor-development-log.md - Comprehensive v0.4.3 development entry
• docs/agor-development-guide.md - Fixed heading syntax
• pyproject.toml & src/agor/__init__.py - Version bump to 0.4.3

⚠️ Breaking Changes

None - All existing functionality preserved through backward compatibility layers.

🚀 Migration Guide

No migration required - all existing AGOR workflows continue to work unchanged. New safety features and modular organization are automatically available.

🔍 Critical Notes

IMPORTANT: This release fixes a critical documentation error. The .agor directory does NOT exist on main or feature branches. It only exists on dedicated memory branches and is accessed exclusively through dev tooling functions.

MEMORY SYSTEM: Comprehensive testing confirms the memory system is working perfectly:

• Memory branches are created automatically when needed
• Cross-branch commits work without switching working branch
• Working directory isolation is maintained
• Dev tooling provides seamless access to memory functionality

🎉 What's Next

This release provides a solid foundation for:

• Enhanced agent coordination workflows
• Safer development operations
• Better code organization and maintainability
• Improved multi-agent collaboration
• Proper memory branch system usage
• Higher code quality and robustness

---

Ready for production use - Comprehensive testing completed, all objectives achieved, critical documentation corrected, memory system validated, and code quality significantly improved.

What's Changed

• Restore AugmentCode Local Agents initialization prompt in usage guide by @jeremiah-k in #85
• 🚀 AGOR Comprehensive Refactoring and Safety Improvements by @jeremiah-k in #86

Full Changelog: 0.4.2...0.4.3

0.4.2

🚧 Under construction 🚧

We're still trying to figure out what works and what doesn't for the dev tooling, so be warned some functionality might be broken.

What's Changed

• Fix Readme & Usage Guide by @jeremiah-k in #79
• Update README.md by @jeremiah-k in #80
• Enhanced AGOR Agent Handoff System + File-Free Output Generation by @jeremiah-k in #81
• Trunk Fixes by @jeremiah-k in #83

Full Changelog: 0.4.1...0.4.2

0.4.1

🚧 Under construction 🚧

We're still trying to figure out what works and what doesn't for the dev tooling, so be warned some functionality might be broken.

What's Changed

• Update documentation, formatting, and code style in Python modules to update docstrings by @jeremiah-k in #73
• AGOR Memory Manager Fixes and Documentation Optimization by @jeremiah-k in #76
• Trunk autofixes & cleanup before release by @jeremiah-k in #77

Full Changelog: 0.4.0...0.4.1