Error Catalog, Spotlight Banner & Help Page

Version: 4.37.0 Date: 2026-07-15

Goal: Turn raw technical task errors into clear, actionable messages for end users; let the team edit messages live without shipping a new box.

Solution: Remote KV-backed catalog on the refs worker; client-side chain matching; inline messages, spotlight banner, dynamic help page, and periodic refresh with retroactive re-resolution.

Features:

• User-friendly message on failed task cards + "i" help link
• Explicit details toggle (chevron) for technical error chain
• Consolidated spotlight banner for account/config problems
• /errors/help?key=... dynamic help page (Markdown, grouped by category)
• /errors/admin live catalog editing; DEFAULT_CATALOG offline fallback
• Error reports to neo-backend include file hash

Files Modified:

• src/protocol/refsErrors.ts (new) - Catalog load/match/refresh
• src/components/TasksPanel/TaskView.tsx, SpotlightBanner.tsx (new)
• src/services/fileProtect/taskActions.pipe.ts - fileHash in error context
• microservices/refs-domain/refs-worker.js - Catalog/admin/help/api-docs routes

Release fragment: feat-error-catalog