Skip to content

Implement Commons transition fixture with synthetic provider and crash recovery - #50

Merged
ClaudiuSchuster merged 1 commit into
mainfrom
oss-oo/commons-transition-fixture-60f8-20260913
Sep 13, 2026
Merged

Implement Commons transition fixture with synthetic provider and crash recovery#50
ClaudiuSchuster merged 1 commit into
mainfrom
oss-oo/commons-transition-fixture-60f8-20260913

Conversation

@ClaudiuSchuster

Copy link
Copy Markdown
Member

Commons Transition Offline Fixture

Reiner Decision-Engine + private POSIX-Fixture mit synthetischem Cloudflare-Provider-Backend. Setzt den Commons Code Transition Plan um.

Dateien

Datei Beschreibung
scripts/commons_transition.py Pure decision engine – Prepare/Stage/Activate/Verify/Rollback. Kein I/O, Netzwerk, SQL, Worker-Code. Frozen OperationKey und FixtureDecision.
scripts/commons_fixture.py Private POSIX-Fixture mit synthetischem Provider-Backend. Separate atomare Control-Journal + Provider-State Dateien. Cooperative flock.
scripts/test-commons-transition.py 54 Tests (normal + -O): Decision-Purity, Full-Normal-Flow, Phase-Gating, Crash-Recovery an jeder Phasengrenze, Concurrent-Lock.
docs/release-commons-transition.md Architektur, State-Machine, Test-Matrix, Usage.

Checks

  • 54 Tests normal ✅ + -O
  • Alle existierenden Tests (commons-plan, static-transition) weiterhin grün ✅
  • Repository-Baseline (check-repository.sh) grün ✅
  • Site-Checks grün ✅

Was es nicht tut

Keine Provider-Mutation, kein deployment_authorized, keine Worker-/D1-/DNS-Schreibzugriffe. fixture_only: true immer.

…h recovery

- commons_transition.py: Pure decision engine for Prepare/Stage/Activate/
  Verify/Rollback lifecycle. No I/O, network, clock, SQL or Worker code.
  OperationKey and FixtureDecision frozen dataclasses. Classify pending
  effects as applied/not_applied_final/unknown/conflict.
- commons_fixture.py: Private POSIX fixture with synthetic Cloudflare
  provider backend. Separate atomically replaced control journal and
  provider state for deliberate crash-recovery testing. Cooperative
  flock with anchored identity checks.
- test-commons-transition.py: 54 tests (normal and -O) covering decision
  engine purity, full normal flow, phase-gated operations, generation
  increments, crash recovery at every phase boundary, concurrent lock
  rejection, secret preservation, and bounded input validation.
- docs/release-commons-transition.md: Architecture, state machine,
  test coverage, and usage documentation.
- CI and doc references updated in repository-checks.yml, CONTRIBUTING.md
  and docs/README.md.

All tests pass; repository baseline and site checks green. No production
mutation, no provider access, deployment_authorized always false.
@ClaudiuSchuster
ClaudiuSchuster merged commit b7a5312 into main Sep 13, 2026
5 checks passed
@ClaudiuSchuster
ClaudiuSchuster deleted the oss-oo/commons-transition-fixture-60f8-20260913 branch September 13, 2026 22:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant