State Attribution & Local Triage
A local-first runtime incident attribution research platform.
SALT focuses on answering one question:
Why did this runtime state happen?
Instead of only collecting telemetry or detecting failures, SALT reconstructs the causal path that produced a runtime state, allowing developers to understand why an incident occurred and which actions or components contributed to it.
Modern software systems generate enormous amounts of runtime telemetry.
Logs tell us what happened.
Metrics tell us how often it happened.
Profilers tell us where time or memory was spent.
SALT complements these tools by focusing on:
- Runtime attribution
- Local replay
- Counterfactual validation
- Auditability
- Deterministic evidence chains
The long-term goal is a local-first attribution platform that supports multiple runtime environments.
Current research directions include:
- JVM Runtime Attribution
- Garbage Collection Attribution
- Runtime Replay
- Counterfactual Validation
- Audit Bundles
Future directions:
- Thread Attribution
- Executor Attribution
- Netty Runtime Attribution
- Spring Runtime Attribution
- Distributed Runtime Attribution
engine/
plugins/
benchmarks/
experiments/
artifacts/
docs/
scripts/
Current status:
Research Prototype
Validated branch:
- SALT-GC
Latest validated milestone:
SALT-GC V0.4c Final Local
Completed:
- Exact public fix reconstruction
- Bit-for-bit artifact verification
- Independent clean reruns
- Counterfactual validation
Status:
STRICT PASS
Current validated scope:
- Local-first runtime attribution
- Runtime replay
- Counterfactual validation
- Audit bundle generation
SALT is currently a research platform.
Current results should not be interpreted as evidence that SALT:
- replaces existing profilers
- supports arbitrary software projects
- is production-ready
Further validation on larger real-world systems is still ongoing.
SALT is licensed under the Mozilla Public License 2.0 (MPL-2.0).
You may use SALT in commercial and proprietary systems. Modifications to MPL-licensed files must remain available under the MPL-2.0 when distributed.
See LICENSE for the full license text.
Current roadmap includes:
- JVM Attribution
- Runtime Plugins
- Additional Runtime Targets
- Distributed Incident Attribution
- General Attribution Framework
GitHub Issues are welcome.