githits 0.10.2 → 0.11.1

package/.claude-plugin/marketplace.json

@@ -6,12 +6,12 @@
   },
   "metadata": {
     "description": "The code context layer for AI coding agents",
-    "version": "0.10.2"
+    "version": "0.11.1"
   },
   "plugins": [
     {
       "name": "githits",
-      "version": "0.10.2",
+      "version": "0.11.1",
       "description": "The code context layer for AI coding agents",
       "author": {
         "name": "GitHits"

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "githits",
-  "version": "0.10.2",
+  "version": "0.11.1",
   "description": "The code context layer for AI coding agents",
   "author": {
     "name": "GitHits"

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "githits",
-  "version": "0.10.2",
+  "version": "0.11.1",
   "description": "The code context layer for AI coding agents",
   "author": {
     "name": "GitHits"

package/.cursor-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "githits",
-  "version": "0.10.2",
+  "version": "0.11.1",
   "description": "The code context layer for AI coding agents",
   "author": {
     "name": "GitHits"

package/.plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "githits",
-  "version": "0.10.2",
+  "version": "0.11.1",
   "description": "The code context layer for AI coding agents",
   "author": {
     "name": "GitHits"

package/AGENTS.md

@@ -27,6 +27,7 @@ Philosophy: "Create architecture that is performant and easy to test"
 - Use dependency injection for external services (REST client, etc.)
 - 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.
 - 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.
+- For MCP tool discovery, treat the tool name plus the first 80 description characters as a standalone selection surface. A verified Claude Desktop connector session exposed only that context during unguided tool selection; connector descriptions and MCP server instructions did not reach it. Lead with the natural user question and the tool's distinct job, treat 80 characters as a ceiling rather than a target, and keep registry counts/lists, argument mechanics, and follow-up routing after that boundary. Do not rely on neighboring tools for context. Add first-80 contract tests and run descriptor-only agent evals for description changes.
 - 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.
 
 See `docs/guidelines/ARCHITECTURAL_GUIDELINES.md` for detailed planning checklist and design principles.
@@ -109,12 +110,12 @@ See `docs/guidelines/TESTING.md` for comprehensive patterns.
 
 ## Workspace Boundaries
 
-- Root `src/**` is still the published `githits` CLI implementation until the CLI package move completes. It owns Commander commands, local auth storage, browser login, init/setup flows, local stdio MCP startup, and plugin/assistant packaging assets.
-- `packages/core-internal` is private source. It owns transport-neutral service clients, service interfaces, shared request/header/telemetry primitives, neutral service errors, PKCE helpers, and `TokenProvider`. Never publish or leak `@githits/core-internal` into public artifacts.
-- `packages/mcp` is the public `@githits/mcp` package. Its public tool/server API is `packages/mcp/src/index.ts`: transport-neutral MCP server creation, tool registration, descriptors, instructions, request-scoped service provider types, and MCP service types. Its public runtime/client API is `packages/mcp/src/client.ts`, exported as `@githits/mcp/client`, for remote MCP servers that need concrete service implementations and token/header/config helpers.
+- Root `src/**` is still the published `githits` CLI implementation until the CLI package move completes. It owns Commander commands, local auth storage, browser login, init/setup flows, local stdio MCP startup, plugin/assistant packaging assets, and the diagnostics implementation/lifecycle (environment, process, and output destinations).
+- `packages/core-internal` is private source. It owns transport-neutral service clients, service interfaces, shared request/header primitives, the host-supplied `ServiceDiagnostics` contract, neutral service errors, PKCE helpers, and `TokenProvider`. It must not discover diagnostics environment settings or own diagnostics process/output destinations. Never publish or leak `@githits/core-internal` into public artifacts.
+- `packages/mcp` is the public `@githits/mcp` package. Its public tool/server API is `packages/mcp/src/index.ts`: transport-neutral MCP server creation, tool registration, descriptors, instructions, request-scoped service provider types, and MCP service types. Its public runtime/client API is `packages/mcp/src/client.ts`, exported as `@githits/mcp/client`, for remote MCP servers that need concrete service implementations, token/header/config helpers, and optional injected `ServiceDiagnostics`.
 - `@githits/mcp/smoke-test` is a public validation helper entrypoint for remote MCP servers. It exports smoke assertions and `runMcpSmoke()` without depending on local CLI startup.
 - `@githits/mcp/internal` is a workspace-only alias for root CLI transition helpers. External packages and the future remote MCP server repo must never import it. If remote server work needs something internal, promote the smallest stable API through `@githits/mcp` instead.
-- Public package artifacts for both root `githits` and `@githits/mcp` must not contain `@githits/core-internal`, `workspace:*`, `@githits/mcp/internal`, or private source aliases in JS, declarations, or manifests.
+- Public package artifacts for both root `githits` and `@githits/mcp` must not contain `@githits/core-internal`, `workspace:*`, `@githits/mcp/internal`, or private source aliases in JS, declarations, or manifests. The public-package validator also rejects static `fs`, `node:fs`, `fs/promises`, and `node:fs/promises` imports in core source and packed MCP artifacts, and rejects direct core `process.stderr`/`process.stdout` access. These checks cover statically resolved string-literal module edges; they do not claim browser compatibility.
 
 ## Release Boundaries
 

package/README.md

@@ -70,6 +70,7 @@ broader open-source ecosystem, not just model memory or local repo context:
 
 | Capability | MCP tools | CLI commands |
 |---|---|---|
+| Tool orientation | `quick_start` | — |
 | Code examples | `get_example`, `search_language` | `githits example`, `githits languages` |
 | Code navigation | `search`, `search_status`, `code_files`, `code_read`, `code_grep` | `githits search`, `githits search-status`, `githits code ...` |
 | Documentation access | `docs_list`, `docs_read` | `githits docs ...` |
@@ -294,11 +295,13 @@ is required.
 To remove configuration written by `init`:
 
 ```sh
-npx githits@latest init uninstall
+npx githits@latest uninstall
 ```
 
-This removes GitHits MCP configuration and preserves stored credentials. Run
-`npx githits@latest logout` separately to remove credentials.
+This removes GitHits MCP configuration and guidance written by `init`, while
+preserving stored credentials. Run `npx githits@latest logout` separately to
+remove credentials. The compatibility form `npx githits@latest init uninstall`
+accepts the same `--yes`, `--project`, and `--keep-guidance` options.
 
 ## Project Setup
 
@@ -317,7 +320,7 @@ Agent-safe non-interactive setup uses staged discovery and explicit install:
 
 ```sh
 npx githits@latest init --detect-agents --json
-npx githits@latest init --install-agents cursor,codex
+npx githits@latest init --install-agents cursor,codex-cli
 ```
 
 ## Plugin and Extension Packaging
@@ -349,6 +352,14 @@ Antigravity plugin through `plugin.json`, `mcp_config.json`, and the shared
 `skills/` tree. Generated manifests are refreshed with `bun run plugins:generate`
 and validated with `bun run plugins:check`.
 
+Guided `init` installs the four canonical skills (`githits-code`, `githits-mcp`,
+`githits-onboarding`, and `githits-package`) only for selected agents. Shared
+skill-capable agents use `~/.agents/skills/` at user scope or `.agents/skills/`
+at project scope; native-only agents use their verified native skill directory.
+Compatible agents reading a shared root can discover those skills. A later
+guided run repairs missing skills, and migration removes only the historical
+Cline or Junie `githits-mcp/SKILL.md` after the complete shared set is verified.
+
 For Claude Code marketplace installs:
 
 ```sh
@@ -366,7 +377,8 @@ gemini extensions install https://github.com/githits-com/githits-cli
 
 ```text
 githits init             Connect GitHits to your coding agents
-githits init uninstall   Remove GitHits MCP configuration
+githits uninstall        Remove GitHits MCP configuration and guidance
+githits init uninstall   Compatibility alias for `githits uninstall`
 githits login            Sign in to your GitHits account
 githits logout           Remove stored credentials
 githits mcp              Show setup instructions or start the local MCP server