brahman/crates/modules/cosmobiologia/SDD.md

modules/cosmobiologia/ — Estudio de astrología profesional

Propósito. App completa de astrología: cálculo de cartas natales (swiss ephemeris vía eternal-astrology), almacenamiento de contactos, render agnóstico (carta natal, dial GR, harmonics) con backends GPUI nativo + SVG/Canvas2D web.

Crates

crate	tipo	rol
cosmobiologia-card	lib	Card del daemon
cosmobiologia-model	lib	Tipos: Chart, Contact, Group, Aspect, Coordinates
cosmobiologia-store	lib	SQLite store (contactos + cartas)
cosmobiologia-engine	lib	Cálculo astrológico (bridge a eternal-astrology)
cosmobiologia-modules	lib	Sub-modules: aspects, harmonics, GR dual-ring
cosmobiologia-render	lib	AGNÓSTICO: RenderModel + DrawCommand + compose
cosmobiologia-theme	lib	Paleta astrológica + presets dark/light
cosmobiologia-canvas	lib	Widget GPUI consumidor de render
cosmobiologia-tree	lib	Widget GPUI: Groups/Contacts/Charts sidebar
cosmobiologia-panel	lib	Widget GPUI: controles dexterior (dial GR, FFT)
cosmobiologia-web	lib	Bridge WASM: DrawCommand → SVG/Canvas2D

Dependencias

• Core: cosmobiologia-model ← cosmobiologia-engine (cálculo) + cosmobiologia-store (persistencia).
• Render path agnóstico: engine → render::compose_wheel → DrawCommands → renderer (gpui nativo o SVG web).
• Widgets GPUI consumen nahual/widgets/tree, nahual-theme.

Estado

LOC 21,502 (más grande del monorepo). Cobertura desigual:

• AGNÓSTICOS estables: model (478), store (760), render (1474), engine (2687).
• GPUI sin tests: canvas (2850), tree (2295), panel (1037).
• 20 TODOs concentrados en engine (sistema GR + harmonics).

Roadmap (memorias de proyecto)

1. ✅ Sistema GR: dual-ring directas+conversas, cómputo de triggers (render::gr), resaltado de convergencias, HUD lateral y scrubbing live del jog-dial.
2. ✅ Armónicos: carta armónica de orden N (render::harmonic) + espectro de fuerza 1-32 como histograma clicable en el canvas. Pendiente: FFT continuo / detección fina de ciclos (#63).
3. ✅ Dial uraniano de 90°: proyección geométrica de los cuerpos sobre el eje 0-90° (render_uranian_dial en el canvas).
4. Research bank (#64-#65): corpus de cartas + queries.
5. 3D celestial sphere (#66): render esférico no 2D.
6. Rectificador automático (#67): ajuste de hora natal vía eventos — usa la matriz GR como evaluador de fitness; ya no bloqueado.