feat(versioning): capture and expose version history for charts, dashboards, and datasets#39603

Draft

mikebridge wants to merge 93 commits into

apache:masterfrom

mikebridge:sc-103156-versioning

Commits on Jun 16, 2026

refactor(db): composite PK on M2M association tables (sc-105349)

Mike Bridge
and
claude
committed
fix(migration): always run NULL-FK cleanup; correct RLS test parent name

Mike Bridge
and
claude
committed
docs(migration): address SQLAlchemy review follow-ups

Mike Bridge
and
claude
committed
refactor(migration): build pre-flight SQL via SQLAlchemy core (review)

Mike Bridge
and
claude
committed
fix(migration): drop FKs before recreate on MySQL (sc-105349)

Mike Bridge
and
claude
committed
fix(migration): MySQL downgrade FK + AUTO_INCREMENT (sc-105349)

Mike Bridge
and
claude
committed
fix(migration): explicit NOT NULL on FK columns for SQLite (sc-105349)

Mike Bridge
and
claude
committed
fix(migration): rebase down_revision onto 33d7e0e21daa (sc-105349)

Mike Bridge
and
claude
committed
docs(UPDATING): add Postgres-targeted maintenance-window queries (sc-105349)

Mike Bridge
and
claude
committed
docs(UPDATING): add MySQL-targeted maintenance-window queries (sc-105349)

Mike Bridge
and
claude
committed
build(docker): add MySQL compose override for dialect-swap evaluation

Mike Bridge
and
claude
committed
fix(docker): MySQL examples DB + EXAMPLES_PORT override (sc-105349)

Mike Bridge
and
claude
committed
build(scripts): add stress-test data generator for migration timing

Mike Bridge
and
claude
committed
feat(scripts): add --dirty-duplicates-pct to seed_junction_load.py

Mike Bridge
and
claude
committed
fix(migration): skip alter_column nullable=False on non-SQLite (sc-105349)

Mike Bridge
and
claude
committed
fix(migration): address aminghadersohi review feedback (sc-105349)

Mike Bridge
and
claude
committed
fix(migration): allowlist guard on _downgrade_mysql_table
Mike Bridge
committed
fix(versioning): re-point composite-PK migration at master's head

Mike Bridge
and
claude
committed
fix(versioning): capture FK list before dropping in composite-PK upgrade

Mike Bridge
and
claude
committed
chore(versioning): add sqlalchemy-continuum dependency

Mike Bridge
and
claude
committed
feat(versioning): Alembic migration for versioning tables

Mike Bridge
and
claude
committed
feat(versioning): UUIDMixin invariants + register entities as versioned

Mike Bridge
and
claude
committed
feat(versioning): diff engine and pure helpers

Mike Bridge
and
claude
committed
feat(versioning): Continuum class factory and baseline-capture listener

Mike Bridge
and
claude
committed
feat(versioning): change-record capture listener and action_kind plumbing

Mike Bridge
and
claude
committed
feat(versioning): app initialization, extensions, config, constants

Mike Bridge
and
claude
committed
feat(versioning): VersionDAO, ETag helper, and restore primitives

Mike Bridge
and
claude
committed
feat(versioning): restore-version commands for chart, dashboard, dataset

Mike Bridge
and
claude
committed
feat(versioning): REST /versions/ endpoints and action_kind stamping

Mike Bridge
and
claude
committed
feat(versioning): time-based retention via Celery beat

Mike Bridge
and
claude
committed
test(versioning): end-to-end integration tests

Mike Bridge
and
claude
committed
docs(versioning): UPDATING.md entry for entity version history

Mike Bridge
and
claude
committed
temp(versioning): demo version-history dropdowns + French i18n

Mike Bridge
and
claude
committed
fix(versioning): address review (B1/H1/M1/M2/N1)

Mike Bridge
and
claude
committed
fix(versioning): SERIALIZABLE isolation for retention prune (TOCTOU)

Mike Bridge
and
claude
committed
fix(versioning): stamp last_saved_* on chart restore audit fields

Mike Bridge
and
claude
committed
feat(versioning): partial index on shadow live-row lookup

Mike Bridge
and
claude
committed
refactor(versioning): extract /versions/ endpoint handlers

Mike Bridge
and
claude
committed
refactor(versioning): modernize typing imports (PEP 604 / PEP 585)

Mike Bridge
and
claude
committed
refactor(versioning): extract CONTINUUM_BOOKKEEPING_COLUMNS + baseline-shadow helper

Mike Bridge
and
claude
committed
docs(versioning): document _coerce_uuid escape hatch (amin M1)

Mike Bridge
and
claude
committed
refactor(versioning): split changes.py into a package

Mike Bridge
and
claude
committed
chore(versioning): v2 review easy fixes

Mike Bridge
and
claude
committed
perf(versioning): thread entity_id through set_version_etag_by_uuid

Mike Bridge
and
claude
committed
refactor(versioning): split baseline.py into a package

Mike Bridge
and
claude
committed
refactor(versioning): RestoreEndpointSpec Parameter Object

Mike Bridge
and
claude
committed
fix(versioning): match shadow text column types to live (MySQL)

Mike Bridge
and
claude
committed
fix(versioning): idempotent register_baseline_listener

Mike Bridge
and
claude
committed
chore(versioning): v3 review cleanup (W2, W3, W4)

Mike Bridge
and
claude
committed
chore(versioning): drop sc-103157 forward-reference comment

Mike Bridge
and
claude
committed
refactor(versioning): drop underscore-prefixed VersionDAO members (DDD T5)

Mike Bridge
and
claude
committed
refactor(versioning): name action_kind values as Published Language (DDD S1)

Mike Bridge
and
claude
committed
docs(versioning): rewrite ACTION_KINDS comment in plain prose

Mike Bridge
and
claude
committed
fix(versioning): chunk retention DELETE IN-clauses for SQLite limit

Mike Bridge
and
claude
committed
fix(versioning): tighten force_parent_dirty + audit-pin diagnostics

Mike Bridge
and
claude
committed
docs(versioning): document polymorphic FK on version_changes.entity_id

Mike Bridge
and
claude
committed
fix(versioning): bounded inline retry on SERIALIZABLE conflict (sqlalchemy W1)

Mike Bridge
and
claude
committed
refactor(versioning): drop underscore prefix on cross-module changes/ exports

Mike Bridge
and
claude
committed
refactor(versioning): drop underscore prefix on cross-module baseline/ exports

Mike Bridge
and
claude
committed
refactor(versioning): extract force_parent_dirty into named helpers

Mike Bridge
and
claude
committed
refactor(versioning): tighten model_cls type to type[Model]

Mike Bridge
and
claude
committed
docs(versioning): UPDATING.md notes on shadow-table joins + reset_ownership

Mike Bridge
and
claude
committed
chore(versioning): v4 cleanup — type[Model], naming honesty, ShadowTables, backoff factor

Mike Bridge
and
claude
committed
feat(versioning): ENABLE_VERSIONING_CAPTURE operational kill-switch

Mike Bridge
and
claude
committed
feat(versioning): retention task emits statsd counters

Mike Bridge
and
claude
committed
feat(versioning): warn at startup when retention beat entry is missing

Mike Bridge
and
claude
committed
test(versioning): round-trip migrations against populated shadow data

Mike Bridge
and
claude
committed
chore(versioning): v5 review cleanup (warn-log ordering, env-var, dead code)

Mike Bridge
and
claude
committed
test(versioning): unit tests for kill-switch + warn-log + retention metrics

Mike Bridge
and
claude
committed
fix(activity-view): warn instead of silently skipping unwired versioned models

Mike Bridge
and
claude
committed
fix(versioning): dedup VERSIONED_MODELS across repeated app inits

Mike Bridge
and
claude
committed
fix(versioning): MySQL-safe shadow-index downgrade

Mike Bridge
and
claude
committed
fix(versioning): missing-table fallbacks work on PostgreSQL

Mike Bridge
and
claude
committed
fix(versioning): stamp restore audit fields with naive local time

Mike Bridge
and
claude
committed
fix(versioning): never honour payload PKs in _override_columns

Mike Bridge
and
claude
committed
fix(versioning): attribute dataset PUT response to the user's transaction

Mike Bridge
and
claude
committed
perf(activity-view): index child shadow tables by (table_id, transaction_id)

Mike Bridge
and
claude
committed
fix(versioning): kill-switch actually stops Continuum shadow writes

Mike Bridge
and
claude
committed
fix(versioning): wire response schemas into the /versions/ endpoints

Mike Bridge
and
claude
committed
docs(versioning): strip forward references to the activity-view module

Mike Bridge
and
claude
committed
chore(versioning): trim dead DDL from the versioning-tables migration

Mike Bridge
and
claude
committed
test(versioning): make params-filter change-record test idempotent

Mike Bridge
and
claude
committed
fix(versioning): exclude machine-written fields from the activity stream

Mike Bridge
and
claude
committed
fix(versioning): dataset save with refresh is one transaction

Mike Bridge
and
claude
committed
feat(versioning): restore transactions record their target version

Mike Bridge
and
claude
committed
fix(versioning): restore never applies the snapshot's uuid to the live row

Mike Bridge
and
claude
committed
test(versioning): parse issued_at as ISO-8601 in version-list ordering test

Mike Bridge
and
claude
committed
revert(versioning): dataset save back to per-command transactions

Mike Bridge
and
claude
committed
fix(versioning): review hardening for the __meta__ headline convention

Mike Bridge
and
claude
committed
refactor(versioning): extract retention cleanup job to sc-111099

Mike Bridge
and
claude
committed
fix(versioning): re-point migration chain onto current master head

Mike Bridge
and
claude
committed
fix(versioning): satisfy mypy/ruff after master rebase (pre-commit)

Mike Bridge
and
claude
committed
fix(versioning): robust user_id capture + correct denies-non-owner tests

Mike Bridge
and
claude
committed