kith-coord 0.1.1 → 0.1.3

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 0.1.3 — 2026-10-22
+
+- Repair automatic client setup: merge existing settings, preserve custom transports, keep private original-byte backups and refuse malformed or redirected configuration before client writes. Register Claude Code in its user MCP configuration and use the installed Node/CLI paths. Global clients select repositories per task; project configurations retain their pinned checkout. Existing hooks, permissions and session ownership stay intact.
+- Canonicalize Windows short home paths before containment checks; allow a bounded cold-start window for Windows process inspection and report probe failures while retaining fail-closed ownership. Keep the MCP renewal test running past its initial expiry with allowance for OS inspection overhead.
+- Add optional per-call `repository` routing (protocol 1.2) for one global MCP connection across projects. Desktop startup at `/` or HOME connects without creating a project database; missing project context returns a tool error. Keep capabilities and command cleanup scoped to each repository, retain pinned `--repo` connections, and refuse filesystem-root coordination. Global setup from HOME writes private configuration backups without initializing a project database.
+- Make the optional read-only watcher compare full paths across linked worktrees of the same Git repository, including common hotspot files. Discover retained/hidden linked worktrees, exclude byte-identical dirty copies, clear resolved alerts, retain unavailable scan health and handle NUL-delimited filenames. Remove speculative cross-repository contract and agent-attribution heuristics.
+- Bound menu-bar subprocess polling, drain stdout/stderr concurrently and show unavailable scans without a clean verdict. Include a universal Intel/Apple Silicon macOS helper in the package and exercise the process runner in macOS CI. Cap overlap rows at eight and label them as observations rather than proven collisions. The view observes differing or unverified uncommitted paths; it does not enforce claims or prove compatibility.
+
+## 0.1.2 — 2026-10-21
+
+- Address AgentScrum’s first external Claude Code/OpenCode task trial: compact default MCP status (protocol 1.1; full contracts remain opt-in), omit unchanged contracts from edit reports, and return the current worktree-bearing agent record immediately.
+- Clarify same-connection token omission and transcript limits, independent PR worktrees, retained worktrees/session completion, and integration target preservation. Record the maintainer-reported completed workflow and merged PRs without treating it as broad client certification.
+
+- Add the official MCP Registry ownership marker and server manifest, with pinned npm launch and a required repository path.
+- Clarify npm-first client onboarding and expose the public package version in the README. No new runtime dependencies or storage schema changes.
+- Synchronize the MCP mutex test with command readiness and release, and assert lease renewal directly, avoiding fixed-duration races on busy CI runners. Installation examples pin this release.
+
 ## 0.1.1 — 2026-10-20
 
 - Validate the real Cursor CLI model/editor/MCP workflow and missing-guard refusal, with redacted reusable proof.

package/README.md

@@ -4,6 +4,7 @@
 
 <p align="center">
   <a href="https://github.com/connorhriley/kith/actions/workflows/ci.yml"><img src="https://github.com/connorhriley/kith/actions/workflows/ci.yml/badge.svg" alt="CI status"></a>
+  <a href="https://www.npmjs.com/package/kith-coord"><img src="https://img.shields.io/npm/v/kith-coord" alt="npm version"></a>
   <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-22C55E" alt="MIT license"></a>
 </p>
 
@@ -37,14 +38,19 @@ The [reliability contract](docs/reliability.md) defines ownership, verification,
 
 Requires **Git 2.38+** and **Node.js 22.13+ on 22.x or Node.js 24+**. Full workflows target macOS and Linux. Version 0.1.1 also validates native Windows MCP claims, worktrees, ports, integration and recovery; supervised mutex commands and shell hooks require macOS/Linux or WSL. See the [support evidence](docs/client-validation.md#native-windows).
 
+Git recording and integration require a commit identity configured for the repository (`user.name` and `user.email`). Kith does not change your global Git identity.
+
 Install the release, then configure your project:
 
 ```sh
-npm install --global kith-coord@0.1.1
+npm install --global kith-coord@0.1.3
 cd /path/to/your/project
+kith init --dry-run
 kith init
 ```
 
+For detected global clients, run `kith setup --dry-run`, then `kith setup`. You configure the connection once. A coding client started in a Git checkout can use its project context; a desktop agent supplies the absolute `repository` path on each call. Claims, ownership and integration stay scoped to that repository. Global setup from HOME creates configuration backups, not a project database. See [client setup](docs/integrations.md#configure-detected-local-clients).
+
 For source installation and the disposable demo, use the pinned **pnpm 10.20.0**:
 
 ```sh
@@ -78,17 +84,7 @@ The implementation is in [examples/two-agents.mjs](examples/two-agents.mjs). Thi
 
 ### Connect your client
 
-Link the built CLI, then switch to the repository you want to coordinate:
-
-```sh
-# From the Kith checkout
-pnpm link --global
-kith help
-
-# From your target repository, preview the selected integrations first
-kith init --dry-run
-kith init
-```
+After the npm quick start above, restart your coding client in that project and approve its Kith MCP connection. Generated configuration uses the installed `kith` executable; no source checkout or `pnpm link` is needed. Review and commit the generated files before asking agents to integrate work.
 
 Default setup installs MCP configuration for Claude, Codex and Cursor plus agent instructions, without adding hooks or package-manager shims. Review and commit the generated configuration before starting work; integration requires a clean target checkout. Restart your client with `kith` on its `PATH`. To select clients, use `--mcp-only --only claude,codex,agents`. Existing hooks are preserved; review warnings if they require an inherited session. See [hook setup](docs/integrations.md) if you need them.