Phase 4: migrate Docs domain to live data contract

[Shannon1980]

Summary

• remove docs runtime dependence on mock-docs in docs page, docs API route, docs components, and docs UI config imports
• add src/lib/docs/model.ts as the typed non-mock docs model (types + options/constants)
• update /api/docs to return live DB/workspace data only (no seed fallback), with stronger error signaling
• keep docs page UX (search/filter/sort/linking + queue/all tabs) while adding explicit load error/retry + clean empty states

What changed

Model layer

• Added src/lib/docs/model.ts with docs domain types and UI constants (CATEGORY_OPTIONS, PRIORITY_OPTIONS, REVIEW_STATUS_OPTIONS).
• Repointed docs components and ui-config to this live model module.

API layer

• src/app/api/docs/route.ts no longer imports SEED_DOCUMENTS.
• Removed seed-data fallback path; fallback is workspace docs only when DB is unavailable in local/dev.
• API now surfaces schema/init and fetch failures as HTTP 500 JSON errors instead of silently injecting seed data.
• Query now selects full docs contract fields (linked_to, version_history, priority, review_status, category, notes, assignments) and maps them through to response defaults.

UI layer

• src/app/docs/page.tsx starts from empty state instead of SEED_DOCUMENTS.
• Added robust loading/error/empty-state handling:
  • load error banner
  • queue/all tab error views when no data
  • retry action
• Preserved existing UX controls and behavior for search/filter/sort/linking and review queue interactions.

Validation

• npx eslint src/app/docs/page.tsx src/app/api/docs/route.ts src/lib/docs/model.ts src/lib/ui-config.ts ✅
• npm run lint currently fails due to pre-existing repo-wide lint errors unrelated to this PR (react-hooks/set-state-in-effect and other baseline issues in non-docs areas).

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
claw-command	Ready	Preview, Comment	Mar 13, 2026 11:38pm