Skip to content

Add native issue dependency and project workflow tools#2416

Open
ex-devo wants to merge 2 commits into
github:mainfrom
ex-devo:codex/github-workflow-tools
Open

Add native issue dependency and project workflow tools#2416
ex-devo wants to merge 2 commits into
github:mainfrom
ex-devo:codex/github-workflow-tools

Conversation

@ex-devo

@ex-devo ex-devo commented May 1, 2026

Copy link
Copy Markdown

Why

This adds higher-level GitHub workflow primitives for MCP clients that manage issue triage and Project V2 boards. The main use case is agent/backlog automation that needs to create an issue, add it to a project, set initial Status/Priority fields, adjust labels without replacing unrelated labels, and model issue dependency relationships without composing several lower-level REST/GraphQL calls client-side.

What Changed

  • Adds issue dependency reads to issue_read for issues blocked by another issue and issues blocking the current issue.
  • Adds issue_dependency_write for adding and removing blocked_by dependency relationships.
  • Adds issue_label_write so clients can add or remove selected issue labels while preserving unrelated labels.
  • Expands Project V2 workflows so clients can resolve/update project items by linked issue or pull request identity, return numeric project item IDs, expose content labels, and update multiple fields in one call.
  • Adds create_project_issue to create an issue, add it to a Project V2 board, and set initial Status/Priority fields in one workflow-oriented operation.
  • Updates tool snapshots and unit coverage for the new/changed tool schemas and response behavior.

Notes for Reviewers

  • This branch was rebased onto the current upstream main before opening the PR.
  • I did not find a PR template in the repository, so this description follows the repo's CONTRIBUTING.md guidance directly.
  • I do not have a linked issue for this change; the intended scenario is the agentic workflow/project-board use case described above.
  • The change is intentionally scoped to GitHub issue, label, dependency, and Project V2 workflow tooling.

Test Plan

  • Not run: go test -v ./... because the go binary is not installed in this environment.
  • Not run: golangci-lint run / script/lint because the Go toolchain and linter are not installed in this environment.
  • Not run: UPDATE_TOOLSNAPS=true go test ./... because the go binary is not installed in this environment.
  • Not run: script/generate-docs because the local toolchain needed by this repository is unavailable in this environment.
ex-devo added 2 commits May 1, 2026 13:09
- Adds issue dependency read operations so agents can inspect blockers and downstream blocked work through the issue read tool

- Adds issue dependency write support so agents can create and remove native blocked-by relationships without relying on issue comments

- Registers the dependency tool and updates tests and tool snapshots so the GitHub workflow exposes blocker management consistently
- Adds explicit issue and project item identifiers so workflow agents can connect issues, project items, sub-issues, and dependencies without parsing ambiguous response IDs
- Adds safe issue label mutation so readiness labels can be added and removed without replacing unrelated labels
- Adds project item updates by issue or pull request identity with batched field updates so Status and Priority changes no longer require brittle project item lookup steps
- Adds project issue creation that creates the issue, adds it to the project, and applies initial Status and Priority for the common backlog workflow
- Updates tool metadata and tests to document the safer GitHub workflow surface and preserve existing compatible paths
@ex-devo ex-devo requested a review from a team as a code owner May 1, 2026 11:11
@SamMorrowDrums

Copy link
Copy Markdown
Collaborator

Tracking: this PR appears to address #2391 for the native issue dependency portion of the change set.

@SamMorrowDrums

Copy link
Copy Markdown
Collaborator

Tracking: this PR appears to address #2391 for the native issue dependency portion of the change set.

@eshaffer321

Copy link
Copy Markdown

Overlaps with #1927 and #950

@SamMorrowDrums

Copy link
Copy Markdown
Collaborator

Tracking link: this PR appears to implement issue #2391.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

4 participants