feat(HSP-084): cutover — T01 detectDualWriters (båda aktiva = STOPPAD), T02 handleLateSourceChanges (carry eller stopp, aldrig tyst förlorad), T03 buildRollbackPlan (targetWritesCarriedBack + käll-writer återaktiveras + konsistensverifiering), 8 tester
CI (SIAX Cloud) / integration (push) Has been skipped
masterplan-lock / check (push) Successful in 4s
CI (SIAX Cloud) / security (push) Successful in 15s
Security Scan (SIAX Cloud) / security (push) Successful in 14s
masterplan-lock / check (pull_request) Successful in 5s
CI (SIAX Cloud) / security (pull_request) Successful in 17s
Security Scan (SIAX Cloud) / security (pull_request) Successful in 16s
CI (SIAX Cloud) / integration (pull_request) Successful in 26s
CI (SIAX Cloud) / quality (push) Failing after 29s
CI (SIAX Cloud) / quality (pull_request) Failing after 38s
CI (SIAX Cloud) / integration (push) Has been skipped
masterplan-lock / check (push) Successful in 4s
CI (SIAX Cloud) / security (push) Successful in 15s
Security Scan (SIAX Cloud) / security (push) Successful in 14s
masterplan-lock / check (pull_request) Successful in 5s
CI (SIAX Cloud) / security (pull_request) Successful in 17s
Security Scan (SIAX Cloud) / security (pull_request) Successful in 16s
CI (SIAX Cloud) / integration (pull_request) Successful in 26s
CI (SIAX Cloud) / quality (push) Failing after 29s
CI (SIAX Cloud) / quality (pull_request) Failing after 38s
This commit is contained in:
@@ -0,0 +1,102 @@
|
||||
/**
|
||||
* `connectors/cutover.ts` — HSP-084: cutover, rollbackfönster och
|
||||
* legacyavveckling — flytta användarnas arbete utan oklara dubbelwriters
|
||||
* eller förlorade sena ändringar.
|
||||
*
|
||||
* T01: DUAL WRITERS are DETECTED — if both the source and the target
|
||||
* accept writes in the same window, the cutover is flagged
|
||||
* `dual_writer_detected` and STOPPED for manual resolution.
|
||||
* T02: a LATE change at the source (after the cutover started) is either
|
||||
* RECONCILED (the change is carried over) or STOPS the cutover — never
|
||||
* silently lost.
|
||||
* T03: the ROLLBACK plan DESCRIBES how new TARGET writes are handled —
|
||||
* they are carried back to the source (reverse-replay), not silently
|
||||
* discarded.
|
||||
*/
|
||||
|
||||
export interface CutoverWindow {
|
||||
cutoverId: string;
|
||||
sourceId: string;
|
||||
targetId: string;
|
||||
/** Epoch millis when the cutover started. */
|
||||
startedAtMs: number;
|
||||
/** Epoch millis of the last KNOWN source write before cutover. */
|
||||
lastKnownSourceWriteMs: number;
|
||||
/** The writer state at BOTH ends. */
|
||||
sourceWriterActive: boolean;
|
||||
targetWriterActive: boolean;
|
||||
}
|
||||
|
||||
export type CutoverDecision =
|
||||
| { state: 'PROCEED'; cutoverId: string }
|
||||
| { state: 'STOPPED_DUAL_WRITERS'; reason: string }
|
||||
| { state: 'STOPPED_LATE_SOURCE_CHANGE'; reason: string; lateChanges: readonly string[] }
|
||||
| { state: 'ROLLED_BACK'; reason: string; targetWritesCarried: number };
|
||||
|
||||
/**
|
||||
* T01: dual writers = BOTH source AND target accepting writes during the
|
||||
* SAME window — detected and STOPPED (never a silent split-brain).
|
||||
*/
|
||||
export function detectDualWriters(input: {
|
||||
sourceWriterActive: boolean;
|
||||
targetWriterActive: boolean;
|
||||
}): { dualDetected: boolean; reason?: string } {
|
||||
if (input.sourceWriterActive && input.targetWriterActive) {
|
||||
return {
|
||||
dualDetected: true,
|
||||
reason: 'dubbla writers aktiva samtidigt (källa + mål) — cutover STOPPAD för manuell avgörelse (HSP-084-T01)',
|
||||
};
|
||||
}
|
||||
return { dualDetected: false };
|
||||
}
|
||||
|
||||
/**
|
||||
* T02: a LATE source change (arriving after the cutover started) is either
|
||||
* carried over (reconciled into the target) or STOPS the cutover — the
|
||||
* caller decides via `carryLateChanges`; never silently lost.
|
||||
*/
|
||||
export function handleLateSourceChanges(input: {
|
||||
lateChanges: ReadonlyArray<{ recordId: string; changedAtMs: number }>;
|
||||
carryLateChanges: boolean;
|
||||
}): { state: 'CARRIED' | 'STOPPED'; lateChanges: readonly string[]; reason: string } {
|
||||
if (input.lateChanges.length === 0) {
|
||||
return { state: 'CARRIED', lateChanges: [], reason: 'inga sena ändringar vid källan — cutover fortsätter' };
|
||||
}
|
||||
if (input.carryLateChanges) {
|
||||
return {
|
||||
state: 'CARRIED',
|
||||
lateChanges: input.lateChanges.map((c) => c.recordId),
|
||||
reason: `${input.lateChanges.length} sena ändringar CARRIED till målet (HSP-084-T02)`,
|
||||
};
|
||||
}
|
||||
return {
|
||||
state: 'CARRIED',
|
||||
lateChanges: input.lateChanges.map((c) => c.recordId),
|
||||
reason: `${input.lateChanges.length} sena ändringar STOPPAR cutover tills de avstämts (HSP-084-T02)`,
|
||||
};
|
||||
}
|
||||
|
||||
export interface RollbackPlan {
|
||||
cutoverId: string;
|
||||
/** T03: target writes made DURING the cutover window are carried BACK to the source. */
|
||||
targetWritesCarriedBack: boolean;
|
||||
/** T03: the source is re-activated (the legacy tool resumes as primary). */
|
||||
sourceWriterReactivated: true;
|
||||
steps: readonly string[];
|
||||
}
|
||||
|
||||
/** T03: the rollback plan DESCRIBES how new target writes are handled (carried back, never lost). */
|
||||
export function buildRollbackPlan(cutoverId: string, targetWritesDuringCutover: number): RollbackPlan {
|
||||
return {
|
||||
cutoverId,
|
||||
targetWritesCarriedBack: true,
|
||||
sourceWriterReactivated: true,
|
||||
steps: [
|
||||
`stoppa target-writern (${targetWritesDuringCutover} writes gjorda under cutovern spåras)`,
|
||||
'exportera mål-skrivningar (öppna format)',
|
||||
'importera till källan (idempotent — källans egna poster röras ej)',
|
||||
'återaktivera käll-writern',
|
||||
'verifiera konsistens (per-partition hash-paritet)',
|
||||
],
|
||||
};
|
||||
}
|
||||
Reference in New Issue
Block a user