DecisionGraph
Engineering Decision Memory System with CLI + API + MCP, plus a docs frontend in docs.
Potencialize seu agente
Instalação do publicador. Não é um endpoint do PlugMCP.
Host a copy with our keys and logs.
Ainda não há uma versão empacotada no registro. Siga o README do repositório.
URL remota ou um comando na sua máquina? Como as duas instalações diferem
Rodar no PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
AbrirDo publicador
Engineering Decision Memory System with CLI + API + MCP, plus a docs frontend in docs.
DecisionGraph is an engineering decision memory system that captures evidence from GitHub/Slack/Jira, answers “why” questions, and runs pre-change guardrails via CLI/API/MCP.
Software teams usually remember what changed, but lose why it changed. DecisionGraph keeps that reasoning traceable with evidence so teams can move fast without repeating old mistakes.
why / who / when / what-changed queries quickly.q, tag, component, owner, decision_type).warn/critical escalation tracking, audit log, and optional connector notification (webhook|slack|discord|teams).off|warn|strict) for required decision fields.python -m pip install -e ".[dev]"
decisiongraph init --reset
decisiongraph seed-demo
decisiongraph serve --host 127.0.0.1 --port 8000 --seed-demo
Quickstart demo:

Health check:
curl http://127.0.0.1:8000/health
Open API docs:
http://127.0.0.1:8000/docscp .env.example .env
docker compose up --build -d
Check health:
curl http://127.0.0.1:8000/health
Tail logs / stop:
docker compose logs -f decisiongraph
docker compose down
Production note:
DECISIONGRAPH_ENV=production, set DECISIONGRAPH_API_TOKEN in .env (or set DECISIONGRAPH_REQUIRE_TOKEN_IN_PRODUCTION=false intentionally).If you only want terminal usage, skip decisiongraph serve.
python -m pip install -e ".[dev]"
decisiongraph init --reset
decisiongraph seed-demo
decisiongraph chat
Windows Command Prompt (cmd):
py -m pip install -e ".[dev]"
decisiongraph init --reset
decisiongraph seed-demo
decisiongraph chat
Inside chat, ask questions directly or use commands:
/help
/list 20
/find <query>
/supersede <new_id> <old_id>
/merge <primary_id> <duplicate_id>
/timeline 20
/quality
/get <decision_id>
/guard <change request>
/contradictions
/stale
/watch
/audit 20
/metrics
/graph
/report json
/exit
Non-interactive CLI equivalents:
decisiongraph list
decisiongraph list --q "rabbitmq" --tag queues
decisiongraph find "rabbitmq" --tag queues
decisiongraph list --owner finance --decision-type risk-policy
decisiongraph query "Why did we cap payment retries at 2?"
decisiongraph supersede <new_decision_id> <old_decision_id>
decisiongraph merge <primary_decision_id> <duplicate_decision_id> --note "dedupe"
decisiongraph timeline --component payment-retry --exclude-superseded
decisiongraph evidence-quality --weak-threshold 0.5
decisiongraph quality --weak-threshold 0.5
decisiongraph watch-assumptions --notify --notify-target slack
decisiongraph watch
decisiongraph audit-log --limit 100 --event assumption.watch_run
decisiongraph audit --limit 100 --event assumption.watch_run
decisiongraph guardrail "Increase retry attempts in payment flow"
If decisiongraph command is not available in PATH:
python -m decisiongraph list
python -m decisiongraph query "Why did we cap payment retries at 2?"
cd docs
npm install
npm run dev
decisiongraph mcp
Create env file:
cp .env.example .env
Windows PowerShell:
Copy-Item .env.example .env
Windows Command Prompt (cmd):
copy .env.example .env
Key variables:
DECISIONGRAPH_ENV=developmentDECISIONGRAPH_DATA_PATH=data/decisiongraph.jsonDECISIONGRAPH_API_TOKEN optional API key (x-api-key header)DECISIONGRAPH_REQUIRE_TOKEN_IN_PRODUCTION=true blocks startup in production without tokenDECISIONGRAPH_AUTO_SEED_DEMO=false auto seed demo data at decisiongraph serve startupDECISIONGRAPH_GOVERNANCE_MODE=off governance policy mode (off|warn|strict)DECISIONGRAPH_GOVERNANCE_REQUIRED_FIELDS=owners,assumptions,risks required fields when governance is enabledDECISIONGRAPH_RATE_LIMIT_PER_MINUTE=240 per-client rate limit (0 disables)DECISIONGRAPH_AUDIT_LOG_RETENTION=5000 max retained audit eventsDECISIONGRAPH_CORS_ORIGINS=http://localhost:3000,http://127.0.0.1:5173DECISIONGRAPH_GITHUB_TOKEN for GitHub ingestionDECISIONGRAPH_GITHUB_BASE_URL=https://api.github.comDECISIONGRAPH_ALERT_WEBHOOK_URL default watcher webhookDECISIONGRAPH_ALERT_SLACK_WEBHOOK, DECISIONGRAPH_ALERT_DISCORD_WEBHOOK, DECISIONGRAPH_ALERT_TEAMS_WEBHOOK connector-specific watcher webhooksSE_URL legacy fallback (prefer DECISIONGRAPH_GITHUB_BASE_URL)GROQ_API_KEY, GROQ_MODELS optional model integrationSecurity note:
.env..env.example.decisiongraph init --reset
decisiongraph seed-demo
decisiongraph serve --host 127.0.0.1 --port 8000
curl -X POST http://127.0.0.1:8000/api/query \
-H "content-type: application/json" \
-d '{"question":"Why did we cap payment retries at 2?"}'
curl -X POST http://127.0.0.1:8000/api/guardrail \
-H "content-type: application/json" \
-d '{"change_request":"Increase retry attempts in payment flow"}'
curl http://127.0.0.1:8000/api/assumptions/stale
curl "http://127.0.0.1:8000/api/decisions?limit=10&q=rabbitmq&tag=queues"
curl "http://127.0.0.1:8000/api/decisions?owner=finance&decision_type=risk-policy"
curl -X POST http://127.0.0.1:8000/api/decisions/supersede \
-H "content-type: application/json" \
-d '{"decision_id":"<new_decision_id>","superseded_decision_id":"<old_decision_id>"}'
curl -X POST http://127.0.0.1:8000/api/decisions/merge \
-H "content-type: application/json" \
-d '{"primary_decision_id":"<primary_id>","duplicate_decision_id":"<duplicate_id>","note":"same rationale"}'
curl -X POST http://127.0.0.1:8000/api/assumptions/watch \
-H "content-type: application/json" \
-d '{"warn_severities":["medium","high"],"critical_severities":["high"],"notify":true,"notify_target":"slack"}'
GET /GET /healthGET /api/report/summary?format=json|markdownGET /api/decisions (supports limit, q, tag, component, owner, decision_type)GET /api/decisions/timelineGET /api/decisions/evidence-qualityGET /api/decisions/{decision_id}POST /api/decisions/supersedePOST /api/decisions/mergePOST /api/queryPOST /api/guardrailGET /api/contradictionsGET /api/assumptions/stalePOST /api/assumptions/watchGET /api/audit/logsGET /api/metricsPOST /api/metricsGET /api/graphPOST /api/ingestPOST /api/ingest/directoryPOST /api/ingest/gitPOST /api/ingest/jsonlPOST /api/ingest/githubPOST /api/ingest/slack-exportPOST /api/ingest/jira-jsonGET /api/scenarios/runGET /api/kpi/snapshotPOST /api/eval/datasetPOST /api/eval/benchmark-checkPOST /api/research/scorecardGET /api/research/interview-scriptPOST /api/research/design-partner-progressGET /api/strategy/sectionsGET /api/strategy/section/{section_id}GET /api/strategy/search?q=...GET /api/ops/doctorGET /api/ops/runbookGET /api/ops/release-checkGET /api/ops/security-auditGET /api/schema/infodecisiongraph init [--reset]decisiongraph seed-demodecisiongraph chat [--list-limit 20] [--guardrail-limit 3]decisiongraph list --limit 20 [--q ...] [--tag ...] [--component ...] [--owner ...] [--decision-type ...]decisiongraph find <query> [--limit ...] [--tag ...] [--component ...] [--owner ...] [--decision-type ...] (alias of search/list)decisiongraph get <decision_id>decisiongraph supersede <decision_id> <superseded_decision_id>decisiongraph merge <primary_decision_id> <duplicate_decision_id> [--note ...]decisiongraph timeline [--limit 200] [--component ...] [--tag ...] [--owner ...] [--decision-type ...] [--exclude-superseded]decisiongraph evidence-quality [--limit 200] [--weak-threshold 0.45]decisiongraph quality [--limit 200] [--weak-threshold 0.45] (alias)decisiongraph query "..."decisiongraph guardrail "..."decisiongraph contradictionsdecisiongraph stale-assumptionsdecisiongraph watch-assumptions [--warn medium,high] [--critical high] [--notify --notify-target slack --webhook-url ...]decisiongraph watch [--warn medium,high] [--critical high] [--notify --notify-target ...] (alias)decisiongraph audit-log [--limit 100] [--event ...]decisiongraph audit [--limit 100] [--event ...] (alias)decisiongraph metric-set --key ... --value ... [--unit ...]decisiongraph metricsdecisiongraph graphdecisiongraph report --format markdown|json [--output ...]decisiongraph serve [--host 127.0.0.1] [--port 8000] [--seed-demo|--no-seed-demo]decisiongraph mcpdecisiongraph ingest --source <file> --source-id <id> [--source-type note]decisiongraph ingest-text --source-id <id> --text "..." [--source-type note]decisiongraph ingest-dir --directory <dir> [--pattern "*.md"]decisiongraph ingest-git --repo <repo_path> [--max-commits 200] [--ref HEAD]decisiongraph ingest-jsonl --source <file.jsonl> [--source-type external]decisiongraph ingest-github --owner <org> --repo <name> [--state all]decisiongraph ingest-slack-export --export-dir <dir> [--max-messages 1000]decisiongraph ingest-jira-json --source <jira.json>decisiongraph scenariosdecisiongraph kpidecisiongraph eval-dataset --dataset <eval.jsonl>decisiongraph benchmark-check --dataset <eval.jsonl> [--min-top1 0.7] [--min-keyword-coverage 0.7]decisiongraph research-score --pain-frequency ... --impact ...decisiongraph research-scriptdecisiongraph design-partner-progressdecisiongraph strategy-list | strategy-show <section> | strategy-search "..."decisiongraph doctor | runbook | release-check | security-audit | schema-infoRun stdio server:
decisiongraph mcp
Tool groups:
src/decisiongraph/
api.py FastAPI app assembly
service.py Core orchestration logic
store.py JSON store with locking + atomic writes
integrations.py Connectors (git, GitHub, Slack, Jira, JSONL)
mcp_server.py MCP server bootstrap
cli.py Typer CLI entrypoint
api_routes/ API routers
cli_commands/ CLI command groups
mcp_toolsets/ MCP tool groups
tests/ Backend test suite
tools/ CI benchmark datasets and helper artifacts
docs/ Frontend docs app (Vite + React)
assets/ README visual assets
Local quality commands:
python -m pytest -q
decisiongraph benchmark-check --dataset tools/ci_eval.jsonl --seed-demo --min-top1 0.65 --min-keyword-coverage 0.65
cd docs && npm run lint && npm run build
Latest local validation (2026-04-25):
59 passed)tools/ci_eval.jsonl): passCI pipeline:
.github/workflows/ci.ymltools/ci_eval.jsonlRelease notes:
DecisionGraph là hệ thống lưu trí nhớ quyết định kỹ thuật để trả lời nhanh câu hỏi "vì sao code đang như vậy". Bạn có thể ingest từ Git/GitHub/Slack/Jira/JSONL, query theo ngữ nghĩa, chạy guardrail trước refactor, và expose cùng logic qua CLI + API + MCP.
DecisionGraph is an engineering decision memory system that captures evidence from GitHub/Slack/Jira, answers “why” questions, and runs pre-change guardrails via CLI/API/MCP.
Ferramentas
Ainda não há lista de ferramentas. Servidores remotos recebem uma após a primeira verificação de saúde.
Perguntas frequentes
Copie nesta página a configuração stdio para Cursor, Claude Desktop, Claude Code ou VS Code. Ela usa a instalação do publicador, não um proxy do PlugMCP.
Este registro não lista nenhuma variável de ambiente obrigatória.
DecisionGraph roda localmente via stdio.
Última verificação: 2026-10-27. DecisionGraph is an engineering decision memory system that captures evidence from GitHub/Slack/Jira, answers “why” questions, and runs pre-change guardrails via CLI/API/MCP.