@githits/mcp 0.29.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,8 +1417,9 @@ 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
+ /** Host projection; compact batch text skips statement retrieval entirely. */
1421
+ changelogView?: "text" | "json" | "triage";
1422
+ statementTiers?: ChangelogStatementTier[];
1422
1423
  packages: PackageUpgradeReviewPackageParams[];
1423
1424
  includeTransitiveSecurity: boolean;
1424
1425
  includeDependencyIssues: boolean;
@@ -1490,48 +1491,28 @@ interface PackageUpgradeChangelogEntry {
1490
1491
  headline?: string;
1491
1492
  signals: string[];
1492
1493
  }
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 {
1494
+ interface ChangelogRiskCoverage {
1514
1495
  versionsClassified: number;
1515
1496
  versionsNotAssessed: number;
1516
1497
  versionsWithoutNotes: number;
1517
1498
  versionsUnparseable: number;
1518
1499
  unitsNoImpact: number;
1519
- /** Statement totals before the per-review cap, separated by backend ambiguity. */
1500
+ /** Whole-range statement totals, separated by backend ambiguity. */
1520
1501
  itemsMustActConfident: number;
1521
1502
  itemsMustActAmbiguous: number;
1522
1503
  itemsShouldKnowConfident: number;
1523
1504
  itemsShouldKnowAmbiguous: number;
1524
1505
  itemsUnclassified: number;
1525
- itemsOmitted: number;
1526
1506
  }
1507
+ interface PackageUpgradeChangelogRiskCoverage extends ChangelogRiskCoverage {}
1527
1508
  interface PackageUpgradeChangelog {
1528
- riskItems: PackageUpgradeChangelogRiskItem[];
1509
+ statements?: ChangelogStatements;
1529
1510
  riskCoverage: PackageUpgradeChangelogRiskCoverage;
1530
1511
  source?: string;
1531
1512
  fallback?: string;
1532
- entries: PackageUpgradeChangelogEntry[];
1533
- sampledEntries: PackageUpgradeChangelogEntry[];
1534
- keywordEntries: PackageUpgradeChangelogEntry[];
1513
+ entries?: PackageUpgradeChangelogEntry[];
1514
+ sampledEntries?: PackageUpgradeChangelogEntry[];
1515
+ keywordEntries?: PackageUpgradeChangelogEntry[];
1535
1516
  totalKeywordEntries: number;
1536
1517
  totalEntries: number;
1537
1518
  totalEntriesWithBodies: number;
@@ -1831,8 +1812,11 @@ interface PackageChangelogParams {
1831
1812
  toVersion?: string;
1832
1813
  /** Latest-mode cap (1–50). Rejected client-side when `fromVersion` is set. */
1833
1814
  limit?: number;
1834
- /** Include raw markdown bodies in entries. Defaults to true. */
1835
- 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;
1836
1820
  }
1837
1821
  /**
1838
1822
  * Package-info echo from the changelog response. Mirrors
@@ -1856,12 +1840,60 @@ interface ChangelogEntryDetail {
1856
1840
  /** Present for exact selected-release results. */
1857
1841
  hasChangelog?: boolean;
1858
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
+ }
1859
1891
  interface ChangelogReport {
1860
- /** Echo of addressing + filter as the backend saw it. */
1892
+ statements?: ChangelogStatements;
1893
+ /** Optional legacy addressing echo; hosts already know the request identity. */
1861
1894
  package?: ChangelogPackageInfo;
1862
- /** `"releases"` | `"changelog_file"` | `"hexdocs"` when resolved; absent for package versions with no changelog entry. */
1863
1895
  source?: string;
1864
- /** Entries in backend/source order. Empty array = resolved source but nothing in range. */
1896
+ /** Entries in backend/source order. */
1865
1897
  entries: ChangelogEntryDetail[];
1866
1898
  }
1867
1899
  type PackageDocSourceKind = "CRAWLED" | "REPOSITORY";
@@ -1988,6 +2020,7 @@ declare class PackageIntelligenceServiceImpl implements PackageIntelligenceServi
1988
2020
  packageUpgradeDependencyProbe(params: PackageUpgradeDependencyProbeParams): Promise<DependencyReport>;
1989
2021
  packageUpgradeReview(params: PackageUpgradeReviewParams): Promise<PackageUpgradeReviewResponse>;
1990
2022
  private executePackageUpgradeReview;
2023
+ private fetchUpgradeStatementPage;
1991
2024
  private executePackageUpgradeDependencyProbe;
1992
2025
  private executePackageDependencies;
1993
2026
  private normaliseDependencyReport;
@@ -1997,10 +2030,7 @@ declare class PackageIntelligenceServiceImpl implements PackageIntelligenceServi
1997
2030
  private normaliseDependencyIssuesSummary;
1998
2031
  packageChangelog(params: PackageChangelogParams): Promise<ChangelogReport>;
1999
2032
  private executePackageChangelog;
2000
- private executeTimelinePackageChangelog;
2001
- private executeExactPackageChangelog;
2002
- private normaliseTimelineChangelogReport;
2003
- private normaliseExactChangelogReport;
2033
+ private fetchPackageChangelogPage;
2004
2034
  listPackageDocs(params: ListPackageDocsParams): Promise<PackageDocsList>;
2005
2035
  private executeListPackageDocs;
2006
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-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};
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,8 +1134,9 @@ 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
+ /** Host projection; compact batch text skips statement retrieval entirely. */
1138
+ changelogView?: "text" | "json" | "triage";
1139
+ statementTiers?: ChangelogStatementTier[];
1139
1140
  packages: PackageUpgradeReviewPackageParams[];
1140
1141
  includeTransitiveSecurity: boolean;
1141
1142
  includeDependencyIssues: boolean;
@@ -1207,48 +1208,28 @@ interface PackageUpgradeChangelogEntry {
1207
1208
  headline?: string;
1208
1209
  signals: string[];
1209
1210
  }
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 {
1211
+ interface ChangelogRiskCoverage {
1231
1212
  versionsClassified: number;
1232
1213
  versionsNotAssessed: number;
1233
1214
  versionsWithoutNotes: number;
1234
1215
  versionsUnparseable: number;
1235
1216
  unitsNoImpact: number;
1236
- /** Statement totals before the per-review cap, separated by backend ambiguity. */
1217
+ /** Whole-range statement totals, separated by backend ambiguity. */
1237
1218
  itemsMustActConfident: number;
1238
1219
  itemsMustActAmbiguous: number;
1239
1220
  itemsShouldKnowConfident: number;
1240
1221
  itemsShouldKnowAmbiguous: number;
1241
1222
  itemsUnclassified: number;
1242
- itemsOmitted: number;
1243
1223
  }
1224
+ interface PackageUpgradeChangelogRiskCoverage extends ChangelogRiskCoverage {}
1244
1225
  interface PackageUpgradeChangelog {
1245
- riskItems: PackageUpgradeChangelogRiskItem[];
1226
+ statements?: ChangelogStatements;
1246
1227
  riskCoverage: PackageUpgradeChangelogRiskCoverage;
1247
1228
  source?: string;
1248
1229
  fallback?: string;
1249
- entries: PackageUpgradeChangelogEntry[];
1250
- sampledEntries: PackageUpgradeChangelogEntry[];
1251
- keywordEntries: PackageUpgradeChangelogEntry[];
1230
+ entries?: PackageUpgradeChangelogEntry[];
1231
+ sampledEntries?: PackageUpgradeChangelogEntry[];
1232
+ keywordEntries?: PackageUpgradeChangelogEntry[];
1252
1233
  totalKeywordEntries: number;
1253
1234
  totalEntries: number;
1254
1235
  totalEntriesWithBodies: number;
@@ -1548,8 +1529,11 @@ interface PackageChangelogParams {
1548
1529
  toVersion?: string;
1549
1530
  /** Latest-mode cap (1–50). Rejected client-side when `fromVersion` is set. */
1550
1531
  limit?: number;
1551
- /** Include raw markdown bodies in entries. Defaults to true. */
1552
- 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;
1553
1537
  }
1554
1538
  /**
1555
1539
  * Package-info echo from the changelog response. Mirrors
@@ -1573,12 +1557,60 @@ interface ChangelogEntryDetail {
1573
1557
  /** Present for exact selected-release results. */
1574
1558
  hasChangelog?: boolean;
1575
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
+ }
1576
1608
  interface ChangelogReport {
1577
- /** Echo of addressing + filter as the backend saw it. */
1609
+ statements?: ChangelogStatements;
1610
+ /** Optional legacy addressing echo; hosts already know the request identity. */
1578
1611
  package?: ChangelogPackageInfo;
1579
- /** `"releases"` | `"changelog_file"` | `"hexdocs"` when resolved; absent for package versions with no changelog entry. */
1580
1612
  source?: string;
1581
- /** Entries in backend/source order. Empty array = resolved source but nothing in range. */
1613
+ /** Entries in backend/source order. */
1582
1614
  entries: ChangelogEntryDetail[];
1583
1615
  }
1584
1616
  type PackageDocSourceKind = "CRAWLED" | "REPOSITORY";