githits 0.6.1 → 0.6.3

package/dist/shared/{chunk-2zmt1crj.js → chunk-k768ws3z.js}

@@ -1 +1 @@
-import{clearAutoLoginAuthSessionMetadata,createAuthCommandDependencies,createAuthStatusDependencies,createContainer,loadAutoLoginAuthSessionMetadata,recordAuthFingerprint}from"./chunk-k13k7548.js";import"./chunk-f9yyzxrw.js";export{recordAuthFingerprint,loadAutoLoginAuthSessionMetadata,createContainer,createAuthStatusDependencies,createAuthCommandDependencies,clearAutoLoginAuthSessionMetadata};
+import{clearAutoLoginAuthSessionMetadata,createAuthCommandDependencies,createAuthStatusDependencies,createContainer,loadAutoLoginAuthSessionMetadata,recordAuthFingerprint}from"./chunk-d5rp3ryj.js";import"./chunk-nftysk9t.js";export{recordAuthFingerprint,loadAutoLoginAuthSessionMetadata,createContainer,createAuthStatusDependencies,createAuthCommandDependencies,clearAutoLoginAuthSessionMetadata};

package/dist/shared/chunk-nftysk9t.js

@@ -0,0 +1,2 @@
+import{createRequire}from"node:module";var __require=createRequire(import.meta.url);var description="The code context layer for AI coding agents";var version="0.6.3";
+export{__require,description,version};

package/gemini-extension.json

@@ -1,7 +1,7 @@
 {
   "name": "githits",
-  "version": "0.6.1",
-  "description": "Code examples from global open source for developers and AI assistants.",
+  "version": "0.6.3",
+  "description": "The code context layer for AI coding agents",
   "mcpServers": {
     "githits": {
       "command": "npx",

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "githits",
-  "description": "Version-aware open-source context for agentic software development",
-  "version": "0.6.1",
+  "description": "The code context layer for AI coding agents",
+  "version": "0.6.3",
+  "mcpName": "com.githits/githits",
   "type": "module",
   "workspaces": [
     "packages/*"
@@ -12,6 +13,7 @@
     ".plugin",
     ".claude-plugin",
     ".mcp.json",
+    "server.json",
     "gemini-extension.json",
     "GEMINI.md",
     "plugins",
@@ -38,6 +40,7 @@
     "inspector": "npx @modelcontextprotocol/inspector bun run dev mcp",
     "smoke:cli": "bun run scripts/cli-smoke.ts",
     "smoke:mcp": "bun run scripts/mcp-smoke.ts",
+    "smoke:proxy-node": "bun run scripts/run-proxy-node-smoke.ts",
     "validate:packages": "bun run scripts/validate-public-packages.ts",
     "validate:packages:mcp-publish": "bun run scripts/validate-public-packages.ts --mcp-publish-dry-run",
     "sync:claude-skills": "bun run scripts/sync-claude-skill-assets.ts",
@@ -77,7 +80,7 @@
     "url": "https://github.com/githits-com/githits-cli/issues"
   },
   "engines": {
-    "node": "^20.12.0 || >=22.13.0"
+    "node": "^20.18.1 || >=22.13.0"
   },
   "publishConfig": {
     "access": "public"
@@ -94,6 +97,7 @@
     "open": "^11.0.0",
     "semver": "7.8.5",
     "smol-toml": "^1.6.1",
+    "undici": "7.28.0",
     "yaml": "^2.9.0",
     "zod": "^4.4.3"
   },

package/plugins/claude/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "githits",
-  "version": "0.6.1",
-  "description": "Code examples from global open source for developers and AI assistants",
+  "version": "0.6.3",
+  "description": "The code context layer for AI coding agents",
   "author": {
     "name": "GitHits"
   },

package/plugins/claude/skills/githits-mcp/SKILL.md

@@ -1,13 +1,19 @@
 ---
 name: githits-mcp
-description: Use GitHits MCP as the default OSS context layer when a task involves open-source packages, frameworks, SDKs, libraries, CLI tools, package docs, repository source, examples, planning, research, vulnerabilities, changelogs, dependency graphs, or upgrade-review evidence. Trigger before relying on model memory or generic web search for OSS context.
+description: Use GitHits MCP as an OSS context layer when a task involves open-source packages, frameworks, SDKs, libraries, developer tools, package docs, repository source, examples, planning, research, vulnerabilities, changelogs, dependency graphs, or upgrade-review evidence. Prefer it before relying on model memory or generic web search for public OSS context.
 ---
 
 # GitHits MCP
 
-Use GitHits MCP for OSS context across the full software development lifecycle: discovery, planning, research, implementation, debugging, and maintenance. GitHits covers package docs, indexed package and repository source, cross-project examples, dependency metadata, vulnerabilities, changelogs, and upgrade-review evidence.
+Use GitHits MCP when public OSS/package evidence would materially improve discovery, planning, research, implementation, debugging, or maintenance. GitHits covers package docs, indexed package and repository source, cross-project examples, dependency metadata, vulnerabilities, changelogs, and upgrade-review evidence.
 
-Prefer GitHits when the user asks about behavior, APIs, configuration, migration, planning, research, debugging, or implementation patterns for open-source libraries, frameworks, SDKs, CLIs, packages, or repositories.
+Prefer GitHits for external OSS/package questions about behavior, APIs, configuration, migration, planning, research, debugging, or implementation patterns for open-source libraries, frameworks, SDKs, developer tools, packages, or repositories.
+
+Scope boundaries:
+
+- GitHits indexes and searches public OSS repositories, package registry artifacts, and public package documentation. It does not index the user's local workspace, private repositories, uncommitted changes, or proprietary code unless that code is also available as public OSS/package evidence.
+- When the user references a public GitHub repository, GitHub file URL, package docs, or OSS registry package, prefer GitHits by translating the reference into a GitHits repository or package target. Use generic web search when GitHits lacks the content or the target is not available through GitHits.
+- If a public target is not indexed yet, wait for GitHits indexing to finish or retry with the provided indexing guidance. Do not fall back to generic web search just because indexing is still in progress.
 
 Use the most targeted GitHits MCP tool or combination of tools for the job:
 

package/plugins/claude/skills/onboarding/SKILL.md

@@ -94,13 +94,15 @@ If not authenticated or expired, ask before launching browser login, then run:
 npx -y githits@latest login
 ```
 
+Normal login opens the browser when possible and also prints a fallback sign-in URL. If command output is hidden from the user, relay the URL verbatim.
+
 Use this only when browser launch fails or the environment is headless:
 
 ```bash
 npx -y githits@latest login --no-browser
 ```
 
-With `--no-browser`, ask the user to open the printed URL. Do not ask them to paste secrets or OAuth codes back into chat.
+With `--no-browser`, surface the printed sign-in URL clearly so the user can open it in a browser. If command output is hidden from the user, relay the URL verbatim. Do not ask them to paste secrets or OAuth codes back into chat.
 
 6. Verify with the selected scope.
 

package/server.json

@@ -0,0 +1,85 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "com.githits/githits",
+  "title": "GitHits",
+  "description": "Search public open-source code, documentation, metadata, vulnerabilities, changelogs, and examples.",
+  "websiteUrl": "https://githits.com",
+  "icons": [
+    {
+      "src": "https://githits.com/assets/brand/logos/GH-Favicon-Gradient_512x512.png",
+      "mimeType": "image/png",
+      "sizes": ["512x512"]
+    }
+  ],
+  "repository": {
+    "url": "https://github.com/githits-com/githits-cli",
+    "source": "github",
+    "id": "1165453165"
+  },
+  "version": "0.6.3",
+  "remotes": [
+    {
+      "type": "streamable-http",
+      "url": "https://mcp.githits.com"
+    }
+  ],
+  "packages": [
+    {
+      "registryType": "npm",
+      "registryBaseUrl": "https://registry.npmjs.org",
+      "identifier": "githits",
+      "version": "0.6.3",
+      "runtimeHint": "npx",
+      "transport": {
+        "type": "stdio"
+      },
+      "packageArguments": [
+        {
+          "type": "positional",
+          "value": "mcp"
+        },
+        {
+          "type": "positional",
+          "value": "start"
+        }
+      ]
+    }
+  ],
+  "_meta": {
+    "io.modelcontextprotocol.registry/publisher-provided": {
+      "keywords": [
+        "githits",
+        "public open-source",
+        "open-source code",
+        "package documentation",
+        "package metadata",
+        "vulnerabilities",
+        "changelogs",
+        "dependency graphs",
+        "upgrade evidence",
+        "implementation examples"
+      ],
+      "categories": [
+        "code-examples",
+        "code-navigation",
+        "code-search",
+        "documentation-search",
+        "package-inspection"
+      ],
+      "workflows": [
+        "planning",
+        "research",
+        "implementation",
+        "debugging",
+        "dependency review",
+        "maintenance"
+      ],
+      "useCases": [
+        "Find prior art and implementation patterns from public open-source repositories, issues, discussions, and pull requests",
+        "Search indexed packages and repositories, grep source, list files, and read exact lines without cloning",
+        "Search hosted and repo-backed package documentation, then read targeted pages and line ranges",
+        "Inspect package metadata, vulnerabilities, dependency graphs, changelogs, upgrade evidence, and package documentation"
+      ]
+    }
+  }
+}

package/skills/githits-mcp/SKILL.md

@@ -1,13 +1,19 @@
 ---
 name: githits-mcp
-description: Use GitHits MCP as the default OSS context layer when a task involves open-source packages, frameworks, SDKs, libraries, CLI tools, package docs, repository source, examples, planning, research, vulnerabilities, changelogs, dependency graphs, or upgrade-review evidence. Trigger before relying on model memory or generic web search for OSS context.
+description: Use GitHits MCP as an OSS context layer when a task involves open-source packages, frameworks, SDKs, libraries, developer tools, package docs, repository source, examples, planning, research, vulnerabilities, changelogs, dependency graphs, or upgrade-review evidence. Prefer it before relying on model memory or generic web search for public OSS context.
 ---
 
 # GitHits MCP
 
-Use GitHits MCP for OSS context across the full software development lifecycle: discovery, planning, research, implementation, debugging, and maintenance. GitHits covers package docs, indexed package and repository source, cross-project examples, dependency metadata, vulnerabilities, changelogs, and upgrade-review evidence.
+Use GitHits MCP when public OSS/package evidence would materially improve discovery, planning, research, implementation, debugging, or maintenance. GitHits covers package docs, indexed package and repository source, cross-project examples, dependency metadata, vulnerabilities, changelogs, and upgrade-review evidence.
 
-Prefer GitHits when the user asks about behavior, APIs, configuration, migration, planning, research, debugging, or implementation patterns for open-source libraries, frameworks, SDKs, CLIs, packages, or repositories.
+Prefer GitHits for external OSS/package questions about behavior, APIs, configuration, migration, planning, research, debugging, or implementation patterns for open-source libraries, frameworks, SDKs, developer tools, packages, or repositories.
+
+Scope boundaries:
+
+- GitHits indexes and searches public OSS repositories, package registry artifacts, and public package documentation. It does not index the user's local workspace, private repositories, uncommitted changes, or proprietary code unless that code is also available as public OSS/package evidence.
+- When the user references a public GitHub repository, GitHub file URL, package docs, or OSS registry package, prefer GitHits by translating the reference into a GitHits repository or package target. Use generic web search when GitHits lacks the content or the target is not available through GitHits.
+- If a public target is not indexed yet, wait for GitHits indexing to finish or retry with the provided indexing guidance. Do not fall back to generic web search just because indexing is still in progress.
 
 Use the most targeted GitHits MCP tool or combination of tools for the job:
 

package/skills/githits-onboarding/SKILL.md

@@ -124,13 +124,15 @@ Then run:
 npx -y githits@latest login
 ```
 
+Normal login opens the browser when possible and also prints a fallback sign-in URL. If command output is hidden from the user, relay the URL verbatim.
+
 If the browser cannot open automatically, or the session appears to be SSH/container/headless, use:
 
 ```bash
 npx -y githits@latest login --no-browser
 ```
 
-With `--no-browser`, ask the user to open the printed URL. Do not ask them to paste passwords, tokens, cookies, or OAuth codes back into chat.
+With `--no-browser`, surface the printed sign-in URL clearly so the user can open it in a browser. If command output is hidden from the user, relay the URL verbatim. Do not ask them to paste passwords, tokens, cookies, or OAuth codes back into chat.
 
 6. Verify setup after login and installation.
 

package/skills/githits-onboarding/references/troubleshooting.md

@@ -22,7 +22,7 @@ Retry login with:
 npx -y githits@latest login --no-browser
 ```
 
-Ask the user to open the printed URL. Do not ask them to paste passwords, tokens, cookies, or OAuth codes into chat.
+Surface the printed sign-in URL clearly so the user can open it in a browser. If command output is hidden from the user, relay the URL verbatim. Do not ask them to paste passwords, tokens, cookies, or OAuth codes into chat.
 
 ## Authentication Timeout
 

package/dist/shared/chunk-f9yyzxrw.js

@@ -1,2 +0,0 @@
-import{createRequire}from"node:module";var __require=createRequire(import.meta.url);var version="0.6.1";
-export{__require,version};