koala73 / koala73/worldmonitor

feat(auth): carry WWW-Authenticate resource_metadata on API entry-point 401s (RFC 9728 discovery)

Open
#4,840 1 comment 0 reactions 0 assignees View on GitHub
agent-readiness area: API enhancement
Dominant language
TypeScript
Stars
86.6k
Forks
13.1k
Avg merge
8h 4m
Merged PRs (30d)
825

Description

From the 2026-07-05 orank scan: `agent-auth-www-authenticate` (bonus, estScoreGain **0**) probes API entry points (`/api`, `/api/v1`, `/mcp`, `api.worldmonitor.app/...`) for a 401 carrying:

```
WWW-Authenticate: Bearer resource_metadata="https://worldmonitor.app/.well-known/oauth-protected-resource"
```

We already publish the protected-resource metadata document — this is just the spec-shaped (RFC 9728 §5) pointer on the 401 itself, so an agent learns the auth requirements from one request instead of hunting for the well-known doc.

Deliberately deferred from the bucket A pass (#4820/#4824/#4838): orank reports zero score gain, and it touches the gateway/MCP auth response path (contract-test-pinned), so it's spec-correctness work, not score work. `api/mcp/auth.ts` already exports a `wwwAuthHeader` helper — likely most of the job.

https://claude.ai/code/session_016LG2b5W6EH7mEGSxuRGUry

Contributor guide

Open the contributing guide

Research direction

Start in api/mcp/auth.ts, where the existing wwwAuthHeader helper is exported, and trace the gateway/MCP authentication response path for API entry-point 401s such as /api, /api/v1, and /mcp. Review the contract tests that pin this response, then verify that qualifying 401s carry the RFC 9728 resource_metadata pointer to the published protected-resource document.

Written by the indexing model from the issue text.

Assessment

Tech stack
typescript
Domain
api, authentication
Issue type
Feature
Difficulty
3/5
Estimated time
1-2 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
58/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.