Skip to content

errors.md

Latest commit

 

History

History
55 lines (42 loc) · 2.46 KB

errors.md

File metadata and controls

55 lines (42 loc) · 2.46 KB
Raw

Error Catalog & Diagnostic Codes

API Hub · CLI Reference · Symptom Matrix · Operations

Comprehensive catalog of typed error variants, diagnostic codes, and HTTP/MCP error responses used across HEAV3NS-PRESS.

1. Domain & Storage Error Variants

Error Code HTTP Status Description Actionable Guidance
ERR_POST_NOT_FOUND 404 Not Found Requested content slug does not exist in storage Verify slug spelling via heav3ns-press list
ERR_INVALID_SLUG 400 Bad Request Slug failed regex validation or is reserved Slugs must be lowercase alphanumeric with hyphens (^[a-z0-9]+(-[a-z0-9]+)*$)
ERR_PAYLOAD_TOO_LARGE 413 Payload Too Large Markdown body exceeds limit (10MB) Split article or compress embedded assets
ERR_CAS_CORRUPTION 500 Internal Error SHA-256 digest on disk doesn't match manifest Self-healing will isolate to quarantine and attempt revision rollback
ERR_TORN_WAL_RECOVERED 200 OK (Advisory) Trailing line of WAL was incomplete after crash Incomplete line discarded; valid transactions replayed
ERR_DISK_SPACE_LOW 503 Service Unavailable Free host disk space < 100MB Prune old backups with heav3ns-press backup --prune
ERR_REVISION_NOT_FOUND 404 Not Found Target rollback revision number does not exist Check valid revision numbers with heav3ns-press revisions <slug>

2. Model Context Protocol (MCP) JSON-RPC Errors

JSON-RPC Code Error Message Scenario
-32700 Parse Error Stdio client passed invalid or non-JSON payload
-32600 Invalid Request JSON-RPC payload lacked jsonrpc: "2.0" or method
-32601 Method Not Found Tool or resource method is unknown
-32602 Invalid Params Missing required arguments (e.g. slug or title)
-32603 Internal Error Unexpected failure inside storage or supervisor

3. Standard JSON Error Envelope

All HTTP API endpoints and CLI commands in --json mode emit structured errors:

{
  "success": false,
  "error": {
    "code": "ERR_INVALID_SLUG",
    "message": "Slug 'my..post' contains illegal directory traversal characters.",
    "remediation": "Provide an alphanumeric slug matching '^[a-z0-9]+(-[a-z0-9]+)*$'"
  }
}