ZAIXOS Engineering Platform — Rollback Plan
Document type: Extraction Planning Specification
Version: 1.0 · Phase: 12-4
Status: Permanent execution authority
Purpose
Define complete rollback strategy for every extraction phase — restore points, procedures, and decision authority.
Rollback timeline (when available)
Pre-12-5: Rollback = no-op (nothing extracted)
12-5: Rollback = delete platform repo (no consumer impact)
12-6: Rollback = abandon platform branch; Dental Clinic unchanged
12-7: Rollback = remove composer require + .zaixos/; restore embedded
12-8: Rollback = revert to 12-7 dual-run or full embedded
12-9: Rollback = revert platform.lock + restore embedded copies (12 months)
Post-GA: Rollback = platform.lock downgrade per VERSION_TRANSITION_PLANRollback principles
| ID | Principle |
|---|---|
| RB-01 | Dental Clinic production release branches never roll back without Architect approval |
| RB-02 | Embedded baseline SHA (PRE-2) is always restorable until 12-9 deletion |
| RB-03 | Platform repo rollback does not require product rollback if consumer not yet cut over |
| RB-04 | Consumer rollback must restore green embedded tests before merge |
| RB-05 | Git operations by Developer only |
Restore points
| ID | Name | Contents | Created |
|---|---|---|---|
| RP-0 | Pre-extraction baseline | Dental Clinic SHA + adapter checksum | Before 12-5 |
| RP-1 | Post-scaffold | Empty platform repo tag | 12-5 end |
| RP-2 | Post-extraction rc | Platform 1.0.0-rc.final | 12-6 end |
| RP-3 | Dual-run start | Product branch with composer + embedded | 12-7 start |
| RP-4 | Pre-GA consumer | Lock @ rc; embedded present | Before 12-9 |
| RP-5 | GA | Platform 1.0.0 + consumer lock | 12-9 |
Document each RP in phase Format B reports.
Rollback procedures by phase
RB-12-5 — Scaffold rollback
| Step | Action |
|---|---|
| 1 | Delete or archive empty zaixos-engineering-platform repository |
| 2 | No Dental Clinic changes required |
| 3 | Re-plan if structure wrong |
Impact: None on product.
RB-12-6 — Extraction rollback
| Step | Action |
|---|---|
| 1 | Stop platform repo extraction branch |
| 2 | Dental Clinic repo unchanged (extraction is copy-out) |
| 3 | Fix wave failure; restart wave from last green checkpoint |
| 4 | If unrecoverable: abandon platform branch; return to RP-0 planning |
Impact: None on product until 12-7.
RB-12-7 — Consumer integration rollback
| Step | Action |
|---|---|
| 1 | Revert product branch commits adding composer.json require |
| 2 | Remove .zaixos/ directory |
| 3 | Restore .cursor/ from RP-0 if materialization altered it |
| 4 | Remove vendor entry; restore composer.lock |
| 5 | Run PRE-1 validation suite — must pass |
| 6 | Architect documents rollback in Format B |
Impact: Return to embedded ERP authoritative mode.
RB-12-8 — Validation phase rollback
| Step | Action |
|---|---|
| 1 | If parity fail: pin consumer to previous rc OR rollback to RB-12-7 |
| 2 | Do not proceed to 12-9 |
| 3 | Fix platform rc; re-run PV-1–PV-8 |
RB-12-9 — GA rollback (within 12 months)
| Step | Action |
|---|---|
| 1 | Restore embedded copies from RP-0 tag archive (if not deleted) OR git history |
| 2 | Revert platform.lock removal of embedded |
| 3 | Pin platform package to last known good PATCH |
| 4 | Rematerialize adapter |
| 5 | Full PRE-1 + CO-4 validation |
| 6 | Architect + Platform Architect joint decision |
Note: After embedded deletion, rollback requires git history restore — mandatory tag RP-0 before 12-9 deletion.
Rollback decision matrix
| Symptom | Rollback to | Authority |
|---|---|---|
| Wave checksum fail | Same wave restart | Platform Developer |
| Platform CI broken 12-6 | RB-12-6 | Platform Architect |
| Consumer CI broken 12-7 | RB-12-7 | Product Architect |
| Parity fail 12-8 | RB-12-7 or fix rc | Platform Architect |
| KPI-1 miss | Fix docs; no rollback unless blocking | Architect |
| Contract text drift detected | Stop all; RP-0 investigation | Platform Architect |
Data preserved during rollback
| Data | Preserved in |
|---|---|
| Dental Clinic baseline | Git tag at RP-0 |
| Platform extraction work | Platform repo branches (even if abandoned) |
| Planning docs | docs/platform/planning/ (both repos after sync) |
| Phase reports | Product + platform release docs |
Rollback verification
After any rollback procedure:
- [ ] PRE-1 tests green in Dental Clinic
- [ ] No partial
.zaixos/state without lock - [ ] Architect Format B rollback report filed
- [ ] Restore point ID documented
Rollback Plan v1.0 — Phase 12-4.