DecisionGraph
Engineering Decision Memory System with CLI + API + MCP, plus a docs frontend in docs.
接入你的智能体
從發布者安裝。不是 PlugMCP 端點。
遠端 URL 還是本機指令? 兩種安裝方式的差異
來自發布者
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.
工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
這筆記錄未列出必要的環境變數。
DecisionGraph 透過 stdio 在本機執行。
上次檢查時間: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.