Skip to content

ci(project): add tracker auto-add workflow#418

Merged
ss-o merged 5 commits into
mainfrom
feature-413-project-auto-add
May 20, 2026
Merged

ci(project): add tracker auto-add workflow#418
ss-o merged 5 commits into
mainfrom
feature-413-project-auto-add

Conversation

@ss-o
Copy link
Copy Markdown
Member

@ss-o ss-o commented May 20, 2026

Summary

  • add a reusable Project Tracker workflow that adds meta:org-tracked issues to Project 28
  • add the Project Tracker starter workflow template for other Z-Shell repositories
  • document Project 28, the expected built-in auto-add filter, the API visibility limitation, token requirements, and verification steps

Verification

  • Confirmed Project 28 exists as z-shell — Org-wide and created test issue test: verify meta org tracked project auto-add #417 with meta: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 --check
  • trunk check --show-existing --no-progress
  • git log -1 --show-signature --format=fuller

Closes #413
Refs #417

@ss-o ss-o requested a review from a team as a code owner May 20, 2026 05:59
Copilot AI review requested due to automatic review settings May 20, 2026 05:59
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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 via gh 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}"
@ss-o ss-o merged commit faa1e70 into main May 20, 2026
3 checks passed
@ss-o ss-o deleted the feature-413-project-auto-add branch May 20, 2026 09:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Configure org tracker auto-add for meta:org-tracked issues

2 participants