Skip to content

CHANGELOG.md

Latest commit

 

History

History
260 lines (160 loc) · 17.4 KB

CHANGELOG.md

File metadata and controls

260 lines (160 loc) · 17.4 KB
Raw

Changelog

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

This changelog is automatically maintained by Release Please using Conventional Commits. Do not edit the versioned sections manually.

1.4.0 (2026-07-09)

Features

  • add per-permission-level repo exclusions to github-add-repo-permissions (#48) (e37ffb3)

1.3.1 (2026-07-08)

Code Refactoring

  • replace get_all_pages with gh_api_paginate and use err() helper (89bbeab)

1.3.0 (2026-07-08)

Features

  • add Copilot Budget Advisor script and validation tests (c57bfc9)

1.2.1 (2026-06-27)

Code Refactoring

  • eliminate plan_credits duplication, _copilot_api wrapper, and test boilerplate (#43) (16fe695)
  • is now visible in Release Please (section: Code Refactoring) (834f342)

1.2.0 (2026-06-27)

Features

  • add bats unit tests for lib/github-common.sh (#41) (226c1f3)

1.1.8 (2026-06-27)

Bug Fixes

  • add packages section to release-please config (#39) (cb1a6a4)
  • use config-file/manifest-file inputs so version-file is honoured (#38) (8ab12ac)

1.1.7 (2026-06-27)

Bug Fixes

  • pass version-file to release-please action (#36) (5f2cfc4)

1.1.6 (2026-06-27)

Bug Fixes

1.1.5 (2026-06-27)

Bug Fixes

  • point release-please to VERSION file (#32) (21e9641)

1.1.4 (2026-06-27)

Bug Fixes

  • ponytail audit — remove ~330 lines of redundant code (#30) (042d71e)

1.1.3 (2026-06-27)

Bug Fixes

  • mark all shell scripts as executable (#28) (5ae37b9)

1.1.2 (2026-06-26)

Bug Fixes

  • handle 404 sentinel in github-dockerfile-discovery (#25) (6ab08f1)

1.1.1 (2026-06-26)

Bug Fixes

  • scripts: BSD head portability and restore billing and Entra ID features (#23) (e5a17af)

1.1.0 (2026-06-26)

Features

  • add dual-auth support (GITHUB_TOKEN + gh CLI) across all scripts (#21) (d45fe33)

1.0.0 (2026-06-26)

Features

  • add advanced issue search documentation (e2634db)
  • add CI workflow to handle documentation-only pull requests (da4a2b4)
  • add composite actions, automated releases, and Conventional Commits workflow (f16f4a8)
  • add Copilot skills and path-scoped instructions (#11) (4c7b045)
  • add GitHub API helpers for organization management and enhance existing functions (35a40a1)
  • add github-organize-stars script for organizing starred repositories into GitHub Lists (00f3ad0)
  • add pre-commit hooks for secret scanning and shell script security checks (032685f)
  • add repository name filtering option for permission management script (761a84b)
  • add script to programmatically install enterprise-owned GitHub App (f9f5e0c)
  • create issue templates for consistent reporting (e2634db)
  • docs: add comprehensive Copilot instructions for GitHub API scripts (42a6622)
  • document sub-issues and parent issues functionality (e2634db)
  • enhance documentation and error handling across scripts for improved usability and validation (5aa10f7)
  • enhance error handling by adding informative messages for missing environment variables (bb511bd)
  • enhance scripts with validation functions and improve reporting output (c57e562)
  • enhance validation and payload handling across multiple scripts (7a22e3c)
  • enhance validation for user inputs and improve error handling across scripts (d7e0c44)
  • GH: add sponsor link (#6) (e71f11c)
  • implement GitHub release skill documentation (e2634db)
  • introduce github-add-repo-permissions script for flexible team permission management (b5c651d)
  • make repo AI-ready (#10) (af1a0e4)
  • README: description and installation (#3) (5bf42eb)
  • Script: initial github-add-repo-admin.sh (#5) (0f46010)
  • Script: initial github-get-consumed-licenses.sh (#8) (dedf034)
  • Script: initial github-import-repo.sh (#1) (2fa4c1a)
  • Script: initial github-monthly-issues-report.sh (#4) (c0cf62d)
  • Script: initial github-repo-from-template.sh (#2) (0143bce)
  • update README with GitHub Actions integration examples and improve script usage instructions (c5716e9)

Bug Fixes

  • improve echo messages and formatting for better readability in scripts (b547df5)
  • improve JWT signing error handling and response parsing in installation script (c9a3810)
  • open PR instead of pushing directly to protected main branch (#14) (37982f2)
  • update shebang from /bin/bash to /usr/bin/env bash in multiple scripts (bcdc7db)

Pre-release history

2026-06-26

  • feat: composite action.yml for all 16 automation scripts — each script is now usable as a uses: step in GitHub Actions workflows, enabling Dependabot to track and bump version pins automatically
  • feat: Release Please workflow for automated releases on push to main
  • feat: github-install-enterprise-app — programmatically installs an enterprise-owned GitHub App using a second installer app (JWT flow); supports --dry-run
  • feat: github-copilot-report — Copilot usage report with Entra ID enrichment, AI credit accounting, and new usage-metrics endpoints
  • fix: github-archive-old-repos — REPORT_DIR is now overridable via environment variable
  • chore: remove update-readme-sha.yml workflow (superseded by release tags)
  • docs: GitHub Actions section in README restructured to lead with composite action uses: syntax

2026-06-21

  • feat: github-copilot-report — NDJSON usage-metrics endpoints, Entra ID enrichment via az rest, credits per seat auto-detection
  • docs: GitHub Actions integration examples (workflow_dispatch, artifact upload, environment protection)
  • fix: validated all required environment variables across all scripts before any API calls

2026-06-20

  • feat: github-add-repo-permissions — REPO_NAME_FILTER option to restrict permission grants to repos matching a name prefix
  • fix: enhanced validation for user-supplied inputs (slugs, regex patterns, date formats) across multiple scripts

[2026-06-19]

Added

  • github-copilot-report — Copilot usage report with per-user seat data, AI credit calculations, and optional Entra ID department/job-title enrichment
  • github-repo-permissions-report — CSV report of all user/team permissions and branch-protection bypass actors for a given repo and branch; uses gh CLI
  • .githooks/pre-commit — secret scanning (gitleaks or built-in regex) + shellcheck on staged .sh files
  • install-hooks.sh — one-command hook installer (git config core.hooksPath .githooks)

Changed

  • Standardized all scripts to the # === 79-char header block with full env-var and requirements documentation
  • Added --dry-run flag documentation to github-close-archived-repo-security-alerts and github-enable-issues

[2026-06-18]

Added

  • lib/github-common.sh — shared utility library: print_status/success/warning/error, require_env_var, require_command, validate_github_token, validate_token, validate_slug, gh_api (Bearer auth + 5-retry rate-limit handling), get_repo_page_count, get_enterprise_orgs (three-tier fallback)
  • github-enable-issues — enables GitHub Issues on all repos in an org that have it disabled; supports --dry-run
  • github-get-repo-list — exports a CSV of all repos in an org (visibility, URL, timestamps)
  • github-get-public-repos — discovers all public repos across all enterprise orgs; writes timestamped CSV
  • github-migrate-internal-repos-to-private — bulk-converts internal repos to private via PATCH
  • github-archive-old-repos — archives repos not pushed to in N years; generates CSV report; prompts for confirmation
  • github-auto-repo-creation — creates private repos with branch protection, CODEOWNERS, and admin team grants
  • github-close-archived-repo-security-alerts — dismisses open Dependabot, code-scanning, and secret-scanning alerts on archived repos; supports --type and --dry-run
  • github-add-enterprise-team-read-permissions — grants all_repo_read org role to an enterprise team across all enterprise orgs via GraphQL pagination
  • github-dockerfile-discovery — code-searches all enterprise orgs for Dockerfiles, extracts FROM instructions, produces detail + summary CSVs
  • Reorganized all scripts into domain subdirectories: org-admin/, enterprise/, reporting/, personal/
  • .github instructions and agent profiles for Copilot

Changed

  • All scripts refactored to source lib/github-common.sh for shared validation and output helpers
  • github-repo-from-template: added CD_GITHUB_TOKEN auto-accept collaborator invitation flow
  • github-add-repo-collaborators-by-pattern (formerly github-add-repo-admin): expanded to support REPO_EXCLUDE_REGEX and comma-separated COLLABORATORS
  • README: comprehensive rewrite with per-script env var tables, usage examples, and GitHub Actions integration guide

[2026-03-12]

Added

  • github-organize-stars — fetches all starred repos via gh CLI GraphQL, categorizes by language/topic/name-keyword rules, and adds repos to GitHub Lists in batches of 25; supports --dry-run, -y, --show-repos, --no-cache

[2025-10-31]

Added

  • github-add-repo-permissions — grants configurable team permissions (admin, maintain, push, triage, pull) across all repos in an org
  • .github/copilot-instructions.md — initial AI agent instructions with architecture overview, API patterns, script-specific behaviors, and common pitfalls

Changed

  • Standardized shebang to #!/bin/bash and improved GITHUB_TOKEN validation across all scripts
  • Enhanced error messages for missing environment variables
  • Improved output formatting and readability

[2025-03-26]

Added

  • github-get-consumed-licenses — calls the enterprise consumed-licenses endpoint to return seat consumption and purchase counts

[2024-09-02]

Changed

  • github-repo-from-template: improved handling of template repo options and team permission assignment

[2021-07-09]

Added

  • github-add-repo-admin (later renamed github-add-repo-collaborators-by-pattern) — adds collaborators to repos matching a name pattern

[2021-07-04] — Initial release

Added

  • github-import-repo — bare-clones a source repo and mirror-pushes to a new private destination repo
  • github-repo-from-template — creates a private repo from a template, assigns admin teams, and invites a CD user
  • github-monthly-issues-report — generates an HTML report of issues created in a date range with label/timeline tracking
  • README with project overview and installation instructions