specforge-mcp 0.1.0

package/dist/engine/migration/service-migrator-planner.js

@@ -0,0 +1,70 @@
+// engine/migration/service-migrator-planner.ts — Migration planning + validation checklist
+// Handles risk-ordered migration planning and per-service behavioral validation
+import { VALIDATION_CHECK_TEMPLATES } from './service-migrator-catalogs.js';
+export function planServicesMigration(services) {
+    // Priority: stateless first, then stateful-replayable, then stateful-critical
+    const riskOrder = {
+        stateless: 1,
+        'stateful-replayable': 2,
+        'stateful-critical': 3,
+    };
+    const sorted = [...services].sort((a, b) => riskOrder[a.riskLevel] - riskOrder[b.riskLevel]);
+    const orderedServices = sorted.map((svc, idx) => ({
+        serviceId: svc.id,
+        serviceName: svc.name,
+        serviceType: svc.type,
+        migrationOrder: idx + 1,
+        rationale: svc.riskLevel === 'stateless'
+            ? 'Stateless service — safest to migrate first; no data loss risk'
+            : svc.riskLevel === 'stateful-replayable'
+                ? 'Stateful with replay capability — migrate after stateless; use dual-write during transition'
+                : 'Stateful critical — migrate last; requires zero-downtime strategy and full backup',
+    }));
+    const stateless = sorted.filter((s) => s.riskLevel === 'stateless').map((s) => s.id);
+    const replayable = sorted.filter((s) => s.riskLevel === 'stateful-replayable').map((s) => s.id);
+    const critical = sorted.filter((s) => s.riskLevel === 'stateful-critical').map((s) => s.id);
+    const phases = [];
+    if (stateless.length > 0) {
+        phases.push({
+            phase: 1,
+            services: stateless,
+            description: 'Stateless services (caches, auth, observability)',
+        });
+    }
+    if (replayable.length > 0) {
+        phases.push({
+            phase: 2,
+            services: replayable,
+            description: 'Stateful replayable services (message queues)',
+        });
+    }
+    if (critical.length > 0) {
+        phases.push({
+            phase: 3,
+            services: critical,
+            description: 'Stateful critical services (object storage, permanent data)',
+        });
+    }
+    const estimatedWeeks = Math.ceil(services.length * 0.5) + (critical.length > 0 ? 2 : 0);
+    return {
+        orderedServices,
+        phases,
+        totalServices: services.length,
+        estimatedWeeks,
+        generatedAt: new Date().toISOString(),
+    };
+}
+export function generateServiceValidationChecklist(service) {
+    const template = VALIDATION_CHECK_TEMPLATES.find((t) => t.serviceType === service.type);
+    const checks = template?.checks.map((c) => ({
+        ...c,
+        expectedValue: 'Define from current system baseline',
+    })) ?? [];
+    return {
+        serviceId: service.id,
+        serviceName: service.name,
+        checks,
+        generatedAt: new Date().toISOString(),
+    };
+}
+//# sourceMappingURL=service-migrator-planner.js.map

package/dist/engine/migration/service-migrator-planner.js.map

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

package/dist/engine/migration/service-migrator.d.ts

@@ -0,0 +1,8 @@
+import type { ExternalService, ServiceAnalysisResult, ServiceEquivalenceMap } from '../../types/index.js';
+export { planServicesMigration, generateServiceValidationChecklist, } from './service-migrator-planner.js';
+export declare function analyzeExternalServices(params: {
+    sourceStack: string;
+    dependencies: string[];
+}): ServiceAnalysisResult;
+export declare function buildServiceEquivalenceMap(sourceStack: string, targetStack: string, services: ExternalService[]): ServiceEquivalenceMap;
+//# sourceMappingURL=service-migrator.d.ts.map

package/dist/engine/migration/service-migrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-migrator.d.ts","sourceRoot":"","sources":["../../../src/engine/migration/service-migrator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,eAAe,EACf,qBAAqB,EACrB,qBAAqB,EAGtB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,qBAAqB,EACrB,kCAAkC,GACnC,MAAM,+BAA+B,CAAC;AAsCvC,wBAAgB,uBAAuB,CAAC,MAAM,EAAE;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB,GAAG,qBAAqB,CAyBxB;AAED,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,eAAe,EAAE,GAC1B,qBAAqB,CAsCvB"}

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

@@ -0,0 +1,94 @@
+// engine/migration/service-migrator.ts — External service migration (SPEC-028b)
+// Detects, maps and plans migration of external services (queues, caches, storage, auth, etc.)
+import { PROVIDER_CATALOG, SERVICE_EQUIVALENCES } from './service-migrator-catalogs.js';
+export { planServicesMigration, generateServiceValidationChecklist, } from './service-migrator-planner.js';
+// --- Detection helpers ---
+function detectServiceFromKeywords(text) {
+    const lower = text.toLowerCase();
+    for (const entry of PROVIDER_CATALOG) {
+        if (entry.keywords.some((kw) => lower.includes(kw))) {
+            return {
+                id: entry.provider,
+                name: entry.provider.charAt(0).toUpperCase() + entry.provider.slice(1),
+                type: entry.type,
+                provider: entry.provider,
+                critical: entry.riskLevel === 'stateful-critical',
+                stateless: entry.stateless,
+                riskLevel: entry.riskLevel,
+                detectedIn: [],
+            };
+        }
+    }
+    return null;
+}
+function deduplicateServices(services) {
+    const seen = new Map();
+    for (const svc of services) {
+        const existing = seen.get(svc.id);
+        if (existing) {
+            existing.detectedIn = [...new Set([...existing.detectedIn, ...svc.detectedIn])];
+        }
+        else {
+            seen.set(svc.id, { ...svc });
+        }
+    }
+    return [...seen.values()];
+}
+// --- Public API ---
+export function analyzeExternalServices(params) {
+    const detected = [];
+    for (const dep of params.dependencies) {
+        const svc = detectServiceFromKeywords(dep);
+        if (svc) {
+            detected.push({ ...svc, detectedIn: [dep] });
+        }
+    }
+    // Also scan the stack string itself for common services
+    const stackSvc = detectServiceFromKeywords(params.sourceStack);
+    if (stackSvc) {
+        detected.push({ ...stackSvc, detectedIn: [params.sourceStack] });
+    }
+    const services = deduplicateServices(detected);
+    const criticalCount = services.filter((s) => s.critical).length;
+    return {
+        services,
+        totalDetected: services.length,
+        criticalCount,
+        analyzedAt: new Date().toISOString(),
+    };
+}
+export function buildServiceEquivalenceMap(sourceStack, targetStack, services) {
+    const equivalences = [];
+    const unmappedServices = [];
+    for (const svc of services) {
+        const entry = SERVICE_EQUIVALENCES.find((e) => e.source === svc.provider || e.type === svc.type);
+        if (entry) {
+            const adapter = {
+                interfaceName: entry.adapterInterfaceName,
+                methods: entry.methods,
+                sourceImplementation: entry.sourceImpl,
+                targetImplementation: entry.targetImpl,
+                portPattern: 'ports-and-adapters',
+            };
+            equivalences.push({
+                sourceService: svc.provider,
+                targetService: entry.target,
+                serviceType: svc.type,
+                behaviorDifferences: entry.differences,
+                adapterSpec: adapter,
+                migrationComplexity: entry.complexity,
+            });
+        }
+        else {
+            unmappedServices.push(svc.provider);
+        }
+    }
+    return {
+        sourceStack,
+        targetStack,
+        equivalences,
+        unmappedServices,
+        generatedAt: new Date().toISOString(),
+    };
+}
+//# sourceMappingURL=service-migrator.js.map

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

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

package/dist/engine/migration/stack-analyzer.d.ts

@@ -0,0 +1,23 @@
+import type { StackAnalysisResult, MigratableComponent, StackComponent, EntryPoint, ExternalIntegration } from '../../types/index.js';
+export declare function buildStackAnalysis(params: {
+    language: string;
+    framework: string;
+    components: StackComponent[];
+    entryPoints: EntryPoint[];
+    externalIntegrations: ExternalIntegration[];
+    migratableComponents: MigratableComponent[];
+    hasTests: boolean;
+    testCoverage?: string;
+}): StackAnalysisResult;
+export declare function scoreMigratableComponents(components: {
+    id: string;
+    name: string;
+    path: string;
+    type: MigratableComponent['type'];
+    cyclomaticComplexity: number;
+    couplingScore: number;
+    dependsOn: string[];
+    dependents: string[];
+    linesOfCode: number;
+}[]): MigratableComponent[];
+//# sourceMappingURL=stack-analyzer.d.ts.map

package/dist/engine/migration/stack-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack-analyzer.d.ts","sourceRoot":"","sources":["../../../src/engine/migration/stack-analyzer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EAEnB,cAAc,EAEd,UAAU,EACV,mBAAmB,EAEpB,MAAM,sBAAsB,CAAC;AA0F9B,wBAAgB,kBAAkB,CAAC,MAAM,EAAE;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,oBAAoB,EAAE,mBAAmB,EAAE,CAAC;IAC5C,oBAAoB,EAAE,mBAAmB,EAAE,CAAC;IAC5C,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,mBAAmB,CAoDtB;AAED,wBAAgB,yBAAyB,CACvC,UAAU,EAAE;IACV,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAClC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB,EAAE,GACF,mBAAmB,EAAE,CAKvB"}

package/dist/engine/migration/stack-analyzer.js

@@ -0,0 +1,111 @@
+// engine/migration/stack-analyzer.ts — Analyze source stack for migration (SPEC-028a)
+// Handles: analyze, implicit contract detection, component dependency graph
+// --- Internal helpers ---
+const HOT_COMPLEXITY_THRESHOLD = 15;
+const WARM_COMPLEXITY_THRESHOLD = 7;
+function classifyTemperature(complexity, coupling) {
+    if (complexity >= HOT_COMPLEXITY_THRESHOLD || coupling >= 8) {
+        return 'hot';
+    }
+    if (complexity >= WARM_COMPLEXITY_THRESHOLD || coupling >= 4) {
+        return 'warm';
+    }
+    return 'cold';
+}
+function detectImplicitContracts(components) {
+    return components.flatMap((c) => {
+        const contracts = [];
+        if (c.type === 'handler') {
+            contracts.push({
+                component: c.name,
+                type: 'error-format',
+                description: 'HTTP error response format must match origin exactly',
+                mustPreserve: true,
+            });
+            contracts.push({
+                component: c.name,
+                type: 'http-header',
+                description: 'Response headers (Content-Type, CORS, etc.) must be preserved',
+                mustPreserve: true,
+            });
+        }
+        if (c.temperature === 'hot') {
+            contracts.push({
+                component: c.name,
+                type: 'side-effect',
+                description: `High-complexity component — document all side effects before migrating`,
+                mustPreserve: true,
+            });
+        }
+        return contracts;
+    });
+}
+function detectArchitecturalPatterns(components) {
+    const patterns = [];
+    const names = components.map((c) => c.name.toLowerCase());
+    const hasDomainLayer = names.some((n) => n.includes('domain') || n.includes('entity')) &&
+        names.some((n) => n.includes('repo') || n.includes('store'));
+    if (hasDomainLayer) {
+        patterns.push({
+            name: 'Domain-Driven Design',
+            confidence: 0.7,
+            indicators: ['domain/ layer', 'repository pattern'],
+        });
+    }
+    const hasControllerService = names.some((n) => n.includes('controller') || n.includes('handler')) &&
+        names.some((n) => n.includes('service'));
+    if (hasControllerService) {
+        patterns.push({
+            name: 'MVC / Controller-Service',
+            confidence: 0.8,
+            indicators: ['controller layer', 'service layer'],
+        });
+    }
+    if (patterns.length === 0) {
+        patterns.push({
+            name: 'Unknown / Flat',
+            confidence: 0.5,
+            indicators: ['no clear layering detected'],
+        });
+    }
+    return patterns;
+}
+// --- Public API ---
+export function buildStackAnalysis(params) {
+    const { language, framework, components, entryPoints, externalIntegrations, migratableComponents, hasTests, testCoverage, } = params;
+    const architecturalPatterns = detectArchitecturalPatterns(migratableComponents);
+    const implicitContracts = detectImplicitContracts(migratableComponents);
+    const riskFlags = [];
+    if (!hasTests) {
+        riskFlags.push('CRITICAL: No tests detected — write behavioral tests before migrating to reduce regression risk');
+    }
+    const hotComponents = migratableComponents.filter((c) => c.temperature === 'hot');
+    if (hotComponents.length > 0) {
+        riskFlags.push(`${hotComponents.length} hot component(s) detected: ${hotComponents.map((c) => c.name).join(', ')} — prioritize deep analysis`);
+    }
+    const circularRisk = migratableComponents.some((c) => c.dependsOn.some((dep) => migratableComponents.find((m) => m.id === dep)?.dependsOn.includes(c.id)));
+    if (circularRisk) {
+        riskFlags.push('Potential circular dependencies detected — run plan action to resolve');
+    }
+    return {
+        language,
+        framework,
+        components,
+        architecturalPatterns,
+        entryPoints,
+        externalIntegrations,
+        migratableComponents,
+        implicitContracts,
+        hasTests,
+        testCoverage,
+        riskFlags,
+        analyzedAt: new Date().toISOString(),
+    };
+}
+export function scoreMigratableComponents(components) {
+    return components.map((c) => ({
+        ...c,
+        temperature: classifyTemperature(c.cyclomaticComplexity, c.couplingScore),
+    }));
+}
+//# sourceMappingURL=stack-analyzer.js.map

package/dist/engine/migration/stack-analyzer.js.map

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

package/dist/engine/migration/strategy-advisor.d.ts

@@ -0,0 +1,3 @@
+import type { MigrationStrategyResult, StrategyInput } from '../../types/index.js';
+export declare function recommendMigrationStrategy(params: StrategyInput): MigrationStrategyResult;
+//# sourceMappingURL=strategy-advisor.d.ts.map

package/dist/engine/migration/strategy-advisor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategy-advisor.d.ts","sourceRoot":"","sources":["../../../src/engine/migration/strategy-advisor.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,uBAAuB,EAMvB,aAAa,EACd,MAAM,sBAAsB,CAAC;AA2F9B,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,aAAa,GAAG,uBAAuB,CA2BzF"}

package/dist/engine/migration/strategy-advisor.js

@@ -0,0 +1,92 @@
+// engine/migration/strategy-advisor.ts — Migration strategy recommendation (SPEC-028a)
+// Recommends big-bang, strangler-fig, or parallel-run based on project characteristics
+// --- Strategy selection logic ---
+function selectStrategy(input) {
+    const { componentCount, hasActiveUsers, hasHighSla } = input;
+    if (componentCount <= 10 && !hasActiveUsers) {
+        return 'big-bang';
+    }
+    if (hasHighSla || input.hasCriticalData) {
+        return 'parallel-run';
+    }
+    return 'strangler-fig';
+}
+function buildStranglerProxy(entryPoints) {
+    const routingRules = entryPoints.map((ep) => ({
+        module: ep,
+        migrated: false,
+        routeTo: 'old',
+        condition: `Route to new when ${ep} migration is validated`,
+    }));
+    return {
+        description: 'Proxy/API gateway routes traffic between old and new system based on migrated modules',
+        routingRules,
+        implementation: 'Implement a reverse proxy (nginx, Traefik, or custom middleware) that forwards requests based on a routing table. As each module is migrated and validated, update the routing table to direct traffic to the new system.',
+    };
+}
+function detectNonIdempotentEndpoints(components) {
+    return components
+        .filter((c) => c.type === 'handler')
+        .map((c) => c.name)
+        .filter((name) => name.toLowerCase().includes('create') ||
+        name.toLowerCase().includes('update') ||
+        name.toLowerCase().includes('delete') ||
+        name.toLowerCase().includes('send') ||
+        name.toLowerCase().includes('payment'));
+}
+function buildParallelComparator(entryPoints, nonIdempotent) {
+    const readEndpoints = entryPoints.filter((ep) => !nonIdempotent.some((ni) => ep.includes(ni)));
+    return {
+        description: 'Shadow mode comparator: runs both implementations and compares responses to validate parity before full cutover',
+        endpoints: readEndpoints,
+        tolerances: Object.fromEntries(readEndpoints.map((ep) => [ep, 0.01])),
+        nonIdempotentEndpoints: nonIdempotent,
+        excludedFromShadow: nonIdempotent,
+    };
+}
+function getAlternatives(chosen) {
+    const all = {
+        'big-bang': 'Best for small codebases with no active users — high risk but fast',
+        'strangler-fig': 'Gradual migration via proxy — safe for active systems',
+        'parallel-run': 'Both systems run simultaneously — safest for critical systems with SLA',
+    };
+    return Object.entries(all)
+        .filter(([s]) => s !== chosen)
+        .map(([strategy, reason]) => ({ strategy, reason }));
+}
+function getRiskLevel(strategy, componentCount) {
+    if (strategy === 'big-bang') {
+        return componentCount > 5 ? 'high' : 'medium';
+    }
+    if (strategy === 'parallel-run') {
+        return 'low';
+    }
+    return 'medium';
+}
+// --- Public API ---
+export function recommendMigrationStrategy(params) {
+    const strategy = selectStrategy(params);
+    const nonIdempotent = detectNonIdempotentEndpoints(params.migratableComponents);
+    let stranglerProxy;
+    let parallelComparator;
+    if (strategy === 'strangler-fig') {
+        stranglerProxy = buildStranglerProxy(params.entryPoints);
+    }
+    else if (strategy === 'parallel-run') {
+        parallelComparator = buildParallelComparator(params.entryPoints, nonIdempotent);
+    }
+    const reasonMap = {
+        'big-bang': `Project has ${params.componentCount} components and no active users — full replacement is safest and fastest`,
+        'strangler-fig': `Active user base detected — gradual migration via proxy minimizes risk and allows incremental validation`,
+        'parallel-run': `High SLA or critical data requirements — both systems must run simultaneously to guarantee zero regression`,
+    };
+    return {
+        recommended: strategy,
+        reasoning: reasonMap[strategy],
+        alternatives: getAlternatives(strategy),
+        stranglerProxy,
+        parallelComparator,
+        riskLevel: getRiskLevel(strategy, params.componentCount),
+    };
+}
+//# sourceMappingURL=strategy-advisor.js.map

package/dist/engine/migration/strategy-advisor.js.map

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

package/dist/engine/mobile-detector-android.d.ts

@@ -0,0 +1,5 @@
+import type { MobileArchPattern, AndroidProjectInfo } from '../types/index.js';
+export declare function extractGradleBlock(content: string, blockName: string): string[];
+export declare function detectDeepAndroid(projectPath: string): Promise<AndroidProjectInfo>;
+export declare function detectAndroidArchPattern(projectPath: string): Promise<MobileArchPattern | null>;
+//# sourceMappingURL=mobile-detector-android.d.ts.map

package/dist/engine/mobile-detector-android.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mobile-detector-android.d.ts","sourceRoot":"","sources":["../../src/engine/mobile-detector-android.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAqC/E,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAgB/E;AAoDD,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAkDxF;AAED,wBAAsB,wBAAwB,CAC5C,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CA6CnC"}

package/dist/engine/mobile-detector-android.js

@@ -0,0 +1,172 @@
+// SpecForge — Deep Android project detection (SPEC-013)
+import { join, basename } from 'node:path';
+import { safeReadFile, walkForExt } from './mobile-detector-shared.js';
+// -- Android constants --------------------------------------------------------
+const ANDROID_CAP_KEYS = {
+    'com.google.firebase.messaging': 'FCM',
+    'com.google.android.gms.wallet': 'Google Pay',
+    'com.google.android.gms.maps': 'Google Maps',
+    'com.google.android.gms.location': 'Location Services',
+    'android.permission.NFC': 'NFC',
+};
+const GRADLE_SKIP_KEYS = new Set([
+    'minSdk',
+    'targetSdk',
+    'compileSdk',
+    'applicationId',
+    'namespace',
+    'versionCode',
+    'versionName',
+]);
+// -- Android helpers ----------------------------------------------------------
+async function readAndroidGradle(projectPath) {
+    return ((await safeReadFile(join(projectPath, 'app', 'build.gradle.kts'))) ??
+        (await safeReadFile(join(projectPath, 'app', 'build.gradle'))));
+}
+function extractSdkValue(content, key) {
+    const m = new RegExp(`${key}\\s*[=:]\\s*(\\d+)`).exec(content);
+    return m?.[1] !== undefined ? parseInt(m[1], 10) : null;
+}
+export function extractGradleBlock(content, blockName) {
+    const m = new RegExp(`${blockName}\\s*\\{([^}]+)\\}`, 's').exec(content);
+    if (!m?.[1]) {
+        return [];
+    }
+    const names = [];
+    const re = /^\s+([a-z][a-zA-Z0-9_]+)\s*[{(]/gm;
+    let nm = re.exec(m[1]);
+    while (nm !== null) {
+        const name = nm[1];
+        if (name && !GRADLE_SKIP_KEYS.has(name)) {
+            names.push(name);
+        }
+        nm = re.exec(m[1]);
+    }
+    return names;
+}
+async function parseSettingsGradle(projectPath) {
+    const content = (await safeReadFile(join(projectPath, 'settings.gradle.kts'))) ??
+        (await safeReadFile(join(projectPath, 'settings.gradle')));
+    if (!content) {
+        return [];
+    }
+    const modules = [];
+    const re = /include\s*\(?["']?([^"',)\s]+)["']?\)?/g;
+    let m = re.exec(content);
+    while (m !== null) {
+        const mod = m[1];
+        if (mod) {
+            modules.push(mod);
+        }
+        m = re.exec(content);
+    }
+    return modules;
+}
+async function parseAndroidManifest(projectPath) {
+    const content = await safeReadFile(join(projectPath, 'app', 'src', 'main', 'AndroidManifest.xml'));
+    if (!content) {
+        return { permissions: [], capabilities: [] };
+    }
+    const permissions = [];
+    const re = /uses-permission\s+android:name="([^"]+)"/g;
+    let m = re.exec(content);
+    while (m !== null) {
+        const perm = m[1];
+        if (perm) {
+            permissions.push(perm);
+        }
+        m = re.exec(content);
+    }
+    const caps = new Set();
+    for (const [kw, label] of Object.entries(ANDROID_CAP_KEYS)) {
+        if (content.includes(kw)) {
+            caps.add(label);
+        }
+    }
+    return { permissions, capabilities: [...caps] };
+}
+// -- Exported detection functions --------------------------------------------
+export async function detectDeepAndroid(projectPath) {
+    const gradle = await readAndroidGradle(projectPath);
+    let minSdk = null;
+    let targetSdk = null;
+    let compileSdk = null;
+    let buildTypes = ['debug', 'release'];
+    let productFlavors = [];
+    let namespace = null;
+    if (gradle) {
+        minSdk = extractSdkValue(gradle, 'minSdk');
+        targetSdk = extractSdkValue(gradle, 'targetSdk');
+        compileSdk = extractSdkValue(gradle, 'compileSdk');
+        const custom = extractGradleBlock(gradle, 'buildTypes');
+        if (custom.length > 0) {
+            buildTypes = [...new Set(['debug', 'release', ...custom])];
+        }
+        productFlavors = extractGradleBlock(gradle, 'productFlavors');
+        namespace =
+            /namespace\s*[=\s]*["']([^"']+)["']/m.exec(gradle)?.[1] ??
+                /applicationId\s*[=\s]*["']([^"']+)["']/m.exec(gradle)?.[1] ??
+                null;
+    }
+    const buildVariants = productFlavors.length > 0
+        ? productFlavors.flatMap((f) => buildTypes.map((b) => `${b}${f.charAt(0).toUpperCase()}${f.slice(1)}`))
+        : buildTypes;
+    const [modules, { permissions, capabilities }, archPattern] = await Promise.all([
+        parseSettingsGradle(projectPath),
+        parseAndroidManifest(projectPath),
+        detectAndroidArchPattern(projectPath),
+    ]);
+    return {
+        minSdk,
+        targetSdk,
+        compileSdk,
+        buildTypes,
+        productFlavors,
+        buildVariants,
+        namespace,
+        modules,
+        permissions,
+        capabilities,
+        archPattern,
+    };
+}
+export async function detectAndroidArchPattern(projectPath) {
+    const files = [];
+    await walkForExt(projectPath, '.kt', files, 20, 0);
+    if (files.length === 0) {
+        return null;
+    }
+    let mviState = false, mviEvent = false, hasVM = false, hasStateFlow = false, hasUseCase = false;
+    for (const f of files) {
+        const c = await safeReadFile(f);
+        if (!c) {
+            continue;
+        }
+        if (/sealed\s+class\s+\w*(State|UiState)/m.test(c)) {
+            mviState = true;
+        }
+        if (/sealed\s+class\s+\w*(Event|Intent|Action)/m.test(c)) {
+            mviEvent = true;
+        }
+        if (c.includes('ViewModel()') || c.includes(': ViewModel()')) {
+            hasVM = true;
+        }
+        if (c.includes('StateFlow') || c.includes('MutableStateFlow')) {
+            hasStateFlow = true;
+        }
+        if (basename(f, '.kt').endsWith('UseCase')) {
+            hasUseCase = true;
+        }
+    }
+    if (mviState && mviEvent) {
+        return 'mvi';
+    }
+    if (hasUseCase) {
+        return 'clean-architecture';
+    }
+    if (hasVM && hasStateFlow) {
+        return 'mvvm';
+    }
+    return null;
+}
+//# sourceMappingURL=mobile-detector-android.js.map

package/dist/engine/mobile-detector-android.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mobile-detector-android.js","sourceRoot":"","sources":["../../src/engine/mobile-detector-android.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAG3C,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAEvE,gFAAgF;AAEhF,MAAM,gBAAgB,GAA2B;IAC/C,+BAA+B,EAAE,KAAK;IACtC,+BAA+B,EAAE,YAAY;IAC7C,6BAA6B,EAAE,aAAa;IAC5C,iCAAiC,EAAE,mBAAmB;IACtD,wBAAwB,EAAE,KAAK;CAChC,CAAC;AAEF,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC;IAC/B,QAAQ;IACR,WAAW;IACX,YAAY;IACZ,eAAe;IACf,WAAW;IACX,aAAa;IACb,aAAa;CACd,CAAC,CAAC;AAEH,gFAAgF;AAEhF,KAAK,UAAU,iBAAiB,CAAC,WAAmB;IAClD,OAAO,CACL,CAAC,MAAM,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,EAAE,kBAAkB,CAAC,CAAC,CAAC;QAClE,CAAC,MAAM,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,CAC/D,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,OAAe,EAAE,GAAW;IACnD,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC,GAAG,GAAG,oBAAoB,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/D,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAAe,EAAE,SAAiB;IACnE,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC,GAAG,SAAS,mBAAmB,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzE,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACZ,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,EAAE,GAAG,mCAAmC,CAAC;IAC/C,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvB,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC;QACnB,MAAM,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;QACnB,IAAI,IAAI,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACxC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC;QACD,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,KAAK,UAAU,mBAAmB,CAAC,WAAmB;IACpD,MAAM,OAAO,GACX,CAAC,MAAM,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,qBAAqB,CAAC,CAAC,CAAC;QAC9D,CAAC,MAAM,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAC7D,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,EAAE,GAAG,yCAAyC,CAAC;IACrD,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzB,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;QAClB,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACjB,IAAI,GAAG,EAAE,CAAC;YACR,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;QACD,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,KAAK,UAAU,oBAAoB,CACjC,WAAmB;IAEnB,MAAM,OAAO,GAAG,MAAM,YAAY,CAChC,IAAI,CAAC,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,qBAAqB,CAAC,CAC/D,CAAC;IACF,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC;IAC/C,CAAC;IACD,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,MAAM,EAAE,GAAG,2CAA2C,CAAC;IACvD,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzB,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;QAClB,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAClB,IAAI,IAAI,EAAE,CAAC;YACT,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;QACD,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACvB,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAC3D,IAAI,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;YACzB,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IACD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC;AAClD,CAAC;AAED,+EAA+E;AAE/E,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,WAAmB;IACzD,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,WAAW,CAAC,CAAC;IACpD,IAAI,MAAM,GAAkB,IAAI,CAAC;IACjC,IAAI,SAAS,GAAkB,IAAI,CAAC;IACpC,IAAI,UAAU,GAAkB,IAAI,CAAC;IACrC,IAAI,UAAU,GAAG,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACtC,IAAI,cAAc,GAAa,EAAE,CAAC;IAClC,IAAI,SAAS,GAAkB,IAAI,CAAC;IAEpC,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,GAAG,eAAe,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC3C,SAAS,GAAG,eAAe,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QACjD,UAAU,GAAG,eAAe,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QACnD,MAAM,MAAM,GAAG,kBAAkB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QACxD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,UAAU,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QAC7D,CAAC;QACD,cAAc,GAAG,kBAAkB,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;QAC9D,SAAS;YACP,qCAAqC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;gBACvD,yCAAyC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;gBAC3D,IAAI,CAAC;IACT,CAAC;IAED,MAAM,aAAa,GACjB,cAAc,CAAC,MAAM,GAAG,CAAC;QACvB,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAC3B,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CACvE;QACH,CAAC,CAAC,UAAU,CAAC;IAEjB,MAAM,CAAC,OAAO,EAAE,EAAE,WAAW,EAAE,YAAY,EAAE,EAAE,WAAW,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC9E,mBAAmB,CAAC,WAAW,CAAC;QAChC,oBAAoB,CAAC,WAAW,CAAC;QACjC,wBAAwB,CAAC,WAAW,CAAC;KACtC,CAAC,CAAC;IAEH,OAAO;QACL,MAAM;QACN,SAAS;QACT,UAAU;QACV,UAAU;QACV,cAAc;QACd,aAAa;QACb,SAAS;QACT,OAAO;QACP,WAAW;QACX,YAAY;QACZ,WAAW;KACZ,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,WAAmB;IAEnB,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,UAAU,CAAC,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IACnD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,QAAQ,GAAG,KAAK,EAClB,QAAQ,GAAG,KAAK,EAChB,KAAK,GAAG,KAAK,EACb,YAAY,GAAG,KAAK,EACpB,UAAU,GAAG,KAAK,CAAC;IAErB,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,MAAM,CAAC,GAAG,MAAM,YAAY,CAAC,CAAC,CAAC,CAAC;QAChC,IAAI,CAAC,CAAC,EAAE,CAAC;YACP,SAAS;QACX,CAAC;QACD,IAAI,sCAAsC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YACnD,QAAQ,GAAG,IAAI,CAAC;QAClB,CAAC;QACD,IAAI,4CAA4C,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YACzD,QAAQ,GAAG,IAAI,CAAC;QAClB,CAAC;QACD,IAAI,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;YAC7D,KAAK,GAAG,IAAI,CAAC;QACf,CAAC;QACD,IAAI,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;YAC9D,YAAY,GAAG,IAAI,CAAC;QACtB,CAAC;QACD,IAAI,QAAQ,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YAC3C,UAAU,GAAG,IAAI,CAAC;QACpB,CAAC;IACH,CAAC;IAED,IAAI,QAAQ,IAAI,QAAQ,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,oBAAoB,CAAC;IAC9B,CAAC;IACD,IAAI,KAAK,IAAI,YAAY,EAAE,CAAC;QAC1B,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/engine/mobile-detector-ios.d.ts

@@ -0,0 +1,4 @@
+import type { MobileArchPattern, IOSProjectInfo } from '../types/index.js';
+export declare function detectDeepIOS(projectPath: string): Promise<IOSProjectInfo>;
+export declare function detectIOSArchPattern(projectPath: string): Promise<MobileArchPattern | null>;
+//# sourceMappingURL=mobile-detector-ios.d.ts.map