docs: plan auth admin read surface

This commit is contained in:
lda
2026-06-06 11:21:50 +07:00 Verified
parent 645d9f3c5d
commit 58771e4423
3 changed files with 927 additions and 0 deletions
@@ -164,6 +164,30 @@ Live source checks and source registry apply should prefer diagnostics over late
adapter failures. Runtime invocation can still fail if the upstream server
requires auth but does not declare that requirement.
## Read-Only Display
Read-only admin surfaces may show that an auth record exists, but they must not
promise provider-specific display until auth records are concrete variants.
For the current `scheme + payload` bridge, safe display should stay intentionally
minimal:
- `id`
- `scheme`
- `metadata`
- `payload_keys`
Do not expose payload values. Do not promise token hints, OAuth subjects,
expiry, scopes, header names, or environment-variable names as the stable
neutral contract yet. Once auth records become a discriminated union, each
variant can own a richer safe display method:
- bearer auth can show token presence or a redacted hint
- headers auth can show safe header names
- env auth can show safe environment variable names
- OAuth auth can show subject, expiry, scopes, and refreshability
- opaque auth can stay limited to scheme and payload keys
## Store Shape
The current filesystem store can remain: