kith-coord 0.1.1 → 0.1.2

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 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>
 
@@ -40,8 +41,9 @@ Requires **Git 2.38+** and **Node.js 22.13+ on 22.x or Node.js 24+**. Full workf
 Install the release, then configure your project:
 
 ```sh
-npm install --global kith-coord@0.1.1
+npm install --global kith-coord@0.1.2
 cd /path/to/your/project
+kith init --dry-run
 kith init
 ```
 
@@ -78,17 +80,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.
 

package/dist/cli/index.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 
 // src/version.ts
-var KITH_VERSION = "0.1.1";
-var KITH_PROTOCOL_VERSION = "1.0.0";
+var KITH_VERSION = "0.1.2";
+var KITH_PROTOCOL_VERSION = "1.1.0";
 
 // src/cli/setup-ledger.ts
 import fs2 from "fs";
@@ -2589,6 +2589,7 @@ var DependencyAndContractEngine = class {
       }
       for (const exp of analysis.exports) {
         const prev = existingBySymbol.get(exp.symbolName);
+        if (prev && prev.kind === exp.kind && prev.signature === exp.signature && prev.ast_hash === exp.astHash && prev.params_fingerprint === exp.paramsFingerprint && prev.doc_comment === exp.docComment) continue;
         const isBreaking = prev !== void 0 && prev.ast_hash !== exp.astHash;
         if (isBreaking && prev) {
           changedSymbols.push({
@@ -3921,7 +3922,7 @@ function createKithMcpServer(repoRoot = process.cwd()) {
   const server = new McpServer({
     name: "kith-coordinator",
     version: KITH_VERSION
-  }, { instructions: "Kith coordinates work claims, isolated worktrees, local resources and verified integration for cooperating coding agents. State stays local; no hosted service or model API key is required. Recommended workflow: one isolated worktree per parallel agent. Call kith_begin_work with isolateWorktree:true and explicit scopeGlobs; edit only the returned worktreePath, call kith_record_file_edit, run literal argv with kith_run_with_mutex, and finish with kith_complete_work plus a project verificationCmd. Heartbeat before the session expires. " + (process.env.KITH_AGENT_ID ? `This server shares a session with CLI/hooks. Use agentId '${process.env.KITH_AGENT_ID}'. Its inherited capability is handled internally; do not request or log it.` : "Start with kith_begin_work or kith_start_session and a unique agentId. This connection retains its granted capability. Another connection needs the session token to resume that ID. Keep tokens private.") });
+  }, { instructions: "Kith coordinates work claims, isolated worktrees, local resources and verified integration for cooperating coding agents. State stays local; no hosted service or model API key is required. Recommended workflow: one isolated worktree per parallel agent. Call kith_begin_work with isolateWorktree:true and explicit scopeGlobs; edit only the returned worktreePath, call kith_record_file_edit, run literal argv with kith_run_with_mutex, and finish with kith_complete_work plus a project verificationCmd. Heartbeat before the session expires. " + (process.env.KITH_AGENT_ID ? `This server shares a session with CLI/hooks. Use agentId '${process.env.KITH_AGENT_ID}'. Its inherited capability is handled internally; do not request or log it.` : "Start with kith_begin_work or kith_start_session and a unique agentId. This connection retains its granted capability. Omit sessionToken on subsequent calls on this connection; only another connection needs it to resume that ID. Initial grant/resume replies contain the token and client transcripts may record it. Keep transcripts private.") });
   const tokenFor = (args) => args.sessionToken ?? (process.env.KITH_AGENT_ID === args.agentId ? process.env.KITH_SESSION_TOKEN : void 0);
   const owned = /* @__PURE__ */ new Set();
   const register = (args) => {
@@ -4006,7 +4007,7 @@ function createKithMcpServer(repoRoot = process.cwd()) {
       const contracts = engine.depGraph.listContracts().slice(0, 30);
       return formatReply(args.agentId, {
         ok: intentRes.ok,
-        agent: reg.agent,
+        agent: engine.fencing.getAgent(args.agentId),
         sessionToken: reg.sessionToken,
         fencingToken: intentRes.fencingToken,
         task: intentRes.task,
@@ -4163,12 +4164,18 @@ function createKithMcpServer(repoRoot = process.cwd()) {
     "Retrieve coordination state, FIFO waiters and guarded commands, plus worktree paths, actual branches, dirty-file overlaps, commit age and ahead/behind against the current integration target HEAD. Normal engine startup may reap expired ownership.",
     {
       agentId: z.string().optional(),
-      sessionToken: z.string().optional()
+      sessionToken: z.string().optional(),
+      includeContracts: z.boolean().optional().describe("Include the full contract registry. Default false keeps frequent status polls compact; contractCount always reports its size.")
     },
     async (args) => {
       if (args.agentId) authorize({ ...args, agentId: args.agentId });
       const state = engine.getStatus();
-      return formatReply(args.agentId, state);
+      return formatReply(args.agentId, {
+        ...state,
+        contracts: args.includeContracts ? state.contracts : [],
+        contractCount: state.contracts.length,
+        contractsIncluded: args.includeContracts ?? false
+      });
     }
   );
   server.tool(
@@ -4188,7 +4195,7 @@ function createKithMcpServer(repoRoot = process.cwd()) {
       sessionToken: z.string().optional(),
       taskId: z.string().optional(),
       fencingToken: z.number().optional(),
-      mergeBranch: z.string().optional().describe("If work was done on a worktree/branch, run Speculative Merge Train to integrate it"),
+      mergeBranch: z.string().optional().describe("Source branch to integrate, not the destination. Defaults to the registered agent branch; destination is the selected repository checkout current branch. Omit for claims-only work without a registered branch."),
       verificationCmd: z.string().optional().describe('Command to run in speculative merge tree (e.g. "npm run typecheck")')
     },
     async (args) => {
@@ -4556,7 +4563,7 @@ Use Kith MCP to claim work, isolate changes in worktrees, share local resources
 4. Renew idle sessions with \`kith_heartbeat\` before their lease expires (every two minutes for the default five-minute lease; sooner for a shorter lease). Inspect \`kith_get_status\`.
 5. Complete with \`kith_complete_work\` and a project-specific \`verificationCmd\`. Failed verification keeps the integration target unchanged. Successful worktrees are retained for inspection.
 
-The MCP connection retains its capability; do not copy or log session tokens. A new connection needs a valid capability to resume an existing ID. Locks coordinate cooperating writers; hooks are not an OS security sandbox.
+The MCP connection retains its capability; omit \`sessionToken\` on subsequent calls on that connection. Initial grant/resume replies contain the token, so keep client transcripts private. Do not copy tokens into shell commands or public reports. A new connection needs a valid capability to resume an existing ID. Locks coordinate cooperating writers; hooks are not an OS security sandbox.
 
 If Claude/Cursor edit hooks or CLI commands are also enabled, launch the client from a persistent shell after \`eval "$(kith session start --agent <id> --owner-pid "$$" --shell)"\`. CLI, hooks and MCP must inherit the same KITH_AGENT_ID/KITH_SESSION_TOKEN and use the same agent ID. Separate stateless shell calls do not preserve these exports or the owning shell. MCP-only setup skips new native edit hooks and preserves existing ones.
 <!-- KITH:END -->`;