DecisionGraph Core
DecisionGraph CoreReleases

Version history and constitutional deltas. No hype—just the structural changes that affect determinism, immutability, and replay.

v0.4.1 — DEPENDENCY_ON_DEPRECATED + --strict flag
Release date: 2026-03-01Packages: @decisiongraph/core, @decisiongraph/cliType: Minor

What changed

v0.4.1 completes the two-tier violation model defined in Constitution Section 6. All four packages are now published on npm.

Added

  • DEPENDENCY_ON_DEPRECATED — WARN severity when a depends_on target is Deprecated. Signals that migration is needed before the target is superseded.
  • CLI --strict flag — treat WARN as ERROR. Useful for pre-release CI gates.
  • @decisiongraph/cli@0.1.0 — initial npm publish.

Violation severity model

  • DEPENDENCY_ON_SUPERSEDED → ERROR — CI fails. Dependency is already invalid.
  • DEPENDENCY_ON_DEPRECATED → WARN — CI passes. Dependency is still valid but should be migrated.
  • --strict — promotes all WARNs to ERROR.
v0.3.1 — Multi-graph kernel + traverse CLI
Release date: 2026-02-28Package: @decisiongraph/coreType: Breaking

What changed

v0.3.1 introduces GraphStore as the top-level container, enabling cross-graph edge validation and deterministic replay across multiple decision graphs. The traverse CLI command provides violation tree display with dependency chain visualization.

Constitutional additions

  • GraphStore introduced as top-level container. GraphStore = one world; commitId = shared time coordinate.
  • graphId is required on all Graphs and log files.
  • All IDs (NodeId, EdgeId, CommitId) are now GraphStore-wide unique. Graph-local uniqueness is intentionally not supported in v0.x.
  • Cross-graph edges are supported and validated. EDGE_NOT_RESOLVED is raised for unresolvable references.
  • DEPENDENCY_ON_SUPERSEDED enforced (Constitution Section 6).
  • Circular dependency detection across graph boundaries (DFS).

New kernel operations

  • lintStore — store-wide cross-graph validation.
  • resolveNode / resolveEdge — locate any Node or Edge across all Graphs.
  • traceDependencyPath — chain traversal for violation display.

CLI

  • decisiongraph traverse <directory> — replays all decision logs into GraphStore and renders violations as dependency trees.

Breaking changes

If you are migrating from v0.2:

  • Add graphId to every log file and Graph.
  • Update "version" from "0.2" to "0.3" in all log files.
  • Audit all Node IDs, Edge IDs, commitIds for GraphStore-wide uniqueness.
  • Update applyBatch, lint, replay calls to accept GraphStore and GraphId.
v0.2.0 — Constitutional tightening
Release date: 2026-02-24Package: @decisiongraph/coreType: Breaking

What changed

v0.2 formalizes and enforces constitutional invariants. This release moves DecisionGraph Core from a conceptual prototype to a structurally enforceable kernel boundary.

Breaking changes

  • Edge IDs are required.
  • Edge status is required.
  • Author is required on all nodes and edges.
  • Replace remove_edge with supersede_edge.
  • Unified status vocabulary and state model clarified.
  • Commit immutability enforcement hardened.
Older releases will be added as the version history stabilizes.