Skip to content

Conversation

@castrojo
Copy link
Contributor

Problem

The workflow from #187 fails because the default GITHUB_TOKEN doesn't have permission to access organization-level project boards.

Solution

  • Update workflow to use ORG_PROJECT_TOKEN repository secret if available, with fallback to GITHUB_TOKEN
  • Add comprehensive documentation on setting up a PAT with required scopes:
    • read:org - Access organization projects
    • read:project - Read project board data
    • write:discussion - Post to discussions
    • repo - Access repository data
  • Add .gitignore to prevent node_modules and .goose from being committed

Setup Instructions

An admin needs to:

  1. Create a GitHub PAT (classic) with the scopes listed above
  2. Add it as a repository secret named ORG_PROJECT_TOKEN
  3. The workflow will then automatically use it

Testing

Tested locally with gh auth token - script successfully:

  • Queries organization project board
  • Categorizes items by area labels with preserved badge colors
  • Generates formatted markdown report
  • Ready to post to discussions once token is configured

Related: #166

The default GITHUB_TOKEN does not have access to organization-level
projects. Update workflow to use ORG_PROJECT_TOKEN repository secret
if available, with fallback to GITHUB_TOKEN.

Add documentation explaining how to set up the required PAT with
proper scopes (read:org, read:project, write:discussion, repo) for
accessing organization projects and posting to discussions.

Also add .gitignore to prevent node_modules and .goose from being
committed.

Assisted-by: Claude 3.5 Sonnet via GitHub Copilot
@dosubot dosubot bot added the size:S This PR changes 10-29 lines, ignoring generated files. label Jan 26, 2026
@dosubot dosubot bot added area/dx Development experience (DX) - IDEs, dev tools kind/bug Something isn't working kind/documentation Improvements or additions to documentation labels Jan 26, 2026
Remove PAT requirement and use built-in GITHUB_TOKEN like other
workflows in this repository. The default GITHUB_TOKEN should have
sufficient permissions for reading organization projects and writing
to discussions.

Assisted-by: Claude 3.5 Sonnet via GitHub Copilot
@dosubot dosubot bot added size:XS This PR changes 0-9 lines, ignoring generated files. and removed size:S This PR changes 10-29 lines, ignoring generated files. labels Jan 26, 2026
@castrojo
Copy link
Contributor Author

Closing: Changes already merged in #187. The workflow already uses secrets.GITHUB_TOKEN. Will test the existing implementation directly.

@castrojo castrojo closed this Jan 26, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/dx Development experience (DX) - IDEs, dev tools kind/bug Something isn't working kind/documentation Improvements or additions to documentation size:XS This PR changes 0-9 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants