Skip to content

[docs] Update Repo Mind Light AW documentation for 2026-06-08#10

Open
szabta89 wants to merge 1 commit into
mainfrom
docs/add-soma-retrieval-backend-2026-06-08-7d19f8a921f97766
Open

[docs] Update Repo Mind Light AW documentation for 2026-06-08#10
szabta89 wants to merge 1 commit into
mainfrom
docs/add-soma-retrieval-backend-2026-06-08-7d19f8a921f97766

Conversation

@szabta89
Copy link
Copy Markdown
Contributor

@szabta89 szabta89 commented Jun 8, 2026

Summary

  • Added soma: null to the config schema YAML example under query, showing it as an alternative embedding-free retrieval backend.
  • Added a schema note clarifying that query.graph_rag_zero and query.soma are mutually exclusive. graph_rag_zero is embedding-based and enabled by default; soma is an embedding-free graph-structural backend available in the default public image. Consumers switching to Soma should set query.graph_rag_zero: null and configure query.soma: {}.

Source Context

  • Checked repo-mind-light-source/repo_mind_light/config.py: the QuerySourcesConfig model has a soma: SomaConfig | None = None field and a validator that rejects configs with both graph_rag_zero and soma set.
  • Checked repo-mind-light-source/README.md: documents soma prominently as an alternative backend and shows soma: null in the config reference.
  • Checked repo-mind-light-source/DOCKER.md: includes a full "Retrieval Backends" section explaining both backends and that INCLUDE_SOMA=1 is the default build arg, meaning the public image ships with Soma support.
  • Checked repo-mind-light-source/CHANGELOG.md: soma-related changes appear in v0.10.0 and v0.10.1 (the current source release), confirming this is a shipped feature.

Validation

  • Config schema YAML example updated to show soma: null alongside code_search, consistent with the structure in the source README.
  • Schema note is accurate: graph_rag_zero and soma being mutually exclusive is enforced by a model_validator in QuerySourcesConfig.
  • No private implementation details, internal issue references, or roadmap items included.

Notes

  • No changes were made to .github/workflows/shared/repo-mind-light.md; the recommended config snippet there covers the common case (GRZ default) and the soma note belongs in the reference docs rather than the shared workflow comments.
  • SomaConfig fields (corpus_subdir, max_tokens, assembly, etc.) are not documented here since they are advanced knobs not needed for a basic Soma setup (soma: {} is sufficient to enable it).

Generated by Repo Mind Light AW Documentation Updater · ● 20.5M ·

  • expires on Jun 15, 2026, 10:56 AM UTC

Add soma to the config schema YAML example and note that graph_rag_zero
and soma are mutually exclusive local retrieval backends. Soma is an
embedding-free graph-structural backend available in the default public
image; consumers who want embedding-free local retrieval should set
query.graph_rag_zero: null and configure query.soma.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant