docs(brain): file-map dossiers B0+B1 (7 Tier A modules)

[mattmre]

Summary

Enriches the brain file-map layer with complete §1–§14 dossiers for batches B0 and B1:

B0 (foundation): \config.py, \�mbedding_backend.py, \�ector_store.py\

B1 (core runtime): \�ntigravity_engine.py, \chelation_adapter.py, \�dapter_router.py, \online_updater.py\

Each dossier includes YAML frontmatter (\last_verified_sha: 6c3e184), public API reference, ≥2 Mermaid diagrams, dependency tables, honest drift watch, and floor-tier unittest commands.

Verification

• \python scripts/scaffold_brain_dossier.py --tier-a-scan: 7 present, 151 remaining (was 158)
• Zero {{placeholders}}\ in dossiers
• Unittests executed (floor tier): \ est_vector_store.py\ (10), \ est_unit_core\ config+adapter (84), \ est_online_updater.py\ (18), \ est_antigravity_engine.TestAntigravityEngine\ (42), adapter_router safety tests (2)

Scope

Documentation only — no production code, tests, or MODULE_GUIDE changes.

Brutal Honesty

• §11 commands are floor-tier unittest only, not ceiling smoke or live Ollama/HF end-to-end.
• \�mbedding_backend\ discloses Ollama zero-vector fallback on failure (\�mbedding_backend.py:212,229,237).
• \�ntigravity_engine\ discloses dashboard/TTS try/except L11 swallow sites.
• \�dapter_router\ is opt-in MoE scaffold, not default retrieval path.

[gemini-code-assist]

Code Review

This pull request adds a robust guard to AntigravityEngine.get_runtime_telemetry to ensure torch.cuda.device_count() > 0 before fetching CUDA device names, successfully preventing crashes in CPU-only or GPU-hidden environments. It also introduces a comprehensive set of documentation dossiers under docs/brain/file-map/ and adds a dedicated regression test suite in test_engine_telemetry_cuda_guard.py. The feedback suggests adding trailing newlines to several of the newly created markdown dossier files to comply with standard formatting conventions.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

[gemini-code-assist]

This file should end with a newline character. It's a common convention that prevents issues with file concatenation and some version control systems.

Suggested change

	| 2026-06-29 | 6c3e184 | Initial enriched dossier (B1 batch) |
	| 2026-06-29 | 6c3e184 | Initial enriched dossier (B1 batch) |

[gemini-code-assist]

This file should end with a newline character. It's a common convention that prevents issues with file concatenation and some version control systems.

Suggested change

	| 2026-06-29 | 6c3e184 | Initial enriched dossier (B1 batch); 41 public symbols in §5 |
	| 2026-06-29 | 6c3e184 | Initial enriched dossier (B1 batch); 41 public symbols in §5 |

[gemini-code-assist]

This file should end with a newline character. It's a common convention that prevents issues with file concatenation and some version control systems.

Suggested change

	| 2026-06-29 | 6c3e184 | Initial enriched dossier (B1 batch) |
	| 2026-06-29 | 6c3e184 | Initial enriched dossier (B1 batch) |

[gemini-code-assist]

This file should end with a newline character. It's a common convention that prevents issues with file concatenation and some version control systems.

Suggested change

	| 2026-06-29 | 6c3e184 | B0 full enrichment — §1–§14, grouped `ChelationConfig` tables, security helpers, sibling links |
	| 2026-06-29 | 6c3e184 | B0 full enrichment — §1–§14, grouped `ChelationConfig` tables, security helpers, sibling links |

[gemini-code-assist]

This file should end with a newline character. It's a common convention that prevents issues with file concatenation and some version control systems.

Suggested change

	| 2026-06-29 | 6c3e184 | B0 full enrichment — §1–§14, Ollama zero-vector drift disclosed, sibling links |
	| 2026-06-29 | 6c3e184 | B0 full enrichment — §1–§14, Ollama zero-vector drift disclosed, sibling links |

[gemini-code-assist]

This file should end with a newline character. It's a common convention that prevents issues with file concatenation and some version control systems.

Suggested change

	| 2026-06-29 | 6c3e184 | Initial enriched dossier (B1 batch) |
	| 2026-06-29 | 6c3e184 | Initial enriched dossier (B1 batch) |

[gemini-code-assist]

This file should end with a newline character. It's a common convention that prevents issues with file concatenation and some version control systems.

Suggested change

	| 2026-06-29 | 6c3e184 | B0 full enrichment — §1–§14, F-044 surface documented, sibling links |
	| 2026-06-29 | 6c3e184 | B0 full enrichment — §1–§14, F-044 surface documented, sibling links |