egutierrez
9042110ea2
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>
39 lines
1.3 KiB
Markdown
39 lines
1.3 KiB
Markdown
---
|
|
id: 0017
|
|
title: CLI `gx` para hablar con el endpoint local
|
|
status: pending
|
|
priority: medium
|
|
created: 2026-05-01
|
|
depends_on: [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).
|