sergio
77 lines
3.4 KiB
Markdown
77 lines
3.4 KiB
Markdown
# modules/fana/ — Writer DAG editor (absorbe pluma)
|
|
|
|
**Propósito.** Editor de escritura multidimensional: el documento es un
|
|
DAG de átomos narrativos con ramas (timelines), tracking de coherencia,
|
|
e indexación semántica. Absorbe el linaje markdown de `pluma`. Prioridad
|
|
alta entre las apps.
|
|
|
|
## Estado
|
|
|
|
- **Implementado**: `fana-core` (átomo + coherencia), `fana-graph`
|
|
(DAG + `propagate_mutation` + orden topológico), `fana-render-plan`
|
|
(layout agnóstico: bloques en columnas por rama, conectores,
|
|
osciloscopio), `fana-editor-gpui` (backend GPUI), `fana-semantic`
|
|
(cliente `verbo`), `fana-store` (persistencia sled), `fana-md` +
|
|
`fana-md-reader-web` (linaje markdown de pluma). App `apps/fana`
|
|
funcional (relato de ejemplo + onda de choque lógica).
|
|
- **Pendiente**: `fana-llm` (cliente HTTP a LLMs remotos — requiere
|
|
cliente HTTP en el workspace), `fana-editor-web` (cdylib WASM).
|
|
|
|
## Crates (objetivo)
|
|
|
|
| crate | tipo | rol |
|
|
| ---------------------- | ---- | ---------------------------------------------------- |
|
|
| `fana-core` | lib | `NarrativeAtom` + `NarrativeGraph` + `CoherenceState`|
|
|
| `fana-md` | lib | Parser markdown (ex pluma-md) |
|
|
| `fana-graph` | lib | DAG ops + `propagate_mutation` topológico |
|
|
| `fana-semantic` | lib | Cliente `verbo` + scoring de intensidad adjetiva |
|
|
| `fana-store` | lib | Persistencia sled/RocksDB + bincode/rkyv zero-copy |
|
|
| `fana-llm` | lib | Cliente HTTP a LLMs remotos (evaluación + merge) |
|
|
| `fana-render-plan` | lib | DrawCommands agnósticos (editor + sidepane + ghost) |
|
|
| `fana-editor-gpui` | lib | WorkspaceEditor View + OscilloscopeSidepane + Ghost |
|
|
| `fana-md-reader-web` | lib | Lector markdown DOM (ex pluma-reader-web) |
|
|
| `fana-editor-web` | lib | (futuro) editor WASM |
|
|
|
|
## Modelo de datos
|
|
|
|
```rust
|
|
enum CoherenceState { Valid, InConflict { origin, reason }, PendingEvaluation }
|
|
|
|
struct NarrativeAtom {
|
|
id: Uuid,
|
|
content_hash: [u8; 32], // SHA-256 estricto
|
|
content: Arc<String>, // texto compartido (zero-alloc al ramificar)
|
|
semantic_vectors: HashMap<String, f32>, // concepto → intensidad
|
|
dependencies: Vec<Uuid>, // nodos prerrequisito
|
|
branch_id: String,
|
|
coherence: CoherenceState,
|
|
}
|
|
|
|
struct NarrativeGraph {
|
|
nodes: HashMap<Uuid, NarrativeAtom>,
|
|
adjacency_list: HashMap<Uuid, Vec<Uuid>>, // padre → hijos dependientes
|
|
}
|
|
```
|
|
|
|
## Dependencias
|
|
|
|
- `fana-semantic` ← `verbo` (embeddings, instancia modelo ligero ~384d).
|
|
- `fana-md` puro (sin deps de host).
|
|
- `fana-md-reader-web` + `fana-editor-web` ← `wasm-bindgen`, `web-sys`.
|
|
- `fana-editor-gpui` ← `gpui`, `nahual`.
|
|
- `gioser-web` sigue consumiendo `fana-md-reader-web`.
|
|
|
|
## Invariantes
|
|
|
|
- Toda mutación de texto valida contra el hash binario del contenido.
|
|
- Branches comparten texto vía `Arc<String>` — clonar una rama es O(1).
|
|
- `propagate_mutation` marca `PendingEvaluation` en cascada topológica
|
|
cuando un átomo origen cambia (shock-wave lógica).
|
|
- Separabilidad UI estricta: `fana-core/md/graph/semantic/store/llm/
|
|
render-plan` agnósticos; `fana-editor-{gpui,web}` intercambiables.
|
|
|
|
## Apps
|
|
|
|
- `apps/fana` — binario GPUI (prioridad alta).
|
|
- `apps/fana-web` — (futuro) cdylib WASM.
|