Files

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

1.9 KiB

Raw Blame History

protocol/ — Contratos canónicos + routing

Propósito. Núcleo de intercomunicación del fractal: tipos canónicos (Card, capabilities, soma), handshake módulo↔Init, broker que empareja flows por tipo, y wire types de red. No corre lógica de dominio.

Crates

crate	tipo	rol
`brahman-card`	lib	`Card { soma, payload, flow, permissions, supervision }`
`brahman-card-wit`	lib	Extracción WIT desde componentes WASM
`brahman-cards`	lib	Templates Nickel + helpers consumer/producer/broker
`brahman-handshake`	lib	Init↔módulo: Hello, Ping, ListSessions, ListMatches
`brahman-broker`	lib	Service locator: flow.input ↔ flow.output por tipo
`brahman-admin`	lib	Socket admin separado: snapshots de sesiones+matches
`brahman-sidecar`	lib	`spawn(card)` para que apps se presenten al Init
`brahman-net`	lib	Malla libp2p opcional (TCP+noise+yamux+kad)
`ente-card`	lib	Alias legacy — re-export de `brahman-card`

Dependencias

Intra: handshake → card + broker; sidecar → card; net → handshake.
Cross: consumido por todos los modules/* y apps/*.
No depende de init/ ni de runtime/ (es la base).

Invariantes

Serialización: postcard length-prefixed sobre Unix SOCK_STREAM, JSON sobre HTTP (gateway). Schemas reproducibles vía Nickel.
Identidad: peer_id libp2p + firma Ed25519 anclada al peer.
Sesiones: el handshake mantiene una sesión por módulo encarnado.

Estado

Base estable (6,260 LOC con tests). 19 TODOs concentrados en handshake (trust remoto fase 3) y broker. Ver docs/changelog/protocol.md.

1.9 KiB Raw Blame History