DecisionGraph CoreQuickstart

Validate decisions in CI (minimal setup)

This page intentionally stays minimal. Copy, run, and confirm the kernel is real.

1) Install

npm i @decisiongraph/core @decisiongraph/cli

2) Create a decision log

Create decisions/example.decisionlog.json.

{
  "version": "0.3",
  "graphId": "G:example",
  "ops": [
    {
      "type": "add_node",
      "node": {
        "id": "ADR-001",
        "kind": "Decision",
        "status": "Active",
        "createdAt": "2026-01-01T00:00:00Z",
        "author": "team",
        "payload": {
          "statement": "Use PostgreSQL for primary data storage"
        }
      }
    },
    {
      "type": "commit",
      "commitId": "C-1",
      "createdAt": "2026-01-01T00:00:01Z",
      "author": "team"
    }
  ]
}

3) Validate (local / CI)

Run traverse to replay all decision logs and detect violations.

npx decisiongraph traverse ./decisions

# .github/workflows/decisions.yml
name: DecisionGraph Validation

on: [push, pull_request]

jobs:
  validate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 20
      - run: npm ci
      - run: npx decisiongraph traverse ./decisions

Guarantees

Validation results are deterministic.
Replay is first-class.
After commit, graphs are append-only (changes via supersession).
Cross-graph dependencies are validated across the entire GraphStore.