@githits/mcp 0.16.1 → 0.16.2

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.
@@ -5,4 +5,4 @@ var EXPECTED_MCP_TOOLS=["quick_start","get_example","search_language","pkg_info"
5
5
  Security
6
6
  `)&&upgradeReviewText.includes(`
7
7
  Changes
8
- `),"pkg_upgrade_review default missing grouped evidence");assert(!upgradeReviewText.includes("pkg_upgrade_review")&&!/\b(?:recommendation|risk level|assessment)\b/i.test(upgradeReviewText),"pkg_upgrade_review default leaked assessment language");const upgradeReviewJson=assertJsonResult(await callTool(caller,"pkg_upgrade_review",{registry:"npm",package_name:"express",current_version:"5.0.0",target_version:"5.2.1",skip_transitive_security:true,format:"json"}),"pkg_upgrade_review json");assertRecord(upgradeReviewJson,"pkg_upgrade_review json");assertRecord(upgradeReviewJson.summary,"pkg_upgrade_review json summary");assert(Array.isArray(upgradeReviewJson.reviews),"pkg_upgrade_review json missing reviews array");const firstUpgradeReview=upgradeReviewJson.reviews[0];assert(firstUpgradeReview,"pkg_upgrade_review json missing first review");for(const forbidden of["risk","riskLevel","recommendation","findings","verification"]){assert(!(forbidden in firstUpgradeReview),`pkg_upgrade_review json leaked judgment field ${forbidden}`)}const docsJson=assertJsonResult(await callTool(caller,"docs_list",{...SMOKE_PACKAGE_TARGET,limit:500,format:"json"}),"docs_list json");assertRecord(docsJson,"docs_list json");assert(Array.isArray(docsJson.pages),"docs_list json missing pages array");const docsPages=docsJson.pages;const crawledPage=docsPages.find((page)=>typeof page==="object"&&page!==null&&page.sourceKind==="crawled"&&typeof page.docsReadTarget==="string"&&/^https?:\/\//.test(page.docsReadTarget));const repoPage=docsPages.find((page)=>typeof page==="object"&&page!==null&&page.sourceKind==="repo");assert(crawledPage&&typeof crawledPage.docsReadTarget==="string"&&typeof crawledPage.pageId==="string"&&typeof crawledPage.sourceUrl==="string","docs_list json missing crawled URL target, stable page ID, or source URL");assert(repoPage&&typeof repoPage.docsReadTarget==="string"&&typeof repoPage.pageId==="string"&&typeof repoPage.sourceUrl==="string","docs_list json missing repo-backed target, stable page ID, or source URL");assert(repoPage.docsReadTarget===repoPage.pageId,"docs_list json repo-backed docsReadTarget should remain snapshot-pinned");const crawledPageIndex=docsPages.indexOf(crawledPage);let crawledPageAfter;if(crawledPageIndex>0){const precedingDocs=assertJsonResult(await callTool(caller,"docs_list",{...SMOKE_PACKAGE_TARGET,limit:crawledPageIndex,format:"json"}),"docs_list crawled target cursor");assertRecord(precedingDocs,"docs_list crawled target cursor");assert(typeof precedingDocs.nextCursor==="string","docs_list crawled target cursor missing nextCursor");crawledPageAfter=precedingDocs.nextCursor}const docsText=assertDefaultText(await callTool(caller,"docs_list",{...SMOKE_PACKAGE_TARGET,limit:1,...crawledPageAfter?{after:crawledPageAfter}:{}}),"docs_list crawled target default");assert(docsText.includes(`docs_read page_id=${JSON.stringify(crawledPage.docsReadTarget)}`),"docs_list default missing crawled URL follow-up");const docReadText=assertDefaultText(await callTool(caller,"docs_read",{page_id:crawledPage.docsReadTarget,start_line:1,end_line:5}),"docs_read crawled URL default");assert(docReadText.length>0,"docs_read crawled URL default missing content");const docReadJson=assertJsonResult(await callTool(caller,"docs_read",{page_id:crawledPage.docsReadTarget,start_line:1,end_line:5,format:"json"}),"docs_read crawled URL json");assertRecord(docReadJson,"docs_read crawled URL json");assert(docReadJson.docsReadTarget===crawledPage.docsReadTarget&&docReadJson.pageId===crawledPage.pageId&&docReadJson.sourceUrl===crawledPage.sourceUrl&&typeof docReadJson.content==="string","docs_read crawled URL json missing target, page ID, source URL, or content");const legacyCrawledRead=assertJsonResult(await callTool(caller,"docs_read",{page_id:crawledPage.pageId,start_line:1,end_line:5,format:"json"}),"docs_read legacy crawled ID json");assertRecord(legacyCrawledRead,"docs_read legacy crawled ID json");assert(legacyCrawledRead.pageId===docReadJson.pageId&&legacyCrawledRead.content===docReadJson.content,"docs_read URL and legacy crawled ID returned different ranged content");const repoRead=assertJsonResult(await callTool(caller,"docs_read",{page_id:repoPage.docsReadTarget,format:"json"}),"docs_read repo-backed ID json");assertRecord(repoRead,"docs_read repo-backed ID json");assert(repoRead.docsReadTarget===repoPage.docsReadTarget&&repoRead.pageId===repoPage.pageId&&typeof repoRead.content==="string","docs_read repo-backed ID json missing snapshot target, page ID, or content");assertErrorCode(await callTool(caller,"docs_read",{page_id:"https://docs.example.invalid/githits-smoke-unknown",format:"json"}),"docs_read unknown URL","NOT_FOUND");const codeFilesText=assertDefaultText(await callTool(caller,"code_files",{target:SMOKE_PACKAGE_TARGET,path_prefix:"package.json",limit:1}),"code_files default");assert(codeFilesText.includes("package.json"),"code_files default missing package.json");const codeFilesJson=assertJsonResult(await callTool(caller,"code_files",{target:SMOKE_PACKAGE_TARGET,path_prefix:"package.json",limit:1,format:"json"}),"code_files json");assertRecord(codeFilesJson,"code_files json");assert(Array.isArray(codeFilesJson.files),"code_files json missing files array");const codeReadText=assertDefaultText(await callTool(caller,"code_read",{target:SMOKE_PACKAGE_TARGET,path:"package.json",start_line:1,end_line:5}),"code_read default");assert(/^1\s+/m.test(codeReadText),"code_read default missing line numbers");const codeReadJson=assertJsonResult(await callTool(caller,"code_read",{target:SMOKE_PACKAGE_TARGET,path:"package.json",start_line:1,end_line:5,format:"json"}),"code_read json");assertRecord(codeReadJson,"code_read json");assert(codeReadJson.path==="package.json","code_read json path mismatch");const codeGrepText=assertDefaultText(await callTool(caller,"code_grep",{target:SMOKE_PACKAGE_TARGET,pattern:"express",path:"package.json",max_matches:1,context_lines_after:12}),"code_grep default");assert(codeGrepText.includes("package.json"),"code_grep default missing package.json");assert(codeGrepText.includes("requested 0 / 12"),"code_grep missing context clamping notice");const codeGrepJson=assertJsonResult(await callTool(caller,"code_grep",{target:SMOKE_PACKAGE_TARGET,pattern:"express",path:"package.json",max_matches:1,context_lines_after:12,format:"json"}),"code_grep json");assertRecord(codeGrepJson,"code_grep json");assert("matches"in codeGrepJson||"totalMatches"in codeGrepJson,"code_grep json missing matches");assertRecord(codeGrepJson.contextClamping,"code_grep context clamping");assert(codeGrepJson.contextClamping.requestedAfter===12&&codeGrepJson.contextClamping.effectiveAfter===10,"code_grep context clamping mismatch");const searchText=assertDefaultText(await callTool(caller,"search",{target:SMOKE_PACKAGE_TARGET,query:"router",limit:1}),"search default");assertSearchDefaultText(searchText,"search default");const searchJson=assertJsonResult(await callTool(caller,"search",{target:SMOKE_PACKAGE_TARGET,query:"router",limit:1,format:"json"}),"search json");assertRecord(searchJson,"search json");const searchRef=typeof searchJson.searchRef==="string"?searchJson.searchRef:undefined;if(searchRef){const statusJson=assertJsonResult(await callTool(caller,"search_status",{search_ref:searchRef,wait_timeout_ms:0,format:"json"}),"search_status json");assertRecord(statusJson,"search_status json");assert("completed"in statusJson||"progress"in statusJson,"search_status json missing status data")}else{assertErrorCode(await callTool(caller,"search_status",{search_ref:"smoke-invalid-search-ref",wait_timeout_ms:0}),"search_status invalid ref","NOT_FOUND")}}async function runMcpSmoke(caller,options={}){const logger=options.logger??console;const includeLiveTools=options.includeLiveTools??true;const toolsResponse=await caller.listTools();const toolNames=new Set(toolsResponse.tools.map((tool)=>tool.name));assert(!toolNames.has("feedback"),"listTools advertises removed feedback tool");for(const expected of EXPECTED_MCP_TOOLS){assert(toolNames.has(expected),`listTools missing ${expected}`)}for(const tool of toolsResponse.tools){assert(tool.annotations?.readOnlyHint===true,`${tool.name} must advertise readOnlyHint: true`)}const quickStart=assertDefaultText(await callTool(caller,"quick_start",{}),"quick_start default");for(const expected of["GitHits routing guide","`search`","`code_grep`"]){assert(quickStart.includes(expected),`quick_start default missing ${expected}`)}if(!includeLiveTools)return;if(await assertLiveOrAuthRequired(caller,logger)){await runLiveSmoke(caller);logger.log("MCP smoke passed")}}export{EXPECTED_MCP_TOOLS,assertCleanErrorEnvelope,assertDefaultText,assertHttpUnauthorizedChallenge,assertJsonResult,callToolText,resultText,runMcpSmoke};
8
+ `),"pkg_upgrade_review default missing grouped evidence");assert(!upgradeReviewText.includes("pkg_upgrade_review")&&!/\b(?:recommendation|risk level|assessment)\b/i.test(upgradeReviewText),"pkg_upgrade_review default leaked assessment language");const upgradeReviewJson=assertJsonResult(await callTool(caller,"pkg_upgrade_review",{registry:"npm",package_name:"express",current_version:"5.0.0",target_version:"5.2.1",skip_transitive_security:true,format:"json"}),"pkg_upgrade_review json");assertRecord(upgradeReviewJson,"pkg_upgrade_review json");assertRecord(upgradeReviewJson.summary,"pkg_upgrade_review json summary");assert(Array.isArray(upgradeReviewJson.reviews),"pkg_upgrade_review json missing reviews array");const firstUpgradeReview=upgradeReviewJson.reviews[0];assert(firstUpgradeReview,"pkg_upgrade_review json missing first review");for(const forbidden of["risk","riskLevel","recommendation","findings","verification"]){assert(!(forbidden in firstUpgradeReview),`pkg_upgrade_review json leaked judgment field ${forbidden}`)}const docsJson=assertJsonResult(await callTool(caller,"docs_list",{...SMOKE_PACKAGE_TARGET,limit:500,format:"json"}),"docs_list json");assertRecord(docsJson,"docs_list json");assert(Array.isArray(docsJson.pages),"docs_list json missing pages array");const docsPages=docsJson.pages;const crawledPage=docsPages.find((page)=>typeof page==="object"&&page!==null&&page.sourceKind==="crawled"&&typeof page.docsReadTarget==="string"&&/^https?:\/\//.test(page.docsReadTarget));const repoPage=docsPages.find((page)=>typeof page==="object"&&page!==null&&page.sourceKind==="repo");assert(crawledPage&&typeof crawledPage.docsReadTarget==="string"&&typeof crawledPage.pageId==="string"&&typeof crawledPage.sourceUrl==="string","docs_list json missing crawled URL target, stable page ID, or source URL");assert(repoPage&&typeof repoPage.docsReadTarget==="string"&&typeof repoPage.pageId==="string"&&typeof repoPage.sourceUrl==="string","docs_list json missing repo-backed target, stable page ID, or source URL");assert(repoPage.docsReadTarget===repoPage.pageId,"docs_list json repo-backed docsReadTarget should remain snapshot-pinned");const crawledPageIndex=docsPages.indexOf(crawledPage);let crawledPageAfter;if(crawledPageIndex>0){const precedingDocs=assertJsonResult(await callTool(caller,"docs_list",{...SMOKE_PACKAGE_TARGET,limit:crawledPageIndex,format:"json"}),"docs_list crawled target cursor");assertRecord(precedingDocs,"docs_list crawled target cursor");assert(typeof precedingDocs.nextCursor==="string","docs_list crawled target cursor missing nextCursor");crawledPageAfter=precedingDocs.nextCursor}const docsText=assertDefaultText(await callTool(caller,"docs_list",{...SMOKE_PACKAGE_TARGET,limit:1,...crawledPageAfter?{after:crawledPageAfter}:{}}),"docs_list crawled target default");assert(docsText.includes(`docs_read page_id=${JSON.stringify(crawledPage.docsReadTarget)}`),"docs_list default missing crawled URL follow-up");const docReadText=assertDefaultText(await callTool(caller,"docs_read",{page_id:crawledPage.docsReadTarget,start_line:1,end_line:5}),"docs_read crawled URL default");assert(docReadText.length>0,"docs_read crawled URL default missing content");const docReadJson=assertJsonResult(await callTool(caller,"docs_read",{page_id:crawledPage.docsReadTarget,start_line:1,end_line:5,format:"json"}),"docs_read crawled URL json");assertRecord(docReadJson,"docs_read crawled URL json");assert(docReadJson.docsReadTarget===crawledPage.docsReadTarget&&docReadJson.pageId===crawledPage.pageId&&docReadJson.sourceUrl===crawledPage.sourceUrl&&typeof docReadJson.content==="string"&&docReadJson.startLine===1&&typeof docReadJson.endLine==="number"&&docReadJson.endLine>=1&&docReadJson.endLine<=5&&typeof docReadJson.totalLines==="number"&&docReadJson.totalLines>=docReadJson.endLine,"docs_read crawled URL json missing locators, content, or backend range");const legacyCrawledRead=assertJsonResult(await callTool(caller,"docs_read",{page_id:crawledPage.pageId,start_line:1,end_line:5,format:"json"}),"docs_read legacy crawled ID json");assertRecord(legacyCrawledRead,"docs_read legacy crawled ID json");assert(legacyCrawledRead.pageId===docReadJson.pageId&&legacyCrawledRead.content===docReadJson.content,"docs_read URL and legacy crawled ID returned different ranged content");const repoRead=assertJsonResult(await callTool(caller,"docs_read",{page_id:repoPage.docsReadTarget,format:"json"}),"docs_read repo-backed ID json");assertRecord(repoRead,"docs_read repo-backed ID json");assert(repoRead.docsReadTarget===repoPage.docsReadTarget&&repoRead.pageId===repoPage.pageId&&typeof repoRead.content==="string"&&typeof repoRead.totalLines==="number"&&(repoRead.totalLines===0||typeof repoRead.startLine==="number"&&typeof repoRead.endLine==="number"),"docs_read repo-backed ID json missing snapshot locators, content, or range");assertErrorCode(await callTool(caller,"docs_read",{page_id:"https://docs.example.invalid/githits-smoke-unknown",format:"json"}),"docs_read unknown URL","NOT_FOUND");const codeFilesText=assertDefaultText(await callTool(caller,"code_files",{target:SMOKE_PACKAGE_TARGET,path_prefix:"package.json",limit:1}),"code_files default");assert(codeFilesText.includes("package.json"),"code_files default missing package.json");const codeFilesJson=assertJsonResult(await callTool(caller,"code_files",{target:SMOKE_PACKAGE_TARGET,path_prefix:"package.json",limit:1,format:"json"}),"code_files json");assertRecord(codeFilesJson,"code_files json");assert(Array.isArray(codeFilesJson.files),"code_files json missing files array");const codeReadText=assertDefaultText(await callTool(caller,"code_read",{target:SMOKE_PACKAGE_TARGET,path:"package.json",start_line:1,end_line:5}),"code_read default");assert(/^1\s+/m.test(codeReadText),"code_read default missing line numbers");const codeReadJson=assertJsonResult(await callTool(caller,"code_read",{target:SMOKE_PACKAGE_TARGET,path:"package.json",start_line:1,end_line:5,format:"json"}),"code_read json");assertRecord(codeReadJson,"code_read json");assert(codeReadJson.path==="package.json","code_read json path mismatch");const codeGrepText=assertDefaultText(await callTool(caller,"code_grep",{target:SMOKE_PACKAGE_TARGET,pattern:"express",path:"package.json",max_matches:1,context_lines_after:12}),"code_grep default");assert(codeGrepText.includes("package.json"),"code_grep default missing package.json");assert(codeGrepText.includes("requested 0 / 12"),"code_grep missing context clamping notice");const codeGrepJson=assertJsonResult(await callTool(caller,"code_grep",{target:SMOKE_PACKAGE_TARGET,pattern:"express",path:"package.json",max_matches:1,context_lines_after:12,format:"json"}),"code_grep json");assertRecord(codeGrepJson,"code_grep json");assert("matches"in codeGrepJson||"totalMatches"in codeGrepJson,"code_grep json missing matches");assertRecord(codeGrepJson.contextClamping,"code_grep context clamping");assert(codeGrepJson.contextClamping.requestedAfter===12&&codeGrepJson.contextClamping.effectiveAfter===10,"code_grep context clamping mismatch");assertErrorCode(await callTool(caller,"search",{target:SMOKE_PACKAGE_TARGET,query:"router",source:"docs",path_prefix:"docs/",format:"json"}),"search unsupported path prefix","INVALID_ARGUMENT");const searchText=assertDefaultText(await callTool(caller,"search",{target:SMOKE_PACKAGE_TARGET,query:"router",limit:1}),"search default");assertSearchDefaultText(searchText,"search default");const searchJson=assertJsonResult(await callTool(caller,"search",{target:SMOKE_PACKAGE_TARGET,query:"router",limit:1,format:"json"}),"search json");assertRecord(searchJson,"search json");const searchRef=typeof searchJson.searchRef==="string"?searchJson.searchRef:undefined;if(searchRef){const statusJson=assertJsonResult(await callTool(caller,"search_status",{search_ref:searchRef,wait_timeout_ms:0,format:"json"}),"search_status json");assertRecord(statusJson,"search_status json");assert("completed"in statusJson||"progress"in statusJson,"search_status json missing status data")}else{assertErrorCode(await callTool(caller,"search_status",{search_ref:"smoke-invalid-search-ref",wait_timeout_ms:0}),"search_status invalid ref","NOT_FOUND")}}async function runMcpSmoke(caller,options={}){const logger=options.logger??console;const includeLiveTools=options.includeLiveTools??true;const toolsResponse=await caller.listTools();const toolNames=new Set(toolsResponse.tools.map((tool)=>tool.name));assert(!toolNames.has("feedback"),"listTools advertises removed feedback tool");for(const expected of EXPECTED_MCP_TOOLS){assert(toolNames.has(expected),`listTools missing ${expected}`)}for(const tool of toolsResponse.tools){assert(tool.annotations?.readOnlyHint===true,`${tool.name} must advertise readOnlyHint: true`)}const quickStart=assertDefaultText(await callTool(caller,"quick_start",{}),"quick_start default");for(const expected of["GitHits routing guide","`search`","`code_grep`"]){assert(quickStart.includes(expected),`quick_start default missing ${expected}`)}if(!includeLiveTools)return;if(await assertLiveOrAuthRequired(caller,logger)){await runLiveSmoke(caller);logger.log("MCP smoke passed")}}export{EXPECTED_MCP_TOOLS,assertCleanErrorEnvelope,assertDefaultText,assertHttpUnauthorizedChallenge,assertJsonResult,callToolText,resultText,runMcpSmoke};
package/dist/tools.js CHANGED
@@ -1 +1 @@
1
- import{createGetExampleTool2}from"./shared/chunk-9kvwrp49.js";import{AuthenticationError2,ApiRateLimitError2,FetchTimeoutError2,TermsAcceptanceRequiredError2}from"./shared/chunk-q07qg1z9.js";import{z}from"zod";function toCallableTool(definition){const input=z.object(definition.schema);const inputSchema=z.toJSONSchema(input,{io:"input"});return{name:definition.name,description:definition.description,inputSchema,annotations:definition.annotations,execute:async(value,options)=>{const args=input.parse(value);const context={authAction:"Authenticate with GitHits, then retry.",...options?.signal?{signal:options.signal}:{}};return definition.handler(args,context)}}}var AuthenticationError=AuthenticationError2;var ApiRateLimitError=ApiRateLimitError2;var FetchTimeoutError=FetchTimeoutError2;var TermsAcceptanceRequiredError=TermsAcceptanceRequiredError2;export{ApiRateLimitError,AuthenticationError,FetchTimeoutError,TermsAcceptanceRequiredError,createGetExampleTool2 as createGetExampleTool,toCallableTool};
1
+ import{createGetExampleTool2}from"./shared/chunk-8xv6evhm.js";import{AuthenticationError2,ApiRateLimitError2,FetchTimeoutError2,TermsAcceptanceRequiredError2}from"./shared/chunk-q07qg1z9.js";import{z}from"zod";function toCallableTool(definition){const input=z.object(definition.schema);const inputSchema=z.toJSONSchema(input,{io:"input"});return{name:definition.name,description:definition.description,inputSchema,annotations:definition.annotations,execute:async(value,options)=>{const args=input.parse(value);const context={authAction:"Authenticate with GitHits, then retry.",...options?.signal?{signal:options.signal}:{}};return definition.handler(args,context)}}}var AuthenticationError=AuthenticationError2;var ApiRateLimitError=ApiRateLimitError2;var FetchTimeoutError=FetchTimeoutError2;var TermsAcceptanceRequiredError=TermsAcceptanceRequiredError2;export{ApiRateLimitError,AuthenticationError,FetchTimeoutError,TermsAcceptanceRequiredError,createGetExampleTool2 as createGetExampleTool,toCallableTool};
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@githits/mcp",
3
- "version": "0.16.1",
3
+ "version": "0.16.2",
4
4
  "description": "Reusable MCP server APIs and tools for GitHits",
5
5
  "type": "module",
6
6
  "files": [