開発者向け

構造化出力としての地図作成。

DSLドキュメントを決定論的に生成・編集し、PNGまたはSVGにレンダリング。HTTP、MCP、またはCLI経由で、パイプラインやエージェントに統合可能。

example · MCP

> validate_gesta_map(doc)
  { "valid": true, "errors": [] }

> render_gesta_map(doc, format="svg")
  { "image_base64": "PD94…",
    "mime": "image/svg+xml" }

3つのインターフェース、1つのエンジン。

HTTP API

RESTエンドポイント

POST /api/generate      → DSL + PNG/SVG
POST /api/edit          → typed ops
POST /api/apply-ops     → deterministic patch
POST /api/rerender      → re-render
POST /api/render-svg    → SVG, id-tagged layers
POST /api/geocode       → names → coordinates

MCP

エージェント向けツール

render_gesta_map(doc, format, dpi)
validate_gesta_map(doc)  → {valid, errors}
extract_draft_from_prose(prose)
how_to(feature)          → self-explain
engine_version()

CLI

コマンドライン

$ gesta validate  map.gesta.yaml
$ gesta render    map.gesta.yaml -o out.svg
$ gesta geocode   map.gesta.yaml --apply
$ gesta resolve   map.gesta.yaml
$ gesta-serve     # HTTP   ·   gesta-mcp

決定論的編集

ドキュメント上の10個の型付き操作。

編集はASTへの操作であり再生成ではない—回帰なし、手動編集も保持。

create_layermodify_layerdelete_layeradd_memberremove_membermodify_arrowmodify_annotationchange_viewapply_classset_disambiguation

決定論的: 同じドキュメント → 同じ地図、ピクセル単位で一致。オンラインジオコーディングはスナップショット化。
検証済み: すべてのドキュメントはV1フォーマットのJSON Schemaに対して検証。
出力: PNG、SVG（レイヤーごとに<g>）、PDF、JPG。SVGは下流で編集可能。
統一されたエンジン: API、MCP、CLIはすべて同じレンダリングパイプラインの薄いラッパー。

その他の入口

Iコーダーでない方へ→III言語→