Files
graph_explorer/enrichers.h
T
egutierrez 7a94160fd2 feat: catch-up de decisiones previas (Webpage→Url, anti-bot, UI 2-col, tests cross-platform)
Bloque de cambios revisados y validados con el usuario en sesiones
previas que no habian aterrizado en commits propios. Lista por tema:

* enrichers: web_search ahora usa lite.duckduckgo.com como endpoint
  primario (mas tolerante con bot detection desde IP residencial),
  con fallback al endpoint html. Detecta pagina captcha y emite
  error claro si ambos fallan. Anyade _DDGLiteParser para el formato
  lite + auto-pick de parser por contenido.

* enrichers: tipo Webpage unificado en Url (campos de cuerpo
  cacheado viven en metadata del Url). Manifests actualizados
  (applies_to: [Url]). fetch_webpage ya no convierte Url->Webpage.

* enrichers/manifest: campo `params` parseado a EnricherSpec.params
  (name, type, default_value, description). UI puede renderizar
  dialog de configuracion.

* jobs: fix de path conversion para Python embebido nativo Windows
  (no convertir a /mnt/c/... cuando el subproceso es Windows-native;
  solo cuando es bash o python via WSL).

* main.cpp: ventana ImGui (no modal) "Run enricher" con layout
  2-col (label izq, input der). Inserta job con JSON tipado. Layout
  clustering apretado: hijos del mismo anchor en un solo anillo
  alrededor del padre, sin desperdigar por anillos crecientes.

* views: inspector con layout 2-col via BeginTable (Identity,
  Schema fields, Extras). Description full-width debajo de su label.

* tests: portable conftest (auto-detecta REGISTRY_ROOT, PYTHON_BIN,
  ENRICHERS_DIR para WSL y Windows portable). _runner.py trampoline
  inyecta stub via sys.path porque embedded Python ignora PYTHONPATH.
  Tests bash-only (vendor_script, freeze, dispatcher bash, resolver
  Linux-binary) skipean en Windows. Tests existentes adaptados a
  Webpage->Url.

Resultado actual: 32 passed WSL, 21 passed + 11 skipped Windows.
2026-05-03 14:41:28 +02:00

74 lines
2.9 KiB
C++

#pragma once
#include <string>
#include <vector>
// Registro estatico de enrichers (issue 0026).
//
// Al arrancar la app se escanea `<app_dir>/enrichers/*/manifest.yaml` y se
// rellena el registro. El context menu del viewport consulta
// `enrichers_for_type(type_ref)` para mostrar el submenu filtrado por tipo
// del nodo right-clickado.
//
// Los parametros declarados en `params:` del manifest se parsean para que
// la UI pueda renderizar un dialog de configuracion antes de lanzar el
// job. Si la lista esta vacia, el job se submitea directamente con `{}`.
namespace ge {
// Parametro declarado en `manifest.yaml` -> entrada `{ name, type, default }`.
// La UI de configuracion edita un buffer string por param y lo serializa a
// JSON segun el `type` al pulsar Run.
struct EnricherParam {
std::string name; // ej: "limit"
std::string type; // "int" | "float" | "string" | "bool"
std::string default_value; // valor por defecto en formato texto
std::string description; // opcional, para tooltip
};
struct EnricherSpec {
std::string id; // ej: "fetch_webpage"
std::string name; // ej: "Fetch web page"
std::string description;
std::vector<std::string> applies_to; // tipos validos (case-insensitive)
std::string run_path; // path absoluto al ejecutable/script
// Lenguaje del enricher (issue 0033 fase A). Determina como
// jobs.cpp construye el argv del subprocess. Valores soportados:
// "python" (default si no se especifica) -> python <run_path>
// "go" -> <run_path> directo
// "bash" -> bash <run_path>
std::string lang;
// Basename del ejecutable o script (sin extension). El loader
// resuelve <dir>/<exec_basename>{.py|.sh} o, para go,
// <dir>/<exec_basename>{.exe} segun la plataforma. Default "run".
std::string exec_basename;
// Parametros editables por el usuario antes de lanzar el job.
std::vector<EnricherParam> params;
// True si lang != "" y no se pudo resolver el ejecutable
// correspondiente (ej: enricher Go sin compilar). El loader deja
// el spec en el registro pero marcado como deshabilitado para
// que la UI pueda mostrar un warning.
bool disabled = false;
std::string disabled_reason;
};
// Escanea el directorio. Reentrante (limpia el registro anterior). Devuelve
// el numero de enrichers cargados, -1 si el dir no existe.
int enrichers_load(const char* enrichers_dir);
// Lista todos los enrichers cargados.
const std::vector<EnricherSpec>& enrichers_all();
// Filtra por tipo. Comparacion case-insensitive. Si applies_to es vacio en el
// manifest, el enricher se considera global (aplica a cualquier tipo).
std::vector<EnricherSpec> enrichers_for_type(const char* type_ref);
// Resuelve un enricher por id. Devuelve nullptr si no existe.
const EnricherSpec* enricher_by_id(const char* id);
} // namespace ge