Skip to content

DeciShift v0.3.0 — Composable Decision Flows

Choose a tag to compare

@github-actions github-actions released this 24 Sep 14:33

DeciShift v0.3.0 adds Composable Decision Flows while preserving the existing DecisionPipeline API and v0.1/v0.2 behavior.

Added

  • DecisionNode, DecisionFlow, and FlowTrace for deterministic row-aligned DAG decision systems.
  • Branching, merging, multiple models/policy stages, and categorical/multi-action final decisions.
  • Deterministic DAG validation and canonical SHA-256 topology fingerprints without NetworkX.
  • Graph-aware cache reuse and descendant invalidation metrics.
  • Structural impact analysis separated from observed action changes and causal claims.
  • Multi-action transition summaries, matrices, action distributions, and Decision Contracts.
  • Numeric flow-attribution targets: candidate_action_support and change_from_baseline.
  • Exact and adaptive approximate node/group attribution with sampling uncertainty.
  • Flow interaction analysis including interaction-only categorical transitions.
  • mode: flow YAML support and decishift graph text/Mermaid inspection.
  • DecisionFlow evidence schema 2.0 with backward-compatible evidence loading/verification.
  • Synthetic equipment-maintenance triage example and CPU benchmark harness.

Attribution correction

  • Separates Shapley efficiency from Monte Carlo precision/convergence semantics.
  • Adds adaptive permutation sampling with minimum/maximum permutations, batches, CI-width targets, confidence level, and deterministic seeds.
  • Preserves fixed-permutation mode and existing public APIs.

Compatibility and scientific scope

  • Existing v0.1/v0.2 public APIs, binary reports, contracts, evidence, and CLI behavior remain supported.
  • Categorical actions are never numerically subtracted or silently ordinal-encoded.
  • Structural reachability is not causal impact.
  • Software-counterfactual attribution does not establish real-world causality.
  • Topology-changing node/group hybrid attribution remains unsupported rather than fabricated.

Install

pip install --upgrade decishift==0.3.0
decishift demo