@githits/mcp 0.28.0 → 0.29.0
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.
- package/dist/client.d.ts +39 -0
- package/dist/client.js +1 -1
- package/dist/index.d.ts +39 -0
- package/dist/index.js +8 -5
- package/dist/shared/chunk-9wvn7h56.js +26 -0
- package/dist/shared/{chunk-7bhsf72k.js → chunk-axsb5fka.js} +2 -2
- package/dist/shared/{chunk-9krxa3vd.js → chunk-db4q74ej.js} +34 -3
- package/dist/smoke-test.js +1 -1
- package/dist/tools.js +1 -1
- package/package.json +1 -1
- package/dist/shared/chunk-fv8rsads.js +0 -26
package/dist/client.d.ts
CHANGED
|
@@ -1417,6 +1417,8 @@ interface PackageUpgradeReviewPackageParams {
|
|
|
1417
1417
|
targetVersion: string;
|
|
1418
1418
|
}
|
|
1419
1419
|
interface PackageUpgradeReviewParams {
|
|
1420
|
+
/** Select complete statement text only when the caller consumes it. */
|
|
1421
|
+
includeChangelogFullText?: boolean;
|
|
1420
1422
|
packages: PackageUpgradeReviewPackageParams[];
|
|
1421
1423
|
includeTransitiveSecurity: boolean;
|
|
1422
1424
|
includeDependencyIssues: boolean;
|
|
@@ -1479,6 +1481,7 @@ interface PackageUpgradeSecurity {
|
|
|
1479
1481
|
transitive?: PackageUpgradeTransitiveSecurity;
|
|
1480
1482
|
}
|
|
1481
1483
|
interface PackageUpgradeChangelogEntry {
|
|
1484
|
+
detailSource?: string;
|
|
1482
1485
|
version?: string;
|
|
1483
1486
|
publishedAt?: string;
|
|
1484
1487
|
htmlUrl?: string;
|
|
@@ -1487,7 +1490,43 @@ interface PackageUpgradeChangelogEntry {
|
|
|
1487
1490
|
headline?: string;
|
|
1488
1491
|
signals: string[];
|
|
1489
1492
|
}
|
|
1493
|
+
/** Backend model labels for one release-note statement, never a package verdict. */
|
|
1494
|
+
interface PackageUpgradeChangelogRiskItem {
|
|
1495
|
+
version: string;
|
|
1496
|
+
tier: "MUST_ACT" | "SHOULD_KNOW" | "UNCLASSIFIED";
|
|
1497
|
+
/** Backend ambiguity policy; confidence is evidence, not a client threshold. */
|
|
1498
|
+
ambiguous: boolean;
|
|
1499
|
+
tierConfidence?: number;
|
|
1500
|
+
kind?: string;
|
|
1501
|
+
kindConfidence?: number;
|
|
1502
|
+
text: string;
|
|
1503
|
+
textTruncated: boolean;
|
|
1504
|
+
/** Complete statement, present only when selected. */
|
|
1505
|
+
fullText?: string;
|
|
1506
|
+
/** Exact backend source locator, independent of sampled entries. */
|
|
1507
|
+
url?: string;
|
|
1508
|
+
heading?: string;
|
|
1509
|
+
source?: string;
|
|
1510
|
+
model: string;
|
|
1511
|
+
formulation: string;
|
|
1512
|
+
}
|
|
1513
|
+
interface PackageUpgradeChangelogRiskCoverage {
|
|
1514
|
+
versionsClassified: number;
|
|
1515
|
+
versionsNotAssessed: number;
|
|
1516
|
+
versionsWithoutNotes: number;
|
|
1517
|
+
versionsUnparseable: number;
|
|
1518
|
+
unitsNoImpact: number;
|
|
1519
|
+
/** Statement totals before the per-review cap, separated by backend ambiguity. */
|
|
1520
|
+
itemsMustActConfident: number;
|
|
1521
|
+
itemsMustActAmbiguous: number;
|
|
1522
|
+
itemsShouldKnowConfident: number;
|
|
1523
|
+
itemsShouldKnowAmbiguous: number;
|
|
1524
|
+
itemsUnclassified: number;
|
|
1525
|
+
itemsOmitted: number;
|
|
1526
|
+
}
|
|
1490
1527
|
interface PackageUpgradeChangelog {
|
|
1528
|
+
riskItems: PackageUpgradeChangelogRiskItem[];
|
|
1529
|
+
riskCoverage: PackageUpgradeChangelogRiskCoverage;
|
|
1491
1530
|
source?: string;
|
|
1492
1531
|
fallback?: string;
|
|
1493
1532
|
entries: PackageUpgradeChangelogEntry[];
|
package/dist/client.js
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
import{GrepGraphQLError2,GrepBackendError2,GrepAccessError2,GrepNetworkError2,MalformedGrepResponseError2,GrepServiceImpl2,ListAccessError2,ListGraphQLError2,ListBackendError2,ListNetworkError2,MalformedListResponseError2,ListServiceImpl2,ReadServiceImpl2,RefreshingGitHitsService2,ResolveTargetServiceImpl2,createStaticTokenProvider2,SessionIdConfigError2,getEnvSessionId2,createClientHeaderBuilder2}from"./shared/chunk-
|
|
1
|
+
import{GrepGraphQLError2,GrepBackendError2,GrepAccessError2,GrepNetworkError2,MalformedGrepResponseError2,GrepServiceImpl2,ListAccessError2,ListGraphQLError2,ListBackendError2,ListNetworkError2,MalformedListResponseError2,ListServiceImpl2,ReadServiceImpl2,RefreshingGitHitsService2,ResolveTargetServiceImpl2,createStaticTokenProvider2,SessionIdConfigError2,getEnvSessionId2,createClientHeaderBuilder2}from"./shared/chunk-axsb5fka.js";import{DEFAULT_MCP_URL2,DEFAULT_API_URL2,DEFAULT_CODE_NAV_URL2,getMcpUrl2,getApiUrl2,getCodeNavigationUrl2,getEnvApiToken2,PKGSEER_REGISTRY_LIST2,toPkgseerRegistry2,toPkgseerRegistryLowercase2,GitHitsServiceImpl2,CodeDiffError2,CodeNavigationServiceImpl2,PackageIntelligenceServiceImpl2}from"./shared/chunk-db4q74ej.js";export{CodeDiffError2 as CodeDiffError,CodeNavigationServiceImpl2 as CodeNavigationServiceImpl,DEFAULT_API_URL2 as DEFAULT_API_URL,DEFAULT_CODE_NAV_URL2 as DEFAULT_CODE_NAV_URL,DEFAULT_MCP_URL2 as DEFAULT_MCP_URL,GitHitsServiceImpl2 as GitHitsServiceImpl,GrepAccessError2 as GrepAccessError,GrepBackendError2 as GrepBackendError,GrepGraphQLError2 as GrepGraphQLError,GrepNetworkError2 as GrepNetworkError,GrepServiceImpl2 as GrepServiceImpl,ListAccessError2 as ListAccessError,ListBackendError2 as ListBackendError,ListGraphQLError2 as ListGraphQLError,ListNetworkError2 as ListNetworkError,ListServiceImpl2 as ListServiceImpl,MalformedGrepResponseError2 as MalformedGrepResponseError,MalformedListResponseError2 as MalformedListResponseError,PKGSEER_REGISTRY_LIST2 as PKGSEER_REGISTRY_LIST,PackageIntelligenceServiceImpl2 as PackageIntelligenceServiceImpl,ReadServiceImpl2 as ReadServiceImpl,RefreshingGitHitsService2 as RefreshingGitHitsService,ResolveTargetServiceImpl2 as ResolveTargetServiceImpl,SessionIdConfigError2 as SessionIdConfigError,createClientHeaderBuilder2 as createClientHeaderBuilder,createStaticTokenProvider2 as createStaticTokenProvider,getApiUrl2 as getApiUrl,getCodeNavigationUrl2 as getCodeNavigationUrl,getEnvApiToken2 as getEnvApiToken,getEnvSessionId2 as getEnvSessionId,getMcpUrl2 as getMcpUrl,toPkgseerRegistry2 as toPkgseerRegistry,toPkgseerRegistryLowercase2 as toPkgseerRegistryLowercase};
|
package/dist/index.d.ts
CHANGED
|
@@ -1134,6 +1134,8 @@ interface PackageUpgradeReviewPackageParams {
|
|
|
1134
1134
|
targetVersion: string;
|
|
1135
1135
|
}
|
|
1136
1136
|
interface PackageUpgradeReviewParams {
|
|
1137
|
+
/** Select complete statement text only when the caller consumes it. */
|
|
1138
|
+
includeChangelogFullText?: boolean;
|
|
1137
1139
|
packages: PackageUpgradeReviewPackageParams[];
|
|
1138
1140
|
includeTransitiveSecurity: boolean;
|
|
1139
1141
|
includeDependencyIssues: boolean;
|
|
@@ -1196,6 +1198,7 @@ interface PackageUpgradeSecurity {
|
|
|
1196
1198
|
transitive?: PackageUpgradeTransitiveSecurity;
|
|
1197
1199
|
}
|
|
1198
1200
|
interface PackageUpgradeChangelogEntry {
|
|
1201
|
+
detailSource?: string;
|
|
1199
1202
|
version?: string;
|
|
1200
1203
|
publishedAt?: string;
|
|
1201
1204
|
htmlUrl?: string;
|
|
@@ -1204,7 +1207,43 @@ interface PackageUpgradeChangelogEntry {
|
|
|
1204
1207
|
headline?: string;
|
|
1205
1208
|
signals: string[];
|
|
1206
1209
|
}
|
|
1210
|
+
/** Backend model labels for one release-note statement, never a package verdict. */
|
|
1211
|
+
interface PackageUpgradeChangelogRiskItem {
|
|
1212
|
+
version: string;
|
|
1213
|
+
tier: "MUST_ACT" | "SHOULD_KNOW" | "UNCLASSIFIED";
|
|
1214
|
+
/** Backend ambiguity policy; confidence is evidence, not a client threshold. */
|
|
1215
|
+
ambiguous: boolean;
|
|
1216
|
+
tierConfidence?: number;
|
|
1217
|
+
kind?: string;
|
|
1218
|
+
kindConfidence?: number;
|
|
1219
|
+
text: string;
|
|
1220
|
+
textTruncated: boolean;
|
|
1221
|
+
/** Complete statement, present only when selected. */
|
|
1222
|
+
fullText?: string;
|
|
1223
|
+
/** Exact backend source locator, independent of sampled entries. */
|
|
1224
|
+
url?: string;
|
|
1225
|
+
heading?: string;
|
|
1226
|
+
source?: string;
|
|
1227
|
+
model: string;
|
|
1228
|
+
formulation: string;
|
|
1229
|
+
}
|
|
1230
|
+
interface PackageUpgradeChangelogRiskCoverage {
|
|
1231
|
+
versionsClassified: number;
|
|
1232
|
+
versionsNotAssessed: number;
|
|
1233
|
+
versionsWithoutNotes: number;
|
|
1234
|
+
versionsUnparseable: number;
|
|
1235
|
+
unitsNoImpact: number;
|
|
1236
|
+
/** Statement totals before the per-review cap, separated by backend ambiguity. */
|
|
1237
|
+
itemsMustActConfident: number;
|
|
1238
|
+
itemsMustActAmbiguous: number;
|
|
1239
|
+
itemsShouldKnowConfident: number;
|
|
1240
|
+
itemsShouldKnowAmbiguous: number;
|
|
1241
|
+
itemsUnclassified: number;
|
|
1242
|
+
itemsOmitted: number;
|
|
1243
|
+
}
|
|
1207
1244
|
interface PackageUpgradeChangelog {
|
|
1245
|
+
riskItems: PackageUpgradeChangelogRiskItem[];
|
|
1246
|
+
riskCoverage: PackageUpgradeChangelogRiskCoverage;
|
|
1208
1247
|
source?: string;
|
|
1209
1248
|
fallback?: string;
|
|
1210
1249
|
entries: PackageUpgradeChangelogEntry[];
|
package/dist/index.js
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import{EXTERNAL_CONTENT_POSTURE,PKG_VULNS_GUARDRAIL,PKG_INFO_GUARDRAIL,PKG_CHANGELOG_GUARDRAIL,PKG_UPGRADE_REVIEW_GUARDRAIL,CODE_READ_GUARDRAIL,CODE_GREP_GUARDRAIL,SEARCH_GUARDRAIL,terminalWidth,sanitizeTerminalText,wrapTerminalProse,toCodeNavigationRegistry,KNOWN_REGISTRIES,UnsupportedRegistryError,InvalidPackageSpecError,InvalidArgumentError,parsePackageSpec,isKnownRegistry,LegacyRepositoryRefError,isRepositoryTargetSpec,parseRepositoryTargetSpec,formatRepositoryTarget,formatRepositoryTargetLabel,buildInvalidTargetSpecError,AuthRequiredError,mapSessionIdError,mapTermsAcceptanceError,mapCodeNavigationError,buildUpdateRequiredError,MAX_WAIT_TIMEOUT_MS,MAX_DISCOVERY_WAIT_TIMEOUT_MS,MCP_READ_DEFAULT_SPAN,MCP_READ_MAX_SPAN,projectTargetResolution,buildTargetResolutionNotes,buildRetryCandidateLine,buildSuggestedRefsLine,buildResolutionFromRetryCandidates,formatTargetResolutionIdentity,formatProvenanceRow,formatSourceRow,renderSourceSection,sameRepositoryCommit,resolutionSourceFacts,formatRequestedIndexingExplanation,renderResolutionDetails,formatRequestedProvenance,formatPreparationRow,renderPreparationSection,formatPreparationRetry,indexingWaitMs,withIndexingRetryAction,formatMappedErrorText,READ_ONLY_TOOL_ANNOTATIONS,OPEN_WORLD_READ_ONLY_TOOL_ANNOTATIONS,textResult,errorResult,withErrorHandling,mcpMappedErrorResult,addLocalMcpAuthAction,throwIfCallerCancellation,createGetExampleTool2,colors,colorize,highlight,highlightMatch,highlightRanges,dim,shellQuote,shellQuoteExact,mapPackageIntelligenceError,formatCompactNumber,parseUnifiedSearchTargetSpec,createResolveTargetTool2}from"./shared/chunk-
|
|
1
|
+
import{EXTERNAL_CONTENT_POSTURE,PKG_VULNS_GUARDRAIL,PKG_INFO_GUARDRAIL,PKG_CHANGELOG_GUARDRAIL,PKG_UPGRADE_REVIEW_GUARDRAIL,CODE_READ_GUARDRAIL,CODE_GREP_GUARDRAIL,SEARCH_GUARDRAIL,terminalWidth,sanitizeTerminalText,wrapTerminalProse,toCodeNavigationRegistry,KNOWN_REGISTRIES,UnsupportedRegistryError,InvalidPackageSpecError,InvalidArgumentError,parsePackageSpec,isKnownRegistry,LegacyRepositoryRefError,isRepositoryTargetSpec,parseRepositoryTargetSpec,formatRepositoryTarget,formatRepositoryTargetLabel,buildInvalidTargetSpecError,AuthRequiredError,mapSessionIdError,mapTermsAcceptanceError,mapCodeNavigationError,buildUpdateRequiredError,MAX_WAIT_TIMEOUT_MS,MAX_DISCOVERY_WAIT_TIMEOUT_MS,MCP_READ_DEFAULT_SPAN,MCP_READ_MAX_SPAN,projectTargetResolution,buildTargetResolutionNotes,buildRetryCandidateLine,buildSuggestedRefsLine,buildResolutionFromRetryCandidates,formatTargetResolutionIdentity,formatProvenanceRow,formatSourceRow,renderSourceSection,sameRepositoryCommit,resolutionSourceFacts,formatRequestedIndexingExplanation,renderResolutionDetails,formatRequestedProvenance,formatPreparationRow,renderPreparationSection,formatPreparationRetry,indexingWaitMs,withIndexingRetryAction,formatMappedErrorText,READ_ONLY_TOOL_ANNOTATIONS,OPEN_WORLD_READ_ONLY_TOOL_ANNOTATIONS,textResult,errorResult,withErrorHandling,mcpMappedErrorResult,addLocalMcpAuthAction,throwIfCallerCancellation,createGetExampleTool2,colors,colorize,highlight,highlightMatch,highlightRanges,dim,shellQuote,shellQuoteExact,mapPackageIntelligenceError,formatCompactNumber,parseUnifiedSearchTargetSpec,createResolveTargetTool2}from"./shared/chunk-9wvn7h56.js";import{ClientUpdateRequiredError,DEFAULT_WAIT_TIMEOUT_MS,PKGSEER_REGISTRY_ARGS,PKGSEER_REGISTRY_LIST2,toPkgseerRegistry2,toPkgseerRegistryLowercase2,isKnownPkgseerRegistryArg,AuthenticationError2,MalformedCodeNavigationResponseError,MalformedPackageIntelligenceResponseError}from"./shared/chunk-db4q74ej.js";import{GrepGraphQLError2,GrepBackendError2,GrepAccessError2,GrepNetworkError2,MalformedGrepResponseError2,parseGrepResult,ListAccessError2,ListGraphQLError2,ListBackendError2,ListNetworkError2,MalformedListResponseError2}from"./shared/chunk-axsb5fka.js";var GUIDE=`# GitHits
|
|
2
2
|
|
|
3
3
|
GitHits answers questions about open-source code, documentation, and packages.
|
|
4
4
|
Inputs leave this machine: never send private code, local paths, credentials,
|
|
@@ -137,14 +137,17 @@ ${historyText}`}function buildVerboseSections(lean,useColors){const blocks=[];if
|
|
|
137
137
|
`)}function formatVerboseChanges(entries,useColors){const lines=[highlight("Recent changes",useColors)];for(const entry of entries){const parts=[entry.version];if(entry.date)parts.push(entry.date);if(entry.summary)parts.push(entry.summary);lines.push(` ${parts.join(" ")}`)}return lines.join(`
|
|
138
138
|
`)}var schema6={target:z6.string().describe(`Latest-only package registry:name, for example npm:express or npm:@types/node; omit version pins. Registries: ${PKGSEER_REGISTRY_LIST2}.`),verbose:z6.boolean().optional().describe("Text only. Adds GitHub language/topics/last-pushed, published-version count, download refresh date, package-wide advisory history (all versions), and recent changes. Latest affected and package-wide history counts are shown separately. Ignored for format=json."),format:z6.enum(["text","json"]).default("text").describe("Omit `format` to use token-efficient text when the model reads the result or chooses follow-up tools. Set `json` only when code consumes the raw response instead of the model, or a required field is absent from text. JSON includes `versionCount`, `downloads.refreshedAt`, and `advisoryHistory.total`.")};var DESCRIPTION_BASE2="Assess latest package health and adoption: license, downloads, and activity. Provide "+"an unpinned package target; this tool always returns latest. "+"Default text returns license, description, repository popularity "+"(stars/forks/issues and [ARCHIVED] when applicable), downloads, "+"publish age, latest affected count, and separate package-wide advisory "+"history count, shown separately. Historical counts are not current-version risk. "+"Use `verbose: true` for additional health and history details.";var DESCRIPTION6=`${DESCRIPTION_BASE2}
|
|
139
139
|
|
|
140
|
-
${PKG_INFO_GUARDRAIL}`;function createPackageSummaryTool(service){return{name:"pkg_info",description:DESCRIPTION6,schema:schema6,annotations:OPEN_WORLD_READ_ONLY_TOOL_ANNOTATIONS,handler:async(args,context)=>{try{const target=parsePackageSpec(args.target.trim());if(target.version!==undefined){throw new InvalidPackageSpecError(`pkg_info always returns the latest version; omit @${target.version}.`)}const{params}=buildPackageSummaryParams({registry:target.registry,packageName:target.name});const textFormat=isTextFormat4(args.format);const summary=await service.packageSummary({...params,includeVerboseFields:!textFormat||args.verbose===true});const payload=buildPackageSummarySuccessPayload(summary);if(textFormat){return textResult(formatPackageSummaryTerminal(summary,{verbose:args.verbose,useColors:false}).trimEnd())}return textResult(JSON.stringify(payload))}catch(error){throwIfCallerCancellation(error,context?.signal);const mapped=mapPackageIntelligenceError(error);return mcpMappedErrorResult(mapped,context,args.format)}}}}function isTextFormat4(format){return format===undefined||format==="text"}import{z as z7}from"zod";class UnsupportedVulnerabilitiesRegistryError extends Error{constructor(message){super(message);this.name="UnsupportedVulnerabilitiesRegistryError"}}var SEVERITY_LABEL_TO_CVSS={low:0.1,medium:4,high:7,critical:9};var ADVISORY_SCOPE_TO_GRAPHQL={affected:"AFFECTED",non_affecting:"NON_AFFECTING",all:"ALL"};function buildPackageVulnerabilitiesParams(input){const trimmedName=input.packageName?.trim()??"";if(!trimmedName){throw new InvalidPackageSpecError("Package name is required.")}const normalisedRegistryArg=input.registry?.trim().toLowerCase()??"";if(!isKnownPkgseerRegistryArg(normalisedRegistryArg)){throw new UnsupportedRegistryError(`Unsupported registry '${input.registry}'. Supported: ${PKGSEER_REGISTRY_LIST2}.`)}const registry=toPkgseerRegistry2(normalisedRegistryArg);if(!supportsVulnerabilitiesRegistry(registry)){throw new UnsupportedVulnerabilitiesRegistryError(`pkg vulns only supports ${SUPPORTED_VULN_REGISTRIES_HUMAN}. Got: ${normalisedRegistryArg}.`)}const severityLabel=resolveMinSeverityLabel(input.minSeverity);const minSeverity=severityLabel!==undefined?SEVERITY_LABEL_TO_CVSS[severityLabel]:undefined;const version=normalisePackageVersion(input.version,registry,{rejectLeadingV:true});const advisoryScope=resolveAdvisoryScope(input.advisoryScope);const filterWithScope=buildFilterEcho(severityLabel,input.includeWithdrawn,advisoryScope);return{params:{registry,packageName:trimmedName,version,minSeverity,includeWithdrawn:input.includeWithdrawn,includeTransitive:input.includeTransitive,advisoryScope:advisoryScope?ADVISORY_SCOPE_TO_GRAPHQL[advisoryScope]:undefined},...filterWithScope?{filter:filterWithScope}:{}}}function resolveMinSeverityLabel(raw){if(raw===undefined)return;const trimmed=raw.trim();if(trimmed.length===0)return;const lower=trimmed.toLowerCase();if(!isSeverityLabel(lower)){throw new InvalidPackageSpecError(`Unsupported severity '${raw}'. Expected one of: low, medium, high, critical.`)}return lower}function buildFilterEcho(minSeverity,includeWithdrawn,advisoryScope){const filter={};if(minSeverity!==undefined)filter.minSeverity=minSeverity;if(includeWithdrawn===true)filter.includeWithdrawn=true;if(advisoryScope!==undefined&&advisoryScope!=="affected"){filter.advisoryScope=advisoryScope}return Object.keys(filter).length>0?filter:undefined}function resolveAdvisoryScope(raw){if(raw===undefined)return;const trimmed=raw.trim();if(trimmed.length===0)return;const lower=trimmed.toLowerCase().replace(/-/g,"_");if(lower==="affected"||lower==="non_affecting"||lower==="all"){return lower}throw new InvalidPackageSpecError(`Unsupported advisory scope '${raw}'. Expected one of: affected, non_affecting, all.`)}function isSeverityLabel(value){return value==="low"||value==="medium"||value==="high"||value==="critical"}var DEFAULT_CHANGELOG_LIMIT=20;var PACKAGE_UPGRADE_REVIEW_MAX_PACKAGES=30;function buildPackageUpgradeReviewRequest(input){const batch=input.packages?.filter((pkg)=>!isBlankPackageInput(pkg));const hasBatch=Array.isArray(batch)&&batch.length>0;const hasSingle=hasNonBlankValue(input.registry)||hasNonBlankValue(input.packageName)||hasNonBlankValue(input.currentVersion)||hasNonBlankValue(input.targetVersion);if(hasBatch&&hasSingle){throw new InvalidPackageSpecError("Pass either packages[] or registry/package_name/current_version/target_version, not both.")}if(!hasBatch&&!hasSingle){throw new InvalidPackageSpecError("Package upgrade review requires either packages[] or registry, package_name, current_version, and target_version.")}const packages=hasBatch?parseBatch(batch):[parsePackageInput({registry:input.registry??"",packageName:input.packageName??"",currentVersion:input.currentVersion??"",targetVersion:input.targetVersion??""})];const minSeverityLabel=resolveMinSeverityLabel2(input.minSeverity);return{packages,options:{includeTransitiveSecurity:input.includeTransitiveSecurity!==false,includeDependencyIssues:input.includeDependencyIssues===true,includeDependencyChanges:true,changelogLimit:DEFAULT_CHANGELOG_LIMIT,minSeverityLabel,minSeverity:minSeverityLabel!==undefined&&minSeverityLabel!=="low"?SEVERITY_LABEL_TO_CVSS[minSeverityLabel]:undefined}}}function hasNonBlankValue(value){return value!==undefined&&value.trim().length>0}function isBlankPackageInput(input){return!(hasNonBlankValue(input.registry)||hasNonBlankValue(input.packageName)||hasNonBlankValue(input.currentVersion)||hasNonBlankValue(input.targetVersion))}function parseBatch(packages){if(!Array.isArray(packages)||packages.length===0){throw new InvalidPackageSpecError("packages[] must contain at least one upgrade.")}if(packages.length>PACKAGE_UPGRADE_REVIEW_MAX_PACKAGES){throw new InvalidPackageSpecError(`packages[] must contain at most ${PACKAGE_UPGRADE_REVIEW_MAX_PACKAGES} upgrades.`)}return packages.map(parsePackageInput)}function parsePackageInput(input){const registryArg=input.registry?.trim().toLowerCase()??"";if(!isKnownPkgseerRegistryArg(registryArg)){throw new UnsupportedRegistryError(`Unsupported registry '${input.registry}'. Supported: ${PKGSEER_REGISTRY_LIST2}.`)}const packageName=input.packageName?.trim()??"";if(packageName.length===0){throw new InvalidPackageSpecError("Package name is required.")}const registry=toPkgseerRegistry2(registryArg);const currentVersion=normaliseVersion(input.currentVersion,"current_version",registry);const targetVersion=normaliseVersion(input.targetVersion,"target_version",registry);return{registry,registryLabel:registryArg,packageName,currentVersion,targetVersion}}function normaliseVersion(raw,fieldName,registry){const version=normalisePackageVersion(raw,registry,{rejectLeadingV:true,fieldName});if(version===undefined){throw new InvalidPackageSpecError(`${fieldName} is required.`)}return version}function resolveMinSeverityLabel2(raw){if(raw===undefined)return;const lower=raw.trim().toLowerCase();if(lower.length===0)return;if(lower==="low"||lower==="medium"||lower==="high"||lower==="critical"){return lower}throw new InvalidPackageSpecError(`Unsupported min_severity '${raw}'. Expected one of: low, medium, high, critical.`)}var BODY_PREVIEW_CHARS=280;async function buildPackageUpgradeReview(service,packages,options){const response=await service.packageUpgradeReview({packages:packages.map((pkg)=>({registry:pkg.registry,name:pkg.packageName,currentVersion:pkg.currentVersion,targetVersion:pkg.targetVersion})),includeTransitiveSecurity:options.includeTransitiveSecurity,includeDependencyIssues:options.includeDependencyIssues,changelogLimit:options.changelogLimit,minSeverity:options.minSeverity});return normaliseBackendUpgradeReviewResponse(response)}function normaliseBackendUpgradeReviewResponse(response){return{summary:response.summary,reviews:response.reviews.map((review)=>({registry:lowerEnum(review.registry)??review.registry,name:review.name,currentVersion:review.currentVersion,targetVersion:review.targetVersion,latestVersion:review.latestVersion,versionDelta:lowerEnum(review.versionDelta),security:normaliseBackendSecurity(review.security),changelog:normaliseBackendChangelog(review.changelog),compatibility:review.compatibility,dependencyChanges:review.dependencyChanges?normaliseBackendDependencyChanges(review.dependencyChanges):undefined,dependencyIssues:review.dependencyIssues,unknowns:review.unknowns}))}}function normaliseBackendSecurity(security){return{current:security.current?normaliseBackendVersionVulnerabilitySummary(security.current):undefined,target:security.target?normaliseBackendVersionVulnerabilitySummary(security.target):undefined,added:security.added.map(normaliseBackendAdvisory),removed:security.removed.map(normaliseBackendAdvisory),notAddressed:security.notAddressed.map(normaliseBackendAdvisory),fixed:security.fixed.map(normaliseBackendAdvisory),introduced:security.introduced.map(normaliseBackendAdvisory),unchanged:security.unchanged.map(normaliseBackendAdvisory),transitive:security.transitive?normaliseBackendTransitiveSecurity(security.transitive):undefined}}function normaliseBackendVersionVulnerabilitySummary(summary){return{version:summary.version,publishedAt:summary.publishedAt,deprecated:summary.deprecated,deprecationReason:summary.deprecationReason,affectedCount:summary.affectedCount,nonAffectingCount:summary.nonAffectingCount,allCount:summary.allCount,advisories:summary.advisories.map(normaliseBackendAdvisory)}}function normaliseBackendAdvisory(advisory){return{id:advisory.id,aliases:advisory.aliases,summary:advisory.summary,severity:advisory.severity,severityLabel:lowerEnum(advisory.severityLabel),fixedIn:advisory.fixedIn,isMalicious:advisory.isMalicious}}function normaliseBackendTransitiveSecurity(transitive){return{currentAffected:transitive.currentAffected,targetAffected:transitive.targetAffected,introducedPackages:transitive.introducedPackages.map(normaliseRegistryPrefix),fixedPackages:transitive.fixedPackages.map(normaliseRegistryPrefix),introducedPackageDetails:transitive.introducedPackageDetails.entries.map(normaliseBackendTransitivePackage),introducedPackageDetailsTotalCount:transitive.introducedPackageDetails.totalCount,introducedPackageDetailsTruncated:transitive.introducedPackageDetails.truncated,fixedPackageDetails:transitive.fixedPackageDetails.entries.map(normaliseBackendTransitivePackage),fixedPackageDetailsTotalCount:transitive.fixedPackageDetails.totalCount,fixedPackageDetailsTruncated:transitive.fixedPackageDetails.truncated,stillAffectedPackageDetails:transitive.stillAffectedPackageDetails.entries.map(normaliseBackendTransitivePackage),stillAffectedPackageDetailsTotalCount:transitive.stillAffectedPackageDetails.totalCount,stillAffectedPackageDetailsTruncated:transitive.stillAffectedPackageDetails.truncated}}function normaliseBackendDependencyChanges(changes){return{direct:normaliseBackendDependencyChangeGroup(changes.direct),transitive:normaliseBackendDependencyChangeGroup(changes.transitive)}}function normaliseBackendDependencyChangeGroup(group){return{added:group.added.map(normaliseBackendDependencyChangeItem),removed:group.removed.map(normaliseBackendDependencyChangeItem),changed:group.changed.map(normaliseBackendDependencyChangeItem)}}function normaliseBackendDependencyChangeItem(item){return{name:item.name,registry:lowerEnum(item.registry),version:item.version,fromVersions:item.fromVersions,toVersions:item.toVersions,constraint:item.constraint,type:lowerEnum(item.type)}}function normaliseBackendTransitivePackage(pkg){return{id:pkg.id,registry:lowerEnum(pkg.registry)??pkg.registry,name:pkg.name,versions:pkg.versions,affectedCount:pkg.affectedCount,maxSeverityScore:pkg.maxSeverityScore,maxSeverityLabel:lowerEnum(pkg.maxSeverityLabel),advisoryIds:pkg.advisoryIds}}function normaliseBackendChangelog(changelog){return{source:lowerEnum(changelog.source),fallback:lowerEnum(changelog.fallback),entries:changelog.entries.map(normaliseBackendChangelogEntry),sampledEntries:changelog.sampledEntries.map(normaliseBackendChangelogEntry),keywordEntries:changelog.keywordEntries.map(normaliseBackendChangelogEntry),totalKeywordEntries:changelog.totalKeywordEntries,totalEntries:changelog.totalEntries,totalEntriesWithBodies:changelog.totalEntriesWithBodies,truncated:changelog.truncated,hasReleaseNoteBodies:changelog.hasReleaseNoteBodies,breakingSignals:changelog.breakingSignals,migrationSignals:changelog.migrationSignals}}function normaliseBackendChangelogEntry(entry){return{version:entry.version??null,publishedAt:entry.publishedAt,htmlUrl:entry.htmlUrl,body:entry.body,bodyPreview:entry.bodyPreview,headline:entry.headline,signals:entry.signals.length>0?entry.signals:undefined}}function lowerEnum(value){return value?.toLowerCase()}function normaliseRegistryPrefix(value){return value.replace(/^([A-Z_]+):/,(prefix)=>prefix.toLowerCase())}function preview(body){if(body===undefined)return;const compact=body.replace(/\s+/g," ").trim();if(compact.length===0)return"";return compact.length>BODY_PREVIEW_CHARS?`${compact.slice(0,BODY_PREVIEW_CHARS)}...`:compact}function changelogSignalText(body){if(!body)return"";const lines=body.replace(/\r\n/g,`
|
|
140
|
+
${PKG_INFO_GUARDRAIL}`;function createPackageSummaryTool(service){return{name:"pkg_info",description:DESCRIPTION6,schema:schema6,annotations:OPEN_WORLD_READ_ONLY_TOOL_ANNOTATIONS,handler:async(args,context)=>{try{const target=parsePackageSpec(args.target.trim());if(target.version!==undefined){throw new InvalidPackageSpecError(`pkg_info always returns the latest version; omit @${target.version}.`)}const{params}=buildPackageSummaryParams({registry:target.registry,packageName:target.name});const textFormat=isTextFormat4(args.format);const summary=await service.packageSummary({...params,includeVerboseFields:!textFormat||args.verbose===true});const payload=buildPackageSummarySuccessPayload(summary);if(textFormat){return textResult(formatPackageSummaryTerminal(summary,{verbose:args.verbose,useColors:false}).trimEnd())}return textResult(JSON.stringify(payload))}catch(error){throwIfCallerCancellation(error,context?.signal);const mapped=mapPackageIntelligenceError(error);return mcpMappedErrorResult(mapped,context,args.format)}}}}function isTextFormat4(format){return format===undefined||format==="text"}import{z as z7}from"zod";class UnsupportedVulnerabilitiesRegistryError extends Error{constructor(message){super(message);this.name="UnsupportedVulnerabilitiesRegistryError"}}var SEVERITY_LABEL_TO_CVSS={low:0.1,medium:4,high:7,critical:9};var ADVISORY_SCOPE_TO_GRAPHQL={affected:"AFFECTED",non_affecting:"NON_AFFECTING",all:"ALL"};function buildPackageVulnerabilitiesParams(input){const trimmedName=input.packageName?.trim()??"";if(!trimmedName){throw new InvalidPackageSpecError("Package name is required.")}const normalisedRegistryArg=input.registry?.trim().toLowerCase()??"";if(!isKnownPkgseerRegistryArg(normalisedRegistryArg)){throw new UnsupportedRegistryError(`Unsupported registry '${input.registry}'. Supported: ${PKGSEER_REGISTRY_LIST2}.`)}const registry=toPkgseerRegistry2(normalisedRegistryArg);if(!supportsVulnerabilitiesRegistry(registry)){throw new UnsupportedVulnerabilitiesRegistryError(`pkg vulns only supports ${SUPPORTED_VULN_REGISTRIES_HUMAN}. Got: ${normalisedRegistryArg}.`)}const severityLabel=resolveMinSeverityLabel(input.minSeverity);const minSeverity=severityLabel!==undefined?SEVERITY_LABEL_TO_CVSS[severityLabel]:undefined;const version=normalisePackageVersion(input.version,registry,{rejectLeadingV:true});const advisoryScope=resolveAdvisoryScope(input.advisoryScope);const filterWithScope=buildFilterEcho(severityLabel,input.includeWithdrawn,advisoryScope);return{params:{registry,packageName:trimmedName,version,minSeverity,includeWithdrawn:input.includeWithdrawn,includeTransitive:input.includeTransitive,advisoryScope:advisoryScope?ADVISORY_SCOPE_TO_GRAPHQL[advisoryScope]:undefined},...filterWithScope?{filter:filterWithScope}:{}}}function resolveMinSeverityLabel(raw){if(raw===undefined)return;const trimmed=raw.trim();if(trimmed.length===0)return;const lower=trimmed.toLowerCase();if(!isSeverityLabel(lower)){throw new InvalidPackageSpecError(`Unsupported severity '${raw}'. Expected one of: low, medium, high, critical.`)}return lower}function buildFilterEcho(minSeverity,includeWithdrawn,advisoryScope){const filter={};if(minSeverity!==undefined)filter.minSeverity=minSeverity;if(includeWithdrawn===true)filter.includeWithdrawn=true;if(advisoryScope!==undefined&&advisoryScope!=="affected"){filter.advisoryScope=advisoryScope}return Object.keys(filter).length>0?filter:undefined}function resolveAdvisoryScope(raw){if(raw===undefined)return;const trimmed=raw.trim();if(trimmed.length===0)return;const lower=trimmed.toLowerCase().replace(/-/g,"_");if(lower==="affected"||lower==="non_affecting"||lower==="all"){return lower}throw new InvalidPackageSpecError(`Unsupported advisory scope '${raw}'. Expected one of: affected, non_affecting, all.`)}function isSeverityLabel(value){return value==="low"||value==="medium"||value==="high"||value==="critical"}var DEFAULT_CHANGELOG_LIMIT=20;var PACKAGE_UPGRADE_REVIEW_MAX_PACKAGES=30;function buildPackageUpgradeReviewRequest(input){const batch=input.packages?.filter((pkg)=>!isBlankPackageInput(pkg));const hasBatch=Array.isArray(batch)&&batch.length>0;const hasSingle=hasNonBlankValue(input.registry)||hasNonBlankValue(input.packageName)||hasNonBlankValue(input.currentVersion)||hasNonBlankValue(input.targetVersion);if(hasBatch&&hasSingle){throw new InvalidPackageSpecError("Pass either packages[] or registry/package_name/current_version/target_version, not both.")}if(!hasBatch&&!hasSingle){throw new InvalidPackageSpecError("Package upgrade review requires either packages[] or registry, package_name, current_version, and target_version.")}const packages=hasBatch?parseBatch(batch):[parsePackageInput({registry:input.registry??"",packageName:input.packageName??"",currentVersion:input.currentVersion??"",targetVersion:input.targetVersion??""})];const minSeverityLabel=resolveMinSeverityLabel2(input.minSeverity);return{packages,options:{includeTransitiveSecurity:input.includeTransitiveSecurity!==false,includeDependencyIssues:input.includeDependencyIssues===true,includeDependencyChanges:true,changelogLimit:DEFAULT_CHANGELOG_LIMIT,minSeverityLabel,minSeverity:minSeverityLabel!==undefined&&minSeverityLabel!=="low"?SEVERITY_LABEL_TO_CVSS[minSeverityLabel]:undefined}}}function hasNonBlankValue(value){return value!==undefined&&value.trim().length>0}function isBlankPackageInput(input){return!(hasNonBlankValue(input.registry)||hasNonBlankValue(input.packageName)||hasNonBlankValue(input.currentVersion)||hasNonBlankValue(input.targetVersion))}function parseBatch(packages){if(!Array.isArray(packages)||packages.length===0){throw new InvalidPackageSpecError("packages[] must contain at least one upgrade.")}if(packages.length>PACKAGE_UPGRADE_REVIEW_MAX_PACKAGES){throw new InvalidPackageSpecError(`packages[] must contain at most ${PACKAGE_UPGRADE_REVIEW_MAX_PACKAGES} upgrades.`)}return packages.map(parsePackageInput)}function parsePackageInput(input){const registryArg=input.registry?.trim().toLowerCase()??"";if(!isKnownPkgseerRegistryArg(registryArg)){throw new UnsupportedRegistryError(`Unsupported registry '${input.registry}'. Supported: ${PKGSEER_REGISTRY_LIST2}.`)}const packageName=input.packageName?.trim()??"";if(packageName.length===0){throw new InvalidPackageSpecError("Package name is required.")}const registry=toPkgseerRegistry2(registryArg);const currentVersion=normaliseVersion(input.currentVersion,"current_version",registry);const targetVersion=normaliseVersion(input.targetVersion,"target_version",registry);return{registry,registryLabel:registryArg,packageName,currentVersion,targetVersion}}function normaliseVersion(raw,fieldName,registry){const version=normalisePackageVersion(raw,registry,{rejectLeadingV:true,fieldName});if(version===undefined){throw new InvalidPackageSpecError(`${fieldName} is required.`)}return version}function resolveMinSeverityLabel2(raw){if(raw===undefined)return;const lower=raw.trim().toLowerCase();if(lower.length===0)return;if(lower==="low"||lower==="medium"||lower==="high"||lower==="critical"){return lower}throw new InvalidPackageSpecError(`Unsupported min_severity '${raw}'. Expected one of: low, medium, high, critical.`)}async function buildPackageUpgradeReview(service,packages,options){const response=await service.packageUpgradeReview({packages:packages.map((pkg)=>({registry:pkg.registry,name:pkg.packageName,currentVersion:pkg.currentVersion,targetVersion:pkg.targetVersion})),includeChangelogFullText:options.includeChangelogFullText===true,includeTransitiveSecurity:options.includeTransitiveSecurity,includeDependencyIssues:options.includeDependencyIssues,changelogLimit:options.changelogLimit,minSeverity:options.minSeverity});return normaliseBackendUpgradeReviewResponse(response)}function normaliseBackendUpgradeReviewResponse(response){return{summary:response.summary,reviews:response.reviews.map((review)=>({registry:lowerEnum(review.registry)??review.registry,name:review.name,currentVersion:review.currentVersion,targetVersion:review.targetVersion,latestVersion:review.latestVersion,versionDelta:lowerEnum(review.versionDelta),security:normaliseBackendSecurity(review.security),changelog:normaliseBackendChangelog(review.changelog),compatibility:review.compatibility,dependencyChanges:review.dependencyChanges?normaliseBackendDependencyChanges(review.dependencyChanges):undefined,dependencyIssues:review.dependencyIssues,unknowns:review.unknowns}))}}function normaliseBackendSecurity(security){return{current:security.current?normaliseBackendVersionVulnerabilitySummary(security.current):undefined,target:security.target?normaliseBackendVersionVulnerabilitySummary(security.target):undefined,added:security.added.map(normaliseBackendAdvisory),removed:security.removed.map(normaliseBackendAdvisory),notAddressed:security.notAddressed.map(normaliseBackendAdvisory),fixed:security.fixed.map(normaliseBackendAdvisory),introduced:security.introduced.map(normaliseBackendAdvisory),unchanged:security.unchanged.map(normaliseBackendAdvisory),transitive:security.transitive?normaliseBackendTransitiveSecurity(security.transitive):undefined}}function normaliseBackendVersionVulnerabilitySummary(summary){return{version:summary.version,publishedAt:summary.publishedAt,deprecated:summary.deprecated,deprecationReason:summary.deprecationReason,affectedCount:summary.affectedCount,nonAffectingCount:summary.nonAffectingCount,allCount:summary.allCount,advisories:summary.advisories.map(normaliseBackendAdvisory)}}function normaliseBackendAdvisory(advisory){return{id:advisory.id,aliases:advisory.aliases,summary:advisory.summary,severity:advisory.severity,severityLabel:lowerEnum(advisory.severityLabel),fixedIn:advisory.fixedIn,isMalicious:advisory.isMalicious}}function normaliseBackendTransitiveSecurity(transitive){return{currentAffected:transitive.currentAffected,targetAffected:transitive.targetAffected,introducedPackages:transitive.introducedPackages.map(normaliseRegistryPrefix),fixedPackages:transitive.fixedPackages.map(normaliseRegistryPrefix),introducedPackageDetails:transitive.introducedPackageDetails.entries.map(normaliseBackendTransitivePackage),introducedPackageDetailsTotalCount:transitive.introducedPackageDetails.totalCount,introducedPackageDetailsTruncated:transitive.introducedPackageDetails.truncated,fixedPackageDetails:transitive.fixedPackageDetails.entries.map(normaliseBackendTransitivePackage),fixedPackageDetailsTotalCount:transitive.fixedPackageDetails.totalCount,fixedPackageDetailsTruncated:transitive.fixedPackageDetails.truncated,stillAffectedPackageDetails:transitive.stillAffectedPackageDetails.entries.map(normaliseBackendTransitivePackage),stillAffectedPackageDetailsTotalCount:transitive.stillAffectedPackageDetails.totalCount,stillAffectedPackageDetailsTruncated:transitive.stillAffectedPackageDetails.truncated}}function normaliseBackendDependencyChanges(changes){return{direct:normaliseBackendDependencyChangeGroup(changes.direct),transitive:normaliseBackendDependencyChangeGroup(changes.transitive)}}function normaliseBackendDependencyChangeGroup(group){return{added:group.added.map(normaliseBackendDependencyChangeItem),removed:group.removed.map(normaliseBackendDependencyChangeItem),changed:group.changed.map(normaliseBackendDependencyChangeItem)}}function normaliseBackendDependencyChangeItem(item){return{name:item.name,registry:lowerEnum(item.registry),version:item.version,fromVersions:item.fromVersions,toVersions:item.toVersions,constraint:item.constraint,type:lowerEnum(item.type)}}function normaliseBackendTransitivePackage(pkg){return{id:pkg.id,registry:lowerEnum(pkg.registry)??pkg.registry,name:pkg.name,versions:pkg.versions,affectedCount:pkg.affectedCount,maxSeverityScore:pkg.maxSeverityScore,maxSeverityLabel:lowerEnum(pkg.maxSeverityLabel),advisoryIds:pkg.advisoryIds}}function normaliseBackendChangelog(changelog){return{riskItems:changelog.riskItems.map((item)=>({...item,tier:item.tier.toLowerCase(),kind:lowerEnum(item.kind),source:lowerEnum(item.source)})),riskCoverage:{...changelog.riskCoverage},source:lowerEnum(changelog.source),fallback:lowerEnum(changelog.fallback),entries:changelog.entries.map(normaliseBackendChangelogEntry),sampledEntries:changelog.sampledEntries.map(normaliseBackendChangelogEntry),keywordEntries:changelog.keywordEntries.map(normaliseBackendChangelogEntry),totalKeywordEntries:changelog.totalKeywordEntries,totalEntries:changelog.totalEntries,totalEntriesWithBodies:changelog.totalEntriesWithBodies,truncated:changelog.truncated,hasReleaseNoteBodies:changelog.hasReleaseNoteBodies,breakingSignals:changelog.breakingSignals,migrationSignals:changelog.migrationSignals}}function normaliseBackendChangelogEntry(entry){return{detailSource:lowerEnum(entry.detailSource),version:entry.version??null,publishedAt:entry.publishedAt,htmlUrl:entry.htmlUrl,body:entry.body,bodyPreview:entry.bodyPreview,headline:entry.headline,signals:entry.signals.length>0?entry.signals:undefined}}function lowerEnum(value){return value?.toLowerCase()}function normaliseRegistryPrefix(value){return value.replace(/^([A-Z_]+):/,(prefix)=>prefix.toLowerCase())}function changelogSignalText(body){if(!body)return"";const lines=body.replace(/\r\n/g,`
|
|
141
141
|
`).split(`
|
|
142
142
|
`);const kept=[];let inCommitSection=false;for(const rawLine of lines){const line=rawLine.trim();if(/^#{1,6}\s+commits?\b/i.test(line)){inCommitSection=true;continue}if(/^#{1,6}\s+/.test(line))inCommitSection=false;if(inCommitSection)continue;if(looksLikeCommitListLine(line))continue;kept.push(rawLine)}return kept.join(`
|
|
143
|
-
`)}function looksLikeCommitListLine(line){return/^[-*]\s+[0-9a-f]{7,40}\b/i.test(line)}function matchesSignalTerm(text,term){const lower=text.toLowerCase();if(term==="breaking"||term==="breaks"){if(/\b(no|without|not)\s+breaking\s+changes?\b/i.test(text))return false}return lower.includes(term)}function formatPackageUpgradeReviewTerminal(response,options={}){const useColors=options.useColors===true;const width=normaliseTerminalWidth(options.terminalWidth);const lines=[sectionTitle(`Upgrade review - ${response.reviews.length} ${response.reviews.length===1?"package":"packages"}`,useColors)];if(response.reviews.length>1){appendWrappedText(lines,"Across packages: ",aggregateSummary(response),width)}
|
|
143
|
+
`)}function looksLikeCommitListLine(line){return/^[-*]\s+[0-9a-f]{7,40}\b/i.test(line)}function matchesSignalTerm(text,term){const lower=text.toLowerCase();if(term==="breaking"||term==="breaks"){if(/\b(no|without|not)\s+breaking\s+changes?\b/i.test(text))return false}return lower.includes(term)}function formatPackageUpgradeReviewTerminal(response,options={}){const useColors=options.useColors===true;const width=normaliseTerminalWidth(options.terminalWidth);const lines=[sectionTitle(`Upgrade review - ${response.reviews.length} ${response.reviews.length===1?"package":"packages"}`,useColors)];if(response.reviews.length>1){appendWrappedText(lines,"Across packages: ",aggregateSummary(response),width)}const reviews=response.reviews.length>1?[...response.reviews].sort((a,b)=>b.changelog.riskCoverage.itemsMustActConfident-a.changelog.riskCoverage.itemsMustActConfident):response.reviews;if(reviews.length>1){appendSection(lines,formatBatchTriage(reviews,options));if(!options.verbose)return`${lines.join(`
|
|
144
144
|
`).trimEnd()}
|
|
145
|
-
`}function sectionTitle(text,useColors){return useColors?`${colors.bold}${text}${colors.reset}`:text}function attentionSectionTitle(text,useColors){return useColors?`${colors.bold}${colors.yellow}${text}${colors.reset}`:text}function normaliseTerminalWidth(width){if(width===undefined||!Number.isFinite(width))return 80;return Math.max(20,Math.floor(width))}function appendSection(lines,section){if(section.length===0)return;lines.push("",...section)}function appendWrappedText(lines,prefix,text,width,continuationPrefix=" ".repeat(prefix.length),style){const words=text.trim().split(/\s+/).filter(Boolean);if(words.length===0){lines.push(style?style(prefix.trimEnd()):prefix.trimEnd());return}let current=prefix;for(const word of words){const separator=current===prefix?"":" ";if(current.length+separator.length+word.length<=width||current===prefix&¤t.trimEnd().length>=width){current+=`${separator}${word}`;continue}lines.push(style?style(current.trimEnd()):current.trimEnd());current=`${continuationPrefix}${word}`}lines.push(style?style(current.trimEnd()):current.trimEnd())}function aggregateSummary(response){const reviewsWithTransitive=response.reviews.filter((review)=>review.security.transitive!==undefined).length;const omittedTransitive=response.reviews.length-reviewsWithTransitive;const clauses=[`${response.summary.withUnknowns} with evidence gaps`,`${response.summary.withAddedAdvisories} with added direct vulnerabilities`];if(reviewsWithTransitive===0){clauses.push("transitive security not checked")}else{clauses.push(`${response.summary.withTransitiveVulnerabilityAdditions} with added transitive vulnerabilities`);if(omittedTransitive>0)clauses.push(`${omittedTransitive} without transitive security evidence`)}clauses.push(`${response.summary.withBreakingSignals} with heuristic change signals`,`${response.summary.withDirectDependencyChanges} with direct dependency changes`);return clauses.join(" | ")}function formatDeprecationLine(review,options){const current=review.security.current;const target=review.security.target;const width=normaliseTerminalWidth(options.terminalWidth);const useColors=options.useColors===true;const hasCurrentDeprecation=current?.deprecated===true;const hasTargetDeprecation=target?.deprecated===true;const targetDeprecationUnknown=target===undefined||target.deprecated===undefined;if(!hasCurrentDeprecation&&!hasTargetDeprecation&&!targetDeprecationUnknown)return;const lines=[sectionTitle("Deprecation",useColors)];if(current?.deprecated===true)lines.push(attentionLine(" Current: deprecated",useColors));if(target?.deprecated===true){const reason=target.deprecationReason?`deprecated: ${target.deprecationReason}`:"deprecated";appendWrappedText(lines," Target: ",reason,width," ",(line)=>attentionLine(line,useColors))}if(targetDeprecationUnknown)lines.push(attentionLine(" Target: deprecation unknown",useColors));return lines.length>1?lines:undefined}function formatVulnerabilitySection(security,options){const current=security.current?.affectedCount??"unknown";const target=security.target?.affectedCount??"unknown";const width=normaliseTerminalWidth(options.terminalWidth);const useColors=options.useColors===true;const lines=[sectionTitle("Security",useColors)];appendWrappedText(lines," Direct: ",`${current} affected -> ${target} affected | ${security.removed.length} fixed | ${security.added.length} added | ${security.notAddressed.length} still present`,width," ",security.added.length>0||security.notAddressed.length>0?(line)=>attentionLine(line,useColors):undefined);lines.push(...formatTransitiveVulnerabilitySummary(security.transitive,options));const limit=options.verbose?Number.POSITIVE_INFINITY:5;appendAdvisoryLines(lines,"Added direct advisories",security.added,limit,width,useColors,true);appendAdvisoryLines(lines,"Fixed direct advisories",security.removed,limit,width,useColors,false);appendAdvisoryLines(lines,"Still present direct advisories",security.notAddressed,limit,width,useColors,true);lines.push(...formatTransitiveVulnerabilityDetails(security.transitive,options));return lines}function appendAdvisoryLines(lines,label,advisories,limit,width,useColors,attention){if(advisories.length===0)return;lines.push(attention?attentionLine(` ${label}`,useColors):` ${label}`);for(const advisory of advisories.slice(0,limit)){const prefix=` - ${formatAdvisoryPrefix(advisory)}`;const prose=formatAdvisoryProse(advisory);if(prose){appendWrappedText(lines,`${prefix}: `,prose,width," ")}else{lines.push(prefix)}}const remaining=advisories.length-limit;if(remaining>0)lines.push(` - ... +${remaining} more with verbose output`)}function formatAdvisoryPrefix(advisory){const id=advisory.id??advisory.aliases?.[0]??"unknown-id";const severity=advisory.severityLabel?` ${advisory.severityLabel}${typeof advisory.severity==="number"?`(${advisory.severity})`:""}`:"";const malicious=advisory.isMalicious?" malicious":"";return`${id}${severity}${malicious}`}function formatAdvisoryProse(advisory){const parts=[];if(advisory.summary)parts.push(advisory.summary);if(advisory.fixedIn?.length)parts.push(`fixed in ${advisory.fixedIn.join(", ")}`);return parts.join(" | ")}function formatTransitiveVulnerabilitySummary(transitive,options){const useColors=options.useColors===true;if(!transitive)return[attentionLine(" Transitive: not checked",useColors)];const lines=[];const width=normaliseTerminalWidth(options.terminalWidth);appendWrappedText(lines," Transitive: ",`${transitive.currentAffected} affected packages -> ${transitive.targetAffected} | ${transitive.fixedPackageDetailsTotalCount} fixed | ${transitive.introducedPackageDetailsTotalCount} added | ${transitive.stillAffectedPackageDetailsTotalCount} still affected`,width," ",transitive.introducedPackageDetailsTotalCount>0||transitive.stillAffectedPackageDetailsTotalCount>0?(line)=>attentionLine(line,useColors):undefined);return lines}function formatTransitiveVulnerabilityDetails(transitive,options){if(!transitive)return[];const useColors=options.useColors===true;const width=normaliseTerminalWidth(options.terminalWidth);const lines=[];const limit=options.verbose?Number.POSITIVE_INFINITY:5;appendTransitivePackageLines(lines,"Added transitive vulnerable packages",transitive.introducedPackageDetails,transitive.introducedPackageDetailsTotalCount,transitive.introducedPackageDetailsTruncated,limit,width,true,useColors);appendTransitivePackageLines(lines,"Still affected transitive packages",transitive.stillAffectedPackageDetails,transitive.stillAffectedPackageDetailsTotalCount,transitive.stillAffectedPackageDetailsTruncated,limit,width,true,useColors);appendTransitivePackageLines(lines,"Fixed transitive vulnerable packages",transitive.fixedPackageDetails,transitive.fixedPackageDetailsTotalCount,transitive.fixedPackageDetailsTruncated,limit,width,false,useColors);return lines}function appendTransitivePackageLines(lines,label,packages,totalCount,truncated,limit,width,attention,useColors){if(totalCount===0)return;lines.push(attention?attentionLine(` ${label}`,useColors):` ${label}`);const visible=packages.slice(0,limit);for(const pkg of visible)lines.push(...formatTransitivePackageLines(pkg,width));const verboseRemaining=Math.max(0,packages.length-visible.length);if(verboseRemaining>0)lines.push(` - ... +${verboseRemaining} more with verbose output`);const backendRemaining=Math.max(0,totalCount-packages.length);if(truncated||backendRemaining>0)lines.push(` - ... +${backendRemaining} more not returned by backend page`)}function formatTransitivePackageLines(pkg,width){const severity=pkg.maxSeverityLabel?` ${pkg.maxSeverityLabel}${typeof pkg.maxSeverityScore==="number"?`(${pkg.maxSeverityScore})`:""}`:"";const lines=[` - ${pkg.registry}:${pkg.name}@${pkg.versions.join("|")} affected=${pkg.affectedCount}${severity}`];if(pkg.advisoryIds.length>0){const prefix=" Advisories: ";appendWrappedText(lines,prefix,pkg.advisoryIds.join(", "),width," ".repeat(prefix.length))}return lines}function formatChangesSection(changelog,options){const width=normaliseTerminalWidth(options.terminalWidth);const useColors=options.useColors===true;const source=formatChangelogSource(changelog);const entryWord=changelog.totalEntries===1?"entry":"entries";const lines=[sectionTitle("Changes",useColors)];let coverage=`${source} | ${changelog.totalEntries} ${entryWord} | ${changelog.totalEntriesWithBodies} with release notes`;if(changelog.truncated)coverage+=` | ${changelog.sampledEntries.length} release entries sampled`;appendWrappedText(lines," ",coverage,width," ");const keywords=changelogKeywordSummary(changelog);if(keywords.length>0||changelog.totalKeywordEntries>0){const keywordWord=changelog.totalKeywordEntries===1?"matching entry":"matching entries";appendWrappedText(lines," Heuristic signals: ",`${keywords.length>0?keywords.join(", "):"unspecified"} | ${changelog.totalKeywordEntries} ${keywordWord}`,width," ",(line)=>colorizeSignalKeywords(line,keywords,useColors))}const renderedKeys=new Set;const keywordEntries=changelog.keywordEntries.filter((entry)=>{const key=changelogEntryKey(entry);if(renderedKeys.has(key))return false;renderedKeys.add(key);return true});if(keywordEntries.length>0){lines.push(" Heuristic release entries");for(const entry of keywordEntries){lines.push(...formatKeywordChangelogEntry(entry,options,width,useColors))}}const sampledEntries=changelog.sampledEntries.filter((entry)=>{const key=changelogEntryKey(entry);if(renderedKeys.has(key))return false;renderedKeys.add(key);return true});appendPlainChangelogEntries(lines,"Sampled release entries",sampledEntries,width);if(options.verbose===true){const otherEntries=changelog.entries.filter((entry)=>{if(!entry.bodyPreview)return false;const key=changelogEntryKey(entry);if(renderedKeys.has(key))return false;renderedKeys.add(key);return true});appendPlainChangelogEntries(lines,"Other release entries",otherEntries,width)}return lines}function formatChangelogSource(changelog){const source=changelog.source||changelog.fallback;const sourceKey=source?.toLowerCase();if(sourceKey==="releases")return"Repository releases";if(sourceKey==="package_versions")return"Package versions (no release notes)";return source??"Changelog source unavailable"}function appendPlainChangelogEntries(lines,label,entries,width){if(entries.length===0)return;lines.push(` ${label}`);for(const entry of entries){lines.push(...formatPlainChangelogEntry(entry,width))}}function changelogEntryKey(entry){return`${entry.version??"unknown"}:${entry.publishedAt??""}:${entry.htmlUrl??""}`}function formatCompatibilitySection(compatibility,options){if(compatibility.peerDependencyChanges.length===0&&compatibility.notes.length===0)return[];const width=normaliseTerminalWidth(options.terminalWidth);const lines=[sectionTitle("Compatibility",options.useColors===true)];if(compatibility.peerDependencyChanges.length>0){lines.push(" Peer dependency changes");const limit=options.verbose?Number.POSITIVE_INFINITY:10;for(const change of compatibility.peerDependencyChanges.slice(0,limit)){appendWrappedText(lines," - ",change,width," ")}const remaining=compatibility.peerDependencyChanges.length-limit;if(remaining>0)lines.push(` - ... +${remaining} more with verbose output`)}for(const note of compatibility.notes){appendWrappedText(lines," Note: ",note,width," ")}return lines}function changelogKeywordSummary(changelog){return[...new Set([...changelog.breakingSignals,...changelog.migrationSignals])]}function formatKeywordChangelogEntry(entry,options,width,useColors){const lines=formatChangelogEntryHeader(entry,width);const matched=formatMatchedExcerpts(entry,options.verbose===true);for(const excerpt of matched){appendWrappedText(lines," ",excerpt,width," ",(line)=>colorizeSignalMarker(line,useColors))}return lines}function colorizeSignalMarker(line,useColors){if(!useColors)return line;return line.replace(/^(\s*\[[^\]]+\]:)/,`${colors.yellow}$1${colors.reset}`)}function colorizeSignalKeywords(line,keywords,useColors){if(!useColors||keywords.length===0)return line;let result=line;for(const keyword of keywords){result=result.replace(keyword,`${colors.yellow}${keyword}${colors.reset}`)}return result}function formatPlainChangelogEntry(entry,width){const lines=formatChangelogEntryHeader(entry,width);if(entry.headline){appendWrappedText(lines," ",preview(entry.headline)??entry.headline,width," ")}return lines}function formatChangelogEntryHeader(entry,width){const version=entry.version??"unknown-version";const header=` - ${version}${entry.publishedAt?` (${entry.publishedAt})`:""}`;if(!entry.htmlUrl)return[header];if(header.length+1+entry.htmlUrl.length<=width)return[`${header} ${entry.htmlUrl}`];return[header,` ${entry.htmlUrl}`]}function formatMatchedExcerpts(entry,verbose){if(!entry.body||!entry.signals?.length)return[];const excerpts=[];const chunks=changelogExcerptChunks(entry.body);const seen=new Set;for(const signal of entry.signals){for(const chunk of chunks){if(!matchesSignalTerm(chunk,signal))continue;const excerpt=excerptAroundSignal(chunk,signal,verbose);const key=`${signal}:${excerpt}`;if(seen.has(key))continue;seen.add(key);excerpts.push(`[${signal}]: ${excerpt}`);break}}return excerpts}function changelogExcerptChunks(body){return changelogSignalText(body).split(/\r?\n+/).map((line)=>normaliseChangelogLine(line)).filter((line)=>line.length>0&&!isGenericChangelogHeading(line))}function excerptAroundSignal(text,signal,verbose){if(verbose)return text;const lower=text.toLowerCase();const index=lower.indexOf(signal.toLowerCase());if(index<0)return preview(text)??text;const radius=120;const start=Math.max(0,index-radius);const end=Math.min(text.length,index+signal.length+radius);const prefix=start>0?"...":"";const suffix=end<text.length?"...":"";return`${prefix}${text.slice(start,end).trim()}${suffix}`}function normaliseChangelogLine(line){return line.replace(/^#{1,6}\s+/,"").trim()}function isGenericChangelogHeading(line){return/^(what'?s changed|main changes|changes|commits?|contributors?|breaking changes?)$/i.test(line.trim())}function formatDependencyChangesSection(changes,options){const useColors=options.useColors===true;const lines=[sectionTitle("Dependencies",useColors)];lines.push(` Direct: ${changes.direct.added.length} added | ${changes.direct.removed.length} removed | ${changes.direct.changed.length} changed`);lines.push(...formatDependencyChangeGroup("Direct",changes.direct,options));lines.push(` Transitive: ${changes.transitive.added.length} added | ${changes.transitive.removed.length} removed | ${changes.transitive.changed.length} changed`);if(options.verbose){lines.push(...formatDependencyChangeGroup("Transitive",changes.transitive,options))}else if(hasDependencyChangeGroupItems(changes.transitive)){lines.push(" More transitive dependency details are available with verbose output.")}return lines}function hasDependencyChangeGroupItems(group){return group.added.length>0||group.removed.length>0||group.changed.length>0}function formatDependencyChangeGroup(scope,group,options){const lines=[];const limit=options.verbose?Number.POSITIVE_INFINITY:5;appendChangeLines(lines,`${scope} added`,group.added,limit);appendChangeLines(lines,`${scope} removed`,group.removed,limit);appendChangeLines(lines,`${scope} changed`,group.changed,limit);return lines}function appendChangeLines(lines,label,items,limit){if(items.length===0)return;const sample=items.slice(0,limit).map(formatDependencyChangeItem);const more=items.length>limit?` (+${items.length-limit} more)`:"";lines.push(` ${label}${more?`${more} with verbose output`:""}`);for(const item of sample)lines.push(` - ${item}`)}function formatDependencyIssuesSection(issues,options){const introduced=issues.introducedDeprecated.length+issues.introducedDuplicates.length+issues.introducedConflicts.length+issues.introducedOutdated.length;const useColors=options.useColors===true;const limit=options.verbose?Number.POSITIVE_INFINITY:5;const lines=[sectionTitle("Dependency issues",useColors)];if(introduced===0){lines.push(` none introduced | current total: ${issues.currentTotal} | target total: ${issues.targetTotal}`);return lines}lines.push(attentionLine(` ${introduced} introduced | current total: ${issues.currentTotal} | target total: ${issues.targetTotal}`,useColors));appendStringList(lines,"Introduced deprecated",issues.introducedDeprecated,limit,useColors);appendStringList(lines,"Introduced duplicates",issues.introducedDuplicates,limit,useColors);appendStringList(lines,"Introduced conflicts",issues.introducedConflicts,limit,useColors);appendStringList(lines,"Introduced outdated",issues.introducedOutdated,limit,useColors);return lines}function appendStringList(lines,label,items,limit,useColors){if(items.length===0)return;lines.push(attentionLine(` ${label}`,useColors));for(const item of items.slice(0,limit))lines.push(` - ${item}`);const remaining=items.length-limit;if(remaining>0)lines.push(` - ... +${remaining} more with verbose output`)}function attentionLine(text,useColors){return colorize(text,"yellow",useColors)}function formatDependencyChangeItem(item){const name=item.registry?`${item.registry}:${item.name}`:item.name;const from=item.fromVersions?.join("|")??"";const to=item.toVersions?.join("|")??"";if(from&&to&&from!==to)return`${name} ${from} -> ${to}`;if(to)return`${name}@${to}`;if(from)return`${name}@${from}`;return name}var packageSchema=z7.object({registry:z7.string().describe(`Package registry. Supported: ${PKGSEER_REGISTRY_LIST2}.`),package_name:z7.string().describe("Package name, scoped names ok."),current_version:z7.string().describe("Currently used package version. Go accepts versions with or without its canonical v prefix; tag-style v prefixes are rejected for other registries except Swift."),target_version:z7.string().describe("Target package version. Go accepts versions with or without its canonical v prefix; tag-style v prefixes are rejected for other registries except Swift.")});var schema7={registry:z7.string().optional().describe(`Package registry for single-package mode. Supported: ${PKGSEER_REGISTRY_LIST2}.`),package_name:z7.string().optional().describe("Package name for single-package mode."),current_version:z7.string().optional().describe("Currently used version for single-package mode. Go accepts versions with or without its canonical v prefix; tag-style v prefixes are rejected for other registries except Swift."),target_version:z7.string().optional().describe("Target version for single-package mode. Go accepts versions with or without its canonical v prefix; tag-style v prefixes are rejected for other registries except Swift."),packages:z7.array(packageSchema).optional().describe(`Batch mode with at most ${PACKAGE_UPGRADE_REVIEW_MAX_PACKAGES} upgrades after blank rows are removed. Mutually exclusive with single-package fields.`),skip_transitive_security:z7.boolean().optional().describe("When true, skip current-vs-target transitive vulnerability summary diffs. Defaults false, so transitive security evidence is included unless explicitly skipped."),include_dependency_issues:z7.boolean().optional().describe("When true, diff current vs target transitive deprecated/outdated/duplicate/conflict summaries. Defaults false."),min_severity:z7.string().optional().describe("Minimum direct-advisory severity: low, medium, high, or critical."),verbose:z7.boolean().optional().describe("Text output only. Include dependency change examples, including transitive version changes."),format:z7.enum(["text","json"]).default("text").describe("Omit `format` to use token-efficient text when the model reads the result or chooses follow-up tools. Set `json` only when code consumes the raw response instead of the model, or a required field is absent from text.")};var DESCRIPTION7="Review a package upgrade: vulnerabilities, releases, peers, dependency changes. "+"Compares current and target versions using direct vulnerability checks, changelog ranges, target deprecation metadata, peer dependency changes, and optional transitive evidence diffs. "+"The tool reports facts only and does not assign risk or decide whether to accept an upgrade. "+"Use this instead of inferring acceptability from semver, including patch bumps. "+"Use signals as a starting point to evaluate the impact of changes on the codebase. "+"You can use pkg_changelog and code_diff to obtain full release-note and source-change details. "+"Accepts either one package via registry/package_name/current_version/"+`target_version or batch \`packages[]\` with at most ${PACKAGE_UPGRADE_REVIEW_MAX_PACKAGES} upgrades.`+`
|
|
145
|
+
`}for(const review of reviews){lines.push("");lines.push(highlight(`${review.registry}:${review.name} ${review.currentVersion} -> ${review.targetVersion} (${review.versionDelta})`,useColors));appendSection(lines,formatVulnerabilitySection(review.security,options));const deprecation=formatDeprecationLine(review,options);if(deprecation)appendSection(lines,deprecation);appendSection(lines,formatChangesSection(review.changelog,options));if(review.compatibility){appendSection(lines,formatCompatibilitySection(review.compatibility,options))}if(review.dependencyChanges){appendSection(lines,formatDependencyChangesSection(review.dependencyChanges,options))}if(review.dependencyIssues)appendSection(lines,formatDependencyIssuesSection(review.dependencyIssues,options));if(review.unknowns.length>0){const unknownLines=[attentionSectionTitle("Unknown evidence",useColors)];for(const unknown of review.unknowns){appendWrappedText(unknownLines," - ",unknown,width," ")}appendSection(lines,unknownLines)}}return`${lines.join(`
|
|
146
|
+
`).trimEnd()}
|
|
147
|
+
`}function sectionTitle(text,useColors){return useColors?`${colors.bold}${text}${colors.reset}`:text}function attentionSectionTitle(text,useColors){return useColors?`${colors.bold}${colors.yellow}${text}${colors.reset}`:text}function normaliseTerminalWidth(width){if(width===undefined||!Number.isFinite(width))return 80;return Math.max(20,Math.floor(width))}function appendSection(lines,section){if(section.length===0)return;lines.push("",...section)}function appendWrappedText(lines,prefix,text,width,continuationPrefix=" ".repeat(prefix.length),style){const words=text.trim().split(/\s+/).filter(Boolean);if(words.length===0){lines.push(style?style(prefix.trimEnd()):prefix.trimEnd());return}let current=prefix;for(const word of words){const separator=current===prefix?"":" ";if(current.length+separator.length+word.length<=width||current===prefix&¤t.trimEnd().length>=width){current+=`${separator}${word}`;continue}if(current.trim())lines.push(style?style(current.trimEnd()):current.trimEnd());current=`${continuationPrefix}${word}`}lines.push(style?style(current.trimEnd()):current.trimEnd())}function aggregateSummary(response){const reviewsWithTransitive=response.reviews.filter((review)=>review.security.transitive!==undefined).length;const omittedTransitive=response.reviews.length-reviewsWithTransitive;const clauses=[`${response.summary.withUnknowns} with reported unknowns`,`${response.summary.withAddedAdvisories} with added direct vulnerabilities`];const classificationGaps=response.reviews.filter(({changelog})=>{const coverage=changelog.riskCoverage;return coverage.versionsNotAssessed>0||coverage.versionsWithoutNotes>0||coverage.versionsUnparseable>0}).length;if(classificationGaps>0)clauses.splice(1,0,`${classificationGaps} with classification coverage gaps`);if(reviewsWithTransitive===0){clauses.push("transitive security not checked")}else{clauses.push(`${response.summary.withTransitiveVulnerabilityAdditions} with added transitive vulnerabilities`);if(omittedTransitive>0)clauses.push(`${omittedTransitive} without transitive security evidence`)}clauses.push(`${response.summary.withBreakingSignals} with heuristic change signals`,`${response.summary.withDirectDependencyChanges} with direct dependency changes`);return clauses.join(" | ")}function formatDeprecationLine(review,options){const current=review.security.current;const target=review.security.target;const width=normaliseTerminalWidth(options.terminalWidth);const useColors=options.useColors===true;const hasCurrentDeprecation=current?.deprecated===true;const hasTargetDeprecation=target?.deprecated===true;const targetDeprecationUnknown=target===undefined||target.deprecated===undefined;if(!hasCurrentDeprecation&&!hasTargetDeprecation&&!targetDeprecationUnknown)return;const lines=[sectionTitle("Deprecation",useColors)];if(current?.deprecated===true)lines.push(attentionLine(" Current: deprecated",useColors));if(target?.deprecated===true){const reason=target.deprecationReason?`deprecated: ${target.deprecationReason}`:"deprecated";appendWrappedText(lines," Target: ",reason,width," ",(line)=>attentionLine(line,useColors))}if(targetDeprecationUnknown)lines.push(attentionLine(" Target: deprecation unknown",useColors));return lines.length>1?lines:undefined}function formatVulnerabilitySection(security,options){const current=security.current?.affectedCount??"unknown";const target=security.target?.affectedCount??"unknown";const width=normaliseTerminalWidth(options.terminalWidth);const useColors=options.useColors===true;const lines=[sectionTitle("Security",useColors)];appendWrappedText(lines," Direct: ",`${current} affected -> ${target} affected | ${security.removed.length} fixed | ${security.added.length} added | ${security.notAddressed.length} still present`,width," ",security.added.length>0||security.notAddressed.length>0?(line)=>attentionLine(line,useColors):undefined);lines.push(...formatTransitiveVulnerabilitySummary(security.transitive,options));const limit=options.verbose?Number.POSITIVE_INFINITY:5;appendAdvisoryLines(lines,"Added direct advisories",security.added,limit,width,useColors,true);appendAdvisoryLines(lines,"Fixed direct advisories",security.removed,limit,width,useColors,false);appendAdvisoryLines(lines,"Still present direct advisories",security.notAddressed,limit,width,useColors,true);lines.push(...formatTransitiveVulnerabilityDetails(security.transitive,options));return lines}function appendAdvisoryLines(lines,label,advisories,limit,width,useColors,attention){if(advisories.length===0)return;lines.push(attention?attentionLine(` ${label}`,useColors):` ${label}`);for(const advisory of advisories.slice(0,limit)){const prefix=` - ${formatAdvisoryPrefix(advisory)}`;const prose=formatAdvisoryProse(advisory);if(prose){appendWrappedText(lines,`${prefix}: `,prose,width," ")}else{lines.push(prefix)}}const remaining=advisories.length-limit;if(remaining>0)lines.push(` - ... +${remaining} more with verbose output`)}function formatAdvisoryPrefix(advisory){const id=advisory.id??advisory.aliases?.[0]??"unknown-id";const severity=advisory.severityLabel?` ${advisory.severityLabel}${typeof advisory.severity==="number"?`(${advisory.severity})`:""}`:"";const malicious=advisory.isMalicious?" malicious":"";return`${id}${severity}${malicious}`}function formatAdvisoryProse(advisory){const parts=[];if(advisory.summary)parts.push(advisory.summary);if(advisory.fixedIn?.length)parts.push(`fixed in ${advisory.fixedIn.join(", ")}`);return parts.join(" | ")}function formatTransitiveVulnerabilitySummary(transitive,options){const useColors=options.useColors===true;if(!transitive)return[attentionLine(" Transitive: not checked",useColors)];const lines=[];const width=normaliseTerminalWidth(options.terminalWidth);appendWrappedText(lines," Transitive: ",`${transitive.currentAffected} affected packages -> ${transitive.targetAffected} | ${transitive.fixedPackageDetailsTotalCount} fixed | ${transitive.introducedPackageDetailsTotalCount} added | ${transitive.stillAffectedPackageDetailsTotalCount} still affected`,width," ",transitive.introducedPackageDetailsTotalCount>0||transitive.stillAffectedPackageDetailsTotalCount>0?(line)=>attentionLine(line,useColors):undefined);return lines}function formatTransitiveVulnerabilityDetails(transitive,options){if(!transitive)return[];const useColors=options.useColors===true;const width=normaliseTerminalWidth(options.terminalWidth);const lines=[];const limit=options.verbose?Number.POSITIVE_INFINITY:5;appendTransitivePackageLines(lines,"Added transitive vulnerable packages",transitive.introducedPackageDetails,transitive.introducedPackageDetailsTotalCount,transitive.introducedPackageDetailsTruncated,limit,width,true,useColors);appendTransitivePackageLines(lines,"Still affected transitive packages",transitive.stillAffectedPackageDetails,transitive.stillAffectedPackageDetailsTotalCount,transitive.stillAffectedPackageDetailsTruncated,limit,width,true,useColors);appendTransitivePackageLines(lines,"Fixed transitive vulnerable packages",transitive.fixedPackageDetails,transitive.fixedPackageDetailsTotalCount,transitive.fixedPackageDetailsTruncated,limit,width,false,useColors);return lines}function appendTransitivePackageLines(lines,label,packages,totalCount,truncated,limit,width,attention,useColors){if(totalCount===0)return;lines.push(attention?attentionLine(` ${label}`,useColors):` ${label}`);const visible=packages.slice(0,limit);for(const pkg of visible)lines.push(...formatTransitivePackageLines(pkg,width));const verboseRemaining=Math.max(0,packages.length-visible.length);if(verboseRemaining>0)lines.push(` - ... +${verboseRemaining} more with verbose output`);const backendRemaining=Math.max(0,totalCount-packages.length);if(truncated||backendRemaining>0)lines.push(` - ... +${backendRemaining} more not returned by backend page`)}function formatTransitivePackageLines(pkg,width){const severity=pkg.maxSeverityLabel?` ${pkg.maxSeverityLabel}${typeof pkg.maxSeverityScore==="number"?`(${pkg.maxSeverityScore})`:""}`:"";const lines=[` - ${pkg.registry}:${pkg.name}@${pkg.versions.join("|")} affected=${pkg.affectedCount}${severity}`];if(pkg.advisoryIds.length>0){const prefix=" Advisories: ";appendWrappedText(lines,prefix,pkg.advisoryIds.join(", "),width," ".repeat(prefix.length))}return lines}function formatChangesSection(changelog,options){const width=normaliseTerminalWidth(options.terminalWidth);const lines=[sectionTitle("Changes (classified by agent)",options.useColors===true)];appendWrappedText(lines," ",`${formatRiskTierCount(changelog,"must_act","require action")} | ${formatRiskTierCount(changelog,"should_know","should know")} | ${changelog.riskCoverage.itemsUnclassified} too long to classify`,width," ");appendWrappedText(lines," Classification versions: ",`${riskCoverageText(changelog)} | ${changelog.riskCoverage.unitsNoImpact} statements labeled no impact`,width," ");const coverage=changelog.riskCoverage;if(coverage.itemsOmitted>0)appendWrappedText(lines," ",`${coverage.itemsOmitted} statements omitted by backend (lowest priority first).`,width," ");if(coverage.versionsNotAssessed>0)appendWrappedText(lines," ",PENDING_CLASSIFICATION_MESSAGE,width," ");if(coverage.versionsWithoutNotes>0||coverage.versionsUnparseable>0)appendWrappedText(lines," ","Missing or unparseable notes are not evidence of no risk.",width," ");if(changelog.fallback==="package_versions")appendWrappedText(lines," ","Release notes unavailable; using package versions.",width," ");if(changelog.truncated)appendWrappedText(lines," ","Release-note entries and links are sampled; statement coverage spans the upgrade range.",width," ");const sources=new Map;const sourceName=(source)=>source==="releases"?"Release notes":source==="changelog_file"?"Changelog":source?safeRiskText(source):undefined;const reference=(url,source)=>{const cleanUrl=url?safeRiskText(url):undefined;const key=cleanUrl??`missing:${source??"unknown"}`;let record=sources.get(key);if(!record){const name=sourceName(source);record={number:sources.size+1,label:cleanUrl?`${name?`${name}: `:""}${cleanUrl}`:`${name??"Source unavailable"} (entry URL not returned)`};sources.set(key,record)}return`[${record.number}]`};const groups=new Map;const groupFor=(version)=>{let group=groups.get(version);if(!group){group={version,items:[],entries:[]};groups.set(version,group)}return group};const entries=new Map;for(const entry of[...changelog.entries,...changelog.sampledEntries,...changelog.keywordEntries]){const key=JSON.stringify([entry.version,entry.detailSource,entry.htmlUrl,entry.publishedAt]);const previous=entries.get(key);entries.set(key,previous?{...previous,body:previous.body??entry.body,headline:previous.headline??entry.headline,bodyPreview:previous.bodyPreview??entry.bodyPreview,signals:[...new Set([...previous.signals??[],...entry.signals??[]])]}:entry)}for(const entry of entries.values())groupFor(entry.version).entries.push(entry);for(const item of changelog.riskItems)groupFor(item.version).items.push(item);let excerpted=false;for(const group of groups.values()){const keywords=[];for(const entry of group.entries){const chunks=changelogExcerptChunks(entry.body??entry.headline??entry.bodyPreview??"");const matches=new Map;for(const signal of entry.signals??[]){const chunk=chunks.find((chunk)=>matchesSignalTerm(chunk,signal));const text=chunk??"";matches.set(text,[...matches.get(text)??[],signal])}for(const[text,signals]of matches){const plain=releaseNoteText(text,()=>"");const item=plain&&entry.detailSource!==undefined?group.items.find((item)=>item.source===entry.detailSource&&releaseNoteText(item.text,()=>"").includes(plain)):undefined;if(!item)keywords.push({text,signals,entry})}}if(group.items.length===0&&keywords.length===0&&!options.verbose)continue;const sourceForItem=(item)=>{const entry=group.entries.find((entry)=>item.source!==undefined&&entry.detailSource===item.source&&entry.htmlUrl);return reference(item.url??entry?.htmlUrl,item.source)};const noteReferences=new Map;for(const item of group.items){if(!item.url)continue;noteReferences.set(sourceForItem(item),sourceName(item.source)??"Notes")}for(const entry of group.entries){if(!entry.htmlUrl)continue;noteReferences.set(reference(entry.htmlUrl,entry.detailSource),sourceName(entry.detailSource)??"Notes")}const version=group.version===null?"Unversioned notes":safeRiskText(group.version);const notes=[...noteReferences].map(([citation,label])=>`${label} ${citation}`);appendWrappedText(lines," ",`${version}${notes.length?` (${notes.join("; ")})`:""}`,width," ");const sections=[{label:"Requires action",items:group.items.filter((item)=>item.tier==="must_act"&&!isUncertainRiskItem(item))},{label:"Possibly requires action",items:group.items.filter((item)=>item.tier==="must_act"&&isUncertainRiskItem(item))},{label:"Should know",items:group.items.filter((item)=>item.tier==="should_know").sort((a,b)=>Number(isUncertainRiskItem(a))-Number(isUncertainRiskItem(b)))},{label:"Too long to classify - read it",items:group.items.filter((item)=>item.tier==="unclassified")}];for(const{label,items}of sections){if(items.length===0)continue;lines.push(` ${label}`);for(const item of items){const source=sourceForItem(item);const quote=releaseNoteText(item.text,(url)=>reference(url));const limit=item.tier==="must_act"||options.verbose?Infinity:240;const characters=Array.from(quote);const shortened=characters.length>limit;excerpted||=shortened;const shown=shortened?`${characters.slice(0,limit).join("").trimEnd()}...`:quote;const kind=item.kind?`[${RISK_KIND_LABELS[item.kind]??safeRiskText(item.kind)}]`:"";const uncertain=isUncertainRiskItem(item);appendWrappedText(lines," * ",`${kind?`${kind} `:""}${uncertain?"(uncertain) ":""}"${shown}" ${source}${item.textTruncated?" [statement truncated by backend]":""}`,width," ",(line)=>{const labeled=kind?line.replace(kind,colorize(kind,"yellow",options.useColors===true)):line;return uncertain?labeled.replace("(uncertain)",colorize("(uncertain)","dim",options.useColors===true)):labeled});if(options.verbose){const details=[item.heading?`heading: ${releaseNoteText(item.heading,(url)=>reference(url))}`:undefined,item.tierConfidence!==undefined?`tier confidence: ${item.tierConfidence}`:undefined,item.kindConfidence!==undefined?`kind confidence: ${item.kindConfidence}`:undefined].filter(Boolean).join(" | ");if(details)appendWrappedText(lines," ",details,width," ")}}}if(keywords.length>0)lines.push(" Keyword matches");for(const keyword of keywords){const source=reference(keyword.entry.htmlUrl,keyword.entry.detailSource);const quote=releaseNoteText(keyword.text,(url)=>reference(url));const characters=Array.from(quote);const shortened=!options.verbose&&characters.length>240;excerpted||=shortened;const shown=shortened?`${characters.slice(0,240).join("").trimEnd()}...`:quote;appendWrappedText(lines," * ",`[${safeRiskText(keyword.signals.join(", "))}] ${shown?`"${shown}"`:"no excerpt returned"} ${source}`,width," ",(line)=>colorizeSignalKeywords(line,keyword.signals,options.useColors===true))}if(options.verbose&&group.items.length===0&&keywords.length===0){for(const entry of group.entries){const source=reference(entry.htmlUrl,entry.detailSource);const quote=releaseNoteText(entry.bodyPreview??entry.headline??"",(url)=>reference(url));appendWrappedText(lines," * ",`${quote?`"${quote}"`:"No statement text returned."} ${source}`,width," ")}}}const entrySignals=new Set([...entries.values()].flatMap((entry)=>entry.signals??[]));const keywords=changelogKeywordSummary(changelog).filter((signal)=>!entrySignals.has(signal));if(keywords.length||entries.size===0&&changelog.totalKeywordEntries>0)appendWrappedText(lines," Keyword matches without excerpts: ",safeRiskText(keywords.join(", ")||`${changelog.totalKeywordEntries} entries`),width," ",(line)=>colorizeSignalKeywords(line,keywords,options.useColors===true));const cited=new Set([...lines.join(`
|
|
148
|
+
`).matchAll(/\[(\d+)\]/g)].map((match)=>Number(match[1])));const visibleSources=[...sources.values()].filter((source)=>cited.has(source.number));if(visibleSources.length){lines.push(" Sources");for(const source of visibleSources)lines.push(` [${source.number}] ${source.label}`)}if(excerpted)appendWrappedText(lines," ","Quotes ending in ... are excerpts; use verbose for full text.",width," ");return lines}function releaseNoteText(text,reference){const plain=safeRiskText(text.split(/\r?\n/).map((line)=>line.replace(/^\s*(?:>\s*)+/,"").replace(/^\s*(?:[-*+]\s+|\d+[.)]\s+)/,"").replace(/\[!([A-Z]+)\]/g,"$1:")).join(" ")).replace(/`([^`]+)`/g,"$1").replace(/\[([^\]]+)\]\[[^\]]*\]/g,"$1").replace(/\[(\d+)\](?!\()/g,"($1)");return plain.replace(/\[([^\]]+)\]\((https?:\/\/[^\s)]+)\)|(https?:\/\/[^\s<>]+)/g,(_match,label,linkedUrl,bareUrl)=>{if(linkedUrl)return`${label??""} ${reference(linkedUrl)}`.trim();const rawUrl=bareUrl??"";const url=rawUrl.replace(/[.,;:!?)]*$/,"");return`${reference(url)}${rawUrl.slice(url.length)}`}).replace(/\s+/g," ").trim()}var RISK_KIND_LABELS={removes_or_renames_api:"removal",changes_behavior_or_default:"behavior",raises_runtime_or_platform_requirement:"runtime/platform",changes_packaging_or_module_format:"packaging/modules",deprecates_without_removal:"deprecation",security_fix:"security fix",notable_change:"notable change"};var PENDING_CLASSIFICATION_MESSAGE="Classification is still running or may have failed. Rerun in a few seconds to a minute to fill not-assessed versions from completed stored labels, without rerunning the model.";function isUncertainRiskItem(item){return item.ambiguous}function formatRiskTierCount(changelog,tier,label){const coverage=changelog.riskCoverage;const confident=tier==="must_act"?coverage.itemsMustActConfident:coverage.itemsShouldKnowConfident;const uncertain=tier==="must_act"?coverage.itemsMustActAmbiguous:coverage.itemsShouldKnowAmbiguous;return`${confident} ${label}${uncertain?` (+${uncertain} uncertain)`:""}`}function riskCoverageText(changelog){const c=changelog.riskCoverage;return`${c.versionsClassified} classified | ${c.versionsNotAssessed} not assessed | ${c.versionsWithoutNotes} without notes${c.versionsUnparseable>0?` | ${c.versionsUnparseable} unparseable`:""}`}function safeRiskText(value){return sanitizeTerminalText(value.replace(/\s+/g," ")).trim()}function formatBatchTriage(reviews,options){const lines=[sectionTitle("Batch triage - statement totals",options.useColors===true)];for(const review of reviews){const c=review.changelog;const target=review.security.target;const deprecation=target?.deprecated===true?"deprecated":target?.deprecated===false?"not deprecated":"deprecation unknown";const transitive=review.security.transitive;const security=`direct vulnerabilities: ${review.security.added.length} added / ${review.security.notAddressed.length} still present`;const transitiveText=transitive?`transitive: ${transitive.introducedPackageDetailsTotalCount} added / ${transitive.stillAffectedPackageDetailsTotalCount} still affected`:"transitive: not checked";const dependencyCount=review.dependencyChanges?[review.dependencyChanges.direct.added,review.dependencyChanges.direct.removed,review.dependencyChanges.direct.changed].reduce((n,rows)=>n+rows.length,0):undefined;const issues=review.dependencyIssues;const issueCount=issues?issues.introducedDeprecated.length+issues.introducedDuplicates.length+issues.introducedConflicts.length+issues.introducedOutdated.length:undefined;lines.push(` ${safeRiskText(`${review.registry}:${review.name} ${review.currentVersion} -> ${review.targetVersion} (${review.versionDelta})`)} | ${formatRiskTierCount(c,"must_act","act")} | ${formatRiskTierCount(c,"should_know","know")} | ${c.riskCoverage.itemsUnclassified} too long to classify | versions: ${riskCoverageText(c)} | ${c.riskCoverage.unitsNoImpact} labeled no impact | ${c.riskCoverage.itemsOmitted} omitted | ${deprecation} | ${security} | ${transitiveText} | ${c.totalKeywordEntries} keyword entries | ${review.compatibility?.peerDependencyChanges.length??"not checked"} peer dependency changes | ${review.compatibility?.notes.length??"not checked"} compatibility notes | ${dependencyCount??"not checked"} direct dependency changes | ${issueCount??"not checked"} dependency issues | ${review.unknowns.length} unknowns`)}const width=normaliseTerminalWidth(options.terminalWidth);if(reviews.some((review)=>review.changelog.riskCoverage.versionsNotAssessed>0))appendWrappedText(lines," ",PENDING_CLASSIFICATION_MESSAGE,width," ");appendWrappedText(lines," ","Counts separate backend-confident statements from uncertain ones; ranking uses only confident action totals. Totals include omitted statements; quotes are capped by the backend.",width," ");appendWrappedText(lines," ","Classified by an agent. Missing or unparseable notes are not evidence of no risk. Use verbose for full per-package quotes and evidence.",width," ");return lines}function formatCompatibilitySection(compatibility,options){if(compatibility.peerDependencyChanges.length===0&&compatibility.notes.length===0)return[];const width=normaliseTerminalWidth(options.terminalWidth);const lines=[sectionTitle("Compatibility",options.useColors===true)];if(compatibility.peerDependencyChanges.length>0){lines.push(" Peer dependency changes");const limit=options.verbose?Number.POSITIVE_INFINITY:10;for(const change of compatibility.peerDependencyChanges.slice(0,limit)){appendWrappedText(lines," - ",change,width," ")}const remaining=compatibility.peerDependencyChanges.length-limit;if(remaining>0)lines.push(` - ... +${remaining} more with verbose output`)}for(const note of compatibility.notes){appendWrappedText(lines," Note: ",note,width," ")}return lines}function changelogKeywordSummary(changelog){return[...new Set([...changelog.breakingSignals,...changelog.migrationSignals])]}function colorizeSignalKeywords(line,keywords,useColors){if(!useColors||keywords.length===0)return line;let result=line;for(const keyword of keywords){result=result.replace(keyword,`${colors.yellow}${keyword}${colors.reset}`)}return result}function changelogExcerptChunks(body){return changelogSignalText(body).split(/\r?\n+/).map((line)=>normaliseChangelogLine(line)).filter((line)=>line.length>0&&!isGenericChangelogHeading(line))}function normaliseChangelogLine(line){return line.replace(/^#{1,6}\s+/,"").trim()}function isGenericChangelogHeading(line){return/^(what'?s changed|main changes|changes|commits?|contributors?|breaking changes?)$/i.test(line.trim())}function formatDependencyChangesSection(changes,options){const useColors=options.useColors===true;const lines=[sectionTitle("Dependencies",useColors)];lines.push(` Direct: ${changes.direct.added.length} added | ${changes.direct.removed.length} removed | ${changes.direct.changed.length} changed`);lines.push(...formatDependencyChangeGroup("Direct",changes.direct,options));lines.push(` Transitive: ${changes.transitive.added.length} added | ${changes.transitive.removed.length} removed | ${changes.transitive.changed.length} changed`);if(options.verbose){lines.push(...formatDependencyChangeGroup("Transitive",changes.transitive,options))}else if(hasDependencyChangeGroupItems(changes.transitive)){lines.push(" More transitive dependency details are available with verbose output.")}return lines}function hasDependencyChangeGroupItems(group){return group.added.length>0||group.removed.length>0||group.changed.length>0}function formatDependencyChangeGroup(scope,group,options){const lines=[];const limit=options.verbose?Number.POSITIVE_INFINITY:5;appendChangeLines(lines,`${scope} added`,group.added,limit);appendChangeLines(lines,`${scope} removed`,group.removed,limit);appendChangeLines(lines,`${scope} changed`,group.changed,limit);return lines}function appendChangeLines(lines,label,items,limit){if(items.length===0)return;const sample=items.slice(0,limit).map(formatDependencyChangeItem);const more=items.length>limit?` (+${items.length-limit} more)`:"";lines.push(` ${label}${more?`${more} with verbose output`:""}`);for(const item of sample)lines.push(` - ${item}`)}function formatDependencyIssuesSection(issues,options){const introduced=issues.introducedDeprecated.length+issues.introducedDuplicates.length+issues.introducedConflicts.length+issues.introducedOutdated.length;const useColors=options.useColors===true;const limit=options.verbose?Number.POSITIVE_INFINITY:5;const lines=[sectionTitle("Dependency issues",useColors)];if(introduced===0){lines.push(` none introduced | current total: ${issues.currentTotal} | target total: ${issues.targetTotal}`);return lines}lines.push(attentionLine(` ${introduced} introduced | current total: ${issues.currentTotal} | target total: ${issues.targetTotal}`,useColors));appendStringList(lines,"Introduced deprecated",issues.introducedDeprecated,limit,useColors);appendStringList(lines,"Introduced duplicates",issues.introducedDuplicates,limit,useColors);appendStringList(lines,"Introduced conflicts",issues.introducedConflicts,limit,useColors);appendStringList(lines,"Introduced outdated",issues.introducedOutdated,limit,useColors);return lines}function appendStringList(lines,label,items,limit,useColors){if(items.length===0)return;lines.push(attentionLine(` ${label}`,useColors));for(const item of items.slice(0,limit))lines.push(` - ${item}`);const remaining=items.length-limit;if(remaining>0)lines.push(` - ... +${remaining} more with verbose output`)}function attentionLine(text,useColors){return colorize(text,"yellow",useColors)}function formatDependencyChangeItem(item){const name=item.registry?`${item.registry}:${item.name}`:item.name;const from=item.fromVersions?.join("|")??"";const to=item.toVersions?.join("|")??"";if(from&&to&&from!==to)return`${name} ${from} -> ${to}`;if(to)return`${name}@${to}`;if(from)return`${name}@${from}`;return name}var packageSchema=z7.object({registry:z7.string().describe(`Package registry. Supported: ${PKGSEER_REGISTRY_LIST2}.`),package_name:z7.string().describe("Package name, scoped names ok."),current_version:z7.string().describe("Currently used package version. Go accepts versions with or without its canonical v prefix; tag-style v prefixes are rejected for other registries except Swift."),target_version:z7.string().describe("Target package version. Go accepts versions with or without its canonical v prefix; tag-style v prefixes are rejected for other registries except Swift.")});var schema7={registry:z7.string().optional().describe(`Package registry for single-package mode. Supported: ${PKGSEER_REGISTRY_LIST2}.`),package_name:z7.string().optional().describe("Package name for single-package mode."),current_version:z7.string().optional().describe("Currently used version for single-package mode. Go accepts versions with or without its canonical v prefix; tag-style v prefixes are rejected for other registries except Swift."),target_version:z7.string().optional().describe("Target version for single-package mode. Go accepts versions with or without its canonical v prefix; tag-style v prefixes are rejected for other registries except Swift."),packages:z7.array(packageSchema).optional().describe(`Batch mode with at most ${PACKAGE_UPGRADE_REVIEW_MAX_PACKAGES} upgrades after blank rows are removed. Mutually exclusive with single-package fields.`),skip_transitive_security:z7.boolean().optional().describe("When true, skip current-vs-target transitive vulnerability summary diffs. Defaults false, so transitive security evidence is included unless explicitly skipped."),include_dependency_issues:z7.boolean().optional().describe("When true, diff current vs target transitive deprecated/outdated/duplicate/conflict summaries. Defaults false."),min_severity:z7.string().optional().describe("Minimum direct-advisory severity: low, medium, high, or critical."),verbose:z7.boolean().optional().describe("Text output only. Batches default to triage rows; verbose adds full per-package reports. Expand statement quotes, headings/confidence and dependency change examples."),format:z7.enum(["text","json"]).default("text").describe("Omit `format` to use token-efficient text when the model reads the result or chooses follow-up tools. Set `json` only when code consumes the raw response instead of the model, or a required field is absent from text.")};var DESCRIPTION7="Review a package upgrade: vulnerabilities, releases, peers, dependency changes. "+"Compares current and target versions using direct vulnerability checks, changelog ranges, target deprecation metadata, peer dependency changes, and optional transitive evidence diffs. "+"The tool reports facts only, including agent-classified release-note quotes grouped by version, with referenced sources and coverage. JSON retains classifier provenance. It does not assign package-level risk or decide whether to accept an upgrade. Batches default to triage rows; use verbose for full per-package evidence. "+"Use this instead of inferring acceptability from semver, including patch bumps. "+"Use signals as a starting point to evaluate the impact of changes on the codebase. "+"You can use pkg_changelog and code_diff to obtain full release-note and source-change details. "+"Accepts either one package via registry/package_name/current_version/"+`target_version or batch \`packages[]\` with at most ${PACKAGE_UPGRADE_REVIEW_MAX_PACKAGES} upgrades.`+`
|
|
146
149
|
|
|
147
|
-
${PKG_UPGRADE_REVIEW_GUARDRAIL}`;function createPackageUpgradeReviewTool(service){return{name:"pkg_upgrade_review",description:DESCRIPTION7,schema:schema7,annotations:OPEN_WORLD_READ_ONLY_TOOL_ANNOTATIONS,handler:async(args,context)=>{try{const request=buildPackageUpgradeReviewRequest({registry:args.registry,packageName:args.package_name,currentVersion:args.current_version,targetVersion:args.target_version,packages:args.packages?.map((pkg)=>({registry:pkg.registry,packageName:pkg.package_name,currentVersion:pkg.current_version,targetVersion:pkg.target_version})),includeTransitiveSecurity:args.skip_transitive_security!==true,includeDependencyIssues:args.include_dependency_issues,minSeverity:args.min_severity});const response=await buildPackageUpgradeReview(service,request.packages,request.options);if(args.format==="json")return textResult(JSON.stringify(response));return textResult(formatPackageUpgradeReviewTerminal(response,{verbose:args.verbose===true}).trimEnd())}catch(error){throwIfCallerCancellation(error,context?.signal);const mapped=mapPackageIntelligenceError(error);return mcpMappedErrorResult(mapped,context,args.format)}}}}import{z as z8}from"zod";var DEFAULT_ADVISORY_CAP=5;function buildPackageVulnerabilitiesSuccessPayload(report,options={}){const pkg=report.package;const security=report.security;const dedupedAdvisories=dedupAdvisoriesByAlias(security?.vulnerabilities??[]);const total=security?.affectedVulnerabilityCount??dedupedAdvisories.length;const payload={registry:lowerRegistry3(pkg.registry),name:pkg.name,version:pkg.version,summary:buildSummary(total,security,dedupedAdvisories)};const requestedEcho=deriveRequestedVersion2(options.requestedVersion,pkg.version);if(requestedEcho!==undefined){payload.requestedVersion=requestedEcho}if(options.filter!==undefined){payload.filter=options.filter}const sortedAdvisories=sortAdvisories(dedupedAdvisories.map(buildAdvisory));if(sortedAdvisories.length>0){payload.advisories=sortedAdvisories}const upgradePaths=security?.upgradePaths;if(upgradePaths&&upgradePaths.length>0){const unique=Array.from(new Set(upgradePaths));unique.sort(compareVersionsAscending);payload.upgradePaths=unique}if(report.transitive!==undefined){payload.transitive=buildTransitiveAudit(report.transitive)}return payload}function compareVersionsAscending(a,b){const pa=parseVersionForSort(a);const pb=parseVersionForSort(b);const len=Math.max(pa.main.length,pb.main.length);for(let i=0;i<len;i++){const diff=(pa.main[i]??0)-(pb.main[i]??0);if(diff!==0)return diff}if(pa.pre===undefined&&pb.pre===undefined)return 0;if(pa.pre===undefined)return 1;if(pb.pre===undefined)return-1;return pa.pre<pb.pre?-1:pa.pre>pb.pre?1:0}function parseVersionForSort(v){const[rawMainStr,...preParts]=v.split("-");const pre=preParts.length>0?preParts.join("-"):undefined;const mainStr=rawMainStr?.replace(/^v(?=\d)/i,"");const main=(mainStr??"").split(".").map((segment)=>{const n=Number.parseInt(segment,10);return Number.isFinite(n)?n:0});return{main,pre}}function buildSummary(total,security,dedupedAdvisories){const summary={total};if(security){summary.affectedVulnerabilityCount=security.affectedVulnerabilityCount;summary.nonAffectingVulnerabilityCount=security.nonAffectingVulnerabilityCount;summary.allVulnerabilityCount=security.allVulnerabilityCount}if(typeof security?.currentVersionAffected==="boolean"){summary.affected=security.currentVersionAffected}if(dedupedAdvisories.length===0)return summary;const bySeverity=computeBySeverity(dedupedAdvisories);const anyCounted=Object.values(bySeverity).some((n)=>n>0);if(anyCounted){const trimmed={};for(const key of BUCKET_ORDER){const n=bySeverity[key];if(n>0)trimmed[key]=n}summary.bySeverity=trimmed}return summary}function buildTransitiveAudit(audit){const packages=audit.packages.map((pkg)=>({registry:lowerRegistry3(pkg.registry),name:pkg.name,occurrenceCount:pkg.occurrenceCount,occurrences:pkg.occurrences.map(buildTransitiveOccurrence).sort(compareTransitiveOccurrences)})).sort(compareTransitivePackages);const occurrences=packages.flatMap((pkg)=>pkg.occurrences);const bySeverity=computeTransitiveBySeverity(occurrences);const hasCountedSeverity=Object.values(bySeverity).some((count)=>count>0);return{scope:"resolved_dependencies",advisoryScope:toAdvisoryScopeLabel(audit.advisoryScope),withdrawnAdvisoriesIncluded:false,summary:{totalPackagesAnalyzed:audit.totalPackagesAnalyzed,packageCount:audit.packageCount,occurrenceCount:audit.occurrenceCount,...hasCountedSeverity?{bySeverity:trimSeverityBuckets(bySeverity)}:{}},...audit.calculatedAt!==undefined?{calculatedAt:audit.calculatedAt}:{},packages}}function buildTransitiveOccurrence(occurrence){const advisory=occurrence.advisory;const publishedAt=toIsoDate(advisory.publishedAt);const modifiedAt=toIsoDate(advisory.modifiedAt);const lean={resolvedVersion:occurrence.version,affectsResolvedVersion:occurrence.affectsResolvedVersion,matchedAffectedVersionRanges:occurrence.matchedAffectedVersionRanges.slice(),fixVersionsAboveResolved:occurrence.fixVersionsAboveResolved.slice()};if(advisory.osvId)lean.id=advisory.osvId;if(advisory.aliases&&advisory.aliases.length>0){lean.aliases=advisory.aliases.slice()}if(advisory.summary&&!isPlaceholderSummary(advisory.summary)){lean.summary=advisory.summary}if(typeof advisory.severityScore==="number"&&advisory.severityScore>0){lean.severity=advisory.severityScore;const severityLabel=vulnSeverityLabel(advisory.severityScore);if(severityLabel!==undefined)lean.severityLabel=severityLabel}if(advisory.affectedVersionRanges&&advisory.affectedVersionRanges.length>0){lean.affectedRanges=advisory.affectedVersionRanges.slice()}if(advisory.fixedInVersions&&advisory.fixedInVersions.length>0){lean.fixedIn=advisory.fixedInVersions.slice()}if(occurrence.nearestFixedVersion){lean.nearestFixedVersion=occurrence.nearestFixedVersion}if(publishedAt)lean.publishedAt=publishedAt;if(modifiedAt&&modifiedAt!==publishedAt)lean.modifiedAt=modifiedAt;if(advisory.isMalicious===true)lean.isMalicious=true;return lean}function toAdvisoryScopeLabel(scope){if(scope==="NON_AFFECTING")return"non_affecting";return scope==="ALL"?"all":"affected"}function computeTransitiveBySeverity(occurrences){const histogram={malware:0,critical:0,high:0,medium:0,low:0,unrated:0};for(const occurrence of occurrences){if(occurrence.isMalicious===true){histogram.malware+=1;continue}if(occurrence.severityLabel!==undefined){histogram[occurrence.severityLabel]+=1}else{histogram.unrated+=1}}return histogram}function trimSeverityBuckets(histogram){const trimmed={};for(const key of BUCKET_ORDER){if(histogram[key]>0)trimmed[key]=histogram[key]}return trimmed}function compareTransitivePackages(a,b){const registry=compareStrings(a.registry,b.registry);return registry!==0?registry:compareStrings(a.name,b.name)}function compareTransitiveOccurrences(a,b){const risk=transitiveRiskRank(b)-transitiveRiskRank(a);if(risk!==0)return risk;const version=compareStrings(a.resolvedVersion,b.resolvedVersion);if(version!==0)return version;const identity=compareStrings(transitiveAdvisoryIdentity(a),transitiveAdvisoryIdentity(b));if(identity!==0)return identity;const aliases=compareStrings((a.aliases??[]).join("\x00"),(b.aliases??[]).join("\x00"));if(aliases!==0)return aliases;return compareStrings(JSON.stringify(a),JSON.stringify(b))}function transitiveAdvisoryIdentity(occurrence){return occurrence.id??occurrence.aliases?.[0]??occurrence.summary??""}function transitiveRiskRank(occurrence){const severityRank=occurrence.severityLabel?SEVERITY_RANK[occurrence.severityLabel]:0;return(occurrence.isMalicious===true?100:0)+severityRank}function compareStrings(a,b){return a<b?-1:a>b?1:0}function computeBySeverity(advisories){const histogram={malware:0,critical:0,high:0,medium:0,low:0,unrated:0};for(const advisory of advisories){if(advisory.isMalicious===true){histogram.malware+=1;continue}const label=vulnSeverityLabel(advisory.severityScore);if(label!==undefined){histogram[label]+=1}else{histogram.unrated+=1}}return histogram}var BUCKET_ORDER=["malware","critical","high","medium","low","unrated"];function vulnSeverityLabel(score){if(typeof score!=="number"||score<=0)return;if(score>=9)return"critical";if(score>=7)return"high";if(score>=4)return"medium";return"low"}function dedupAdvisoriesByAlias(advisories){if(advisories.length===0)return[];const parent=new Map;const find=(id)=>{let root=id;let next=parent.get(root);while(next!==undefined&&next!==root){root=next;next=parent.get(root)}let cursor=id;while(cursor!==root){const parentOfCursor=parent.get(cursor);if(parentOfCursor===undefined)break;parent.set(cursor,root);cursor=parentOfCursor}return root};const union=(a,b)=>{const ra=find(a);const rb=find(b);if(ra!==rb)parent.set(ra,rb)};const ensure=(id)=>{if(!parent.has(id))parent.set(id,id)};const advisoryKeys=[];for(let i=0;i<advisories.length;i++){const advisory=advisories[i];if(!advisory){advisoryKeys.push(`__synthetic_${i}`);continue}const ids=[];if(advisory.osvId)ids.push(advisory.osvId);for(const alias of advisory.aliases??[]){if(alias)ids.push(alias)}if(ids.length===0){const synthetic=`__synthetic_${i}`;ensure(synthetic);advisoryKeys.push(synthetic);continue}for(const id of ids)ensure(id);for(let j=1;j<ids.length;j++){const a=ids[j-1];const b=ids[j];if(a!==undefined&&b!==undefined)union(a,b)}advisoryKeys.push(ids[0])}const clusters=new Map;for(let i=0;i<advisories.length;i++){const advisory=advisories[i];if(!advisory)continue;const key=advisoryKeys[i];if(key===undefined)continue;const root=find(key);const bucket=clusters.get(root);if(bucket)bucket.push(advisory);else clusters.set(root,[advisory])}const merged=[];for(const cluster of clusters.values()){merged.push(mergeAdvisoryCluster(cluster))}return merged}function mergeAdvisoryCluster(cluster){if(cluster.length===1){const only=cluster[0];if(!only)throw new Error("empty advisory cluster");return only}const canonical=pickCanonical(cluster);const aliasSet=new Set;for(const member of cluster){if(member.osvId)aliasSet.add(member.osvId);for(const alias of member.aliases??[]){if(alias)aliasSet.add(alias)}}if(canonical.osvId)aliasSet.delete(canonical.osvId);const aliases=Array.from(aliasSet).sort();const affectedRangesSet=new Set;const matchedAffectedRangesSet=new Set;const fixedInSet=new Set;const duplicateIdsSet=new Set;let isMalicious=false;let affectsInspectedVersion=false;let affectedVersionRangesTruncated=false;let affectedVersionRangesCount=0;let latestModifiedAt=canonical.modifiedAt;let withdrawnAt;let allWithdrawn=true;let maxSeverityScore=typeof canonical.severityScore==="number"?canonical.severityScore:0;for(const member of cluster){for(const range of member.affectedVersionRanges??[]){affectedRangesSet.add(range)}for(const range of member.matchedAffectedVersionRanges??[]){matchedAffectedRangesSet.add(range)}for(const fix of member.fixedInVersions??[]){fixedInSet.add(fix)}for(const duplicateId of member.duplicateIds??[]){duplicateIdsSet.add(duplicateId)}if(member.isMalicious===true)isMalicious=true;if(member.affectsInspectedVersion===true)affectsInspectedVersion=true;if(member.affectedVersionRangesTruncated===true){affectedVersionRangesTruncated=true}if(typeof member.affectedVersionRangesCount==="number"){affectedVersionRangesCount=Math.max(affectedVersionRangesCount,member.affectedVersionRangesCount)}if(member.modifiedAt){if(!latestModifiedAt||member.modifiedAt>latestModifiedAt){latestModifiedAt=member.modifiedAt}}if(member.withdrawnAt){if(!withdrawnAt||member.withdrawnAt>withdrawnAt){withdrawnAt=member.withdrawnAt}}else{allWithdrawn=false}if(!member.withdrawnAt&&typeof member.severityScore==="number"&&member.severityScore>maxSeverityScore){maxSeverityScore=member.severityScore}}const merged={...canonical,aliases};if(maxSeverityScore>0){merged.severityScore=maxSeverityScore}if(affectedRangesSet.size>0){merged.affectedVersionRanges=Array.from(affectedRangesSet)}const exactOrLowerBoundCount=Math.max(affectedVersionRangesCount,affectedRangesSet.size);if(exactOrLowerBoundCount>0){merged.affectedVersionRangesCount=exactOrLowerBoundCount}if(affectedVersionRangesTruncated){merged.affectedVersionRangesTruncated=true}if(matchedAffectedRangesSet.size>0){merged.matchedAffectedVersionRanges=Array.from(matchedAffectedRangesSet)}if(affectsInspectedVersion)merged.affectsInspectedVersion=true;if(duplicateIdsSet.size>0){merged.duplicateIds=Array.from(duplicateIdsSet).sort()}if(fixedInSet.size>0){merged.fixedInVersions=Array.from(fixedInSet)}if(isMalicious)merged.isMalicious=true;if(latestModifiedAt){merged.modifiedAt=latestModifiedAt}else{delete merged.modifiedAt}if(allWithdrawn&&withdrawnAt){merged.withdrawnAt=withdrawnAt}else{delete merged.withdrawnAt}return merged}function pickCanonical(cluster){const ranked=cluster.slice().sort((a,b)=>{const aHasScore=typeof a.severityScore==="number"&&a.severityScore>0?1:0;const bHasScore=typeof b.severityScore==="number"&&b.severityScore>0?1:0;if(aHasScore!==bHasScore)return bHasScore-aHasScore;const aRank=idPrefixRank(a.osvId);const bRank=idPrefixRank(b.osvId);if(aRank!==bRank)return aRank-bRank;const aId=a.osvId??"";const bId=b.osvId??"";if(aId!==bId)return aId<bId?-1:1;return 0});const winner=ranked[0];if(!winner)throw new Error("empty cluster passed to pickCanonical");return winner}function idPrefixRank(id){if(!id)return 99;if(id.startsWith("GHSA-"))return 0;if(id.startsWith("RUSTSEC-"))return 2;return 1}function buildAdvisory(advisory){const lean={};if(advisory.osvId)lean.id=advisory.osvId;if(advisory.aliases&&advisory.aliases.length>0){lean.aliases=advisory.aliases.slice()}if(advisory.summary&&!isPlaceholderSummary(advisory.summary)){lean.summary=advisory.summary}if(typeof advisory.severityScore==="number"&&advisory.severityScore>0){lean.severity=advisory.severityScore;const label=vulnSeverityLabel(advisory.severityScore);if(label!==undefined)lean.severityLabel=label}if(advisory.affectedVersionRanges&&advisory.affectedVersionRanges.length>0){lean.affectedRanges=advisory.affectedVersionRanges.slice()}if(typeof advisory.affectedVersionRangesCount==="number"){lean.affectedVersionRangesCount=advisory.affectedVersionRangesCount}if(advisory.affectedVersionRangesTruncated===true){lean.affectedVersionRangesTruncated=true}if(typeof advisory.affectsInspectedVersion==="boolean"){lean.affectsInspectedVersion=advisory.affectsInspectedVersion}if(advisory.matchedAffectedVersionRanges&&advisory.matchedAffectedVersionRanges.length>0){lean.matchedAffectedVersionRanges=advisory.matchedAffectedVersionRanges.slice()}if(advisory.duplicateIds&&advisory.duplicateIds.length>0){lean.duplicateIds=advisory.duplicateIds.slice()}if(advisory.fixedInVersions&&advisory.fixedInVersions.length>0){lean.fixedIn=advisory.fixedInVersions.slice()}const publishedAt=toIsoDate(advisory.publishedAt);if(publishedAt)lean.publishedAt=publishedAt;const modifiedAt=toIsoDate(advisory.modifiedAt);if(modifiedAt&&modifiedAt!==publishedAt){lean.modifiedAt=modifiedAt}const withdrawnAt=toIsoDate(advisory.withdrawnAt);if(withdrawnAt)lean.withdrawnAt=withdrawnAt;if(advisory.isMalicious===true){lean.isMalicious=true}return lean}var SEVERITY_RANK={critical:4,high:3,medium:2,low:1};function sortAdvisories(advisories){return advisories.slice().sort(compareAdvisories)}function compareAdvisories(a,b){const aWithdrawn=a.withdrawnAt!==undefined;const bWithdrawn=b.withdrawnAt!==undefined;if(aWithdrawn!==bWithdrawn)return aWithdrawn?1:-1;const aMalware=a.isMalicious===true;const bMalware=b.isMalicious===true;if(aMalware!==bMalware)return aMalware?-1:1;const aRank=a.severityLabel?SEVERITY_RANK[a.severityLabel]:0;const bRank=b.severityLabel?SEVERITY_RANK[b.severityLabel]:0;if(aRank!==bRank)return bRank-aRank;const aDate=a.publishedAt??"";const bDate=b.publishedAt??"";if(aDate!==bDate)return aDate<bDate?1:-1;const aId=a.id??"";const bId=b.id??"";if(aId!==bId)return aId<bId?-1:1;return 0}function deriveRequestedVersion2(requested,resolved){if(requested===undefined)return;const trimmed=requested.trim();if(trimmed.length===0)return;if(trimmed===resolved)return;return trimmed}function lowerRegistry3(value){if(!value)return"";const upper=value.toUpperCase();try{return toPkgseerRegistryLowercase2(upper)}catch{return value.toLowerCase()}}function formatPackageVulnerabilitiesTerminal(report,options={}){const payload=buildPackageVulnerabilitiesSuccessPayload(report,{requestedVersion:options.requestedVersion,filter:options.filter});const useColors=options.useColors??false;const verbose=options.verbose??false;const surface=options.surface??"cli";const headerLine=formatHeader(payload,useColors);const requestedLine=payload.requestedVersion?dim(`(requested ${sanitizeIdentity(payload.requestedVersion)})`,useColors):undefined;const filterLines=formatFilterLines(payload.filter);const transitiveBlock=payload.transitive?formatTransitiveAuditTerminal(payload.transitive,{verbose,useColors,surface,terminalWidth:options.terminalWidth,includeWithdrawn:payload.filter?.includeWithdrawn===true}):undefined;if(payload.summary.total===0){const lines=[headerLine];if(requestedLine)lines.push(requestedLine);lines.push(...filterLines);lines.push(formatNoAffectedVulnerabilitiesLine(payload));if(payload.advisories&&payload.advisories.length>0){const rangeLimit=resolveAffectedRangesLimit(options.terminalWidth);lines.push("",formatAdvisoryList(payload.advisories,verbose,useColors,rangeLimit,surface,options.terminalWidth))}if(transitiveBlock)lines.push("",transitiveBlock);return`${lines.join(`
|
|
150
|
+
${PKG_UPGRADE_REVIEW_GUARDRAIL}`;function createPackageUpgradeReviewTool(service){return{name:"pkg_upgrade_review",description:DESCRIPTION7,schema:schema7,annotations:OPEN_WORLD_READ_ONLY_TOOL_ANNOTATIONS,handler:async(args,context)=>{try{const request=buildPackageUpgradeReviewRequest({registry:args.registry,packageName:args.package_name,currentVersion:args.current_version,targetVersion:args.target_version,packages:args.packages?.map((pkg)=>({registry:pkg.registry,packageName:pkg.package_name,currentVersion:pkg.current_version,targetVersion:pkg.target_version})),includeTransitiveSecurity:args.skip_transitive_security!==true,includeDependencyIssues:args.include_dependency_issues,minSeverity:args.min_severity});const response=await buildPackageUpgradeReview(service,request.packages,{...request.options,includeChangelogFullText:args.format==="json"});if(args.format==="json")return textResult(JSON.stringify(response));return textResult(formatPackageUpgradeReviewTerminal(response,{verbose:args.verbose===true}).trimEnd())}catch(error){throwIfCallerCancellation(error,context?.signal);const mapped=mapPackageIntelligenceError(error);return mcpMappedErrorResult(mapped,context,args.format)}}}}import{z as z8}from"zod";var DEFAULT_ADVISORY_CAP=5;function buildPackageVulnerabilitiesSuccessPayload(report,options={}){const pkg=report.package;const security=report.security;const dedupedAdvisories=dedupAdvisoriesByAlias(security?.vulnerabilities??[]);const total=security?.affectedVulnerabilityCount??dedupedAdvisories.length;const payload={registry:lowerRegistry3(pkg.registry),name:pkg.name,version:pkg.version,summary:buildSummary(total,security,dedupedAdvisories)};const requestedEcho=deriveRequestedVersion2(options.requestedVersion,pkg.version);if(requestedEcho!==undefined){payload.requestedVersion=requestedEcho}if(options.filter!==undefined){payload.filter=options.filter}const sortedAdvisories=sortAdvisories(dedupedAdvisories.map(buildAdvisory));if(sortedAdvisories.length>0){payload.advisories=sortedAdvisories}const upgradePaths=security?.upgradePaths;if(upgradePaths&&upgradePaths.length>0){const unique=Array.from(new Set(upgradePaths));unique.sort(compareVersionsAscending);payload.upgradePaths=unique}if(report.transitive!==undefined){payload.transitive=buildTransitiveAudit(report.transitive)}return payload}function compareVersionsAscending(a,b){const pa=parseVersionForSort(a);const pb=parseVersionForSort(b);const len=Math.max(pa.main.length,pb.main.length);for(let i=0;i<len;i++){const diff=(pa.main[i]??0)-(pb.main[i]??0);if(diff!==0)return diff}if(pa.pre===undefined&&pb.pre===undefined)return 0;if(pa.pre===undefined)return 1;if(pb.pre===undefined)return-1;return pa.pre<pb.pre?-1:pa.pre>pb.pre?1:0}function parseVersionForSort(v){const[rawMainStr,...preParts]=v.split("-");const pre=preParts.length>0?preParts.join("-"):undefined;const mainStr=rawMainStr?.replace(/^v(?=\d)/i,"");const main=(mainStr??"").split(".").map((segment)=>{const n=Number.parseInt(segment,10);return Number.isFinite(n)?n:0});return{main,pre}}function buildSummary(total,security,dedupedAdvisories){const summary={total};if(security){summary.affectedVulnerabilityCount=security.affectedVulnerabilityCount;summary.nonAffectingVulnerabilityCount=security.nonAffectingVulnerabilityCount;summary.allVulnerabilityCount=security.allVulnerabilityCount}if(typeof security?.currentVersionAffected==="boolean"){summary.affected=security.currentVersionAffected}if(dedupedAdvisories.length===0)return summary;const bySeverity=computeBySeverity(dedupedAdvisories);const anyCounted=Object.values(bySeverity).some((n)=>n>0);if(anyCounted){const trimmed={};for(const key of BUCKET_ORDER){const n=bySeverity[key];if(n>0)trimmed[key]=n}summary.bySeverity=trimmed}return summary}function buildTransitiveAudit(audit){const packages=audit.packages.map((pkg)=>({registry:lowerRegistry3(pkg.registry),name:pkg.name,occurrenceCount:pkg.occurrenceCount,occurrences:pkg.occurrences.map(buildTransitiveOccurrence).sort(compareTransitiveOccurrences)})).sort(compareTransitivePackages);const occurrences=packages.flatMap((pkg)=>pkg.occurrences);const bySeverity=computeTransitiveBySeverity(occurrences);const hasCountedSeverity=Object.values(bySeverity).some((count)=>count>0);return{scope:"resolved_dependencies",advisoryScope:toAdvisoryScopeLabel(audit.advisoryScope),withdrawnAdvisoriesIncluded:false,summary:{totalPackagesAnalyzed:audit.totalPackagesAnalyzed,packageCount:audit.packageCount,occurrenceCount:audit.occurrenceCount,...hasCountedSeverity?{bySeverity:trimSeverityBuckets(bySeverity)}:{}},...audit.calculatedAt!==undefined?{calculatedAt:audit.calculatedAt}:{},packages}}function buildTransitiveOccurrence(occurrence){const advisory=occurrence.advisory;const publishedAt=toIsoDate(advisory.publishedAt);const modifiedAt=toIsoDate(advisory.modifiedAt);const lean={resolvedVersion:occurrence.version,affectsResolvedVersion:occurrence.affectsResolvedVersion,matchedAffectedVersionRanges:occurrence.matchedAffectedVersionRanges.slice(),fixVersionsAboveResolved:occurrence.fixVersionsAboveResolved.slice()};if(advisory.osvId)lean.id=advisory.osvId;if(advisory.aliases&&advisory.aliases.length>0){lean.aliases=advisory.aliases.slice()}if(advisory.summary&&!isPlaceholderSummary(advisory.summary)){lean.summary=advisory.summary}if(typeof advisory.severityScore==="number"&&advisory.severityScore>0){lean.severity=advisory.severityScore;const severityLabel=vulnSeverityLabel(advisory.severityScore);if(severityLabel!==undefined)lean.severityLabel=severityLabel}if(advisory.affectedVersionRanges&&advisory.affectedVersionRanges.length>0){lean.affectedRanges=advisory.affectedVersionRanges.slice()}if(advisory.fixedInVersions&&advisory.fixedInVersions.length>0){lean.fixedIn=advisory.fixedInVersions.slice()}if(occurrence.nearestFixedVersion){lean.nearestFixedVersion=occurrence.nearestFixedVersion}if(publishedAt)lean.publishedAt=publishedAt;if(modifiedAt&&modifiedAt!==publishedAt)lean.modifiedAt=modifiedAt;if(advisory.isMalicious===true)lean.isMalicious=true;return lean}function toAdvisoryScopeLabel(scope){if(scope==="NON_AFFECTING")return"non_affecting";return scope==="ALL"?"all":"affected"}function computeTransitiveBySeverity(occurrences){const histogram={malware:0,critical:0,high:0,medium:0,low:0,unrated:0};for(const occurrence of occurrences){if(occurrence.isMalicious===true){histogram.malware+=1;continue}if(occurrence.severityLabel!==undefined){histogram[occurrence.severityLabel]+=1}else{histogram.unrated+=1}}return histogram}function trimSeverityBuckets(histogram){const trimmed={};for(const key of BUCKET_ORDER){if(histogram[key]>0)trimmed[key]=histogram[key]}return trimmed}function compareTransitivePackages(a,b){const registry=compareStrings(a.registry,b.registry);return registry!==0?registry:compareStrings(a.name,b.name)}function compareTransitiveOccurrences(a,b){const risk=transitiveRiskRank(b)-transitiveRiskRank(a);if(risk!==0)return risk;const version=compareStrings(a.resolvedVersion,b.resolvedVersion);if(version!==0)return version;const identity=compareStrings(transitiveAdvisoryIdentity(a),transitiveAdvisoryIdentity(b));if(identity!==0)return identity;const aliases=compareStrings((a.aliases??[]).join("\x00"),(b.aliases??[]).join("\x00"));if(aliases!==0)return aliases;return compareStrings(JSON.stringify(a),JSON.stringify(b))}function transitiveAdvisoryIdentity(occurrence){return occurrence.id??occurrence.aliases?.[0]??occurrence.summary??""}function transitiveRiskRank(occurrence){const severityRank=occurrence.severityLabel?SEVERITY_RANK[occurrence.severityLabel]:0;return(occurrence.isMalicious===true?100:0)+severityRank}function compareStrings(a,b){return a<b?-1:a>b?1:0}function computeBySeverity(advisories){const histogram={malware:0,critical:0,high:0,medium:0,low:0,unrated:0};for(const advisory of advisories){if(advisory.isMalicious===true){histogram.malware+=1;continue}const label=vulnSeverityLabel(advisory.severityScore);if(label!==undefined){histogram[label]+=1}else{histogram.unrated+=1}}return histogram}var BUCKET_ORDER=["malware","critical","high","medium","low","unrated"];function vulnSeverityLabel(score){if(typeof score!=="number"||score<=0)return;if(score>=9)return"critical";if(score>=7)return"high";if(score>=4)return"medium";return"low"}function dedupAdvisoriesByAlias(advisories){if(advisories.length===0)return[];const parent=new Map;const find=(id)=>{let root=id;let next=parent.get(root);while(next!==undefined&&next!==root){root=next;next=parent.get(root)}let cursor=id;while(cursor!==root){const parentOfCursor=parent.get(cursor);if(parentOfCursor===undefined)break;parent.set(cursor,root);cursor=parentOfCursor}return root};const union=(a,b)=>{const ra=find(a);const rb=find(b);if(ra!==rb)parent.set(ra,rb)};const ensure=(id)=>{if(!parent.has(id))parent.set(id,id)};const advisoryKeys=[];for(let i=0;i<advisories.length;i++){const advisory=advisories[i];if(!advisory){advisoryKeys.push(`__synthetic_${i}`);continue}const ids=[];if(advisory.osvId)ids.push(advisory.osvId);for(const alias of advisory.aliases??[]){if(alias)ids.push(alias)}if(ids.length===0){const synthetic=`__synthetic_${i}`;ensure(synthetic);advisoryKeys.push(synthetic);continue}for(const id of ids)ensure(id);for(let j=1;j<ids.length;j++){const a=ids[j-1];const b=ids[j];if(a!==undefined&&b!==undefined)union(a,b)}advisoryKeys.push(ids[0])}const clusters=new Map;for(let i=0;i<advisories.length;i++){const advisory=advisories[i];if(!advisory)continue;const key=advisoryKeys[i];if(key===undefined)continue;const root=find(key);const bucket=clusters.get(root);if(bucket)bucket.push(advisory);else clusters.set(root,[advisory])}const merged=[];for(const cluster of clusters.values()){merged.push(mergeAdvisoryCluster(cluster))}return merged}function mergeAdvisoryCluster(cluster){if(cluster.length===1){const only=cluster[0];if(!only)throw new Error("empty advisory cluster");return only}const canonical=pickCanonical(cluster);const aliasSet=new Set;for(const member of cluster){if(member.osvId)aliasSet.add(member.osvId);for(const alias of member.aliases??[]){if(alias)aliasSet.add(alias)}}if(canonical.osvId)aliasSet.delete(canonical.osvId);const aliases=Array.from(aliasSet).sort();const affectedRangesSet=new Set;const matchedAffectedRangesSet=new Set;const fixedInSet=new Set;const duplicateIdsSet=new Set;let isMalicious=false;let affectsInspectedVersion=false;let affectedVersionRangesTruncated=false;let affectedVersionRangesCount=0;let latestModifiedAt=canonical.modifiedAt;let withdrawnAt;let allWithdrawn=true;let maxSeverityScore=typeof canonical.severityScore==="number"?canonical.severityScore:0;for(const member of cluster){for(const range of member.affectedVersionRanges??[]){affectedRangesSet.add(range)}for(const range of member.matchedAffectedVersionRanges??[]){matchedAffectedRangesSet.add(range)}for(const fix of member.fixedInVersions??[]){fixedInSet.add(fix)}for(const duplicateId of member.duplicateIds??[]){duplicateIdsSet.add(duplicateId)}if(member.isMalicious===true)isMalicious=true;if(member.affectsInspectedVersion===true)affectsInspectedVersion=true;if(member.affectedVersionRangesTruncated===true){affectedVersionRangesTruncated=true}if(typeof member.affectedVersionRangesCount==="number"){affectedVersionRangesCount=Math.max(affectedVersionRangesCount,member.affectedVersionRangesCount)}if(member.modifiedAt){if(!latestModifiedAt||member.modifiedAt>latestModifiedAt){latestModifiedAt=member.modifiedAt}}if(member.withdrawnAt){if(!withdrawnAt||member.withdrawnAt>withdrawnAt){withdrawnAt=member.withdrawnAt}}else{allWithdrawn=false}if(!member.withdrawnAt&&typeof member.severityScore==="number"&&member.severityScore>maxSeverityScore){maxSeverityScore=member.severityScore}}const merged={...canonical,aliases};if(maxSeverityScore>0){merged.severityScore=maxSeverityScore}if(affectedRangesSet.size>0){merged.affectedVersionRanges=Array.from(affectedRangesSet)}const exactOrLowerBoundCount=Math.max(affectedVersionRangesCount,affectedRangesSet.size);if(exactOrLowerBoundCount>0){merged.affectedVersionRangesCount=exactOrLowerBoundCount}if(affectedVersionRangesTruncated){merged.affectedVersionRangesTruncated=true}if(matchedAffectedRangesSet.size>0){merged.matchedAffectedVersionRanges=Array.from(matchedAffectedRangesSet)}if(affectsInspectedVersion)merged.affectsInspectedVersion=true;if(duplicateIdsSet.size>0){merged.duplicateIds=Array.from(duplicateIdsSet).sort()}if(fixedInSet.size>0){merged.fixedInVersions=Array.from(fixedInSet)}if(isMalicious)merged.isMalicious=true;if(latestModifiedAt){merged.modifiedAt=latestModifiedAt}else{delete merged.modifiedAt}if(allWithdrawn&&withdrawnAt){merged.withdrawnAt=withdrawnAt}else{delete merged.withdrawnAt}return merged}function pickCanonical(cluster){const ranked=cluster.slice().sort((a,b)=>{const aHasScore=typeof a.severityScore==="number"&&a.severityScore>0?1:0;const bHasScore=typeof b.severityScore==="number"&&b.severityScore>0?1:0;if(aHasScore!==bHasScore)return bHasScore-aHasScore;const aRank=idPrefixRank(a.osvId);const bRank=idPrefixRank(b.osvId);if(aRank!==bRank)return aRank-bRank;const aId=a.osvId??"";const bId=b.osvId??"";if(aId!==bId)return aId<bId?-1:1;return 0});const winner=ranked[0];if(!winner)throw new Error("empty cluster passed to pickCanonical");return winner}function idPrefixRank(id){if(!id)return 99;if(id.startsWith("GHSA-"))return 0;if(id.startsWith("RUSTSEC-"))return 2;return 1}function buildAdvisory(advisory){const lean={};if(advisory.osvId)lean.id=advisory.osvId;if(advisory.aliases&&advisory.aliases.length>0){lean.aliases=advisory.aliases.slice()}if(advisory.summary&&!isPlaceholderSummary(advisory.summary)){lean.summary=advisory.summary}if(typeof advisory.severityScore==="number"&&advisory.severityScore>0){lean.severity=advisory.severityScore;const label=vulnSeverityLabel(advisory.severityScore);if(label!==undefined)lean.severityLabel=label}if(advisory.affectedVersionRanges&&advisory.affectedVersionRanges.length>0){lean.affectedRanges=advisory.affectedVersionRanges.slice()}if(typeof advisory.affectedVersionRangesCount==="number"){lean.affectedVersionRangesCount=advisory.affectedVersionRangesCount}if(advisory.affectedVersionRangesTruncated===true){lean.affectedVersionRangesTruncated=true}if(typeof advisory.affectsInspectedVersion==="boolean"){lean.affectsInspectedVersion=advisory.affectsInspectedVersion}if(advisory.matchedAffectedVersionRanges&&advisory.matchedAffectedVersionRanges.length>0){lean.matchedAffectedVersionRanges=advisory.matchedAffectedVersionRanges.slice()}if(advisory.duplicateIds&&advisory.duplicateIds.length>0){lean.duplicateIds=advisory.duplicateIds.slice()}if(advisory.fixedInVersions&&advisory.fixedInVersions.length>0){lean.fixedIn=advisory.fixedInVersions.slice()}const publishedAt=toIsoDate(advisory.publishedAt);if(publishedAt)lean.publishedAt=publishedAt;const modifiedAt=toIsoDate(advisory.modifiedAt);if(modifiedAt&&modifiedAt!==publishedAt){lean.modifiedAt=modifiedAt}const withdrawnAt=toIsoDate(advisory.withdrawnAt);if(withdrawnAt)lean.withdrawnAt=withdrawnAt;if(advisory.isMalicious===true){lean.isMalicious=true}return lean}var SEVERITY_RANK={critical:4,high:3,medium:2,low:1};function sortAdvisories(advisories){return advisories.slice().sort(compareAdvisories)}function compareAdvisories(a,b){const aWithdrawn=a.withdrawnAt!==undefined;const bWithdrawn=b.withdrawnAt!==undefined;if(aWithdrawn!==bWithdrawn)return aWithdrawn?1:-1;const aMalware=a.isMalicious===true;const bMalware=b.isMalicious===true;if(aMalware!==bMalware)return aMalware?-1:1;const aRank=a.severityLabel?SEVERITY_RANK[a.severityLabel]:0;const bRank=b.severityLabel?SEVERITY_RANK[b.severityLabel]:0;if(aRank!==bRank)return bRank-aRank;const aDate=a.publishedAt??"";const bDate=b.publishedAt??"";if(aDate!==bDate)return aDate<bDate?1:-1;const aId=a.id??"";const bId=b.id??"";if(aId!==bId)return aId<bId?-1:1;return 0}function deriveRequestedVersion2(requested,resolved){if(requested===undefined)return;const trimmed=requested.trim();if(trimmed.length===0)return;if(trimmed===resolved)return;return trimmed}function lowerRegistry3(value){if(!value)return"";const upper=value.toUpperCase();try{return toPkgseerRegistryLowercase2(upper)}catch{return value.toLowerCase()}}function formatPackageVulnerabilitiesTerminal(report,options={}){const payload=buildPackageVulnerabilitiesSuccessPayload(report,{requestedVersion:options.requestedVersion,filter:options.filter});const useColors=options.useColors??false;const verbose=options.verbose??false;const surface=options.surface??"cli";const headerLine=formatHeader(payload,useColors);const requestedLine=payload.requestedVersion?dim(`(requested ${sanitizeIdentity(payload.requestedVersion)})`,useColors):undefined;const filterLines=formatFilterLines(payload.filter);const transitiveBlock=payload.transitive?formatTransitiveAuditTerminal(payload.transitive,{verbose,useColors,surface,terminalWidth:options.terminalWidth,includeWithdrawn:payload.filter?.includeWithdrawn===true}):undefined;if(payload.summary.total===0){const lines=[headerLine];if(requestedLine)lines.push(requestedLine);lines.push(...filterLines);lines.push(formatNoAffectedVulnerabilitiesLine(payload));if(payload.advisories&&payload.advisories.length>0){const rangeLimit=resolveAffectedRangesLimit(options.terminalWidth);lines.push("",formatAdvisoryList(payload.advisories,verbose,useColors,rangeLimit,surface,options.terminalWidth))}if(transitiveBlock)lines.push("",transitiveBlock);return`${lines.join(`
|
|
148
151
|
`)}
|
|
149
152
|
`}const blocks=[];const headerBlock=[headerLine];if(requestedLine)headerBlock.push(requestedLine);headerBlock.push(...filterLines);headerBlock.push(formatSummaryLine(payload,useColors));const selectedAdvisoryCount=payload.advisories?.length??0;const scope=payload.filter?.advisoryScope;const selectedCountLine=formatSelectedAdvisoryCountLine(selectedAdvisoryCount,scope);if(selectedCountLine)headerBlock.push(selectedCountLine);const breakdown=scope===undefined?formatBreakdownLine(payload.summary,useColors,options.terminalWidth):undefined;if(breakdown)headerBlock.push(breakdown);blocks.push(headerBlock.join(`
|
|
150
153
|
`));if(payload.advisories&&payload.advisories.length>0){const rangeLimit=resolveAffectedRangesLimit(options.terminalWidth);blocks.push(formatAdvisoryList(payload.advisories,verbose,useColors,rangeLimit,surface,options.terminalWidth))}const upgradeFooter=formatUpgradeFooter(payload.upgradePaths);if(upgradeFooter)blocks.push(upgradeFooter);if(transitiveBlock)blocks.push(transitiveBlock);return`${blocks.join(`
|