15.5 KB · updated 2026-05-19 · md

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 パーサー)MD0architecture.md § モジュールマップ
WikiLayerProjector — wiki レイヤーノードごとに 1 つの md ページMD0architecture.md § パイプライン
sources/ ページwiki_projector.pyfrontend-redesign.md § Sources
concepts/ ページwiki_projector.pyfrontend-redesign.md § Concepts
entities/ ページwiki_projector.pyfrontend-redesign.md § Entities
papers/ ページwiki_projector.pyfrontend-redesign.md § Papers
repos/ ページwiki_projector.pyfrontend-redesign.md § Repos
topics/ ページwiki_projector.pyfrontend-redesign.md § Topics
questions/ ページ(未解決の質問)wiki_projector.pyfrontend-redesign.md § Questions
syntheses/ ページMD0frontend-redesign.md § Syntheses

合成の種類 (L2 → 派生)

SynthesisProjector は 7 つの決定的テンプレートを生成し、Synthesis ノードと synthesizes / summarizes エッジをグラフへ戻します。

種類状態ソース注記
pulse(グローバルに 1 つ、/ を駆動)synthesis.pycompile のたびに再構築されます。
daily_digestsynthesis.pydata/research/daily/<date>/ ごとに 1 つ。
weeklysynthesis.pydata/research/weekly/<iso-week>/ ごとに 1 つ。
topicsynthesis.py3 本以上の papers を含む ResearchTopic / ApproachFamily クラスターごとに 1 つ。
comparisonsynthesis.py同じタスクで競合する ApproachFamily のペアごとに 1 つ。
field_overviewsynthesis.pyResearchField ごとに 1 つ。
LLM 強化サマリー(環境フラグ)hook のみヒューリスティックなベースラインは出荷済み。TESSERAE_SYNTHESIS_LLM=1 hook は stub として残されています。

静的サイトルート

ルート状態ソース注記
/(ホーム、hero pulse)MD0 render_home統計行 + キュレーション済み入口 + 最近の活動。
/sources/, /sources/<slug>.htmlpages.py::render_sources_index, render_source_detail
/concepts/, /concepts/<slug>.htmlpages.py::render_concepts_index, render_concept_detail
/entities/, /entities/<slug>.htmlpages.py::render_entities_index, render_entity_detail
/papers/, /papers/<slug>.htmlpages.py::render_papers_index, render_paper_detail
/repos/, /repos/<slug>.htmlpages.py::render_repos_index, render_repo_detail
/topics/, /topics/<slug>.htmlpages.py::render_topics_index, render_topic_detail
/syntheses/, /syntheses/<slug>.htmlpages.py::render_syntheses_index, render_synthesis_detail
/questions/, /questions/<slug>.htmlpages.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.py3d-force-graph + Three.js、ホバーツールチップ、エッジラベル、カーソル基準ズーム。
/about.htmlpages.py::render_aboutスキーマ、ビルド情報。

AI フレンドリーなエクスポート

アーティファクト状態ソース目的
ページごとの <page>.txt 兄弟ファイルMD0 write_siblings1 ページのプレーンテキスト表示(ナビゲーション、スタイルなし)。
ページごとの <page>.json 兄弟ファイルexports.py::write_siblings{title, kind, body, body_text, links, source_path, frontmatter}
llms.txtexports.py::render_llms_txtllmstxt.org の短いインデックス。
llms-full.txtexports.py::render_llms_full_txt全ページ本文、5 MB 上限。
graph.jsonldexports.py::render_graph_jsonldschema.org Dataset、wiki レイヤーノードのみ。
graph.json__init__.py::write_site完全なグラフペイロード(ツール用コードノードを含む)。
search-index.jsonMD0パレット + ページ検索。wiki レイヤー種別のみ。
sitemap.xmlexports.py::render_sitemap_xml出力された全ルート、lastmod は frontmatter 由来。
rss.xmlexports.py::render_rss_xml最新 30 件の syntheses。
robots.txtexports.py::render_robots_txt許可的 — クロール + インデックス。
ai-readme.mdexports.py::render_ai_readme機械可読サイトマップ。
manifest.json__init__.py::_manifest出力された各ファイルの sha256 + サイズ(冪等性ハーネス)。

ビジュアルデザイン + UX

機能状態ソース注記
デザイントークン(ライト + ダークテーマ、テラコッタのアクセント)MD0assets/style.css の単一 CSS バンドル。
テーマ切替(永続化、ちらつきなし)MD0localStorage 内の data-theme="dark"、描画前に適用。
検索パレット(cmd+k / ctrl+k / /js.pysearch-index.json に対するファジーマッチ。最近ページリスト。
右側固定 TOCpages.py + tokens.pyデスクトップのみ。モバイルは <details> によるドロワー。
月 + 曜日ラベル付き活動ヒートマップcomponents.py::heatmap_svg26 週 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.py3d-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 + MD1wiki/ + graph.json を読み、site/ を書き出す。
project serve ローカル HTTPcli.py素の stdlib サーバー。
project deploy → GitHub PagesMD0gh-pages への worktree push。gh CLI 経由の任意 --enable-pages--build, --dry-run, --branch, --remote, --force
project sessions discover/import/listMD0 + cli.pyClaude Code/Codex 用のインバウンドセッション履歴。発見は明示的で、プロジェクト作業ディレクトリにスコープされる。
project watch 変更時再ビルドMD0Subagent 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 冪等性;
  • ✅ パッケージインストールとインストーラー契約。