1# Cómo generar el corpus de interpretación
2
3Esta guía dice **exactamente** qué hacer, a mano, para construir el
4corpus que `cosmobiologia` usará para interpretar cartas sin que ninguna
5IA invente una palabra.
6
7## Qué es (y qué NO es) el corpus
8
9El corpus **no es un set de reglas matemáticas**. No "calcula" la
10interpretación. Las reglas —qué planeta en qué signo, qué aspecto con
11qué orbe— las computa el motor astronómico. El corpus es la **biblioteca
12de evidencia**: fragmentos de texto —de los libros y de tu propia
13escritura— recortados y **etiquetados** con la combinación exacta que
14describen.
15
16En runtime, las combinaciones de una carta hacen un **JOIN** contra el
17corpus y traen los textos, citados y con fuente. La síntesis (tejerlos
18en un párrafo continuo) es una capa posterior; el corpus solo
19**almacena** y **recupera**.
20
21La contradicción no se promedia. Un Marte hiperdisciplinado en el
22trabajo y disperso en la soledad **no** se colapsa a "medio
23disciplinado": cada fuerza vive intacta en su **dominio** vivencial. Por
24eso el corpus rebana la carta en tajadas (`Vital`, `Social`, `Psiquico`)
25— como ver un cuerpo en cortes tomográficos.
26
27## El formato
28
29Un archivo `.ron`. Mira `ejemplo.ron` en esta misma carpeta: es una
30plantilla cargable y comentada. Tiene dos secciones, `arquetipos` y
31`pasajes`.
32
33### El "código de barras" de una combinación
34
35Cada pasaje se etiqueta con una clave-cadena:
36
37| Tipo | Sintaxis | Ejemplo |
38|---|---|---|
39| Planeta en signo | `planeta·signo` o `planeta/signo` | `mars·virgo`, `mars/virgo` |
40| Planeta en casa | `planeta@cN` | `mars@c6` |
41| Aspecto entre dos planetas | `a kind b` (tres palabras) | `mars square saturn` |
42
43Reglas de los identificadores:
44
45- minúscula, ASCII, **una sola palabra** (usa `_`: `north_node`);
46- usa siempre el **mismo** nombre — `mars`, no `Marte` aquí y `mars`
47  allá, o el JOIN no engancha;
48- en un aspecto el orden da igual: `mars square saturn` y
49  `saturn square mars` quedan como la misma clave.
50
51## Los pasos
52
53### Paso 1 — Crea tu archivo
54
55```sh
56cd crates/modules/cosmobiologia/cosmobiologia-corpus
57cp ejemplo.ron corpus.ron
58```
59
60Trabaja sobre `corpus.ron`. Borra los tres pasajes-plantilla cuando
61tengas los tuyos.
62
63### Paso 2 — (Opcional, recomendado) Escribe la ontología
64
65En la sección `arquetipos`, una entrada por cada planeta, signo, casa y
66aspecto que uses. Cada una lleva un `perfil`: un mapa de **dimensiones
67psicológicas** —las nombras tú— con un peso en `[-1.0, 1.0]`.
68
69```ron
70(
71    nombre: "mars",
72    tipo: planeta,          // planeta | signo | casa | aspecto
73    perfil: {
74        "accion": 0.9,
75        "deseo": 0.7,
76    },
77),
78```
79
80Esto **no es obligatorio para el JOIN** (el JOIN solo usa `pasajes`),
81pero es la base para, más adelante, deducir el perfil de una combinación
82que no llegaste a escribir. Si recién empiezas, puedes dejar
83`arquetipos: []` y volver luego.
84
85### Paso 3 — Cosecha los pasajes
86
87Esta es la carne. Una entrada en `pasajes` por cada fragmento de
88interpretación:
89
90```ron
91(
92    combinacion: "mars·virgo",
93    texto: "Cita literal, corta, del libro — o tu propia redacción.",
94    fuente: "Autor, Título de la obra, p. 123",
95),
96```
97
98Dos formas de avanzar; elige una:
99
100- **Por fuente** — tomas un libro y lo vacías combinación por
101  combinación. Bueno para cubrir un autor entero de forma pareja.
102- **Por carta** — tomas la carta que estás leyendo *ahora*, listas sus
103  combinaciones y solo escribes esas. Bueno para tener algo útil ya, sin
104  esperar a "terminar" el corpus (que nunca termina).
105
106Recomendado: empieza **por carta**. El corpus crece con cada consulta
107real.
108
109### Paso 4 — Cuida la fuente y el derecho de autor
110
111- Cita **corto** y **textual**, y **atribuye siempre** (autor, obra,
112  página). Fragmentos breves con cita son uso legítimo.
113- No copies capítulos enteros. Si quieres volcar una idea larga,
114  **reescríbela con tus palabras** y pon `fuente: "propio"`.
115- Convención reservada: `fuente: "deducido"` queda para perfiles
116  compuestos por código a futuro, no para texto de libro.
117
118### Paso 5 — Acota el dominio cuando el texto lo pida
119
120Si un pasaje describe la combinación **solo en un plano** de la vida,
121márcalo:
122
123```ron
124(
125    combinacion: "mars square saturn",
126    texto: "...",
127    fuente: "...",
128    dominio: Some(psiquico),   // vital | social | psiquico
129),
130```
131
132Sin `dominio`, el pasaje aplica al dominio que le toque por la posición
133del planeta en la carta. Con `dominio`, lo fuerzas. Úsalo poco: solo
134cuando el autor habla de un plano concreto.
135
136### Paso 6 — Valida el archivo
137
138```sh
139cargo test -p cosmobiologia-corpus
140```
141
142Si tu RON tiene un error de sintaxis, el test `ejemplo_ron_carga`
143te marca el formato correcto; para validar `corpus.ron` directamente,
144cárgalo desde un binario o un test propio con `Corpus::desde_ron`.
145
146### Paso 7 — Busca los huecos
147
148Con la carta cargada, `Corpus::huecos(&combinaciones)` devuelve las
149combinaciones de esa carta que **no tienen ni un pasaje**. Esa lista es,
150literalmente, tu cola de trabajo: lo que falta escribir.
151
152## Cuánto es "suficiente"
153
154El universo completo es grande (≈10 planetas × 12 signos = 120, otras
155120 planeta-en-casa, y los aspectos). No lo persigas. El 80 % del valor
156sale del 20 %: las combinaciones que de verdad aparecen en las cartas
157que lees. Empieza con una carta, deja que `huecos` te guíe, y el corpus
158se llena solo, consulta a consulta.