v3.17.0 — KARM Contract Surface

v3.17.0 — KARM Contract Surface

Closes the KARM-readiness gap: CognitiveSnapshot was real and cursor-aware but incomplete for the KARM handover loop — Laws, Policies, uncertainty, and failures were absent from the view; no Provider/Sink trait boundary existed; no unified TransitionView or PredictionError read model.

What's new

Change	Details
Snapshot completeness	CognitiveSnapshot extended with 4 #[serde(default)] fields: laws: Vec<LawSummary>, policies: Vec<PolicySummary>, failures: Vec<FailureSummary>, uncertainty: UncertaintySummary; backward-safe (old JSON parses with defaults)
Provider/Sink trait boundary	CognitiveStateProvider + CognitiveStateSink traits in cognitive_contracts.rs; CognitiveHandle<B> implements both; KARM reads/writes only through these traits — never locks MemoryStore directly
TransitionView + PredictionError	TransitionView (from open_intents, non-Open only) + PredictionError (from CalibrationTracker::snapshot().prediction_error_ewma) in transition_view.rs; CognitiveHandle::transitions_since() + prediction_error()
REST surfaces	GET /snapshot/:actor/transitions?since=<tx> + GET /snapshot/:actor/prediction_error

Test coverage

379 lib + 555 unit (+9) + 190 integration (+4 SIT) + 59 property + 258 Python = all green, 0 failures

Channel state

Channel	Version
GitHub (this release)	3.17.0
PyPI (pip install hipcortex)	3.17.0
VSIX (upload manually)	3.17.0 (hipcortex-memory-3.17.0.vsix)
Open VSX (upload manually)	3.17.0