Operator observability: memory inspector and diagnostics workflow

[aurexav]

Summary

Provide an operator-friendly memory inspection and diagnostics workflow.

Problem

Troubleshooting currently requires deep DB/manual inspection, which slows iteration and quality tuning.

In Scope

• Build read-only inspector for sessions/traces/explain outputs.
• Add status and diagnostics commands/endpoints for common failure classes.
• Improve troubleshooting documentation for ingestion/retrieval loops.

Out of Scope

• Full admin dashboard productization.
• Write-capable production management UI.

Deliverables

• Inspector entrypoint (local-first).
• Diagnostics surfaces.
• Ops runbook updates.

Acceptance Criteria

• Developers can inspect memory decisions end-to-end without direct DB spelunking.
• Common failures are diagnosable with documented commands.
• Inspector works on desktop and mobile local usage.

Dependencies

• Search: graph relation context and explain integration #50
• Quality gate: CI regression checks with elf-eval trace compare #54

Related

• Add a read-only web viewer for sessions and traces #26

Implementation Checklist

• Inspector prototype.
• Diagnostics endpoints/commands.
• Runbook docs.
• Developer workflow validation.

Done When

• Debugging memory quality is fast and repeatable for contributors.