githits 0.15.1 → 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.
package/server.json CHANGED
@@ -16,7 +16,7 @@
16
16
  "source": "github",
17
17
  "id": "1165453165"
18
18
  },
19
- "version": "0.15.1",
19
+ "version": "0.16.0",
20
20
  "remotes": [
21
21
  {
22
22
  "type": "streamable-http",
@@ -28,7 +28,7 @@
28
28
  "registryType": "npm",
29
29
  "registryBaseUrl": "https://registry.npmjs.org",
30
30
  "identifier": "githits",
31
- "version": "0.15.1",
31
+ "version": "0.16.0",
32
32
  "runtimeHint": "npx",
33
33
  "transport": {
34
34
  "type": "stdio"
@@ -68,7 +68,6 @@ githits docs read <docsReadTarget> --lines 20-120
68
68
  - 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.
69
69
  - 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.
70
70
  - If a code-navigation command returns `INDEXING`, use the elapsed/expected duration in the message to decide whether to retry with `--wait`; prefer any displayed indexed refs/versions when you need an immediate follow-up.
71
- - After using GitHits results, send feedback when practical. Use `githits feedback <solution_id> --accept|--reject` for `githits example` results, or omit `<solution_id>` for generic session feedback such as `githits feedback --reject --tool search -m "missing kotlin support"`.
72
71
 
73
72
  ## External Content Posture
74
73
 
@@ -17,7 +17,7 @@ recovery.
17
17
 
18
18
  GitHits provides verified open-source examples plus indexed package/repository evidence.
19
19
 
20
- Routing: use `get_example` for canonical cross-project examples; use `search` / `code_*` / `docs_*` / `pkg_*` for a known dependency, repository, stack trace, package adoption question, or upgrade review; use both for comparative OSS questions or when package-scoped evidence needs broader examples. Use `search_language` only to disambiguate a `get_example` language. Use `feedback` after helpful or flawed results.
20
+ Routing: use `get_example` for canonical cross-project examples; use `search` / `code_*` / `docs_*` / `pkg_*` for a known dependency, repository, stack trace, package adoption question, or upgrade review; use both for comparative OSS questions or when package-scoped evidence needs broader examples. Use `search_language` only to disambiguate a `get_example` language.
21
21
 
22
22
  Output format: use default `text` for reading and tool follow-ups. Pass returned paths, IDs, and line ranges directly to the next tool. Use `json` only to parse responses in code or obtain required fields absent from text.
23
23
 
@@ -84,7 +84,6 @@ Follow the CLI JSON `instructions` remediation for these states rather than repl
84
84
  Tell the user:
85
85
 
86
86
  - GitHits queries and public package, repository, and documentation targets are sent to GitHits services for processing.
87
- - Feedback submission is an outbound write that sends feedback data to GitHits services.
88
87
  - Installing GitHits does not itself upload the local workspace.
89
88
  - After installation, open a new coding-agent session so it loads MCP configuration and any supporting instructions. The terminal and machine do not need to be restarted.
90
89
 
@@ -166,21 +165,9 @@ With `--no-browser`, surface the printed sign-in URL clearly so the user can ope
166
165
 
167
166
  7. Verify setup after login and installation.
168
167
 
169
- Project-level verification:
168
+ Follow the CLI-emitted verification instruction for the selected setup scope, preserving `--project` and `--no-guidance` when applicable. Confirm selected tools are `already_configured` for that scope. For local CLI/stdio integrations, confirm local authentication is active using the auth-status command above. Skip local CLI authentication checks for Cursor-only setup; use the Cursor verification below. For mixed setups, verify each authentication path separately.
170
169
 
171
- ```bash
172
- npx -y githits@latest auth status
173
- npx -y githits@latest init --project --detect-agents --json
174
- ```
175
-
176
- User-level verification:
177
-
178
- ```bash
179
- npx -y githits@latest auth status
180
- npx -y githits@latest init --detect-agents --json
181
- ```
182
-
183
- Confirm auth is active and selected tools are `already_configured` for the selected scope. If MCP configuration or supporting guidance changed, tell the user to open a new coding-agent session in the project or user environment so the tool reloads its MCP configuration and any supporting instructions. The terminal and machine do not need to be restarted.
170
+ If MCP configuration or supporting guidance changed, tell the user to open a new coding-agent session in the project or user environment so the tool reloads its MCP configuration and any supporting instructions. The terminal and machine do not need to be restarted.
184
171
 
185
172
  For Cursor, `already_configured` verifies only that the remote URL is present. It does not verify Cursor-managed OAuth or tool discovery. Do not report Cursor as ready based on `githits auth status` or init detection alone.
186
173
 
@@ -8,7 +8,7 @@ If you cannot run shell commands, explain that you cannot complete setup directl
8
8
 
9
9
  ## npx Unavailable
10
10
 
11
- `npx -y githits@latest` requires Node/npm tooling. If `npx` is unavailable, try an already installed `githits` binary. Otherwise explain that Node/npm or the GitHits CLI is required before agent-driven setup can continue.
11
+ `npx -y githits@latest` requires Node/npm tooling. If `npx` is unavailable, explain that Node/npm is required before normal onboarding can continue. Do not fall back to a globally installed CLI. Use a local or pinned command only when the user explicitly requested that testing mode, preserving their command and environment.
12
12
 
13
13
  ## No Supported Tools Detected
14
14
 
@@ -48,11 +48,8 @@ For `init --install-agents <ids> --json`, inspect `outcomes`. Report each failed
48
48
 
49
49
  ## Verification Fails
50
50
 
51
- After setup, run:
51
+ Follow the CLI-emitted verification instruction for the selected setup scope. Preserve `--project` for project setup and `--no-guidance` when guidance was declined; do not substitute a user-level detection command. Report the specific mismatch if selected tools are not `already_configured`.
52
52
 
53
- ```bash
54
- npx -y githits@latest auth status
55
- npx -y githits@latest init --detect-agents --json
56
- ```
53
+ For local CLI/stdio integrations, check `npx -y githits@latest auth status` (or the user-requested local/pinned command). For Cursor, follow the main skill's Cursor verification flow: local CLI authentication and `already_configured` do not establish Cursor readiness. Skip local CLI authentication for Cursor-only setup; verify Cursor-managed OAuth and tool discovery in a new Cursor Agent chat, using `cursor-agent` when available. For mixed setups, verify each authentication path separately.
57
54
 
58
- If auth is active but selected tools are not `already_configured`, report the specific mismatch and failed tool state. If tools are configured, tell the user to open a new agent session so MCP config changes are loaded.
55
+ After MCP configuration or supporting guidance changes, tell the user to open a new coding-agent session. The terminal and machine do not need to be restarted.