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.
1.1.0 - 2026-02-17
Added
doctorcommand — runflamelet doctorfor global health checks orflamelet -t <tenant> doctorfor full tenant diagnostics- Stale venv cleanup — detects virtual environments under
~/.flamelet/venv/that no longer match any tenant'sconfig.sh(e.g. leftover after version bumps), with interactive or--forcedeletion; respects--dryrun - Ansible version check — queries PyPI for the latest stable release and the latest patch in the current major.minor series
- Unused Galaxy collections — scans tenant YAML files for FQCN references and reports collections with no matches
- Unused Galaxy roles — scans tenant YAML files for role references (strips version pins) and reports roles with no matches
- MkDocs search — enabled the built-in search plugin for the documentation site
Fixed
- Option parsing — flags like
-onow work in any position, including after the command name (e.g.flamelet -t x ansiblemodule -o "all -m ping"previously corrupted the options tonse) - Empty option guard —
_ansible_()and_ansibleModule_()no longer mangle an unset-ovalue
1.0.0 - 2026-02-17
First stable release.
Added
- Semantic versioning —
VERSIONfile as single source of truth,--version/-Vflag,versioncommand with remote update checking - Version-aware updates —
flamelet updatenow shows before/after versions - GitHub Actions release workflow — automatically creates a GitHub Release on tag push
- Installer version display —
tools/install.shprints the installed version - Remote install includes VERSION —
installremotecopies the VERSION file to the remote host - Ad-hoc Ansible modules —
ansiblemodulecommand for running ad-hoc Ansible modules (ping,command,raw,shell, etc.) without a playbook - Collection removal fix — use
rm -rfinstead ofansible-galaxy collection remove, which does not exist - Multi-page documentation site — full MkDocs Material site with CLI reference, configuration guide, usage patterns, and advanced features
- Example tenant documentation —
example-localtenant with step-by-step instructions conf_*_customcomposition pattern — documented approach for composable default/custom variable overrides
Features carried from pre-release development
- Multi-tenant support with isolated configuration per tenant
- Per-tenant Python virtual environments with pinned Ansible versions
- Remote execution via SSH controller (
-rflag) - Offline mode for air-gapped environments (
-lflag) - Dry run mode (
-nflag) - Tenant repository checkout and branch tracking
- System dependency installation across Debian, RedHat, FreeBSD, and OpenBSD
- Network scanning with nmap and HTML report generation
- System info and dependency checking (
sysinfo) - Galaxy roles and collections management
- Configurable SSH, SCP, and git options
- Environment file loading (
env.shat global and tenant level) - Flexible logging with configurable log levels and log files