githits 0.15.0 → 0.16.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.
@@ -6,12 +6,12 @@
6
6
  },
7
7
  "metadata": {
8
8
  "description": "The code context layer for AI coding agents",
9
- "version": "0.15.0"
9
+ "version": "0.16.0"
10
10
  },
11
11
  "plugins": [
12
12
  {
13
13
  "name": "githits",
14
- "version": "0.15.0",
14
+ "version": "0.16.0",
15
15
  "description": "The code context layer for AI coding agents",
16
16
  "author": {
17
17
  "name": "GitHits"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "githits",
3
- "version": "0.15.0",
3
+ "version": "0.16.0",
4
4
  "description": "The code context layer for AI coding agents",
5
5
  "author": {
6
6
  "name": "GitHits"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "githits",
3
- "version": "0.15.0",
3
+ "version": "0.16.0",
4
4
  "description": "The code context layer for AI coding agents",
5
5
  "author": {
6
6
  "name": "GitHits"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "githits",
3
- "version": "0.15.0",
3
+ "version": "0.16.0",
4
4
  "description": "The code context layer for AI coding agents",
5
5
  "author": {
6
6
  "name": "GitHits"
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "githits",
3
- "version": "0.15.0",
3
+ "version": "0.16.0",
4
4
  "description": "The code context layer for AI coding agents",
5
5
  "author": {
6
6
  "name": "GitHits"
package/AGENTS.md CHANGED
@@ -26,6 +26,7 @@ Philosophy: "Create architecture that is performant and easy to test"
26
26
  - Prefer public helper modules to lots of private methods
27
27
  - Use dependency injection for external services (REST client, etc.)
28
28
  - Do not eagerly validate network/proxy/environment configuration while constructing command dependencies when the command has local-only or no-network paths. Defer validation until the first network operation and add regression tests for malformed env values on local paths.
29
+ - GitHits information tools advertise `readOnlyHint: true`, including internal result storage, caching, preparation, and research-thread state. Keep this policy covered by catalog tests; assess any future user-facing write tool separately.
29
30
  - For MCP/agent-facing tools, avoid coupled optional flags and default-true booleans. Design schemas for real agent calls, including empty strings, empty arrays, and explicit `false` values.
30
31
  - For MCP tool discovery, treat the tool name plus the first description sentence as a standalone selection surface. A verified claude.ai deferred-tool catalog rendered at most 80 characters: a sentence longer than 79 characters appeared as its first 79 plus an ellipsis, while connector descriptions and MCP server instructions did not reach selection. Lead with the natural user question and the tool's distinct job, keep that sentence within 79 characters when it must render whole, and avoid internal periods (including abbreviations, version literals, and filenames) because the observed sentence boundary is otherwise ambiguous. Keep registry counts/lists, argument mechanics, and follow-up routing after it. Also keep the first 80 raw description characters useful for clients that expose a raw prefix. Do not rely on neighboring tools for context. Add first-sentence/first-80 contract tests and run descriptor-only agent evals for description changes.
31
32
  - For GraphQL/API-backed tools, treat minimal data fetching as part of the tool contract. Before adding or changing selected fields, compare the query against every consumer (text, verbose, JSON, MCP, CLI, and internal callers), use conditional fields or separate queries for mode-specific data, and add tests that assert the wire variables/selections for compact and detailed modes.
package/README.md CHANGED
@@ -37,6 +37,9 @@ health, compare dependency upgrades, and find source-cited examples from real
37
37
  open-source projects when model knowledge and local repository context are not
38
38
  enough.
39
39
 
40
+ Want to use GitHits as part of your agent harness or software factory? Check out
41
+ our [public API documentation](https://docs.githits.com/api/overview).
42
+
40
43
  ## Quick Start
41
44
 
42
45
  ```sh
@@ -74,7 +77,6 @@ broader open-source ecosystem, not just model memory or local repo context:
74
77
  | Code navigation | `search`, `search_status`, `code_files`, `code_read`, `code_grep` | `githits search`, `githits search-status`, `githits code ...` |
75
78
  | Documentation access | `docs_list`, `docs_read` | `githits docs ...` |
76
79
  | Package inspection | `pkg_info`, `pkg_vulns`, `pkg_deps`, `pkg_changelog`, `pkg_upgrade_review` | `githits pkg ...` |
77
- | Feedback | `feedback` | `githits feedback` |
78
80
 
79
81
  Use GitHits when your agent needs to:
80
82
 
@@ -150,7 +152,7 @@ tools = true
150
152
  ```
151
153
 
152
154
  See [Experimental tools](docs/experimental-tools.md) for platform-specific
153
- config discovery, CLI examples, optional issue reporting, limitations, and how
155
+ config discovery, CLI examples, limitations, and how
154
156
  to disable the tools.
155
157
 
156
158
  ## Supported Sources
@@ -385,7 +387,6 @@ githits mcp Show setup instructions or start the local MCP server
385
387
  githits mcp start Always start the local MCP server over stdio
386
388
  githits example Find real-world implementations from open source
387
389
  githits languages List or filter supported programming languages
388
- githits feedback Submit feedback about GitHits results
389
390
  githits doctor Diagnose configuration and auth state
390
391
  githits resolve Experimental: resolve a fuzzy name to canonical targets
391
392
  githits settings View and update preferences, privacy, and terms