@nebutra/next-unicorn-skill 1.0.0

package/dist/checker/peer-dependency-checker.d.ts

@@ -0,0 +1,62 @@
+import type { RecommendedChange } from '../schemas/output.schema.js';
+/**
+ * Resolved peer dependency metadata for a library.
+ * Maps peer dependency name → required version range.
+ */
+export type PeerDependencyMap = Record<string, string>;
+/**
+ * Interface for resolving peer dependency metadata.
+ * Injected for testability — real implementation reads from npm registry or package.json.
+ */
+export interface PeerDependencyResolver {
+    resolve(libraryName: string, version: string): Promise<PeerDependencyMap>;
+}
+export type WarningSeverity = 'conflict' | 'missing' | 'compatible';
+export interface PeerDependencyWarning {
+    recommendedLibrary: string;
+    peerDependency: string;
+    requiredRange: string;
+    installedVersion: string | null;
+    severity: WarningSeverity;
+}
+export interface PeerCheckResult {
+    warnings: PeerDependencyWarning[];
+    recommendations: RecommendedChange[];
+}
+/**
+ * Classify the severity of a peer dependency relationship.
+ *
+ * - If the peer dependency is not installed (undefined), returns "missing"
+ * - If the installed version cannot be coerced to a valid semver, returns "conflict"
+ * - If the installed version satisfies the required range, returns "compatible"
+ * - Otherwise, returns "conflict"
+ *
+ * Requirements: 2.1, 2.2, 2.3
+ */
+export declare function classifySeverity(requiredRange: string, installedVersion: string | undefined): WarningSeverity;
+/**
+ * Escalate migration risk when conflict or missing peer dependencies are detected.
+ *
+ * - If no conflict/missing, preserves current risk
+ * - If current risk is "high", preserves "high"
+ * - Otherwise bumps to "medium"
+ *
+ * Requirements: 3.1, 3.2, 3.3
+ */
+export declare function escalateRisk(currentRisk: 'low' | 'medium' | 'high', hasConflictOrMissing: boolean): 'low' | 'medium' | 'high';
+/**
+ * Check peer dependencies for all recommendations against currentLibraries.
+ *
+ * For each recommendation:
+ * 1. Resolve peer dependency metadata via the resolver
+ * 2. For each peer dep, compare against currentLibraries using semver
+ * 3. Classify as "compatible", "conflict", or "missing"
+ * 4. If any peer dep is "conflict" or "missing", escalate migrationRisk to at least "medium"
+ *
+ * On resolver error for a specific library: catch error, produce zero warnings,
+ * preserve original migrationRisk, and continue processing.
+ *
+ * Requirements: 1.1, 1.2, 2.1, 2.2, 2.3, 2.4, 3.1, 3.2, 3.3
+ */
+export declare function checkPeerDependencies(recommendations: RecommendedChange[], currentLibraries: Record<string, string>, resolver: PeerDependencyResolver): Promise<PeerCheckResult>;
+//# sourceMappingURL=peer-dependency-checker.d.ts.map

package/dist/checker/peer-dependency-checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"peer-dependency-checker.d.ts","sourceRoot":"","sources":["../../src/checker/peer-dependency-checker.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAErE;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEvD;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC3E;AAED,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,SAAS,GAAG,YAAY,CAAC;AAEpE,MAAM,WAAW,qBAAqB;IACpC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,EAAE,eAAe,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,qBAAqB,EAAE,CAAC;IAClC,eAAe,EAAE,iBAAiB,EAAE,CAAC;CACtC;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,aAAa,EAAE,MAAM,EACrB,gBAAgB,EAAE,MAAM,GAAG,SAAS,GACnC,eAAe,CAKjB;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,WAAW,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,EACtC,oBAAoB,EAAE,OAAO,GAC5B,KAAK,GAAG,QAAQ,GAAG,MAAM,CAI3B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,qBAAqB,CACzC,eAAe,EAAE,iBAAiB,EAAE,EACpC,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACxC,QAAQ,EAAE,sBAAsB,GAC/B,OAAO,CAAC,eAAe,CAAC,CA0D1B"}

package/dist/checker/peer-dependency-checker.js

@@ -0,0 +1,94 @@
+import semver from 'semver';
+/**
+ * Classify the severity of a peer dependency relationship.
+ *
+ * - If the peer dependency is not installed (undefined), returns "missing"
+ * - If the installed version cannot be coerced to a valid semver, returns "conflict"
+ * - If the installed version satisfies the required range, returns "compatible"
+ * - Otherwise, returns "conflict"
+ *
+ * Requirements: 2.1, 2.2, 2.3
+ */
+export function classifySeverity(requiredRange, installedVersion) {
+    if (installedVersion === undefined)
+        return 'missing';
+    const coerced = semver.coerce(installedVersion);
+    if (!coerced)
+        return 'conflict';
+    return semver.satisfies(coerced, requiredRange) ? 'compatible' : 'conflict';
+}
+/**
+ * Escalate migration risk when conflict or missing peer dependencies are detected.
+ *
+ * - If no conflict/missing, preserves current risk
+ * - If current risk is "high", preserves "high"
+ * - Otherwise bumps to "medium"
+ *
+ * Requirements: 3.1, 3.2, 3.3
+ */
+export function escalateRisk(currentRisk, hasConflictOrMissing) {
+    if (!hasConflictOrMissing)
+        return currentRisk;
+    if (currentRisk === 'high')
+        return 'high';
+    return 'medium';
+}
+/**
+ * Check peer dependencies for all recommendations against currentLibraries.
+ *
+ * For each recommendation:
+ * 1. Resolve peer dependency metadata via the resolver
+ * 2. For each peer dep, compare against currentLibraries using semver
+ * 3. Classify as "compatible", "conflict", or "missing"
+ * 4. If any peer dep is "conflict" or "missing", escalate migrationRisk to at least "medium"
+ *
+ * On resolver error for a specific library: catch error, produce zero warnings,
+ * preserve original migrationRisk, and continue processing.
+ *
+ * Requirements: 1.1, 1.2, 2.1, 2.2, 2.3, 2.4, 3.1, 3.2, 3.3
+ */
+export async function checkPeerDependencies(recommendations, currentLibraries, resolver) {
+    const allWarnings = [];
+    const updatedRecommendations = [];
+    for (const rec of recommendations) {
+        let peerDeps = {};
+        try {
+            const resolved = await resolver.resolve(rec.recommendedLibrary.name, rec.recommendedLibrary.version);
+            // Validate resolved data — filter out non-string values (malformed data)
+            for (const [key, value] of Object.entries(resolved)) {
+                if (typeof key === 'string' && typeof value === 'string') {
+                    peerDeps[key] = value;
+                }
+            }
+        }
+        catch {
+            // Resolver error: produce zero warnings, preserve original risk, continue
+            updatedRecommendations.push(rec);
+            continue;
+        }
+        const recWarnings = [];
+        for (const [peerName, requiredRange] of Object.entries(peerDeps)) {
+            const installedVersion = currentLibraries[peerName];
+            const severity = classifySeverity(requiredRange, installedVersion);
+            recWarnings.push({
+                recommendedLibrary: rec.recommendedLibrary.name,
+                peerDependency: peerName,
+                requiredRange,
+                installedVersion: installedVersion ?? null,
+                severity,
+            });
+        }
+        const hasConflictOrMissing = recWarnings.some((w) => w.severity === 'conflict' || w.severity === 'missing');
+        const escalatedRisk = escalateRisk(rec.migrationRisk, hasConflictOrMissing);
+        updatedRecommendations.push({
+            ...rec,
+            migrationRisk: escalatedRisk,
+        });
+        allWarnings.push(...recWarnings);
+    }
+    return {
+        warnings: allWarnings,
+        recommendations: updatedRecommendations,
+    };
+}
+//# sourceMappingURL=peer-dependency-checker.js.map

package/dist/checker/peer-dependency-checker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"peer-dependency-checker.js","sourceRoot":"","sources":["../../src/checker/peer-dependency-checker.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAgC5B;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAC9B,aAAqB,EACrB,gBAAoC;IAEpC,IAAI,gBAAgB,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACrD,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAChD,IAAI,CAAC,OAAO;QAAE,OAAO,UAAU,CAAC;IAChC,OAAO,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,UAAU,CAAC;AAC9E,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAC1B,WAAsC,EACtC,oBAA6B;IAE7B,IAAI,CAAC,oBAAoB;QAAE,OAAO,WAAW,CAAC;IAC9C,IAAI,WAAW,KAAK,MAAM;QAAE,OAAO,MAAM,CAAC;IAC1C,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,eAAoC,EACpC,gBAAwC,EACxC,QAAgC;IAEhC,MAAM,WAAW,GAA4B,EAAE,CAAC;IAChD,MAAM,sBAAsB,GAAwB,EAAE,CAAC;IAEvD,KAAK,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QAClC,IAAI,QAAQ,GAAsB,EAAE,CAAC;QAErC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,OAAO,CACrC,GAAG,CAAC,kBAAkB,CAAC,IAAI,EAC3B,GAAG,CAAC,kBAAkB,CAAC,OAAO,CAC/B,CAAC;YAEF,yEAAyE;YACzE,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACpD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;oBACzD,QAAQ,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;gBACxB,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,0EAA0E;YAC1E,sBAAsB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACjC,SAAS;QACX,CAAC;QAED,MAAM,WAAW,GAA4B,EAAE,CAAC;QAEhD,KAAK,MAAM,CAAC,QAAQ,EAAE,aAAa,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YACjE,MAAM,gBAAgB,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;YACpD,MAAM,QAAQ,GAAG,gBAAgB,CAAC,aAAa,EAAE,gBAAgB,CAAC,CAAC;YAEnE,WAAW,CAAC,IAAI,CAAC;gBACf,kBAAkB,EAAE,GAAG,CAAC,kBAAkB,CAAC,IAAI;gBAC/C,cAAc,EAAE,QAAQ;gBACxB,aAAa;gBACb,gBAAgB,EAAE,gBAAgB,IAAI,IAAI;gBAC1C,QAAQ;aACT,CAAC,CAAC;QACL,CAAC;QAED,MAAM,oBAAoB,GAAG,WAAW,CAAC,IAAI,CAC3C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,UAAU,IAAI,CAAC,CAAC,QAAQ,KAAK,SAAS,CAC7D,CAAC;QAEF,MAAM,aAAa,GAAG,YAAY,CAAC,GAAG,CAAC,aAAa,EAAE,oBAAoB,CAAC,CAAC;QAE5E,sBAAsB,CAAC,IAAI,CAAC;YAC1B,GAAG,GAAG;YACN,aAAa,EAAE,aAAa;SAC7B,CAAC,CAAC;QAEH,WAAW,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC;IACnC,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,WAAW;QACrB,eAAe,EAAE,sBAAsB;KACxC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Next-Unicorn SKILL — Analyze and Recommend Third-Party Optimizations
+ *
+ * Scans codebases and recommends replacing hand-rolled implementations
+ * with battle-tested third-party libraries.
+ *
+ * This is the orchestrator that wires the full pipeline:
+ * validate input → scan → verify → score → plan → audit → filter →
+ * vuln scan → auto-update → serialize → PR creation
+ */
+import { OutputSchema } from './schemas/output.schema.js';
+import { type Context7Client } from './verifier/context7.js';
+import { type ExclusionRecord } from './utils/constraint-filter.js';
+import { type PeerDependencyResolver } from './checker/peer-dependency-checker.js';
+import type { VulnerabilityClient } from './security/osv-client.js';
+import type { RegistryClient } from './updater/registry-client.js';
+import type { PlatformClient } from './pr-creator/platform-client.js';
+import type { GitOperations } from './pr-creator/git-operations.js';
+export declare const VERSION = "2.0.0";
+export interface AnalyzeOptions {
+    /** Raw input to be validated against InputSchema */
+    input: unknown;
+    /** Injected Context7 client for testability — no real HTTP calls in tests */
+    context7Client: Context7Client;
+    /** Optional — if provided, enables vulnerability scanning */
+    vulnClient?: VulnerabilityClient;
+    /** Optional — if provided, enables auto-update recommendations */
+    registryClient?: RegistryClient;
+    /** Required only if prPolicy.enabled is true */
+    platformClient?: PlatformClient;
+    /** Required only if prPolicy.enabled is true */
+    gitOps?: GitOperations;
+    /** Optional — if provided, resolves peer dependency metadata for recommended libraries */
+    peerDependencyResolver?: PeerDependencyResolver;
+}
+export type AnalyzeResult = {
+    success: true;
+    output: OutputSchema;
+    json: string;
+    prettyJson: string;
+    exclusions: ExclusionRecord[];
+} | {
+    success: false;
+    error: string;
+    issues?: unknown;
+};
+export type { Context7Client, VerificationResult } from './verifier/context7.js';
+export type { ExclusionRecord } from './utils/constraint-filter.js';
+export type { InputSchema } from './schemas/input.schema.js';
+export type { OutputSchema } from './schemas/output.schema.js';
+export type { VulnerabilityClient } from './security/osv-client.js';
+export type { RegistryClient } from './updater/registry-client.js';
+export type { PlatformClient } from './pr-creator/platform-client.js';
+export type { GitOperations } from './pr-creator/git-operations.js';
+export type { PeerDependencyResolver } from './checker/peer-dependency-checker.js';
+/**
+ * Run the full Next-Unicorn analysis pipeline.
+ *
+ * Pipeline steps:
+ * 1.  Validate input with InputSchema Zod schema
+ * 2.  Scan codebase with scanCodebase
+ * 3.  Verify all detections with Context7
+ * 4.  Score each detection
+ * 5.  Build RecommendedChange objects
+ * 6.  Apply dependency conflict detection
+ * 6.5 Vulnerability scanning (optional — Phase 2)
+ * 7.  Apply license filtering
+ * 8.  Build migration plan
+ * 9.  Audit UX completeness
+ * 10. Auto-update existing dependencies (optional — Phase 2)
+ * 11. Assemble OutputSchema, serialize
+ * 12. PR auto-creation (optional — Phase 2)
+ * 13. Return result
+ *
+ * Requirements: 1.1, 7.3, 10.*, 11.*, 12.*
+ */
+export declare function analyze(options: AnalyzeOptions): Promise<AnalyzeResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EACL,YAAY,EAIb,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,wBAAwB,CAAC;AAIhC,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EAEL,KAAK,sBAAsB,EAE5B,MAAM,sCAAsC,CAAC;AAG9C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAOnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAMpE,eAAO,MAAM,OAAO,UAAU,CAAC;AAM/B,MAAM,WAAW,cAAc;IAC7B,oDAAoD;IACpD,KAAK,EAAE,OAAO,CAAC;IACf,6EAA6E;IAC7E,cAAc,EAAE,cAAc,CAAC;IAC/B,6DAA6D;IAC7D,UAAU,CAAC,EAAE,mBAAmB,CAAC;IACjC,kEAAkE;IAClE,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,gDAAgD;IAChD,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,gDAAgD;IAChD,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,0FAA0F;IAC1F,sBAAsB,CAAC,EAAE,sBAAsB,CAAC;CACjD;AAED,MAAM,MAAM,aAAa,GACrB;IACE,OAAO,EAAE,IAAI,CAAC;IACd,MAAM,EAAE,YAAY,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,eAAe,EAAE,CAAC;CAC/B,GACD;IACE,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAMN,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjF,YAAY,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,YAAY,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,YAAY,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,YAAY,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,YAAY,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,YAAY,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,YAAY,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AACpE,YAAY,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAMnF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAwT7E"}

package/dist/index.js

@@ -0,0 +1,325 @@
+/**
+ * Next-Unicorn SKILL — Analyze and Recommend Third-Party Optimizations
+ *
+ * Scans codebases and recommends replacing hand-rolled implementations
+ * with battle-tested third-party libraries.
+ *
+ * This is the orchestrator that wires the full pipeline:
+ * validate input → scan → verify → score → plan → audit → filter →
+ * vuln scan → auto-update → serialize → PR creation
+ */
+import { ZodError } from 'zod';
+import { InputSchema } from './schemas/input.schema.js';
+import { scanCodebase } from './analyzer/scanner.js';
+import { getPatternCatalog } from './analyzer/pattern-catalog.js';
+import { verifyAllRecommendations, } from './verifier/context7.js';
+import { computeImpactScore } from './scorer/impact-scorer.js';
+import { buildMigrationPlan } from './planner/migration-planner.js';
+import { auditUxCompleteness } from './auditor/ux-auditor.js';
+import { filterByLicense, detectDependencyConflicts, } from './utils/constraint-filter.js';
+import { serializeOutput, prettyPrint } from './utils/serializer.js';
+import { checkPeerDependencies, } from './checker/peer-dependency-checker.js';
+import { scanVulnerabilities } from './security/vulnerability-scanner.js';
+import { applyUpdatePolicy } from './updater/update-policy.js';
+import { verifyChangelog } from './updater/changelog-verifier.js';
+import { scoreUpdate } from './updater/update-scorer.js';
+import { buildUpdatePlan } from './updater/update-plan-builder.js';
+import { planPRs } from './pr-creator/pr-strategy.js';
+import { executePRPlans } from './pr-creator/pr-executor.js';
+// ---------------------------------------------------------------------------
+// Version
+// ---------------------------------------------------------------------------
+export const VERSION = '2.0.0';
+// ---------------------------------------------------------------------------
+// analyze — main orchestrator
+// ---------------------------------------------------------------------------
+/**
+ * Run the full Next-Unicorn analysis pipeline.
+ *
+ * Pipeline steps:
+ * 1.  Validate input with InputSchema Zod schema
+ * 2.  Scan codebase with scanCodebase
+ * 3.  Verify all detections with Context7
+ * 4.  Score each detection
+ * 5.  Build RecommendedChange objects
+ * 6.  Apply dependency conflict detection
+ * 6.5 Vulnerability scanning (optional — Phase 2)
+ * 7.  Apply license filtering
+ * 8.  Build migration plan
+ * 9.  Audit UX completeness
+ * 10. Auto-update existing dependencies (optional — Phase 2)
+ * 11. Assemble OutputSchema, serialize
+ * 12. PR auto-creation (optional — Phase 2)
+ * 13. Return result
+ *
+ * Requirements: 1.1, 7.3, 10.*, 11.*, 12.*
+ */
+export async function analyze(options) {
+    const { input, context7Client } = options;
+    // -------------------------------------------------------------------------
+    // Step 1: Validate input
+    // -------------------------------------------------------------------------
+    let validatedInput;
+    try {
+        validatedInput = InputSchema.parse(input);
+    }
+    catch (err) {
+        if (err instanceof ZodError) {
+            return {
+                success: false,
+                error: `Input validation failed: ${err.errors.map((e) => e.message).join(', ')}`,
+                issues: err.errors,
+            };
+        }
+        return {
+            success: false,
+            error: `Input validation failed: ${String(err)}`,
+        };
+    }
+    // -------------------------------------------------------------------------
+    // Step 2: Scan codebase
+    // -------------------------------------------------------------------------
+    const scanResult = await scanCodebase(validatedInput);
+    // -------------------------------------------------------------------------
+    // Step 3: Verify all detections with Context7
+    // -------------------------------------------------------------------------
+    const verificationMap = await verifyAllRecommendations(context7Client, scanResult.detections);
+    // -------------------------------------------------------------------------
+    // Step 4 & 5: Score each detection and build RecommendedChange objects
+    // -------------------------------------------------------------------------
+    const catalog = getPatternCatalog();
+    const catalogMap = new Map(catalog.map((p) => [p.id, p]));
+    const recommendations = scanResult.detections.map((detection, index) => {
+        const verification = verificationMap.get(index) ?? {
+            status: 'unavailable',
+            note: 'No verification result available',
+        };
+        const scoringOutput = computeImpactScore({
+            detection,
+            verification,
+            weights: validatedInput.impactWeights,
+            priorityFocusAreas: validatedInput.priorityFocusAreas,
+        });
+        // Look up the pattern definition for version and license info
+        const patternDef = catalogMap.get(detection.patternCategory);
+        return {
+            currentImplementation: {
+                filePath: detection.filePath,
+                lineRange: detection.lineRange,
+                patternCategory: detection.patternCategory,
+                confidenceScore: detection.confidenceScore,
+            },
+            recommendedLibrary: {
+                name: detection.suggestedLibrary,
+                version: patternDef?.suggestedVersion ?? 'latest',
+                license: patternDef?.license ?? 'MIT',
+                documentationUrl: verification.documentationUrl,
+            },
+            domain: detection.domain,
+            impactScores: scoringOutput.scores,
+            migrationRisk: scoringOutput.migrationRisk,
+            estimatedEffort: scoringOutput.estimatedEffort,
+            verificationStatus: verification.status,
+            verificationNote: verification.note,
+        };
+    });
+    // -------------------------------------------------------------------------
+    // Step 6: Apply dependency conflict detection
+    // -------------------------------------------------------------------------
+    const conflictChecked = detectDependencyConflicts(recommendations, validatedInput.projectMetadata.currentLibraries);
+    // -------------------------------------------------------------------------
+    // Step 6.25: Check peer dependencies
+    // -------------------------------------------------------------------------
+    let peerWarnings = [];
+    let peerCheckedRecommendations = conflictChecked;
+    try {
+        const resolver = options.peerDependencyResolver ?? {
+            resolve: async () => ({}),
+        };
+        const peerCheckResult = await checkPeerDependencies(conflictChecked, validatedInput.projectMetadata.currentLibraries, resolver);
+        peerWarnings = peerCheckResult.warnings;
+        peerCheckedRecommendations = peerCheckResult.recommendations;
+    }
+    catch {
+        // Unexpected error — fall back to empty warnings and original recommendations
+        peerWarnings = [];
+        peerCheckedRecommendations = conflictChecked;
+    }
+    // -------------------------------------------------------------------------
+    // Step 6.5: Vulnerability scanning (optional — Phase 2)
+    // -------------------------------------------------------------------------
+    let vulnerabilityReport;
+    if (options.vulnClient) {
+        const defaultEcosystem = detectDefaultEcosystem(validatedInput.projectMetadata.packageManagers);
+        const vulnResult = await scanVulnerabilities({
+            currentLibraries: validatedInput.projectMetadata.currentLibraries,
+            recommendedChanges: peerCheckedRecommendations,
+            target: 'both',
+            defaultEcosystem,
+        }, options.vulnClient);
+        vulnerabilityReport = {
+            findings: vulnResult.findings.map((f) => ({
+                source: f.source,
+                packageName: f.packageName,
+                installedVersion: f.installedVersion,
+                ecosystem: f.ecosystem,
+                vulnerabilityId: f.vulnerability.id,
+                aliases: f.vulnerability.aliases,
+                severity: f.vulnerability.severity,
+                cvssScore: f.vulnerability.cvssScore,
+                summary: f.vulnerability.summary,
+                fixAvailable: f.fixAvailable,
+                recommendationIndex: f.recommendationIndex,
+            })),
+            summary: vulnResult.summary,
+            serviceUnavailable: vulnResult.serviceUnavailable,
+        };
+    }
+    // -------------------------------------------------------------------------
+    // Step 7: Apply license filtering
+    // -------------------------------------------------------------------------
+    const { recommendations: filteredRecommendations, exclusions } = filterByLicense(peerCheckedRecommendations, validatedInput.constraints.licenseAllowlist);
+    // -------------------------------------------------------------------------
+    // Step 8: Build migration plan
+    // -------------------------------------------------------------------------
+    const migrationPlan = buildMigrationPlan(filteredRecommendations);
+    // -------------------------------------------------------------------------
+    // Step 9: Audit UX completeness
+    // -------------------------------------------------------------------------
+    const uxAuditResult = auditUxCompleteness(scanResult, validatedInput.projectMetadata);
+    // -------------------------------------------------------------------------
+    // Step 10: Auto-update existing dependencies (optional — Phase 2)
+    // -------------------------------------------------------------------------
+    let updatePlan;
+    if (validatedInput.updatePolicy?.enabled &&
+        options.registryClient) {
+        const policy = validatedInput.updatePolicy;
+        const defaultEcosystem = detectDefaultEcosystem(validatedInput.projectMetadata.packageManagers);
+        try {
+            // Fetch version info for all current libraries
+            const queries = Object.entries(validatedInput.projectMetadata.currentLibraries).map(([name, version]) => ({
+                ecosystem: defaultEcosystem,
+                packageName: name,
+                currentVersion: version,
+            }));
+            const versionInfoMap = await options.registryClient.getVersionInfoBatch(queries);
+            // Apply update policy
+            const candidates = applyUpdatePolicy(versionInfoMap, {
+                defaultStrategy: policy.defaultStrategy,
+                packageOverrides: policy.packageOverrides,
+                maxUpdates: policy.maxUpdates,
+                minAgeDays: policy.minAgeDays,
+                groupRelatedPackages: policy.groupRelatedPackages,
+                pinned: policy.pinned,
+            }, defaultEcosystem);
+            // Verify changelogs via Context7
+            const changelogs = await Promise.all(candidates.map((c) => verifyChangelog(context7Client, c.packageName, c.currentVersion, c.targetVersion)));
+            // Score each update
+            const scores = candidates.map((candidate, index) => scoreUpdate({
+                candidate,
+                changelog: changelogs[index],
+            }));
+            // Build update plan
+            updatePlan = buildUpdatePlan(candidates, scores, changelogs);
+        }
+        catch {
+            // Registry unavailable — skip update plan silently
+            updatePlan = undefined;
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Step 11: Assemble OutputSchema
+    // -------------------------------------------------------------------------
+    // Compute lines saved estimate from deletion checklist
+    const linesSavedEstimate = migrationPlan.deletionChecklist.reduce((total, item) => {
+        if (item.lineRange) {
+            return total + (item.lineRange.end - item.lineRange.start + 1);
+        }
+        return total;
+    }, 0);
+    // Collect files to delete from the deletion checklist
+    const filesToDelete = [
+        ...new Set(migrationPlan.deletionChecklist.map((item) => item.filePath)),
+    ];
+    const output = {
+        recommendedChanges: filteredRecommendations,
+        filesToDelete,
+        linesSavedEstimate,
+        uxAudit: uxAuditResult.items,
+        migrationPlan: {
+            phases: migrationPlan.phases,
+            deletionChecklist: migrationPlan.deletionChecklist,
+            peerDependencyWarnings: peerWarnings,
+        },
+        // Phase 2 optional sections
+        vulnerabilityReport,
+        updatePlan,
+    };
+    // -------------------------------------------------------------------------
+    // Step 12: PR auto-creation (optional — Phase 2)
+    // -------------------------------------------------------------------------
+    if (validatedInput.prPolicy?.enabled &&
+        options.platformClient &&
+        options.gitOps) {
+        const prPolicy = validatedInput.prPolicy;
+        const prPlans = planPRs({
+            output,
+            policy: {
+                enabled: prPolicy.enabled,
+                maxOpenPRs: prPolicy.maxOpenPRs,
+                groupUpdates: prPolicy.groupUpdates,
+                separateSecurityPRs: prPolicy.separateSecurityPRs,
+                createMigrationPRs: prPolicy.createMigrationPRs,
+                labels: prPolicy.labels,
+                reviewers: prPolicy.reviewers,
+                draft: prPolicy.draft,
+                branchPrefix: prPolicy.branchPrefix,
+            },
+        });
+        const prResults = await executePRPlans({
+            plans: prPlans,
+            platformClient: options.platformClient,
+            gitOps: options.gitOps,
+            labels: prPolicy.labels,
+            reviewers: prPolicy.reviewers,
+            draft: prPolicy.draft,
+        });
+        output.pullRequests = prResults;
+    }
+    // -------------------------------------------------------------------------
+    // Step 13: Serialize and return
+    // -------------------------------------------------------------------------
+    const json = serializeOutput(output);
+    const prettyJson = prettyPrint(output);
+    return {
+        success: true,
+        output,
+        json,
+        prettyJson,
+        exclusions,
+    };
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Detect default ecosystem from package manager list.
+ */
+function detectDefaultEcosystem(packageManagers) {
+    const ecosystemMap = {
+        npm: 'npm',
+        pnpm: 'npm',
+        yarn: 'npm',
+        bun: 'npm',
+        pip: 'PyPI',
+        cargo: 'crates.io',
+        go: 'Go',
+    };
+    for (const pm of packageManagers) {
+        const eco = ecosystemMap[pm];
+        if (eco)
+            return eco;
+    }
+    return 'npm';
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

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

@@ -0,0 +1,47 @@
+import type { RecommendedChange, AdapterStrategy } from '../schemas/output.schema.js';
+export interface MigrationPlan {
+    phases: MigrationPhase[];
+    deletionChecklist: DeletionItem[];
+}
+export interface MigrationPhase {
+    phase: number;
+    name: string;
+    steps: MigrationStep[];
+}
+export interface MigrationStep {
+    recommendationIndex: number;
+    description: string;
+    adapterStrategy?: AdapterStrategy;
+}
+export interface DeletionItem {
+    filePath: string;
+    lineRange?: {
+        start: number;
+        end: number;
+    };
+    reason: string;
+}
+/**
+ * Build a phased migration plan from a list of recommendations.
+ *
+ * Phasing logic:
+ * - Phase 1: low-risk items
+ * - Phase 2: medium-risk items
+ * - Phase 3: high-risk items (with adapter strategies)
+ *
+ * Within each phase, items are ordered by composite score descending
+ * (highest impact first).
+ *
+ * Only phases that have items are included (empty phases are skipped).
+ *
+ * High-risk items MUST have an AdapterStrategy generated — if the input
+ * recommendation doesn't already have one, a default is generated.
+ *
+ * The deletion checklist includes EVERY filePath from recommendations.
+ *
+ * Empty recommendations → empty plan with zero phases.
+ *
+ * Requirements: 4.1, 4.2, 4.3, 4.4, 9.4
+ */
+export declare function buildMigrationPlan(recommendations: RecommendedChange[]): MigrationPlan;
+//# sourceMappingURL=migration-planner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"migration-planner.d.ts","sourceRoot":"","sources":["../../src/planner/migration-planner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAMtF,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,iBAAiB,EAAE,YAAY,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,aAAa,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,MAAM,EAAE,MAAM,CAAC;CAChB;AAgBD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,kBAAkB,CAChC,eAAe,EAAE,iBAAiB,EAAE,GACnC,aAAa,CAkDf"}