.agents/memory/2026-02-23-documentation-audit-team-embedding-repair-endpoint.md

2026-02-23 Session Notes

Documentation Audit Team - Embedding & Repair Endpoints

Worker-b was assigned tasks #3 and #4 by the team lead to update API and CLI documentation for new embedding and repair functionality.

Task #3: API.md Endpoints — Add three new API endpoint sections:

• GET /api/embeddings/projection — Server-side UMAP dimensionality reduction returning cached 2D/3D projections. Includes dimensions query parameter and polling support (202 Accepted when computing).
• GET /api/repair/embedding-gaps — Returns count of unembedded memories and coverage percentage.
• POST /api/repair/re-embed — Batch re-embed endpoint with batchSize and dryRun options. Rate-limited.

Task #4: CLI.md Commands — Add new signet embed command documentation with subcommands (backfill, gaps) and options (--batch-size, --dry-run). Also document service installation scripts for systemd/launchd.

Worker-b claimed task #3 and began reading API.md to locate insertion points. Session encountered an API overload error but work was initiated.

Team Context — Part of broader docs-audit team with 7 pending tasks covering DIAGNOSTICS.md, DASHBOARD.md, ARCHITECTURE.md, PIPELINE.md, and TRAY.md creation.