ci(project): add tracker auto-add workflow#418
Merged
Conversation
This was referenced May 20, 2026
Contributor
There was a problem hiding this comment.
Pull request overview
Adds organization-wide “Project Tracker” automation so issues labeled meta:org-tracked can be auto-added to the z-shell — Org-wide GitHub Project (Project v2 #28), plus starter workflow and runbook documentation to roll the behavior out across Z-Shell repositories.
Changes:
- Introduces a reusable workflow (
.github/workflows/project-tracker.yml) to add issues to Project 28 viagh project item-add, and a starter workflow template to call it from other repos. - Documents the tracker/project identity, the preferred built-in Project auto-add filter, token requirements, and verification steps.
- Updates existing docs/indexes to reference the new runbook and starter workflow.
Reviewed changes
Copilot reviewed 7 out of 7 changed files in this pull request and generated 3 comments.
Show a summary per file
| File | Description |
|---|---|
workflow-templates/project-tracker.yml |
Adds a starter workflow that calls the reusable project-tracker workflow when meta:org-tracked is present. |
workflow-templates/project-tracker.properties.json |
Registers the starter workflow template metadata for “Actions > New workflow”. |
runbooks/triage.md |
Links triage guidance to the new project-tracker runbook. |
runbooks/project-tracker.md |
New runbook documenting Project 28, auto-add mechanisms, token requirements, and verification. |
AGENTS.md |
Adds the project-tracker runbook to the canonical “draft-only workflows” and “see also” lists. |
.github/workflows/project-tracker.yml |
New reusable workflow (and direct issues trigger) that adds labeled issues to Project 28. |
.github/README.md |
Documents the new “Project Tracker” starter workflow and links to the runbook. |
| uses: z-shell/.github/.github/workflows/project-tracker.yml@main | ||
| with: | ||
| issue_url: ${{ github.event.issue.html_url }} | ||
| secrets: inherit |
| uses: z-shell/.github/.github/workflows/project-tracker.yml@main | ||
| with: | ||
| issue_url: ${{ github.event.issue.html_url }} | ||
| secrets: inherit |
Comment on lines
+32
to
+55
| concurrency: | ||
| group: ${{ github.workflow }}-${{ github.event.issue.node_id || inputs.issue_url }} | ||
| cancel-in-progress: true | ||
|
|
||
| jobs: | ||
| add-tracked-issue: | ||
| name: Add tracked issue | ||
| if: >- | ||
| ${{ | ||
| github.event_name == 'workflow_call' || | ||
| contains(github.event.issue.labels.*.name, 'meta:org-tracked') | ||
| }} | ||
| runs-on: ubuntu-latest | ||
| env: | ||
| GH_TOKEN: ${{ secrets.Z_SHELL_PROJECT_TOKEN || github.token }} | ||
| ISSUE_URL: ${{ inputs.issue_url || github.event.issue.html_url }} | ||
| PROJECT_OWNER: ${{ inputs.project_owner || 'z-shell' }} | ||
| PROJECT_NUMBER: ${{ inputs.project_number || '28' }} | ||
| steps: | ||
| - name: Add issue to project | ||
| run: | | ||
| gh project item-add "${PROJECT_NUMBER}" \ | ||
| --owner "${PROJECT_OWNER}" \ | ||
| --url "${ISSUE_URL}" |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
meta:org-trackedissues to Project 28Verification
z-shell — Org-wideand created test issue test: verify meta org tracked project auto-add #417 withmeta:org-tracked; it was not auto-added before this implementation, so the built-in Project workflow is not currently sufficient from the observed behavior.ruby -e 'require "yaml"; Dir[".github/workflows/*.yml", "workflow-templates/*.yml", "actions/*/action.yml"].each { |f| YAML.load_file(f); puts "yaml ok #{f}" }'ruby -e 'require "json"; Dir["workflow-templates/*.properties.json"].each { |f| JSON.parse(File.read(f)); puts "json ok #{f}" }'git diff --checktrunk check --show-existing --no-progressgit log -1 --show-signature --format=fullerCloses #413
Refs #417