@ssheleg/agent-sync 1.9.0 → 1.10.1

package/CHANGELOG.md

@@ -1,3 +1,43 @@
+## v1.10.1
+
+The claim tag could not be placed on nearly half a real board, and the lease was granted
+anyway.
+
+### Fixed
+
+- **A row that CITES an id no longer defeats that id's claim.** `claimTags` in `cell` mode
+  selected every row *containing* the id, so an ordinary board sentence — "closed by
+  B-12", "blocked until T-1 ships" — made the id ambiguous and the tag was refused.
+  Cross-referencing is what boards do: measured on `sshlg-skills`' own board on
+  2026-08-14, **14 of 41 rows cited others, leaving 19 ids that could never be tagged**.
+
+  The refusal itself was correct — guessing which row carries a claim is how a claim lands
+  on somebody else's work. What was wrong is that `acquire` still returned `won`: the
+  lease was granted while the registry silently carried no claim, which is precisely the
+  state a claim exists to make visible.
+
+  A markdown board declares which row is which in its **first cell**. `acquire` now
+  narrows to the row whose id cell equals the key, and refuses only when no row's id cell
+  matches. Tried *after* the existing marker narrowing, so `release` still trusts the
+  marker it actually wrote rather than re-deriving the row.
+
+  Covered by `check_claim_lands_on_the_row_whose_id_cell_matches()`, which builds a two-row
+  board where the second row cites the first, and asserts the tag lands on exactly one row
+  and that it is the right one — then that release still restores the file byte for byte.
+  Watched failing before the fix: *"acquire wrote no claim — a row citing T-1 defeated the
+  selector, and the lease was granted with the registry unmarked"*.
+
+## v1.10.0
+
+Following `task-pipeline` v1.53.0, which renamed the artifact root's default from
+`docs/superpowers/` to `docs/evidence/` and made the root resolvable (`paths.artifacts`
+in `pipeline.json`, else an existing `docs/evidence/`, else an existing
+`docs/superpowers/` — **the legacy name stays supported and no run warns about it**).
+
+Shipped surfaces name the new default now, which is why this is a minor rather than a
+patch. This project's own records moved with the directory and were not rewritten: a
+brief describes where things were when it was written.
+
 ## v1.9.0
 
 ### Changed

package/agent-sync.example.json

@@ -19,7 +19,7 @@
     "docs/OPEN_QUESTIONS.md",
     "docs/ROADMAP.md",
     "docs/DOCMAP.md",
-    "docs/superpowers/retro.md"
+    "docs/evidence/retro.md"
   ],
   "claimTags": {
     "docs/ROADMAP.md": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ssheleg/agent-sync",
-  "version": "1.9.0",
+  "version": "1.10.1",
   "description": "Let concurrent coding agents share one project without colliding — 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,7 +1,7 @@
 {
   "name": "agent-sync",
   "displayName": "Agent Sync",
-  "version": "1.9.0",
+  "version": "1.10.1",
   "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": "ssheleg",

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.9.0"
+  version: "1.10.1"
   author: ssheleg
 ---
 

package/plugins/agent-sync/skills/agent-sync/references/pipeline-binding.md

@@ -108,7 +108,7 @@ since the pipeline's documentation track it is longer than the registers:
 | the decision register (`docs/DECISIONS.md` or `docs/adr/`) | append-only; a concurrent write loses an entry |
 | `docs/OPEN_QUESTIONS.md`, `docs/ROADMAP.md` | the same |
 | **`docs/DOCMAP.md`** | seeded into every project the pipeline touches; holds the registers, the propagation matrix and the ratchet floors. Losing it loses the map |
-| **`docs/superpowers/retro.md`** | capped at ten standing instructions, so a concurrent write silently **drops a lesson** instead of conflicting visibly |
+| **`docs/evidence/retro.md`** | capped at ten standing instructions, so a concurrent write silently **drops a lesson** instead of conflicting visibly |
 
 The schema keeps `agent-sync.json` to known keys, which is why this reasoning lives
 here and not as a comment in the config.

package/plugins/agent-sync/skills/agent-sync/scripts/agent_sync.py

@@ -33,7 +33,7 @@ from datetime import datetime, timezone
 from pathlib import Path
 from typing import Any
 
-VERSION = "1.9.0"
+VERSION = "1.10.1"
 
 CONFIG_PATH = Path(".claude/agent-sync.json")
 ENV_FILE = Path(".env.agent-sync")
@@ -1668,6 +1668,22 @@ class Sync:
                     if len(narrowed) == 1:
                         hits = narrowed
 
+            # A board says which row is which in its FIRST cell. Every other match is a
+            # row CITING this id — "closed by B-12", "blocked until T-1 ships" — and boards
+            # cross-reference constantly: on the family's own board 14 rows cited others, so
+            # 19 of 41 ids had two candidate rows and their claim was refused. The refusal
+            # was right; granting the lease anyway was not, because the registry then carries
+            # no claim while `acquire` reports `won`. Tried after the marker so a release
+            # still trusts what it actually wrote.
+            if len(hits) > 1:
+                own = []
+                for i in hits:
+                    cells = self._row_cells(lines[i])
+                    if cells and cells[0].strip() == key:
+                        own.append(i)
+                if len(own) == 1:
+                    hits = own
+
             if len(hits) > 1:
                 notes.append(f"{rel}: `{key}` appears in {len(hits)} table rows — refusing "
                              "to guess which one is the claim. Narrow the pattern or edit by hand")