Feature Map

<!-- translations:start -->

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

<!-- translations:end --> This document summarizes the features currently implemented in Tesserae, with status, source files, and where they're documented.

Status legend: ✅ shipped · ⚠ in-progress / partial.

Frontend redesign — April 2026

Document-first, hierarchical wiki replaces the old graph dump. See MD0 for the route-by-route tour and MD1 for the three-layer model.

Wiki layer (L2 markdown)

Synthesis kinds (L2 → derived)

SynthesisProjector produces seven deterministic templates and adds Synthesis nodes + synthesizes / summarizes edges back into the graph.

Static site routes

AI-friendly exports

Visual design + UX

Pipeline + CLI

Pre-existing features (carried forward unchanged)

CLI and installation

• ✅ Installable Python package via pyproject.toml.
• ✅ Console commands: tesserae, tesserae, tesserae_mcp.
• ✅ scripts/install.sh for curl | bash installation.
• ✅ Editable installs by default for fast local development.

Extraction

• ✅ Deterministic research-note extractor with controlled node/edge vocabularies.
• ✅ Claude CLI/OAuth extractor for higher-quality structured extraction without API keys.
• ✅ Selective Claude routing by glob and budget limit.
• ✅ Deterministic development-code extractor for Python projects.
• ✅ Batch ingest with content hashing and --changed-only support.
• ✅ Malformed UTF-8 tolerant source reading.

Graph governance

• ✅ Controlled ResearchNodeType list — now includes SYNTHESIS.
• ✅ Controlled edge type whitelist — now includes synthesizes, summarizes.
• ✅ Validation to reject schema drift.
• ✅ Alias canonicalization.
• ✅ Review queue for ambiguous near-duplicate nodes.
• ✅ Review decisions template and merge/keep-separate workflow.
• ✅ Corpus trend summarization from per-file graphs.

Persistence and reports

• ✅ Graph JSON export.
• ✅ SQLite graph store.
• ✅ Optional Kuzu graph store.
• ✅ Graph report with counts, evidence coverage, orphan nodes, date buckets, alias-heavy nodes.
• ✅ Competitive report describing absorbed ideas from MegaMem, Graphiti/Zep, MCP graph servers, agentic RAG.

Project-local workflow

• ✅ tesserae project init
• ✅ tesserae project ingest
• ✅ tesserae project compile
• ✅ tesserae project mcp-config
• ✅ tesserae project build-site
• ✅ tesserae project serve
• ✅ tesserae project deploy (new — GitHub Pages)
• ✅ tesserae project sessions discover/import/list (explicit local agent-history import)
• ⚠ tesserae project watch (in-progress)
• ✅ tesserae project export-agent-harness
• ✅ tesserae project export-obsidian
• ✅ tesserae project export-graphiti
• ✅ tesserae project sync-graphiti

Obsidian

• ✅ Ready-to-open vault export.
• ✅ .obsidian/app.json and graph settings.
• ✅ Markdown projection.
• ✅ raw/assets/ structure.
• ✅ _meta/dashboard.md with Dataview query.

Agent harnesses

Generated target files for:

• ✅ Claude Code: CLAUDE.md, .claude/settings.json
• ✅ Codex: AGENTS.md, mcp.toml
• ✅ Gemini: GEMINI.md, .gemini/settings.json
• ✅ Kiro: steering and MCP settings
• ✅ Cursor: project rules and MCP config
• ✅ OpenCode: AGENTS.md, opencode.json

Graphiti / temporal facts

• ✅ Temporal fact projection with provenance, currentness, confidence, and invalidation fields.
• ✅ Dependency-free Graphiti episode JSONL export.
• ✅ sync-graphiti --dry-run smoke without Graphiti installed.
• ✅ Optional live sync with graphiti_core and Neo4j.

Cognee

• ✅ Cognee JSONL bundle (nodes.jsonl, edges.jsonl, manifest.json).
• ✅ Optional add-only direct import.
• ✅ Optional Codex CLI/OAuth-backed Cognee cognify adapter.
• ✅ Deterministic and Ollama embedding adapter paths for no-API-key smoke/quality workflows.

MCP server

• ✅ tesserae_mcp / python3 -m tesserae.mcp_server over stdio JSON-RPC.
• ✅ Tools: schema, graph_summary, search_nodes, node_context, search_facts, timeline.
• ✅ Multi-project registry.

Tests

The current suite covers:

• ✅ ontology guardrails (incl. new Synthesis node + synthesizes / summarizes edges);
• ✅ deterministic extraction;
• ✅ Claude CLI wrapper parsing/validation;
• ✅ selective Claude routing;
• ✅ canonicalization/review workflow;
• ✅ batch ingest;
• ✅ reports;
• ✅ SQLite/Kuzu persistence;
• ✅ Cognee bundles/import patches;
• ✅ Graphiti export/sync dry-run;
• ✅ project CLI workflow;
• ✅ agent harness export;
• ✅ Obsidian export;
• ✅ frontend generation + link integrity (no nodes/codeclass-*.html);
• ✅ wiki store idempotence;
• ✅ synthesis projector golden + idempotence;
• ✅ site components, pages, exports, relevance;
• ✅ AI-sibling shape (.txt + .json per page);
• ✅ end-to-end compile-twice idempotence;
• ✅ package install and installer contract.