kith-coord 0.0.0-stage → 0.1.0

package/docs/validation/2026-10-19-path-hardening-claude.json

@@ -0,0 +1,32 @@
+{
+  "client": "claude",
+  "version": "2.1.301 (Claude Code)",
+  "platform": "darwin",
+  "node": "v22.23.3",
+  "scenarios": [
+    {
+      "scenario": "isolated",
+      "passed": true,
+      "tools": [
+        "kith_begin_work",
+        "kith_begin_work",
+        "kith_record_file_edit",
+        "kith_run_with_mutex",
+        "kith_complete_work",
+        "kith_get_status"
+      ],
+      "hookDenialVerified": true,
+      "checks": [
+        "protected bytes unchanged",
+        "native edit",
+        "contract recorded",
+        "renewable MCP mutex command",
+        "verified integration",
+        "task completed",
+        "locks released",
+        "inherited owner preserved"
+      ]
+    }
+  ],
+  "passed": true
+}

package/docs/validation/2026-10-19-path-hardening-codex.json

@@ -0,0 +1,30 @@
+{
+  "client": "codex",
+  "version": "codex-cli 0.163.0-alpha.10.2",
+  "platform": "darwin",
+  "node": "v22.23.3",
+  "scenarios": [
+    {
+      "scenario": "isolated",
+      "passed": true,
+      "tools": [
+        "kith_begin_work",
+        "kith_begin_work",
+        "kith_record_file_edit",
+        "kith_run_with_mutex",
+        "kith_complete_work",
+        "kith_get_status"
+      ],
+      "checks": [
+        "protected bytes unchanged",
+        "native edit",
+        "contract recorded",
+        "renewable MCP mutex command",
+        "verified integration",
+        "task completed",
+        "locks released"
+      ]
+    }
+  ],
+  "passed": true
+}

package/docs/validation/2026-10-19-recovery-claude.json

@@ -0,0 +1,35 @@
+{
+  "client": "claude",
+  "version": "2.1.301 (Claude Code)",
+  "platform": "darwin",
+  "node": "v22.23.3",
+  "scenarios": [
+    {
+      "scenario": "isolated",
+      "passed": true,
+      "tools": [
+        "kith_begin_work",
+        "kith_begin_work",
+        "kith_record_file_edit",
+        "kith_run_with_mutex",
+        "kith_complete_work",
+        "kith_get_status",
+        "kith_complete_work",
+        "kith_get_status"
+      ],
+      "hookDenialVerified": true,
+      "checks": [
+        "protected bytes unchanged",
+        "native edit",
+        "contract recorded",
+        "renewable MCP mutex command",
+        "failed verification and successful retry",
+        "verified integration",
+        "task completed",
+        "locks released",
+        "inherited owner preserved"
+      ]
+    }
+  ],
+  "passed": true
+}

package/docs/validation/2026-10-19-recovery-codex.json

@@ -0,0 +1,33 @@
+{
+  "client": "codex",
+  "version": "codex-cli 0.163.0-alpha.10.2",
+  "platform": "darwin",
+  "node": "v22.23.3",
+  "scenarios": [
+    {
+      "scenario": "isolated",
+      "passed": true,
+      "tools": [
+        "kith_begin_work",
+        "kith_begin_work",
+        "kith_record_file_edit",
+        "kith_run_with_mutex",
+        "kith_complete_work",
+        "kith_get_status",
+        "kith_complete_work",
+        "kith_get_status"
+      ],
+      "checks": [
+        "protected bytes unchanged",
+        "native edit",
+        "contract recorded",
+        "renewable MCP mutex command",
+        "failed verification and successful retry",
+        "verified integration",
+        "task completed",
+        "locks released"
+      ]
+    }
+  ],
+  "passed": true
+}

package/docs/validation/2026-10-19-sqlite-runtime-report.json

@@ -0,0 +1,50 @@
+{
+  "date": "2026-10-19",
+  "scope": "SQLite capability compatibility; local macOS checks, hosted failure reproduction",
+  "hosted_before_fix": {
+    "run": "https://github.com/connorhriley/kith/actions/runs/39280488937",
+    "passed": [
+      "macos/22",
+      "macos/24",
+      "ubuntu/22",
+      "ubuntu/24"
+    ],
+    "failed": [
+      "macos/22.13.0",
+      "ubuntu/22.13.0"
+    ],
+    "cause": "no such module: fts5"
+  },
+  "local_runtimes": [
+    {
+      "node": "22.13.0",
+      "fts5": false,
+      "tests_passed": 78,
+      "tests_skipped": 2,
+      "skip_reason": "Restoration of an FTS5 index requires the unavailable module; fallback behavior is exercised.",
+      "package_consumer": "passed",
+      "two_mcp_clients": "passed"
+    },
+    {
+      "node": "22.23.3",
+      "fts5": true,
+      "tests_passed": 80,
+      "tests_skipped": 0
+    },
+    {
+      "node": "24.22.0",
+      "fts5": true,
+      "tests_passed": 80,
+      "tests_skipped": 0
+    }
+  ],
+  "real_cross_runtime_roundtrip": {
+    "result": "passed",
+    "sequence": [
+      "Create indexed state under Node 22.23.3",
+      "Update a contract and delete another under stock Node 22.13.0",
+      "Rebuild derived FTS index under Node 22.23.3 and verify only the updated contract remains"
+    ]
+  },
+  "hosted_after_fix": "Pending; inspect the final commit CI run for Linux/macOS validation."
+}

package/docs/validation/2026-10-20-adoption-claude.json

@@ -0,0 +1,35 @@
+{
+  "client": "claude",
+  "version": "2.1.301 (Claude Code)",
+  "platform": "darwin",
+  "node": "v22.23.3",
+  "scenarios": [
+    {
+      "scenario": "isolated",
+      "passed": true,
+      "tools": [
+        "kith_begin_work",
+        "kith_begin_work",
+        "kith_record_file_edit",
+        "kith_run_with_mutex",
+        "kith_complete_work",
+        "kith_get_status",
+        "kith_complete_work",
+        "kith_get_status"
+      ],
+      "hookDenialVerified": true,
+      "checks": [
+        "protected bytes unchanged",
+        "native edit",
+        "contract recorded",
+        "renewable MCP mutex command",
+        "failed verification and successful retry",
+        "verified integration",
+        "task completed",
+        "locks released",
+        "inherited owner preserved"
+      ]
+    }
+  ],
+  "passed": true
+}

package/docs/validation/2026-10-20-adoption-codex-first-attempt.json

@@ -0,0 +1,20 @@
+{
+  "client": "codex",
+  "version": "codex-cli 0.163.0-alpha.10.2",
+  "platform": "darwin",
+  "node": "v22.23.3",
+  "scenarios": [
+    {
+      "scenario": "isolated",
+      "passed": false,
+      "tools": [
+        "kith_begin_work",
+        "kith_begin_work",
+        "kith_record_file_edit",
+        "kith_run_with_mutex"
+      ],
+      "error": "Missing kith_complete_work; client exit zero is insufficient"
+    }
+  ],
+  "passed": false
+}

package/docs/validation/2026-10-20-adoption-codex.json

@@ -0,0 +1,73 @@
+{
+  "client": "codex",
+  "version": "codex-cli 0.163.0-alpha.10.2",
+  "platform": "darwin",
+  "node": "v22.23.3",
+  "scenarios": [
+    {
+      "scenario": "isolated",
+      "passed": true,
+      "tools": [
+        "kith_begin_work",
+        "kith_begin_work",
+        "kith_record_file_edit",
+        "kith_run_with_mutex",
+        "kith_complete_work",
+        "kith_get_status",
+        "kith_complete_work",
+        "kith_get_status"
+      ],
+      "toolOutcomes": [
+        {
+          "tool": "kith_begin_work",
+          "status": "failed",
+          "ok": false
+        },
+        {
+          "tool": "kith_begin_work",
+          "status": "completed",
+          "ok": true
+        },
+        {
+          "tool": "kith_record_file_edit",
+          "status": "completed"
+        },
+        {
+          "tool": "kith_run_with_mutex",
+          "status": "completed",
+          "ok": true,
+          "exitCode": 0
+        },
+        {
+          "tool": "kith_complete_work",
+          "status": "failed",
+          "ok": false
+        },
+        {
+          "tool": "kith_get_status",
+          "status": "completed"
+        },
+        {
+          "tool": "kith_complete_work",
+          "status": "completed",
+          "ok": true
+        },
+        {
+          "tool": "kith_get_status",
+          "status": "completed"
+        }
+      ],
+      "checks": [
+        "protected bytes unchanged",
+        "native edit",
+        "contract recorded",
+        "renewable MCP mutex command",
+        "failed verification and successful retry",
+        "verified integration",
+        "task completed",
+        "locks released"
+      ]
+    }
+  ],
+  "passed": true
+}

package/docs/validation/2026-10-20-adoption-hook-failure.json

@@ -0,0 +1,18 @@
+{
+  "client": "claude",
+  "version": "2.1.301 (Claude Code)",
+  "platform": "darwin",
+  "node": "v22.23.3",
+  "scenarios": [
+    {
+      "scenario": "hook-failure",
+      "passed": true,
+      "checks": [
+        "native Write attempted once",
+        "tool denied",
+        "marker absent"
+      ]
+    }
+  ],
+  "passed": true
+}

package/docs/validation/2026-10-20-subtraction-claude.json

@@ -0,0 +1,35 @@
+{
+  "client": "claude",
+  "version": "2.1.301 (Claude Code)",
+  "platform": "darwin",
+  "node": "v22.23.3",
+  "scenarios": [
+    {
+      "scenario": "isolated",
+      "passed": true,
+      "tools": [
+        "kith_begin_work",
+        "kith_begin_work",
+        "kith_record_file_edit",
+        "kith_run_with_mutex",
+        "kith_complete_work",
+        "kith_get_status",
+        "kith_complete_work",
+        "kith_get_status"
+      ],
+      "hookDenialVerified": true,
+      "checks": [
+        "protected bytes unchanged",
+        "native edit",
+        "contract recorded",
+        "renewable MCP mutex command",
+        "failed verification and successful retry",
+        "verified integration",
+        "task completed",
+        "locks released",
+        "inherited owner preserved"
+      ]
+    }
+  ],
+  "passed": true
+}

package/docs/validation/2026-10-20-subtraction-codex.json

@@ -0,0 +1,33 @@
+{
+  "client": "codex",
+  "version": "codex-cli 0.163.0-alpha.10.2",
+  "platform": "darwin",
+  "node": "v22.23.3",
+  "scenarios": [
+    {
+      "scenario": "isolated",
+      "passed": true,
+      "tools": [
+        "kith_begin_work",
+        "kith_begin_work",
+        "kith_record_file_edit",
+        "kith_run_with_mutex",
+        "kith_complete_work",
+        "kith_get_status",
+        "kith_complete_work",
+        "kith_get_status"
+      ],
+      "checks": [
+        "protected bytes unchanged",
+        "native edit",
+        "contract recorded",
+        "renewable MCP mutex command",
+        "failed verification and successful retry",
+        "verified integration",
+        "task completed",
+        "locks released"
+      ]
+    }
+  ],
+  "passed": true
+}

package/package.json

@@ -1,6 +1,85 @@
 {
   "name": "kith-coord",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Local coordination for cooperating coding agents: work claims, isolated worktrees, shared resources, and verified integration without a hosted service.",
+  "type": "module",
+  "bin": {
+    "kith": "./dist/cli/index.js",
+    "coord": "./dist/cli/index.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "docs",
+    "CONTRIBUTING.md",
+    "SECURITY.md",
+    "CODE_OF_CONDUCT.md",
+    "CHANGELOG.md",
+    "assets/brand"
+  ],
+  "engines": {
+    "node": "^22.13.0 || >=24.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "tsup && vitest run",
+    "test:watch": "tsup && vitest",
+    "typecheck": "tsc --noEmit",
+    "check": "pnpm typecheck && pnpm test",
+    "prepack": "tsup",
+    "test:package": "pnpm build && node scripts/smoke-package.mjs",
+    "demo": "pnpm build && node examples/two-agents.mjs",
+    "test:clients": "pnpm build && node scripts/validate-native-clients.mjs",
+    "protocol:export": "pnpm build && node scripts/export-protocol.mjs",
+    "protocol:check": "node scripts/export-protocol.mjs --check"
+  },
+  "keywords": [
+    "ai-agents",
+    "parallel-agents",
+    "mcp",
+    "claude-code",
+    "codex",
+    "antigravity",
+    "cursor",
+    "git-worktree",
+    "coordination",
+    "multi-agent"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.32.1",
+    "picomatch": "^4.0.2",
+    "smol-toml": "^1.9.1",
+    "zod": "^3.24.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.0",
+    "@types/picomatch": "^4.0.0",
+    "tsup": "^8.4.0",
+    "vitest": "^3.0.7",
+    "typescript": "^5.8.2"
+  },
+  "packageManager": "pnpm@10.20.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/connorhriley/kith.git"
+  },
+  "homepage": "https://github.com/connorhriley/kith#readme",
+  "bugs": {
+    "url": "https://github.com/connorhriley/kith/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  }
+}