specforge-mcp 0.1.0

package/dist/engine/migration/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engine/migration/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,gDAAgD;AAEhD,OAAO,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AACpF,OAAO,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAC1F,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC9F,YAAY;AACZ,OAAO,EACL,uBAAuB,EACvB,0BAA0B,EAC1B,qBAAqB,EACrB,kCAAkC,GACnC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,0BAA0B,GAC3B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/engine/migration/migration-tracker.d.ts

@@ -0,0 +1,11 @@
+import type { MigrationPlan, MigrationStatusReport, ActiveFeatureFlag } from '../../types/index.js';
+export declare function buildMigrationStatusReport(params: {
+    projectId: string;
+    plan: MigrationPlan;
+    completedComponentIds: string[];
+    inProgressComponentIds: string[];
+    blockedComponentIds: string[];
+    activeFlags: ActiveFeatureFlag[];
+    completedSpecIds?: Record<string, string>;
+}): MigrationStatusReport;
+//# sourceMappingURL=migration-tracker.d.ts.map

package/dist/engine/migration/migration-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-tracker.d.ts","sourceRoot":"","sources":["../../../src/engine/migration/migration-tracker.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,aAAa,EACb,qBAAqB,EAGrB,iBAAiB,EAElB,MAAM,sBAAsB,CAAC;AA8F9B,wBAAgB,0BAA0B,CAAC,MAAM,EAAE;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,aAAa,CAAC;IACpB,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,sBAAsB,EAAE,MAAM,EAAE,CAAC;IACjC,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,WAAW,EAAE,iBAAiB,EAAE,CAAC;IACjC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3C,GAAG,qBAAqB,CA+DxB"}

package/dist/engine/migration/migration-tracker.js

@@ -0,0 +1,108 @@
+// engine/migration/migration-tracker.ts — Migration status and tracking (SPEC-028b)
+// Builds status reports for ongoing migrations
+// --- Status calculation ---
+function calculateCompletionDate(totalComponents, completedComponents, estimatedTotalHours) {
+    if (totalComponents === 0) {
+        return new Date().toISOString();
+    }
+    const remainingFraction = 1 - completedComponents / totalComponents;
+    const remainingHours = estimatedTotalHours * remainingFraction;
+    const remainingMs = remainingHours * 60 * 60 * 1000;
+    return new Date(Date.now() + remainingMs).toISOString();
+}
+function classifyComponentStatus(componentId, completedIds, inProgressIds, blockedIds) {
+    if (completedIds.includes(componentId)) {
+        return 'completed';
+    }
+    if (inProgressIds.includes(componentId)) {
+        return 'in-progress';
+    }
+    if (blockedIds.includes(componentId)) {
+        return 'blocked';
+    }
+    return 'pending';
+}
+// --- Risk detection ---
+function detectActiveRisks(params) {
+    const risks = [];
+    const { plan, completedComponentIds, activeFlags } = params;
+    // Circular dependencies still unresolved
+    if (plan.circularDependencies.length > 0) {
+        risks.push({
+            id: 'circular-deps',
+            description: `${plan.circularDependencies.length} circular dependency cycle(s) detected — resolve before migrating affected components`,
+            severity: 'high',
+            mitigationStatus: 'open',
+        });
+    }
+    // High risk factor
+    if (plan.riskFactor > 1.8) {
+        risks.push({
+            id: 'high-risk-factor',
+            description: `Risk factor is ${plan.riskFactor.toFixed(2)} (>1.8) — consider adding tests before proceeding`,
+            severity: 'high',
+            mitigationStatus: 'open',
+        });
+    }
+    // Late-stage flags (tech debt)
+    const techDebtFlags = activeFlags.filter((f) => f.isTechDebt);
+    if (techDebtFlags.length > 0) {
+        risks.push({
+            id: 'flag-tech-debt',
+            description: `${techDebtFlags.length} feature flag(s) active for >90 days — remove after migration completes`,
+            severity: 'medium',
+            mitigationStatus: 'open',
+        });
+    }
+    // Stalled migration (no components completed)
+    if (completedComponentIds.length === 0 && plan.specs.length > 0) {
+        risks.push({
+            id: 'no-progress',
+            description: 'Migration started but no components have been completed — review blockers',
+            severity: 'medium',
+            mitigationStatus: 'open',
+        });
+    }
+    return risks;
+}
+// --- Public API ---
+export function buildMigrationStatusReport(params) {
+    const { projectId, plan, completedComponentIds, inProgressComponentIds, blockedComponentIds, activeFlags, completedSpecIds, } = params;
+    const allComponentIds = plan.specs.map((s) => s.specId);
+    const totalComponents = allComponentIds.length;
+    const components = allComponentIds.map((id) => {
+        const spec = plan.specs.find((s) => s.specId === id);
+        const status = classifyComponentStatus(id, completedComponentIds, inProgressComponentIds, blockedComponentIds);
+        return {
+            id,
+            name: spec?.title ?? id,
+            status,
+            specId: completedSpecIds?.[id],
+            completedAt: status === 'completed' ? new Date().toISOString() : undefined,
+        };
+    });
+    const completedCount = components.filter((c) => c.status === 'completed').length;
+    const inProgressCount = components.filter((c) => c.status === 'in-progress').length;
+    const pendingCount = components.filter((c) => c.status === 'pending').length;
+    const percentComplete = totalComponents > 0 ? Math.round((completedCount / totalComponents) * 100) : 0;
+    const activeRisks = detectActiveRisks({
+        plan,
+        completedComponentIds,
+        activeFlags,
+    });
+    const estimatedCompletionDate = calculateCompletionDate(totalComponents, completedCount, plan.adjustedHours);
+    return {
+        projectId,
+        percentComplete,
+        totalComponents,
+        completedComponents: completedCount,
+        inProgressComponents: inProgressCount,
+        pendingComponents: pendingCount,
+        components,
+        activeRisks,
+        activeFlags,
+        estimatedCompletionDate,
+        generatedAt: new Date().toISOString(),
+    };
+}
+//# sourceMappingURL=migration-tracker.js.map

package/dist/engine/migration/migration-tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-tracker.js","sourceRoot":"","sources":["../../../src/engine/migration/migration-tracker.ts"],"names":[],"mappings":"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"}

package/dist/engine/migration/parity-validator.d.ts

@@ -0,0 +1,7 @@
+import type { ParityValidationResult } from '../../types/index.js';
+export declare function generateParityValidation(params: {
+    component: string;
+    endpoints: string[];
+    observedDifferences?: string[];
+}): ParityValidationResult;
+//# sourceMappingURL=parity-validator.d.ts.map

package/dist/engine/migration/parity-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parity-validator.d.ts","sourceRoot":"","sources":["../../../src/engine/migration/parity-validator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,sBAAsB,EAAiC,MAAM,sBAAsB,CAAC;AA0FlG,wBAAgB,wBAAwB,CAAC,MAAM,EAAE;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;CAChC,GAAG,sBAAsB,CAezB"}

package/dist/engine/migration/parity-validator.js

@@ -0,0 +1,91 @@
+// engine/migration/parity-validator.ts — Functional parity validation (SPEC-028a)
+// Generates parity checklists and contract tests for migrated components
+// --- Checklist generation ---
+function buildParityChecklist(component) {
+    return [
+        {
+            category: 'endpoints',
+            description: `All endpoints exposed by ${component} are present in the new implementation`,
+            status: 'pending',
+        },
+        {
+            category: 'request-schema',
+            description: `Request body/params schema is identical (field names, types, required/optional)`,
+            status: 'pending',
+        },
+        {
+            category: 'response-schema',
+            description: `Response body schema is identical (field names, types, nested structures)`,
+            status: 'pending',
+        },
+        {
+            category: 'error-codes',
+            description: `HTTP status codes and error message formats match the origin`,
+            status: 'pending',
+        },
+        {
+            category: 'side-effects',
+            description: `Database writes, events emitted, and external calls match origin behavior`,
+            status: 'pending',
+        },
+    ];
+}
+// --- Contract test generation ---
+function buildContractTests(component, endpoints) {
+    return endpoints.map((endpoint) => {
+        const method = endpoint.startsWith('GET') ? 'GET' : 'POST';
+        const path = endpoint.replace(/^(GET|POST|PUT|DELETE|PATCH)\s+/, '');
+        return {
+            endpoint: path,
+            method,
+            sampleInput: {
+                description: `Sample input for ${component} ${endpoint}`,
+                placeholder: 'Replace with actual request body/params from origin',
+            },
+            expectedOutputPattern: {
+                description: `Expected response shape from ${component} ${endpoint}`,
+                placeholder: 'Replace with actual response schema from origin',
+            },
+            tolerances: [
+                'Timestamp fields may differ by up to 1 second',
+                'UUID/ID fields may differ — compare by reference not by value',
+            ],
+        };
+    });
+}
+// --- Difference classification ---
+function classifyDifferences(differences) {
+    const regressions = [];
+    const intentionalChanges = [];
+    for (const diff of differences) {
+        const lower = diff.toLowerCase();
+        if (lower.includes('missing') ||
+            lower.includes('broken') ||
+            lower.includes('error') ||
+            lower.includes('fail') ||
+            lower.includes('wrong') ||
+            lower.includes('regression')) {
+            regressions.push(diff);
+        }
+        else {
+            intentionalChanges.push(diff);
+        }
+    }
+    return { regressions, intentionalChanges };
+}
+// --- Public API ---
+export function generateParityValidation(params) {
+    const { component, endpoints, observedDifferences = [] } = params;
+    const checklist = buildParityChecklist(component);
+    const contractTests = buildContractTests(component, endpoints);
+    const { regressions, intentionalChanges } = classifyDifferences(observedDifferences);
+    return {
+        component,
+        checklist,
+        contractTests,
+        regressions,
+        intentionalChanges,
+        validatedAt: new Date().toISOString(),
+    };
+}
+//# sourceMappingURL=parity-validator.js.map

package/dist/engine/migration/parity-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parity-validator.js","sourceRoot":"","sources":["../../../src/engine/migration/parity-validator.ts"],"names":[],"mappings":"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"}

package/dist/engine/migration/plan-generator.d.ts

@@ -0,0 +1,8 @@
+import type { MigrationPlan, MigratableComponent } from '../../types/index.js';
+export declare function generateMigrationPlan(params: {
+    sourceStack: string;
+    targetStack: string;
+    components: MigratableComponent[];
+    hasTests: boolean;
+}): MigrationPlan;
+//# sourceMappingURL=plan-generator.d.ts.map

package/dist/engine/migration/plan-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-generator.d.ts","sourceRoot":"","sources":["../../../src/engine/migration/plan-generator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,aAAa,EAIb,mBAAmB,EAGpB,MAAM,sBAAsB,CAAC;AAmJ9B,wBAAgB,qBAAqB,CAAC,MAAM,EAAE;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,mBAAmB,EAAE,CAAC;IAClC,QAAQ,EAAE,OAAO,CAAC;CACnB,GAAG,aAAa,CAwChB"}

package/dist/engine/migration/plan-generator.js

@@ -0,0 +1,159 @@
+// engine/migration/plan-generator.ts — Migration plan generation (SPEC-028a)
+// Builds ordered migration specs and detects circular dependencies
+// --- Topological sort + cycle detection ---
+function topologicalSort(components) {
+    const idMap = new Map(components.map((c) => [c.id, c]));
+    const visited = new Set();
+    const inStack = new Set();
+    const order = [];
+    const cycles = [];
+    function dfs(id, path) {
+        if (inStack.has(id)) {
+            const cycleStart = path.indexOf(id);
+            const cycle = path.slice(cycleStart);
+            cycle.push(id);
+            /* v8 ignore start */
+            const first = cycle[0] ?? id;
+            const secondToLast = cycle[cycle.length - 2] ?? id;
+            /* v8 ignore stop */
+            cycles.push({
+                cycle,
+                breakStrategy: `Extract interface/contract between ${first} and ${secondToLast} to break the cycle during migration`,
+            });
+            return;
+        }
+        if (visited.has(id)) {
+            return;
+        }
+        visited.add(id);
+        inStack.add(id);
+        path.push(id);
+        const comp = idMap.get(id);
+        if (comp) {
+            for (const dep of comp.dependsOn) {
+                dfs(dep, [...path]);
+            }
+        }
+        inStack.delete(id);
+        order.push(id);
+    }
+    for (const comp of components) {
+        if (!visited.has(comp.id)) {
+            dfs(comp.id, []);
+        }
+    }
+    return { order, cycles };
+}
+// --- Phase building ---
+function buildPhases(components, sortedOrder) {
+    const idMap = new Map(components.map((c) => [c.id, c]));
+    // Phase 1: no dependencies (utils, models, helpers)
+    const phase1 = sortedOrder
+        .map((id) => idMap.get(id))
+        .filter((c) => c !== undefined)
+        .filter((c) => c.dependsOn.length === 0)
+        .map((c) => c.id);
+    // Phase 2: business logic (depends only on phase 1)
+    /* v8 ignore start */
+    const phase2 = sortedOrder
+        .map((id) => idMap.get(id))
+        .filter((c) => c !== undefined &&
+        c.dependsOn.length > 0 &&
+        c.dependsOn.every((dep) => phase1.includes(dep)) &&
+        (c.type === 'service' || c.type === 'module'))
+        .map((c) => c.id);
+    /* v8 ignore stop */
+    // Phase 3: entry points and remaining
+    const phase3 = sortedOrder.filter((id) => !phase1.includes(id) && !phase2.includes(id));
+    const phases = [];
+    if (phase1.length > 0) {
+        phases.push({
+            order: 1,
+            name: 'Foundation — utils, models, helpers',
+            description: 'Components with no dependencies — safest to migrate first',
+            components: phase1,
+        });
+    }
+    if (phase2.length > 0) {
+        phases.push({
+            order: 2,
+            name: 'Business Logic — services, modules',
+            description: 'Core business logic components that depend on foundation layer',
+            components: phase2,
+        });
+    }
+    if (phase3.length > 0) {
+        phases.push({
+            order: 3,
+            name: 'Entry Points — handlers, API, CLI',
+            description: 'External-facing components migrated last',
+            components: phase3,
+        });
+    }
+    return phases;
+}
+// --- Risk factor calculation ---
+function calculateRiskFactor(components, hasTests) {
+    let factor = 1.0;
+    if (!hasTests) {
+        factor += 0.5;
+    }
+    const hotCount = components.filter((c) => c.temperature === 'hot').length;
+    factor += hotCount * 0.15;
+    const warmCount = components.filter((c) => c.temperature === 'warm').length;
+    factor += warmCount * 0.05;
+    return Math.min(factor, 2.5);
+}
+function estimateHours(comp) {
+    const base = Math.ceil(comp.linesOfCode / 50);
+    const complexityMult = comp.temperature === 'hot' ? 3 : comp.temperature === 'warm' ? 2 : 1;
+    return Math.max(1, base * complexityMult);
+}
+function mapComponentRisk(comp) {
+    if (comp.temperature === 'hot') {
+        return 'high';
+    }
+    if (comp.temperature === 'warm') {
+        return 'medium';
+    }
+    return 'low';
+}
+// --- Public API ---
+export function generateMigrationPlan(params) {
+    const { sourceStack, targetStack, components, hasTests } = params;
+    const { order, cycles } = topologicalSort(components);
+    const phases = buildPhases(components, order);
+    const idMap = new Map(components.map((c) => [c.id, c]));
+    const specs = order
+        .map((id) => idMap.get(id))
+        .filter((c) => c !== undefined)
+        .map((c, idx) => ({
+        specId: `migration-${c.id}`,
+        title: `Migrate: ${c.name}`,
+        sourceComponent: c.path,
+        targetStack,
+        applicableEquivalences: [],
+        parityChecklist: [
+            `All public functions/methods of ${c.name} behave identically`,
+            `Same error types and messages`,
+            `Same side effects (DB writes, events, external calls)`,
+        ],
+        estimatedHours: estimateHours(c),
+        risk: mapComponentRisk(c),
+        order: idx + 1,
+    }));
+    const totalEstimatedHours = specs.reduce((sum, s) => sum + s.estimatedHours, 0);
+    const riskFactor = calculateRiskFactor(components, hasTests);
+    return {
+        sourceStack,
+        targetStack,
+        phases,
+        specs,
+        circularDependencies: cycles,
+        totalEstimatedHours,
+        riskFactor,
+        adjustedHours: Math.ceil(totalEstimatedHours * riskFactor),
+        generatedAt: new Date().toISOString(),
+    };
+}
+//# sourceMappingURL=plan-generator.js.map

package/dist/engine/migration/plan-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-generator.js","sourceRoot":"","sources":["../../../src/engine/migration/plan-generator.ts"],"names":[],"mappings":"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"}

package/dist/engine/migration/rollback-planner.d.ts

@@ -0,0 +1,18 @@
+import type { MigrationPlan, MigratableComponent, RollbackPlan, MigrationCheckpoint, RollbackExecutionPlan } from '../../types/index.js';
+export declare function generateRollbackPlan(params: {
+    plan: MigrationPlan;
+    components: MigratableComponent[];
+    sortedOrder: string[];
+}): RollbackPlan;
+export declare function createMigrationCheckpoint(params: {
+    projectId: string;
+    label: string;
+    completedComponents: string[];
+    dbSchemaVersion?: string;
+    serviceConfig?: Record<string, string>;
+}): MigrationCheckpoint;
+export declare function buildRollbackExecutionPlan(params: {
+    targetCheckpointId: string;
+    rollbackPlan: RollbackPlan;
+}): RollbackExecutionPlan;
+//# sourceMappingURL=rollback-planner.d.ts.map

package/dist/engine/migration/rollback-planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rollback-planner.d.ts","sourceRoot":"","sources":["../../../src/engine/migration/rollback-planner.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,aAAa,EACb,mBAAmB,EACnB,YAAY,EAKZ,mBAAmB,EACnB,qBAAqB,EAGtB,MAAM,sBAAsB,CAAC;AA6K9B,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAC3C,IAAI,EAAE,aAAa,CAAC;IACpB,UAAU,EAAE,mBAAmB,EAAE,CAAC;IAClC,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB,GAAG,YAAY,CAsBf;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC,GAAG,mBAAmB,CAYtB;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE;IACjD,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,YAAY,CAAC;CAC5B,GAAG,qBAAqB,CA6BxB"}

package/dist/engine/migration/rollback-planner.js

@@ -0,0 +1,185 @@
+// engine/migration/rollback-planner.ts — Rollback planning engine (SPEC-028b)
+// Generates rollback plans, checkpoints, and dependency-aware rollback order
+// --- Reversibility classification ---
+function classifyReversibility(comp, isDbOperation) {
+    if (isDbOperation) {
+        // DB schema changes that delete columns/tables are irreversible in practice
+        return comp.temperature === 'hot' ? 'irreversible' : 'partially-reversible';
+    }
+    if (comp.temperature === 'hot') {
+        return 'partially-reversible';
+    }
+    return 'reversible';
+}
+function buildIrreversibilityReason(comp, isDbOp) {
+    if (isDbOp && comp.temperature === 'hot') {
+        return 'Destructive schema change (column/table deletion) on a hot component — restoring from backup required if data was written to the new schema';
+    }
+    if (isDbOp) {
+        return 'Schema migration may have received writes — point-in-time restore needed for full rollback';
+    }
+    return undefined;
+}
+// --- Checkpoint generation ---
+function buildCheckpoints(plan) {
+    const checkpoints = [];
+    for (const phase of plan.phases) {
+        checkpoints.push({
+            checkpointId: `cp-before-phase-${phase.order}`,
+            phase: phase.name,
+            description: `Snapshot before starting ${phase.name} — safe rollback point before any phase-${phase.order} changes`,
+            automatedBefore: true,
+            conditions: [
+                `All phase-${phase.order - 1} components validated`,
+                'DB backup confirmed',
+                'Service health checks green',
+            ],
+        });
+    }
+    // Point of no return: after last phase first component with destructive DB change
+    checkpoints.push({
+        checkpointId: 'cp-point-of-no-return',
+        phase: 'Final cutover',
+        description: 'Last safe rollback point before decommissioning source system and deleting old schema',
+        automatedBefore: true,
+        conditions: [
+            'New system at 100% traffic for minimum 24h',
+            'All parity checks passed',
+            'Monitoring shows no regressions',
+        ],
+    });
+    return checkpoints;
+}
+// --- Inverse DB migrations ---
+function buildInverseDbMigrations(components) {
+    return components
+        .filter((c) => c.type === 'layer' ||
+        c.name.toLowerCase().includes('db') ||
+        c.name.toLowerCase().includes('schema'))
+        .map((c) => ({
+        originalMigration: `migrate-${c.id}.sql`,
+        inverseScript: `-- Inverse of migrate-${c.id}.sql\n-- Restore previous schema state\n-- NOTE: Verify data integrity before executing\nALTER TABLE ... RENAME COLUMN ... ; -- placeholder: fill in from actual migration`,
+        dataRestoreStrategy: `Restore from backup taken at checkpoint before ${c.name} migration`,
+        practicalityNote: c.temperature === 'hot'
+            ? `WARNING: High volume of writes expected on ${c.name} — rollback window shortens rapidly after migration starts`
+            : undefined,
+    }));
+}
+// --- Component rollback order (reverse topological) ---
+function buildComponentRollbacks(components, sortedOrder) {
+    // Rollback order is reverse of migration order
+    const reverseOrder = [...sortedOrder].reverse();
+    return reverseOrder.map((id, idx) => {
+        const comp = components.find((c) => c.id === id);
+        const name = comp?.name ?? id;
+        const dependents = comp?.dependents ?? [];
+        return {
+            component: name,
+            dependents,
+            rollbackOrder: idx + 1,
+            rollbackSteps: [
+                `Verify ${dependents.length > 0 ? `dependents [${dependents.join(', ')}] have been rolled back first` : 'no dependents — safe to rollback'}`,
+                `Stop traffic to migrated ${name}`,
+                `Restore ${name} from last checkpoint`,
+                `Redirect traffic back to source ${name}`,
+                `Validate source ${name} health check passes`,
+            ],
+        };
+    });
+}
+// --- Steps generation ---
+function buildRollbackSteps(components, sortedOrder) {
+    const reverseOrder = [...sortedOrder].reverse();
+    const steps = [];
+    reverseOrder.forEach((id, idx) => {
+        const comp = components.find((c) => c.id === id);
+        if (!comp) {
+            return;
+        }
+        const isDbOp = comp.type === 'layer' && comp.name.toLowerCase().includes('db');
+        const reversibility = classifyReversibility(comp, isDbOp);
+        const irreversibilityReason = buildIrreversibilityReason(comp, isDbOp);
+        steps.push({
+            stepId: `rollback-${comp.id}`,
+            description: `Rollback ${comp.name} (${comp.path})`,
+            reversibility,
+            irreversibilityReason,
+            rollbackAction: isDbOp
+                ? `Execute inverse migration script for ${comp.name} and restore data from backup`
+                : `Redeploy previous version of ${comp.name} and update routing`,
+            estimatedMinutes: Math.ceil(comp.linesOfCode / 200) * (reversibility === 'irreversible' ? 30 : 10),
+            requiresConfirmation: reversibility !== 'reversible',
+        });
+        // Warn on irreversible steps
+        if (reversibility === 'irreversible') {
+            steps.push({
+                stepId: `rollback-${comp.id}-warning`,
+                description: `CRITICAL WARNING: ${comp.name} rollback is irreversible`,
+                reversibility: 'irreversible',
+                irreversibilityReason: 
+                /* v8 ignore next 1 */ irreversibilityReason ?? 'Irreversible operation',
+                rollbackAction: 'Ensure full backup exists and data restore plan is confirmed before proceeding',
+                estimatedMinutes: 5,
+                requiresConfirmation: true,
+            });
+        }
+        // Insert as early as possible in the loop
+        void idx;
+    });
+    return steps;
+}
+// --- Public API ---
+export function generateRollbackPlan(params) {
+    const { plan, components, sortedOrder } = params;
+    const checkpoints = buildCheckpoints(plan);
+    const steps = buildRollbackSteps(components, sortedOrder);
+    const inverseDbMigrations = buildInverseDbMigrations(components);
+    const componentRollbacks = buildComponentRollbacks(components, sortedOrder);
+    const totalEstimatedMinutes = steps.reduce((sum, s) => sum + s.estimatedMinutes, 0);
+    const pointOfNoReturn = 'After decommissioning source system OR after applying destructive DB schema changes that have received production writes';
+    return {
+        components: componentRollbacks,
+        checkpoints,
+        steps,
+        inverseDbMigrations,
+        pointOfNoReturn,
+        totalEstimatedMinutes,
+        generatedAt: new Date().toISOString(),
+    };
+}
+export function createMigrationCheckpoint(params) {
+    const checkpointId = `cp-${Date.now()}`;
+    return {
+        checkpointId,
+        label: params.label,
+        completedComponents: params.completedComponents,
+        dbSchemaSnapshot: params.dbSchemaVersion ?? 'snapshot-pending',
+        serviceConfiguration: params.serviceConfig ?? {},
+        createdAt: new Date().toISOString(),
+        projectId: params.projectId,
+    };
+}
+export function buildRollbackExecutionPlan(params) {
+    const { targetCheckpointId, rollbackPlan } = params;
+    const orderedActions = rollbackPlan.steps.map((step, idx) => {
+        const type = step.requiresConfirmation
+            ? 'manual-confirmation-required'
+            : 'automatic';
+        return {
+            order: idx + 1,
+            description: step.description,
+            type,
+            reversibility: step.reversibility,
+            command: step.reversibility === 'reversible' ? `./rollback.sh --step=${step.stepId}` : undefined,
+        };
+    });
+    const requiresManualConfirmation = orderedActions.some((a) => a.type === 'manual-confirmation-required');
+    return {
+        targetCheckpointId,
+        orderedActions,
+        totalSteps: orderedActions.length,
+        requiresManualConfirmation,
+        generatedAt: new Date().toISOString(),
+    };
+}
+//# sourceMappingURL=rollback-planner.js.map

package/dist/engine/migration/rollback-planner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rollback-planner.js","sourceRoot":"","sources":["../../../src/engine/migration/rollback-planner.ts"],"names":[],"mappings":"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"}