standardize justfiles

Author: woutervh

.just/gh.justfile

@@ -1,98 +1,248 @@
-# GitHub CLI commands
-# docs: https://cli.github.com/manual/
+# GitHub CLI (gh) commands
+# https://cli.github.com/manual/
 
 
-# list open pull requests
+# show repository info
 [group: 'gh']
-gh-pr-list:
-    gh pr list --state open
+gh-repo-view:
+    gh repo view
 
 
-# list all pull requests (open and closed)
+# list pull requests
 [group: 'gh']
-gh-pr-list-all:
-    gh pr list --state all --limit 20
+gh-pr-list limit="10":
+    gh pr list --limit {{limit}}
 
 
-# view a specific pull request
+# list all pull requests (including closed)
 [group: 'gh']
-gh-pr-view pr:
-    gh pr view {{ pr }}
+gh-pr-list-all limit="10":
+    gh pr list --state all --limit {{limit}}
 
 
-# close a pull request with comment
+# view specific pull request
 [group: 'gh']
-gh-pr-close pr comment="Closing PR":
-    gh pr close {{ pr }} --comment "{{ comment }}"
+gh-pr-view pr_number:
+    gh pr view {{pr_number}}
 
 
-# merge a pull request
+# create a new pull request
 [group: 'gh']
-gh-pr-merge pr:
-    gh pr merge {{ pr }}
+gh-pr-create:
+    gh pr create
 
 
-# list recent workflow runs
+# checkout a pull request locally
 [group: 'gh']
-gh-run-list:
-    gh run list --limit 10
+gh-pr-checkout pr_number:
+    gh pr checkout {{pr_number}}
 
 
-# view a specific workflow run
+# list issues
 [group: 'gh']
-gh-run-view run:
-    gh run view {{ run }}
+gh-issue-list limit="10":
+    gh issue list --limit {{limit}}
 
 
-# view failed logs for a workflow run
+# view specific issue
 [group: 'gh']
-gh-run-failed run:
-    gh run view {{ run }} --log-failed
+gh-issue-view issue_number:
+    gh issue view {{issue_number}}
 
 
-# watch a workflow run in progress
+# create a new issue
 [group: 'gh']
-gh-run-watch run:
-    gh run watch {{ run }}
+gh-issue-create:
+    gh issue create
 
 
-# list dependabot security alerts
+# list workflow runs
 [group: 'gh']
-gh-alerts:
-    gh api repos/:owner/:repo/dependabot/alerts --jq '.[] | select(.state == "open") | {number, severity: .security_advisory.severity, package: .security_vulnerability.package.name, summary: .security_advisory.summary}'
+gh-run-list limit="10":
+    gh run list --limit {{limit}}
 
 
-# list all dependabot alerts (open and fixed)
+# list runs for specific workflow
 [group: 'gh']
-gh-alerts-all:
-    gh api repos/:owner/:repo/dependabot/alerts --jq '.[] | {number, state, severity: .security_advisory.severity, package: .security_vulnerability.package.name}'
+gh-run-list-workflow workflow limit="10":
+    gh run list --workflow "{{workflow}}" --limit {{limit}}
 
 
-# dismiss a dependabot alert
+# view specific workflow run
 [group: 'gh']
-gh-alert-dismiss alert reason="not_used":
-    gh api --method PATCH repos/:owner/:repo/dependabot/alerts/{{ alert }} -f state=dismissed -f dismissed_reason={{ reason }}
+gh-run-view run_id:
+    gh run view {{run_id}}
 
 
-# view repository info
+# watch a workflow run in real-time
 [group: 'gh']
-gh-repo-view:
-    gh repo view
+gh-run-watch run_id:
+    gh run watch {{run_id}}
+
+
+# list GitHub Actions caches
+[group: 'gh']
+gh-cache-list limit="20":
+    gh cache list --limit {{limit}}
+
+
+# delete a specific cache
+[group: 'gh']
+gh-cache-delete cache_id:
+    gh cache delete {{cache_id}}
+
+
+# delete all caches (requires confirmation)
+[group: 'gh']
+gh-cache-delete-all:
+    gh cache delete --all
+
+
+# list workflow files
+[group: 'gh']
+gh-workflow-list:
+    gh workflow list
+
+
+# view workflow file
+[group: 'gh']
+gh-workflow-view workflow:
+    gh workflow view "{{workflow}}"
+
+
+# enable a workflow
+[group: 'gh']
+gh-workflow-enable workflow:
+    gh workflow enable "{{workflow}}"
+
+
+# disable a workflow
+[group: 'gh']
+gh-workflow-disable workflow:
+    gh workflow disable "{{workflow}}"
+
+
+# trigger a workflow manually (workflow_dispatch)
+[group: 'gh']
+gh-workflow-run workflow:
+    gh workflow run "{{workflow}}"
+
+
+# list releases
+[group: 'gh']
+gh-release-list limit="10":
+    gh release list --limit {{limit}}
+
+
+# view latest release
+[group: 'gh']
+gh-release-view-latest:
+    gh release view --latest
+
+
+# create a new release
+[group: 'gh']
+gh-release-create tag:
+    gh release create {{tag}}
+
+
+# list repository secrets
+[group: 'gh']
+gh-secret-list:
+    gh secret list
+
+
+# set a repository secret
+[group: 'gh']
+gh-secret-set name value:
+    echo "{{value}}" | gh secret set {{name}}
+
+
+# delete a repository secret
+[group: 'gh']
+gh-secret-delete name:
+    gh secret delete {{name}}
+
+
+# view repository status (checks, deployments, etc)
+[group: 'gh']
+gh-status:
+    gh status
+
+
+# list repository collaborators
+[group: 'gh']
+gh-api-collaborators:
+    gh api repos/{owner}/{repo}/collaborators
+
+
+# view rate limit status
+[group: 'gh']
+gh-api-rate-limit:
+    gh api rate_limit
+
+
+# clone repository
+[group: 'gh']
+gh-repo-clone repo:
+    gh repo clone {{repo}}
+
+
+# fork repository
+[group: 'gh']
+gh-repo-fork:
+    gh repo fork
+
+
+# sync fork with upstream
+[group: 'gh']
+gh-repo-sync:
+    gh repo sync
+
+
+# browse repository in browser
+[group: 'gh']
+gh-browse:
+    gh browse
+
+
+# browse pull requests in browser
+[group: 'gh']
+gh-browse-pr:
+    gh browse --pulls
+
+
+# browse issues in browser
+[group: 'gh']
+gh-browse-issues:
+    gh browse --issues
+
+
+# browse actions in browser
+[group: 'gh']
+gh-browse-actions:
+    gh browse --actions
+
+
+# browse wiki in browser
+[group: 'gh']
+gh-browse-wiki:
+    gh browse --wiki
 
 
-# open repository in browser
+# list dependabot PRs
 [group: 'gh']
-gh-repo-browse:
-    gh repo view --web
+gh-pr-list-dependabot limit="10":
+    gh pr list --author app/dependabot --limit {{limit}}
 
 
-# open pull requests page in browser
+# list all dependabot PRs (including closed)
 [group: 'gh']
-gh-pr-browse:
-    gh pr list --web
+gh-pr-list-dependabot-all limit="20":
+    gh pr list --state all --author app/dependabot --limit {{limit}}
 
 
-# open actions page in browser
+# view GitHub Actions usage (billing)
 [group: 'gh']
-gh-actions-browse:
-    gh run list --web
+gh-api-actions-usage:
+    gh api repos/{owner}/{repo}/actions/billing/usage