Files
graph_explorer/issues/0017-gx-cli.md
T
egutierrez 9042110ea2 docs(issues): plan enrichers asincronos + recoleccion web (0026-0030)
Cinco issues que componen el plan:
- 0026: sistema de jobs (infra, contrato wire)
- 0027: tipo Webpage + cache de documentos
- 0028: enricher fetch_webpage (MVP end-to-end)
- 0028b: enrichers extract_domain / extract_links / extract_text_entities
- 0029: variantes CDP (Chrome headless, screenshot)
- 0030: macro "Deep enrich" + expand_domain

Tambien anade los issues previos 0012-0025 que estaban untracked.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-01 18:24:13 +02:00

1.3 KiB

id, title, status, priority, created, depends_on
id title status priority created depends_on
0017 CLI `gx` para hablar con el endpoint local pending medium 2026-05-01
0012

Objetivo

Cliente CLI fino, instalable en ~/.local/bin/gx, que habla con el endpoint HTTP local de graph_explorer (issue 0012). Permite ingesta y consulta desde terminal o scripts sin abrir la app.

Comandos

  • gx add <type> <name> [--metadata k=v ...] — crea entidad.
  • gx rel <from_id> <kind> <to_id> — crea relacion.
  • gx ingest <file> — manda archivo al endpoint, abre preview en TUI.
  • gx from-url <url> — fetch + extract.
  • gx search "query" — devuelve hits del grafo activo (json o tabla).
  • gx neighbors <id> [--depth N].
  • gx open <id> — abre el grafo y enfoca el nodo en graph_explorer.

Decisiones

  • Implementar como sub-comando del fn CLI existente (fn gx ...) o binario aparte? Probablemente sub-comando para reusar config y auth.
  • Output JSON por defecto si stdout no es TTY (componible con jq).
  • Tabla legible si stdout es TTY.

Definicion de hecho

  • gx add person "Juan Perez" añade el nodo en el grafo en vivo.
  • gx ingest articulo.pdf lanza preview interactivo en terminal y commit.
  • gx neighbors <id> --depth 2 --format json | jq funciona en pipeline.
  • Errores de conexion al endpoint se reportan claros (no stack traces).