DeciShift v0.3.0 — Composable Decision Flows
DeciShift v0.3.0 adds Composable Decision Flows while preserving the existing DecisionPipeline API and v0.1/v0.2 behavior.
Added
DecisionNode,DecisionFlow, andFlowTracefor 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_supportandchange_from_baseline. - Exact and adaptive approximate node/group attribution with sampling uncertainty.
- Flow interaction analysis including interaction-only categorical transitions.
mode: flowYAML support anddecishift graphtext/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