14.5 KB · updated 2026-05-19 · md

feature-map.es.md

docs/i18n/feature-map.es.md

Mapa de funciones

English · 한국어 · 中文 · 日本語 · Русский · Español · Français · Deutsch

Este documento resume las funciones implementadas actualmente en Tesserae, con su estado, archivos fuente y dónde están documentadas.

Leyenda de estado: ✅ publicado · ⚠ en progreso / parcial.

Rediseño del frontend — abril de 2026

Una wiki jerárquica centrada en documentos reemplaza el antiguo volcado de grafos. Consulta MD0 para el recorrido ruta por ruta y MD1 para el modelo de tres capas.

Capa wiki (L2 markdown)

Función	Estado	Fuente	Ancla de documentación
`WikiPageStore` (escrituras idempotentes con body-hash, parser de frontmatter)	✅	MD0	architecture.md § Mapa de módulos
`WikiLayerProjector` — una página md por nodo de la capa wiki	✅	MD0	architecture.md § Canalización
Páginas `sources/`	✅	`wiki_projector.py`	frontend-redesign.md § Sources
Páginas `concepts/`	✅	`wiki_projector.py`	frontend-redesign.md § Concepts
Páginas `entities/`	✅	`wiki_projector.py`	frontend-redesign.md § Entities
Páginas `papers/`	✅	`wiki_projector.py`	frontend-redesign.md § Papers
Páginas `repos/`	✅	`wiki_projector.py`	frontend-redesign.md § Repos
Páginas `topics/`	✅	`wiki_projector.py`	frontend-redesign.md § Topics
Páginas `questions/` (preguntas abiertas)	✅	`wiki_projector.py`	frontend-redesign.md § Questions
Páginas `syntheses/`	✅	MD0	frontend-redesign.md § Syntheses

Tipos de síntesis (L2 → derivado)

SynthesisProjector produce siete plantillas deterministas y añade nodos Synthesis y aristas synthesizes / summarizes de vuelta al grafo.

Tipo	Estado	Fuente	Notas
`pulse` (uno global, alimenta `/`)	✅	`synthesis.py`	Se reconstruye en cada compilación.
`daily_digest`	✅	`synthesis.py`	Uno por `data/research/daily/<date>/`.
`weekly`	✅	`synthesis.py`	Uno por `data/research/weekly/<iso-week>/`.
`topic`	✅	`synthesis.py`	Uno por clúster `ResearchTopic` / `ApproachFamily` con ≥ 3 papers.
`comparison`	✅	`synthesis.py`	Uno por par de `ApproachFamily` que compiten en la misma tarea.
`field_overview`	✅	`synthesis.py`	Uno por `ResearchField`.
Resúmenes mejorados con LLM (activados por variable de entorno)	⚠	solo hook	La línea base heurística se entrega; el hook `TESSERAE_SYNTHESIS_LLM=1` queda como stub.

Rutas del sitio estático

Ruta	Estado	Fuente	Notas
`/` (inicio, pulse principal)	✅	MD0 `render_home`	Fila de estadísticas + puntos de entrada curados + actividad reciente.
`/sources/`, `/sources/<slug>.html`	✅	`pages.py::render_sources_index`, `render_source_detail`
`/concepts/`, `/concepts/<slug>.html`	✅	`pages.py::render_concepts_index`, `render_concept_detail`
`/entities/`, `/entities/<slug>.html`	✅	`pages.py::render_entities_index`, `render_entity_detail`
`/papers/`, `/papers/<slug>.html`	✅	`pages.py::render_papers_index`, `render_paper_detail`
`/repos/`, `/repos/<slug>.html`	✅	`pages.py::render_repos_index`, `render_repo_detail`
`/topics/`, `/topics/<slug>.html`	✅	`pages.py::render_topics_index`, `render_topic_detail`
`/syntheses/`, `/syntheses/<slug>.html`	✅	`pages.py::render_syntheses_index`, `render_synthesis_detail`
`/questions/`, `/questions/<slug>.html`	✅	`pages.py::render_questions_index`, `render_question_detail`
`/timeline/`	✅	`pages.py::render_timeline`	Mapa de calor + lista de días + carril de síntesis.
`/timeline/<YYYY-MM-DD>.html` (detalle por día)	⚠	aún n/a	Las celdas del mapa de calor enlazan provisionalmente a la página fuente `digest.md` de ese día. Subagent P está conectando las páginas de detalle diario mediante `StaticSiteBuilder`.
`/graph/` (2D + 3D interactivo)	✅	`pages.py::render_graph_view` + `js.py`	3d-force-graph + Three.js, tooltips al pasar el cursor, etiquetas de aristas, zoom anclado al cursor.
`/about.html`	✅	`pages.py::render_about`	Esquema, información de compilación.

Exportaciones amigables para IA

Artefacto	Estado	Fuente	Propósito
Archivo hermano `<page>.txt` por página	✅	MD0 `write_siblings`	Vista en texto plano de una página (sin navegación ni estilos).
Archivo hermano `<page>.json` por página	✅	`exports.py::write_siblings`	`{title, kind, body, body_text, links, source_path, frontmatter}`.
`llms.txt`	✅	`exports.py::render_llms_txt`	Índice corto de llmstxt.org.
`llms-full.txt`	✅	`exports.py::render_llms_full_txt`	Cuerpo de todas las páginas, limitado a 5 MB.
`graph.jsonld`	✅	`exports.py::render_graph_jsonld`	`Dataset` de schema.org, solo nodos de la capa wiki.
`graph.json`	✅	`__init__.py::write_site`	Payload completo del grafo (incl. nodos de código para herramientas).
`search-index.json`	✅	MD0	Paleta + búsqueda de páginas; solo tipos de la capa wiki.
`sitemap.xml`	✅	`exports.py::render_sitemap_xml`	Todas las rutas emitidas, `lastmod` desde frontmatter.
`rss.xml`	✅	`exports.py::render_rss_xml`	Últimas 30 syntheses.
`robots.txt`	✅	`exports.py::render_robots_txt`	Permisivo — rastrear + indexar.
`ai-readme.md`	✅	`exports.py::render_ai_readme`	Mapa del sitio legible por máquina.
`manifest.json`	✅	`__init__.py::_manifest`	sha256 + tamaño de cada archivo emitido (arnés de idempotencia).

Diseño visual + UX

Función	Estado	Fuente	Notas
Tokens de diseño (temas claro + oscuro, acento terracota)	✅	MD0	Un único paquete CSS en `assets/style.css`.
Alternador de tema (persistente, sin destello)	✅	MD0	`data-theme="dark"` en `localStorage`, aplicado antes del pintado.
Paleta de búsqueda (`cmd+k` / `ctrl+k` / `/`)	✅	`js.py`	Coincidencia difusa sobre `search-index.json`; lista de páginas recientes.
TOC derecho fijo	✅	`pages.py` + `tokens.py`	Solo escritorio; cajón móvil mediante `<details>`.
Mapa de calor de actividad con etiquetas de mes + día de semana	✅	`components.py::heatmap_svg`	SVG de 26 semanas, las celdas enlazan al `digest.md` del día.
Sparkline (por concepto/entidad)	✅	`components.py::sparkline_svg`	Conteos semanales de menciones, últimas 12 semanas.
Shell móvil (carril de cajón, navegación inferior, tipografía fluida)	✅	`tokens.py` + `pages.py`	Objetivos táctiles ≥ 44 px.
Transiciones de página (opacidad 120 ms, prefers-reduced-motion)	✅	`tokens.py`
Vista de grafo 3D + 2D (hover, etiquetas de aristas, zoom anclado al cursor)	✅	`pages.py::render_graph_view` + `js.py`	3d-force-graph + Three.js, vendorizado como snapshot de CDN.
Pie de hermanos IA por página	✅	`components.py::ai_siblings_footer`	Enlaces en línea al `.txt` y `.json` de la página actual.
Páginas de historial de sesiones del arnés	✅	MD0 + MD1	Importación explícita de Claude Code/Codex; índice `/sessions/` y páginas de detalle con turnos markdown, carril izquierdo de turnos, uso de herramientas colapsado y entradas de búsqueda.

Canalización + CLI

Función	Estado	Fuente	Notas
`project compile` llama a synthesis + wiki + site en orden	✅	MD0	Fase 3 del plan de rediseño.
`project build-site` independiente	✅	`project.py` + MD1	Lee `wiki/` + `graph.json`, escribe `site/`.
`project serve` HTTP local	✅	`cli.py`	Servidor stdlib simple.
`project deploy` → GitHub Pages	✅	MD0	Push de worktree a `gh-pages`; `--enable-pages` opcional vía CLI `gh`. `--build`, `--dry-run`, `--branch`, `--remote`, `--force`.
`project sessions discover/import/list`	✅	MD0 + `cli.py`	Historial de sesiones entrante para Claude Code/Codex; el descubrimiento es explícito y limitado al directorio de trabajo del proyecto.
`project watch` recompila al cambiar	⚠	MD0	Subagent R está terminando el watcher por sondeo — la superficie de argumentos `--interval`, `--debounce`, `--once`, `--paths`, `--quiet` está lista; el cuerpo del bucle de recompilación se está integrando en esta ronda.

Funciones preexistentes (conservadas sin cambios)

CLI e instalación

✅ Paquete Python instalable mediante pyproject.toml.
✅ Comandos de consola: tesserae, tesserae, tesserae_mcp.
✅ scripts/install.sh para instalación con curl | bash.
✅ Instalaciones editables por defecto para desarrollo local rápido.

Extracción

✅ Extractor determinista de notas de investigación con vocabularios controlados de nodos/aristas.
✅ Extractor Claude CLI/OAuth para extracción estructurada de mayor calidad sin claves API.
✅ Enrutamiento selectivo de Claude por glob y límite de presupuesto.
✅ Extractor determinista de código de desarrollo para proyectos Python.
✅ Ingesta por lotes con hashing de contenido y soporte --changed-only.
✅ Lectura de fuentes tolerante a UTF-8 malformado.

Gobernanza del grafo

✅ Lista controlada ResearchNodeType — ahora incluye SYNTHESIS.
✅ Lista blanca controlada de tipos de arista — ahora incluye synthesizes, summarizes.
✅ Validación para rechazar deriva de esquema.
✅ Canonicalización de alias.
✅ Cola de revisión para nodos casi duplicados ambiguos.
✅ Plantilla de decisiones de revisión y flujo de fusionar/mantener separado.
✅ Resumen de tendencias del corpus a partir de grafos por archivo.

Persistencia e informes

✅ Exportación Graph JSON.
✅ Almacén de grafos SQLite.
✅ Almacén de grafos Kuzu opcional.
✅ Informe de grafo con conteos, cobertura de evidencia, nodos huérfanos, buckets de fecha y nodos con muchos alias.
✅ Informe competitivo que describe ideas absorbidas de MegaMem, Graphiti/Zep, MCP graph servers, agentic RAG.

Flujo de trabajo local del proyecto

✅ tesserae project init
✅ tesserae project ingest
✅ tesserae project compile
✅ tesserae project mcp-config
✅ tesserae project build-site
✅ tesserae project serve
✅ tesserae project deploy (nuevo — GitHub Pages)
✅ tesserae project sessions discover/import/list (importación explícita de historial de agente local)
⚠ tesserae project watch (en progreso)
✅ tesserae project export-agent-harness
✅ tesserae project export-obsidian
✅ tesserae project export-graphiti
✅ tesserae project sync-graphiti

Obsidian

✅ Exportación de vault lista para abrir.
✅ .obsidian/app.json y configuración de grafo.
✅ Proyección Markdown.
✅ Estructura raw/assets/.
✅ _meta/dashboard.md con consulta Dataview.

Arneses de agente

Archivos de destino generados para:

✅ Claude Code: CLAUDE.md, .claude/settings.json
✅ Codex: AGENTS.md, mcp.toml
✅ Gemini: GEMINI.md, .gemini/settings.json
✅ Kiro: steering y configuración MCP
✅ Cursor: reglas de proyecto y configuración MCP
✅ OpenCode: AGENTS.md, opencode.json

Graphiti / hechos temporales

✅ Proyección de hechos temporales con campos de procedencia, vigencia, confianza e invalidación.
✅ Exportación JSONL de episodios Graphiti sin dependencias.
✅ Smoke sync-graphiti --dry-run sin Graphiti instalado.
✅ Sincronización en vivo opcional con graphiti_core y Neo4j.

Cognee

✅ Paquete Cognee JSONL (nodes.jsonl, edges.jsonl, manifest.json).
✅ Importación directa opcional solo-adición.
✅ Adaptador Cognee cognify opcional respaldado por Codex CLI/OAuth.
✅ Rutas de adaptador de embeddings determinista y Ollama para flujos smoke/calidad sin clave API.

Servidor MCP

✅ tesserae_mcp / python3 -m tesserae.mcp_server sobre stdio JSON-RPC.
✅ Herramientas: schema, graph_summary, search_nodes, node_context, search_facts, timeline.
✅ Registro multiproyecto.

Pruebas

La suite actual cubre:

✅ guardrails de ontología (incl. nuevo nodo Synthesis + aristas synthesizes / summarizes);
✅ extracción determinista;
✅ parsing/validación del wrapper Claude CLI;
✅ enrutamiento selectivo de Claude;
✅ flujo de canonicalización/revisión;
✅ ingesta por lotes;
✅ informes;
✅ persistencia SQLite/Kuzu;
✅ bundles/import patches de Cognee;
✅ exportación/sincronización Graphiti dry-run;
✅ flujo CLI del proyecto;
✅ exportación de arnés de agente;
✅ exportación Obsidian;
✅ generación frontend + integridad de enlaces (sin nodes/codeclass-*.html);
✅ idempotencia del almacén wiki;
✅ golden + idempotencia de synthesis projector;
✅ componentes, páginas, exportaciones y relevancia del sitio;
✅ forma de hermanos IA (.txt + .json por página);
✅ idempotencia end-to-end al compilar dos veces;
✅ instalación de paquete y contrato del instalador.