Mapa de funciones

<!-- translations:start -->

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

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

Tesserae es un motor de contexto que funciona sobre tres pilares: (1) monitoreo de sesiones, (2) ingesta de conocimiento autónoma y proactiva, y (3) documentos/contexto bajo demanda. El grafo tipado, el almacén (vault) y el sitio estático son proyecciones de la base de conocimiento. Las funciones de abajo se agrupan por el pilar al que sirven; el hito v0.5.0 (junio de 2026) publicó la columna del motor y la función estrella del Pilar 3, el compilador de contexto bajo demanda.

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

Motor de contexto — v0.5.0 (junio de 2026)

La columna del motor que impulsa los tres pilares. Véase MD0 para el mapa de módulos de la columna del motor, el sidecar de memoria de automejora y el flujo de datos del compilador de contexto.

Columna del motor (pilares 1 & 2)

Memoria de automejora (pilar 2)

Recuperación + embeddings (pilares 2 & 3)

Compilador de contexto bajo demanda (Pilar 3 — estrella)

Compilación incremental (Fase 4 — experimental)

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)

Tipos de síntesis (L2 → derivado)

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

Rutas del sitio estático

Exportaciones amigables para IA

Diseño visual + UX

Canalización + CLI

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 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 de agente local)
• ✅ tesserae export site --watch (watcher por sondeo autónomo)
• ✅ tesserae engine (bucle supervisor — v0.5.0)
• ✅ tesserae refresh (cadena en prosa ingesta → compilación → proyección — 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

• ✅ 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 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.
• ✅ Herramientas del motor de contexto (v0.5.0): compile_context, embedding_status, fresh_insights (orden por decaimiento), list_communities, find_session_findings, find_code_symbol_mentions, ask.
• ✅ Herramientas de configuración: tesserae_setup_plan, tesserae_setup_apply.
• ✅ Registro multiproyecto: list_projects, register_project, activate_project, unregister_project, list_sessions. Despacho de URL de almacén vía url_resolver.

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;
• ✅ columna del motor: pipeline, cadena de actualización, núcleo del demonio + fuentes, CLI project engine;
• ✅ memoria de automejora: sidecar, decaimiento/reemplazo, supresión de reemplazo (incl. MCP), refuerzo/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/repliegue PPR, CLI project context, MCP compile_context;
• ✅ compilación incremental (experimental): diferenciador, puertas de paridad, preparación de procedencia, procedencia SQLite;
• ✅ instalación de paquete y contrato del instalador.