feat(tahuantinsuyu): scaffolding del estudio astrológico (10 crates + ventana 3-panes)

Módulo nuevo `modules/tahuantinsuyu/` con 9 crates reusables + app `apps/tahuantinsuyu` ejecutable que abre la ventana del explorador y coordina los widgets: - tahuantinsuyu-card: Card Brahman + spawn_sidecar (flows chart-request/chart-result). - tahuantinsuyu-model: tipos agnósticos (Group/Contact/Chart, StoredBirthData, StoredChartConfig, ChartKind, TreeSelection). - tahuantinsuyu-store: persistencia SQLite (rusqlite) con migración v1, CRUD por entidad y descenso recursivo `charts_under_group`. - tahuantinsuyu-engine: bridge agnóstico al canvas vía `RenderModel` (Layer/Glyph/Geometry). Feature `eternal-bridge` (off por default) reservada para enchufar eternal-astrology desde ~/eternal. - tahuantinsuyu-modules: registry de módulos pluggables (Module trait + Control schema) con `NatalModule` placeholder. - tahuantinsuyu-theme: AstroPalette (elementos / modos / planetas / aspectos) con variantes dark + light sobre yahweh-theme. - tahuantinsuyu-canvas: widget GPUI con CanvasState (Empty / Wheel / Thumbnails). Render placeholder hasta cablear la rueda real. - tahuantinsuyu-tree: explorador izquierdo sobre yahweh-widget-tree, prefijos g:/c:/h: para Group/Contact/Chart. - tahuantinsuyu-panel: control panel inferior que lee Controls de los módulos del registry y los pinta. - apps/tahuantinsuyu: binario `tahuantinsuyu` (launch_app-style) con Shell coordinador (tree↔canvas↔panel), DB en $XDG_DATA_HOME. Workspace Cargo.toml actualizado con los 10 miembros. `cargo check` verde, tests unitarios verdes (model/store/engine/modules/theme/card). Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-16 01:06:03 +00:00
parent e8f97b50cb
commit c48638fe87
23 changed files with 3256 additions and 0 deletions
@@ -0,0 +1,30 @@
+[package]
+name = "tahuantinsuyu-engine"
+version = { workspace = true }
+edition = { workspace = true }
+license = { workspace = true }
+description = "Tahuantinsuyu — bridge entre el modelo agnóstico y eternal-astrology. Produce RenderModel agnóstico para el canvas."
+
+[dependencies]
+tahuantinsuyu-model = { path = "../tahuantinsuyu-model" }
+serde = { workspace = true }
+thiserror = { workspace = true }
+
+# eternal-astrology vive en otro workspace (~/eternal). Lo enlazamos por
+# path para que el bridge use la misma lógica validada que el harness de
+# Sergio. Si el path no existe (CI sin eternal checked out), el feature
+# `eternal-bridge` se apaga.
+[dependencies.eternal-astrology]
+path = "../../../../../eternal/eternal-astrology"
+optional = true
+
+[dependencies.eternal-sky]
+path = "../../../../../eternal/eternal-sky"
+optional = true
+
+[features]
+default = []
+# Activa el bridge real contra eternal-astrology. Sin este feature, la
+# engine sólo expone el RenderModel y mocks — útil para tests y para
+# compilar la UI antes de que eternal esté disponible.
+eternal-bridge = ["dep:eternal-astrology", "dep:eternal-sky"]
@@ -0,0 +1,272 @@
+//! `tahuantinsuyu-engine` — bridge entre el modelo agnóstico y
+//! `eternal-astrology`.
+//!
+//! Recibe un `Chart` del modelo + un `ChartKind` y devuelve un
+//! [`RenderModel`] que describe la geometría a pintar **sin** acoplar
+//! el canvas a tipos de la librería astronómica. El canvas habla
+//! grados decimales, radios normalizados y kinds simbólicos.
+//!
+//! ## Por qué un RenderModel intermedio
+//!
+//! 1. El canvas no debería caer si cambia el shape de `NatalChart`
+//!    upstream.
+//! 2. Tests del canvas: podemos generar `RenderModel`s sintéticos sin
+//!    arrancar eternal.
+//! 3. Cada `ChartKind` produce el mismo shape genérico → el render
+//!    coordina N módulos sin saber qué calcularon.
+//!
+//! ## Feature `eternal-bridge`
+//!
+//! - **off** (default): la engine sólo expone los tipos `RenderModel`,
+//!   `Layer`, `Glyph`, etc. y un `compute_mock()` con un disco de
+//!   prueba. Útil para la UI antes de que `eternal-astrology` compile.
+//! - **on**: agrega `compute(chart) -> RenderModel` con la pipeline
+//!   real.
+
+#![forbid(unsafe_code)]
+#![warn(rust_2018_idioms)]
+
+use serde::{Deserialize, Serialize};
+use thiserror::Error;
+
+pub use tahuantinsuyu_model::{Chart, ChartId, ChartKind};
+
+// =====================================================================
+// RenderModel — lo que el canvas necesita pintar una capa
+// =====================================================================
+
+/// Resultado agnóstico de un cómputo astrológico, listo para renderizar.
+/// Cada `Layer` es independiente — el canvas las apila por z-order.
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct RenderModel {
+    /// Identidad estable de la carta a la que pertenece este render.
+    pub chart_id: ChartId,
+    /// Kind original — el canvas lo usa para títulos y ornamentos.
+    pub chart_kind: ChartKind,
+    /// Capas a pintar. Orden = z-order ascendente.
+    pub layers: Vec<Layer>,
+    /// Texto humano-legible breve. Ej. "Sergio · 14 mar 1987 · Caracas".
+    pub title: String,
+    /// Tiempo de cómputo en ms — métrica para diagnóstico.
+    pub compute_ms: u64,
+}
+
+/// Una capa visual. Cada módulo de astrología publica una o varias.
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct Layer {
+    /// Identidad estable del módulo emisor ("natal", "transit", "uranian").
+    pub module_id: String,
+    /// Tipo de capa — controla cómo se compone con vecinas.
+    pub kind: LayerKind,
+    /// Radio normalizado [0, 1] sobre el lienzo. Permite stack de anillos.
+    pub ring: f32,
+    /// Z-order absoluto (más alto = encima). Default 0.
+    #[serde(default)]
+    pub z: i32,
+    /// Geometría: puntos, arcos, líneas.
+    pub geometry: Geometry,
+    /// Glifos simbólicos sobre la geometría (planetas, signos, casas).
+    #[serde(default)]
+    pub glyphs: Vec<Glyph>,
+}
+
+#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Serialize, Deserialize)]
+#[serde(rename_all = "snake_case")]
+pub enum LayerKind {
+    /// El anillo zodiacal de fondo (12 signos).
+    SignDial,
+    /// Las 12 cusps de casas + cuadrantes.
+    Houses,
+    /// Los planetas / cuerpos en sus posiciones.
+    Bodies,
+    /// Líneas de aspecto entre cuerpos.
+    Aspects,
+    /// Puntos arábigos / lots.
+    Lots,
+    /// Estrellas fijas como overlay.
+    FixedStars,
+    /// Puntos medios y simetría Uraniana.
+    Midpoints,
+    /// Anillo externo de tránsitos / progresiones / direcciones.
+    Outer,
+    /// Geometría libre — usa cuando una capa no encaja en las otras.
+    Custom,
+}
+
+/// Geometría primitiva, agnóstica del renderer.
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub enum Geometry {
+    /// Sólo glifos posicionados — sin trazo de fondo.
+    GlyphsOnly,
+    /// Anillo dividido en sectores (zodíaco, casas).
+    Ring {
+        /// Divisiones en grados zodiacales [0, 360). El canvas pinta
+        /// líneas radiales en cada uno.
+        cusps_deg: Vec<f32>,
+    },
+    /// Conjunto de líneas (aspectos). Cada par = `(from_deg, to_deg)`.
+    Lines(Vec<LineSeg>),
+    /// Puntos sueltos con marcadores (lots, fixed stars).
+    Points(Vec<PointMark>),
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct LineSeg {
+    pub from_deg: f32,
+    pub to_deg: f32,
+    /// Categoría simbólica (conjunction, trine, square…) — el theme
+    /// resuelve el color.
+    pub kind: String,
+    /// Opacidad sugerida [0, 1].
+    pub opacity: f32,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct PointMark {
+    pub deg: f32,
+    pub label: String,
+    /// Tag simbólico para que el theme elija color/glifo.
+    pub tag: String,
+}
+
+/// Glifo dibujable sobre una capa.
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct Glyph {
+    /// Posición zodiacal en grados [0, 360).
+    pub deg: f32,
+    /// Glyph simbólico ("sun","moon","aries",…). El theme lo mapea a
+    /// imagen o codepoint.
+    pub symbol: String,
+    /// Texto secundario (ej. el grado dentro del signo).
+    #[serde(default)]
+    pub annotation: Option<String>,
+    /// `true` si el cuerpo está retrógrado.
+    #[serde(default)]
+    pub retrograde: bool,
+    /// Casa en la que cae (1..=12), si aplica.
+    #[serde(default)]
+    pub house: Option<u8>,
+}
+
+// =====================================================================
+// Errores
+// =====================================================================
+
+#[derive(Debug, Error)]
+pub enum EngineError {
+    #[error("bridge a eternal-astrology no disponible (recompilá con feature `eternal-bridge`)")]
+    BridgeDisabled,
+    #[error("model: {0}")]
+    Model(#[from] tahuantinsuyu_model::ModelError),
+    #[cfg(feature = "eternal-bridge")]
+    #[error("eternal: {0}")]
+    Eternal(String),
+}
+
+// =====================================================================
+// API pública
+// =====================================================================
+
+/// Computa el RenderModel real contra `eternal-astrology`. Requiere
+/// el feature `eternal-bridge`.
+#[cfg(feature = "eternal-bridge")]
+pub fn compute(_chart: &Chart) -> Result<RenderModel, EngineError> {
+    // TODO: pipeline real — abrir `EphemerisSession`, traducir
+    // `StoredBirthData → BirthData`, `StoredChartConfig → ChartConfig`,
+    // correr `NatalChart::compute`, mapear a `Layer`s. Se cablea en la
+    // fase 3 del plan.
+    Err(EngineError::Eternal("pendiente fase 3".into()))
+}
+
+/// Stub que devuelve un disco vacío de placeholder — sirve a la UI
+/// mientras la pipeline real no esté cableada. Usar en demos y
+/// desarrollo.
+pub fn compute_mock(chart: &Chart) -> RenderModel {
+    use std::time::Instant;
+    let t0 = Instant::now();
+
+    let sign_dial = Layer {
+        module_id: "natal".into(),
+        kind: LayerKind::SignDial,
+        ring: 0.95,
+        z: 0,
+        geometry: Geometry::Ring {
+            cusps_deg: (0..12).map(|i| (i as f32) * 30.0).collect(),
+        },
+        glyphs: (0..12)
+            .map(|i| Glyph {
+                deg: (i as f32) * 30.0 + 15.0,
+                symbol: ZODIAC_GLYPHS[i].into(),
+                annotation: None,
+                retrograde: false,
+                house: None,
+            })
+            .collect(),
+    };
+
+    RenderModel {
+        chart_id: chart.id,
+        chart_kind: chart.kind,
+        layers: vec![sign_dial],
+        title: chart.label.clone(),
+        compute_ms: t0.elapsed().as_millis() as u64,
+    }
+}
+
+const ZODIAC_GLYPHS: [&str; 12] = [
+    "aries",
+    "taurus",
+    "gemini",
+    "cancer",
+    "leo",
+    "virgo",
+    "libra",
+    "scorpio",
+    "sagittarius",
+    "capricorn",
+    "aquarius",
+    "pisces",
+];
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+    use tahuantinsuyu_model::{
+        Chart, ChartKind, ContactId, StoredBirthData, StoredChartConfig,
+    };
+
+    fn sample_chart() -> Chart {
+        Chart {
+            id: ChartId::new(),
+            contact_id: ContactId::new(),
+            kind: ChartKind::Natal,
+            label: "test".into(),
+            birth_data: StoredBirthData {
+                year: 1987,
+                month: 3,
+                day: 14,
+                hour: 5,
+                minute: 22,
+                second: 0.0,
+                tz_offset_minutes: -240,
+                latitude_deg: 10.4806,
+                longitude_deg: -66.9036,
+                altitude_m: 900.0,
+                time_certainty: Default::default(),
+                subject_name: None,
+                birthplace_label: None,
+            },
+            config: StoredChartConfig::default(),
+            related_chart_id: None,
+            created_at_ms: 0,
+        }
+    }
+
+    #[test]
+    fn mock_emits_sign_dial() {
+        let model = compute_mock(&sample_chart());
+        assert_eq!(model.layers.len(), 1);
+        assert!(matches!(model.layers[0].kind, LayerKind::SignDial));
+        assert_eq!(model.layers[0].glyphs.len(), 12);
+    }
+}