Skip to content

docs: qualify GitHub helper runtime paths #2641

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Chris0Jeky merged 2 commits into from
Sep 5, 2026
+1 −1
Merged

docs: qualify GitHub helper runtime paths #2641

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
0b394b3
docs: qualify GitHub helper runtime paths
Chris0Jeky Sep 5, 2026
965abde
docs: describe Claude's GitHub path as gh with the helpers where thei…
Chris0Jeky Sep 5, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/GITHUB_PROJECT_AUTOMATION.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -153,7 +153,7 @@ Local helper scripts:
- `scripts/github/New-TaskdeckDocsRehydrationChecklist.ps1` — list recently merged PRs and docs that may need rehydration.
- `scripts/github/Sync-TaskdeckProjectPriority.ps1` — audit issue/PR Project v2 `Priority` drift and optionally apply fixes.

These helpers are fallbacks for GitHub MCP gaps. Project v2 priority audit needs `read:project`; applying field updates with `Sync-TaskdeckProjectPriority.ps1 -Apply` requires `gh auth refresh -s project`.
Claude has no project GitHub MCP (`.mcp.json` omits it on purpose, 2026-09-02; see `docs/MCP_TOOLING_GUIDE.md`), so it reaches GitHub through `gh` and uses these helpers where their specific shape is needed. Codex uses them as a REST/CLI fallback when its configured GitHub MCP is unavailable or quota-limited. Project v2 priority audit needs `read:project`; applying field updates with `Sync-TaskdeckProjectPriority.ps1 -Apply` requires `gh auth refresh -s project`.
The sync helper enforces the PR rule above: complete same-repository closing issues take precedence over repository-aware body references, the highest derived urgency wins, and a PR with no authoritative issue references receives `Priority V`. If every closing Issue is external, the helper still evaluates the body for a same-repository fallback. Every body reference is resolved to a typed, repository-matching object. Only actual same-repository Issues contribute Priority labels. A validated PullRequest reference is ignored as a non-Issue. Cross-repository Issue authority is default-off: those references stay visible by exact PR/source/repository/number identity in human and JSON output, but their labels never enter ranking; mixed references derive only from same-repository Issues. An actual same-repository Issue whose priority is missing, ambiguous, unreadable, or identity-mismatched fails closed instead of becoming a fallback.

The priority helper's completeness contract is fail-closed:
Expand Down
Loading