@nebutra/next-unicorn-skill 1.0.1 → 1.0.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (13) hide show
  1. package/CHANGELOG.md +19 -0
  2. package/README.md +5 -1
  3. package/SKILL.md +69 -16
  4. package/dist/index.d.ts +70 -3
  5. package/dist/index.d.ts.map +1 -1
  6. package/dist/index.js +7 -1
  7. package/dist/index.js.map +1 -1
  8. package/dist/schemas/output.schema.d.ts +483 -48
  9. package/dist/schemas/output.schema.d.ts.map +1 -1
  10. package/dist/schemas/output.schema.js +43 -0
  11. package/dist/schemas/output.schema.js.map +1 -1
  12. package/package.json +1 -1
  13. package/templates/summary-table.md +32 -0
package/dist/schemas/output.schema.d.ts CHANGED
@@ -86,16 +86,67 @@ export declare const RecommendedChange: z.ZodObject<{
86
86
  version: z.ZodString;
87
87
  license: z.ZodString;
88
88
  documentationUrl: z.ZodOptional<z.ZodString>;
89
+ /** WHY this library — AI agent's reasoning */
90
+ rationale: z.ZodOptional<z.ZodString>;
91
+ /** Companion libraries that form a cohesive solution */
92
+ ecosystem: z.ZodOptional<z.ZodArray<z.ZodObject<{
93
+ library: z.ZodString;
94
+ version: z.ZodString;
95
+ role: z.ZodString;
96
+ }, "strip", z.ZodTypeAny, {
97
+ version: string;
98
+ library: string;
99
+ role: string;
100
+ }, {
101
+ version: string;
102
+ library: string;
103
+ role: string;
104
+ }>, "many">>;
105
+ /** What NOT to use, and why */
106
+ antiPatterns: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
107
+ /** Alternative solutions for different architectural contexts */
108
+ alternatives: z.ZodOptional<z.ZodArray<z.ZodObject<{
109
+ library: z.ZodString;
110
+ when: z.ZodString;
111
+ }, "strip", z.ZodTypeAny, {
112
+ library: string;
113
+ when: string;
114
+ }, {
115
+ library: string;
116
+ when: string;
117
+ }>, "many">>;
89
118
  }, "strip", z.ZodTypeAny, {
90
119
  name: string;
91
120
  version: string;
92
121
  license: string;
93
122
  documentationUrl?: string | undefined;
123
+ rationale?: string | undefined;
124
+ ecosystem?: {
125
+ version: string;
126
+ library: string;
127
+ role: string;
128
+ }[] | undefined;
129
+ antiPatterns?: string[] | undefined;
130
+ alternatives?: {
131
+ library: string;
132
+ when: string;
133
+ }[] | undefined;
94
134
  }, {
95
135
  name: string;
96
136
  version: string;
97
137
  license: string;
98
138
  documentationUrl?: string | undefined;
139
+ rationale?: string | undefined;
140
+ ecosystem?: {
141
+ version: string;
142
+ library: string;
143
+ role: string;
144
+ }[] | undefined;
145
+ antiPatterns?: string[] | undefined;
146
+ alternatives?: {
147
+ library: string;
148
+ when: string;
149
+ }[] | undefined;
99
150
  }>;
100
151
  domain: z.ZodString;
101
152
  impactScores: z.ZodObject<{
@@ -161,6 +212,17 @@ export declare const RecommendedChange: z.ZodObject<{
161
212
  version: string;
162
213
  license: string;
163
214
  documentationUrl?: string | undefined;
215
+ rationale?: string | undefined;
216
+ ecosystem?: {
217
+ version: string;
218
+ library: string;
219
+ role: string;
220
+ }[] | undefined;
221
+ antiPatterns?: string[] | undefined;
222
+ alternatives?: {
223
+ library: string;
224
+ when: string;
225
+ }[] | undefined;
164
226
  };
165
227
  domain: string;
166
228
  impactScores: {
@@ -198,6 +260,17 @@ export declare const RecommendedChange: z.ZodObject<{
198
260
  version: string;
199
261
  license: string;
200
262
  documentationUrl?: string | undefined;
263
+ rationale?: string | undefined;
264
+ ecosystem?: {
265
+ version: string;
266
+ library: string;
267
+ role: string;
268
+ }[] | undefined;
269
+ antiPatterns?: string[] | undefined;
270
+ alternatives?: {
271
+ library: string;
272
+ when: string;
273
+ }[] | undefined;
201
274
  };
202
275
  domain: string;
203
276
  impactScores: {
@@ -230,15 +303,15 @@ export declare const UxAuditItem: z.ZodObject<{
230
303
  rationale: z.ZodString;
231
304
  }, "strip", z.ZodTypeAny, {
232
305
  status: "present" | "partial" | "missing";
306
+ rationale: string;
233
307
  category: "accessibility" | "error-states" | "empty-states" | "loading-states" | "form-validation" | "performance-feel" | "copy-consistency" | "design-system-alignment";
234
308
  filePaths: string[];
235
- rationale: string;
236
309
  recommendedLibrary?: string | undefined;
237
310
  }, {
238
311
  status: "present" | "partial" | "missing";
312
+ rationale: string;
239
313
  category: "accessibility" | "error-states" | "empty-states" | "loading-states" | "form-validation" | "performance-feel" | "copy-consistency" | "design-system-alignment";
240
314
  filePaths: string[];
241
- rationale: string;
242
315
  recommendedLibrary?: string | undefined;
243
316
  }>;
244
317
  export type UxAuditItem = z.infer<typeof UxAuditItem>;
@@ -348,11 +421,11 @@ export declare const VulnFindingSchema: z.ZodObject<{
348
421
  fixAvailable: z.ZodNullable<z.ZodString>;
349
422
  recommendationIndex: z.ZodOptional<z.ZodNumber>;
350
423
  }, "strip", z.ZodTypeAny, {
424
+ ecosystem: string;
351
425
  installedVersion: string;
352
426
  severity: "unknown" | "low" | "medium" | "high" | "critical";
353
427
  source: "current" | "recommended";
354
428
  packageName: string;
355
- ecosystem: string;
356
429
  vulnerabilityId: string;
357
430
  aliases: string[];
358
431
  cvssScore: number | null;
@@ -360,11 +433,11 @@ export declare const VulnFindingSchema: z.ZodObject<{
360
433
  fixAvailable: string | null;
361
434
  recommendationIndex?: number | undefined;
362
435
  }, {
436
+ ecosystem: string;
363
437
  installedVersion: string;
364
438
  severity: "unknown" | "low" | "medium" | "high" | "critical";
365
439
  source: "current" | "recommended";
366
440
  packageName: string;
367
- ecosystem: string;
368
441
  vulnerabilityId: string;
369
442
  cvssScore: number | null;
370
443
  summary: string;
@@ -419,11 +492,11 @@ export declare const VulnReportSchema: z.ZodObject<{
419
492
  fixAvailable: z.ZodNullable<z.ZodString>;
420
493
  recommendationIndex: z.ZodOptional<z.ZodNumber>;
421
494
  }, "strip", z.ZodTypeAny, {
495
+ ecosystem: string;
422
496
  installedVersion: string;
423
497
  severity: "unknown" | "low" | "medium" | "high" | "critical";
424
498
  source: "current" | "recommended";
425
499
  packageName: string;
426
- ecosystem: string;
427
500
  vulnerabilityId: string;
428
501
  aliases: string[];
429
502
  cvssScore: number | null;
@@ -431,11 +504,11 @@ export declare const VulnReportSchema: z.ZodObject<{
431
504
  fixAvailable: string | null;
432
505
  recommendationIndex?: number | undefined;
433
506
  }, {
507
+ ecosystem: string;
434
508
  installedVersion: string;
435
509
  severity: "unknown" | "low" | "medium" | "high" | "critical";
436
510
  source: "current" | "recommended";
437
511
  packageName: string;
438
- ecosystem: string;
439
512
  vulnerabilityId: string;
440
513
  cvssScore: number | null;
441
514
  summary: string;
@@ -488,11 +561,11 @@ export declare const VulnReportSchema: z.ZodObject<{
488
561
  unfixable: number;
489
562
  };
490
563
  findings: {
564
+ ecosystem: string;
491
565
  installedVersion: string;
492
566
  severity: "unknown" | "low" | "medium" | "high" | "critical";
493
567
  source: "current" | "recommended";
494
568
  packageName: string;
495
- ecosystem: string;
496
569
  vulnerabilityId: string;
497
570
  aliases: string[];
498
571
  cvssScore: number | null;
@@ -514,11 +587,11 @@ export declare const VulnReportSchema: z.ZodObject<{
514
587
  unfixable: number;
515
588
  };
516
589
  findings: {
590
+ ecosystem: string;
517
591
  installedVersion: string;
518
592
  severity: "unknown" | "low" | "medium" | "high" | "critical";
519
593
  source: "current" | "recommended";
520
594
  packageName: string;
521
- ecosystem: string;
522
595
  vulnerabilityId: string;
523
596
  cvssScore: number | null;
524
597
  summary: string;
@@ -577,6 +650,7 @@ export declare const UpdateItemSchema: z.ZodObject<{
577
650
  vulnFixCount: z.ZodNumber;
578
651
  groupKey: z.ZodOptional<z.ZodString>;
579
652
  }, "strip", z.ZodTypeAny, {
653
+ ecosystem: string;
580
654
  impactScores: {
581
655
  scalability: number;
582
656
  performance: number;
@@ -589,7 +663,6 @@ export declare const UpdateItemSchema: z.ZodObject<{
589
663
  };
590
664
  estimatedEffort: number;
591
665
  packageName: string;
592
- ecosystem: string;
593
666
  currentVersion: string;
594
667
  targetVersion: string;
595
668
  updateType: "patch" | "minor" | "major";
@@ -600,6 +673,7 @@ export declare const UpdateItemSchema: z.ZodObject<{
600
673
  breakingChangeSummary?: string | undefined;
601
674
  groupKey?: string | undefined;
602
675
  }, {
676
+ ecosystem: string;
603
677
  impactScores: {
604
678
  scalability: number;
605
679
  performance: number;
@@ -612,7 +686,6 @@ export declare const UpdateItemSchema: z.ZodObject<{
612
686
  };
613
687
  estimatedEffort: number;
614
688
  packageName: string;
615
- ecosystem: string;
616
689
  currentVersion: string;
617
690
  targetVersion: string;
618
691
  updateType: "patch" | "minor" | "major";
@@ -668,6 +741,7 @@ export declare const UpdateGroupSchema: z.ZodObject<{
668
741
  vulnFixCount: z.ZodNumber;
669
742
  groupKey: z.ZodOptional<z.ZodString>;
670
743
  }, "strip", z.ZodTypeAny, {
744
+ ecosystem: string;
671
745
  impactScores: {
672
746
  scalability: number;
673
747
  performance: number;
@@ -680,7 +754,6 @@ export declare const UpdateGroupSchema: z.ZodObject<{
680
754
  };
681
755
  estimatedEffort: number;
682
756
  packageName: string;
683
- ecosystem: string;
684
757
  currentVersion: string;
685
758
  targetVersion: string;
686
759
  updateType: "patch" | "minor" | "major";
@@ -691,6 +764,7 @@ export declare const UpdateGroupSchema: z.ZodObject<{
691
764
  breakingChangeSummary?: string | undefined;
692
765
  groupKey?: string | undefined;
693
766
  }, {
767
+ ecosystem: string;
694
768
  impactScores: {
695
769
  scalability: number;
696
770
  performance: number;
@@ -703,7 +777,6 @@ export declare const UpdateGroupSchema: z.ZodObject<{
703
777
  };
704
778
  estimatedEffort: number;
705
779
  packageName: string;
706
- ecosystem: string;
707
780
  currentVersion: string;
708
781
  targetVersion: string;
709
782
  updateType: "patch" | "minor" | "major";
@@ -719,6 +792,7 @@ export declare const UpdateGroupSchema: z.ZodObject<{
719
792
  urgency: "critical" | "recommended" | "routine" | "urgent";
720
793
  groupKey: string;
721
794
  items: {
795
+ ecosystem: string;
722
796
  impactScores: {
723
797
  scalability: number;
724
798
  performance: number;
@@ -731,7 +805,6 @@ export declare const UpdateGroupSchema: z.ZodObject<{
731
805
  };
732
806
  estimatedEffort: number;
733
807
  packageName: string;
734
- ecosystem: string;
735
808
  currentVersion: string;
736
809
  targetVersion: string;
737
810
  updateType: "patch" | "minor" | "major";
@@ -746,6 +819,7 @@ export declare const UpdateGroupSchema: z.ZodObject<{
746
819
  urgency: "critical" | "recommended" | "routine" | "urgent";
747
820
  groupKey: string;
748
821
  items: {
822
+ ecosystem: string;
749
823
  impactScores: {
750
824
  scalability: number;
751
825
  performance: number;
@@ -758,7 +832,6 @@ export declare const UpdateGroupSchema: z.ZodObject<{
758
832
  };
759
833
  estimatedEffort: number;
760
834
  packageName: string;
761
- ecosystem: string;
762
835
  currentVersion: string;
763
836
  targetVersion: string;
764
837
  updateType: "patch" | "minor" | "major";
@@ -814,6 +887,7 @@ export declare const UpdatePlanSchema: z.ZodObject<{
814
887
  vulnFixCount: z.ZodNumber;
815
888
  groupKey: z.ZodOptional<z.ZodString>;
816
889
  }, "strip", z.ZodTypeAny, {
890
+ ecosystem: string;
817
891
  impactScores: {
818
892
  scalability: number;
819
893
  performance: number;
@@ -826,7 +900,6 @@ export declare const UpdatePlanSchema: z.ZodObject<{
826
900
  };
827
901
  estimatedEffort: number;
828
902
  packageName: string;
829
- ecosystem: string;
830
903
  currentVersion: string;
831
904
  targetVersion: string;
832
905
  updateType: "patch" | "minor" | "major";
@@ -837,6 +910,7 @@ export declare const UpdatePlanSchema: z.ZodObject<{
837
910
  breakingChangeSummary?: string | undefined;
838
911
  groupKey?: string | undefined;
839
912
  }, {
913
+ ecosystem: string;
840
914
  impactScores: {
841
915
  scalability: number;
842
916
  performance: number;
@@ -849,7 +923,6 @@ export declare const UpdatePlanSchema: z.ZodObject<{
849
923
  };
850
924
  estimatedEffort: number;
851
925
  packageName: string;
852
- ecosystem: string;
853
926
  currentVersion: string;
854
927
  targetVersion: string;
855
928
  updateType: "patch" | "minor" | "major";
@@ -904,6 +977,7 @@ export declare const UpdatePlanSchema: z.ZodObject<{
904
977
  vulnFixCount: z.ZodNumber;
905
978
  groupKey: z.ZodOptional<z.ZodString>;
906
979
  }, "strip", z.ZodTypeAny, {
980
+ ecosystem: string;
907
981
  impactScores: {
908
982
  scalability: number;
909
983
  performance: number;
@@ -916,7 +990,6 @@ export declare const UpdatePlanSchema: z.ZodObject<{
916
990
  };
917
991
  estimatedEffort: number;
918
992
  packageName: string;
919
- ecosystem: string;
920
993
  currentVersion: string;
921
994
  targetVersion: string;
922
995
  updateType: "patch" | "minor" | "major";
@@ -927,6 +1000,7 @@ export declare const UpdatePlanSchema: z.ZodObject<{
927
1000
  breakingChangeSummary?: string | undefined;
928
1001
  groupKey?: string | undefined;
929
1002
  }, {
1003
+ ecosystem: string;
930
1004
  impactScores: {
931
1005
  scalability: number;
932
1006
  performance: number;
@@ -939,7 +1013,6 @@ export declare const UpdatePlanSchema: z.ZodObject<{
939
1013
  };
940
1014
  estimatedEffort: number;
941
1015
  packageName: string;
942
- ecosystem: string;
943
1016
  currentVersion: string;
944
1017
  targetVersion: string;
945
1018
  updateType: "patch" | "minor" | "major";
@@ -955,6 +1028,7 @@ export declare const UpdatePlanSchema: z.ZodObject<{
955
1028
  urgency: "critical" | "recommended" | "routine" | "urgent";
956
1029
  groupKey: string;
957
1030
  items: {
1031
+ ecosystem: string;
958
1032
  impactScores: {
959
1033
  scalability: number;
960
1034
  performance: number;
@@ -967,7 +1041,6 @@ export declare const UpdatePlanSchema: z.ZodObject<{
967
1041
  };
968
1042
  estimatedEffort: number;
969
1043
  packageName: string;
970
- ecosystem: string;
971
1044
  currentVersion: string;
972
1045
  targetVersion: string;
973
1046
  updateType: "patch" | "minor" | "major";
@@ -982,6 +1055,7 @@ export declare const UpdatePlanSchema: z.ZodObject<{
982
1055
  urgency: "critical" | "recommended" | "routine" | "urgent";
983
1056
  groupKey: string;
984
1057
  items: {
1058
+ ecosystem: string;
985
1059
  impactScores: {
986
1060
  scalability: number;
987
1061
  performance: number;
@@ -994,7 +1068,6 @@ export declare const UpdatePlanSchema: z.ZodObject<{
994
1068
  };
995
1069
  estimatedEffort: number;
996
1070
  packageName: string;
997
- ecosystem: string;
998
1071
  currentVersion: string;
999
1072
  targetVersion: string;
1000
1073
  updateType: "patch" | "minor" | "major";
@@ -1038,6 +1111,7 @@ export declare const UpdatePlanSchema: z.ZodObject<{
1038
1111
  estimatedTotalEffort: number;
1039
1112
  };
1040
1113
  updates: {
1114
+ ecosystem: string;
1041
1115
  impactScores: {
1042
1116
  scalability: number;
1043
1117
  performance: number;
@@ -1050,7 +1124,6 @@ export declare const UpdatePlanSchema: z.ZodObject<{
1050
1124
  };
1051
1125
  estimatedEffort: number;
1052
1126
  packageName: string;
1053
- ecosystem: string;
1054
1127
  currentVersion: string;
1055
1128
  targetVersion: string;
1056
1129
  updateType: "patch" | "minor" | "major";
@@ -1065,6 +1138,7 @@ export declare const UpdatePlanSchema: z.ZodObject<{
1065
1138
  urgency: "critical" | "recommended" | "routine" | "urgent";
1066
1139
  groupKey: string;
1067
1140
  items: {
1141
+ ecosystem: string;
1068
1142
  impactScores: {
1069
1143
  scalability: number;
1070
1144
  performance: number;
@@ -1077,7 +1151,6 @@ export declare const UpdatePlanSchema: z.ZodObject<{
1077
1151
  };
1078
1152
  estimatedEffort: number;
1079
1153
  packageName: string;
1080
- ecosystem: string;
1081
1154
  currentVersion: string;
1082
1155
  targetVersion: string;
1083
1156
  updateType: "patch" | "minor" | "major";
@@ -1099,6 +1172,7 @@ export declare const UpdatePlanSchema: z.ZodObject<{
1099
1172
  estimatedTotalEffort: number;
1100
1173
  };
1101
1174
  updates: {
1175
+ ecosystem: string;
1102
1176
  impactScores: {
1103
1177
  scalability: number;
1104
1178
  performance: number;
@@ -1111,7 +1185,6 @@ export declare const UpdatePlanSchema: z.ZodObject<{
1111
1185
  };
1112
1186
  estimatedEffort: number;
1113
1187
  packageName: string;
1114
- ecosystem: string;
1115
1188
  currentVersion: string;
1116
1189
  targetVersion: string;
1117
1190
  updateType: "patch" | "minor" | "major";
@@ -1126,6 +1199,7 @@ export declare const UpdatePlanSchema: z.ZodObject<{
1126
1199
  urgency: "critical" | "recommended" | "routine" | "urgent";
1127
1200
  groupKey: string;
1128
1201
  items: {
1202
+ ecosystem: string;
1129
1203
  impactScores: {
1130
1204
  scalability: number;
1131
1205
  performance: number;
@@ -1138,7 +1212,6 @@ export declare const UpdatePlanSchema: z.ZodObject<{
1138
1212
  };
1139
1213
  estimatedEffort: number;
1140
1214
  packageName: string;
1141
- ecosystem: string;
1142
1215
  currentVersion: string;
1143
1216
  targetVersion: string;
1144
1217
  updateType: "patch" | "minor" | "major";
@@ -1205,6 +1278,119 @@ export declare const PRSummarySchema: z.ZodObject<{
1205
1278
  totalPlanned: number;
1206
1279
  }>;
1207
1280
  export type PRSummary = z.infer<typeof PRSummarySchema>;
1281
+ export declare const GapPriority: z.ZodEnum<["critical", "recommended", "nice-to-have"]>;
1282
+ export type GapPriority = z.infer<typeof GapPriority>;
1283
+ export declare const GapRecommendationSchema: z.ZodObject<{
1284
+ domain: z.ZodString;
1285
+ description: z.ZodString;
1286
+ recommendedLibrary: z.ZodObject<{
1287
+ name: z.ZodString;
1288
+ version: z.ZodString;
1289
+ license: z.ZodString;
1290
+ documentationUrl: z.ZodOptional<z.ZodString>;
1291
+ rationale: z.ZodOptional<z.ZodString>;
1292
+ ecosystem: z.ZodOptional<z.ZodArray<z.ZodObject<{
1293
+ library: z.ZodString;
1294
+ version: z.ZodString;
1295
+ role: z.ZodString;
1296
+ }, "strip", z.ZodTypeAny, {
1297
+ version: string;
1298
+ library: string;
1299
+ role: string;
1300
+ }, {
1301
+ version: string;
1302
+ library: string;
1303
+ role: string;
1304
+ }>, "many">>;
1305
+ antiPatterns: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1306
+ alternatives: z.ZodOptional<z.ZodArray<z.ZodObject<{
1307
+ library: z.ZodString;
1308
+ when: z.ZodString;
1309
+ }, "strip", z.ZodTypeAny, {
1310
+ library: string;
1311
+ when: string;
1312
+ }, {
1313
+ library: string;
1314
+ when: string;
1315
+ }>, "many">>;
1316
+ }, "strip", z.ZodTypeAny, {
1317
+ name: string;
1318
+ version: string;
1319
+ license: string;
1320
+ documentationUrl?: string | undefined;
1321
+ rationale?: string | undefined;
1322
+ ecosystem?: {
1323
+ version: string;
1324
+ library: string;
1325
+ role: string;
1326
+ }[] | undefined;
1327
+ antiPatterns?: string[] | undefined;
1328
+ alternatives?: {
1329
+ library: string;
1330
+ when: string;
1331
+ }[] | undefined;
1332
+ }, {
1333
+ name: string;
1334
+ version: string;
1335
+ license: string;
1336
+ documentationUrl?: string | undefined;
1337
+ rationale?: string | undefined;
1338
+ ecosystem?: {
1339
+ version: string;
1340
+ library: string;
1341
+ role: string;
1342
+ }[] | undefined;
1343
+ antiPatterns?: string[] | undefined;
1344
+ alternatives?: {
1345
+ library: string;
1346
+ when: string;
1347
+ }[] | undefined;
1348
+ }>;
1349
+ priority: z.ZodEnum<["critical", "recommended", "nice-to-have"]>;
1350
+ }, "strip", z.ZodTypeAny, {
1351
+ description: string;
1352
+ recommendedLibrary: {
1353
+ name: string;
1354
+ version: string;
1355
+ license: string;
1356
+ documentationUrl?: string | undefined;
1357
+ rationale?: string | undefined;
1358
+ ecosystem?: {
1359
+ version: string;
1360
+ library: string;
1361
+ role: string;
1362
+ }[] | undefined;
1363
+ antiPatterns?: string[] | undefined;
1364
+ alternatives?: {
1365
+ library: string;
1366
+ when: string;
1367
+ }[] | undefined;
1368
+ };
1369
+ domain: string;
1370
+ priority: "critical" | "recommended" | "nice-to-have";
1371
+ }, {
1372
+ description: string;
1373
+ recommendedLibrary: {
1374
+ name: string;
1375
+ version: string;
1376
+ license: string;
1377
+ documentationUrl?: string | undefined;
1378
+ rationale?: string | undefined;
1379
+ ecosystem?: {
1380
+ version: string;
1381
+ library: string;
1382
+ role: string;
1383
+ }[] | undefined;
1384
+ antiPatterns?: string[] | undefined;
1385
+ alternatives?: {
1386
+ library: string;
1387
+ when: string;
1388
+ }[] | undefined;
1389
+ };
1390
+ domain: string;
1391
+ priority: "critical" | "recommended" | "nice-to-have";
1392
+ }>;
1393
+ export type GapRecommendation = z.infer<typeof GapRecommendationSchema>;
1208
1394
  export declare const OutputSchema: z.ZodObject<{
1209
1395
  recommendedChanges: z.ZodArray<z.ZodObject<{
1210
1396
  currentImplementation: z.ZodObject<{
@@ -1243,16 +1429,67 @@ export declare const OutputSchema: z.ZodObject<{
1243
1429
  version: z.ZodString;
1244
1430
  license: z.ZodString;
1245
1431
  documentationUrl: z.ZodOptional<z.ZodString>;
1432
+ /** WHY this library — AI agent's reasoning */
1433
+ rationale: z.ZodOptional<z.ZodString>;
1434
+ /** Companion libraries that form a cohesive solution */
1435
+ ecosystem: z.ZodOptional<z.ZodArray<z.ZodObject<{
1436
+ library: z.ZodString;
1437
+ version: z.ZodString;
1438
+ role: z.ZodString;
1439
+ }, "strip", z.ZodTypeAny, {
1440
+ version: string;
1441
+ library: string;
1442
+ role: string;
1443
+ }, {
1444
+ version: string;
1445
+ library: string;
1446
+ role: string;
1447
+ }>, "many">>;
1448
+ /** What NOT to use, and why */
1449
+ antiPatterns: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1450
+ /** Alternative solutions for different architectural contexts */
1451
+ alternatives: z.ZodOptional<z.ZodArray<z.ZodObject<{
1452
+ library: z.ZodString;
1453
+ when: z.ZodString;
1454
+ }, "strip", z.ZodTypeAny, {
1455
+ library: string;
1456
+ when: string;
1457
+ }, {
1458
+ library: string;
1459
+ when: string;
1460
+ }>, "many">>;
1246
1461
  }, "strip", z.ZodTypeAny, {
1247
1462
  name: string;
1248
1463
  version: string;
1249
1464
  license: string;
1250
1465
  documentationUrl?: string | undefined;
1466
+ rationale?: string | undefined;
1467
+ ecosystem?: {
1468
+ version: string;
1469
+ library: string;
1470
+ role: string;
1471
+ }[] | undefined;
1472
+ antiPatterns?: string[] | undefined;
1473
+ alternatives?: {
1474
+ library: string;
1475
+ when: string;
1476
+ }[] | undefined;
1251
1477
  }, {
1252
1478
  name: string;
1253
1479
  version: string;
1254
1480
  license: string;
1255
1481
  documentationUrl?: string | undefined;
1482
+ rationale?: string | undefined;
1483
+ ecosystem?: {
1484
+ version: string;
1485
+ library: string;
1486
+ role: string;
1487
+ }[] | undefined;
1488
+ antiPatterns?: string[] | undefined;
1489
+ alternatives?: {
1490
+ library: string;
1491
+ when: string;
1492
+ }[] | undefined;
1256
1493
  }>;
1257
1494
  domain: z.ZodString;
1258
1495
  impactScores: z.ZodObject<{
@@ -1318,6 +1555,17 @@ export declare const OutputSchema: z.ZodObject<{
1318
1555
  version: string;
1319
1556
  license: string;
1320
1557
  documentationUrl?: string | undefined;
1558
+ rationale?: string | undefined;
1559
+ ecosystem?: {
1560
+ version: string;
1561
+ library: string;
1562
+ role: string;
1563
+ }[] | undefined;
1564
+ antiPatterns?: string[] | undefined;
1565
+ alternatives?: {
1566
+ library: string;
1567
+ when: string;
1568
+ }[] | undefined;
1321
1569
  };
1322
1570
  domain: string;
1323
1571
  impactScores: {
@@ -1355,6 +1603,17 @@ export declare const OutputSchema: z.ZodObject<{
1355
1603
  version: string;
1356
1604
  license: string;
1357
1605
  documentationUrl?: string | undefined;
1606
+ rationale?: string | undefined;
1607
+ ecosystem?: {
1608
+ version: string;
1609
+ library: string;
1610
+ role: string;
1611
+ }[] | undefined;
1612
+ antiPatterns?: string[] | undefined;
1613
+ alternatives?: {
1614
+ library: string;
1615
+ when: string;
1616
+ }[] | undefined;
1358
1617
  };
1359
1618
  domain: string;
1360
1619
  impactScores: {
@@ -1388,15 +1647,15 @@ export declare const OutputSchema: z.ZodObject<{
1388
1647
  rationale: z.ZodString;
1389
1648
  }, "strip", z.ZodTypeAny, {
1390
1649
  status: "present" | "partial" | "missing";
1650
+ rationale: string;
1391
1651
  category: "accessibility" | "error-states" | "empty-states" | "loading-states" | "form-validation" | "performance-feel" | "copy-consistency" | "design-system-alignment";
1392
1652
  filePaths: string[];
1393
- rationale: string;
1394
1653
  recommendedLibrary?: string | undefined;
1395
1654
  }, {
1396
1655
  status: "present" | "partial" | "missing";
1656
+ rationale: string;
1397
1657
  category: "accessibility" | "error-states" | "empty-states" | "loading-states" | "form-validation" | "performance-feel" | "copy-consistency" | "design-system-alignment";
1398
1658
  filePaths: string[];
1399
- rationale: string;
1400
1659
  recommendedLibrary?: string | undefined;
1401
1660
  }>, "many">;
1402
1661
  migrationPlan: z.ZodObject<{
@@ -1576,6 +1835,116 @@ export declare const OutputSchema: z.ZodObject<{
1576
1835
  severity: "missing" | "conflict" | "compatible";
1577
1836
  }[];
1578
1837
  }>;
1838
+ gapAnalysis: z.ZodOptional<z.ZodArray<z.ZodObject<{
1839
+ domain: z.ZodString;
1840
+ description: z.ZodString;
1841
+ recommendedLibrary: z.ZodObject<{
1842
+ name: z.ZodString;
1843
+ version: z.ZodString;
1844
+ license: z.ZodString;
1845
+ documentationUrl: z.ZodOptional<z.ZodString>;
1846
+ rationale: z.ZodOptional<z.ZodString>;
1847
+ ecosystem: z.ZodOptional<z.ZodArray<z.ZodObject<{
1848
+ library: z.ZodString;
1849
+ version: z.ZodString;
1850
+ role: z.ZodString;
1851
+ }, "strip", z.ZodTypeAny, {
1852
+ version: string;
1853
+ library: string;
1854
+ role: string;
1855
+ }, {
1856
+ version: string;
1857
+ library: string;
1858
+ role: string;
1859
+ }>, "many">>;
1860
+ antiPatterns: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
1861
+ alternatives: z.ZodOptional<z.ZodArray<z.ZodObject<{
1862
+ library: z.ZodString;
1863
+ when: z.ZodString;
1864
+ }, "strip", z.ZodTypeAny, {
1865
+ library: string;
1866
+ when: string;
1867
+ }, {
1868
+ library: string;
1869
+ when: string;
1870
+ }>, "many">>;
1871
+ }, "strip", z.ZodTypeAny, {
1872
+ name: string;
1873
+ version: string;
1874
+ license: string;
1875
+ documentationUrl?: string | undefined;
1876
+ rationale?: string | undefined;
1877
+ ecosystem?: {
1878
+ version: string;
1879
+ library: string;
1880
+ role: string;
1881
+ }[] | undefined;
1882
+ antiPatterns?: string[] | undefined;
1883
+ alternatives?: {
1884
+ library: string;
1885
+ when: string;
1886
+ }[] | undefined;
1887
+ }, {
1888
+ name: string;
1889
+ version: string;
1890
+ license: string;
1891
+ documentationUrl?: string | undefined;
1892
+ rationale?: string | undefined;
1893
+ ecosystem?: {
1894
+ version: string;
1895
+ library: string;
1896
+ role: string;
1897
+ }[] | undefined;
1898
+ antiPatterns?: string[] | undefined;
1899
+ alternatives?: {
1900
+ library: string;
1901
+ when: string;
1902
+ }[] | undefined;
1903
+ }>;
1904
+ priority: z.ZodEnum<["critical", "recommended", "nice-to-have"]>;
1905
+ }, "strip", z.ZodTypeAny, {
1906
+ description: string;
1907
+ recommendedLibrary: {
1908
+ name: string;
1909
+ version: string;
1910
+ license: string;
1911
+ documentationUrl?: string | undefined;
1912
+ rationale?: string | undefined;
1913
+ ecosystem?: {
1914
+ version: string;
1915
+ library: string;
1916
+ role: string;
1917
+ }[] | undefined;
1918
+ antiPatterns?: string[] | undefined;
1919
+ alternatives?: {
1920
+ library: string;
1921
+ when: string;
1922
+ }[] | undefined;
1923
+ };
1924
+ domain: string;
1925
+ priority: "critical" | "recommended" | "nice-to-have";
1926
+ }, {
1927
+ description: string;
1928
+ recommendedLibrary: {
1929
+ name: string;
1930
+ version: string;
1931
+ license: string;
1932
+ documentationUrl?: string | undefined;
1933
+ rationale?: string | undefined;
1934
+ ecosystem?: {
1935
+ version: string;
1936
+ library: string;
1937
+ role: string;
1938
+ }[] | undefined;
1939
+ antiPatterns?: string[] | undefined;
1940
+ alternatives?: {
1941
+ library: string;
1942
+ when: string;
1943
+ }[] | undefined;
1944
+ };
1945
+ domain: string;
1946
+ priority: "critical" | "recommended" | "nice-to-have";
1947
+ }>, "many">>;
1579
1948
  vulnerabilityReport: z.ZodOptional<z.ZodObject<{
1580
1949
  findings: z.ZodArray<z.ZodObject<{
1581
1950
  source: z.ZodEnum<["current", "recommended"]>;
@@ -1590,11 +1959,11 @@ export declare const OutputSchema: z.ZodObject<{
1590
1959
  fixAvailable: z.ZodNullable<z.ZodString>;
1591
1960
  recommendationIndex: z.ZodOptional<z.ZodNumber>;
1592
1961
  }, "strip", z.ZodTypeAny, {
1962
+ ecosystem: string;
1593
1963
  installedVersion: string;
1594
1964
  severity: "unknown" | "low" | "medium" | "high" | "critical";
1595
1965
  source: "current" | "recommended";
1596
1966
  packageName: string;
1597
- ecosystem: string;
1598
1967
  vulnerabilityId: string;
1599
1968
  aliases: string[];
1600
1969
  cvssScore: number | null;
@@ -1602,11 +1971,11 @@ export declare const OutputSchema: z.ZodObject<{
1602
1971
  fixAvailable: string | null;
1603
1972
  recommendationIndex?: number | undefined;
1604
1973
  }, {
1974
+ ecosystem: string;
1605
1975
  installedVersion: string;
1606
1976
  severity: "unknown" | "low" | "medium" | "high" | "critical";
1607
1977
  source: "current" | "recommended";
1608
1978
  packageName: string;
1609
- ecosystem: string;
1610
1979
  vulnerabilityId: string;
1611
1980
  cvssScore: number | null;
1612
1981
  summary: string;
@@ -1659,11 +2028,11 @@ export declare const OutputSchema: z.ZodObject<{
1659
2028
  unfixable: number;
1660
2029
  };
1661
2030
  findings: {
2031
+ ecosystem: string;
1662
2032
  installedVersion: string;
1663
2033
  severity: "unknown" | "low" | "medium" | "high" | "critical";
1664
2034
  source: "current" | "recommended";
1665
2035
  packageName: string;
1666
- ecosystem: string;
1667
2036
  vulnerabilityId: string;
1668
2037
  aliases: string[];
1669
2038
  cvssScore: number | null;
@@ -1685,11 +2054,11 @@ export declare const OutputSchema: z.ZodObject<{
1685
2054
  unfixable: number;
1686
2055
  };
1687
2056
  findings: {
2057
+ ecosystem: string;
1688
2058
  installedVersion: string;
1689
2059
  severity: "unknown" | "low" | "medium" | "high" | "critical";
1690
2060
  source: "current" | "recommended";
1691
2061
  packageName: string;
1692
- ecosystem: string;
1693
2062
  vulnerabilityId: string;
1694
2063
  cvssScore: number | null;
1695
2064
  summary: string;
@@ -1742,6 +2111,7 @@ export declare const OutputSchema: z.ZodObject<{
1742
2111
  vulnFixCount: z.ZodNumber;
1743
2112
  groupKey: z.ZodOptional<z.ZodString>;
1744
2113
  }, "strip", z.ZodTypeAny, {
2114
+ ecosystem: string;
1745
2115
  impactScores: {
1746
2116
  scalability: number;
1747
2117
  performance: number;
@@ -1754,7 +2124,6 @@ export declare const OutputSchema: z.ZodObject<{
1754
2124
  };
1755
2125
  estimatedEffort: number;
1756
2126
  packageName: string;
1757
- ecosystem: string;
1758
2127
  currentVersion: string;
1759
2128
  targetVersion: string;
1760
2129
  updateType: "patch" | "minor" | "major";
@@ -1765,6 +2134,7 @@ export declare const OutputSchema: z.ZodObject<{
1765
2134
  breakingChangeSummary?: string | undefined;
1766
2135
  groupKey?: string | undefined;
1767
2136
  }, {
2137
+ ecosystem: string;
1768
2138
  impactScores: {
1769
2139
  scalability: number;
1770
2140
  performance: number;
@@ -1777,7 +2147,6 @@ export declare const OutputSchema: z.ZodObject<{
1777
2147
  };
1778
2148
  estimatedEffort: number;
1779
2149
  packageName: string;
1780
- ecosystem: string;
1781
2150
  currentVersion: string;
1782
2151
  targetVersion: string;
1783
2152
  updateType: "patch" | "minor" | "major";
@@ -1832,6 +2201,7 @@ export declare const OutputSchema: z.ZodObject<{
1832
2201
  vulnFixCount: z.ZodNumber;
1833
2202
  groupKey: z.ZodOptional<z.ZodString>;
1834
2203
  }, "strip", z.ZodTypeAny, {
2204
+ ecosystem: string;
1835
2205
  impactScores: {
1836
2206
  scalability: number;
1837
2207
  performance: number;
@@ -1844,7 +2214,6 @@ export declare const OutputSchema: z.ZodObject<{
1844
2214
  };
1845
2215
  estimatedEffort: number;
1846
2216
  packageName: string;
1847
- ecosystem: string;
1848
2217
  currentVersion: string;
1849
2218
  targetVersion: string;
1850
2219
  updateType: "patch" | "minor" | "major";
@@ -1855,6 +2224,7 @@ export declare const OutputSchema: z.ZodObject<{
1855
2224
  breakingChangeSummary?: string | undefined;
1856
2225
  groupKey?: string | undefined;
1857
2226
  }, {
2227
+ ecosystem: string;
1858
2228
  impactScores: {
1859
2229
  scalability: number;
1860
2230
  performance: number;
@@ -1867,7 +2237,6 @@ export declare const OutputSchema: z.ZodObject<{
1867
2237
  };
1868
2238
  estimatedEffort: number;
1869
2239
  packageName: string;
1870
- ecosystem: string;
1871
2240
  currentVersion: string;
1872
2241
  targetVersion: string;
1873
2242
  updateType: "patch" | "minor" | "major";
@@ -1883,6 +2252,7 @@ export declare const OutputSchema: z.ZodObject<{
1883
2252
  urgency: "critical" | "recommended" | "routine" | "urgent";
1884
2253
  groupKey: string;
1885
2254
  items: {
2255
+ ecosystem: string;
1886
2256
  impactScores: {
1887
2257
  scalability: number;
1888
2258
  performance: number;
@@ -1895,7 +2265,6 @@ export declare const OutputSchema: z.ZodObject<{
1895
2265
  };
1896
2266
  estimatedEffort: number;
1897
2267
  packageName: string;
1898
- ecosystem: string;
1899
2268
  currentVersion: string;
1900
2269
  targetVersion: string;
1901
2270
  updateType: "patch" | "minor" | "major";
@@ -1910,6 +2279,7 @@ export declare const OutputSchema: z.ZodObject<{
1910
2279
  urgency: "critical" | "recommended" | "routine" | "urgent";
1911
2280
  groupKey: string;
1912
2281
  items: {
2282
+ ecosystem: string;
1913
2283
  impactScores: {
1914
2284
  scalability: number;
1915
2285
  performance: number;
@@ -1922,7 +2292,6 @@ export declare const OutputSchema: z.ZodObject<{
1922
2292
  };
1923
2293
  estimatedEffort: number;
1924
2294
  packageName: string;
1925
- ecosystem: string;
1926
2295
  currentVersion: string;
1927
2296
  targetVersion: string;
1928
2297
  updateType: "patch" | "minor" | "major";
@@ -1966,6 +2335,7 @@ export declare const OutputSchema: z.ZodObject<{
1966
2335
  estimatedTotalEffort: number;
1967
2336
  };
1968
2337
  updates: {
2338
+ ecosystem: string;
1969
2339
  impactScores: {
1970
2340
  scalability: number;
1971
2341
  performance: number;
@@ -1978,7 +2348,6 @@ export declare const OutputSchema: z.ZodObject<{
1978
2348
  };
1979
2349
  estimatedEffort: number;
1980
2350
  packageName: string;
1981
- ecosystem: string;
1982
2351
  currentVersion: string;
1983
2352
  targetVersion: string;
1984
2353
  updateType: "patch" | "minor" | "major";
@@ -1993,6 +2362,7 @@ export declare const OutputSchema: z.ZodObject<{
1993
2362
  urgency: "critical" | "recommended" | "routine" | "urgent";
1994
2363
  groupKey: string;
1995
2364
  items: {
2365
+ ecosystem: string;
1996
2366
  impactScores: {
1997
2367
  scalability: number;
1998
2368
  performance: number;
@@ -2005,7 +2375,6 @@ export declare const OutputSchema: z.ZodObject<{
2005
2375
  };
2006
2376
  estimatedEffort: number;
2007
2377
  packageName: string;
2008
- ecosystem: string;
2009
2378
  currentVersion: string;
2010
2379
  targetVersion: string;
2011
2380
  updateType: "patch" | "minor" | "major";
@@ -2027,6 +2396,7 @@ export declare const OutputSchema: z.ZodObject<{
2027
2396
  estimatedTotalEffort: number;
2028
2397
  };
2029
2398
  updates: {
2399
+ ecosystem: string;
2030
2400
  impactScores: {
2031
2401
  scalability: number;
2032
2402
  performance: number;
@@ -2039,7 +2409,6 @@ export declare const OutputSchema: z.ZodObject<{
2039
2409
  };
2040
2410
  estimatedEffort: number;
2041
2411
  packageName: string;
2042
- ecosystem: string;
2043
2412
  currentVersion: string;
2044
2413
  targetVersion: string;
2045
2414
  updateType: "patch" | "minor" | "major";
@@ -2054,6 +2423,7 @@ export declare const OutputSchema: z.ZodObject<{
2054
2423
  urgency: "critical" | "recommended" | "routine" | "urgent";
2055
2424
  groupKey: string;
2056
2425
  items: {
2426
+ ecosystem: string;
2057
2427
  impactScores: {
2058
2428
  scalability: number;
2059
2429
  performance: number;
@@ -2066,7 +2436,6 @@ export declare const OutputSchema: z.ZodObject<{
2066
2436
  };
2067
2437
  estimatedEffort: number;
2068
2438
  packageName: string;
2069
- ecosystem: string;
2070
2439
  currentVersion: string;
2071
2440
  targetVersion: string;
2072
2441
  updateType: "patch" | "minor" | "major";
@@ -2180,6 +2549,17 @@ export declare const OutputSchema: z.ZodObject<{
2180
2549
  version: string;
2181
2550
  license: string;
2182
2551
  documentationUrl?: string | undefined;
2552
+ rationale?: string | undefined;
2553
+ ecosystem?: {
2554
+ version: string;
2555
+ library: string;
2556
+ role: string;
2557
+ }[] | undefined;
2558
+ antiPatterns?: string[] | undefined;
2559
+ alternatives?: {
2560
+ library: string;
2561
+ when: string;
2562
+ }[] | undefined;
2183
2563
  };
2184
2564
  domain: string;
2185
2565
  impactScores: {
@@ -2207,9 +2587,9 @@ export declare const OutputSchema: z.ZodObject<{
2207
2587
  linesSavedEstimate: number;
2208
2588
  uxAudit: {
2209
2589
  status: "present" | "partial" | "missing";
2590
+ rationale: string;
2210
2591
  category: "accessibility" | "error-states" | "empty-states" | "loading-states" | "form-validation" | "performance-feel" | "copy-consistency" | "design-system-alignment";
2211
2592
  filePaths: string[];
2212
- rationale: string;
2213
2593
  recommendedLibrary?: string | undefined;
2214
2594
  }[];
2215
2595
  migrationPlan: {
@@ -2243,6 +2623,28 @@ export declare const OutputSchema: z.ZodObject<{
2243
2623
  severity: "missing" | "conflict" | "compatible";
2244
2624
  }[];
2245
2625
  };
2626
+ gapAnalysis?: {
2627
+ description: string;
2628
+ recommendedLibrary: {
2629
+ name: string;
2630
+ version: string;
2631
+ license: string;
2632
+ documentationUrl?: string | undefined;
2633
+ rationale?: string | undefined;
2634
+ ecosystem?: {
2635
+ version: string;
2636
+ library: string;
2637
+ role: string;
2638
+ }[] | undefined;
2639
+ antiPatterns?: string[] | undefined;
2640
+ alternatives?: {
2641
+ library: string;
2642
+ when: string;
2643
+ }[] | undefined;
2644
+ };
2645
+ domain: string;
2646
+ priority: "critical" | "recommended" | "nice-to-have";
2647
+ }[] | undefined;
2246
2648
  vulnerabilityReport?: {
2247
2649
  summary: {
2248
2650
  low: number;
@@ -2256,11 +2658,11 @@ export declare const OutputSchema: z.ZodObject<{
2256
2658
  unfixable: number;
2257
2659
  };
2258
2660
  findings: {
2661
+ ecosystem: string;
2259
2662
  installedVersion: string;
2260
2663
  severity: "unknown" | "low" | "medium" | "high" | "critical";
2261
2664
  source: "current" | "recommended";
2262
2665
  packageName: string;
2263
- ecosystem: string;
2264
2666
  vulnerabilityId: string;
2265
2667
  aliases: string[];
2266
2668
  cvssScore: number | null;
@@ -2280,6 +2682,7 @@ export declare const OutputSchema: z.ZodObject<{
2280
2682
  estimatedTotalEffort: number;
2281
2683
  };
2282
2684
  updates: {
2685
+ ecosystem: string;
2283
2686
  impactScores: {
2284
2687
  scalability: number;
2285
2688
  performance: number;
@@ -2292,7 +2695,6 @@ export declare const OutputSchema: z.ZodObject<{
2292
2695
  };
2293
2696
  estimatedEffort: number;
2294
2697
  packageName: string;
2295
- ecosystem: string;
2296
2698
  currentVersion: string;
2297
2699
  targetVersion: string;
2298
2700
  updateType: "patch" | "minor" | "major";
@@ -2307,6 +2709,7 @@ export declare const OutputSchema: z.ZodObject<{
2307
2709
  urgency: "critical" | "recommended" | "routine" | "urgent";
2308
2710
  groupKey: string;
2309
2711
  items: {
2712
+ ecosystem: string;
2310
2713
  impactScores: {
2311
2714
  scalability: number;
2312
2715
  performance: number;
@@ -2319,7 +2722,6 @@ export declare const OutputSchema: z.ZodObject<{
2319
2722
  };
2320
2723
  estimatedEffort: number;
2321
2724
  packageName: string;
2322
- ecosystem: string;
2323
2725
  currentVersion: string;
2324
2726
  targetVersion: string;
2325
2727
  updateType: "patch" | "minor" | "major";
@@ -2367,6 +2769,17 @@ export declare const OutputSchema: z.ZodObject<{
2367
2769
  version: string;
2368
2770
  license: string;
2369
2771
  documentationUrl?: string | undefined;
2772
+ rationale?: string | undefined;
2773
+ ecosystem?: {
2774
+ version: string;
2775
+ library: string;
2776
+ role: string;
2777
+ }[] | undefined;
2778
+ antiPatterns?: string[] | undefined;
2779
+ alternatives?: {
2780
+ library: string;
2781
+ when: string;
2782
+ }[] | undefined;
2370
2783
  };
2371
2784
  domain: string;
2372
2785
  impactScores: {
@@ -2394,9 +2807,9 @@ export declare const OutputSchema: z.ZodObject<{
2394
2807
  linesSavedEstimate: number;
2395
2808
  uxAudit: {
2396
2809
  status: "present" | "partial" | "missing";
2810
+ rationale: string;
2397
2811
  category: "accessibility" | "error-states" | "empty-states" | "loading-states" | "form-validation" | "performance-feel" | "copy-consistency" | "design-system-alignment";
2398
2812
  filePaths: string[];
2399
- rationale: string;
2400
2813
  recommendedLibrary?: string | undefined;
2401
2814
  }[];
2402
2815
  migrationPlan: {
@@ -2430,6 +2843,28 @@ export declare const OutputSchema: z.ZodObject<{
2430
2843
  severity: "missing" | "conflict" | "compatible";
2431
2844
  }[];
2432
2845
  };
2846
+ gapAnalysis?: {
2847
+ description: string;
2848
+ recommendedLibrary: {
2849
+ name: string;
2850
+ version: string;
2851
+ license: string;
2852
+ documentationUrl?: string | undefined;
2853
+ rationale?: string | undefined;
2854
+ ecosystem?: {
2855
+ version: string;
2856
+ library: string;
2857
+ role: string;
2858
+ }[] | undefined;
2859
+ antiPatterns?: string[] | undefined;
2860
+ alternatives?: {
2861
+ library: string;
2862
+ when: string;
2863
+ }[] | undefined;
2864
+ };
2865
+ domain: string;
2866
+ priority: "critical" | "recommended" | "nice-to-have";
2867
+ }[] | undefined;
2433
2868
  vulnerabilityReport?: {
2434
2869
  summary: {
2435
2870
  low: number;
@@ -2443,11 +2878,11 @@ export declare const OutputSchema: z.ZodObject<{
2443
2878
  unfixable: number;
2444
2879
  };
2445
2880
  findings: {
2881
+ ecosystem: string;
2446
2882
  installedVersion: string;
2447
2883
  severity: "unknown" | "low" | "medium" | "high" | "critical";
2448
2884
  source: "current" | "recommended";
2449
2885
  packageName: string;
2450
- ecosystem: string;
2451
2886
  vulnerabilityId: string;
2452
2887
  cvssScore: number | null;
2453
2888
  summary: string;
@@ -2467,6 +2902,7 @@ export declare const OutputSchema: z.ZodObject<{
2467
2902
  estimatedTotalEffort: number;
2468
2903
  };
2469
2904
  updates: {
2905
+ ecosystem: string;
2470
2906
  impactScores: {
2471
2907
  scalability: number;
2472
2908
  performance: number;
@@ -2479,7 +2915,6 @@ export declare const OutputSchema: z.ZodObject<{
2479
2915
  };
2480
2916
  estimatedEffort: number;
2481
2917
  packageName: string;
2482
- ecosystem: string;
2483
2918
  currentVersion: string;
2484
2919
  targetVersion: string;
2485
2920
  updateType: "patch" | "minor" | "major";
@@ -2494,6 +2929,7 @@ export declare const OutputSchema: z.ZodObject<{
2494
2929
  urgency: "critical" | "recommended" | "routine" | "urgent";
2495
2930
  groupKey: string;
2496
2931
  items: {
2932
+ ecosystem: string;
2497
2933
  impactScores: {
2498
2934
  scalability: number;
2499
2935
  performance: number;
@@ -2506,7 +2942,6 @@ export declare const OutputSchema: z.ZodObject<{
2506
2942
  };
2507
2943
  estimatedEffort: number;
2508
2944
  packageName: string;
2509
- ecosystem: string;
2510
2945
  currentVersion: string;
2511
2946
  targetVersion: string;
2512
2947
  updateType: "patch" | "minor" | "major";