@ssheleg/agent-sync 1.2.2 → 1.2.3

package/CHANGELOG.md

@@ -3,6 +3,32 @@
 All notable changes to this project are documented here.
 This project adheres to [Semantic Versioning](https://semver.org/).
 
+## 1.2.3 — 2026-07-29
+
+### Fixed — the guard blocked commits in projects that never installed agent-sync
+`_lib.sh` states the contract: *"Every hook is a no-op in a project that does not use
+agent-sync, so installing the plugin globally changes nothing elsewhere."* `guard.sh` was
+the one hook that never sourced `_lib.sh`, and it honored that contract on only one of its
+two branches.
+
+- **The `git commit` branch had no configuration check.** It ran `agent_sync.py guard` on
+  every staged path; in an uninitialized project that command exits 2 with *"no
+  `.claude/agent-sync.json` in this project"*, which the loop read as "this run holds no
+  lease" — so every commit in every repo without agent-sync was blocked, with a message
+  naming a lease the project could not possibly need. The single-file branch had the check
+  all along, which is why the failure only ever surfaced on commits.
+- `guard.sh` now sources `_lib.sh` and gates on `agent_sync_configured` like the other three
+  hooks, so the check cannot drift apart from them again. The hand-rolled `AGENT_SYNC_PY`
+  path and the duplicated `[ -f … ]` test are gone.
+- The staged-path listing now runs against `${CLAUDE_PROJECT_DIR:-$PWD}`, the same directory
+  the configuration check reads. Before, the two could point at different repositories.
+
+### Added
+- **`test/validate.py` exercises the no-op contract** instead of only checking syntax: every
+  hook runs against a throwaway git repository that has a staged file and no
+  `.claude/agent-sync.json`, and must exit 0. Verified red against the pre-fix `guard.sh` and
+  green after — a `bash -n` pass could never have caught this.
+
 ## 1.2.2 — 2026-07-29
 
 ### Changed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ssheleg/agent-sync",
-  "version": "1.2.2",
+  "version": "1.2.3",
   "description": "Let concurrent coding agents share one project without colliding \u2014 leases with TTL, race-free id reservation, a run journal and a generated board, over a pluggable knowledge cloud.",
   "bin": {
     "agent-sync": "bin/agent-sync.js"

package/plugins/agent-sync/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-sync",
-  "version": "1.2.2",
+  "version": "1.2.3",
   "description": "Coordination layer for multi-agent repositories — leases with TTL, race-free ID reservation, a run journal, a cross-repo signal feed and a generated board, over a pluggable knowledge cloud.",
   "author": {
     "name": "appvillis-com"

package/plugins/agent-sync/hooks/guard.sh

@@ -3,7 +3,9 @@
 # Any other non-zero code is NON-blocking in Claude Code, so every internal
 # failure must also exit 2 — a crashing guard that fails open guards nothing.
 set -uo pipefail
-S="${CLAUDE_PLUGIN_ROOT}/skills/agent-sync/scripts/agent_sync.py"
+. "${CLAUDE_PLUGIN_ROOT}/hooks/_lib.sh"
+S="$AGENT_SYNC_PY"
+agent_sync_configured || exit 0
 input=$(cat)
 
 path=$(python3 -c '
@@ -34,14 +36,12 @@ print((d.get("tool_input") or {}).get("command",""))
           echo "agent-sync: '$staged' is staged but this run holds no lease on it. Acquire one, or unstage it." >&2
           exit 2
         fi
-      done < <(git diff --cached --name-only 2>/dev/null)
+      done < <(git -C "${CLAUDE_PROJECT_DIR:-$PWD}" diff --cached --name-only 2>/dev/null)
       ;;
   esac
   exit 0
 fi
 
-[ -f "${CLAUDE_PROJECT_DIR:-$PWD}/.claude/agent-sync.json" ] || exit 0
-
 if out=$(python3 "$S" guard "$path" 2>&1); then
   exit 0
 else

package/plugins/agent-sync/skills/agent-sync/SKILL.md

@@ -4,7 +4,7 @@ description: "Use when several coding agents work one repository at the same tim
 compatibility: "Requires the task-pipeline skill for its stages (npx sshlg-skills install). Needs python3 3.9+ (stdlib only, HTTP included - nothing to pip install) and bash for the hooks. The knowledge backend is configured per project; with none configured it degrades to git-file leases. Enforcement hooks are Claude Code only - on other agents the same checks run as a self-check."
 license: MIT
 metadata:
-  version: "1.2.2"
+  version: "1.2.3"
   author: appvillis-com
 ---