docs: add error-codes reference page and v0.14.0 changelog#9
Merged
Conversation
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…ug fixes sections The v0.5.0 entry was missing content from docs/release/0.5.0.md: - Credential injection (vault-resolved, no creds in config files) - Session checkpoint (crash-recovery via Postgres upsert) - 6 post-review bug fixes (memory, YAML parser, migration runner, UTF-8, UUID, test runner) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Remove 4 implementation-internal fixes (memory, migration runner, UUID reads, test infra) — not user-visible. Keep only YAML parser and UTF-8 truncation fixes which affect observable CLI behavior. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- Add comprehensive error-codes.mdx with all UZ-* error codes, HTTP status mappings, and common causes for each category - Add error-codes page to docs.json navigation under API Reference > Overview - Add v0.14.0 changelog entry for Persistent Zombie Memory (M14_001) feature
- Remove GET /v1/specs from docs.json navigation (endpoint removed from API) - Delete api-reference/endpoint/list-specs.mdx (endpoint no longer exists) The /v1/specs endpoint was removed in a previous release. This cleans up the documentation to match the current OpenAPI spec.
- Remove entire 'Agents' group from docs.json (8 endpoints removed from API) - Remove entire 'Harness' group from docs.json (4 endpoints removed from API) These endpoints were removed in v0.10.1 (M17_001). Cleaning up docs to match current OpenAPI spec.
- Remove 'Agent Relay' group from docs.json (spec/template and spec/preview
endpoints removed from API)
- Remove POST /v1/workspaces/{workspace_id}/scoring/config from Billing group
(endpoint removed from API)
- Delete api-reference/endpoint/agent-stream.mdx (documents removed endpoint)
Cleaning up more stale references to match current OpenAPI spec.
- Fix UZ-AUTH-002: remove 'or expired' to avoid overlap with UZ-AUTH-003 - Remove UZ-ENTL-002: retired error code (harness-only, removed in v0.10.1) - Remove UZ-AGENT-002: dead error code (endpoint removed in v0.10.1) Addresses Greptile review feedback on PR #9.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
This PR adds documentation for API error codes and updates the changelog with the v0.14.0 memory feature release.
Changes
New:
Updated:
Checklist
Greptile Summary
This PR adds a new
api-reference/error-codes.mdxreference page covering all RFC 7807 error codes, adds changelog entries for v0.8.0–v0.14.0, removes deprecated endpoint pages (agent-stream.mdx,list-specs.mdx), and cleans updocs.jsonnavigation.docs_uriexample in the response format section uses per-code URL fragments (e.g.,#UZ-ZMB-009), but the page has no HTML anchors on table rows — browsers will silently ignore the fragment, breaking the "link to the specific code" promise documented in the field description.Confidence Score: 4/5
Safe to merge after fixing the docs_uri anchor gap, which misrepresents a documented API contract to callers.
One new P1 found: the docs_uri deep-link mechanism is documented as linking to the specific code but won't work without per-row HTML anchors in the MDX. Prior review threads also flagged several unresolved issues (retired UZ-ENTL-002, missing v0.13.0 error codes, internal-detail violations). Until the anchor issue is resolved, the error codes page doesn't fulfill its stated RFC 7807 purpose.
api-reference/error-codes.mdx — missing per-row HTML anchors and incorrect HTTP status on UZ-RELAY-001
Important Files Changed
Sequence Diagram
sequenceDiagram participant Client participant zombied participant Docs as docs.usezombie.com Client->>zombied: API Request zombied-->>Client: 4xx/5xx application/problem+json Note over Client: Reads error_code, follows docs_uri Client->>Docs: GET /api-reference/error-codes#UZ-ZMB-009 Note over Docs: Fragment #UZ-ZMB-009 has no matching anchor in MDX table rows Docs-->>Client: Page renders at top (not at specific error code)Prompt To Fix All With AI
Reviews (3): Last reviewed commit: "docs: fix error-codes accuracy issues fr..." | Re-trigger Greptile
Context used: