Mapa de funciones

<!-- translations:start -->

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

<!-- translations:end --> Este documento resume las funciones actualmente implementadas en Tesserae, con estado, archivos fuente y dónde están documentadas.

Tesserae es un motor de contexto que corre sobre tres pilares: (1) monitorización de sesiones, (2) ingesta de conocimiento autónoma y proactiva, y (3) docs/contexto bajo demanda. El grafo tipado, el vault y el sitio estático son proyecciones de la base de conocimiento. Las funciones de abajo están agrupadas según el pilar al que sirven; el hito v0.5.0 (junio 2026) entregó la espina dorsal del engine y la función estrella del Pilar 3, el compilador de contexto bajo demanda.

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

Cross-project y UX — v0.11.0 (junio 2026)

Interop, búsqueda y setup — v0.10.0 (junio 2026)

Motor de contexto — v0.5.0 (junio 2026)

La espina dorsal del engine que impulsa los tres pilares. Ver MD0 para el mapa de módulos de la espina del engine, el sidecar de memoria de auto-mejora y el dataflow del compilador de contexto.

Espina del engine (pilares 1 y 2)

Memoria de auto-mejora (pilar 2)

Recuperación + embeddings (pilares 2 y 3)

Compilador de contexto bajo demanda (pilar 3 — titular)

Compilación incremental (Fase 4 — experimental)

Rediseño del frontend — abril 2026

Una wiki document-first y jerárquica reemplaza al viejo volcado del grafo. Ver MD0 para el recorrido ruta a ruta y MD1 para el modelo de tres capas.

Capa wiki (markdown L2)

Tipos de síntesis (L2 → derivado)

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

Rutas del sitio estático

Exports amigables para IA

Diseño visual + UX

Pipeline + CLI

Funciones preexistentes (mantenidas sin cambios)

CLI e instalación

• ✅ Paquete Python instalable vía pyproject.toml.
• ✅ Comandos de consola: tesserae, tesserae, tesserae_mcp.
• ✅ scripts/install.sh para instalación 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 de 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 de --changed-only.
• ✅ Lectura de fuentes tolerante a UTF-8 malformado.

Gobernanza del grafo

• ✅ Lista controlada ResearchNodeType — ahora incluye SYNTHESIS.
• ✅ Whitelist controlada de tipos de arista — ahora incluye synthesizes, summarizes.
• ✅ Validación para rechazar la deriva de esquema.
• ✅ Canonicalización de alias.
• ✅ Cola de revisión para nodos casi-duplicados ambiguos.
• ✅ Plantilla de decisiones de revisión y flujo merge/keep-separate.
• ✅ Resumen de tendencias del corpus desde grafos por archivo.

Persistencia e informes

• ✅ Export JSON del grafo.
• ✅ Store de grafo SQLite.
• ✅ Store de grafo Kuzu opcional.
• ✅ Informe del grafo con recuentos, cobertura de evidencia, nodos huérfanos, buckets por fecha, nodos con muchos alias.
• ✅ Informe competitivo describiendo ideas absorbidas de MegaMem, Graphiti/Zep, servidores de grafo MCP, RAG agéntico.

Flujo local al proyecto

• ✅ tesserae init --bare
• ✅ tesserae compile <paths>
• ✅ tesserae compile
• ✅ tesserae projects mcp-config
• ✅ tesserae export site
• ✅ tesserae serve
• ✅ tesserae export site --deploy (GitHub Pages)
• ✅ tesserae sessions discover/import/list (importación explícita de historial local de agentes)
• ✅ tesserae export site --watch (watcher de sondeo standalone)
• ✅ tesserae engine (bucle supervisor — v0.5.0)
• ✅ tesserae refresh (cadena en prosa ingest → compile → project — v0.5.0)
• ✅ tesserae context (compilador de contexto bajo demanda — v0.5.0)
• ✅ tesserae export harness
• ✅ tesserae vault export
• ✅ tesserae export graphiti
• ✅ tesserae export graphiti --sync

Obsidian

• ✅ Export de vault listo para abrir.
• ✅ .obsidian/app.json y ajustes del grafo.
• ✅ Proyección markdown.
• ✅ Estructura raw/assets/.
• ✅ _meta/dashboard.md con consulta de Dataview.

Agent harnesses

Archivos target generados para:

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

Graphiti / hechos temporales

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

Servidor MCP

• ✅ tesserae_mcp / python3 -m tesserae.mcp_server sobre stdio JSON-RPC.
• ✅ Herramientas de recuperación/grafo: schema, graph_summary, search_nodes, node_context (con use_ppr), search_facts, timeline, graph_ppr, wiki_page, raw_source, lint_report, doctor_report.
• ✅ Herramientas del motor de contexto (v0.5.0): compile_context, embedding_status, fresh_insights (rankeado por decay), list_communities, find_session_findings, find_code_symbol_mentions, ask.
• ✅ Herramientas de setup: tesserae_setup_plan, tesserae_setup_apply.
• ✅ Registro multi-proyecto: list_projects, register_project, unregister_project, list_sessions. Dispatch de URL de store vía url_resolver.

Tests

La suite actual cubre:

• ✅ guardarraíles de ontología (incl. nuevo nodo Synthesis + aristas synthesizes / summarizes);
• ✅ extracción determinista;
• ✅ parsing/validación del wrapper de Claude CLI;
• ✅ enrutamiento selectivo de Claude;
• ✅ flujo de canonicalización/revisión;
• ✅ ingesta por lotes;
• ✅ informes;
• ✅ persistencia SQLite/Kuzu;
• ✅ export/sync dry-run de Graphiti;
• ✅ flujo CLI de proyecto;
• ✅ export de agent harness;
• ✅ export de Obsidian;
• ✅ generación de frontend + integridad de enlaces (sin nodes/codeclass-*.html);
• ✅ idempotencia del wiki store;
• ✅ golden + idempotencia del proyector de síntesis;
• ✅ componentes, páginas, exports y relevancia del sitio;
• ✅ forma de los AI siblings (.txt + .json por página);
• ✅ idempotencia end-to-end de compilar dos veces;
• ✅ espina del engine: pipeline, cadena de refresco, núcleo del daemon + fuentes, CLI de project engine;
• ✅ memoria de auto-mejora: sidecar, decay/supersede, supresión de supersede (incl. MCP), reinforce/contradicción;
• ✅ recuperación + embeddings: búsqueda híbrida, PPR, embeddings reales por defecto (Fase 6);
• ✅ compilador de contexto: forma/integridad de citas/determinismo/presupuesto/fallback de PPR, CLI de project context, compile_context de MCP;
• ✅ compilación incremental (experimental): differ, puertas de paridad, preparación de procedencia, procedencia SQLite;
• ✅ instalación del paquete y contrato del instalador.