doubled-graph 1.0.2

MCP facade over CodeGraphContext + grace-marketplace: impact, context, drift-detect for LLM-driven codebases.

doubled-graph

MCP-сервер для LLM-агентов, работающих с большими кодовыми базами.

Проблема: агент правит код не зная, кто вызывает функцию и какой у неё контракт — получаем регрессии и тихий дрейф. doubled-graph даёт агенту два графа одновременно:

• Computed graph — AST-граф реального кода (через CodeGraphContext): кто вызывает что, где определено.
• Declared graph — граф из артефактов (docs/*.xml): замысел, контракты, верификация.

Четыре MCP-инструмента:

Инструмент	Когда
analyze	построить/обновить граф
impact	радиус влияния изменений — до правки
context	360° вид: символ + контракт + вызовы
detect_changes	дрейф кода от артефактов — до коммита

---

Установка

Требования: Python 3.11+, Bun/NPN (для grace-cli).

pip install doubled-graph

---

Первые шаги

1. Онбординг репозитория

cd your-project
doubled-graph setup

Одна команда:

• установит @osovv/grace-cli через bun add -g
• скопирует prompts/ и methodology/ в репозиторий
• зарегистрирует MCP-сервер в вашей IDE (Claude Code / Cursor / Continue)
• установит git post-commit хук для автообновления графа
• запустит первый полный analyze

Посмотреть план без реальных изменений:

doubled-graph setup --dry-run

Явно указать IDE:

doubled-graph setup --ide claude-code

2. Подключить MCP вручную (если нужно)

.mcp.json в корне репозитория:

{
  "mcpServers": {
    "doubled-graph": {
      "command": "doubled-graph",
      "args": ["serve"]
    }
  }
}

3. Инициализация

Введите в ваш ИИ первый промт. Остальные промты он сам подгрузит.

Сценарий 1. Новый проект - prompts/new-project/00-entry-prompt.md.

Сценарий 2. Миграция существующего - prompts/migrate-existing-project/00-entry-prompt.md.

---

Другие команды

# Обновить граф вручную
doubled-graph analyze --mode auto

# 360° контекст символа
doubled-graph context validateUser

# Текущая фаза методологии (migration | post_migration)
doubled-graph phase get
doubled-graph phase set post_migration --reason "migration complete"

---

Документация

• SPEC.md — архитектура, хранилище .doubled-graph/
• TOOLS.md — подробные схемы инструментов
• HOOKS.md — git и Claude Code хуки
• CHANGELOG.md — история изменений

---

Лицензия

MIT. Upstream-компоненты (CodeGraphContext, grace-marketplace) — MIT.