kith-coord 0.1.4 → 0.1.5
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/CHANGELOG.md +5 -0
- package/README.md +1 -1
- package/bin/kith-menubar +0 -0
- package/dist/cli/index.js +57 -8
- package/dist/cli/index.js.map +1 -1
- package/dist/index.d.ts +4 -2
- package/dist/index.js +6 -2
- package/dist/index.js.map +1 -1
- package/docs/integrations.md +2 -2
- package/docs/reliability.md +5 -1
- package/docs/roadmap.md +1 -1
- package/package.json +1 -1
- package/server.json +2 -2
package/docs/integrations.md
CHANGED
|
@@ -66,12 +66,12 @@ Uninstall restores the exact original bytes/permissions or deletes files created
|
|
|
66
66
|
|
|
67
67
|
## Registry installation
|
|
68
68
|
|
|
69
|
-
The package is `kith-coord`, and its binary remains `kith`. Install it persistently (`npm install --global kith-coord@0.1.
|
|
69
|
+
The package is `kith-coord`, and its binary remains `kith`. Install it persistently (`npm install --global kith-coord@0.1.5`) before `kith init`, because generated configurations launch `kith` on PATH. Invoking init through npx alone does not create that persistent executable.
|
|
70
70
|
|
|
71
71
|
An MCP client can instead use a pinned registry launcher without a global install:
|
|
72
72
|
|
|
73
73
|
```json
|
|
74
|
-
{"mcpServers":{"kith":{"command":"npx","args":["--yes","--package","kith-coord@0.1.
|
|
74
|
+
{"mcpServers":{"kith":{"command":"npx","args":["--yes","--package","kith-coord@0.1.5","kith","mcp","--repo","/absolute/checkout"]}}}
|
|
75
75
|
```
|
|
76
76
|
|
|
77
77
|
Use a version you have verified; the unrelated npm package named `kith` is not Kith's distribution. Hook commands still need their configured executable to remain available. The clean-package smoke check exercises the installed binary, library, supervised worker and actual MCP discovery/status in a separate consumer.
|
package/docs/reliability.md
CHANGED
|
@@ -73,7 +73,7 @@ See [path and scope rules](path-and-scope-rules.md) for repository discovery, li
|
|
|
73
73
|
|
|
74
74
|
## Observations and previews
|
|
75
75
|
|
|
76
|
-
Workspace status distinguishes recorded branch/lease from observed Git state. Dirty overlap means the same relative path is changed in multiple
|
|
76
|
+
Workspace status distinguishes recorded branch/lease from observed Git state. Dirty overlap means the same relative path is changed in multiple checkouts; it does not prove a merge conflict. Ahead/behind uses the reported target HEAD, not a fetched remote branch. Commit age does not trigger release; ownership TTL and heartbeat remain authoritative. Unavailable observations must not be interpreted as clean.
|
|
77
77
|
|
|
78
78
|
`kith_preview_integrate` uses committed source/target trees and reports Git's exact conflict paths. It refuses dirty inputs rather than silently checkpointing them. It can create unreachable Git objects but leaves files/indexes/refs untouched; normal session authorization can renew a heartbeat. Actual completion rechecks inputs and performs the requested project verification independently. A successful preview is not a verification result.
|
|
79
79
|
|
|
@@ -81,3 +81,7 @@ Preview refuses repositories with configured custom merge drivers because Git ca
|
|
|
81
81
|
|
|
82
82
|
|
|
83
83
|
Passive CLI/menu observations use Git status and available file mtimes. They do not identify file writers or establish that a session is participating. Missing files and future timestamps cannot establish edit age and are omitted from timed recent-file lists. Incomplete scans retain unknown health; any retained findings may be stale. Use an explicit checkout and its owning session for integration, or offline inspection for recovery. Never clear warnings by deleting retained work.
|
|
84
|
+
|
|
85
|
+
The radar groups differing paths by checkout. **Active Kith lease** means a recorded active session with an unexpired lease, not proof of a live writer. **Retained** means its recorded sessions are completed, idle, dead or expired; it is not permission to delete the checkout. **No Kith session** means outside activity is unknown. **Ownership unavailable** means the preserved coordination snapshot could not be read; inspect `kith status --offline` or `kith recover` in that checkout. Reads never renew or reap owners. Git change counts exclude ignored files and say nothing about unpushed commits or whether cleanup is safe.
|
|
86
|
+
|
|
87
|
+
The menu's path count is a review list before integration, not an urgency score or a count of colliding agents. Identical dirty copies are excluded. A path shown under several checkouts need not differ between every pair. Recorded owners are not attributed as file writers. Review the worktree copies and run normal verification through the owning session before integration; preserve unfinished work in retained checkouts.
|
package/docs/roadmap.md
CHANGED
|
@@ -14,7 +14,7 @@ MCP is the default agent interface. Keep one shared ownership ledger per Git com
|
|
|
14
14
|
4. **Followable recovery.** Exercise disconnect, expiry, failed checks, partial setup, interrupted migration and damaged-state refusal. Preserve worktrees and matching stopped database/sidecars; no automatic repair, forced claim release or deletion of `.coord`.
|
|
15
15
|
5. **Exact release evidence.** Require all six Linux/macOS and both Windows jobs on the candidate, including any editor checks, plus the exact packed-package consumer. Verify registry bytes and tag workflows after publication. Maintain versioned client evidence and honest platform limits.
|
|
16
16
|
|
|
17
|
-
Published 0.1.
|
|
17
|
+
Published 0.1.4 / protocol 1.3 has recorded clean npm and editor-registry evidence. Version 0.1.5 carries the read-only radar clarity fixes without changing the protocol. Each candidate must pass its own combined core/platform, bundled-server and clean-install gates before publication; a green prior release does not certify a new branch.
|
|
18
18
|
|
|
19
19
|
## Deferred
|
|
20
20
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "kith-coord",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.5",
|
|
4
4
|
"description": "Local coordination for cooperating coding agents: work claims, isolated worktrees, shared resources, and verified integration without a hosted service.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
package/server.json
CHANGED
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
"name": "io.github.connorhriley/kith",
|
|
4
4
|
"title": "Kith",
|
|
5
5
|
"description": "Coordinate coding agents with work claims, Git worktrees, shared resources and verified integration.",
|
|
6
|
-
"version": "0.1.
|
|
6
|
+
"version": "0.1.5",
|
|
7
7
|
"repository": {
|
|
8
8
|
"url": "https://github.com/connorhriley/kith",
|
|
9
9
|
"source": "github"
|
|
@@ -23,7 +23,7 @@
|
|
|
23
23
|
"registryType": "npm",
|
|
24
24
|
"registryBaseUrl": "https://registry.npmjs.org",
|
|
25
25
|
"identifier": "kith-coord",
|
|
26
|
-
"version": "0.1.
|
|
26
|
+
"version": "0.1.5",
|
|
27
27
|
"runtimeHint": "npx",
|
|
28
28
|
"runtimeArguments": [
|
|
29
29
|
{
|