specforge-mcp 0.1.0

package/dist/engine/package-registry.js

@@ -0,0 +1,258 @@
+// SpecForge — Package Registry Clients
+// Queries npm, PyPI, crates.io, pkg.go.dev, packagist for latest versions.
+// Uses globalThis.fetch (Node.js 22+) — no external HTTP dependencies.
+// === Registry URL templates ===
+const REGISTRY_URLS = {
+    npm: 'https://registry.npmjs.org/{name}',
+    pypi: 'https://pypi.org/pypi/{name}/json',
+    crates: 'https://crates.io/api/v1/crates/{name}',
+    go: 'https://proxy.golang.org/{name}/@latest',
+    packagist: 'https://repo.packagist.org/p2/{name}.json',
+    pub: 'https://pub.dev/api/packages/{name}',
+    nuget: 'https://api.nuget.org/v3-flatcontainer/{name}/index.json',
+    rubygems: 'https://rubygems.org/api/v1/gems/{name}.json',
+};
+const TIMEOUT_MS = 10_000;
+// === Public API ===
+export async function fetchLatestVersion(packageName, registry) {
+    const urlTemplate = REGISTRY_URLS[registry];
+    const url = urlTemplate.replace('{name}', encodeURIComponent(packageName));
+    try {
+        const response = await globalThis.fetch(url, {
+            headers: buildHeaders(registry),
+            signal: AbortSignal.timeout(TIMEOUT_MS),
+        });
+        if (!response.ok) {
+            return null;
+        }
+        const data = await response.json();
+        return parseRegistryResponse(data, registry);
+    }
+    catch {
+        return null;
+    }
+}
+export function classifyUpdateType(current, latest) {
+    const cur = parseSemver(current);
+    const lat = parseSemver(latest);
+    if (!cur || !lat) {
+        return 'up-to-date';
+    }
+    if (cur.major === lat.major && cur.minor === lat.minor && cur.patch === lat.patch) {
+        return 'up-to-date';
+    }
+    if (lat.major > cur.major) {
+        return 'major';
+    }
+    if (lat.minor > cur.minor) {
+        return 'minor';
+    }
+    if (lat.patch > cur.patch) {
+        return 'patch';
+    }
+    return 'up-to-date';
+}
+export function detectRegistry(packageName, language) {
+    const lang = language?.toLowerCase() ?? '';
+    if (lang === 'python' || lang === 'python3') {
+        return 'pypi';
+    }
+    if (lang === 'rust') {
+        return 'crates';
+    }
+    if (lang === 'go' || lang === 'golang') {
+        return 'go';
+    }
+    if (lang === 'php') {
+        return 'packagist';
+    }
+    if (lang === 'dart' || lang === 'flutter') {
+        return 'pub';
+    }
+    if (lang === 'csharp' || lang === 'c#' || lang === 'dotnet') {
+        return 'nuget';
+    }
+    if (lang === 'ruby') {
+        return 'rubygems';
+    }
+    // Heuristic: scoped packages (@scope/name) are npm
+    if (packageName.startsWith('@')) {
+        return 'npm';
+    }
+    // Default to npm for JS/TS ecosystem
+    return 'npm';
+}
+export async function checkPackageVersions(dependencies, language) {
+    const results = [];
+    const entries = Object.entries(dependencies);
+    // Process in batches to respect rate limits
+    const batchSize = 5;
+    for (let i = 0; i < entries.length; i += batchSize) {
+        const batch = entries.slice(i, i + batchSize);
+        const batchResults = await Promise.allSettled(batch.map(async ([name, version]) => {
+            const cleanVersion = version.replace(/[\^~>=<]/g, '');
+            const registry = detectRegistry(name, language);
+            const latest = await fetchLatestVersion(name, registry);
+            if (latest) {
+                return {
+                    name,
+                    currentVersion: cleanVersion,
+                    latestVersion: latest.version,
+                    updateType: classifyUpdateType(cleanVersion, latest.version),
+                    deprecated: latest.deprecated,
+                    replacement: latest.replacement,
+                    registry,
+                    checkedAt: new Date().toISOString(),
+                };
+            }
+            // Fallback: registry unreachable
+            return {
+                name,
+                currentVersion: cleanVersion,
+                latestVersion: cleanVersion,
+                updateType: 'up-to-date',
+                deprecated: false,
+                registry,
+                checkedAt: new Date().toISOString(),
+            };
+        }));
+        for (const result of batchResults) {
+            if (result.status === 'fulfilled') {
+                results.push(result.value);
+            }
+        }
+    }
+    return results;
+}
+// === Internal helpers ===
+function buildHeaders(registry) {
+    const headers = {
+        'User-Agent': 'SpecForge-MCP/1.0',
+        Accept: 'application/json',
+    };
+    // crates.io requires a user agent
+    if (registry === 'crates') {
+        headers['User-Agent'] = 'SpecForge-MCP/1.0 (https://github.com/specforge)';
+    }
+    return headers;
+}
+function parseSemver(version) {
+    const clean = version.replace(/^[v=]/, '').split('-')[0] ?? '';
+    const parts = clean.split('.');
+    const major = Number(parts[0]);
+    const minor = Number(parts[1] ?? '0');
+    const patch = Number(parts[2] ?? '0');
+    if (isNaN(major)) {
+        return null;
+    }
+    return { major, minor, patch };
+}
+function parseRegistryResponse(data, registry) {
+    if (!data || typeof data !== 'object') {
+        return null;
+    }
+    switch (registry) {
+        case 'npm':
+            return parseNpmResponse(data);
+        case 'pypi':
+            return parsePyPIResponse(data);
+        case 'crates':
+            return parseCratesResponse(data);
+        case 'go':
+            return parseGoResponse(data);
+        case 'packagist':
+            return parsePackagistResponse(data);
+        case 'pub':
+            return parsePubResponse(data);
+        case 'nuget':
+            return parseNugetResponse(data);
+        case 'rubygems':
+            return parseRubygemsResponse(data);
+    }
+}
+function parseNpmResponse(data) {
+    const distTags = data['dist-tags'];
+    const version = distTags?.latest;
+    if (!version) {
+        return null;
+    }
+    // Check deprecation in latest version info
+    const versions = data.versions;
+    const latestInfo = versions?.[version];
+    const deprecated = typeof latestInfo?.deprecated === 'string';
+    return { version, deprecated };
+}
+function parsePyPIResponse(data) {
+    const info = data.info;
+    const version = info?.version;
+    if (typeof version !== 'string') {
+        return null;
+    }
+    const classifiers = (info?.classifiers ?? []);
+    const deprecated = classifiers.some((c) => c.includes('Inactive') || c.includes('Deprecated'));
+    return { version, deprecated };
+}
+function parseCratesResponse(data) {
+    const crate = data.crate;
+    const version = crate?.max_stable_version ?? crate?.max_version;
+    if (typeof version !== 'string') {
+        return null;
+    }
+    return { version, deprecated: false };
+}
+function parseGoResponse(data) {
+    const version = data.Version;
+    if (typeof version !== 'string') {
+        return null;
+    }
+    return { version: version.replace(/^v/, ''), deprecated: false };
+}
+function parsePackagistResponse(data) {
+    const packages = data.packages;
+    if (!packages) {
+        return null;
+    }
+    const entries = Object.values(packages)[0];
+    const latest = entries?.[0];
+    if (!latest) {
+        return null;
+    }
+    const version = latest.version;
+    if (typeof version !== 'string') {
+        return null;
+    }
+    const abandoned = latest.abandoned;
+    return {
+        version: version.replace(/^v/, ''),
+        deprecated: typeof abandoned === 'string' || abandoned === true,
+        replacement: typeof abandoned === 'string' ? abandoned : undefined,
+    };
+}
+function parsePubResponse(data) {
+    const latest = data.latest;
+    const version = latest?.version;
+    if (typeof version !== 'string') {
+        return null;
+    }
+    return { version, deprecated: false };
+}
+function parseNugetResponse(data) {
+    const versions = data.versions;
+    if (!versions || versions.length === 0) {
+        return null;
+    }
+    // Last version in the list is the latest
+    const version = versions[versions.length - 1];
+    if (!version) {
+        return null;
+    }
+    return { version, deprecated: false };
+}
+function parseRubygemsResponse(data) {
+    const version = data.version;
+    if (typeof version !== 'string') {
+        return null;
+    }
+    return { version, deprecated: false };
+}
+//# sourceMappingURL=package-registry.js.map

package/dist/engine/package-registry.js.map

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

package/dist/engine/paradigm-advisor/recommendations.d.ts

@@ -0,0 +1,23 @@
+import type { ParadigmReport, ParadigmRecommendation, ParadigmDrift, ParadigmMigrationPlan } from '../../types/index.js';
+/**
+ * Returns paradigm-specific recommendations based on a detection report.
+ * Returns an empty array when confidence is below threshold (avoids noise).
+ */
+export declare function getParadigmRecommendations(detection: ParadigmReport): ParadigmRecommendation[];
+/**
+ * Detects paradigm drift by checking if spec content contains keywords
+ * inconsistent with the dominant paradigm.
+ */
+export declare function detectParadigmDrift(specContent: string, dominantParadigm: string, threshold: number): ParadigmDrift | null;
+/**
+ * Generates a structured migration plan from one paradigm to another.
+ */
+export declare function generateParadigmMigrationPlan(origin: string, destination: string): ParadigmMigrationPlan;
+/**
+ * Formats paradigm recommendations and an optional drift result into a
+ * human-readable expert voice section string.
+ */
+export declare function formatParadigmObservations(recommendations: ParadigmRecommendation[], drift: ParadigmDrift | null): string;
+export declare function getMinConfidenceThreshold(): number;
+export declare function getDriftConfidenceThreshold(): number;
+//# sourceMappingURL=recommendations.d.ts.map

package/dist/engine/paradigm-advisor/recommendations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recommendations.d.ts","sourceRoot":"","sources":["../../../src/engine/paradigm-advisor/recommendations.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,cAAc,EACd,sBAAsB,EACtB,aAAa,EACb,qBAAqB,EACtB,MAAM,sBAAsB,CAAC;AAc9B;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,cAAc,GAAG,sBAAsB,EAAE,CAc9F;AAID;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EACnB,gBAAgB,EAAE,MAAM,EACxB,SAAS,EAAE,MAAM,GAChB,aAAa,GAAG,IAAI,CAyDtB;AAID;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAClB,qBAAqB,CA2BvB;AAID;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,eAAe,EAAE,sBAAsB,EAAE,EACzC,KAAK,EAAE,aAAa,GAAG,IAAI,GAC1B,MAAM,CAgCR;AAID,wBAAgB,yBAAyB,IAAI,MAAM,CAElD;AAED,wBAAgB,2BAA2B,IAAI,MAAM,CAEpD"}

package/dist/engine/paradigm-advisor/recommendations.js

@@ -0,0 +1,136 @@
+// engine/paradigm-advisor/recommendations.ts — Paradigm recommendations and formatter (SPEC-035b)
+import { MIN_CONFIDENCE_FOR_RECOMMENDATIONS, MIN_CONFIDENCE_FOR_DRIFT, OOP_KEYWORDS, FP_KEYWORDS, RECOMMENDATIONS_BY_PARADIGM, GENERIC_RECOMMENDATIONS, MIGRATION_PHASES, MIGRATION_RISKS, } from './tables.js';
+// === Recommendations ===
+/**
+ * Returns paradigm-specific recommendations based on a detection report.
+ * Returns an empty array when confidence is below threshold (avoids noise).
+ */
+export function getParadigmRecommendations(detection) {
+    const dominant = detection.dominant;
+    if (!dominant || dominant.confidence < MIN_CONFIDENCE_FOR_RECOMMENDATIONS) {
+        return [];
+    }
+    const known = RECOMMENDATIONS_BY_PARADIGM[dominant.paradigmId];
+    if (known) {
+        return known;
+    }
+    return GENERIC_RECOMMENDATIONS;
+}
+// === Drift detection ===
+/**
+ * Detects paradigm drift by checking if spec content contains keywords
+ * inconsistent with the dominant paradigm.
+ */
+export function detectParadigmDrift(specContent, dominantParadigm, threshold) {
+    if (!specContent || threshold < 0 || threshold > 1) {
+        return null;
+    }
+    const lower = specContent.toLowerCase();
+    const evidence = [];
+    if (dominantParadigm === 'functional' || dominantParadigm === 'pure-functional') {
+        for (const kw of OOP_KEYWORDS) {
+            if (lower.includes(kw)) {
+                evidence.push(kw.trim());
+            }
+        }
+        if (evidence.length === 0) {
+            return null;
+        }
+        const driftScore = evidence.length / (evidence.length + FP_KEYWORDS.length);
+        if (driftScore < threshold) {
+            return null;
+        }
+        return {
+            expectedParadigm: dominantParadigm,
+            detectedParadigm: 'oop',
+            evidence,
+            severity: driftScore > 0.7 ? 'blocker' : 'warning',
+        };
+    }
+    if (dominantParadigm === 'oop') {
+        for (const kw of FP_KEYWORDS) {
+            if (lower.includes(kw)) {
+                evidence.push(kw.trim());
+            }
+        }
+        if (evidence.length === 0) {
+            return null;
+        }
+        const driftScore = evidence.length / (evidence.length + OOP_KEYWORDS.length);
+        if (driftScore < threshold) {
+            return null;
+        }
+        return {
+            expectedParadigm: 'oop',
+            detectedParadigm: 'functional',
+            evidence,
+            severity: driftScore > 0.7 ? 'blocker' : 'warning',
+        };
+    }
+    return null;
+}
+// === Migration plan ===
+/**
+ * Generates a structured migration plan from one paradigm to another.
+ */
+export function generateParadigmMigrationPlan(origin, destination) {
+    const key = `${origin}->${destination}`;
+    const phases = MIGRATION_PHASES[key] ?? [
+        'Audit the current codebase and identify hotspots',
+        'Define target patterns and document them as ADRs',
+        'Refactor incrementally — one module at a time',
+        'Update tests to reflect new paradigm conventions',
+        'Validate with the team and iterate',
+    ];
+    const risks = MIGRATION_RISKS[key] ?? [
+        'Mixed paradigm period creates inconsistency',
+        'Team alignment may slow the migration',
+        'Legacy integrations may resist the new paradigm',
+    ];
+    const sameFamily = (origin.includes('functional') && destination.includes('functional')) ||
+        (origin === 'oop' && destination === 'oop');
+    const estimatedEffort = sameFamily
+        ? '1-2 weeks (paradigms share many patterns)'
+        : phases.length <= 4
+            ? '2-4 weeks (moderate structural changes)'
+            : '4-8 weeks (significant architectural shift)';
+    return { origin, destination, phases, risks, estimatedEffort };
+}
+// === Formatter ===
+/**
+ * Formats paradigm recommendations and an optional drift result into a
+ * human-readable expert voice section string.
+ */
+export function formatParadigmObservations(recommendations, drift) {
+    const lines = [];
+    if (recommendations.length === 0 && !drift) {
+        return '';
+    }
+    lines.push('### Paradigm Expert Voice');
+    lines.push('');
+    if (drift) {
+        lines.push(`**Paradigm Drift Detected** (${drift.severity.toUpperCase()}): ` +
+            `Expected \`${drift.expectedParadigm}\` patterns but found \`${drift.detectedParadigm}\` signals.`);
+        lines.push(`Evidence: ${drift.evidence.join(', ')}`);
+        lines.push('');
+    }
+    if (recommendations.length > 0) {
+        lines.push('**Recommendations:**');
+        for (const rec of recommendations) {
+            const urgencyTag = rec.urgency === 'high' ? ' [HIGH]' : rec.urgency === 'medium' ? ' [MEDIUM]' : '';
+            lines.push(`- ${rec.message}${urgencyTag}`);
+            if (rec.alternatives.length > 0) {
+                lines.push(`  Alternatives: ${rec.alternatives.join(' | ')}`);
+            }
+        }
+    }
+    return lines.join('\n');
+}
+// === Threshold accessors (exposed for tests) ===
+export function getMinConfidenceThreshold() {
+    return MIN_CONFIDENCE_FOR_RECOMMENDATIONS;
+}
+export function getDriftConfidenceThreshold() {
+    return MIN_CONFIDENCE_FOR_DRIFT;
+}
+//# sourceMappingURL=recommendations.js.map

package/dist/engine/paradigm-advisor/recommendations.js.map

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

package/dist/engine/paradigm-advisor/tables.d.ts

@@ -0,0 +1,18 @@
+import type { ParadigmRecommendation } from '../../types/index.js';
+/** Minimum confidence to surface recommendations (avoids false positives). */
+export declare const MIN_CONFIDENCE_FOR_RECOMMENDATIONS = 0.6;
+/** Minimum confidence to surface drift warnings. */
+export declare const MIN_CONFIDENCE_FOR_DRIFT = 0.5;
+/**
+ * Keywords in spec content that indicate OOP usage.
+ */
+export declare const OOP_KEYWORDS: string[];
+/**
+ * Keywords in spec content that indicate FP usage.
+ */
+export declare const FP_KEYWORDS: string[];
+export declare const RECOMMENDATIONS_BY_PARADIGM: Record<string, ParadigmRecommendation[]>;
+export declare const GENERIC_RECOMMENDATIONS: ParadigmRecommendation[];
+export declare const MIGRATION_PHASES: Record<string, string[]>;
+export declare const MIGRATION_RISKS: Record<string, string[]>;
+//# sourceMappingURL=tables.d.ts.map

package/dist/engine/paradigm-advisor/tables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tables.d.ts","sourceRoot":"","sources":["../../../src/engine/paradigm-advisor/tables.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAEnE,8EAA8E;AAC9E,eAAO,MAAM,kCAAkC,MAAM,CAAC;AAEtD,oDAAoD;AACpD,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAE5C;;GAEG;AACH,eAAO,MAAM,YAAY,UAAyD,CAAC;AAEnF;;GAEG;AACH,eAAO,MAAM,WAAW,UAAyE,CAAC;AAElG,eAAO,MAAM,2BAA2B,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,EAAE,CAsGhF,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,sBAAsB,EAQ3D,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CA6BrD,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAqBpD,CAAC"}

package/dist/engine/paradigm-advisor/tables.js

@@ -0,0 +1,176 @@
+// engine/paradigm-advisor/tables.ts — Recommendation and migration tables (SPEC-035b)
+/** Minimum confidence to surface recommendations (avoids false positives). */
+export const MIN_CONFIDENCE_FOR_RECOMMENDATIONS = 0.6;
+/** Minimum confidence to surface drift warnings. */
+export const MIN_CONFIDENCE_FOR_DRIFT = 0.5;
+/**
+ * Keywords in spec content that indicate OOP usage.
+ */
+export const OOP_KEYWORDS = ['class ', 'new ', 'this.', 'extends ', 'implements '];
+/**
+ * Keywords in spec content that indicate FP usage.
+ */
+export const FP_KEYWORDS = ['pure function', 'immutable', 'lambda', 'map(', 'reduce(', 'filter('];
+export const RECOMMENDATIONS_BY_PARADIGM = {
+    functional: [
+        {
+            type: 'functional',
+            message: 'Use pure functions and immutability to avoid unintended side effects.',
+            alternatives: ['Consider persistent data structures (Immer, Immutable.js)'],
+            urgency: 'medium',
+        },
+        {
+            type: 'functional',
+            message: 'Prefer composable transformations over mutating state in place.',
+            alternatives: ['Use function composition with pipe/compose utilities'],
+            urgency: 'low',
+        },
+        {
+            type: 'functional',
+            message: 'Consider property-based tests to verify function correctness at scale.',
+            alternatives: ['fast-check for TypeScript', 'Hypothesis for Python'],
+            urgency: 'low',
+        },
+    ],
+    'pure-functional': [
+        {
+            type: 'pure-functional',
+            message: 'Use pure functions and immutability to avoid unintended side effects.',
+            alternatives: ['Consider persistent data structures (Immer, Immutable.js)'],
+            urgency: 'medium',
+        },
+        {
+            type: 'pure-functional',
+            message: 'Isolate all side effects in a thin I/O boundary (IO monad pattern).',
+            alternatives: ['fp-ts Effect type', 'Purify-ts IO'],
+            urgency: 'high',
+        },
+        {
+            type: 'pure-functional',
+            message: 'Property-based tests are essential for pure functions — use them widely.',
+            alternatives: ['fast-check', 'Hypothesis', 'QuickCheck'],
+            urgency: 'medium',
+        },
+    ],
+    oop: [
+        {
+            type: 'oop',
+            message: 'Apply SOLID principles — especially Single Responsibility and Dependency Inversion.',
+            alternatives: ['Consider hexagonal architecture for clear port/adapter separation'],
+            urgency: 'medium',
+        },
+        {
+            type: 'oop',
+            message: 'Define clear interfaces before implementations to avoid tight coupling.',
+            alternatives: ['Program to an interface, not an implementation (GoF principle)'],
+            urgency: 'medium',
+        },
+        {
+            type: 'oop',
+            message: 'Use dependency injection to make components testable in isolation.',
+            alternatives: ['InversifyJS', 'tsyringe', 'manual constructor injection'],
+            urgency: 'low',
+        },
+    ],
+    reactive: [
+        {
+            type: 'reactive',
+            message: 'Model all state as event streams — avoid imperative mutations.',
+            alternatives: ['RxJS', 'xstate for statecharts', 'Signals (Angular/Solid)'],
+            urgency: 'high',
+        },
+        {
+            type: 'reactive',
+            message: 'Handle backpressure explicitly to prevent memory leaks under load.',
+            alternatives: ['throttleTime', 'debounceTime', 'buffer operators in RxJS'],
+            urgency: 'high',
+        },
+        {
+            type: 'reactive',
+            message: 'Use Observable patterns for async coordination instead of callbacks.',
+            alternatives: ['switchMap over nested subscriptions', 'mergeMap for concurrent ops'],
+            urgency: 'medium',
+        },
+    ],
+    procedural: [
+        {
+            type: 'procedural',
+            message: 'Organize code with modules to prevent global state pollution.',
+            alternatives: ['ES modules', 'Python packages', 'Go packages'],
+            urgency: 'medium',
+        },
+        {
+            type: 'procedural',
+            message: 'Consider incremental refactoring toward functional style for better testability.',
+            alternatives: ['Extract pure functions from stateful procedures first'],
+            urgency: 'low',
+        },
+        {
+            type: 'procedural',
+            message: 'Keep functions small (< 30 lines) with a single clear purpose.',
+            alternatives: ['Extract helper functions', 'Use early returns to reduce nesting'],
+            urgency: 'low',
+        },
+    ],
+};
+export const GENERIC_RECOMMENDATIONS = [
+    {
+        type: 'unknown',
+        message: 'No dominant paradigm detected — consider establishing clear architectural guidelines.',
+        alternatives: ['Choose one paradigm and document it in your CLAUDE.md or ADR'],
+        urgency: 'medium',
+    },
+];
+export const MIGRATION_PHASES = {
+    'functional->oop': [
+        'Identify stateful operations hidden inside closures',
+        'Extract classes from closure-based modules',
+        'Define interfaces for each new class boundary',
+        'Replace function composition with method chains where appropriate',
+        'Rewrite unit tests using class mocking patterns',
+    ],
+    'pure-functional->oop': [
+        'Identify stateful operations hidden inside closures',
+        'Extract classes from closure-based modules',
+        'Define interfaces for each new class boundary',
+        'Replace function composition with method chains where appropriate',
+        'Rewrite unit tests using class mocking patterns',
+    ],
+    'oop->functional': [
+        'Identify pure functions already embedded in methods',
+        'Extract state transformations out of mutable objects',
+        'Remove mutations — replace setters with returning new values',
+        'Add property-based tests to verify function correctness',
+        'Reduce class hierarchy depth — prefer composition over inheritance',
+    ],
+    'oop->pure-functional': [
+        'Identify pure functions already embedded in methods',
+        'Extract state transformations out of mutable objects',
+        'Remove mutations — replace setters with returning new values',
+        'Isolate all side effects in an IO boundary layer',
+        'Add property-based tests to verify function correctness',
+    ],
+};
+export const MIGRATION_RISKS = {
+    'functional->oop': [
+        'Team may find OOP boilerplate increases cognitive load',
+        'Composition patterns from FP may not map cleanly to class hierarchies',
+        'Test suite will need significant rewrites',
+    ],
+    'pure-functional->oop': [
+        'Team may find OOP boilerplate increases cognitive load',
+        'Loss of type-level purity guarantees',
+        'Test suite will need significant rewrites',
+    ],
+    'oop->functional': [
+        'Existing framework integrations may rely on class instances',
+        'Serialization/deserialization libraries often expect class instances',
+        'Incremental migration creates a long "mixed paradigm" period',
+    ],
+    'oop->pure-functional': [
+        'Existing framework integrations may rely on class instances',
+        'Stricter purity rules require significant architecture changes',
+        'Learning curve for functional patterns is steep',
+    ],
+};
+//# sourceMappingURL=tables.js.map

package/dist/engine/paradigm-advisor/tables.js.map

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

package/dist/engine/paradigm-advisor.d.ts

@@ -0,0 +1,2 @@
+export { getParadigmRecommendations, detectParadigmDrift, generateParadigmMigrationPlan, formatParadigmObservations, getMinConfidenceThreshold, getDriftConfidenceThreshold, } from './paradigm-advisor/recommendations.js';
+//# sourceMappingURL=paradigm-advisor.d.ts.map

package/dist/engine/paradigm-advisor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paradigm-advisor.d.ts","sourceRoot":"","sources":["../../src/engine/paradigm-advisor.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,0BAA0B,EAC1B,mBAAmB,EACnB,6BAA6B,EAC7B,0BAA0B,EAC1B,yBAAyB,EACzB,2BAA2B,GAC5B,MAAM,uCAAuC,CAAC"}