diff --git a/CLAUDE.md b/CLAUDE.md index 8efcaeb..5c5f465 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -238,8 +238,8 @@ You do NOT need to manually instruct subagents about context-mode. ### ctx commands -| Command | Action | -|---------|--------| -| `ctx stats` | Call the `ctx_stats` MCP tool and display the full output verbatim | -| `ctx doctor` | Call the `ctx_doctor` MCP tool, run the returned shell command, display as checklist | +| Command | Action | +|---------------|---------------------------------------------------------------------------------------| +| `ctx stats` | Call the `ctx_stats` MCP tool and display the full output verbatim | +| `ctx doctor` | Call the `ctx_doctor` MCP tool, run the returned shell command, display as checklist | | `ctx upgrade` | Call the `ctx_upgrade` MCP tool, run the returned shell command, display as checklist | diff --git a/README.md b/README.md index c8a75d1..2020410 100644 --- a/README.md +++ b/README.md @@ -29,73 +29,73 @@ This repository contains **26 reusable GitHub Actions** for CI/CD automation. ### Quick Reference (26 Actions) | Icon | Action | Category | Description | Key Features | -| :--: | :--------------------------------------------------- | :--------- | :-------------------------------------------------------------- | :------------------------------------------- | +|:----:|:-----------------------------------------------------|:-----------|:----------------------------------------------------------------|:---------------------------------------------| | ๐Ÿ”€ | [`action-versioning`][action-versioning] | Utilities | Automatically update SHA-pinned action references to match l... | Token auth, Outputs | | ๐Ÿ“ฆ | [`ansible-lint-fix`][ansible-lint-fix] | Linting | Lints and fixes Ansible playbooks, commits changes, and uplo... | Caching, Token auth, Outputs | -| โœ… | [`biome-lint`][biome-lint] | Linting | Run Biome linter in check or fix mode | Caching, Auto-detection, Token auth, Outputs | -| ๐Ÿ›ก๏ธ | [`codeql-analysis`][codeql-analysis] | Repository | Run CodeQL security analysis for a single language with conf... | Auto-detection, Token auth, Outputs | -| ๐Ÿ–ผ๏ธ | [`compress-images`][compress-images] | Repository | Compress images on demand (workflow_dispatch), and at 11pm e... | Token auth, Outputs | +| โœ… | [`biome-lint`][biome-lint] | Linting | Run Biome linter in check or fix mode | Caching, Auto-detection, Token auth, Outputs | +| ๐Ÿ›ก๏ธ | [`codeql-analysis`][codeql-analysis] | Repository | Run CodeQL security analysis for a single language with conf... | Auto-detection, Token auth, Outputs | +| ๐Ÿ–ผ๏ธ | [`compress-images`][compress-images] | Repository | Compress images on demand (workflow_dispatch), and at 11pm e... | Token auth, Outputs | | ๐Ÿ“ | [`csharp-build`][csharp-build] | Build | Builds and tests C# projects. | Caching, Auto-detection, Token auth, Outputs | | ๐Ÿ“ | [`csharp-lint-check`][csharp-lint-check] | Linting | Runs linters like StyleCop or dotnet-format for C# code styl... | Caching, Auto-detection, Token auth, Outputs | | ๐Ÿ“ฆ | [`csharp-publish`][csharp-publish] | Publishing | Publishes a C# project to GitHub Packages. | Caching, Auto-detection, Token auth, Outputs | | ๐Ÿ“ฆ | [`docker-build`][docker-build] | Build | Builds a Docker image for multiple architectures with enhanc... | Caching, Auto-detection, Token auth, Outputs | | โ˜๏ธ | [`docker-publish`][docker-publish] | Publishing | Simple wrapper to publish Docker images to GitHub Packages a... | Token auth, Outputs | -| โœ… | [`eslint-lint`][eslint-lint] | Linting | Run ESLint in check or fix mode with advanced configuration ... | Caching, Auto-detection, Token auth, Outputs | +| โœ… | [`eslint-lint`][eslint-lint] | Linting | Run ESLint in check or fix mode with advanced configuration ... | Caching, Auto-detection, Token auth, Outputs | | ๐Ÿ“ฆ | [`go-build`][go-build] | Build | Builds the Go project. | Caching, Auto-detection, Token auth, Outputs | | ๐Ÿ“ | [`go-lint`][go-lint] | Linting | Run golangci-lint with advanced configuration, caching, and ... | Caching, Token auth, Outputs | | ๐Ÿ“ | [`language-version-detect`][language-version-detect] | Setup | DEPRECATED: This action is deprecated. Inline version detect... | Auto-detection, Token auth, Outputs | | ๐Ÿ“ฆ | [`npm-publish`][npm-publish] | Publishing | Publishes the package to the NPM registry with configurable ... | Caching, Auto-detection, Token auth, Outputs | -| โœ… | [`php-tests`][php-tests] | Testing | Run PHPUnit tests with optional Laravel setup and Composer d... | Caching, Auto-detection, Token auth, Outputs | -| โœ… | [`pr-lint`][pr-lint] | Linting | Runs MegaLinter against pull requests | Caching, Auto-detection, Token auth, Outputs | +| โœ… | [`php-tests`][php-tests] | Testing | Run PHPUnit tests with optional Laravel setup and Composer d... | Caching, Auto-detection, Token auth, Outputs | +| โœ… | [`pr-lint`][pr-lint] | Linting | Runs MegaLinter against pull requests | Caching, Auto-detection, Token auth, Outputs | | ๐Ÿ“ฆ | [`pre-commit`][pre-commit] | Linting | Runs pre-commit on the repository and pushes the fixes back ... | Auto-detection, Token auth, Outputs | -| โœ… | [`prettier-lint`][prettier-lint] | Linting | Run Prettier in check or fix mode with advanced configuratio... | Caching, Auto-detection, Token auth, Outputs | +| โœ… | [`prettier-lint`][prettier-lint] | Linting | Run Prettier in check or fix mode with advanced configuratio... | Caching, Auto-detection, Token auth, Outputs | | ๐Ÿ“ | [`python-lint-fix`][python-lint-fix] | Linting | Lints and fixes Python files, commits changes, and uploads S... | Caching, Auto-detection, Token auth, Outputs | | ๐Ÿ“ฆ | [`release-monthly`][release-monthly] | Repository | Creates a release for the current month, incrementing patch ... | Token auth, Outputs | -| ๐Ÿ›ก๏ธ | [`security-scan`][security-scan] | Security | Comprehensive security scanning for GitHub Actions including... | Caching, Token auth, Outputs | +| ๐Ÿ›ก๏ธ | [`security-scan`][security-scan] | Security | Comprehensive security scanning for GitHub Actions including... | Caching, Token auth, Outputs | | ๐Ÿ“ฆ | [`stale`][stale] | Repository | A GitHub Action to close stale issues and pull requests. | Token auth, Outputs | -| ๐Ÿท๏ธ | [`sync-labels`][sync-labels] | Repository | Sync labels from a YAML file to a GitHub repository | Token auth, Outputs | -| ๐Ÿ–ฅ๏ธ | [`terraform-lint-fix`][terraform-lint-fix] | Linting | Lints and fixes Terraform files with advanced validation and... | Token auth, Outputs | -| ๐Ÿ›ก๏ธ | [`validate-inputs`][validate-inputs] | Validation | Centralized Python-based input validation for GitHub Actions... | Token auth, Outputs | +| ๐Ÿท๏ธ | [`sync-labels`][sync-labels] | Repository | Sync labels from a YAML file to a GitHub repository | Token auth, Outputs | +| ๐Ÿ–ฅ๏ธ | [`terraform-lint-fix`][terraform-lint-fix] | Linting | Lints and fixes Terraform files with advanced validation and... | Token auth, Outputs | +| ๐Ÿ›ก๏ธ | [`validate-inputs`][validate-inputs] | Validation | Centralized Python-based input validation for GitHub Actions... | Token auth, Outputs | ### Actions by Category #### ๐Ÿ”ง Setup (1 action) | Action | Description | Languages | Features | -| :------------------------------------------------------ | :---------------------------------------------------- | :----------------------------- | :---------------------------------- | +|:--------------------------------------------------------|:------------------------------------------------------|:-------------------------------|:------------------------------------| | ๐Ÿ“ [`language-version-detect`][language-version-detect] | DEPRECATED: This action is deprecated. Inline vers... | PHP, Python, Go, .NET, Node.js | Auto-detection, Token auth, Outputs | #### ๐Ÿ› ๏ธ Utilities (1 action) | Action | Description | Languages | Features | -| :------------------------------------------ | :---------------------------------------------------- | :------------- | :------------------ | +|:--------------------------------------------|:------------------------------------------------------|:---------------|:--------------------| | ๐Ÿ”€ [`action-versioning`][action-versioning] | Automatically update SHA-pinned action references ... | GitHub Actions | Token auth, Outputs | #### ๐Ÿ“ Linting (10 actions) -| Action | Description | Languages | Features | -| :-------------------------------------------- | :---------------------------------------------------- | :------------------------------------------- | :------------------------------------------- | -| ๐Ÿ“ฆ [`ansible-lint-fix`][ansible-lint-fix] | Lints and fixes Ansible playbooks, commits changes... | Ansible, YAML | Caching, Token auth, Outputs | -| โœ… [`biome-lint`][biome-lint] | Run Biome linter in check or fix mode | JavaScript, TypeScript, JSON | Caching, Auto-detection, Token auth, Outputs | -| ๐Ÿ“ [`csharp-lint-check`][csharp-lint-check] | Runs linters like StyleCop or dotnet-format for C#... | C#, .NET | Caching, Auto-detection, Token auth, Outputs | -| โœ… [`eslint-lint`][eslint-lint] | Run ESLint in check or fix mode with advanced conf... | JavaScript, TypeScript | Caching, Auto-detection, Token auth, Outputs | -| ๐Ÿ“ [`go-lint`][go-lint] | Run golangci-lint with advanced configuration, cac... | Go | Caching, Token auth, Outputs | -| โœ… [`pr-lint`][pr-lint] | Runs MegaLinter against pull requests | Conventional Commits | Caching, Auto-detection, Token auth, Outputs | -| ๐Ÿ“ฆ [`pre-commit`][pre-commit] | Runs pre-commit on the repository and pushes the f... | Python, Multiple Languages | Auto-detection, Token auth, Outputs | -| โœ… [`prettier-lint`][prettier-lint] | Run Prettier in check or fix mode with advanced co... | JavaScript, TypeScript, Markdown, YAML, JSON | Caching, Auto-detection, Token auth, Outputs | -| ๐Ÿ“ [`python-lint-fix`][python-lint-fix] | Lints and fixes Python files, commits changes, and... | Python | Caching, Auto-detection, Token auth, Outputs | +| Action | Description | Languages | Features | +|:-----------------------------------------------|:------------------------------------------------------|:---------------------------------------------|:---------------------------------------------| +| ๐Ÿ“ฆ [`ansible-lint-fix`][ansible-lint-fix] | Lints and fixes Ansible playbooks, commits changes... | Ansible, YAML | Caching, Token auth, Outputs | +| โœ… [`biome-lint`][biome-lint] | Run Biome linter in check or fix mode | JavaScript, TypeScript, JSON | Caching, Auto-detection, Token auth, Outputs | +| ๐Ÿ“ [`csharp-lint-check`][csharp-lint-check] | Runs linters like StyleCop or dotnet-format for C#... | C#, .NET | Caching, Auto-detection, Token auth, Outputs | +| โœ… [`eslint-lint`][eslint-lint] | Run ESLint in check or fix mode with advanced conf... | JavaScript, TypeScript | Caching, Auto-detection, Token auth, Outputs | +| ๐Ÿ“ [`go-lint`][go-lint] | Run golangci-lint with advanced configuration, cac... | Go | Caching, Token auth, Outputs | +| โœ… [`pr-lint`][pr-lint] | Runs MegaLinter against pull requests | Conventional Commits | Caching, Auto-detection, Token auth, Outputs | +| ๐Ÿ“ฆ [`pre-commit`][pre-commit] | Runs pre-commit on the repository and pushes the f... | Python, Multiple Languages | Auto-detection, Token auth, Outputs | +| โœ… [`prettier-lint`][prettier-lint] | Run Prettier in check or fix mode with advanced co... | JavaScript, TypeScript, Markdown, YAML, JSON | Caching, Auto-detection, Token auth, Outputs | +| ๐Ÿ“ [`python-lint-fix`][python-lint-fix] | Lints and fixes Python files, commits changes, and... | Python | Caching, Auto-detection, Token auth, Outputs | | ๐Ÿ–ฅ๏ธ [`terraform-lint-fix`][terraform-lint-fix] | Lints and fixes Terraform files with advanced vali... | Terraform, HCL | Token auth, Outputs | #### ๐Ÿงช Testing (1 action) -| Action | Description | Languages | Features | -| :-------------------------- | :---------------------------------------------------- | :----------- | :------------------------------------------- | +| Action | Description | Languages | Features | +|:---------------------------|:------------------------------------------------------|:-------------|:---------------------------------------------| | โœ… [`php-tests`][php-tests] | Run PHPUnit tests with optional Laravel setup and ... | PHP, Laravel | Caching, Auto-detection, Token auth, Outputs | #### ๐Ÿ—๏ธ Build (3 actions) | Action | Description | Languages | Features | -| :-------------------------------- | :---------------------------------------------------- | :-------- | :------------------------------------------- | +|:----------------------------------|:------------------------------------------------------|:----------|:---------------------------------------------| | ๐Ÿ“ [`csharp-build`][csharp-build] | Builds and tests C# projects. | C#, .NET | Caching, Auto-detection, Token auth, Outputs | | ๐Ÿ“ฆ [`docker-build`][docker-build] | Builds a Docker image for multiple architectures w... | Docker | Caching, Auto-detection, Token auth, Outputs | | ๐Ÿ“ฆ [`go-build`][go-build] | Builds the Go project. | Go | Caching, Auto-detection, Token auth, Outputs | @@ -103,68 +103,68 @@ This repository contains **26 reusable GitHub Actions** for CI/CD automation. #### ๐Ÿš€ Publishing (3 actions) | Action | Description | Languages | Features | -| :------------------------------------ | :---------------------------------------------------- | :----------- | :------------------------------------------- | +|:--------------------------------------|:------------------------------------------------------|:-------------|:---------------------------------------------| | ๐Ÿ“ฆ [`csharp-publish`][csharp-publish] | Publishes a C# project to GitHub Packages. | C#, .NET | Caching, Auto-detection, Token auth, Outputs | | โ˜๏ธ [`docker-publish`][docker-publish] | Simple wrapper to publish Docker images to GitHub ... | Docker | Token auth, Outputs | | ๐Ÿ“ฆ [`npm-publish`][npm-publish] | Publishes the package to the NPM registry with con... | Node.js, npm | Caching, Auto-detection, Token auth, Outputs | #### ๐Ÿ“ฆ Repository (5 actions) -| Action | Description | Languages | Features | -| :-------------------------------------- | :---------------------------------------------------- | :------------------------------------------------------ | :---------------------------------- | +| Action | Description | Languages | Features | +|:-----------------------------------------|:------------------------------------------------------|:--------------------------------------------------------|:------------------------------------| | ๐Ÿ›ก๏ธ [`codeql-analysis`][codeql-analysis] | Run CodeQL security analysis for a single language... | JavaScript, TypeScript, Python, Java, C#, C++, Go, Ruby | Auto-detection, Token auth, Outputs | | ๐Ÿ–ผ๏ธ [`compress-images`][compress-images] | Compress images on demand (workflow_dispatch), and... | Images, PNG, JPEG | Token auth, Outputs | -| ๐Ÿ“ฆ [`release-monthly`][release-monthly] | Creates a release for the current month, increment... | GitHub Actions | Token auth, Outputs | -| ๐Ÿ“ฆ [`stale`][stale] | A GitHub Action to close stale issues and pull req... | GitHub Actions | Token auth, Outputs | +| ๐Ÿ“ฆ [`release-monthly`][release-monthly] | Creates a release for the current month, increment... | GitHub Actions | Token auth, Outputs | +| ๐Ÿ“ฆ [`stale`][stale] | A GitHub Action to close stale issues and pull req... | GitHub Actions | Token auth, Outputs | | ๐Ÿท๏ธ [`sync-labels`][sync-labels] | Sync labels from a YAML file to a GitHub repositor... | YAML, GitHub | Token auth, Outputs | #### ๐Ÿ›ก๏ธ Security (1 action) -| Action | Description | Languages | Features | -| :---------------------------------- | :---------------------------------------------------- | :-------- | :--------------------------- | +| Action | Description | Languages | Features | +|:-------------------------------------|:------------------------------------------------------|:----------|:-----------------------------| | ๐Ÿ›ก๏ธ [`security-scan`][security-scan] | Comprehensive security scanning for GitHub Actions... | - | Caching, Token auth, Outputs | #### โœ… Validation (1 action) -| Action | Description | Languages | Features | -| :-------------------------------------- | :---------------------------------------------------- | :------------------- | :------------------ | +| Action | Description | Languages | Features | +|:-----------------------------------------|:------------------------------------------------------|:---------------------|:--------------------| | ๐Ÿ›ก๏ธ [`validate-inputs`][validate-inputs] | Centralized Python-based input validation for GitH... | YAML, GitHub Actions | Token auth, Outputs | ### Feature Matrix | Action | Caching | Auto-detection | Token auth | Outputs | -| :--------------------------------------------------- | :-----: | :------------: | :--------: | :-----: | -| [`action-versioning`][action-versioning] | - | - | โœ… | โœ… | -| [`ansible-lint-fix`][ansible-lint-fix] | โœ… | - | โœ… | โœ… | -| [`biome-lint`][biome-lint] | โœ… | โœ… | โœ… | โœ… | -| [`codeql-analysis`][codeql-analysis] | - | โœ… | โœ… | โœ… | -| [`compress-images`][compress-images] | - | - | โœ… | โœ… | -| [`csharp-build`][csharp-build] | โœ… | โœ… | โœ… | โœ… | -| [`csharp-lint-check`][csharp-lint-check] | โœ… | โœ… | โœ… | โœ… | -| [`csharp-publish`][csharp-publish] | โœ… | โœ… | โœ… | โœ… | -| [`docker-build`][docker-build] | โœ… | โœ… | โœ… | โœ… | -| [`docker-publish`][docker-publish] | - | - | โœ… | โœ… | -| [`eslint-lint`][eslint-lint] | โœ… | โœ… | โœ… | โœ… | -| [`go-build`][go-build] | โœ… | โœ… | โœ… | โœ… | -| [`go-lint`][go-lint] | โœ… | - | โœ… | โœ… | -| [`language-version-detect`][language-version-detect] | - | โœ… | โœ… | โœ… | -| [`npm-publish`][npm-publish] | โœ… | โœ… | โœ… | โœ… | -| [`php-tests`][php-tests] | โœ… | โœ… | โœ… | โœ… | -| [`pr-lint`][pr-lint] | โœ… | โœ… | โœ… | โœ… | -| [`pre-commit`][pre-commit] | - | โœ… | โœ… | โœ… | -| [`prettier-lint`][prettier-lint] | โœ… | โœ… | โœ… | โœ… | -| [`python-lint-fix`][python-lint-fix] | โœ… | โœ… | โœ… | โœ… | -| [`release-monthly`][release-monthly] | - | - | โœ… | โœ… | -| [`security-scan`][security-scan] | โœ… | - | โœ… | โœ… | -| [`stale`][stale] | - | - | โœ… | โœ… | -| [`sync-labels`][sync-labels] | - | - | โœ… | โœ… | -| [`terraform-lint-fix`][terraform-lint-fix] | - | - | โœ… | โœ… | -| [`validate-inputs`][validate-inputs] | - | - | โœ… | โœ… | +|:-----------------------------------------------------|:-------:|:--------------:|:----------:|:-------:| +| [`action-versioning`][action-versioning] | - | - | โœ… | โœ… | +| [`ansible-lint-fix`][ansible-lint-fix] | โœ… | - | โœ… | โœ… | +| [`biome-lint`][biome-lint] | โœ… | โœ… | โœ… | โœ… | +| [`codeql-analysis`][codeql-analysis] | - | โœ… | โœ… | โœ… | +| [`compress-images`][compress-images] | - | - | โœ… | โœ… | +| [`csharp-build`][csharp-build] | โœ… | โœ… | โœ… | โœ… | +| [`csharp-lint-check`][csharp-lint-check] | โœ… | โœ… | โœ… | โœ… | +| [`csharp-publish`][csharp-publish] | โœ… | โœ… | โœ… | โœ… | +| [`docker-build`][docker-build] | โœ… | โœ… | โœ… | โœ… | +| [`docker-publish`][docker-publish] | - | - | โœ… | โœ… | +| [`eslint-lint`][eslint-lint] | โœ… | โœ… | โœ… | โœ… | +| [`go-build`][go-build] | โœ… | โœ… | โœ… | โœ… | +| [`go-lint`][go-lint] | โœ… | - | โœ… | โœ… | +| [`language-version-detect`][language-version-detect] | - | โœ… | โœ… | โœ… | +| [`npm-publish`][npm-publish] | โœ… | โœ… | โœ… | โœ… | +| [`php-tests`][php-tests] | โœ… | โœ… | โœ… | โœ… | +| [`pr-lint`][pr-lint] | โœ… | โœ… | โœ… | โœ… | +| [`pre-commit`][pre-commit] | - | โœ… | โœ… | โœ… | +| [`prettier-lint`][prettier-lint] | โœ… | โœ… | โœ… | โœ… | +| [`python-lint-fix`][python-lint-fix] | โœ… | โœ… | โœ… | โœ… | +| [`release-monthly`][release-monthly] | - | - | โœ… | โœ… | +| [`security-scan`][security-scan] | โœ… | - | โœ… | โœ… | +| [`stale`][stale] | - | - | โœ… | โœ… | +| [`sync-labels`][sync-labels] | - | - | โœ… | โœ… | +| [`terraform-lint-fix`][terraform-lint-fix] | - | - | โœ… | โœ… | +| [`validate-inputs`][validate-inputs] | - | - | โœ… | โœ… | ### Language Support | Language | Actions | -| :------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------- | +|:---------------------|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------| | .NET | [`csharp-build`][csharp-build], [`csharp-lint-check`][csharp-lint-check], [`csharp-publish`][csharp-publish], [`language-version-detect`][language-version-detect] | | Ansible | [`ansible-lint-fix`][ansible-lint-fix] | | C# | [`codeql-analysis`][codeql-analysis], [`csharp-build`][csharp-build], [`csharp-lint-check`][csharp-lint-check], [`csharp-publish`][csharp-publish] |