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.
- Issues metadata backup: Export GitHub issues (with comments) to JSON files
- New
backup_metadata.issuesconfig option (disabled by default) - JSON schema includes issue metadata, labels, assignees, milestones, comments
- Files saved as
{repo}-issues-{date}.jsonalongside git archives
- New
- New
IssuesHandlerclass for issues export functionality - Monthly issue reporting: backup reports grouped by month with collapsed details
- End-of-month review reminder (@mmcky mention when day >= 25)
BackupManagernow accepts optionalbackup_metadataconfiguration- GitHub issue reports now use monthly issues instead of single rolling issue
- Issues backup is disabled by default due to API rate limit concerns (see #3)
- Each issue requires a separate API call for comments
- GraphQL optimization planned for future release
exclude_archivedconfig option to skip archived repositories during backupexclude_repositoriesconfig option to exclude specific repos by exact nameexclude_patternsconfig option to exclude repos matching regex patterns- Improved logging: excluded repos now shown in formatted multi-column list
- Type hints updated to Python 3.9+ style (lowercase
list,dict,set) - Ruff configuration updated to use
[tool.ruff.lint]section
- Individual repository backup with
repositories:config (exact names, no regex needed) - Pattern-based repository selection with
patterns:config (Python regex) - Skip existing same-day backups (use
--forceto override) - PAT authentication support for private repos via
REPO_BACKUP_TOKEN - S3 upload with SHA256 checksums for integrity verification
- Backup reporting with
--task report - Issue reporting for weekly runs (creates/updates GitHub issue, tags @mmcky on failure)
- Dry-run mode with
--dry-runto preview backups - GitHub Actions workflow with OIDC authentication for AWS
- Configuration system using YAML
- Renamed project from
action-repo-maintenancetoworkflow-backups - Adopted
workflow-prefix convention for org-level automation - Switched to OIDC authentication (recommended over static credentials)
Release notes for each version are in docs/releases/.