specforge-mcp 0.1.0

package/dist/engine/migration/db-migrator.js

@@ -0,0 +1,234 @@
+// engine/migration/db-migrator.ts — Database migration planning (SPEC-028a)
+// analyze-db, map-db, plan-db actions
+// --- Type mapping knowledge base ---
+const POSTGRES_TO_MONGO = [
+    { sourceType: 'TEXT', targetType: 'String', dataLossRisk: false },
+    { sourceType: 'VARCHAR', targetType: 'String', dataLossRisk: false },
+    { sourceType: 'INTEGER', targetType: 'Number', dataLossRisk: false },
+    {
+        sourceType: 'BIGINT',
+        targetType: 'Long (NumberLong)',
+        dataLossRisk: true,
+        dataLossNote: 'MongoDB Number may lose precision for very large integers',
+    },
+    { sourceType: 'BOOLEAN', targetType: 'Boolean', dataLossRisk: false },
+    { sourceType: 'TIMESTAMP', targetType: 'Date', dataLossRisk: false },
+    { sourceType: 'JSON', targetType: 'Object', dataLossRisk: false },
+    {
+        sourceType: 'UUID',
+        targetType: 'String (or ObjectId)',
+        dataLossRisk: false,
+        transformation: 'Store as string or convert to ObjectId',
+    },
+    {
+        sourceType: 'FOREIGN KEY',
+        targetType: 'Embedded document or $ref',
+        transformation: 'Decide: embed document vs reference. Embedding denormalizes data.',
+        dataLossRisk: true,
+        dataLossNote: 'Relational integrity not enforced — denormalized or reference-based',
+    },
+];
+const POSTGRES_TO_MYSQL = [
+    { sourceType: 'TEXT', targetType: 'TEXT', dataLossRisk: false },
+    {
+        sourceType: 'BOOLEAN',
+        targetType: 'TINYINT(1)',
+        dataLossRisk: false,
+        transformation: 'Use TINYINT(1) as BOOLEAN in MySQL',
+    },
+    {
+        sourceType: 'TIMESTAMP WITH TIME ZONE',
+        targetType: 'DATETIME',
+        dataLossRisk: true,
+        dataLossNote: 'MySQL DATETIME does not store timezone — convert to UTC first',
+    },
+    { sourceType: 'SERIAL', targetType: 'AUTO_INCREMENT', dataLossRisk: false },
+    { sourceType: 'UUID', targetType: 'CHAR(36)', dataLossRisk: false },
+    {
+        sourceType: 'JSONB',
+        targetType: 'JSON',
+        dataLossRisk: false,
+        transformation: 'MySQL JSON does not support GIN indexes',
+    },
+    {
+        sourceType: 'ARRAY',
+        targetType: 'JSON',
+        dataLossRisk: true,
+        dataLossNote: 'PostgreSQL native arrays have no MySQL equivalent — store as JSON',
+    },
+];
+const MYSQL_TO_POSTGRES = [
+    { sourceType: 'TINYINT(1)', targetType: 'BOOLEAN', dataLossRisk: false },
+    {
+        sourceType: 'DATETIME',
+        targetType: 'TIMESTAMP WITH TIME ZONE',
+        dataLossRisk: false,
+        transformation: 'Add timezone info — assume UTC if not specified',
+    },
+    { sourceType: 'AUTO_INCREMENT', targetType: 'SERIAL / IDENTITY', dataLossRisk: false },
+    { sourceType: 'ENUM', targetType: 'custom type or CHECK constraint', dataLossRisk: false },
+    { sourceType: 'TEXT', targetType: 'TEXT', dataLossRisk: false },
+];
+const TYPE_MAPPING_DB = {
+    'postgresql-mongodb': POSTGRES_TO_MONGO,
+    'postgresql-mysql': POSTGRES_TO_MYSQL,
+    'mysql-postgresql': MYSQL_TO_POSTGRES,
+};
+function getTypeMappings(sourceEngine, targetEngine) {
+    const key = `${sourceEngine.toLowerCase()}-${targetEngine.toLowerCase()}`;
+    return TYPE_MAPPING_DB[key] ?? [];
+}
+function detectMigrationType(source, target) {
+    const noSqlEngines = new Set(['mongodb', 'dynamodb', 'firebase', 'couchdb']);
+    const newSqlEngines = new Set(['cockroachdb', 'spanner', 'tidb']);
+    const cloudManaged = new Set(['rds', 'cloudsql', 'supabase', 'aurora', 'neon']);
+    const sourceIsNoSql = noSqlEngines.has(source.toLowerCase());
+    const targetIsNoSql = noSqlEngines.has(target.toLowerCase());
+    const targetIsNewSql = newSqlEngines.has(target.toLowerCase());
+    const targetIsCloud = cloudManaged.has(target.toLowerCase());
+    if (sourceIsNoSql && !targetIsNoSql) {
+        return 'nosql-to-relational';
+    }
+    if (!sourceIsNoSql && targetIsNoSql) {
+        return 'relational-to-nosql';
+    }
+    if (targetIsNewSql) {
+        return 'sql-to-newsql';
+    }
+    if (targetIsCloud) {
+        return 'on-premise-to-cloud';
+    }
+    return 'relational-to-relational';
+}
+function buildStructuralTransformations(source, target) {
+    const transforms = [];
+    const migrationType = detectMigrationType(source, target);
+    if (migrationType === 'relational-to-nosql') {
+        transforms.push('Convert FK relationships to embedded documents or $lookup references');
+        transforms.push('Denormalize frequently accessed related data for query efficiency');
+        transforms.push('Remove JOIN-based query patterns — MongoDB uses aggregation pipelines');
+    }
+    if (migrationType === 'nosql-to-relational') {
+        transforms.push('Normalize embedded documents into separate tables with FK relationships');
+        transforms.push('Identify unique indexes from MongoDB _id fields');
+        transforms.push('Convert array fields to junction tables or JSON columns');
+    }
+    return transforms;
+}
+function buildDbMigrationPhases(schema, dualWrite) {
+    const phases = [
+        {
+            order: 1,
+            name: 'schema',
+            description: 'Create target schema: tables/collections, columns, constraints',
+            estimatedMinutes: 5 + schema.tables.length * 2,
+            rollbackStrategy: 'Drop target schema entirely — origin untouched',
+        },
+        {
+            order: 2,
+            name: 'data-batches',
+            description: 'Migrate data in batches to minimize memory pressure and allow progress tracking',
+            /* v8 ignore next 1 */
+            estimatedMinutes: Math.ceil((schema.estimatedSizeGb ?? 1) * 60),
+            rollbackStrategy: 'Truncate target tables/collections — re-run from batch checkpoint',
+        },
+        {
+            order: 3,
+            name: 'indexes',
+            description: 'Create indexes AFTER data migration for maximum performance',
+            estimatedMinutes: 10 + schema.tables.length * 5,
+            rollbackStrategy: 'Drop indexes from target — data remains intact',
+        },
+        {
+            order: 4,
+            name: 'validation',
+            description: 'Run row/document count comparisons and sample data spot checks',
+            estimatedMinutes: 15,
+            rollbackStrategy: 'No rollback needed — validation only, origin unchanged',
+        },
+    ];
+    if (dualWrite) {
+        phases.splice(1, 0, {
+            order: 2,
+            name: 'data-batches',
+            description: 'Enable dual-write: all new writes go to both DBs simultaneously',
+            estimatedMinutes: 30,
+            rollbackStrategy: 'Disable dual-write flag — all writes revert to origin only',
+        });
+    }
+    return phases;
+}
+function buildDualWriteStrategy() {
+    return {
+        description: 'Dual-write pattern: application writes to both databases simultaneously during transition. New database is read-validated but not read by production until cutover.',
+        steps: [
+            '1. Deploy dual-write code with feature flag disabled',
+            '2. Enable dual-write flag — application now writes to both DBs',
+            '3. Migrate historical data in background batches',
+            '4. Run validation queries to confirm data parity',
+            '5. Enable new DB for reads on non-critical paths (canary)',
+            '6. Monitor error rates and compare response times',
+            '7. Full cutover: disable writes to origin DB',
+            '8. Keep origin DB for 30 days as read-only backup',
+        ],
+        validationQueries: [
+            'SELECT COUNT(*) FROM each table — compare origin vs target',
+            'Sample 1000 random rows per table — compare field by field',
+            'Check latest 100 records are present in both DBs',
+        ],
+        cutoverCondition: 'Zero validation errors for 24 consecutive hours + error rate on canary reads < 0.1%',
+    };
+}
+// --- Public API ---
+export function analyzeDbSchema(params) {
+    return {
+        engine: params.engine,
+        orm: params.orm,
+        tables: params.tables ?? [],
+        estimatedSizeGb: params.estimatedSizeGb,
+    };
+}
+export function buildDbMigrationMap(sourceEngine, targetEngine) {
+    const rawMappings = getTypeMappings(sourceEngine, targetEngine);
+    const typeMappings = rawMappings.map((m) => ({
+        sourceType: m.sourceType,
+        targetType: m.targetType,
+        transformation: m.transformation,
+        dataLossRisk: m.dataLossRisk,
+        dataLossNote: m.dataLossNote,
+    }));
+    const warnings = typeMappings
+        .filter((m) => m.dataLossRisk)
+        .map(
+    /* v8 ignore next 1 */
+    (m) => `WARNING: ${m.sourceType} → ${m.targetType}: ${m.dataLossNote ?? 'potential data loss'}`);
+    const structuralTransformations = buildStructuralTransformations(sourceEngine, targetEngine);
+    return {
+        sourceEngine,
+        targetEngine,
+        migrationType: detectMigrationType(sourceEngine, targetEngine),
+        typeMappings,
+        structuralTransformations,
+        warnings,
+        unmigratableFeatures: [],
+        generatedAt: new Date().toISOString(),
+    };
+}
+export function buildDbMigrationPlan(params) {
+    const { sourceEngine, targetEngine, schema, zeroDowntime } = params;
+    const phases = buildDbMigrationPhases(schema, zeroDowntime);
+    const totalMinutes = phases.reduce((sum, p) => sum + p.estimatedMinutes, 0);
+    return {
+        sourceEngine,
+        targetEngine,
+        phases,
+        estimatedDowntimeMinutes: zeroDowntime ? 0 : Math.ceil(totalMinutes * 0.3),
+        rollbackPlan: zeroDowntime
+            ? 'Disable dual-write + feature flags — full rollback in < 5 minutes'
+            : 'Stop application, restore origin DB from snapshot, restart — downtime ~15 minutes',
+        dualWriteStrategy: zeroDowntime ? buildDualWriteStrategy() : undefined,
+        unmigratableData: [],
+        generatedAt: new Date().toISOString(),
+    };
+}
+//# sourceMappingURL=db-migrator.js.map

package/dist/engine/migration/db-migrator.js.map

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

package/dist/engine/migration/equivalence-mapper.d.ts

@@ -0,0 +1,4 @@
+import type { EquivalenceMap } from '../../types/index.js';
+export declare function buildEquivalenceMap(sourceStack: string, targetStack: string): EquivalenceMap;
+export declare function getSupportedMigrationPairs(): string[];
+//# sourceMappingURL=equivalence-mapper.d.ts.map

package/dist/engine/migration/equivalence-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"equivalence-mapper.d.ts","sourceRoot":"","sources":["../../../src/engine/migration/equivalence-mapper.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAqC,MAAM,sBAAsB,CAAC;AA2K9F,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,cAAc,CA0B5F;AAED,wBAAgB,0BAA0B,IAAI,MAAM,EAAE,CAErD"}

package/dist/engine/migration/equivalence-mapper.js

@@ -0,0 +1,191 @@
+// engine/migration/equivalence-mapper.ts — Tech equivalence mapping (SPEC-028a)
+// Maps source stack libs to target stack equivalents
+// --- Known equivalence knowledge base ---
+const JAVA_TO_GO = [
+    {
+        sourceLib: 'Spring MVC',
+        targetLib: 'net/http + chi',
+        category: 'framework',
+        status: 'partial',
+        differences: [
+            'Spring DI via @Autowired — Go uses manual constructor injection',
+            'Spring AOP not available in Go — cross-cutting concerns via middleware',
+        ],
+        notes: 'Consider Gin or Echo for more batteries-included alternatives',
+    },
+    {
+        sourceLib: 'JPA / Hibernate',
+        targetLib: 'GORM',
+        category: 'database',
+        status: 'partial',
+        differences: [
+            'JPA lazy loading not available in GORM — all relations explicit',
+            'Hibernate L2 cache not equivalent — use Redis manually',
+        ],
+    },
+    {
+        sourceLib: 'JUnit 5',
+        targetLib: 'testing (stdlib) + testify',
+        category: 'testing',
+        status: 'exact',
+        differences: [],
+    },
+    {
+        sourceLib: 'Log4j / SLF4J',
+        targetLib: 'zerolog / zap',
+        category: 'library',
+        status: 'partial',
+        differences: ['Structured logging differences in API surface'],
+    },
+    {
+        sourceLib: 'Spring Security',
+        targetLib: 'middleware + jwt-go',
+        category: 'auth',
+        status: 'manual',
+        differences: [
+            'No equivalent framework — implement auth middleware manually',
+            'RBAC must be hand-coded or use Casbin',
+        ],
+    },
+];
+const PHP_TO_NODE = [
+    {
+        sourceLib: 'Laravel',
+        targetLib: 'NestJS',
+        category: 'framework',
+        status: 'partial',
+        differences: [
+            'Laravel Eloquent ORM → TypeORM / Prisma',
+            'Artisan CLI → NestJS CLI',
+            'Blade templates → not applicable for API-only migration',
+        ],
+    },
+    {
+        sourceLib: 'Eloquent ORM',
+        targetLib: 'Prisma',
+        category: 'database',
+        status: 'exact',
+        differences: ['API syntax differs significantly'],
+        notes: 'TypeORM is closer to Eloquent in philosophy',
+    },
+    {
+        sourceLib: 'PHPUnit',
+        targetLib: 'Jest / Vitest',
+        category: 'testing',
+        status: 'exact',
+        differences: [],
+    },
+    {
+        sourceLib: 'Composer',
+        targetLib: 'npm / pnpm',
+        category: 'build',
+        status: 'exact',
+        differences: [],
+    },
+];
+const PYTHON_DJANGO_TO_FASTAPI = [
+    {
+        sourceLib: 'Django',
+        targetLib: 'FastAPI',
+        category: 'framework',
+        status: 'partial',
+        differences: [
+            'Django ORM → SQLAlchemy or Tortoise ORM',
+            'Django admin panel has no FastAPI equivalent',
+            'Django signals → event-based pattern or message queue',
+        ],
+    },
+    {
+        sourceLib: 'Django ORM',
+        targetLib: 'SQLAlchemy (async)',
+        category: 'database',
+        status: 'partial',
+        differences: ['Django QuerySet API differs from SQLAlchemy session'],
+    },
+    {
+        sourceLib: 'pytest',
+        targetLib: 'pytest',
+        category: 'testing',
+        status: 'exact',
+        differences: [],
+    },
+    {
+        sourceLib: 'Celery',
+        targetLib: 'arq / dramatiq',
+        category: 'queue',
+        status: 'partial',
+        differences: ['Task syntax and broker config differ'],
+    },
+];
+const EXPRESS_TO_FASTIFY = [
+    {
+        sourceLib: 'Express',
+        targetLib: 'Fastify',
+        category: 'framework',
+        status: 'partial',
+        differences: [
+            'Express middleware API differs from Fastify plugin/hook API',
+            'Fastify schema validation built-in via Ajv',
+            'Express req/res differs from Fastify request/reply',
+        ],
+    },
+    {
+        sourceLib: 'express-validator',
+        targetLib: 'Fastify built-in schema validation',
+        category: 'library',
+        status: 'partial',
+        differences: ['JSON Schema vs fluent validation API'],
+    },
+];
+const KNOWLEDGE_BASE = {
+    'java-go': JAVA_TO_GO,
+    'php-node': PHP_TO_NODE,
+    'php-typescript': PHP_TO_NODE,
+    'python-fastapi': PYTHON_DJANGO_TO_FASTAPI,
+    'express-fastify': EXPRESS_TO_FASTIFY,
+    'express-hono': EXPRESS_TO_FASTIFY,
+};
+function normalizeStackKey(source, target) {
+    const s = source.toLowerCase().replace(/[^a-z]/g, '-');
+    const t = target.toLowerCase().replace(/[^a-z]/g, '-');
+    return `${s}-${t}`;
+}
+function findPartialMatch(key) {
+    const keys = Object.keys(KNOWLEDGE_BASE);
+    for (const k of keys) {
+        if (key.includes(k) || k.includes(key)) {
+            /* v8 ignore start */
+            return KNOWLEDGE_BASE[k] ?? [];
+            /* v8 ignore stop */
+        }
+    }
+    return [];
+}
+export function buildEquivalenceMap(sourceStack, targetStack) {
+    const key = normalizeStackKey(sourceStack, targetStack);
+    const entries = KNOWLEDGE_BASE[key] ?? findPartialMatch(key);
+    const equivalences = entries.map((e) => ({
+        originLib: e.sourceLib,
+        originStack: sourceStack,
+        targetLib: e.targetLib,
+        targetStack,
+        category: e.category,
+        status: e.status,
+        differences: e.differences,
+        notes: e.notes,
+    }));
+    const unsupportedPairs = equivalences
+        .filter((e) => e.status === 'manual' || e.status === 'none')
+        .map((e) => `${e.originLib} → manual mapping required`);
+    return {
+        sourceStack,
+        targetStack,
+        equivalences,
+        unsupportedPairs,
+        generatedAt: new Date().toISOString(),
+    };
+}
+export function getSupportedMigrationPairs() {
+    return Object.keys(KNOWLEDGE_BASE);
+}
+//# sourceMappingURL=equivalence-mapper.js.map

package/dist/engine/migration/equivalence-mapper.js.map

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

package/dist/engine/migration/feature-flag-generator.d.ts

@@ -0,0 +1,8 @@
+import type { FeatureFlagSpec, MigratableComponent } from '../../types/index.js';
+export declare function generateFeatureFlagSpec(params: {
+    migrationName: string;
+    migratedComponents: MigratableComponent[];
+    hasBaselineMetrics: boolean;
+    strategy: 'strangler-fig' | 'big-bang' | 'parallel-run';
+}): FeatureFlagSpec;
+//# sourceMappingURL=feature-flag-generator.d.ts.map

package/dist/engine/migration/feature-flag-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-flag-generator.d.ts","sourceRoot":"","sources":["../../../src/engine/migration/feature-flag-generator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,eAAe,EAQf,mBAAmB,EACpB,MAAM,sBAAsB,CAAC;AAsJ9B,wBAAgB,uBAAuB,CAAC,MAAM,EAAE;IAC9C,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,mBAAmB,EAAE,CAAC;IAC1C,kBAAkB,EAAE,OAAO,CAAC;IAC5B,QAAQ,EAAE,eAAe,GAAG,UAAU,GAAG,cAAc,CAAC;CACzD,GAAG,eAAe,CAsBlB"}

package/dist/engine/migration/feature-flag-generator.js

@@ -0,0 +1,153 @@
+// engine/migration/feature-flag-generator.ts — Feature flag spec generator (SPEC-028b)
+// Generates feature flag specs for traffic shifting during migrations
+// --- Traffic shifting stages ---
+const DEFAULT_TRAFFIC_STAGES = [
+    {
+        percentage: 1,
+        observationPeriodMinutes: 60,
+        advanceCondition: 'Error rate < 2x baseline for 60min',
+    },
+    {
+        percentage: 5,
+        observationPeriodMinutes: 120,
+        advanceCondition: 'Error rate < 2x baseline for 2h',
+    },
+    {
+        percentage: 25,
+        observationPeriodMinutes: 240,
+        advanceCondition: 'Error rate < 2x baseline for 4h',
+    },
+    {
+        percentage: 50,
+        observationPeriodMinutes: 480,
+        advanceCondition: 'Error rate < 2x baseline for 8h',
+    },
+    {
+        percentage: 100,
+        observationPeriodMinutes: 1440,
+        advanceCondition: 'All parity checks verified for 24h',
+    },
+];
+// --- Provider adapters ---
+const PROVIDER_ADAPTERS = {
+    launchdarkly: {
+        provider: 'launchdarkly',
+        implementation: `import * as ld from 'launchdarkly-node-server-sdk';
+const client = ld.init(process.env.LAUNCHDARKLY_SDK_KEY!);
+export async function isEnabled(flagKey: string, userKey: string): Promise<boolean> {
+  return client.variation(flagKey, { key: userKey }, false) as Promise<boolean>;
+}`,
+        configExample: `LAUNCHDARKLY_SDK_KEY=sdk-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx`,
+    },
+    unleash: {
+        provider: 'unleash',
+        implementation: `import { initialize } from 'unleash-client';
+const unleash = initialize({ url: process.env.UNLEASH_URL!, appName: 'migration', instanceId: 'instance-1' });
+export function isEnabled(flagKey: string, context?: object): boolean {
+  return unleash.isEnabled(flagKey, context);
+}`,
+        configExample: `UNLEASH_URL=http://unleash.internal/api`,
+    },
+    flagsmith: {
+        provider: 'flagsmith',
+        implementation: `import Flagsmith from 'flagsmith-nodejs';
+const flagsmith = new Flagsmith({ environmentKey: process.env.FLAGSMITH_ENV_KEY! });
+export async function isEnabled(flagKey: string, identifier?: string): Promise<boolean> {
+  const flags = identifier ? await flagsmith.getIdentityFlags(identifier) : await flagsmith.getEnvironmentFlags();
+  return flags.isFeatureEnabled(flagKey);
+}`,
+        configExample: `FLAGSMITH_ENV_KEY=ser.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`,
+    },
+    'custom-json': {
+        provider: 'custom-json',
+        implementation: `import { readFileSync } from 'fs';
+interface FlagConfig { enabled: boolean; percentage: number; }
+function loadFlags(): Record<string, FlagConfig> {
+  try { return JSON.parse(readFileSync('./flags.json', 'utf-8')) as Record<string, FlagConfig>; }
+  catch { return {}; }
+}
+export function isEnabled(flagKey: string): boolean {
+  const flags = loadFlags();
+  const flag = flags[flagKey];
+  if (!flag?.enabled) return false;
+  return Math.random() * 100 < (flag.percentage ?? 100);
+}`,
+        configExample: `// flags.json\n{ "migration_new_service": { "enabled": true, "percentage": 5 } }`,
+    },
+};
+// --- Router generation ---
+function buildRouter(migratedModules, flagName) {
+    return {
+        description: 'Strangler-fig router: reads the migration flag and routes each request to new or old system based on migrated modules',
+        pseudocode: `function route(request, module) {
+  const isMigrated = [${migratedModules.map((m) => JSON.stringify(m)).join(', ')}].includes(module);
+  const useNew = isMigrated && featureFlags.isEnabled('${flagName}');
+  return useNew ? newSystem.handle(request) : oldSystem.handle(request);
+}`,
+        modules: migratedModules,
+    };
+}
+// --- Test scenarios ---
+function buildFlagTests(flagName, modules) {
+    return [
+        {
+            scenario: `Flag ${flagName} is OFF — all traffic goes to old system`,
+            flagState: 'off',
+            expectedBehavior: `All modules [${modules.join(', ')}] route to old system; no errors from new system`,
+        },
+        {
+            scenario: `Flag ${flagName} is ON at 100% — all traffic goes to new system`,
+            flagState: 'on',
+            expectedBehavior: `All modules route to new system; parity with old system verified`,
+        },
+        {
+            scenario: `Flag ${flagName} is PARTIAL (1-99%) — traffic splits correctly`,
+            flagState: 'partial',
+            expectedBehavior: `Percentage of requests route to new system; no data inconsistency on split requests`,
+        },
+    ];
+}
+// --- Auto-rollback criteria ---
+function buildAutoRollbackCriteria(hasBaselineMetrics) {
+    if (!hasBaselineMetrics) {
+        return {
+            errorRateMultiplier: 0, // 0 means disabled
+            windowMinutes: 0,
+            description: 'Auto-rollback DISABLED — source system has no metrics baseline. Manual decision required for rollback.',
+        };
+    }
+    return {
+        errorRateMultiplier: 2,
+        windowMinutes: 5,
+        description: 'If error rate of new system exceeds 2x the baseline error rate for 5 minutes, flag automatically reverts to 0%',
+    };
+}
+// --- Expiration policy ---
+function buildExpirationPolicy() {
+    return {
+        suggestedDaysAfterMigration: 14,
+        techDebtWarningDays: 90,
+        rationale: 'Flag should be removed 14 days after 100% migration is stable. Flag is flagged as tech debt if still active at 90 days.',
+    };
+}
+// --- Public API ---
+export function generateFeatureFlagSpec(params) {
+    const { migrationName, migratedComponents, hasBaselineMetrics, strategy } = params;
+    const flagName = `migration_${migrationName.toLowerCase().replace(/[^a-z0-9]/g, '_')}`;
+    const moduleNames = migratedComponents.map((c) => c.name);
+    const allProviders = Object.keys(PROVIDER_ADAPTERS);
+    const adapters = allProviders.map((p) => PROVIDER_ADAPTERS[p]);
+    const router = strategy === 'strangler-fig' ? buildRouter(moduleNames, flagName) : undefined;
+    return {
+        flagName,
+        description: `Controls traffic shifting for migration: ${migrationName}. Enables progressive cutover from old to new system.`,
+        trafficStages: DEFAULT_TRAFFIC_STAGES,
+        autoRollback: buildAutoRollbackCriteria(hasBaselineMetrics),
+        adapters,
+        router,
+        expirationPolicy: buildExpirationPolicy(),
+        tests: buildFlagTests(flagName, moduleNames),
+        generatedAt: new Date().toISOString(),
+    };
+}
+//# sourceMappingURL=feature-flag-generator.js.map

package/dist/engine/migration/feature-flag-generator.js.map

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

package/dist/engine/migration/index.d.ts

@@ -0,0 +1,11 @@
+export { buildStackAnalysis, scoreMigratableComponents } from './stack-analyzer.js';
+export { buildEquivalenceMap, getSupportedMigrationPairs } from './equivalence-mapper.js';
+export { generateMigrationPlan } from './plan-generator.js';
+export { recommendMigrationStrategy } from './strategy-advisor.js';
+export { generateParityValidation } from './parity-validator.js';
+export { analyzeDbSchema, buildDbMigrationMap, buildDbMigrationPlan } from './db-migrator.js';
+export { analyzeExternalServices, buildServiceEquivalenceMap, planServicesMigration, generateServiceValidationChecklist, } from './service-migrator.js';
+export { generateRollbackPlan, createMigrationCheckpoint, buildRollbackExecutionPlan, } from './rollback-planner.js';
+export { generateFeatureFlagSpec } from './feature-flag-generator.js';
+export { buildMigrationStatusReport } from './migration-tracker.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/engine/migration/index.d.ts.map

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

@@ -0,0 +1,14 @@
+// engine/migration/index.ts — Public API for migration engine (SPEC-028a + SPEC-028b)
+// Re-exports all migration sub-module functions
+export { buildStackAnalysis, scoreMigratableComponents } from './stack-analyzer.js';
+export { buildEquivalenceMap, getSupportedMigrationPairs } from './equivalence-mapper.js';
+export { generateMigrationPlan } from './plan-generator.js';
+export { recommendMigrationStrategy } from './strategy-advisor.js';
+export { generateParityValidation } from './parity-validator.js';
+export { analyzeDbSchema, buildDbMigrationMap, buildDbMigrationPlan } from './db-migrator.js';
+// SPEC-028b
+export { analyzeExternalServices, buildServiceEquivalenceMap, planServicesMigration, generateServiceValidationChecklist, } from './service-migrator.js';
+export { generateRollbackPlan, createMigrationCheckpoint, buildRollbackExecutionPlan, } from './rollback-planner.js';
+export { generateFeatureFlagSpec } from './feature-flag-generator.js';
+export { buildMigrationStatusReport } from './migration-tracker.js';
+//# sourceMappingURL=index.js.map