Module index 

Comindly index — the versioned LanceDB store (local dir or S3).

Tables: symbols, edges, file_facts, search, enrichment, flows, style_guide, repo_meta. Each overwrite creates a new Lance version (prior versions retained), so the newest manifest is the atomic “latest” pointer. Remote stores use the platform’s own credentials.

Structs

IndexedRepo

A repository in the index: its name, the commit and branch indexed and where it is cloned from.

Tables

Open tables of one index for a long-running reader: LanceDB keeps their metadata and indexes in its session cache and re-checks for a newer version at most every fresh.

Functions

count_rows

Read back (symbol_count, edge_count) — proves the persisted tables are queryable.

count_rows_blocking

Blocking wrapper for the read-back count.

graph_versions

Blocking wrapper for read_graph. Graph versions as (symbols version, edges version, UTC time), oldest first. Each graph write commits both tables, so the n-th versions of each belong together.

graph_versions_blocking

hybrid_search

Native hybrid search: BM25 full-text + vector, fused by LanceDB’s RRF reranker. Returns (rendered_symbol_id, relevance_score) best-first. query_vector must match the index dim.

hybrid_search_blocking

latest_versions

Read the current (symbols, edges) versions — the atomic latest pointer.

latest_versions_blocking

Blocking wrapper for the current (symbols, edges) versions.

read_enrichment

Load persisted enrichment as (symbol_id, summary, queries). Ok(None) if absent.

read_enrichment_blocking

Blocking wrapper for read_enrichment.

read_facts

Read persisted facts; None for indexes written before facts were stored.

read_facts_blocking

read_flows

Load persisted flows as (entry_id, narration, queries). Ok(None) if absent.

read_flows_blocking

read_graph

Load the persisted org graph back into core types. This is the fast consumer path: serve/explore load once from Lance (local mmap or S3) instead of re-parsing.

read_graph_at

The graph at given (symbols, edges) table versions, or the latest.

read_graph_blocking

read_indexed_repos

The repositories recorded in the index (indexes made before remotes were stored have none).

read_keys

The fingerprints write_keys stored in table, by id.

read_keys_blocking

read_packages

read_packages_blocking

read_recipes

read_recipes_blocking

read_repo_commits

The indexed commit of each repository, by name.

read_repo_commits_blocking

Blocking wrapper for read_repo_commits.

read_repo_meta

The commit a repo dataset was last indexed at, if recorded.

read_repo_meta_blocking

Blocking wrapper for read_repo_meta.

read_search_vectors

Read (symbol_id, vector) from the search table for incremental reuse. Ok(None) if absent.

read_search_vectors_blocking

read_source

The stored contents of path in repo, if the index holds them.

read_source_files

Every stored (repo, path, hash).

read_style_guide

Read the persisted per-repo style guides as (repo, content) pairs.

read_style_guide_blocking

Blocking wrapper for read_style_guide.

write_enrichment

Persist LLM enrichment (one-line summary + generated NL queries) as a Lance enrichment table. queries is a JSON array string. Returns the new version. No-op if empty.

write_enrichment_blocking

Blocking wrapper for write_enrichment.

write_facts

Persist per-file parse facts (JSON per file) so incremental runs can re-resolve everything.

write_facts_blocking

write_flows

Persist pre-generated flow walkthroughs: (entry_id, narration_markdown, flow_questions).

write_flows_blocking

Blocking wrappers.

write_graph

Write the symbol/edge graph to a LanceDB dataset at uri (e.g. s3://bucket/prefix or a local path). Returns the new (symbols, edges) versions.

write_graph_blocking

Blocking wrapper so the (sync) CLI can persist without an async main. Returns the new (symbols, edges) Lance versions.

write_keys

What each generated text was written from, as (id, fingerprint) in table; same fingerprint, same input, so the text is reused instead of asking the LLM again.

write_keys_blocking

write_packages

Persist manifest/lockfile package rows (JSON per row).

write_packages_blocking

write_recipes

Persist derived conventions (e.g. history recipes), JSON per row.

write_recipes_blocking

write_repo_commits

Record the indexed commit for several repos (multi-row repo_meta) — used by the org link so an incremental rebuild knows which repos changed.

write_repo_commits_blocking

Blocking wrapper for write_repo_commits.

write_repo_meta

Record the commit a repo dataset was indexed at (single-row repo_meta table).

write_repo_meta_blocking

Blocking wrapper for write_repo_meta.

write_search_table

Write the denormalized retrieval table (symbol_id, text, vector) and build a native BM25 full-text index on text. Hybrid search then fuses this FTS index with vector search using LanceDB’s own RRF reranker — no hand-rolled BM25.

write_search_table_blocking

Blocking wrappers.

write_sources

Store files: contents go into source_blobs once per hash (append-only, so unchanged files cost nothing), and source_files maps each path to its hash. With merge, rows of repositories files does not cover are kept. Returns the files and the new contents written.

write_style_guide

Persist the inferred repo style guide (single-row style_guide table). Persist one style guide per repo as (repo, content) rows.

write_style_guide_blocking

Blocking wrapper for write_style_guide.