feat(core): capability namespace standardization

.changeset/capability-namespace-standardization.md

@@ -0,0 +1,57 @@
+---
+"@ghx-dev/core": minor
+---
+
+Standardize all capability IDs to consistent naming conventions.
+
+**Renamed capabilities:**
+
+- `pr.thread.*` → `pr.threads.*` (list, reply, resolve, unresolve)
+- `pr.review.*` → `pr.reviews.*` (list, request, submit)
+- `pr.checks.rerun_all` → `pr.checks.rerun.all`
+- `pr.checks.rerun_failed` → `pr.checks.rerun.failed`
+- `workflow.get` → `workflow.view`
+- `workflow.dispatch.run` → `workflow.dispatch`
+- `workflow.run.rerun_all` → `workflow.run.rerun.all`
+- `workflow.run.rerun_failed` → `workflow.run.rerun.failed`
+- `workflow.job.logs.get` → `workflow.job.logs.view`
+- `project_v2.org.get` → `project_v2.org.view`
+- `project_v2.user.get` → `project_v2.user.view`
+- `project_v2.item.add_issue` → `project_v2.items.issue.add`
+- `project_v2.item.field.update` → `project_v2.items.field.update`
+- `release.get` → `release.view`
+- `release.create_draft` → `release.create`
+- `release.publish_draft` → `release.publish`
+- `issue.labels.update` → `issue.labels.set`
+- `issue.assignees.update` → `issue.assignees.set`
+- `issue.relations.get` → `issue.relations.view`
+- `issue.linked_prs.list` → `issue.relations.prs.list`
+- `issue.parent.set` → `issue.relations.parent.set`
+- `issue.parent.remove` → `issue.relations.parent.remove`
+- `issue.blocked_by.add` → `issue.relations.blocked_by.add`
+- `issue.blocked_by.remove` → `issue.relations.blocked_by.remove`
+
+**New capabilities:**
+
+- `issue.labels.remove` — remove specific labels from an issue
+- `issue.assignees.add` — add assignees without replacing existing
+- `issue.assignees.remove` — remove specific assignees
+- `issue.milestone.clear` — remove milestone from an issue
+- `pr.assignees.add` — add assignees to a PR
+- `pr.assignees.remove` — remove assignees from a PR
+- `project_v2.items.issue.remove` — remove an issue from a Projects v2 project
+
+**Retired capabilities:**
+
+- `pr.checks.failed` — merged into `pr.checks.list` (use `state: "failed"` filter)
+- `check_run.annotations.list` — annotations now inline in `pr.checks.list` output
+- `pr.assignees.update` — replaced by `pr.assignees.add` + `pr.assignees.remove`
+- `pr.threads.composite`, `issue.triage.composite`, `issue.update.composite` — composite infrastructure removed
+
+**Output schema changes:**
+
+- All rerun capabilities now return `{ runId: integer, queued: boolean }` (normalized)
+- `pr.threads.reply` output now includes `commentId` and `commentUrl`
+- `issue.relations.parent.set` output now includes `updated: boolean`
+- `issue.relations.blocked_by.add` output now includes `added: boolean`
+- `issue.milestone.set` no longer accepts `null` (use `issue.milestone.clear` instead)

docs/capabilities/README.md

@@ -1,6 +1,6 @@
 # Capabilities Reference
 
-Welcome to ghx's comprehensive capabilities reference. These 69 capabilities form the
+Welcome to ghx's comprehensive capabilities reference. These capabilities form the
 core of ghx's ability to automate GitHub workflows for AI agents.
 
 Capabilities are organized by domain — from managing issues and pull requests to
@@ -62,21 +62,20 @@ graph TB
 | `pr.merge` | Execute a pull request merge. | cli (preferred) |
 | `pr.merge.status` | View pull request mergeability and readiness signals. | graphql (preferred), cli (fallback) |
 | `pr.branch.update` | Update pull request branch with latest base changes. | cli (preferred) |
-| `pr.assignees.update` | Update pull request assignees. | cli (preferred) |
-| `pr.thread.list` | List pull request review threads. | graphql (preferred) |
-| `pr.thread.reply` | Reply to a pull request review thread. | graphql (preferred) |
-| `pr.thread.resolve` | Resolve a pull request review thread. | graphql (preferred) |
-| `pr.thread.unresolve` | Unresolve a pull request review thread. | graphql (preferred) |
-| `pr.review.list` | List pull request reviews. | graphql (preferred) |
-| `pr.review.submit` | Submit a pull request review (approve, request changes, or comment). | graphql (preferred) |
-| `pr.review.request` | Request pull request reviewers. | cli (preferred) |
+| `pr.assignees.add` | Add assignees to a pull request. | cli (preferred) |
+| `pr.assignees.remove` | Remove assignees from a pull request. | cli (preferred) |
+| `pr.threads.list` | List pull request review threads. | graphql (preferred) |
+| `pr.threads.reply` | Reply to a pull request review thread. | graphql (preferred) |
+| `pr.threads.resolve` | Resolve a pull request review thread. | graphql (preferred) |
+| `pr.threads.unresolve` | Unresolve a pull request review thread. | graphql (preferred) |
+| `pr.reviews.list` | List pull request reviews. | graphql (preferred) |
+| `pr.reviews.submit` | Submit a pull request review (approve, request changes, or comment). | graphql (preferred) |
+| `pr.reviews.request` | Request pull request reviewers. | cli (preferred) |
 | `pr.checks.list` | List PR check statuses with summary counts. | cli (preferred) |
-| `pr.checks.failed` | List failed pull request checks. | cli (preferred) |
-| `pr.checks.rerun_all` | Rerun all PR workflow checks for a selected run. | cli (preferred) |
-| `pr.checks.rerun_failed` | Rerun failed PR workflow checks for a selected run. | cli (preferred) |
+| `pr.checks.rerun.all` | Rerun all PR workflow checks for a selected run. | cli (preferred) |
+| `pr.checks.rerun.failed` | Rerun failed PR workflow checks for a selected run. | cli (preferred) |
 | `pr.diff.files` | List changed files in a pull request diff. | graphql (preferred) |
 | `pr.diff.view` | View the unified diff for a pull request. | cli (preferred) |
-| `pr.threads.composite` | Batch thread reply/resolve operations in a single GraphQL call. | graphql (preferred) |
 | **Releases (5)** |
 | `release.create_draft` | Create a draft release. | cli (preferred) |
 | `release.get` | Get release details by tag name. | cli (preferred) |
@@ -106,8 +105,6 @@ graph TB
 | `project_v2.items.list` | List items in a Projects v2 project. | cli (preferred) |
 | `project_v2.item.add_issue` | Add an issue to a Projects v2 project. | cli (preferred) |
 | `project_v2.item.field.update` | Update a field on a Projects v2 project item. | cli (preferred) |
-| **Check Runs (1)** |
-| `check_run.annotations.list` | List annotations for one check run. | cli (preferred) |
 
 ## Domain Documentation