src/dazzle_back/runtime/spec_versioning.py

Generated: 2026-03-30T04:38:48.329735+00:00

Commit: 615f1354a103

Language: python

Scope: dazzle_back

Purpose

Spec Versioning and Change Tracking.

Stores AppSpec snapshots on each server start, computes structured diffs between versions for the Founder Console changes timeline.

Tables: spec_versions (in ops_database)

Key Exports

• FieldChange
• AppSpecDiff
• SpecVersion
• SpecVersionStore
• to_dict
• save_version
• list_versions
• count_versions
• get_diff
• get_snapshot

Dependencies

Imports

• __future__.annotations
• hashlib
• json
• logging
• dataclasses.dataclass
• dataclasses.field
• datetime.UTC
• datetime.datetime
• typing.Any
• uuid.uuid4

Event Interactions

None detected.

Invariants and Assumptions

No invariants documented.

Tests

• tests/integration/test_runtime_e2e.py
• tests/integration/test_runtime_pipeline.py
• tests/unit/test_runtime_test_routes.py
• tests/unit/test_runtime_services.py
• tests/unit/test_runtime_mcp_tools.py

Notes

This page was automatically generated by tools/gen_reference_docs.py.