# Changelog

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

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [Unreleased]

### Added
- **Project Foundation**: Complete project restructuring and automation setup
- **Build System**: Comprehensive justfile with build, test, and status commands
- **Base Image**: Debian Trixie-slim based container with essential system packages
- **Minimal Image**: Bootable minimal image with OSTree compliance
- **OSTree Integration**: Basic OSTree configuration and structure
- **Systemd Services**: Core system services and configuration
- **Kernel Support**: Kernel headers and module structure setup
- **Bootloader Support**: GRUB EFI configuration (deployment-time setup)
- **Disk Utilities**: Essential tools for bootc deployment (util-linux, parted, e2fsprogs, etc.)
- **Phase 2 CoreOS**: Complete CoreOS equivalent with OSTree management
- **OSTree Repository**: Full repository setup and deployment structure
- **System Management**: Network configuration, security hardening, and container runtime
- **Update Tools**: Particle-OS OSTree update management tool
- **Security Features**: AppArmor integration and kernel security configuration
- **Bootloader Management**: Complete bootupd/bootctl integration framework
- **Bootloader Commands**: `just install-bootloader`, `just update-bootloader`, `just test-bootloader`, `just bootloader-status`
- **Bootloader Testing**: Automated validation of bootupd, bootctl, and GRUB functionality

### Changed
- **Project Structure**: Reorganized from monolithic approach to layered container architecture
- **Build Process**: Automated container builds using Podman
- **Dependency Management**: Streamlined package installation and configuration

### Fixed
- **Containerfile.base**: Corrected syntax error in multi-line apt-get install command
- **Kernel Headers**: Fixed kernel header path resolution for both version-specific and amd64 variants
- **Build Environment**: Made kernel module setup robust for containerized builds
- **Bootloader**: Skipped grub-install during build (deployment-time concern)
- **Module Dependencies**: Skipped depmod during build (deployment-time concern)
- **bootc Installation**: Resolved download issues by deferring to deployment-time installation

### Technical Details
- **Base Image**: Debian Trixie-slim with systemd, networking, and essential utilities
- **Minimal Image**: Extends base with kernel support, bootloader config, and OSTree structure
- **Build Commands**: `just build-base`, `just build-minimal`, `just status`
- **Test Commands**: `just test-image`, `just test-ostree`, `just test-bootc-deployment`
- **Architecture**: x86_64 with EFI boot support
- **Container Engine**: Podman for builds and testing

### Known Limitations
- bootc binary installation deferred to deployment (GitHub releases URL issues)
- Kernel module dependency generation skipped during build
- Bootloader configuration deferred to deployment (container filesystem limitations)

### Next Steps
- **Bootloader Management**: Complete bootupd/bootctl integration and testing
- **Phase 3**: Desktop environment integration (GNOME/KDE variants)
- **Phase 4**: Advanced features and production readiness

## [0.1.0] - 2024-08-11

### Added
- Initial project structure and documentation
- Basic roadmap and terminology definitions
- OSTree requirements specification
- Project foundation and planning documents

[Unreleased]: https://github.com/your-username/particle-os/compare/v0.1.0...HEAD
[0.1.0]: https://github.com/your-username/particle-os/releases/tag/v0.1.0