2cfcfdd1af
Phase 2.6.1: co_occurrence_edges migration - build_co_occurrence_edges_from_qdrant() - Qdrant embeddings → frame grouping → YOLO objects - Result: 6679 edges (vs 6701 PostgreSQL) Phase 2.6.2: face_face_edges migration - build_face_face_edges_from_qdrant() - Qdrant embeddings → frame grouping → face pairs - mutual_gaze detection preserved - Result: 6 edges (exact match) Phase 2.6.3: speaker_face_edges migration - build_speaker_face_edges_from_qdrant() - Qdrant embeddings → trace_id frame ranges - SPEAKS_AS edge creation Architecture: - All edges use Qdrant payload (no face_detections queries) - PostgreSQL fallback for empty Qdrant - Estimated 3.6x performance improvement Testing: - Playground (3003): ✓ All Phase 2.6 logs verified - Edge counts: ✓ Close match with PostgreSQL - Fallback: ✓ Working Docs: - docs_v1.0/DESIGN/TKG_PHASE2_6_EDGES_MIGRATION.md - docs_v1.0/M4_workspace/2026-06-21_phase2_6_test.md
API Workspace
Purpose
This directory is the single source of truth for all API documentation modules.
Generated outputs go to ../GUIDES/ as assembled deliverable documents.
Workflow
# 1. Edit a module
vim modules/09_tmdb.md
# 2. Preview the generated output
make _build/API_ENDPOINTS.md
# 3. Check diff against current GUIDES/ content
make check
# 4. Deploy to GUIDES/
make deploy
# 5. Regenerate all
make all
Directory Structure
API_WORKSPACE/
├── modules/ ← 11 module files (01_auth ... 11_error_codes)
├── configs/ ← 7 assembly recipies (.toml)
├── narratives/ ← narrative intros for specific output files
├── _build/ ← generated output (gitignored)
├── Makefile ← build targets
├── assemble_docs.sh ← assembly engine
└── README.md
Available make Targets
| Target | Output |
|---|---|
make reference |
_build/API_REFERENCE.md |
make endpoints |
_build/API_ENDPOINTS.md |
make quickref |
_build/API_QUICK_REFERENCE.md |
make errors |
_build/API_ERROR_CODES.md |
make index |
_build/API_INDEX.md |
make marcom |
_build/API_TRAINING_MARCOM.md |
make tmdb |
_build/TMDb_User_Guide.md |
make all |
All of the above |
make deploy |
Copy _build/* → ../GUIDES/ |
make check |
diff against existing ../GUIDES/ files |
Adding a New Endpoint
- Add the endpoint to the appropriate module (e.g.,
modules/XX_files.md) - Follow the template in
modules/_template.md make all && make checkmake deploy