@githits/mcp 0.13.0 → 0.15.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 CHANGED
@@ -201,6 +201,10 @@ interface UnifiedSearchParams {
201
201
  offset?: number;
202
202
  waitTimeoutMs?: number;
203
203
  }
204
+ interface UnifiedSearchReadOptions {
205
+ /** Omit compatibility navigation source when the caller renders only matched evidence. */
206
+ omitFocusedSource?: boolean;
207
+ }
204
208
  interface UnifiedSearchEvidenceRange {
205
209
  startLine: number;
206
210
  endLine: number;
@@ -279,9 +283,22 @@ interface UnifiedSearchFocusedSource {
279
283
  linesOmittedBefore: boolean;
280
284
  linesOmittedAfter: boolean;
281
285
  }
286
+ type UnifiedSearchBm25MatchField = "SYMBOL_NAME" | "FILE_PATH" | "DOCUMENTATION" | "SOURCE_IDENTIFIER";
287
+ /** Producer-proven focused source; independent of indexed-field provenance. */
288
+ interface UnifiedSearchMatchedSource extends Omit<UnifiedSearchFocusedSource, "rangeKind"> {
289
+ rangeKind: string;
290
+ }
291
+ /** Normalized crawled-page preview with zero-based, half-open grapheme ranges. */
292
+ interface UnifiedSearchDocumentationPreview {
293
+ text: string;
294
+ highlights: Array<readonly [number, number]>;
295
+ }
282
296
  interface UnifiedSearchRepositoryEvidence {
283
- focusedSource: UnifiedSearchFocusedSource | null;
297
+ focusedSource?: UnifiedSearchFocusedSource | null;
284
298
  semanticContext: UnifiedSearchSemanticContext | null;
299
+ /** Complete positive-term field list; null means unknown, not no matches. */
300
+ bm25MatchFields?: UnifiedSearchBm25MatchField[] | null;
301
+ matchedSource?: UnifiedSearchMatchedSource | null;
285
302
  }
286
303
  interface UnifiedSearchLocator {
287
304
  registry?: string;
@@ -322,6 +339,7 @@ interface UnifiedSearchHit {
322
339
  summary?: Array<readonly [number, number]>;
323
340
  };
324
341
  repositoryEvidence?: UnifiedSearchRepositoryEvidence | null;
342
+ documentationPreview?: UnifiedSearchDocumentationPreview | null;
325
343
  contentSafety?: ContentSafety;
326
344
  locator: UnifiedSearchLocator;
327
345
  requestedTargetLabel?: string;
@@ -723,8 +741,8 @@ interface GrepRepoResult {
723
741
  targetResolution?: TargetResolution;
724
742
  }
725
743
  interface CodeNavigationService {
726
- search(params: UnifiedSearchParams): Promise<UnifiedSearchOutcome>;
727
- searchStatus(searchRef: string, waitTimeoutMs?: number): Promise<UnifiedSearchOutcome>;
744
+ search(params: UnifiedSearchParams, options?: UnifiedSearchReadOptions): Promise<UnifiedSearchOutcome>;
745
+ searchStatus(searchRef: string, waitTimeoutMs?: number, options?: UnifiedSearchReadOptions): Promise<UnifiedSearchOutcome>;
728
746
  listFiles(params: ListFilesParams): Promise<ListFilesResult>;
729
747
  readFile(params: ReadFileParams): Promise<ReadFileResult>;
730
748
  grepRepo(params: GrepRepoParams): Promise<GrepRepoResult>;
@@ -754,8 +772,8 @@ declare class CodeNavigationServiceImpl implements CodeNavigationService, CodeDi
754
772
  diagnostics?: ServiceDiagnostics;
755
773
  });
756
774
  private postGraphqlWithTargetResolutionFallback;
757
- search(params: UnifiedSearchParams): Promise<UnifiedSearchOutcome>;
758
- searchStatus(searchRef: string, waitTimeoutMs?: number): Promise<UnifiedSearchOutcome>;
775
+ search(params: UnifiedSearchParams, options?: UnifiedSearchReadOptions): Promise<UnifiedSearchOutcome>;
776
+ searchStatus(searchRef: string, waitTimeoutMs?: number, options?: UnifiedSearchReadOptions): Promise<UnifiedSearchOutcome>;
759
777
  codeDiff(params: CodeDiffParams): Promise<CodeDiffResult>;
760
778
  private executeCodeDiff;
761
779
  private createCodeDiffRootError;
@@ -958,7 +976,11 @@ interface PackageVulnerabilitiesParams {
958
976
  minSeverity?: number;
959
977
  /** Optional — backend defaults to false when omitted. */
960
978
  includeWithdrawn?: boolean;
961
- /** Advisory rows to return; counts always include all scopes. */
979
+ /** Optional — only true enables the extra graph-analysis request; omission/false preserve direct-only behavior. */
980
+ includeTransitive?: boolean;
981
+ /** Optional internal breadth for advisory-wide transitive detail fields. */
982
+ includeTransitiveAdvisoryDetails?: boolean;
983
+ /** Advisory rows to return for the root and opt-in transitive audit; direct counts always include all scopes. */
962
984
  advisoryScope?: VulnerabilityScope;
963
985
  }
964
986
  type VulnerabilityScope = "AFFECTED" | "NON_AFFECTING" | "ALL";
@@ -999,6 +1021,25 @@ interface VulnerabilitySecurityDetails {
999
1021
  interface VulnerabilityReport {
1000
1022
  package: PackageVersionIdentity;
1001
1023
  security?: VulnerabilitySecurityDetails;
1024
+ transitive?: TransitiveVulnerabilityAudit;
1025
+ }
1026
+ interface TransitiveVulnerabilityAudit {
1027
+ /** Advisory scope applied to dependency-package occurrences. */
1028
+ advisoryScope: VulnerabilityScope;
1029
+ /** Number of resolved package-version graph nodes checked. */
1030
+ totalPackagesAnalyzed: number;
1031
+ /** Number of dependency package rows with occurrences in the selected scope. */
1032
+ packageCount: number;
1033
+ /** Number of advisory occurrences across dependency rows in the selected scope. */
1034
+ occurrenceCount: number;
1035
+ calculatedAt?: string;
1036
+ packages: TransitiveVulnerabilityAuditPackage[];
1037
+ }
1038
+ interface TransitiveVulnerabilityAuditPackage {
1039
+ registry: string;
1040
+ name: string;
1041
+ occurrenceCount: number;
1042
+ occurrences: TransitiveDependencyVulnerability[];
1002
1043
  }
1003
1044
  interface PackageDependenciesParams {
1004
1045
  registry: PkgseerRegistry;
@@ -1551,6 +1592,8 @@ declare class PackageIntelligenceServiceImpl implements PackageIntelligenceServi
1551
1592
  private executePackageVulnerabilities;
1552
1593
  private fetchPackageVulnerabilitiesPage;
1553
1594
  private normaliseVulnerabilityReport;
1595
+ private fetchTransitiveVulnerabilityAudit;
1596
+ private normaliseTransitiveVulnerabilityAudit;
1554
1597
  packageDependencies(params: PackageDependenciesParams): Promise<DependencyReport>;
1555
1598
  packageUpgradeDependencyProbe(params: PackageUpgradeDependencyProbeParams): Promise<DependencyReport>;
1556
1599
  packageUpgradeReview(params: PackageUpgradeReviewParams): Promise<PackageUpgradeReviewResponse>;
@@ -1560,6 +1603,7 @@ declare class PackageIntelligenceServiceImpl implements PackageIntelligenceServi
1560
1603
  private normaliseDependencyReport;
1561
1604
  private normaliseTransitiveVulnerabilitySummary;
1562
1605
  private normaliseVulnerabilitySummaryDetail;
1606
+ private normaliseTransitiveAuditAdvisory;
1563
1607
  private normaliseDependencyIssuesSummary;
1564
1608
  packageChangelog(params: PackageChangelogParams): Promise<ChangelogReport>;
1565
1609
  private executePackageChangelog;
package/dist/client.js CHANGED
@@ -1 +1 @@
1
- import{DEFAULT_MCP_URL2,DEFAULT_API_URL2,DEFAULT_CODE_NAV_URL2,getMcpUrl2,getApiUrl2,getCodeNavigationUrl2,getEnvApiToken2,GitHitsServiceImpl2,PKGSEER_REGISTRY_LIST2,toPkgseerRegistry2,toPkgseerRegistryLowercase2,CodeDiffError2,CodeNavigationServiceImpl2,PackageIntelligenceServiceImpl2,RefreshingGitHitsService2,createStaticTokenProvider2,createClientHeaderBuilder2}from"./shared/chunk-h6wfms9v.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,PKGSEER_REGISTRY_LIST2 as PKGSEER_REGISTRY_LIST,PackageIntelligenceServiceImpl2 as PackageIntelligenceServiceImpl,RefreshingGitHitsService2 as RefreshingGitHitsService,createClientHeaderBuilder2 as createClientHeaderBuilder,createStaticTokenProvider2 as createStaticTokenProvider,getApiUrl2 as getApiUrl,getCodeNavigationUrl2 as getCodeNavigationUrl,getEnvApiToken2 as getEnvApiToken,getMcpUrl2 as getMcpUrl,toPkgseerRegistry2 as toPkgseerRegistry,toPkgseerRegistryLowercase2 as toPkgseerRegistryLowercase};
1
+ import{DEFAULT_MCP_URL2,DEFAULT_API_URL2,DEFAULT_CODE_NAV_URL2,getMcpUrl2,getApiUrl2,getCodeNavigationUrl2,getEnvApiToken2,GitHitsServiceImpl2,PKGSEER_REGISTRY_LIST2,toPkgseerRegistry2,toPkgseerRegistryLowercase2,CodeDiffError2,CodeNavigationServiceImpl2,PackageIntelligenceServiceImpl2,RefreshingGitHitsService2,createStaticTokenProvider2,createClientHeaderBuilder2}from"./shared/chunk-vkwpw51c.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,PKGSEER_REGISTRY_LIST2 as PKGSEER_REGISTRY_LIST,PackageIntelligenceServiceImpl2 as PackageIntelligenceServiceImpl,RefreshingGitHitsService2 as RefreshingGitHitsService,createClientHeaderBuilder2 as createClientHeaderBuilder,createStaticTokenProvider2 as createStaticTokenProvider,getApiUrl2 as getApiUrl,getCodeNavigationUrl2 as getCodeNavigationUrl,getEnvApiToken2 as getEnvApiToken,getMcpUrl2 as getMcpUrl,toPkgseerRegistry2 as toPkgseerRegistry,toPkgseerRegistryLowercase2 as toPkgseerRegistryLowercase};
package/dist/index.d.ts CHANGED
@@ -149,6 +149,10 @@ interface UnifiedSearchParams {
149
149
  offset?: number;
150
150
  waitTimeoutMs?: number;
151
151
  }
152
+ interface UnifiedSearchReadOptions {
153
+ /** Omit compatibility navigation source when the caller renders only matched evidence. */
154
+ omitFocusedSource?: boolean;
155
+ }
152
156
  interface UnifiedSearchEvidenceRange {
153
157
  startLine: number;
154
158
  endLine: number;
@@ -227,9 +231,22 @@ interface UnifiedSearchFocusedSource {
227
231
  linesOmittedBefore: boolean;
228
232
  linesOmittedAfter: boolean;
229
233
  }
234
+ type UnifiedSearchBm25MatchField = "SYMBOL_NAME" | "FILE_PATH" | "DOCUMENTATION" | "SOURCE_IDENTIFIER";
235
+ /** Producer-proven focused source; independent of indexed-field provenance. */
236
+ interface UnifiedSearchMatchedSource extends Omit<UnifiedSearchFocusedSource, "rangeKind"> {
237
+ rangeKind: string;
238
+ }
239
+ /** Normalized crawled-page preview with zero-based, half-open grapheme ranges. */
240
+ interface UnifiedSearchDocumentationPreview {
241
+ text: string;
242
+ highlights: Array<readonly [number, number]>;
243
+ }
230
244
  interface UnifiedSearchRepositoryEvidence {
231
- focusedSource: UnifiedSearchFocusedSource | null;
245
+ focusedSource?: UnifiedSearchFocusedSource | null;
232
246
  semanticContext: UnifiedSearchSemanticContext | null;
247
+ /** Complete positive-term field list; null means unknown, not no matches. */
248
+ bm25MatchFields?: UnifiedSearchBm25MatchField[] | null;
249
+ matchedSource?: UnifiedSearchMatchedSource | null;
233
250
  }
234
251
  interface UnifiedSearchLocator {
235
252
  registry?: string;
@@ -270,6 +287,7 @@ interface UnifiedSearchHit {
270
287
  summary?: Array<readonly [number, number]>;
271
288
  };
272
289
  repositoryEvidence?: UnifiedSearchRepositoryEvidence | null;
290
+ documentationPreview?: UnifiedSearchDocumentationPreview | null;
273
291
  contentSafety?: ContentSafety;
274
292
  locator: UnifiedSearchLocator;
275
293
  requestedTargetLabel?: string;
@@ -522,8 +540,8 @@ interface GrepRepoResult {
522
540
  targetResolution?: TargetResolution;
523
541
  }
524
542
  interface CodeNavigationService {
525
- search(params: UnifiedSearchParams): Promise<UnifiedSearchOutcome>;
526
- searchStatus(searchRef: string, waitTimeoutMs?: number): Promise<UnifiedSearchOutcome>;
543
+ search(params: UnifiedSearchParams, options?: UnifiedSearchReadOptions): Promise<UnifiedSearchOutcome>;
544
+ searchStatus(searchRef: string, waitTimeoutMs?: number, options?: UnifiedSearchReadOptions): Promise<UnifiedSearchOutcome>;
527
545
  listFiles(params: ListFilesParams): Promise<ListFilesResult>;
528
546
  readFile(params: ReadFileParams): Promise<ReadFileResult>;
529
547
  grepRepo(params: GrepRepoParams): Promise<GrepRepoResult>;
@@ -647,7 +665,11 @@ interface PackageVulnerabilitiesParams {
647
665
  minSeverity?: number;
648
666
  /** Optional — backend defaults to false when omitted. */
649
667
  includeWithdrawn?: boolean;
650
- /** Advisory rows to return; counts always include all scopes. */
668
+ /** Optional — only true enables the extra graph-analysis request; omission/false preserve direct-only behavior. */
669
+ includeTransitive?: boolean;
670
+ /** Optional internal breadth for advisory-wide transitive detail fields. */
671
+ includeTransitiveAdvisoryDetails?: boolean;
672
+ /** Advisory rows to return for the root and opt-in transitive audit; direct counts always include all scopes. */
651
673
  advisoryScope?: VulnerabilityScope;
652
674
  }
653
675
  type VulnerabilityScope = "AFFECTED" | "NON_AFFECTING" | "ALL";
@@ -688,6 +710,25 @@ interface VulnerabilitySecurityDetails {
688
710
  interface VulnerabilityReport {
689
711
  package: PackageVersionIdentity;
690
712
  security?: VulnerabilitySecurityDetails;
713
+ transitive?: TransitiveVulnerabilityAudit;
714
+ }
715
+ interface TransitiveVulnerabilityAudit {
716
+ /** Advisory scope applied to dependency-package occurrences. */
717
+ advisoryScope: VulnerabilityScope;
718
+ /** Number of resolved package-version graph nodes checked. */
719
+ totalPackagesAnalyzed: number;
720
+ /** Number of dependency package rows with occurrences in the selected scope. */
721
+ packageCount: number;
722
+ /** Number of advisory occurrences across dependency rows in the selected scope. */
723
+ occurrenceCount: number;
724
+ calculatedAt?: string;
725
+ packages: TransitiveVulnerabilityAuditPackage[];
726
+ }
727
+ interface TransitiveVulnerabilityAuditPackage {
728
+ registry: string;
729
+ name: string;
730
+ occurrenceCount: number;
731
+ occurrences: TransitiveDependencyVulnerability[];
691
732
  }
692
733
  interface PackageDependenciesParams {
693
734
  registry: PkgseerRegistry;