feature-map.ja.md
docs/i18n/feature-map.ja.md
機能マップ
<!-- translations:start -->
English · 한국어 · 中文 · 日本語 · Русский · Español · Français · Deutsch
<!-- translations:end --> このドキュメントは、Tesserae に現在実装されている機能を、状態、ソースファイル、ドキュメント上の場所とともにまとめたものです。
状態凡例: ✅ 出荷済み · ⚠ 進行中 / 部分実装。
フロントエンド再設計 — 2026年4月
従来のグラフダンプを、ドキュメント中心の階層型 wiki が置き換えます。ルートごとのツアーは MD0 、3層モデルは MD1 を参照してください。
Wiki レイヤー (L2 markdown)
| 機能 | 状態 | ソース | ドキュメントアンカー |
|---|---|---|---|
WikiPageStore（冪等な body-hash 書き込み、frontmatter パーサー） | ✅ | MD0 | architecture.md § モジュールマップ |
WikiLayerProjector — wiki レイヤーノードごとに 1 つの md ページ | ✅ | MD0 | architecture.md § パイプライン |
sources/ ページ | ✅ | wiki_projector.py | frontend-redesign.md § Sources |
concepts/ ページ | ✅ | wiki_projector.py | frontend-redesign.md § Concepts |
entities/ ページ | ✅ | wiki_projector.py | frontend-redesign.md § Entities |
papers/ ページ | ✅ | wiki_projector.py | frontend-redesign.md § Papers |
repos/ ページ | ✅ | wiki_projector.py | frontend-redesign.md § Repos |
topics/ ページ | ✅ | wiki_projector.py | frontend-redesign.md § Topics |
questions/ ページ（未解決の質問） | ✅ | wiki_projector.py | frontend-redesign.md § Questions |
syntheses/ ページ | ✅ | MD0 | frontend-redesign.md § Syntheses |
合成の種類 (L2 → 派生)
SynthesisProjector は 7 つの決定的テンプレートを生成し、Synthesis ノードと synthesizes / summarizes エッジをグラフへ戻します。
| 種類 | 状態 | ソース | 注記 |
|---|---|---|---|
pulse（グローバルに 1 つ、/ を駆動） | ✅ | synthesis.py | compile のたびに再構築されます。 |
daily_digest | ✅ | synthesis.py | data/research/daily/<date>/ ごとに 1 つ。 |
weekly | ✅ | synthesis.py | data/research/weekly/<iso-week>/ ごとに 1 つ。 |
topic | ✅ | synthesis.py | 3 本以上の papers を含む ResearchTopic / ApproachFamily クラスターごとに 1 つ。 |
comparison | ✅ | synthesis.py | 同じタスクで競合する ApproachFamily のペアごとに 1 つ。 |
field_overview | ✅ | synthesis.py | ResearchField ごとに 1 つ。 |
| LLM 強化サマリー（環境フラグ） | ⚠ | hook のみ | ヒューリスティックなベースラインは出荷済み。TESSERAE_SYNTHESIS_LLM=1 hook は stub として残されています。 |
静的サイトルート
| ルート | 状態 | ソース | 注記 |
|---|---|---|---|
/（ホーム、hero pulse） | ✅ | MD0 render_home | 統計行 + キュレーション済み入口 + 最近の活動。 |
/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 | ヒートマップ + 日付リスト + synthesis レール。 |
/timeline/<YYYY-MM-DD>.html（日別詳細） | ⚠ | まだ n/a | ヒートマップセルは暫定的にその日の digest.md ソースページへリンクします。Subagent P が StaticSiteBuilder 経由で日別詳細ページを配線中です。 |
/graph/（インタラクティブ 2D + 3D） | ✅ | pages.py::render_graph_view + js.py | 3d-force-graph + Three.js、ホバーツールチップ、エッジラベル、カーソル基準ズーム。 |
/about.html | ✅ | pages.py::render_about | スキーマ、ビルド情報。 |
AI フレンドリーなエクスポート
| アーティファクト | 状態 | ソース | 目的 |
|---|---|---|---|
ページごとの <page>.txt 兄弟ファイル | ✅ | MD0 write_siblings | 1 ページのプレーンテキスト表示（ナビゲーション、スタイルなし）。 |
ページごとの <page>.json 兄弟ファイル | ✅ | exports.py::write_siblings | {title, kind, body, body_text, links, source_path, frontmatter}。 |
llms.txt | ✅ | exports.py::render_llms_txt | llmstxt.org の短いインデックス。 |
llms-full.txt | ✅ | exports.py::render_llms_full_txt | 全ページ本文、5 MB 上限。 |
graph.jsonld | ✅ | exports.py::render_graph_jsonld | schema.org Dataset、wiki レイヤーノードのみ。 |
graph.json | ✅ | __init__.py::write_site | 完全なグラフペイロード（ツール用コードノードを含む）。 |
search-index.json | ✅ | MD0 | パレット + ページ検索。wiki レイヤー種別のみ。 |
sitemap.xml | ✅ | exports.py::render_sitemap_xml | 出力された全ルート、lastmod は frontmatter 由来。 |
rss.xml | ✅ | exports.py::render_rss_xml | 最新 30 件の syntheses。 |
robots.txt | ✅ | exports.py::render_robots_txt | 許可的 — クロール + インデックス。 |
ai-readme.md | ✅ | exports.py::render_ai_readme | 機械可読サイトマップ。 |
manifest.json | ✅ | __init__.py::_manifest | 出力された各ファイルの sha256 + サイズ（冪等性ハーネス）。 |
ビジュアルデザイン + UX
| 機能 | 状態 | ソース | 注記 |
|---|---|---|---|
| デザイントークン（ライト + ダークテーマ、テラコッタのアクセント） | ✅ | MD0 | assets/style.css の単一 CSS バンドル。 |
| テーマ切替（永続化、ちらつきなし） | ✅ | MD0 | localStorage 内の data-theme="dark"、描画前に適用。 |
検索パレット（cmd+k / ctrl+k / /） | ✅ | js.py | search-index.json に対するファジーマッチ。最近ページリスト。 |
| 右側固定 TOC | ✅ | pages.py + tokens.py | デスクトップのみ。モバイルは <details> によるドロワー。 |
| 月 + 曜日ラベル付き活動ヒートマップ | ✅ | components.py::heatmap_svg | 26 週 SVG、セルはその日の digest.md へリンク。 |
| Sparkline（概念/エンティティごと） | ✅ | components.py::sparkline_svg | 週次メンション数、直近 12 週。 |
| モバイルシェル（ドロワーレール、下部ナビ、流動的な文字サイズ） | ✅ | tokens.py + pages.py | タッチターゲット ≥ 44 px。 |
| ページ遷移（120 ms 不透明度、prefers-reduced-motion） | ✅ | tokens.py | |
| 3D + 2D グラフ表示（ホバー、エッジラベル、カーソル基準ズーム） | ✅ | pages.py::render_graph_view + js.py | 3d-force-graph + Three.js、CDN スナップショットとして vendored。 |
| ページごとの AI 兄弟ファイルフッター | ✅ | components.py::ai_siblings_footer | 現在ページの .txt と .json へのインラインリンク。 |
| ハーネスセッション履歴ページ | ✅ | MD0 + MD1 | 明示的な Claude Code/Codex インポート。markdown ターン、左側ターンレール、折りたたみツール使用、検索エントリを備えた /sessions/ インデックスと詳細ページ。 |
パイプライン + CLI
| 機能 | 状態 | ソース | 注記 |
|---|---|---|---|
project compile は synthesis + wiki + site を順に呼び出す | ✅ | MD0 | 再設計計画のフェーズ 3。 |
project build-site 単体実行 | ✅ | project.py + MD1 | wiki/ + graph.json を読み、site/ を書き出す。 |
project serve ローカル HTTP | ✅ | cli.py | 素の stdlib サーバー。 |
project deploy → GitHub Pages | ✅ | MD0 | gh-pages への worktree push。gh CLI 経由の任意 --enable-pages。--build, --dry-run, --branch, --remote, --force。 |
project sessions discover/import/list | ✅ | MD0 + cli.py | Claude Code/Codex 用のインバウンドセッション履歴。発見は明示的で、プロジェクト作業ディレクトリにスコープされる。 |
project watch 変更時再ビルド | ⚠ | MD0 | Subagent R がポーリング watcher を仕上げ中 — --interval, --debounce, --once, --paths, --quiet の引数面は準備済み。再ビルドループ本体はこのラウンドで投入中。 |
既存機能（変更なしで継続）
CLI とインストール
- ✅
pyproject.tomlによるインストール可能な Python パッケージ。 - ✅ コンソールコマンド:
tesserae,tesserae,tesserae_mcp。 - ✅
curl | bashインストール用のscripts/install.sh。 - ✅ 高速なローカル開発のため、デフォルトで editable install。
抽出
- ✅ 制御されたノード/エッジ語彙を持つ決定的な研究ノート抽出器。
- ✅ API キーなしで高品質な構造化抽出を行う Claude CLI/OAuth 抽出器。
- ✅ glob と予算上限による選択的 Claude ルーティング。
- ✅ Python プロジェクト向けの決定的な開発コード抽出器。
- ✅ コンテンツハッシュと
--changed-only対応のバッチ ingest。 - ✅ 不正な UTF-8 に寛容なソース読み取り。
グラフガバナンス
- ✅ 制御された
ResearchNodeTypeリスト — 現在はSYNTHESISを含む。 - ✅ 制御されたエッジタイプ許可リスト — 現在は
synthesizes,summarizesを含む。 - ✅ スキーマドリフトを拒否する検証。
- ✅ エイリアスの正規化。
- ✅ あいまいな近重複ノード用レビューキュー。
- ✅ レビュー判断テンプレートとマージ/分離維持ワークフロー。
- ✅ ファイル別グラフからのコーパストレンド要約。
永続化とレポート
- ✅ Graph JSON エクスポート。
- ✅ SQLite グラフストア。
- ✅ 任意の Kuzu グラフストア。
- ✅ 件数、証拠カバレッジ、孤立ノード、日付バケット、エイリアスの多いノードを含むグラフレポート。
- ✅ MegaMem、Graphiti/Zep、MCP graph servers、agentic RAG から吸収したアイデアを説明する競合レポート。
プロジェクトローカルワークフロー
- ✅
tesserae project init - ✅
tesserae project ingest - ✅
tesserae project compile - ✅
tesserae project mcp-config - ✅
tesserae project build-site - ✅
tesserae project serve - ✅
tesserae project deploy（新規 — GitHub Pages） - ✅
tesserae project sessions discover/import/list（明示的なローカル agent-history インポート） - ⚠
tesserae project watch（進行中） - ✅
tesserae project export-agent-harness - ✅
tesserae project export-obsidian - ✅
tesserae project export-graphiti - ✅
tesserae project sync-graphiti
Obsidian
- ✅ すぐ開ける vault エクスポート。
- ✅
.obsidian/app.jsonとグラフ設定。 - ✅ Markdown 投影。
- ✅
raw/assets/構造。 - ✅ Dataview クエリ付き
_meta/dashboard.md。
エージェントハーネス
生成対象ファイル:
- ✅ Claude Code:
CLAUDE.md,.claude/settings.json - ✅ Codex:
AGENTS.md,mcp.toml - ✅ Gemini:
GEMINI.md,.gemini/settings.json - ✅ Kiro: steering と MCP 設定
- ✅ Cursor: プロジェクトルールと MCP 設定
- ✅ OpenCode:
AGENTS.md,opencode.json
Graphiti / 時間的事実
- ✅ provenance、currentness、confidence、invalidation フィールドを持つ時間的事実投影。
- ✅ 依存なしの Graphiti episode JSONL エクスポート。
- ✅ Graphiti 未インストールでの
sync-graphiti --dry-runスモーク。 - ✅
graphiti_coreと Neo4j による任意のライブ同期。
Cognee
- ✅ Cognee JSONL バンドル（
nodes.jsonl,edges.jsonl,manifest.json）。 - ✅ 任意の add-only 直接インポート。
- ✅ 任意の Codex CLI/OAuth ベース Cognee cognify アダプター。
- ✅ API キーなしのスモーク/品質ワークフロー向け、決定的および Ollama embedding アダプターパス。
MCP サーバー
- ✅ stdio JSON-RPC 上の
tesserae_mcp/python3 -m tesserae.mcp_server。 - ✅ ツール:
schema,graph_summary,search_nodes,node_context,search_facts,timeline。 - ✅ マルチプロジェクトレジストリ。
テスト
現在のスイートの対象:
- ✅ ontology guardrails（新しい
Synthesisノード +synthesizes/summarizesエッジを含む）; - ✅ 決定的抽出;
- ✅ Claude CLI wrapper の解析/検証;
- ✅ 選択的 Claude ルーティング;
- ✅ 正規化/レビューワークフロー;
- ✅ バッチ ingest;
- ✅ レポート;
- ✅ SQLite/Kuzu 永続化;
- ✅ Cognee bundles/import patches;
- ✅ Graphiti export/sync dry-run;
- ✅ プロジェクト CLI ワークフロー;
- ✅ agent harness export;
- ✅ Obsidian export;
- ✅ フロントエンド生成 + リンク整合性（
nodes/codeclass-*.htmlなし）; - ✅ wiki store 冪等性;
- ✅ synthesis projector golden + 冪等性;
- ✅ サイトコンポーネント、ページ、エクスポート、関連性;
- ✅ AI 兄弟ファイル形状（ページごとに
.txt+.json）; - ✅ end-to-end compile-twice 冪等性;
- ✅ パッケージインストールとインストーラー契約。