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

bc_gitops_runtime_default: Version upgrades now restart the application
- Ensures clean initialization (routes, supervisors, app metadata)
- Fixes issue where application:get_key/2 returned stale cached values
- Hot code reload still available for same-version code changes via bc_gitops_hot_reload
Upgrade flow: Always fetches fresh code for upgrades
- Deletes existing workspace before fetching new version
- Ensures clean build with correct ref/tag

Detailed telemetry events for build pipeline visibility:
- [:bc_gitops, :git, :clone_start] / [:bc_gitops, :git, :clone_stop]
- [:bc_gitops, :deps, :start] / [:bc_gitops, :deps, :stop]
- [:bc_gitops, :build, :start] / [:bc_gitops, :build, :stop]
- [:bc_gitops, :code, :load]
- All events include app name, tool used, and success/failure status

guides/api.md: Complete API quick-reference guide
- Core module API (status, state, manual operations)
- Runtime module callbacks
- Workspace and hot reload APIs
- Record definitions and telemetry events

assets/architecture.svg: Updated to show v0.2.0 modules
- Added bc_gitops_workspace and bc_gitops_hot_reload
- Added hex.pm external source and build tools
assets/hot_reload_flow.svg: New diagram showing upgrade flow
- Suspend -> reload -> resume sequence
- MD5 comparison for change detection
- Fallback to restart on failure

bc_gitops_workspace: Package fetching and compilation workspace
- Fetches packages from hex.pm via rebar3 (Erlang) or mix (Elixir)
- Clones and compiles git repositories
- Manages code paths automatically
- Supports rebar3, mix, and erlang.mk project types
bc_gitops_hot_reload: Hot code reloading utilities
- Module reloading with code:soft_purge/1 + code:load_file/1
- Process suspension/resumption for stateful upgrades
- Change detection via beam file MD5 comparison
- Coordinated upgrade across application modules

bc_gitops_runtime_default: Now fully functional out of the box
- Actually fetches and compiles packages (was just a stub before)
- Supports hot code upgrades with fallback to restart
- Properly manages application environment and state

Initial release of bc_gitops
Core reconciler (bc_gitops_reconciler) with configurable interval
Git operations (bc_gitops_git) for clone, pull, and commit queries
Configuration parser (bc_gitops_parser) supporting Erlang term and JSON formats
Runtime behaviour (bc_gitops_runtime) for pluggable deployment strategies
Default runtime implementation (bc_gitops_runtime_default) using OTP application management
Telemetry events for reconciliation, deployment, and upgrade operations
Comprehensive API (bc_gitops) for status queries and manual operations
Full documentation with examples