v1.4.0 — SnapshotStore V2 (Scalable Replay)

Highlights

SnapshotStore V2 — deterministic snapshot-assisted replay that reduces compile_cognitive_head() time by 43–95% depending on snapshot coverage. After the first snapshot, only new events are replayed, not the entire ledger.

Architecture

• ReplayEngine abstraction owns all replay strategy (full, delta, fast path)
• SnapshotManager lifecycle: load, validate, save, refresh, delete
• ReplayReport telemetry: replay mode, event counts, snapshot status
• EventCountPolicy: configurable threshold (default: 100 new events)
• ADR-026 accepted; replay subsystem contracts frozen

Performance

Events	Snapshot %	Full (ms)	Delta (ms)	Improvement
1,000	50%	1.61	0.84	48.1%
5,000	50%	8.57	4.85	43.4%
10,000	50%	22.12	8.94	59.6%
5,000	90%	9.05	1.07	88.1%
5,000	99%	8.56	0.37	95.7%
10,000	99%	17.53	0.84	95.2%

Verification

• 1,870 tests pass (55 snapshot + 44 replay equivalence + 1,771 existing)
• PostgreSQL CI: full test suite validates backend parity
• Replay equivalence CI: required status check on every PR
• Backend parity CI: snapshot tests on both SQLite and PostgreSQL
• Nightly benchmarks: daily performance tracking

Compatibility

• No public API breaking changes
• Existing projects require no migration beyond applying database schema version 0003
• Snapshot is purely additive — full replay remains available as fallback

Upgrade Notes

Apply migration 0003_snapshots.sql to enable snapshot storage. No code changes required — the compiler automatically uses snapshot-assisted replay when snapshots are available.

v1.3.1 — Stability & Robustness

Fixed

• Memory extraction failures now emit a warning to stderr instead of failing silently, while preserving successful event append semantics.
• Eliminated a latent circular import risk in the memory lifecycle subsystem.
• Improved \MarkdownMemoryProvider\ thread safety for concurrent writes within a single process.
• Clarified documentation for reserved relation event types intended for future persistence.

Quality

• No public API changes.
• No behavioral changes to event sourcing, retrieval, or projections.
• Full regression suite passing (1771 tests).

RationaleVault v1.3.0 — Intelligent Retrieval & Observability

Highlights

• Unified retrieval orchestration via RetrievalOrchestrator with 9 retrieval profiles
• Provider capability APIs (search_records, get_by_ids, count) with SQL-optimized implementations
• Provider-backed candidate generation replacing full-corpus scans
• Batched citation lookups for memory and knowledge
• Retrieval telemetry subsystem with CLI and MCP dashboards
• MCP boundary cleanup through shared organization service
• Expanded test coverage (1771 passing) and benchmark stabilization
• Dead code removal and repository cleanup

v1.2.1

Added

• BaseProjection Alignment: All 9 projection classes now inherit from BaseProjection with declared ClassVar metadata (projection_kind, build_version, dependencies). Projections: SessionProjection, ContinuationProjection, KnowledgeProjection, GraphProjection, CrossProjectProjection, OrganizationProjection, OrganizationGraphProjection, OrganizationActivityProjection, OrganizationContinuationProjection.
• Epistemic Status: Added epistemic_status attribute to KnowledgeObject with full serialization/deserialization support. States: PROPOSED, VALIDATED, INVARIANT, CONFLICTED, TOMBSTONED.
• Canonical Event Registration: Added GOVERNANCE_DECISION_RECORDED, SKILL_EXECUTED, KNOWLEDGE_PROMOTION_CANDIDATE, KNOWLEDGE_PROMOTION_ASSESSED, KNOWLEDGE_PROMOTION_GATED, KNOWLEDGE_PROMOTION_APPROVED, KNOWLEDGE_PROMOTION_REJECTED to EventType enum.
• Governance Structures: Added GovernanceDomain, GovernanceAction enums and GovernanceRecord frozen dataclass with to_dict/from_dict support.
• EventRecord Schema Version: Added schema_version: int = 1 field to EventRecord dataclass, resolving a defect where SchemaPolicy and ReplayResolver referenced event.schema_version on a type that lacked it.

Changed

• Version bumped from 1.2.0 to 1.2.1 in pyproject.toml and __init__.py.
• OrganizationActivityState and OrganizationGraphState now have from_dict() class methods for full serialization roundtrip support.

Fixed

• Fixed mocked data type mismatch in tests/unit/organization/test_graph_projection.py.

RationaleVault v1.2.0

RationaleVault v1.2.0

Highlights

• SchemaPolicy Architecture — Policy-driven schema evolution with per-event-type migration authority
• Governance-Driven Replay — Schema changes driven by GovernanceState projections
• Multi-Version Production — Two independent production migrations validated
  • TASK_CREATED v1→v2: Flat title/description to nested details structure
  • DECISION_PROPOSED v1→v2: Enrichment with context and category fields
• 2022 Passing Tests — Comprehensive test suite with integration proofs and architectural guards
• Frozen APIs — 9 replay and policy APIs formally frozen

What's New

• SchemaPolicy: Immutable value object answering schema questions per-event-type
• SchemaPolicyFactory: Compiles policy from GovernanceState
• ReplayResolver: Pure policy executor with zero schema knowledge
• UpcasterRegistry: Pure data structure mapping event types to upcaster callables
• ReplayContext: Pure dataclass carrying max_sequence and schema_policy
• 15 integration proofs across F15 and F16
• AST-based architectural guards enforcing T14/T15 invariants

Frozen APIs

• SchemaPolicy, EventSchema, MigrationPath, MigrationStep
• SchemaPolicyFactory
• ReplayResolver
• ReplayPipeline
• ReplayContext, InterpretiveContext
• ReplayRequest
• GovernanceProjection, GovernanceState

Known Limitations

• compile_at_sequence() historical governance not yet production-complete (planned F17)
• Replay Auditor designed but not yet active (planned F18)
• Only two production event migrations currently exist
• COUNTERFACTUAL replay mode reserved and not implemented

Roadmap

• F17: Governance History (compile_at_sequence())
• F18: Replay Auditor (multi-version audit)
• F19: Governance Tooling (visualization, dashboards)

Full Changelog: v1.1.0...v1.2.0

v1.1.0

Full Changelog: v1.0.1...v1.1.0