@githits/mcp 0.28.0 → 0.30.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
@@ -1417,6 +1417,9 @@ interface PackageUpgradeReviewPackageParams {
1417
1417
  targetVersion: string;
1418
1418
  }
1419
1419
  interface PackageUpgradeReviewParams {
1420
+ /** Host projection; compact batch text skips statement retrieval entirely. */
1421
+ changelogView?: "text" | "json" | "triage";
1422
+ statementTiers?: ChangelogStatementTier[];
1420
1423
  packages: PackageUpgradeReviewPackageParams[];
1421
1424
  includeTransitiveSecurity: boolean;
1422
1425
  includeDependencyIssues: boolean;
@@ -1479,6 +1482,7 @@ interface PackageUpgradeSecurity {
1479
1482
  transitive?: PackageUpgradeTransitiveSecurity;
1480
1483
  }
1481
1484
  interface PackageUpgradeChangelogEntry {
1485
+ detailSource?: string;
1482
1486
  version?: string;
1483
1487
  publishedAt?: string;
1484
1488
  htmlUrl?: string;
@@ -1487,12 +1491,28 @@ interface PackageUpgradeChangelogEntry {
1487
1491
  headline?: string;
1488
1492
  signals: string[];
1489
1493
  }
1494
+ interface ChangelogRiskCoverage {
1495
+ versionsClassified: number;
1496
+ versionsNotAssessed: number;
1497
+ versionsWithoutNotes: number;
1498
+ versionsUnparseable: number;
1499
+ unitsNoImpact: number;
1500
+ /** Whole-range statement totals, separated by backend ambiguity. */
1501
+ itemsMustActConfident: number;
1502
+ itemsMustActAmbiguous: number;
1503
+ itemsShouldKnowConfident: number;
1504
+ itemsShouldKnowAmbiguous: number;
1505
+ itemsUnclassified: number;
1506
+ }
1507
+ interface PackageUpgradeChangelogRiskCoverage extends ChangelogRiskCoverage {}
1490
1508
  interface PackageUpgradeChangelog {
1509
+ statements?: ChangelogStatements;
1510
+ riskCoverage: PackageUpgradeChangelogRiskCoverage;
1491
1511
  source?: string;
1492
1512
  fallback?: string;
1493
- entries: PackageUpgradeChangelogEntry[];
1494
- sampledEntries: PackageUpgradeChangelogEntry[];
1495
- keywordEntries: PackageUpgradeChangelogEntry[];
1513
+ entries?: PackageUpgradeChangelogEntry[];
1514
+ sampledEntries?: PackageUpgradeChangelogEntry[];
1515
+ keywordEntries?: PackageUpgradeChangelogEntry[];
1496
1516
  totalKeywordEntries: number;
1497
1517
  totalEntries: number;
1498
1518
  totalEntriesWithBodies: number;
@@ -1792,8 +1812,11 @@ interface PackageChangelogParams {
1792
1812
  toVersion?: string;
1793
1813
  /** Latest-mode cap (1–50). Rejected client-side when `fromVersion` is set. */
1794
1814
  limit?: number;
1795
- /** Include raw markdown bodies in entries. Defaults to true. */
1796
- includeBodies?: boolean;
1815
+ /** Default: complete parsed statements. Original notes and timeline do no label work. */
1816
+ view?: PackageChangelogView;
1817
+ statementTiers?: ChangelogStatementTier[];
1818
+ /** Select full statement text and classification provenance for machine consumers. */
1819
+ includeJsonFields?: boolean;
1797
1820
  }
1798
1821
  /**
1799
1822
  * Package-info echo from the changelog response. Mirrors
@@ -1817,12 +1840,60 @@ interface ChangelogEntryDetail {
1817
1840
  /** Present for exact selected-release results. */
1818
1841
  hasChangelog?: boolean;
1819
1842
  }
1843
+ type PackageChangelogView = "statements" | "verbatim" | "timeline";
1844
+ type ChangelogStatementTier = "MUST_ACT" | "SHOULD_KNOW" | "NO_IMPACT" | "UNCLASSIFIED";
1845
+ type ChangelogStatementAssessmentStatus = "CLASSIFIED" | "NOT_ASSESSED" | "WITHOUT_NOTES" | "UNPARSEABLE";
1846
+ interface ChangelogStatementClassification {
1847
+ tier: ChangelogStatementTier;
1848
+ ambiguous: boolean;
1849
+ kind?: string;
1850
+ tierConfidence?: number;
1851
+ kindConfidence?: number;
1852
+ model?: string;
1853
+ formulation?: string;
1854
+ }
1855
+ interface ChangelogStatementContext {
1856
+ heading?: string;
1857
+ text: string;
1858
+ textTruncated: boolean;
1859
+ fullText?: string;
1860
+ }
1861
+ interface ChangelogStatement {
1862
+ version: string;
1863
+ position: number;
1864
+ sourceIndex: number;
1865
+ sourcePosition?: number;
1866
+ heading?: string;
1867
+ source?: string;
1868
+ url?: string;
1869
+ text: string;
1870
+ textTruncated: boolean;
1871
+ fullText?: string;
1872
+ context?: ChangelogStatementContext;
1873
+ /** Null is missing assessment, never a no-impact classification. */
1874
+ classification: ChangelogStatementClassification | null;
1875
+ }
1876
+ interface ChangelogStatementCoverage {
1877
+ version: string;
1878
+ status: ChangelogStatementAssessmentStatus;
1879
+ statementsTotal: number;
1880
+ statementsAssessed: number;
1881
+ statementsNotAssessed: number;
1882
+ statementsNoImpact: number;
1883
+ statementsUnclassified: number;
1884
+ }
1885
+ interface ChangelogStatements {
1886
+ totalCount: number;
1887
+ matchingCount: number;
1888
+ items: ChangelogStatement[];
1889
+ coverage: ChangelogStatementCoverage[];
1890
+ }
1820
1891
  interface ChangelogReport {
1821
- /** Echo of addressing + filter as the backend saw it. */
1892
+ statements?: ChangelogStatements;
1893
+ /** Optional legacy addressing echo; hosts already know the request identity. */
1822
1894
  package?: ChangelogPackageInfo;
1823
- /** `"releases"` | `"changelog_file"` | `"hexdocs"` when resolved; absent for package versions with no changelog entry. */
1824
1895
  source?: string;
1825
- /** Entries in backend/source order. Empty array = resolved source but nothing in range. */
1896
+ /** Entries in backend/source order. */
1826
1897
  entries: ChangelogEntryDetail[];
1827
1898
  }
1828
1899
  type PackageDocSourceKind = "CRAWLED" | "REPOSITORY";
@@ -1949,6 +2020,7 @@ declare class PackageIntelligenceServiceImpl implements PackageIntelligenceServi
1949
2020
  packageUpgradeDependencyProbe(params: PackageUpgradeDependencyProbeParams): Promise<DependencyReport>;
1950
2021
  packageUpgradeReview(params: PackageUpgradeReviewParams): Promise<PackageUpgradeReviewResponse>;
1951
2022
  private executePackageUpgradeReview;
2023
+ private fetchUpgradeStatementPage;
1952
2024
  private executePackageUpgradeDependencyProbe;
1953
2025
  private executePackageDependencies;
1954
2026
  private normaliseDependencyReport;
@@ -1958,10 +2030,7 @@ declare class PackageIntelligenceServiceImpl implements PackageIntelligenceServi
1958
2030
  private normaliseDependencyIssuesSummary;
1959
2031
  packageChangelog(params: PackageChangelogParams): Promise<ChangelogReport>;
1960
2032
  private executePackageChangelog;
1961
- private executeTimelinePackageChangelog;
1962
- private executeExactPackageChangelog;
1963
- private normaliseTimelineChangelogReport;
1964
- private normaliseExactChangelogReport;
2033
+ private fetchPackageChangelogPage;
1965
2034
  listPackageDocs(params: ListPackageDocsParams): Promise<PackageDocsList>;
1966
2035
  private executeListPackageDocs;
1967
2036
  private normalisePackageDocsList;
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-7bhsf72k.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-9krxa3vd.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};
1
+ import{GrepGraphQLError2,GrepBackendError2,GrepAccessError2,GrepNetworkError2,MalformedGrepResponseError2,GrepServiceImpl2,ListAccessError2,ListGraphQLError2,ListBackendError2,ListNetworkError2,MalformedListResponseError2,ListServiceImpl2,ReadServiceImpl2,RefreshingGitHitsService2,ResolveTargetServiceImpl2,createStaticTokenProvider2,SessionIdConfigError2,getEnvSessionId2,createClientHeaderBuilder2}from"./shared/chunk-876mzceb.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-2tjd7frp.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,9 @@ interface PackageUpgradeReviewPackageParams {
1134
1134
  targetVersion: string;
1135
1135
  }
1136
1136
  interface PackageUpgradeReviewParams {
1137
+ /** Host projection; compact batch text skips statement retrieval entirely. */
1138
+ changelogView?: "text" | "json" | "triage";
1139
+ statementTiers?: ChangelogStatementTier[];
1137
1140
  packages: PackageUpgradeReviewPackageParams[];
1138
1141
  includeTransitiveSecurity: boolean;
1139
1142
  includeDependencyIssues: boolean;
@@ -1196,6 +1199,7 @@ interface PackageUpgradeSecurity {
1196
1199
  transitive?: PackageUpgradeTransitiveSecurity;
1197
1200
  }
1198
1201
  interface PackageUpgradeChangelogEntry {
1202
+ detailSource?: string;
1199
1203
  version?: string;
1200
1204
  publishedAt?: string;
1201
1205
  htmlUrl?: string;
@@ -1204,12 +1208,28 @@ interface PackageUpgradeChangelogEntry {
1204
1208
  headline?: string;
1205
1209
  signals: string[];
1206
1210
  }
1211
+ interface ChangelogRiskCoverage {
1212
+ versionsClassified: number;
1213
+ versionsNotAssessed: number;
1214
+ versionsWithoutNotes: number;
1215
+ versionsUnparseable: number;
1216
+ unitsNoImpact: number;
1217
+ /** Whole-range statement totals, separated by backend ambiguity. */
1218
+ itemsMustActConfident: number;
1219
+ itemsMustActAmbiguous: number;
1220
+ itemsShouldKnowConfident: number;
1221
+ itemsShouldKnowAmbiguous: number;
1222
+ itemsUnclassified: number;
1223
+ }
1224
+ interface PackageUpgradeChangelogRiskCoverage extends ChangelogRiskCoverage {}
1207
1225
  interface PackageUpgradeChangelog {
1226
+ statements?: ChangelogStatements;
1227
+ riskCoverage: PackageUpgradeChangelogRiskCoverage;
1208
1228
  source?: string;
1209
1229
  fallback?: string;
1210
- entries: PackageUpgradeChangelogEntry[];
1211
- sampledEntries: PackageUpgradeChangelogEntry[];
1212
- keywordEntries: PackageUpgradeChangelogEntry[];
1230
+ entries?: PackageUpgradeChangelogEntry[];
1231
+ sampledEntries?: PackageUpgradeChangelogEntry[];
1232
+ keywordEntries?: PackageUpgradeChangelogEntry[];
1213
1233
  totalKeywordEntries: number;
1214
1234
  totalEntries: number;
1215
1235
  totalEntriesWithBodies: number;
@@ -1509,8 +1529,11 @@ interface PackageChangelogParams {
1509
1529
  toVersion?: string;
1510
1530
  /** Latest-mode cap (1–50). Rejected client-side when `fromVersion` is set. */
1511
1531
  limit?: number;
1512
- /** Include raw markdown bodies in entries. Defaults to true. */
1513
- includeBodies?: boolean;
1532
+ /** Default: complete parsed statements. Original notes and timeline do no label work. */
1533
+ view?: PackageChangelogView;
1534
+ statementTiers?: ChangelogStatementTier[];
1535
+ /** Select full statement text and classification provenance for machine consumers. */
1536
+ includeJsonFields?: boolean;
1514
1537
  }
1515
1538
  /**
1516
1539
  * Package-info echo from the changelog response. Mirrors
@@ -1534,12 +1557,60 @@ interface ChangelogEntryDetail {
1534
1557
  /** Present for exact selected-release results. */
1535
1558
  hasChangelog?: boolean;
1536
1559
  }
1560
+ type PackageChangelogView = "statements" | "verbatim" | "timeline";
1561
+ type ChangelogStatementTier = "MUST_ACT" | "SHOULD_KNOW" | "NO_IMPACT" | "UNCLASSIFIED";
1562
+ type ChangelogStatementAssessmentStatus = "CLASSIFIED" | "NOT_ASSESSED" | "WITHOUT_NOTES" | "UNPARSEABLE";
1563
+ interface ChangelogStatementClassification {
1564
+ tier: ChangelogStatementTier;
1565
+ ambiguous: boolean;
1566
+ kind?: string;
1567
+ tierConfidence?: number;
1568
+ kindConfidence?: number;
1569
+ model?: string;
1570
+ formulation?: string;
1571
+ }
1572
+ interface ChangelogStatementContext {
1573
+ heading?: string;
1574
+ text: string;
1575
+ textTruncated: boolean;
1576
+ fullText?: string;
1577
+ }
1578
+ interface ChangelogStatement {
1579
+ version: string;
1580
+ position: number;
1581
+ sourceIndex: number;
1582
+ sourcePosition?: number;
1583
+ heading?: string;
1584
+ source?: string;
1585
+ url?: string;
1586
+ text: string;
1587
+ textTruncated: boolean;
1588
+ fullText?: string;
1589
+ context?: ChangelogStatementContext;
1590
+ /** Null is missing assessment, never a no-impact classification. */
1591
+ classification: ChangelogStatementClassification | null;
1592
+ }
1593
+ interface ChangelogStatementCoverage {
1594
+ version: string;
1595
+ status: ChangelogStatementAssessmentStatus;
1596
+ statementsTotal: number;
1597
+ statementsAssessed: number;
1598
+ statementsNotAssessed: number;
1599
+ statementsNoImpact: number;
1600
+ statementsUnclassified: number;
1601
+ }
1602
+ interface ChangelogStatements {
1603
+ totalCount: number;
1604
+ matchingCount: number;
1605
+ items: ChangelogStatement[];
1606
+ coverage: ChangelogStatementCoverage[];
1607
+ }
1537
1608
  interface ChangelogReport {
1538
- /** Echo of addressing + filter as the backend saw it. */
1609
+ statements?: ChangelogStatements;
1610
+ /** Optional legacy addressing echo; hosts already know the request identity. */
1539
1611
  package?: ChangelogPackageInfo;
1540
- /** `"releases"` | `"changelog_file"` | `"hexdocs"` when resolved; absent for package versions with no changelog entry. */
1541
1612
  source?: string;
1542
- /** Entries in backend/source order. Empty array = resolved source but nothing in range. */
1613
+ /** Entries in backend/source order. */
1543
1614
  entries: ChangelogEntryDetail[];
1544
1615
  }
1545
1616
  type PackageDocSourceKind = "CRAWLED" | "REPOSITORY";