# Documentation Index

Status: Canonical navigation

Use this page as the authoritative map of current docs.

## Start here
- [`../README.md`](../README.md)
- [`reviewers/start-here.md`](reviewers/start-here.md)
- [`public_surface.md`](public_surface.md)

## Concepts
- [`concepts/why-core-memory.md`](concepts/why-core-memory.md)
- [`memory_surfaces_spec.md`](memory_surfaces_spec.md)
- [`semantic_backend_modes.md`](semantic_backend_modes.md)
- [`edge_lifecycle.md`](edge_lifecycle.md)
- [`dreamer_contract.md`](dreamer_contract.md)
- [`truth_hierarchy.md`](truth_hierarchy.md)
- [`truth_hierarchy_policy.md`](truth_hierarchy_policy.md)

## Architecture
- [`architecture_overview.md`](architecture_overview.md)
- [`graph_backend_plugin.md`](graph_backend_plugin.md)
- [`canonical_paths.md`](canonical_paths.md)
- [`integration_contract.md`](integration_contract.md)
- [`core_adapters_architecture.md`](core_adapters_architecture.md)

## Adapters
- Shared foundations:
  - [`integrations/shared/README.md`](integrations/shared/README.md)
  - [`integrations/shared/concepts.md`](integrations/shared/concepts.md)
  - [`integrations/shared/contracts.md`](integrations/shared/contracts.md)
- OpenClaw: [`integrations/openclaw/README.md`](integrations/openclaw/README.md)
  - Canonical contract: [`integrations/openclaw/canonical_contract.md`](integrations/openclaw/canonical_contract.md)
  - Skill companion: [`integrations/openclaw/core-memory-skill-instructions.md`](integrations/openclaw/core-memory-skill-instructions.md)
- PydanticAI: [`integrations/pydanticai/README.md`](integrations/pydanticai/README.md)
- SpringAI / HTTP: [`integrations/springai/README.md`](integrations/springai/README.md)
- LangChain: [`integrations/langchain/README.md`](integrations/langchain/README.md)
- Neo4j (graph backend): [`integrations/neo4j/README.md`](integrations/neo4j/README.md)
- Graphiti / Zep: [`graph_backend_plugin.md`](graph_backend_plugin.md)
- Obsidian vault mirror: [`graph_backend_plugin.md`](graph_backend_plugin.md)

## Integration quickstarts
- [`integrations/openclaw/quickstart.md`](integrations/openclaw/quickstart.md)
- [`integrations/springai/quickstart.md`](integrations/springai/quickstart.md)
- [`integrations/pydanticai/quickstart.md`](integrations/pydanticai/quickstart.md)
- [`integrations/langchain/quickstart.md`](integrations/langchain/quickstart.md)
- [`integrations/neo4j/quickstart.md`](integrations/neo4j/quickstart.md)

## Contracts
- [`contracts/http_api.v1.json`](contracts/http_api.v1.json)
- [`contracts/canonical_phase_function_map.md`](contracts/canonical_phase_function_map.md)
- [`contracts/entity_registry_contract.md`](contracts/entity_registry_contract.md)
- [`contracts/entity_merge_review_contract.md`](contracts/entity_merge_review_contract.md)
- [`contracts/retrieval_value_override_contract.md`](contracts/retrieval_value_override_contract.md)
- [`contracts/mcp_typed_read_contract.md`](contracts/mcp_typed_read_contract.md)
- [`contracts/mcp_typed_write_contract.md`](contracts/mcp_typed_write_contract.md)
- [`contracts/myelination_experiment_contract.md`](contracts/myelination_experiment_contract.md)
- [`adapter_parity_matrix.md`](adapter_parity_matrix.md)

## Specs
- [`specs/association-inference-v2.1.md`](specs/association-inference-v2.1.md)
- [`specs/agent-authored-turn-memory-v1.md`](specs/agent-authored-turn-memory-v1.md)
- [`specs/agent-authored-rollout-playbook.md`](specs/agent-authored-rollout-playbook.md)

## Evaluation entrypoints
- `../eval/memory_execute_eval.py`
- `../eval/dreamer_behavior_eval.py`
- `../eval/longitudinal_benchmark_v2.py` (proxy telemetry)
- `../eval/reviewer_quick_value_v2.py`

## Open work
- [`status.md`](status.md) — single source of truth for completion state and open items
- [`PRD/README.md`](PRD/README.md) — index of all cleanup-phase PRD specs

## Compatibility / historical material
- [`archive/`](archive/) — superseded migration/process/history docs
- [`reports/`](reports/) — dated snapshots and audits
- [`reports/bd2-change-report-2026-04-08.md`](reports/bd2-change-report-2026-04-08.md) — BD-2 decomposition change summary
- Legacy typed-search/search-form narratives are treated as historical material, not forward path docs.

## Notes for reviewers
Canonical retrieval story is:
- `search` (anchor retrieval)
- `trace` (causal traversal)
- `execute` (single orchestrated entrypoint)

Hydration is explicit post-selection source recovery.
Deep recall is real, but separate from canonical hydration.
