sergio
e570c6ca6f
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>
37 lines
1.6 KiB
Markdown
37 lines
1.6 KiB
Markdown
# 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-core` ← `tree-sitter`, `tree-sitter-rust`, `-python`, `-ts`,
|
||
`-js`, `-go`. Consumido por store/p2p/cli.
|
||
- `minga-p2p` ← `protocol/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`.
|