feat(auth): a one-call "am I ready to push a new repo" readiness check #841

New issue

Open

opened 2026-10-20 16:50:34 +00:00 by hexajon · 0 comments

hexajon commented

2026-10-20 16:50:34 +00:00

Owner

What happens

Before I create and push a new remote, I want one call that answers "am I set up to do this?". auth whoami reports identity and token scopes, but it does not map those scopes to the question I actually have: can I create a repo and push to it on the forge that this context resolves, right now. I infer readiness from partial scope output, which is guesswork.

Fix

Add a readiness check: one call that reports whether the resolved forge can be reached and authenticated and has the scopes to create a repo and push, and that names the exact missing step when it cannot. ADR 0025 resolves that forge from origin, or from the session forge outside a repo. This can be a mode of the identity command, or a small auth check.

Acceptance criteria

One call reports whether the resolved forge is reachable, authenticated, and scoped to create a repo and push.
When a prerequisite is missing, the output names the exact missing step.
The check resolves the forge as ADR 0025 does: origin first, session forge outside a repo.
The CLI and the MCP surface both expose it (ADR 0014 parity).

ADR 0025 (origin-first forge resolution), #419 (login scope), #747 (first-call success).

## What happens Before I create and push a new remote, I want one call that answers "am I set up to do this?". `auth whoami` reports identity and token scopes, but it does not map those scopes to the question I actually have: can I create a repo and push to it on the forge that this context resolves, right now. I infer readiness from partial scope output, which is guesswork. ## Fix Add a readiness check: one call that reports whether the resolved forge can be reached and authenticated and has the scopes to create a repo and push, and that names the exact missing step when it cannot. ADR 0025 resolves that forge from origin, or from the session forge outside a repo. This can be a mode of the identity command, or a small `auth check`. ## Acceptance criteria - One call reports whether the resolved forge is reachable, authenticated, and scoped to create a repo and push. - When a prerequisite is missing, the output names the exact missing step. - The check resolves the forge as ADR 0025 does: origin first, session forge outside a repo. - The CLI and the MCP surface both expose it (ADR 0014 parity). ## Related - ADR 0025 (origin-first forge resolution), #419 (login scope), #747 (first-call success).

No milestone

No project

No assignees

1 participant

Notifications

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference

sixfold-space/madtea#841

No description provided.

Rows
Columns