Skip to content

Add GitHub Issues tracker adapter#103

Merged
frantic-openai merged 2 commits into
mainfrom
codex/github-tracker
Jul 20, 2026
Merged

Add GitHub Issues tracker adapter#103
frantic-openai merged 2 commits into
mainfrom
codex/github-tracker

Conversation

@frantic-openai

Copy link
Copy Markdown
Collaborator

Context

Symphony's generic tracker seam needs a real non-Linear stress test without adding generic mutation APIs.

TL;DR

Add GitHub Issues reads and a host-authenticated raw GitHub tool.

Summary

  • Add project-scoped GitHub issue reads, normalization, and dispatchability.
  • Add raw github_api for provider-native mutations with host-side auth.
  • Add contract tests, live E2E proof, and GitHub adapter documentation.

Alternatives

  • Generic CRUD was rejected because it would flatten GitHub-specific capabilities.
  • GraphQL was rejected for v1 because REST covers the required reads and tool flow simply.

Test Plan

  • make -C elixir all
  • SYMPHONY_RUN_GITHUB_LIVE_E2E=1 mix test test/symphony_elixir/github_live_e2e_test.exs
  • SYMPHONY_RUN_LIVE_E2E=1 SYMPHONY_LIVE_LINEAR_TEAM_KEY=FST mix test test/symphony_elixir/live_e2e_test.exs:123

frantic-openai and others added 2 commits July 17, 2026 23:52
Summary:
- Add GitHub Issues polling, normalization, and repository-scoped
  reconciliation behind the generic tracker read boundary.
- Expose host-authenticated github_api while stripping declared token
  environments from Codex children.
- Add contract coverage, a real opt-in GitHub E2E, and adapter docs.

Rationale:
- Keep the scheduler provider-neutral while giving GitHub workflows
  native REST capabilities without duplicate agent auth.
- Use GH-<number> as a route-safe scoped identifier and keep GitHub
  details in native_ref.

Tests:
- make all
- SYMPHONY_RUN_GITHUB_LIVE_E2E=1 mix test
  test/symphony_elixir/github_live_e2e_test.exs
- SYMPHONY_RUN_LIVE_E2E=1 mix test
  test/symphony_elixir/live_e2e_test.exs:123

Co-authored-by: Codex <codex@openai.com>
Summary:
- Reduce the GitHub adapter notes to configuration, scoped reads, and
  host-authenticated tool behavior.
- Keep the live test command while removing implementation narration.

Rationale:
- The README should explain how to use the adapter without duplicating
  provider implementation details or error catalogs.

Tests:
- git diff --check

Co-authored-by: Codex <codex@openai.com>
@frantic-openai
frantic-openai merged commit 044f204 into main Jul 20, 2026
2 checks passed
@frantic-openai
frantic-openai deleted the codex/github-tracker branch July 20, 2026 18:00
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.

1 participant