particle-os/changelog
2025-08-10 19:03:24 -07:00

65 lines
3.3 KiB
Text

# 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 with 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
### 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
- **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