docs: reconcile public GitHub PR state - #214
Conversation
There was a problem hiding this comment.
Code Review
This pull request introduces a new maintenance document for public GitHub state reconciliation and updates the existing triage documentation. The review identified potential issues with the gh pr list and gh api commands, noting that the current limit of 100 may lead to inaccurate pull request counts as the backlog grows. Increasing these limits to 1000 is recommended to ensure accuracy.
| - Follow-up branch: `codex/public-github-state-reconciliation` | ||
| - Current baseline: public `main` after PR #203. | ||
| - `origin/main`: `f636c482031021b9d21aeea1cdef1f0252e51ece` | ||
| - GitHub source of truth: `gh pr list --state open --limit 100 --json number --jq length` |
There was a problem hiding this comment.
The --limit 100 flag in the gh pr list command will cause an incorrect count if the number of open pull requests exceeds 100. Consider increasing this limit to a higher value (e.g., 1000) to ensure the count remains accurate as the backlog grows.
| - GitHub source of truth: `gh pr list --state open --limit 100 --json number --jq length` | |
| - gh pr list --state open --limit 1000 --json number --jq length |
|
|
||
| Use GitHub API / `gh` as the operational source of truth for PR state. | ||
|
|
||
| - `gh pr list --state open --limit 100 --json number --jq length`: `43` |
There was a problem hiding this comment.
The --limit 100 flag in the gh pr list command will cause an incorrect count if the number of open pull requests exceeds 100. Consider increasing this limit to a higher value (e.g., 1000) to ensure the count remains accurate as the backlog grows.
| - `gh pr list --state open --limit 100 --json number --jq length`: `43` | |
| - gh pr list --state open --limit 1000 --json number --jq length: 43 |
| Use GitHub API / `gh` as the operational source of truth for PR state. | ||
|
|
||
| - `gh pr list --state open --limit 100 --json number --jq length`: `43` | ||
| - `gh api "/repos/YoneRai12/YonerAI/pulls?state=open&per_page=100" --jq length`: `43` |
There was a problem hiding this comment.
The gh api command using per_page=100 only returns the first page of results, which will lead to an incorrect count if there are more than 100 open pull requests. It is recommended to use gh pr list with a sufficiently high limit, as done in the previous line, for a more robust count.
| - `gh api "/repos/YoneRai12/YonerAI/pulls?state=open&per_page=100" --jq length`: `43` | |
| - gh pr list --state open --limit 1000 --json number --jq length: 43 |
Scope
gh, GitHub API, and public pull-list HTML all show43open PRs.docs/maintenance/PUBLIC_GITHUB_STATE_RECONCILIATION_2026_05_21.md.Validation
git diff --checkpassed.tokenhits are existing explanatory wording only.src/cogs/ora.py: unchanged.reference_clawdbot: untouched.Non-claims
This does not claim production readiness, shipping completion, official cloud completion, hybrid completion, full security backlog completion, full dependency backlog completion, persistent memory, Google login, Discord gateway completion, Tools/MCP completion, provider ecosystem completion, or
src/cogs/ora.pyresolution.Traceability