Files
brahman/crates/modules/semantic_dht/SDD.md
T
sergio 550c98f275 refactor(monorepo): reorganización lógica + renames + SDDs + split CHANGELOG
Reorganización física de crates/:
- core/ (mezclaba 6 propósitos) se divide en protocol/, init/, runtime/, compat/
- shared/ (3 crates) se redistribuye en protocol/ e init/
- lapaloma (sub-módulo de ui_engine) se promueve a modules/pineal/

Renames de proyectos:
- shipote → shuma (runtime de sandboxes)
- nouser → akasha (explorador de Mónadas)
- yahweh → nahual (motor GPUI, antes ui_engine/)
- lapaloma → pineal (data-viz agnóstica)

Fraccionamiento UI → core agnóstico:
- vista-core (DeckState + snap, 175 LOC, 5 tests verdes)
- barra-core (Task + render_html + sanitize, 90 LOC, 5 tests verdes)
- vista-web y barra-web ahora son thin DOM bindings

Documentación nueva:
- 16 SDDs por subdirectorio (≤80 LOC c/u): protocol/init/runtime/compat
  + 10 módulos + apps/
- docs/STATUS.md con cifras reales por proyecto
- docs/ROADMAP.md con plan a finalización (6 hitos, ~6-8 semanas)
- CHANGELOG.md particionado en docs/changelog/<proyecto>.md (7 buckets)

Automatización:
- scripts/reorg.py — script idempotente que: git mv directorios, renombra
  package names, recomputa path = refs, reescribe imports rust, actualiza
  workspace Cargo.toml. Soporta --dry-run.
- scripts/split-changelog.py — particiona CHANGELOG por componente.

Validación:
- cargo check --workspace pasa (124 crates + 2 nuevos cores).
- 10 tests adicionales (5 en vista-core + 5 en barra-core) verdes.

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

35 lines
1.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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) — montaje VFS de mónadas remotas |
| `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 — gating del
"file system de mónadas". Ver `docs/changelog/minga.md`.