Repository navigation
ByteHot 1.3.0 - ByteHot Release
ByteHot 1.3.0
Release Type: stable
Build Date: 2025-06-21 22:36:25 UTC
Commit: 6476d665
Changes: 148 commits from project start
π Quick Start
# Download the agent JAR from this release
java -javaagent:bytehot-1.3.0-agent.jar \
-Dbytehot.watch.paths=target/classes \
-cp target/classes \
com.example.YourApplicationWhat's Changed
π₯ Major Features
-
π [Versioning Strategy] Establish comprehensive milestone-aligned semantic versioning (06653c1) ([Versioning Strategy])\n- π Create revolutionary GitHub Pages site with GETTING_STARTED integration (ae277d1)\n- π [#6C] Complete documentation update for Milestone 6C (5759dd9) (#6, [#6C])\n- π [#2] update journal with milestone 6B completion (3d6e56a) (#2, #2, [#2])\n\n### β Features & Implementation
-
β¨ Add manual trigger support to auto-patch-release workflow (cacdad1)\n- β [Configuration Loading Issue] Fix ByteHotAgent to load actual configuration instead of default (71e1799) ([Configuration Loading Issue])\n- π [Documentation] Add comprehensive automated release system documentation (31cc6a7) ([Documentation])\n- ποΈ [GitHub Actions] Add comprehensive automated release workflows (987aede) ([GitHub Actions])\n- β [Configuration Loading Issue] Fix YAML configuration loading and add bhconfig support (a102687) ([Configuration Loading Issue])\n- π Add comprehensive literate programming docs for core infrastructure classes (d6e00a3)\n- π Add Implementation section and comprehensive literate programming docs (8cda98c)\n- π Update ByteHot story to reflect new documentation and flow detection features (1588f71)\n- π Add comprehensive ByteHot getting started guide in org-mode (c3e3982)\n- π Add comprehensive documentation and newbie guide (bea6695)\n- β [#2] Complete Milestone 6D: Event-Driven Bug Reporting implementation (253085d) (#2, #2, [#2])\n- β [#2] Complete Milestone 6C: User Management Domain (eab02da) (#2, #2, [#2])\n- π§ [#2] Add comprehensive Checker Framework integration (878c29a) (#2, #2, [#2])\n- ποΈ [#2] Reorganize milestone structure: Add Milestone 6E for GitHub Actions setup (8e808f6) (#2, #2, [#2])\n- π [#2] Implement comprehensive flows documentation with index page (71ae00e) (#2, #2, [#2])\n- π [#2] Add comprehensive NVD API diagnostics to security check (f0ba23c) (#2, #2, [#2])\n- β‘ [#2] Add NVD API key support for faster security checks (cf82e5d) (#2, #2, [#2])\n- π Add comprehensive debugging for file copying and org file discovery (4e2df30)\n- π Add -q flag to Maven commands to reduce log verbosity (f143d68)\n- π§ Fix Javadoc generation and org file conversion - add debugging and fallback handling (9b77f85)\n- π§ Fix gh-pages branch creation - add git config and safer file removal (42e0a11)\n- π [#github-actions] Add automated documentation publishing workflows (50bbae6) ([#github-actions])\n- β [#6C] Complete User Management Domain with EventSourcing (686caec) (#6, [#6C])\n- β [#6C] Implement UserStatistics and UserSession value objects (5cf069e) (#6, [#6C])\n- β [#6C] Implement UserPreferences value object with type-safe operations (6c7cfc6) (#6, [#6C])\n- β [#6C] Implement UserProfile value object with immutable operations (d50cbe1) (#6, [#6C])\n- β [#6C] Implement UserId value object with auto-discovery (6925bd3) (#6, [#6C])\n- β [#2] Milestone 6A: Complete EventSourcing Infrastructure (9e5b99b) (#2, #2, [#2])\n- β [#6A] Implement Milestone 6A: Basic EventSourcing Infrastructure (c393a7f) (#6, [#6A])\n- π [#2] Add literate programming documentation for all components (d4ae845) (#2, #2, [#2])\n- π [#2] Update documentation with hexagonal architecture implementation (665c7db) (#2, #2, [#2])\n- β [#2] Integrate hexagonal architecture with JVM agent lifecycle (0cb709d) (#2, #2, [#2])\n- β [#2] Implement dynamic adapter discovery in application layer (5586fc0) (#2, #2, [#2])\n- β [#2] Enhance Ports registry with singleton pattern and resolution (d1e8181) (#2, #2, [#2])\n- β [#2] Implement hexagonal architecture adapters (09d15ce) (#2, #2, [#2])\n- β [#2] Implement comprehensive rollback functionality for failed operations (4801108) (#2, #2, [#2])\n- β [#2] Implement comprehensive error recovery framework (ErrorRecoveryManager + supporting classes) (ead8cf8) (#2, #2, [#2])\n- β [#2] Implement comprehensive error handling framework (11ac237) (#2, #2, [#2])\n- β [#2] Implement FrameworkIntegration for Spring-style factory patterns (96a1229) (#2, #2, [#2])\n- β [#2] Implement StatePreserver with reflection-based state management (1c66538) (#2, #2, [#2])\n- β [#2] Implement InstanceUpdateException for comprehensive error handling (2cf434b) (#2, #2, [#2])\n- β [#2] Implement InstanceUpdater with multiple update strategies (bbec0ea) (#2, #2, [#2])\n- β [#2] Implement InstanceTracker with thread-safe weak reference management (d680e62) (#2, #2, [#2])\n- β [#2] Implement InstancesUpdated domain event with comprehensive metrics (ba78a99) (#2, #2, [#2])\n- β [#2] Implement InstanceUpdateMethod enum with 5 update strategies (fb80d7d) (#2, #2, [#2])\n- π§ Add .gitignore to prevent target/ files from being committed (78ac3f0)\n- Added Nix flake to easily choose the JVM to use (9d9502f)\n- β [#2] Implement WatchPathConfigured event and configuration loading logic (82a00d4) (#2, #2, [#2])\n- β [#2] Implement ByteHot agent that prints ByteHotAgentAttached event (05c95fb) (#2, #2, [#2])\n- β [#2] implement configuration loading and folder watching (8caa62a) (#2, #2, [#2])\n- Added Ports design (bca1695)\n\n### π§ͺ Tests & Validation
-
π§ Fix auto-patch workflow test execution by targeting bytehot module (3eec86f)\n- π§ Fix YAML configuration format in WatchPathConfiguredTest (27cdab7)\n- π§ Fix auto-patch workflow by excluding problematic agent-dependent tests (52789b0)\n- π§ Fix auto-patch workflow test failures by running targeted test subset (6358629)\n- π§ͺ [Documentation Introspection] Add bhconfig-specific test for configuration loading (5f7be60) ([Documentation Introspection])\n- π§ͺ [Configuration Loading Issue] Add failing test to reproduce configuration loading bug (c190457) ([Configuration Loading Issue])\n- π Convert milestone specifications from Markdown to Org-mode format (1a7f696)\n- π [#2] Fix ErrorHandler test failures after EventSnapshotException integration (6945d45) (#2, #2, [#2])\n- π§ͺ [#2] Implement Milestone 6F: Flow Detection - Core functionality complete (17262c8) (#2, #2, [#2])\n- π [#2] Create comprehensive Milestone 6F: Flow Detection specification (fba3df4) (#2, #2, [#2])\n- π [#2] Enhance specs documentation integration in GitHub Pages (9f60ad2) (#2, #2, [#2])\n- π§ͺ [#2] Fix test isolation issue in ByteHotApplicationIntegrationTest (70e056e) (#2, #2, [#2])\n- π [#2] Fix GitHub Actions CI workflow and test stability (1e9fe40) (#2, #2, [#2])\n- β Update Nix tests to reflect actual Java 17+ requirement per Maven configuration (d77d97a)\n- π§ Fix test assertion to match actual Maven error output (c95a40d)\n- β Fix Nix test - acknowledge Java 8 incompatibility, test minimum supported Java 11+ (b3542d3)\n- π§ Fix Nix test Java 8 compilation - override parent POM compiler settings (b4d8f95)\n- π§ Fix Nix test - correct flake paths, Java version compatibility, and add debugging (c90892a)\n- π§ͺ Add test workflow to verify GitHub Actions runner setup (aaaad3b)\n- π§ͺ [#6C] Add failing test for UserProfile value object (ca1c4b5) (#6, [#6C])\n- π§ͺ [#6C] Add failing test for UserId value object (ecebf7c) (#6, [#6C])\n- π§ [#2] fix compilation errors in event-driven testing framework (af384a0) (#2, #2, [#2])\n- π [#2] mark milestone 6B specification as completed (88d9fb5) (#2, #2, [#2])\n- β [#2] implement revolutionary event-driven testing framework (946db73) (#2, #2, [#2])\n- π§ͺ [#2] Add hexagonal architecture port interfaces (4bc6cd1) (#2, #2, [#2])\n- π§ͺ [#2] Add hexagonal architecture adapter tests (966b101) (#2, #2, [#2])\n- π§ͺ [#2] Add RollbackManagerTest with 8 comprehensive rollback scenarios (89df108) (#2, #2, [#2])\n- π§ͺ [#2] Add ErrorRecoveryManagerTest with 9 comprehensive recovery scenarios (e94e26e) (#2, #2, [#2])\n- π§ͺ [#2] Add ErrorHandler test for comprehensive error handling framework (c0dcf01) (#2, #2, [#2])\n- π§ͺ [#2] Add FrameworkIntegration test for Spring-style factory patterns (a62692a) (#2, #2, [#2])\n- β [#2] Add comprehensive integration tests for instance management workflow (a2b10b0) (#2, #2, [#2])\n- π§ͺ [#2] Add StatePreserver test for object state management (89c9e25) (#2, #2, [#2])\n- π§ͺ [#2] Add InstanceUpdateException test for error handling (2c8ce72) (#2, #2, [#2])\n- π§ͺ [#2] Add InstanceUpdater test for coordinating instance updates (25d5b9c) (#2, #2, [#2])\n- π§ͺ [#2] Add InstanceTracker test for thread-safe instance tracking (86594bf) (#2, #2, [#2])\n- π§ͺ [#2] Add InstancesUpdated domain event test for update results (e6f49ae) (#2, #2, [#2])\n- π§ͺ [#2] Add InstanceUpdateMethod enum test for update strategies (f9a0bf6) (#2, #2, [#2])\n- π§ Fix folder watch test race condition (32aa1ad)\n- π§Ή Remove Nix test report from git tracking (71d8d42)\n- β [#2] Add ByteHotApplicationIntegrationTest for complete startup flow (45631e8) (#2, #2, [#2])\n- π§ͺ [#2] Add Nix-based JVM compatibility test for hot-swap capabilities (5f0895f) (#2, #2, [#2])\n- β [#2] Implement HotSwapCapabilityEnabled event and validation checks (2256e81) (#2, #2, [#2])\n- π§ͺ [#2] Write failing test for HotSwapCapabilityEnabled event when all checks pass (355f2a4) (#2, #2, [#2])\n- π§ͺ [#2] Write failing test for WatchPathConfigured event when configuration contains valid paths (a71a7f4) (#2, #2, [#2])\n- π§ͺ [#2] Write failing test for ByteHotAgentAttached event (55cd106) (#2, #2, [#2])\n\n### π Bug Fixes
-
π§ Fix multi-line commit message handling in auto-patch-release workflow (8f299c2)\n- π§ [GitHub Actions] Fix YAML syntax error in auto-patch-release workflow (b0a7601) ([GitHub Actions])\n- π§ Fix compilation warnings in java-commons and bytehot modules (866c048)\n- π§ Fix YAML syntax - replace heredoc with echo statements for fallback HTML (5150276)\n- π§ Fix Javadoc generation - use direct javadoc command with proper classpath as fallback (df49765)\n- π§ Fix file copying to gh-pages - use temp directory to preserve generated files across branch switches (dadedf7)\n- π§ Fix Maven dependency resolution - use 'mvn install' to install java-commons in local repo (193a534)\n- π§ Fix final YAML syntax - remove all heredoc blocks, use echo statements throughout (a4cddd8)\n- π§ Fix YAML syntax - replace heredoc with echo statements for CSS generation (9e70b3c)\n- π [#2] Fix Maven compiler configuration for cross-JVM compatibility (ea2742a) (#2, #2, [#2])\n- Fixed Nix flake (4fccce6)\n\n### π Documentation
-
π§ Improve ConfigurationAdapter documentation for external file loading clarity (d54b582)\n- π§ [GitHub Actions] Replace Python heredoc with echo statements in enhanced-documentation (a536706) ([GitHub Actions])\n- π§ [GitHub Actions] Replace enhanced-documentation workflow to eliminate all heredocs (5034844) ([GitHub Actions])\n- π§ [GitHub Actions] Remove massive heredoc from documentation workflow (5eca024) ([GitHub Actions])\n- π§ [GitHub Actions] Fix org-mode code block conversion issues in documentation workflow (8d59163) ([GitHub Actions])\n- π Complete comprehensive literate programming documentation for all ByteHot classes (f1351ea)\n- π Update project instructions with comprehensive documentation standards (a1a3955)\n- π Update development journal with comprehensive documentation revolution (decfb95)\n- π Create comprehensive domain ports documentation with hexagonal architecture focus (63591ff)\n- π Create comprehensive domain events documentation with literate programming (8e7a072)\n- π¦ Complete java-commons framework extraction and update documentation (522632a)\n- π§ [#2] Fix documentation workflow step ordering (2c75cde) (#2, #2, [#2])\n- π§ [#2] Improve documentation workflow file discovery and content (818c048) (#2, #2, [#2])\n- π [#2] Fix YAML syntax error in documentation workflow (ec118ae) (#2, #2, [#2])\n- π§ [#2] Fix documentation workflow Javadoc generation (69bf791) (#2, #2, [#2])\n- π Enhance GitHub Pages README with comprehensive content, structure, and navigation (7e01dba)\n- π§ Fix file paths - use correct paths for Javadocs and source files from root directory (2b52cac)\n- π§ Fix YAML syntax error in documentation workflow - escape CSS comments and HTML content (7c8e297)\n- π [#2] GitHub Actions CI/CD + Documentation Updates (337d7cb) (#2, #2, [#2])\n- Initial README.md (eb2bfe1)\n\n### π Security & Dependencies
-
π Upgrade Apache Commons Configuration to resolve security vulnerability (7572854)\n- π Fix critical Log4j 1.x security vulnerability (CVE-2019-17571) (b98b7af)\n- π‘οΈ [#2] Update MySQL connector to fix critical security vulnerability (a2296bc) (#2, #2, [#2])\n- π‘οΈ [#2] Make security vulnerability check more robust and resilient (4489dc9) (#2, #2, [#2])\n\n### π Performance & Optimization
-
π [#2] Refactor ErrorHandler to use double dispatch pattern (d1b3d71) (#2, #2, [#2])\n- π [#2] Update CLI to use refactored configuration loading (75ea64d) (#2, #2, [#2])\n- π [#2] Refactor domain classes to use hexagonal architecture (e9bf5d4) (#2, #2, [#2])\n- Improved AGENTS.md (da61826)\n\n### ποΈ Infrastructure
-
π§ Fix auto-patch workflow dependency resolution by building all modules first (6476d66)\n- π§ [GitHub Actions] Fix YAML syntax by replacing heredoc with string concatenation (6c32c54) ([GitHub Actions])\n- π‘οΈ [#2] Update Jackson dependencies to fix CVE-2023-35116 (1c5858c) (#2, #2, [#2])\n- π [#2] Fix NVD API key variable expansion in CI workflow (5008c51) (#2, #2, [#2])\n- β‘ [#2] Temporarily disable OWASP dependency check to unblock CI (7ea53a7) (#2, #2, [#2])\n- π§ Fix Maven multi-module build - build from root directory and use Maven javadoc plugin (48d17e8)\n\n### π Content Updates
-
Minor changes. (bd49931)\n\n### π Other Changes
-
Initial layout to simplify development (07989f3)\n- Initial commit (f7b67fa)\n\n## π οΈ Technical Details
System Requirements:
- Java 17 or later
- Maven 3.6+ (for building from source)
Architecture:
- Domain-Driven Design (DDD) + Hexagonal Architecture
- Event-driven with comprehensive event sourcing
- Test-Driven Development methodology
- User session tracking and flow detection
Build Information:
- Java Version: 17
- Build Tool: Maven with shade plugin
- Test Coverage: Comprehensive unit and integration tests
- Artifact Type: Shaded JAR with all dependencies
π¦ Release Artifacts
| Artifact | Description | Size | Checksum |
|---|---|---|---|
bytehot-1.3.0-agent.jar |
Main ByteHot agent (recommended) | ~14MB | See SHA256SUMS |
bytehot-1.3.0.jar |
Slim version without dependencies | ~300KB | See SHA256SUMS |
bytehot-latest-SNAPSHOT-agent.jar |
Compatibility alias | ~14MB | For CI/CD |
π Documentation & Resources
- Getting Started Guide - Complete setup instructions
- Architecture Documentation - Technical deep-dive
- Feature Specifications - Detailed feature specs
- Development Journal - Development process log
π§ͺ Quality Assurance
This release includes comprehensive testing:
π€ Automated Release
π Workflow: Smart Release with Metadata
π Repository: ByteHot