feat(mcp): add current-branch GitHub status hints

[oktofeesh1]

Summary

• bind cached GitHub PR status to current local branch analysis
• surface approved, pending, failing, and needs-author branch states
• include public-safe GitHub status context in generated PR packets

What changed

• matches current branch metadata by head SHA or branch ref
• adds branch findings for failing checks, requested changes, and incomplete status data
• tests PR-found, no-PR, failing status, approved review, and unavailable-status fallback cases
• keeps readiness integration fixtures current so freshness SLO assertions remain deterministic in CI

Why

• branch preflight should explain already-known GitHub review/check state before contributors ask maintainers for review.

Validation

• git diff --check
• npx tsc --noEmit
• npx vitest run test/unit/local-branch.test.ts
• npm run test:coverage
• GitHub validate, Contributor trust, and Superagent Security Scan pass on the latest head

Closes #102

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: c5311f5f5c

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 4b2b4bb4a7

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

[JSONbored]

@oktofeesh1 this is merge-ready from my pass.

• Deterministic: check rollup is green and merge-tree against current origin/main is clean.
• Maintainer judgment: current-branch GitHub status is now wired into local branch analysis, MCP/API paths, PR packet output, and schema coverage.
• Validation: tests cover branch matching, base-ref matching, failing/pending checks, drafts, requested changes, and public-safe packet output.