githits 0.16.2 → 0.17.1

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "githits",
   "description": "The code context layer for AI coding agents",
-  "version": "0.16.2",
+  "version": "0.17.1",
   "mcpName": "com.githits/githits",
   "type": "module",
   "workspaces": [

package/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
   "name": "githits",
-  "version": "0.16.2",
+  "version": "0.17.1",
   "description": "The code context layer for AI coding agents",
   "author": {
     "name": "GitHits"

package/server.json

@@ -16,7 +16,7 @@
     "source": "github",
     "id": "1165453165"
   },
-  "version": "0.16.2",
+  "version": "0.17.1",
   "remotes": [
     {
       "type": "streamable-http",
@@ -28,7 +28,7 @@
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "githits",
-      "version": "0.16.2",
+      "version": "0.17.1",
       "runtimeHint": "npx",
       "transport": {
         "type": "stdio"

package/skills/githits-code/SKILL.md

@@ -62,7 +62,7 @@ githits docs read <docsReadTarget>
 - For multi-step code/docs investigations, keep raw CLI output out of the final answer unless it is the evidence the user needs.
 - If output says it used recent, stale, or provisional indexed evidence, treat the displayed served target as provenance. Provisional evidence is queryable while visibly still indexing. If freshness matters, follow the rendered continuation, retry with a longer `--wait`, use one of the displayed `queryable now` versions/refs, or inspect JSON `targetResolution` for structured candidates.
 - Partial and capped documentation coverage are usable published evidence. Report the disclosed limit, but infer neither indexing progress nor retryability from coverage; follow only `searchRef` and the evidence notice.
-- If search returns a `searchRef`, continue with `githits search-status <searchRef>` only when the output explicitly supplies that follow-up, including for active `PENDING`, `INDEXING`, or `SEARCHING` progress or a completed result with an evidence notice. Its bounded wait defaults to 20 seconds; use `--wait <seconds>` with an integer from 0 to 60 to adjust it. For terminal `DEFERRED`, `TIMEOUT`, or `FAILED` progress, or an unrecognized status, preserve any disclosed evidence, do not poll the reference again, and follow the rendered new-search action.
+- If search returns a `searchRef`, continue with `githits search-status <searchRef>` only when the output explicitly supplies that follow-up, including for active `PENDING`, `INDEXING`, or `SEARCHING` progress or a completed result with an evidence notice. Use the wait in the rendered continuation; `--wait <seconds>` accepts an integer, and `githits search-status --help` gives the installed version's default and limit. For terminal `DEFERRED`, `TIMEOUT`, or `FAILED` progress, or an unrecognized status, preserve any disclosed evidence, do not poll the reference again, and follow the rendered new-search action.
 - If discovery search returns no useful hits, do not repeat it unchanged. Follow the rendered pivots; when the query is now an exact identifier or string, switch to `githits code grep` and read the focused match because symbol discovery may not include re-exports or generated aliases.
 - If grep returns no matches, do not repeat it unchanged. Follow the returned guidance by changing the pattern, broadening the file scope, or switching to `githits search` for conceptual discovery.
 - For a missing or ambiguous standalone site, use the returned `suggestedSiteTargets` in order. Do not rewrite the original target or retry automatically; when `suggestedSiteTargetsTruncated` is true, state that additional candidates were omitted.

package/skills/githits-code/references/code-and-docs.md

@@ -12,7 +12,7 @@ Useful filters: `--kind`, `--category`, `--path-prefix`, `--intent`, `--public`,
 
 `--path-prefix` filters code results only. Omit it for `--source docs`, `--source symbol`, and standalone site searches. Use it with `--source code` on a package/repository, or with automatic source selection that includes a package/repository.
 
-If search returns a `searchRef`, continue with `githits search-status <searchRef> [--wait <seconds>]` only when the output explicitly supplies that follow-up, including for active `PENDING`, `INDEXING`, or `SEARCHING` progress or a completed result with an evidence notice. The bounded wait defaults to 20 seconds, and the explicit value must be an integer from 0 to 60. Terminal `DEFERRED`, `TIMEOUT`, or `FAILED` progress, and unrecognized statuses, do not advance: keep any disclosed evidence, do not poll the same reference, and follow the rendered new-search action.
+If search returns a `searchRef`, continue with `githits search-status <searchRef> [--wait <seconds>]` only when the output explicitly supplies that follow-up, including for active `PENDING`, `INDEXING`, or `SEARCHING` progress or a completed result with an evidence notice. Use the wait in the rendered continuation; `--wait <seconds>` accepts an integer, and `githits search-status --help` gives the installed version's default and limit. Terminal `DEFERRED`, `TIMEOUT`, or `FAILED` progress, and unrecognized statuses, do not advance: keep any disclosed evidence, do not poll the same reference, and follow the rendered new-search action.
 
 Stale or provisional evidence remains queryable while refresh or indexing
 continues. Treat the displayed served target as exact provenance and follow a

package/skills/githits-mcp/SKILL.md

@@ -22,9 +22,8 @@ the routing decision; the selected tool supplies its argument details.
 | Find a known literal or regex in a public repository/package | `code_grep` |
 | Find relevant source, symbols, tests, or documentation for a topic | `search` |
 | List paths or browse a source directory | `code_files` |
-| Read a known exact source file or matched lines | `code_read` |
+| Read a source file, documentation page, or focused section | `read` |
 | Browse package documentation pages | `docs_list` |
-| Read a documentation page returned by search or docs_list | `docs_read` |
 | Assess a package's license, adoption, maintenance, or overall health | `pkg_info` |
 | Inspect vulnerabilities in a package or version | `pkg_vulns` |
 | Inspect direct dependencies or transitive footprint | `pkg_deps` |
@@ -47,13 +46,14 @@ target forms and argument details.
 For a package or site docs topic, use `search` with `source:"docs"`.
 `docs_list` browses package pages, not standalone `site:` targets.
 Use a docs hit's snippet when sufficient; otherwise follow its generated
-`followUp`. From text, pass a `[docs page]` target unchanged to `docs_read`.
+`followUp`. From text, pass a `[docs page]` target unchanged to `read`.
 A fragment needs no bounds and returns the exact section; add bounds only to
 replace it with a page-relative range. Historical `pageId` works.
-For source evidence, locate paths or matches before reading; never use
-`code_read` to list/probe directories.
+For source evidence, locate paths or matches before reading; pass the source
+target and returned path to `read`; never use `read` to list/probe directories.
 
 Tools with `wait_timeout_ms` wait for indexing or results before returning.
+For `read`, the wait applies only to code indexing.
 Omit it for the default; use `0` to return without waiting. If work remains,
 follow the suggested continuation or recovery action. When a target is still
 indexing, use the indexing estimate, if shown, to choose a longer wait, or retry