1# modules/fana/ — Writer DAG editor (absorbe pluma)
2
3**Propósito.** Editor de escritura multidimensional: el documento es un
4DAG de átomos narrativos con ramas (timelines), tracking de coherencia,
5e indexación semántica. Absorbe el linaje markdown de `pluma`. Prioridad
6alta entre las apps.
7
8## Estado
9
10- **Implementado**: `fana-core` (átomo + coherencia), `fana-graph`
11  (DAG + `propagate_mutation` + orden topológico), `fana-render-plan`
12  (layout agnóstico: bloques en columnas por rama, conectores,
13  osciloscopio), `fana-editor-gpui` (backend GPUI), `fana-semantic`
14  (cliente `verbo`), `fana-store` (persistencia sled), `fana-md` +
15  `fana-md-reader-web` (linaje markdown de pluma). App `apps/fana`
16  funcional (relato de ejemplo + onda de choque lógica).
17- **Pendiente**: `fana-llm` (cliente HTTP a LLMs remotos — requiere
18  cliente HTTP en el workspace), `fana-editor-web` (cdylib WASM).
19
20## Crates (objetivo)
21
22| crate                  | tipo | rol                                                  |
23| ---------------------- | ---- | ---------------------------------------------------- |
24| `fana-core`            | lib  | `NarrativeAtom` + `NarrativeGraph` + `CoherenceState`|
25| `fana-md`              | lib  | Parser markdown (ex pluma-md)                        |
26| `fana-graph`           | lib  | DAG ops + `propagate_mutation` topológico            |
27| `fana-semantic`        | lib  | Cliente `verbo` + scoring de intensidad adjetiva     |
28| `fana-store`           | lib  | Persistencia sled/RocksDB + bincode/rkyv zero-copy   |
29| `fana-llm`             | lib  | Cliente HTTP a LLMs remotos (evaluación + merge)     |
30| `fana-render-plan`     | lib  | DrawCommands agnósticos (editor + sidepane + ghost)  |
31| `fana-editor-gpui`     | lib  | WorkspaceEditor View + OscilloscopeSidepane + Ghost  |
32| `fana-md-reader-web`   | lib  | Lector markdown DOM (ex pluma-reader-web)            |
33| `fana-editor-web`      | lib  | (futuro) editor WASM                                 |
34
35## Modelo de datos
36
37```rust
38enum CoherenceState { Valid, InConflict { origin, reason }, PendingEvaluation }
39
40struct NarrativeAtom {
41    id: Uuid,
42    content_hash: [u8; 32],            // SHA-256 estricto
43    content: Arc<String>,              // texto compartido (zero-alloc al ramificar)
44    semantic_vectors: HashMap<String, f32>,  // concepto → intensidad
45    dependencies: Vec<Uuid>,           // nodos prerrequisito
46    branch_id: String,
47    coherence: CoherenceState,
48}
49
50struct NarrativeGraph {
51    nodes: HashMap<Uuid, NarrativeAtom>,
52    adjacency_list: HashMap<Uuid, Vec<Uuid>>,  // padre → hijos dependientes
53}
54```
55
56## Dependencias
57
58- `fana-semantic` ← `verbo` (embeddings, instancia modelo ligero ~384d).
59- `fana-md` puro (sin deps de host).
60- `fana-md-reader-web` + `fana-editor-web` ← `wasm-bindgen`, `web-sys`.
61- `fana-editor-gpui` ← `gpui`, `nahual`.
62- `gioser-web` sigue consumiendo `fana-md-reader-web`.
63
64## Invariantes
65
66- Toda mutación de texto valida contra el hash binario del contenido.
67- Branches comparten texto vía `Arc<String>` — clonar una rama es O(1).
68- `propagate_mutation` marca `PendingEvaluation` en cascada topológica
69  cuando un átomo origen cambia (shock-wave lógica).
70- Separabilidad UI estricta: `fana-core/md/graph/semantic/store/llm/
71  render-plan` agnósticos; `fana-editor-{gpui,web}` intercambiables.
72
73## Apps
74
75- `apps/fana` — binario GPUI (prioridad alta).
76- `apps/fana-web` — (futuro) cdylib WASM.