githits 0.4.4 → 0.4.6

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.
@@ -6,7 +6,7 @@
6
6
  },
7
7
  "metadata": {
8
8
  "description": "GitHits plugins for Claude Code - code examples from global open source",
9
- "version": "0.4.4"
9
+ "version": "0.4.6"
10
10
  },
11
11
  "plugins": [
12
12
  {
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "githits",
3
- "version": "0.4.4",
3
+ "version": "0.4.6",
4
4
  "description": "Code examples from global open source for developers and AI assistants",
5
5
  "author": {
6
6
  "name": "GitHits"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "githits",
3
- "version": "0.4.4",
3
+ "version": "0.4.6",
4
4
  "description": "Code examples from global open source for developers and AI assistants",
5
5
  "author": {
6
6
  "name": "GitHits"
package/GEMINI.md CHANGED
@@ -24,13 +24,14 @@ Look up supported programming language names. Use this before calling `get_examp
24
24
 
25
25
  ### feedback
26
26
 
27
- Rate a search result. Submit feedback after each search to improve future result quality.
27
+ Submit feedback on a search result, a GitHits tool result, or the current GitHits session. Use it when a result was useful or when a tool/UX issue should be recorded.
28
28
 
29
29
  **Parameters:**
30
30
 
31
- - `solution_id` (string, required) - the ID of the search result
31
+ - `solution_id` (string, optional) - ID from a `get_example` result; omit for generic session feedback
32
32
  - `accepted` (boolean, required) - whether the result was useful
33
33
  - `feedback_text` (string, optional) - additional context about why the result was or was not helpful
34
+ - `tool_name` (string, optional) - GitHits tool or command being rated for generic feedback
34
35
 
35
36
  ## When to Use
36
37
 
@@ -64,13 +65,14 @@ Do not use `get_example` for:
64
65
  - Formulate queries as natural language questions (e.g., "How to stream responses with the Vercel AI SDK in Next.js")
65
66
  - Include specific error messages, library names, or API names when relevant
66
67
  - Keep queries focused: 3-4 technical terms maximum
67
- - Submit `feedback` after every search result you use or discard
68
+ - Submit `feedback` after GitHits results you use or discard; omit `solution_id` for generic tool/session feedback
68
69
 
69
70
  ## Indexed Package/Source Tools
70
71
 
71
72
  GitHits also exposes indexed dependency/package tools such as `search`,
72
73
  `search_status`, `docs_list`, `docs_read`, `pkg_info`, `pkg_vulns`,
73
- `pkg_deps`, `pkg_changelog`, `code_files`, `code_read`, and `code_grep`.
74
+ `pkg_deps`, `pkg_changelog`, `pkg_upgrade_review`, `code_files`,
75
+ `code_read`, and `code_grep`.
74
76
 
75
77
  ## License Filtering
76
78
 
package/README.md CHANGED
@@ -12,7 +12,7 @@ npx githits init
12
12
 
13
13
  `init` authenticates with your [GitHits](https://githits.com) account, then auto-detects your installed coding tools and configures each one with GitHits MCP.
14
14
 
15
- Supported tools: Claude Code, Cursor, Windsurf, VS Code / Copilot, Cline, Claude Desktop, Codex CLI, Gemini CLI, Google Antigravity, and OpenCode.
15
+ Supported tools: Claude Code, Cursor, Windsurf, VS Code / Copilot, Cline, Claude Desktop, Codex CLI, Pi, Gemini CLI, Google Antigravity, and OpenCode.
16
16
 
17
17
  If you are using a tool that is not listed above, use the manual MCP setup instructions near the end of this README.
18
18
 
@@ -94,7 +94,7 @@ Core tools available in every authenticated session:
94
94
  |---|---|
95
95
  | `get_example` | Find canonical code examples by describing what you need in natural language |
96
96
  | `search_language` | Look up supported programming language names |
97
- | `feedback` | Rate search results to improve future quality |
97
+ | `feedback` | Submit result or session feedback to improve future quality |
98
98
 
99
99
  The assistant decides when to call these tools on its own — typically when it's stuck, needs a working example for an unfamiliar API, or encounters an error it can't resolve from its training data alone.
100
100
 
@@ -110,6 +110,7 @@ GitHits also exposes indexed package/source tools:
110
110
  | `pkg_vulns` | CVE / OSV advisories for a package or specific version, with filter echo and compact/verbose modes |
111
111
  | `pkg_deps` | Direct dependencies, dependency groups, and optional transitive graph |
112
112
  | `pkg_changelog` | Release notes / changelog entries for a package or GitHub repo, with compact timeline and body-preview controls |
113
+ | `pkg_upgrade_review` | Evidence for dependency upgrades, including vulnerabilities, changelog entries, deprecation metadata, peer changes, and dependency changes |
113
114
  | `code_files` | Discover what files a dependency or repo contains |
114
115
  | `code_read` | Read a dependency file by path |
115
116
  | `code_grep` | Deterministic text grep across indexed dependency or repo files |
@@ -195,7 +196,7 @@ githits mcp start Always start MCP server (for use in MCP config files)
195
196
  githits auth status Show current authentication status
196
197
  githits example Get canonical code examples from global open source
197
198
  githits languages List or filter supported language names
198
- githits feedback Send feedback on a returned example
199
+ githits feedback Send feedback on a result, command, or session
199
200
  ```
200
201
 
201
202
  These indexed package/source commands are also available:
@@ -203,7 +204,7 @@ These indexed package/source commands are also available:
203
204
  ```
204
205
  githits search ... Unified indexed dependency/repository search
205
206
  githits search-status Follow up a prior indexed search
206
- githits pkg ... Package metadata: overview, advisories, deps, changelog
207
+ githits pkg ... Package metadata: overview, advisories, deps, changelog, upgrade reviews
207
208
  githits docs ... Package documentation: browse pages and read content
208
209
  githits code ... Dependency source inspection: search, files, read, grep
209
210
  ```
@@ -21,4 +21,5 @@ Optional parameters:
21
21
  licenses), or `"custom"` (user's blocklist).
22
22
 
23
23
  Present the results clearly. After the user has reviewed the result, use the
24
- `feedback` tool to report whether the example was helpful.
24
+ `feedback` tool to report whether the example was helpful. Use the returned
25
+ `solution_id` when available.
package/commands/help.md CHANGED
@@ -31,11 +31,12 @@ This plugin connects to the GitHits MCP server and always exposes these core too
31
31
  language. Requires `query`; `language` is optional and inferred when omitted.
32
32
  - **search_language** — Look up supported programming language names when you
33
33
  need to force a specific language.
34
- - **feedback** — Rate a search result to improve future quality.
34
+ - **feedback** — Submit result or session feedback to improve future quality.
35
35
 
36
36
  Additional indexed dependency/package tools are available by default:
37
37
  `search`, `search_status`, `docs_list`, `docs_read`, `pkg_info`, `pkg_vulns`,
38
- `pkg_deps`, `pkg_changelog`, `code_files`, `code_read`, and `code_grep`.
38
+ `pkg_deps`, `pkg_changelog`, `pkg_upgrade_review`, `code_files`,
39
+ `code_read`, and `code_grep`.
39
40
 
40
41
  ## Authentication
41
42
 
@@ -23,4 +23,5 @@ Optional parameters:
23
23
  licenses), or `"custom"` (user's blocklist).
24
24
 
25
25
  Present the results clearly. After the user has reviewed the result, use the
26
- `feedback` tool to report whether the example was helpful.
26
+ `feedback` tool to report whether the result was helpful. Omit `solution_id`
27
+ for generic session feedback about indexed search results.