M109_003: drop dead UZ-AUTH-009/010 rows + record error-reference/hint fixes

[indykish]

Docs half of M109_003 (schema/registry drift reconciliation). Pairs with agentsfleet PR #474.

Changes

• api-reference/error-codes.mdx — removed the UZ-AUTH-009 and UZ-AUTH-010 rows. Both are producerless in the server registry (superseded by UZ-AUTH-022), contradicting this page's own generation note.
  • Kept UZ-AUTH-021 (struck-through historical row, per f64e20c "keep retired UZ-AUTH-021 visible") and the UZ-SLK-021 numbering-gap prose — both are intentional documentation, not dead rows.
• changelog.mdx — new Fixes / API entry for the error-reference cleanup and the UZ-PROVIDER-003 hint correction (the hint change itself ships in agentsfleet PR #474).

Verification

Corrected registry-vs-doc diff (union of error_entries.zig + error_entries_runtime.zig, named-constant entries included, deliberately-documented historical codes subtracted) is empty — no live-looking doc row lacks a producer.

🤖 Generated with Claude Code

Greptile Summary

This documentation-only PR removes two dead error-code rows (UZ-AUTH-009, UZ-AUTH-010) from api-reference/error-codes.mdx and adds a matching changelog entry. Both codes have no producer in the server registry (superseded by UZ-AUTH-022), making their removal a correctness fix aligned with the page's own "generated from the server's error registry" note.

• api-reference/error-codes.mdx — two rows dropped; UZ-AUTH-021 (struck-through historical entry) and all surrounding rows are untouched.
• changelog.mdx — new Fixes / API entry for this cleanup plus a UZ-PROVIDER-003 hint correction (the hint text is already correct in error-codes.mdx; the corresponding server-side change is tracked in agentsfleet PR #474).

Confidence Score: 5/5

Safe to merge — removes two dead documentation rows and adds a changelog entry with no structural side-effects.

Both changed files are documentation only. The row deletions are narrow and correct: UZ-AUTH-009 and UZ-AUTH-010 had no producer in the server registry and were superseded by UZ-AUTH-022. The retained historical entries (UZ-AUTH-021, UZ-SLK-021 gap prose) are untouched and intentional. The changelog entry accurately describes the error-reference cleanup; the UZ-PROVIDER-003 timing concern was raised in a prior review thread and is a known cross-PR coordination item.

No files require special attention.

Important Files Changed

Filename	Overview
api-reference/error-codes.mdx	Removed UZ-AUTH-009 and UZ-AUTH-010 rows; change is correct and minimal — surrounding entries are untouched and the retained UZ-AUTH-021 historical row is unaffected.
changelog.mdx	New Fixes/API Update block added; the UZ-AUTH-009/010 removal bullet is accurate; UZ-PROVIDER-003 entry is a cross-PR coordination concern already tracked in a previous review thread.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A[Server error registry\nerror_entries.zig +\nerror_entries_runtime.zig] -->|produces| B[UZ-AUTH-022\nInsufficient scope]
    A -->|no producer| C[UZ-AUTH-009\nInsufficient role ❌]
    A -->|no producer| D[UZ-AUTH-010\nUnsupported role ❌]
    B --> E[api-reference/error-codes.mdx\nAuthentication section]
    C -->|removed by this PR| E
    D -->|removed by this PR| E
    F[UZ-AUTH-021\nstruck-through historical] -->|intentionally kept| E
    E --> G[changelog.mdx\nFixes/API entry Jul 03 2026]

Loading

%%{init: {'theme': 'base', 'themeVariables': {"darkMode": true, "background": "#0d1117", "primaryColor": "#21262d", "primaryTextColor": "#e6edf3", "primaryBorderColor": "#8b949e", "lineColor": "#8b949e", "textColor": "#e6edf3", "edgeLabelBackground": "#161b22", "actorBkg": "#21262d", "actorBorder": "#8b949e", "actorTextColor": "#e6edf3", "actorLineColor": "#8b949e", "signalColor": "#8b949e", "signalTextColor": "#e6edf3", "noteBkgColor": "#373320", "noteBorderColor": "#d4a72c", "noteTextColor": "#f0e6c0", "labelBoxBkgColor": "#21262d", "labelBoxBorderColor": "#8b949e", "labelTextColor": "#e6edf3", "loopTextColor": "#e6edf3", "activationBkgColor": "#30363d", "activationBorderColor": "#8b949e"}}}%%
flowchart TD
    A[Server error registry\nerror_entries.zig +\nerror_entries_runtime.zig] -->|produces| B[UZ-AUTH-022\nInsufficient scope]
    A -->|no producer| C[UZ-AUTH-009\nInsufficient role ❌]
    A -->|no producer| D[UZ-AUTH-010\nUnsupported role ❌]
    B --> E[api-reference/error-codes.mdx\nAuthentication section]
    C -->|removed by this PR| E
    D -->|removed by this PR| E
    F[UZ-AUTH-021\nstruck-through historical] -->|intentionally kept| E
    E --> G[changelog.mdx\nFixes/API entry Jul 03 2026]

Loading

_{Reviews (2): Last reviewed commit: "docs(m109-003): changelog — error-refere..." | Re-trigger Greptile}

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
agentsfleet	🟢 Ready	View Preview	Jul 3, 2026, 10:28 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.