refactor(yahweh): Fase 1 — nakui-ui-schema → yahweh-meta-schema
Primer paso del refactor yahweh. El schema de UI declarativa no tiene acoplamiento real con Nakui (sólo dep en serde/thiserror) — movemos a yahweh para que cualquier app metadata-driven lo use sin pasar por nakui. Mecánico: - git mv crates/modules/nakui/ui-schema → crates/modules/ui_engine/libs/meta-schema. - Crate name: nakui-ui-schema → yahweh-meta-schema. - Workspace members[] actualizado (sección yahweh, no nakui). - Consumers actualizados: brahman-cards (Cargo.toml + lib.rs + readers.rs), nakui-ui (Cargo.toml + main.rs). - Self-test (example_modules.rs): import + path rebase (5 niveles arriba ahora). Documental: - Doc del crate ahora dice "metainterfaz (yahweh meta-schema)" + "backend-agnostic" en filosofía. - Module.nakui_module_dir documentado como "path opaco al backend"; se conserva el nombre por compat con módulos ya escritos + serde alias "backend_module_dir" para futuro rename suave. Tests: 13 yahweh-meta-schema + 26 brahman-cards + 48 nakui-ui verdes. Workspace build verde. NO hace Fase 1: mover widgets a yahweh (Fase 2), trait MetaBackend (Fase 3), renombrar nakui_module_dir. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
Sergio
@@ -6,6 +6,79 @@ ratio/diff ver `git show <sha>`.
|
||||
|
||||
## 2026-05-09
|
||||
|
||||
### refactor(yahweh): Fase 1 — `nakui-ui-schema` → `yahweh-meta-schema`
|
||||
Primer paso del refactor yahweh. El schema de UI declarativa
|
||||
(entities, menús, listas, formularios, acciones) vivía bajo
|
||||
`crates/modules/nakui/ui-schema/` y se llamaba `nakui-ui-schema` —
|
||||
un nombre que sugería acoplamiento con Nakui que en realidad no
|
||||
existe (el crate sólo depende de `serde`/`serde_json`/`thiserror`).
|
||||
Lo movemos a yahweh para que sea consumible por cualquier app de UI
|
||||
metadata-driven sin hacer pasar la dep "rara" por nakui.
|
||||
|
||||
Cambios mecánicos:
|
||||
- **`git mv`**: `crates/modules/nakui/ui-schema/` →
|
||||
`crates/modules/ui_engine/libs/meta-schema/`.
|
||||
- **Cargo.toml del crate movido**:
|
||||
- `name = "nakui-ui-schema"` → `name = "yahweh-meta-schema"`.
|
||||
- Description actualizada: "Yahweh — meta-schema: descriptores
|
||||
declarativos de UI ... independiente del backend".
|
||||
- **Workspace `Cargo.toml`**: la entry del members[] pasa de
|
||||
`crates/modules/nakui/ui-schema` a
|
||||
`crates/modules/ui_engine/libs/meta-schema` (en su sección
|
||||
yahweh, no en la sección nakui).
|
||||
- **`brahman-cards`**:
|
||||
- Cargo.toml: dep path/name a `yahweh-meta-schema`.
|
||||
- lib.rs: `pub use nakui_ui_schema::Module` →
|
||||
`pub use yahweh_meta_schema::Module`.
|
||||
- readers.rs: comment + doc-link al nuevo nombre.
|
||||
- **`nakui-ui`**:
|
||||
- Cargo.toml: dep path/name a `yahweh-meta-schema`.
|
||||
- main.rs: `use nakui_ui_schema::{...}` →
|
||||
`use yahweh_meta_schema::{...}`.
|
||||
- **Self-test del crate movido**
|
||||
(`tests/example_modules.rs`): `nakui_ui_schema` → `yahweh_meta_schema`,
|
||||
y se rebasa el path del repo root (5 niveles arriba ahora, era 4).
|
||||
|
||||
Cambios documentales:
|
||||
- **Doc de crate** (`lib.rs`): "Schema declarativo de la metainterfaz
|
||||
Nakui" → "Schema declarativo de la metainterfaz (yahweh
|
||||
meta-schema)" + "backend-agnostic" en la filosofía. La sección
|
||||
Persistencia universal pasa de "el runtime conecta cada vista al
|
||||
`nakui_core::store::Store`" a un wording neutro: "el runtime que
|
||||
consume este schema conecta vistas a su backend".
|
||||
- **Doc del field `Module.nakui_module_dir`**: ahora marcado como
|
||||
"path opaco al backend, lo interpreta el runtime concreto". Se
|
||||
describe la convención actual de Nakui (nsmc.json + KCL + Rhai)
|
||||
como ejemplo, no como contrato del schema. El nombre del campo
|
||||
se mantiene por compat con módulos ya escritos; agregado
|
||||
`#[serde(alias = "backend_module_dir")]` para que un futuro
|
||||
rename no rompa los actuales.
|
||||
|
||||
Tests:
|
||||
- yahweh-meta-schema (crate movido): 13 tests propios siguen
|
||||
verdes tras el path rebase.
|
||||
- brahman-cards: 26/26 verdes (17 integration + 9 nickel).
|
||||
- nakui-ui: 48/48 verdes.
|
||||
- Workspace build verde.
|
||||
|
||||
Lo que NO hace Fase 1:
|
||||
- No mueve los widgets de UI (form/list/modal/EntityRef selector)
|
||||
a yahweh — eso es Fase 2.
|
||||
- No introduce un trait `MetaBackend` para desacoplar la lógica
|
||||
de runtime de Nakui — eso es Fase 3.
|
||||
- No renombra el field `nakui_module_dir`. Se hará cuando aparezca
|
||||
un segundo backend que también lo necesite.
|
||||
|
||||
**Pendientes** (orden):
|
||||
1. **Fase 2**: extraer widgets render (form/list/modal/EntityRef
|
||||
selector + helpers parse_field_value/render_value/etc.) a un
|
||||
nuevo crate `yahweh-widget-meta-form` (o nombre similar).
|
||||
2. **Fase 3**: trait `MetaBackend` + thin shell — `nakui-ui` queda
|
||||
reducido a una impl de backend wireada a `nakui-core`.
|
||||
3. **KCL → Nickel**: kcl_wrapper reemplazado por evaluación de
|
||||
Nickel contracts.
|
||||
4. **card.k eliminado** (REFERENCE ONLY).
|
||||
|
||||
### feat(nakui-ui): migrar consumer al brazo unificado `brahman_cards::load_cards_from_dir`
|
||||
Primera consumer migration del brazo. `nakui-ui` ya no llama a
|
||||
`nakui_ui_schema::load_modules_from_dir` directamente — pasa por
|
||||
|
||||
Generated
+12
-12
@@ -1238,13 +1238,13 @@ name = "brahman-cards"
|
||||
version = "0.1.0"
|
||||
dependencies = [
|
||||
"brahman-card",
|
||||
"nakui-ui-schema",
|
||||
"nickel-lang",
|
||||
"nouser-card",
|
||||
"serde",
|
||||
"serde_json",
|
||||
"thiserror 2.0.18",
|
||||
"ulid",
|
||||
"yahweh-meta-schema",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
@@ -6396,24 +6396,14 @@ dependencies = [
|
||||
"brahman-cards",
|
||||
"gpui",
|
||||
"nakui-core",
|
||||
"nakui-ui-schema",
|
||||
"serde_json",
|
||||
"tempfile",
|
||||
"uuid",
|
||||
"yahweh-meta-schema",
|
||||
"yahweh-theme",
|
||||
"yahweh-widget-text-input",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "nakui-ui-schema"
|
||||
version = "0.1.0"
|
||||
dependencies = [
|
||||
"serde",
|
||||
"serde_json",
|
||||
"tempfile",
|
||||
"thiserror 2.0.18",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "nanorand"
|
||||
version = "0.7.0"
|
||||
@@ -12840,6 +12830,16 @@ dependencies = [
|
||||
"yahweh-theme",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "yahweh-meta-schema"
|
||||
version = "0.1.0"
|
||||
dependencies = [
|
||||
"serde",
|
||||
"serde_json",
|
||||
"tempfile",
|
||||
"thiserror 2.0.18",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "yahweh-provider-fs"
|
||||
version = "0.1.0"
|
||||
|
||||
+1
-1
@@ -52,6 +52,7 @@ members = [
|
||||
"crates/modules/ui_engine/libs/core",
|
||||
"crates/modules/ui_engine/libs/theme",
|
||||
"crates/modules/ui_engine/libs/bus",
|
||||
"crates/modules/ui_engine/libs/meta-schema",
|
||||
"crates/modules/ui_engine/libs/providers/fs",
|
||||
"crates/modules/ui_engine/libs/providers/sqlite",
|
||||
"crates/modules/ui_engine/widgets/tree",
|
||||
@@ -65,7 +66,6 @@ members = [
|
||||
# modules/nakui/ — ERP matemático (nakui absorbido)
|
||||
# ============================================================
|
||||
"crates/modules/nakui/core",
|
||||
"crates/modules/nakui/ui-schema",
|
||||
|
||||
# ============================================================
|
||||
# modules/nouser/ — explorador de Mónadas (nuevo)
|
||||
|
||||
@@ -7,7 +7,7 @@ description = "Nakui — runtime GPUI de la metainterfaz: carga module.json desd
|
||||
|
||||
[dependencies]
|
||||
nakui-core = { path = "../../modules/nakui/core" }
|
||||
nakui-ui-schema = { path = "../../modules/nakui/ui-schema" }
|
||||
yahweh-meta-schema = { path = "../../modules/ui_engine/libs/meta-schema" }
|
||||
brahman-cards = { path = "../../core/brahman-cards" }
|
||||
yahweh-widget-text-input = { path = "../../modules/ui_engine/widgets/text_input" }
|
||||
yahweh-theme = { path = "../../modules/ui_engine/libs/theme" }
|
||||
|
||||
@@ -37,7 +37,7 @@ use nakui_core::event_log::{
|
||||
use brahman_cards::CardBody;
|
||||
use nakui_core::executor::Executor;
|
||||
use nakui_core::store::{MemoryStore, Store};
|
||||
use nakui_ui_schema::{
|
||||
use yahweh_meta_schema::{
|
||||
Action, FieldKind, FieldSpec, FormView, ListView, Module, View,
|
||||
};
|
||||
use serde_json::{json, Value};
|
||||
|
||||
@@ -15,7 +15,7 @@ thiserror = { workspace = true }
|
||||
ulid = { workspace = true }
|
||||
brahman-card = { path = "../brahman-card" }
|
||||
nouser-card = { path = "../../modules/nouser/card" }
|
||||
nakui-ui-schema = { path = "../../modules/nakui/ui-schema" }
|
||||
yahweh-meta-schema = { path = "../../modules/ui_engine/libs/meta-schema" }
|
||||
nickel-lang = "2.0.0"
|
||||
|
||||
[dev-dependencies]
|
||||
|
||||
@@ -48,8 +48,8 @@ use serde_json::Value;
|
||||
use thiserror::Error;
|
||||
|
||||
pub use brahman_card::Card as EnteCard;
|
||||
pub use nakui_ui_schema::Module as UiModuleSpec;
|
||||
pub use nouser_card::MonadManifest;
|
||||
pub use yahweh_meta_schema::Module as UiModuleSpec;
|
||||
|
||||
/// Estructura canónica única que consumen los downstream del sistema
|
||||
/// (UI runtime, storage, DHT, wire). Cada formato input se proyecta
|
||||
@@ -59,7 +59,7 @@ pub use nouser_card::MonadManifest;
|
||||
/// (identidad legible + extensiones forward-compat); el body preserva
|
||||
/// el typing rico de cada dominio sin colapsarlos.
|
||||
// PartialEq se omite porque algunos body variants vienen de crates
|
||||
// que no lo implementan (MonadManifest, nakui_ui_schema::Module).
|
||||
// que no lo implementan (MonadManifest, yahweh_meta_schema::Module).
|
||||
// Si downstream necesita igualdad, comparar via JSON round-trip o
|
||||
// agregar PartialEq en los crates origen.
|
||||
#[derive(Debug, Clone, Serialize, Deserialize)]
|
||||
|
||||
@@ -114,11 +114,11 @@ impl CardReader for MonadJsonReader {
|
||||
}
|
||||
|
||||
// ============================================================================
|
||||
// UiModule (nakui-ui-schema)
|
||||
// UiModule (yahweh-meta-schema)
|
||||
// ============================================================================
|
||||
|
||||
/// Reader para el shape JSON de los `module.json` de la UI Nakui
|
||||
/// ([`nakui_ui_schema::Module`]).
|
||||
/// Reader para el shape JSON de los `module.json` de la metainterfaz
|
||||
/// ([`yahweh_meta_schema::Module`]).
|
||||
///
|
||||
/// Heurística: tiene `entities` Y `views` Y `menu`. Es el shape más
|
||||
/// específico del repo, así que va primero en el orden default — si
|
||||
|
||||
@@ -1,14 +0,0 @@
|
||||
[package]
|
||||
name = "nakui-ui-schema"
|
||||
version.workspace = true
|
||||
edition.workspace = true
|
||||
license.workspace = true
|
||||
description = "Nakui UI metainterface schema: módulos declaran menús, listas y formularios como datos (JSON); el runtime los carga y renderiza sin código compilado por módulo."
|
||||
|
||||
[dependencies]
|
||||
serde = { workspace = true }
|
||||
serde_json = { workspace = true }
|
||||
thiserror = { workspace = true }
|
||||
|
||||
[dev-dependencies]
|
||||
tempfile = { workspace = true }
|
||||
@@ -0,0 +1,14 @@
|
||||
[package]
|
||||
name = "yahweh-meta-schema"
|
||||
version.workspace = true
|
||||
edition.workspace = true
|
||||
license.workspace = true
|
||||
description = "Yahweh — meta-schema: descriptores declarativos de UI (entities, menús, listas, formularios, acciones) consumidos por widgets metainterfaz reusables. Independiente del backend: cualquier app que monte una UI dirigida por datos puede usarlo."
|
||||
|
||||
[dependencies]
|
||||
serde = { workspace = true }
|
||||
serde_json = { workspace = true }
|
||||
thiserror = { workspace = true }
|
||||
|
||||
[dev-dependencies]
|
||||
tempfile = { workspace = true }
|
||||
+34
-26
@@ -1,22 +1,22 @@
|
||||
//! Schema declarativo de la metainterfaz Nakui.
|
||||
//! Schema declarativo de la metainterfaz (yahweh meta-schema).
|
||||
//!
|
||||
//! Cada **módulo** Nakui (customers, products, sales, ...) declara
|
||||
//! aquí qué menús, vistas, listas y formularios expone, sin escribir
|
||||
//! código GPUI ni Rust. El runtime ([`nakui-ui` crate]) lee estos
|
||||
//! `module.json` desde un directorio y monta automáticamente la UI
|
||||
//! correspondiente.
|
||||
//! Cada **módulo** declara aquí qué menús, vistas, listas y
|
||||
//! formularios expone, sin escribir código GPUI ni Rust. Cualquier
|
||||
//! runtime de UI dirigida por datos (Nakui hoy, otros mañana) lo
|
||||
//! carga y monta la UI correspondiente.
|
||||
//!
|
||||
//! ## Filosofía
|
||||
//!
|
||||
//! - **UI como datos**: agregar un módulo = escribir un JSON. Ningún
|
||||
//! recompile, ningún acoplamiento con el binario del runtime.
|
||||
//! - **Persistencia universal**: el runtime conecta cada vista al
|
||||
//! `nakui_core::store::Store` actual; los formularios escriben
|
||||
//! ops por la pipeline normal de Nakui (executor + event log).
|
||||
//! - **Schema primero, semántica después**: este crate sólo define
|
||||
//! la *forma* de los manifests. Validación semántica
|
||||
//! (referencias rotas a entities, campos faltantes, etc.) vive en
|
||||
//! el runtime que lo carga, no acá.
|
||||
//! - **UI como datos**: agregar un módulo = escribir un JSON o un
|
||||
//! `.ncl`. Ningún recompile, ningún acoplamiento con el binario
|
||||
//! del runtime.
|
||||
//! - **Backend-agnostic**: este crate sólo describe la *forma* de
|
||||
//! la UI. La conexión a un store/log/executor concretos vive en
|
||||
//! el runtime que lo consume (ej: el meta-runtime de Nakui que
|
||||
//! wirea esto a `nakui_core` + KCL post-checks).
|
||||
//! - **Schema primero, semántica después**: validación semántica
|
||||
//! (referencias rotas a entities, campos faltantes, etc.) vive
|
||||
//! en el runtime que lo carga, no acá.
|
||||
//!
|
||||
//! ## Anatomía de un módulo
|
||||
//!
|
||||
@@ -47,7 +47,7 @@ use std::path::{Path, PathBuf};
|
||||
use serde::{Deserialize, Serialize};
|
||||
use thiserror::Error;
|
||||
|
||||
/// Manifiesto de un módulo de la metainterfaz Nakui.
|
||||
/// Manifiesto de un módulo declarativo de UI.
|
||||
#[derive(Debug, Clone, Serialize, Deserialize)]
|
||||
pub struct Module {
|
||||
/// Identificador estable. Único dentro del directorio cargado.
|
||||
@@ -66,20 +66,28 @@ pub struct Module {
|
||||
#[serde(default)]
|
||||
pub entities: Vec<EntitySpec>,
|
||||
|
||||
/// Path a un módulo nakui-core (directorio con `nsmc.json` +
|
||||
/// schemas KCL + scripts Rhai). Cuando está set, el runtime
|
||||
/// carga un `Executor` para ese path y permite que las acciones
|
||||
/// `Morphism { name }` despachen al pipeline real
|
||||
/// (compute → log → apply).
|
||||
/// Path opaco al backend que va a manejar este módulo. Lo
|
||||
/// interpreta el runtime concreto (no este schema).
|
||||
///
|
||||
/// Convención actual de Nakui: directorio con `nsmc.json` +
|
||||
/// schemas KCL + scripts Rhai. Cuando está set, el runtime
|
||||
/// Nakui carga un `Executor` para ese path y permite que las
|
||||
/// acciones `Morphism { name }` despachen al pipeline real
|
||||
/// (compute → log → apply). Otro backend puede ignorar este
|
||||
/// campo o darle un significado distinto.
|
||||
///
|
||||
/// Path resuelto relativo al directorio del `module.json`
|
||||
/// o absoluto.
|
||||
///
|
||||
/// Si es `None`, las acciones `Morphism` quedan deshabilitadas
|
||||
/// (toast informativo al usuario). Las acciones `SeedEntity`
|
||||
/// siguen funcionando sin esto — son altas administrativas que
|
||||
/// no necesitan validación de manifest.
|
||||
#[serde(default)]
|
||||
/// Si es `None`, los backends que requieren manifest deberían
|
||||
/// degradar (toast informativo, deshabilitar morphisms, etc.);
|
||||
/// los `SeedEntity` siguen funcionando — son altas
|
||||
/// administrativas que no necesitan validación de manifest.
|
||||
///
|
||||
/// Nombre conservado por compat con módulos ya escritos.
|
||||
/// Renombrar a `backend_module_dir` o similar si emerge un
|
||||
/// segundo backend que también lo use.
|
||||
#[serde(default, alias = "backend_module_dir")]
|
||||
pub nakui_module_dir: Option<String>,
|
||||
|
||||
/// Items del menú. Cada uno apunta a una key de `views`. Orden
|
||||
+7
-4
@@ -4,13 +4,16 @@
|
||||
//! corra `NAKUI_MODULES_DIR=examples/nakui-modules cargo run -p nakui-ui`
|
||||
//! va a obtener los 6 módulos cargados sin tocar nada.
|
||||
|
||||
use nakui_ui_schema::{load_modules_from_dir, FieldKind, View};
|
||||
use yahweh_meta_schema::{load_modules_from_dir, FieldKind, View};
|
||||
|
||||
fn examples_dir() -> std::path::PathBuf {
|
||||
// Tests corren desde el dir del crate; el repo root está dos
|
||||
// niveles arriba: crates/modules/nakui/ui-schema → repo.
|
||||
// Tras el lift a yahweh, el crate vive en
|
||||
// `crates/modules/ui_engine/libs/meta-schema`, así que el repo
|
||||
// root queda 5 niveles arriba.
|
||||
let here = std::path::Path::new(env!("CARGO_MANIFEST_DIR"));
|
||||
here.join("../../../..").join("examples/nakui-modules")
|
||||
here.join("../../../../..").join("examples/nakui-modules")
|
||||
}
|
||||
|
||||
#[test]
|
||||
@@ -50,8 +53,8 @@ fn sales_engine_declares_nakui_module_dir_and_morphism() {
|
||||
"sales_engine debería declarar nakui_module_dir"
|
||||
);
|
||||
let has_morphism_view = sales.views.values().any(|v| match v {
|
||||
nakui_ui_schema::View::Form(form) => {
|
||||
matches!(form.on_submit, nakui_ui_schema::Action::Morphism { .. })
|
||||
yahweh_meta_schema::View::Form(form) => {
|
||||
matches!(form.on_submit, yahweh_meta_schema::Action::Morphism { .. })
|
||||
}
|
||||
_ => false,
|
||||
});
|
||||
Reference in New Issue
Block a user