Skip to content

refactor(cli): consolidate automation discovery#758

Merged
steipete merged 4 commits into
mainfrom
feat/cli-capabilities-677
Jun 11, 2026
Merged

refactor(cli): consolidate automation discovery#758
steipete merged 4 commits into
mainfrom
feat/cli-capabilities-677

Conversation

@steipete

@steipete steipete commented Jun 11, 2026

Copy link
Copy Markdown
Collaborator

Summary

  • remove the separate gog agent, gog capabilities, and gog exit-codes discovery commands
  • add a concise automation contract to root --help
  • expose output formats, stable exit codes, effective command guards, no-send state, and baked safety profile through gog schema --json
  • use MCP protocol tools/list and gog mcp --list-tools; remove the redundant model-callable discovery tool
  • update the CLI skill, README, automation guide, generated docs, and bundled safety profiles

Automation behavior belongs to the CLI as a whole, not a special command namespace.

Closes #677.

Safety

  • schema discovery remains local and does not open the keyring
  • effective no-send state resolves GOG_ACCOUNT, account aliases, global config, and command-line flags
  • schema resets result projections and untrusted-content wrapping so trusted command metadata remains stable
  • no account identity, credentials, tokens, scopes, or key material are returned

Verification

  • make ci
  • structured autoreview: clean after fixing alias-aware no-send resolution and schema projection isolation
  • built binary smoke: root automation help, schema automation metadata, removed command parse paths, MCP tool listing
  • generated docs: 629 command pages and 23 feature pages

No live Google API smoke is required: this change only exposes local CLI metadata and removes discovery commands; it does not alter authenticated service behavior.

@clawsweeper

clawsweeper Bot commented Jun 11, 2026

Copy link
Copy Markdown
Contributor

Codex review: needs maintainer review before merge. Reviewed June 11, 2026, 6:05 PM ET / 22:05 UTC.

Summary
Review failed before ClawSweeper could summarize the requested change.

Reproducibility: unclear. The review failed before ClawSweeper could establish a reproduction path.

Review metrics: none identified.

Merge readiness
Overall: 🌊 off-meta tidepool
Proof: 🌊 off-meta tidepool
Patch quality: 🌊 off-meta tidepool
Result: rating does not apply to this item.

Overall follows the weaker of proof and patch quality, so missing proof can cap an otherwise strong patch.

Risk before merge

  • [P1] No close action taken because the review did not complete.

Maintainer options:

  1. Decide the mitigation before merge
    Retry the Codex review after fixing the execution failure.
  2. Pause or close
    Do not merge this PR until maintainers decide whether the risk is worth taking.

Next step before merge

  • Review did not complete, so no work-lane recommendation was made.
Review details

Best possible solution:

Retry the Codex review after fixing the execution failure.

Do we have a high-confidence way to reproduce the issue?

Unclear. The review failed before ClawSweeper could establish a reproduction path.

Is this the best way to solve the issue?

Unclear. Retry the review first so ClawSweeper can evaluate the actual issue and fix direction.

AGENTS.md: unclear because the file could not be read completely.

Codex review notes: model internal, reasoning high; reviewed against 1d2246317f44.

Label changes

Label justifications:

  • rating: 🌊 off-meta tidepool: Overall readiness is 🌊 off-meta tidepool; proof is 🌊 off-meta tidepool and patch quality is 🌊 off-meta tidepool.
Evidence reviewed

What I checked:

  • failure reason: retryable codex transport failure.
  • codex failure detail: Codex review failed for this PR with exit 1.
  • codex stderr: horAssociation": "NONE",.
  • codex stdout: No stdout captured.

Likely related people:

  • unknown: Codex failed before it could trace repository history. (role: review did not complete; confidence: low)
What the crustacean ranks mean
  • 🦀 challenger crab: rare, exceptional readiness with strong proof, clean implementation, and convincing validation.
  • 🦞 diamond lobster: very strong readiness with only minor maintainer review expected.
  • 🐚 platinum hermit: good normal PR, likely mergeable with ordinary maintainer review.
  • 🦐 gold shrimp: useful signal, but proof or patch confidence is still limited.
  • 🦪 silver shellfish: thin signal; proof, validation, or implementation needs work.
  • 🧂 unranked krab: not merge-ready because proof is missing/unusable or there are serious correctness or safety concerns.
  • 🌊 off-meta tidepool: rating does not apply to this item.

Shiny media proof means a screenshot, video, or linked artifact directly shows the changed behavior. Runtime, network, CSP, and security claims still need visible diagnostics.

How this review workflow works
  • ClawSweeper keeps one durable marker-backed review comment per issue or PR.
  • Re-runs edit this comment so the latest verdict, findings, and automation markers stay together instead of adding duplicate bot comments.
  • A fresh review can be triggered by eligible @clawsweeper re-review comments, exact-item GitHub events, scheduled/background review runs, or manual workflow dispatch.
  • PR/issue authors and users with repository write access can comment @clawsweeper re-review or @clawsweeper re-run on an open PR or issue to request a fresh review only.
  • Maintainers can also comment @clawsweeper review to request a fresh review only.
  • Fresh-review commands do not start repair, autofix, rebase, CI repair, or automerge.
  • Maintainer-only repair and merge flows require explicit commands such as @clawsweeper autofix, @clawsweeper automerge, @clawsweeper fix ci, or @clawsweeper address review.
  • Maintainers can comment @clawsweeper explain to ask for more context, or @clawsweeper stop to stop active automation.

@clawsweeper clawsweeper Bot added the rating: 🌊 off-meta tidepool PR readiness rating does not apply to this item. label Jun 11, 2026

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 1042e8b07f

ℹ️ About Codex in GitHub

Your team has set up Codex to 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 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread internal/cmd/capabilities.go Outdated
Comment on lines +146 to +150
Discovery: capabilityDiscovery{
SchemaCommand: "gog schema --json",
ExitCodesCommand: "gog exit-codes --json",
MCPToolsCommand: "gog mcp --list-tools",
},

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Filter unavailable discovery commands

When capabilities is run under an active command guard that allows this command but blocks the advertised discovery commands, the snapshot still tells automation to run commands that will immediately fail; for example, gog --enable-commands=capabilities capabilities --json reports gog schema --json, gog exit-codes --json, and gog mcp --list-tools even though the same --enable-commands setting rejects each of them. Since this endpoint is meant to describe the active runtime capability surface, please omit or mark discovery commands that are blocked by the current allow/deny rules or baked profile.

Useful? React with 👍 / 👎.

@steipete steipete changed the title feat(cli): add runtime capability discovery refactor(cli): consolidate automation discovery Jun 11, 2026
@steipete
steipete merged commit 02291d2 into main Jun 11, 2026
12 of 13 checks passed
@steipete
steipete deleted the feat/cli-capabilities-677 branch June 11, 2026 22:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

rating: 🌊 off-meta tidepool PR readiness rating does not apply to this item.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Support auth.md-based capability discovery for agent and MCP clients

1 participant