feat(minga-explorer): nueva app dashboard del repo Minga sobre stack yahweh
Iter 11. Cierra integración del módulo Minga (VCS semántico P2P) al ecosistema GUI. Antes Minga sólo tenía CLI; ahora hay un dashboard GPUI con counts del repo en vivo. crates/apps/minga-explorer/: - Deps: minga-store + yahweh-theme + 3 widgets compartidos. Sin minga-cli (sin passphrase prompts) ni minga-core. - PersistentRepo abierto directo (counts son lectura pública, sin passphrase). El DID sigue requiriendo `minga status` CLI. - Refresh polling 2s (mismo pattern que nakui/nouser explorer). - 3 stat cards: Nodos AST, Atestaciones, Claves MST. Cada una con border-l accent + label + número grande + descripción. - Helper stat_card() factoriza la card. - Header con título dinámico + theme switcher. - error_banner themed. - 2 tests sanity (missing dir errors, RepoSnapshot default). Smoke run verificado: bootstrap completo OK, panic esperado en open_window sin display. Apps GUI themed: 4 (nakui-ui, nakui-explorer, nouser-explorer, minga-explorer). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
Sergio
@@ -6,6 +6,56 @@ ratio/diff ver `git show <sha>`.
|
||||
|
||||
## 2026-05-10
|
||||
|
||||
### feat(minga-explorer): nueva app dashboard del repo Minga sobre stack yahweh
|
||||
Iter 11. Cierra el último frente identificado: integración del
|
||||
módulo Minga (VCS semántico P2P) al ecosistema GUI. Antes Minga
|
||||
sólo tenía CLI (`minga init/status/ingest/listen/sync/watch`).
|
||||
Ahora hay un **dashboard GPUI** que muestra los counts del repo
|
||||
en vivo, sobre el mismo stack themed que las otras dos apps
|
||||
explorer.
|
||||
|
||||
Crate nuevo `crates/apps/minga-explorer/`:
|
||||
- **Deps**: `minga-store` (para `PersistentRepo::open`) +
|
||||
`yahweh-theme` + `yahweh-widget-{banner,card,theme-switcher}`.
|
||||
Sin `minga-cli` (no necesita prompts de passphrase) ni
|
||||
`minga-core` (counts no requieren parsear AST).
|
||||
- **Lectura sin passphrase**: el `PersistentRepo` se abre directo
|
||||
desde `<repo>/repo` sled. Los counts (`nodes.len()`,
|
||||
`attestations.len()`, `mst.len()`) son lectura pública. Para el
|
||||
DID se sigue necesitando `minga status` (CLI con passphrase).
|
||||
- **Refresh por polling cada 2s**: mismo pattern que
|
||||
`nakui-explorer`/`nouser-explorer`.
|
||||
- **3 stat cards** una por dimensión:
|
||||
- Nodos AST (cyan) — fragments parseados del código.
|
||||
- Atestaciones (verde) — firmas Ed25519 sobre los nodos.
|
||||
- Claves MST (purple) — entradas del Merkle Search Tree.
|
||||
- **Helper `stat_card(cx, label, value, description, accent, ...)`**:
|
||||
fabrica una card con border-l colored + label tenue + número
|
||||
grande (`px(28)`) + descripción. Reutilizable.
|
||||
- **Header**: título dinámico (`Repo: <path> · reload <ms> ms`)
|
||||
+ theme switcher derecha.
|
||||
- **Error banner**: themed Banner::Error si el repo no abre.
|
||||
- 2 tests: `load_snapshot_errors_on_missing_dir` (msg claro
|
||||
cuando el dir no existe) + sanity del `RepoSnapshot::default`.
|
||||
|
||||
Workspace: nueva entry en `members[]`.
|
||||
|
||||
Smoke run del binario verificado: bootstrap completo OK, panic
|
||||
esperado en open_window por falta de display.
|
||||
|
||||
Beneficio operativo:
|
||||
- Un usuario corre `minga init` + `minga ingest archivo.rs` desde
|
||||
CLI, después abre `minga-explorer` y ve los counts crecer en
|
||||
vivo cuando ingiere más archivos.
|
||||
- Comparte theme switcher con `nakui-explorer` y
|
||||
`nouser-explorer` — cualquier preset elegido se aplica
|
||||
visualmente igual cross-app.
|
||||
- `minga` deja de ser sólo CLI; gana presencia GUI sin tocar
|
||||
el resto del módulo.
|
||||
|
||||
Apps GUI integradas al stack themed: **4** (nakui-ui, nakui-explorer,
|
||||
nouser-explorer, minga-explorer).
|
||||
|
||||
### feat(nouser-explorer): integración al stack yahweh themed
|
||||
Iter 10. `nouser-explorer` (la app paralela a `nakui-explorer`
|
||||
para ver Mónadas via daemon nouser) tenía colors hardcoded
|
||||
|
||||
Generated
+12
@@ -6196,6 +6196,18 @@ dependencies = [
|
||||
"tree-sitter-typescript",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "minga-explorer"
|
||||
version = "0.1.0"
|
||||
dependencies = [
|
||||
"gpui",
|
||||
"minga-store",
|
||||
"yahweh-theme",
|
||||
"yahweh-widget-banner",
|
||||
"yahweh-widget-card",
|
||||
"yahweh-widget-theme-switcher",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "minga-p2p"
|
||||
version = "0.1.0"
|
||||
|
||||
@@ -92,6 +92,7 @@ members = [
|
||||
"crates/apps/nouser-explorer",
|
||||
"crates/apps/nakui-explorer",
|
||||
"crates/apps/nakui-ui",
|
||||
"crates/apps/minga-explorer",
|
||||
]
|
||||
|
||||
[workspace.package]
|
||||
|
||||
@@ -0,0 +1,18 @@
|
||||
[package]
|
||||
name = "minga-explorer"
|
||||
version.workspace = true
|
||||
edition.workspace = true
|
||||
license.workspace = true
|
||||
description = "Dashboard GPUI del repo Minga: counts de nodos AST, atestaciones, claves MST, refresh por polling. Lee sled directo (sin passphrase). Standalone."
|
||||
|
||||
[dependencies]
|
||||
minga-store = { path = "../../modules/semantic_dht/minga-store" }
|
||||
yahweh-theme = { path = "../../modules/ui_engine/libs/theme" }
|
||||
yahweh-widget-banner = { path = "../../modules/ui_engine/widgets/banner" }
|
||||
yahweh-widget-card = { path = "../../modules/ui_engine/widgets/card" }
|
||||
yahweh-widget-theme-switcher = { path = "../../modules/ui_engine/widgets/theme-switcher" }
|
||||
gpui = { workspace = true }
|
||||
|
||||
[[bin]]
|
||||
name = "minga-explorer"
|
||||
path = "src/main.rs"
|
||||
@@ -0,0 +1,303 @@
|
||||
//! `minga-explorer` — dashboard GPUI del repo Minga (VCS semántico
|
||||
//! P2P).
|
||||
//!
|
||||
//! Polling cada 2s contra `MINGA_REPO` (env, default `./.minga`),
|
||||
//! abre el `PersistentRepo` (sled, sin passphrase porque los counts
|
||||
//! son lectura pública) y muestra:
|
||||
//! - Cantidad de nodos AST almacenados.
|
||||
//! - Cantidad de atestaciones firmadas.
|
||||
//! - Cantidad de claves del MST (Merkle Search Tree).
|
||||
//!
|
||||
//! No requiere keypair descifrado — eso se queda para el CLI
|
||||
//! (`minga status`) cuando hace falta el DID. El explorer foco es
|
||||
//! observabilidad rápida.
|
||||
//!
|
||||
//! Stack visual: yahweh-theme + banner_themed + card_themed +
|
||||
//! theme_switcher. Mismo patrón que `nakui-explorer` /
|
||||
//! `nouser-explorer`.
|
||||
//!
|
||||
//! Uso:
|
||||
//! ```sh
|
||||
//! cargo run -p minga-explorer
|
||||
//! # con repo custom:
|
||||
//! MINGA_REPO=/path/to/.minga cargo run -p minga-explorer
|
||||
//! ```
|
||||
|
||||
use std::path::PathBuf;
|
||||
use std::time::Duration;
|
||||
|
||||
use gpui::{
|
||||
div, prelude::*, px, App, Application, Bounds, Context, IntoElement, Render, SharedString,
|
||||
Window, WindowBounds, WindowOptions,
|
||||
};
|
||||
use minga_store::PersistentRepo;
|
||||
use yahweh_theme::Theme;
|
||||
use yahweh_widget_banner::{banner_themed, Banner};
|
||||
use yahweh_widget_card::card_themed;
|
||||
use yahweh_widget_theme_switcher::theme_switcher;
|
||||
|
||||
const REFRESH_INTERVAL: Duration = Duration::from_secs(2);
|
||||
const REPO_DIRNAME: &str = "repo";
|
||||
|
||||
fn main() {
|
||||
Application::new().run(|cx: &mut App| {
|
||||
Theme::install_default(cx);
|
||||
let bounds = Bounds::centered(None, gpui::size(px(800.), px(560.)), cx);
|
||||
cx.open_window(
|
||||
WindowOptions {
|
||||
window_bounds: Some(WindowBounds::Windowed(bounds)),
|
||||
titlebar: Some(gpui::TitlebarOptions {
|
||||
title: Some(SharedString::from("Minga — Repo")),
|
||||
..Default::default()
|
||||
}),
|
||||
..Default::default()
|
||||
},
|
||||
|_w, cx| cx.new(Explorer::new),
|
||||
)
|
||||
.expect("open window");
|
||||
cx.activate(true);
|
||||
});
|
||||
}
|
||||
|
||||
/// Snapshot de counts del repo. Se reemplaza completo en cada
|
||||
/// refresh — los stores no diff fácilmente, y los counts son
|
||||
/// baratos (sled tracks size).
|
||||
#[derive(Clone, Default, Debug)]
|
||||
struct RepoSnapshot {
|
||||
nodes: usize,
|
||||
attestations: usize,
|
||||
mst_keys: usize,
|
||||
}
|
||||
|
||||
struct Explorer {
|
||||
repo_path: PathBuf,
|
||||
snapshot: Option<RepoSnapshot>,
|
||||
error: Option<SharedString>,
|
||||
last_load_ms: u64,
|
||||
}
|
||||
|
||||
impl Explorer {
|
||||
fn new(cx: &mut Context<Self>) -> Self {
|
||||
let repo_path = std::env::var("MINGA_REPO")
|
||||
.ok()
|
||||
.map(PathBuf::from)
|
||||
.unwrap_or_else(|| PathBuf::from(".minga"));
|
||||
let path_for_loop = repo_path.clone();
|
||||
cx.spawn(async move |this, cx| {
|
||||
let timer = cx.background_executor().clone();
|
||||
loop {
|
||||
let started = std::time::Instant::now();
|
||||
let result = load_snapshot(&path_for_loop);
|
||||
let elapsed = started.elapsed().as_millis() as u64;
|
||||
let _ = this.update(cx, |me, cx| {
|
||||
match result {
|
||||
Ok(snap) => {
|
||||
me.snapshot = Some(snap);
|
||||
me.error = None;
|
||||
}
|
||||
Err(e) => {
|
||||
me.error = Some(SharedString::from(format!(
|
||||
"no pude leer repo {}: {}",
|
||||
me.repo_path.display(),
|
||||
e
|
||||
)));
|
||||
}
|
||||
}
|
||||
me.last_load_ms = elapsed;
|
||||
cx.notify();
|
||||
});
|
||||
timer.timer(REFRESH_INTERVAL).await;
|
||||
}
|
||||
})
|
||||
.detach();
|
||||
|
||||
Self {
|
||||
repo_path,
|
||||
snapshot: None,
|
||||
error: None,
|
||||
last_load_ms: 0,
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/// Lee el repo sled `<repo_path>/repo` y devuelve los 3 counts.
|
||||
/// Falla si: el dir no existe, sled rebota al abrir, o cualquier
|
||||
/// store falla a `len()`. Ningún error es fatal — la UI muestra el
|
||||
/// banner y mantiene el último snapshot bueno.
|
||||
fn load_snapshot(repo_path: &std::path::Path) -> Result<RepoSnapshot, String> {
|
||||
let inner = repo_path.join(REPO_DIRNAME);
|
||||
if !inner.exists() {
|
||||
return Err(format!(
|
||||
"directorio del repo sled no existe: {}",
|
||||
inner.display()
|
||||
));
|
||||
}
|
||||
let repo = PersistentRepo::open(&inner).map_err(|e| format!("open: {e}"))?;
|
||||
Ok(RepoSnapshot {
|
||||
nodes: repo.nodes.len(),
|
||||
attestations: repo.attestations.len(),
|
||||
mst_keys: repo.mst.len(),
|
||||
})
|
||||
}
|
||||
|
||||
impl Render for Explorer {
|
||||
fn render(&mut self, _w: &mut Window, cx: &mut Context<Self>) -> impl IntoElement {
|
||||
let theme = Theme::global(cx).clone();
|
||||
let bg = theme.bg_app.clone();
|
||||
let text = theme.fg_text;
|
||||
let text_dim = theme.fg_muted;
|
||||
// Acentos por kind del dashboard: nodos azul, atestaciones
|
||||
// verde, MST purple. Señales semánticas del dominio Minga.
|
||||
let accent_nodes = gpui::rgb(0x88c0d0);
|
||||
let accent_attestations = gpui::rgb(0xa3be8c);
|
||||
let accent_mst = gpui::rgb(0xb48ead);
|
||||
|
||||
let header_text = match &self.snapshot {
|
||||
Some(_) => format!(
|
||||
"Repo: {} · reload {} ms",
|
||||
self.repo_path.display(),
|
||||
self.last_load_ms
|
||||
),
|
||||
None => format!("Buscando repo en {}…", self.repo_path.display()),
|
||||
};
|
||||
|
||||
let header = div()
|
||||
.flex()
|
||||
.flex_row()
|
||||
.items_center()
|
||||
.px(px(16.))
|
||||
.py(px(12.))
|
||||
.bg(theme.bg_panel.clone())
|
||||
.border_b_1()
|
||||
.border_color(theme.border)
|
||||
.text_color(text)
|
||||
.text_size(px(14.))
|
||||
.child(div().flex_grow().child(header_text))
|
||||
.child(theme_switcher(cx));
|
||||
|
||||
let error_banner = self.error.as_ref().map(|e| {
|
||||
banner_themed(cx, Banner::Error, e.clone())
|
||||
.px(px(16.))
|
||||
.py(px(8.))
|
||||
.text_size(px(12.))
|
||||
});
|
||||
|
||||
let body = match &self.snapshot {
|
||||
None => div()
|
||||
.px(px(16.))
|
||||
.py(px(20.))
|
||||
.text_color(text_dim)
|
||||
.text_size(px(13.))
|
||||
.child("Esperando primer refresh…"),
|
||||
Some(snap) => div()
|
||||
.flex()
|
||||
.flex_col()
|
||||
.gap(px(8.))
|
||||
.px(px(16.))
|
||||
.py(px(16.))
|
||||
.child(stat_card(
|
||||
cx,
|
||||
"Nodos AST",
|
||||
snap.nodes,
|
||||
"fragments parseados del código",
|
||||
accent_nodes,
|
||||
text,
|
||||
text_dim,
|
||||
))
|
||||
.child(stat_card(
|
||||
cx,
|
||||
"Atestaciones",
|
||||
snap.attestations,
|
||||
"firmas Ed25519 sobre los nodos",
|
||||
accent_attestations,
|
||||
text,
|
||||
text_dim,
|
||||
))
|
||||
.child(stat_card(
|
||||
cx,
|
||||
"Claves MST",
|
||||
snap.mst_keys,
|
||||
"entradas del Merkle Search Tree",
|
||||
accent_mst,
|
||||
text,
|
||||
text_dim,
|
||||
)),
|
||||
};
|
||||
|
||||
div()
|
||||
.flex()
|
||||
.flex_col()
|
||||
.size_full()
|
||||
.bg(bg)
|
||||
.child(header)
|
||||
.when_some(error_banner, |d, b| d.child(b))
|
||||
.child(body)
|
||||
}
|
||||
}
|
||||
|
||||
/// Card visual para una estadística del dashboard. Border-l por
|
||||
/// kind, label arriba + número grande + descripción abajo.
|
||||
fn stat_card(
|
||||
cx: &mut Context<Explorer>,
|
||||
label: &str,
|
||||
value: usize,
|
||||
description: &str,
|
||||
accent: gpui::Rgba,
|
||||
text: gpui::Hsla,
|
||||
text_dim: gpui::Hsla,
|
||||
) -> impl IntoElement {
|
||||
card_themed(cx)
|
||||
.border_l_4()
|
||||
.border_color(accent)
|
||||
.child(
|
||||
div()
|
||||
.text_color(accent)
|
||||
.text_size(px(11.))
|
||||
.child(SharedString::from(label.to_string())),
|
||||
)
|
||||
.child(
|
||||
div()
|
||||
.text_color(text)
|
||||
.text_size(px(28.))
|
||||
.child(SharedString::from(value.to_string())),
|
||||
)
|
||||
.child(
|
||||
div()
|
||||
.text_color(text_dim)
|
||||
.text_size(px(11.))
|
||||
.child(SharedString::from(description.to_string())),
|
||||
)
|
||||
}
|
||||
|
||||
#[cfg(test)]
|
||||
mod tests {
|
||||
use super::*;
|
||||
|
||||
/// Sanity: load_snapshot rebota si el dir no existe (mensaje
|
||||
/// claro). Es el path típico para "no inicializaste el repo".
|
||||
#[test]
|
||||
fn load_snapshot_errors_on_missing_dir() {
|
||||
let p = std::env::temp_dir().join(format!(
|
||||
"minga-explorer-missing-{}-{}",
|
||||
std::process::id(),
|
||||
std::time::SystemTime::now()
|
||||
.duration_since(std::time::UNIX_EPOCH)
|
||||
.map(|d| d.as_nanos())
|
||||
.unwrap_or(0)
|
||||
));
|
||||
// p NO existe.
|
||||
let err = load_snapshot(&p).unwrap_err();
|
||||
assert!(
|
||||
err.contains("no existe"),
|
||||
"msg debe explicar el missing: {err}"
|
||||
);
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn snapshot_default_is_zeros() {
|
||||
let s = RepoSnapshot::default();
|
||||
assert_eq!(s.nodes, 0);
|
||||
assert_eq!(s.attestations, 0);
|
||||
assert_eq!(s.mst_keys, 0);
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user