Files
brahman/crates/modules/semantic_dht/SDD.md
T
sergio e570c6ca6f docs: fix factual errors en SDDs y STATUS/ROADMAP
Errores detectados al auditar afirmaciones técnicas contra el código:

1. minga-vfs: NO está relacionado con Mónadas (esas son de akasha).
   Es FUSE que proyecta el índice de minga (git semántico) como
   filesystem, resolviendo paths virtuales a blobs por hash.

2. protocol/SDD.md: Card tiene 19 campos, no 6. Añadido bloque con
   anatomía completa del struct.

3. STATUS.md: LOC por capa corregidos contra wc -l real
   - protocol: 6,260 → 7,278
   - init:     ~3,600 → 4,301
   - compat:   ~5,000 → 3,435 (estaba sobrestimado)

4. pineal: 6 stubs (<30 LOC c/u), no 5. Export (23 LOC) también es
   stub funcional. LOC reales por sub-crate documentados.

5. init/SDD.md: ente-soma es wrapper de 44 LOC, no ~30.

6. akasha/SDD.md: fastembed está detrás de feature `embeddings`,
   ort es transitivo. Sin feature, akasha-nous-real es stub mínimo.

7. vista/barra: LOC ajustados (vista-core 177, barra-core 108).

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-19 17:03:05 +00:00

1.6 KiB
Raw Blame History

modules/semantic_dht/ (minga) — DHT semántico de código

Propósito. Indexador peer-to-peer de código fuente: parsea con tree-sitter, normaliza identifiers (α-equivalence), produce embeddings y los publica en un DHT. Búsqueda por similitud semántica cross-repo.

Crates

crate tipo rol
minga-core lib Parser + α-hashing (Rust/Py/TS/JS/Go) + scoring
minga-store lib Sled backend para índice local
minga-p2p lib Capa libp2p: kad + bootstrap + provider records
minga-vfs lib Stub (2 LOC) — FUSE que proyecta el índice como filesystem
minga-cli bin CLI: index, search, peers, bootstrap

Dependencias

  • minga-coretree-sitter, tree-sitter-rust, -python, -ts, -js, -go. Consumido por store/p2p/cli.
  • minga-p2pprotocol/brahman-net (libp2p compartido).

α-hashing

Normaliza nombres de variables/funciones a α0..αN para que dos implementaciones idénticas con identifiers distintos colisionen en el mismo hash. Cubre let-else, if-let, or-patterns, let-chains en Rust; cierres en Py/TS/JS/Go.

Estado

LOC 5,091. Indexa repos reales. 15 TODOs en core (más patterns para cada lenguaje). minga-vfs aún no implementado — bloquea el montaje del repo como filesystem (paths virtuales → blobs por hash bajo demanda). NO está relacionado con Mónadas (esas son de akasha/). Ver docs/changelog/minga.md.