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>

CHANGELOG.md

@@ -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

Cargo.lock

@@ -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"

Cargo.toml

@@ -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)

crates/apps/nakui-ui/Cargo.toml

@@ -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" }

crates/apps/nakui-ui/src/main.rs

@@ -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};

crates/core/brahman-cards/Cargo.toml

@@ -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]

crates/core/brahman-cards/src/lib.rs

@@ -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)]

crates/core/brahman-cards/src/readers.rs

@@ -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
+/// Reader para el shape JSON de los `module.json` de la metainterfaz
-/// ([`nakui_ui_schema::Module`]).
+/// ([`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

crates/modules/nakui/ui-schema/Cargo.toml

@@ -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 }

crates/modules/ui_engine/libs/meta-schema/Cargo.toml

@@ -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 }

crates/modules/ui_engine/libs/meta-schema/src/lib.rs

@@ -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
+//! Cada **módulo** declara aquí qué menús, vistas, listas y
-//! aquí qué menús, vistas, listas y formularios expone, sin escribir
+//! formularios expone, sin escribir código GPUI ni Rust. Cualquier
-//! código GPUI ni Rust. El runtime ([`nakui-ui` crate]) lee estos
+//! runtime de UI dirigida por datos (Nakui hoy, otros mañana) lo
-//! `module.json` desde un directorio y monta automáticamente la UI
+//! carga y monta la UI correspondiente.
-//! correspondiente.
 //!
 //! ## Filosofía
 //!
-//! - **UI como datos**: agregar un módulo = escribir un JSON. Ningún
+//! - **UI como datos**: agregar un módulo = escribir un JSON o un
-//!   recompile, ningún acoplamiento con el binario del runtime.
+//!   `.ncl`. Ningún recompile, ningún acoplamiento con el binario
-//! - **Persistencia universal**: el runtime conecta cada vista al
+//!   del runtime.
-//!   `nakui_core::store::Store` actual; los formularios escriben
+//! - **Backend-agnostic**: este crate sólo describe la *forma* de
-//!   ops por la pipeline normal de Nakui (executor + event log).
+//!   la UI. La conexión a un store/log/executor concretos vive en
-//! - **Schema primero, semántica después**: este crate sólo define
+//!   el runtime que lo consume (ej: el meta-runtime de Nakui que
-//!   la *forma* de los manifests. Validación semántica
+//!   wirea esto a `nakui_core` + KCL post-checks).
-//!   (referencias rotas a entities, campos faltantes, etc.) vive en
+//! - **Schema primero, semántica después**: validación semántica
-//!   el runtime que lo carga, no acá.
+//!   (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` +
+    /// Path opaco al backend que va a manejar este módulo. Lo
-    /// schemas KCL + scripts Rhai). Cuando está set, el runtime
+    /// interpreta el runtime concreto (no este schema).
-    /// carga un `Executor` para ese path y permite que las acciones
+    ///
-    /// `Morphism { name }` despachen al pipeline real
+    /// Convención actual de Nakui: directorio con `nsmc.json` +
-    /// (compute → log → apply).
+    /// 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
+    /// Si es `None`, los backends que requieren manifest deberían
-    /// (toast informativo al usuario). Las acciones `SeedEntity`
+    /// degradar (toast informativo, deshabilitar morphisms, etc.);
-    /// siguen funcionando sin esto — son altas administrativas que
+    /// los `SeedEntity` siguen funcionando — son altas
-    /// no necesitan validación de manifest.
+    /// administrativas que no necesitan validación de manifest.
-    #[serde(default)]
+    ///
+    /// 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

crates/modules/ui_engine/libs/meta-schema/tests/example_modules.rs

@@ -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) => {
+        yahweh_meta_schema::View::Form(form) => {
-            matches!(form.on_submit, nakui_ui_schema::Action::Morphism { .. })
+            matches!(form.on_submit, yahweh_meta_schema::Action::Morphism { .. })
         }
         _ => false,
     });