Files
graph_explorer/issues/0014-browser-extension.md
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

50 lines
1.7 KiB
Markdown

---
id: 0014
title: Extension de navegador "Add to graph"
status: pending
priority: high
created: 2026-05-01
depends_on: [0012]
---
## Objetivo
Extension Firefox/Chrome que añade items al grafo desde el navegador con
un click. Cubre el flujo Maltego "estoy leyendo algo en web -> nodo en
mi grafo" sin abandonar el navegador.
## Casos
- Click derecho sobre seleccion de texto -> "Add to graph" (manda texto
via `/ingest/text`).
- Click derecho sobre link -> "Add link" (crea entidad URL + metadata
del href, opcionalmente trigger fetch).
- Boton de toolbar -> "Add this page" (URL + titulo + meta description +
texto principal extraido con Readability).
- Modo "select & relate": dos selecciones consecutivas -> crea relacion
entre las entidades resultantes.
## Alcance
- WebExtension API (compatible Firefox/Chrome, Manifest v3).
- Settings: URL del endpoint (default `http://localhost:7878`), token,
proyecto destino.
- Preview popup tras extraccion: muestra entities propuestas, el usuario
acepta o edita antes de commit (reusa `?commit=false` de 0012).
- Atajo configurable (ej. `Ctrl+Shift+G`) para "add page".
## Decisiones
- Sin auth OAuth — token local compartido es suficiente para localhost.
- Empaquetar en `apps/graph_explorer/extension/` o como sub-repo propio
bajo `dataforge/graph_explorer_extension`.
- Si `graph_explorer` no esta corriendo: la extension muestra error
claro y guarda la accion en cola para reintentar.
## Definicion de hecho
- Selecciono un parrafo en una pagina, click derecho -> Add, en menos de
2 s veo los nodos en `graph_explorer`.
- Funciona en Firefox y Chrome con la misma build.
- Reintento automatico de la cola cuando vuelve a haber endpoint vivo.