graph_explorer/issues/0036b-kind-discriminator-and-group-loader.md at d6e13fddc37858e707a716d6f1edc9896d325397

Files

T

egutierrez d6e13fddc3 feat(0036b): NodeGroups admite kind=Group + loader entities

NodeGroupsWindowState gana un discriminador `kind` (Table | Group) y
un flag `focus_request` (lo consumira 0036c). Por defecto Table, asi
que el flujo historico (DuckDB rows tras expand de un nodo Table) no
cambia.

kind=Group lee directamente operations.db consultando
`entities WHERE group_id = container_id` con columnas fijas
(id, name, type_ref, status, updated_at) ordenadas por updated_at DESC.
Los nuevos loaders viven en node_groups.cpp:

  - node_groups_count_for_group  -> SELECT count(*) ...
  - node_groups_page_for_group   -> SELECT id,name,type_ref,status,
                                     updated_at ... LIMIT ? OFFSET ?

Para columnas, opcion (A) del issue: pre-popular meta.columns con la
lista fija al abrir kind=Group, asi el render se mantiene generico.
NodeGroupsRow.values guarda los 5 campos en ese orden y row.id es la
key natural (= entity_id de la fila — al ser ya entidad, no hace falta
promocionarla).

Render en views.cpp ramifica por kind:

  - Table: layout original [id_col + columns + promoted] con doble
    click -> promote/focus.
  - Group: layout [columns fijas] sin promoted. Doble click sobre la
    fila ya pone want_focus_entity = id (los flujos posteriores 0036c-e
    afinan UX). Right click ofrece "Focus in Inspector".

main.cpp dispatcha por kind al refrescar paginas y, al cerrar via X,
solo llama a node_groups_set_expanded para kind=Table (Group no usa
ese flag).

views_node_groups_windows_sync se hace kind-aware: solo reconcilia
entries kind=Table contra el set de Tables expandidas; no toca las
entries kind=Group (las gestiona views_node_groups_open).

Nueva API publica:

  views_node_groups_open(app, container_id, kind, ops_db)

Crea o reusa la entry, setea focus_request=true y para kind=Group
pre-popula meta.columns + intenta leer `name` del Group para el
titulo. Sin caller todavia — la consume 0036c.

Tests:
  - tests/test_node_groups_loader.py (6 tests) verifica el contrato
    SQL via gx-cli. Nuevo subcomando `gx-cli group page <id>` espejea
    el loader C++ exactamente (mismo SQL); tambien expuesto como tool
    MCP `group_page` para que Echo pueda inspeccionar Groups.

Resultado:
  - WSL: 89 -> 95 passed
  - Windows: 78+11 -> 84+11 passed
  - Build C++ Windows limpio, sin warnings nuevos.
  - Regresion kind=Table: comportamiento identico (mismo render,
    mismo loader DuckDB).

Refs: issues/0036b-kind-discriminator-and-group-loader.md

2026-05-04 00:52:25 +02:00

2.5 KiB

Raw Blame History

id, title, status, priority, created, parent, depends_on

title

status

priority

created

parent

depends_on

0036b

NodeGroups window con kind (Table | Group) y loader para Groups

pending

high

2026-05-04

0036

0036a

Objetivo

Que la NodeGroups window admita dos kinds: Table (DuckDB-backed, comportamiento actual) y Group (entidades hijas con group_id set). La window se elige por el type_ref del contenedor; el loader y las columnas mostradas se ramifican por kind.

Cambios

`NodeGroupsWindowState` extendido

Anyadir campo:

enum class NodeGroupsKind { Table, Group };
NodeGroupsKind kind = NodeGroupsKind::Table;

Loaders por kind (en `node_groups.cpp`)

kind = Table: comportamiento actual (node_groups_load_metadata
- node_groups_page_rows sobre DuckDB).
kind = Group: nuevo loader que hace SELECT id, name, type_ref, status, updated_at FROM entities WHERE group_id = ? ORDER BY updated_at DESC LIMIT ? OFFSET ?
- SELECT count(*) para total_rows. Las columnas que se renderizan son fijas: id, name, type_ref, status, updated_at.

Convertir el dispatch en un metodo o switch dentro de node_groups_load_metadata y node_groups_page_rows que mire kind.

Columnas dinamicas en el render

Hoy views.cpp (en la pintura de la window) asume las columnas DuckDB. Adaptar para que cuando kind == Group use las columnas fijas listadas arriba.

Apertura programatica

Para que 0036c pueda abrir una window de Group, exponer una API limpia tipo:

NodeGroupsWindowState* node_groups_open(AppState& app,
                                        const std::string& container_id,
                                        NodeGroupsKind kind);

Que crea la entrada en app.node_groups_windows[container_id] si no existe, le pone el kind, y retorna puntero. El caller puede setear focus_request = true antes de devolver el control al render.

Acceptance criteria

Tests pytest siguen verdes.
Manual: insertar via SQL un nodo Group con 5 entidades hijas (group_id = <ese group>), luego en la app llamar a node_groups_open(app, "<group_id>", Group) (o disparar via test unitario en C++ si se incluye), recargar render → la window muestra las 5 entidades con columnas id/name/type_ref/status/ updated_at correctas.
Apertura de un Table existente (kind=Table) sigue funcionando identico (regresion).

TBD

Branch issue/0036b-kind-and-group-loader, merge --no-ff a master.

Out of scope

Disparar drill-in desde doble click sobre Group (es 0036c).
Promote / row click (0036d-e).

2.5 KiB Raw Blame History