@ssheleg/agent-sync 1.8.0 → 1.8.2

package/CHANGELOG.md

@@ -1,3 +1,22 @@
+## v1.8.2
+
+### Changed
+
+- `references/hooks.md` crossed 100 lines and gains the `## Contents` list the canon
+  requires past that mark — generated from its own six headings. v1.8.1 did this for the
+  six references that were over the line then; this one grew past it afterwards, which
+  is the shape of the defect: the rule fires on a length that keeps changing.
+
+## v1.8.1
+
+### Changed
+
+- **Six references over 100 lines now open with a `## Contents` list.** The
+  canon asks for it because a partial read is what an agent actually does with
+  a long reference; without the list, a partial read returns an arbitrary
+  slice. Generated from each file's own `##` headings, so the list cannot
+  disagree with the document.
+
 ## v1.8.0
 
 **The board, cleared.** Nine rows opened by the two audits of 2026-08-10, closed with a check, a

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ssheleg/agent-sync",
-  "version": "1.8.0",
+  "version": "1.8.2",
   "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,7 +1,7 @@
 {
   "name": "agent-sync",
   "displayName": "Agent Sync",
-  "version": "1.8.0",
+  "version": "1.8.2",
   "description": "Coordination layer for multi-agent repositories \u2014 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.8.0"
+  version: "1.8.2"
   author: ssheleg
 ---
 

package/plugins/agent-sync/skills/agent-sync/references/backend-outline.md

@@ -2,6 +2,17 @@
 
 **Read this when** making any Outline API call or debugging one.
 
+## Contents
+
+- [Shape of the API](#shape-of-the-api)
+- [Capabilities](#capabilities)
+- [Primitive mapping](#primitive-mapping)
+- [Calling it without leaking the token](#calling-it-without-leaking-the-token)
+- [Rate limits](#rate-limits)
+- [Getting a token](#getting-a-token)
+- [Verifying an instance](#verifying-an-instance)
+
+
 [Outline](https://www.getoutline.com) is a collaborative knowledge base, available
 hosted or self-hosted. Both work; the instance URL is configuration, never code.
 

package/plugins/agent-sync/skills/agent-sync/references/branching.md

@@ -3,6 +3,15 @@
 **Read this when** starting work that will produce commits, merging a branch, or deciding
 where a claim should be written.
 
+## Contents
+
+- [The rule](#the-rule)
+- [Where a claim lives](#where-a-claim-lives)
+- [Landing the work](#landing-the-work)
+- [The merge log](#the-merge-log)
+- [What this does not do](#what-this-does-not-do)
+
+
 ## The rule
 
 > **Work happens on a branch. The integration branch is somebody else's stable base.**

package/plugins/agent-sync/skills/agent-sync/references/hooks.md

@@ -2,6 +2,15 @@
 
 **Read this when** installing, debugging or removing the enforcement hooks.
 
+## Contents
+
+- The limit, first
+- Contract
+- Installed hooks
+- Performance
+- Debugging
+- Removing them
+
 ## The limit, first
 
 **Hooks exist only in Claude Code.** On Cursor, Codex and the other agents the

package/plugins/agent-sync/skills/agent-sync/references/lease-protocol.md

@@ -3,6 +3,16 @@
 **Read this when** changing acquisition, expiry, stealing, or id allocation — or
 when two agents disagree about who holds something.
 
+## Contents
+
+- [Line grammar](#line-grammar)
+- [Acquiring — the third design, and the first that is true](#acquiring--the-third-design-and-the-first-that-is-true)
+- [Expiry and stealing](#expiry-and-stealing)
+- [Releasing](#releasing)
+- [Id reservation](#id-reservation)
+- [The lease is not the claim](#the-lease-is-not-the-claim)
+
+
 Two different mechanisms, and confusing them is how this went wrong twice:
 
 > **A lease is decided by an atomic operation** — `O_EXCL` on one filesystem, or a pushed

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

@@ -2,6 +2,16 @@
 
 **Read this when** wiring `pipeline.json`, or adding a stage hook.
 
+## Contents
+
+- [The numbers, once](#the-numbers-once)
+- [Where it plugs in](#where-it-plugs-in)
+- [pipeline.json](#pipelinejson)
+- [What must be guarded](#what-must-be-guarded)
+- [Preflight](#preflight)
+- [Gate expressions](#gate-expressions)
+
+
 `agent-sync` supplies stages; it does not define them. The stage names below are
 `task-pipeline`'s own — do not rename, renumber or fork them.
 

package/plugins/agent-sync/skills/agent-sync/references/roadmap.md

@@ -3,6 +3,16 @@
 **Read this when** configuring `claimTags`, taking or releasing a task, closing one, or
 re-planning work that is already on a board.
 
+## Contents
+
+- [The two records, and why both exist](#the-two-records-and-why-both-exist)
+- [How the write is made safe](#how-the-write-is-made-safe)
+- [Configuring it](#configuring-it)
+- [Closing a task](#closing-a-task)
+- [Re-planning](#re-planning)
+- [When the claim cannot be written](#when-the-claim-cannot-be-written)
+
+
 The roadmap is where a project says *what is being done and by whom*. With several
 agents it is also the file most likely to be written by two of them at once, which is why
 it is guarded — and why the tool touches it as narrowly as it possibly can.

package/plugins/agent-sync/skills/agent-sync/references/two-sources.md

@@ -3,6 +3,16 @@
 **Read this when** starting a task, finishing one, or deciding where a piece of
 documentation belongs.
 
+## Contents
+
+- [They answer different questions](#they-answer-different-questions)
+- [The duty, both ends of a task](#the-duty-both-ends-of-a-task)
+- [What `reconcile` decides, and what it refuses to](#what-reconcile-decides-and-what-it-refuses-to)
+- [The baseline — why the check is a ratchet](#the-baseline--why-the-check-is-a-ratchet)
+- [Where a piece of documentation belongs](#where-a-piece-of-documentation-belongs)
+- [Lifetime, and why nothing is deleted](#lifetime-and-why-nothing-is-deleted)
+
+
 ## They answer different questions
 
 | Source | Answers | Written | Authority over |

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.8.0"
+VERSION = "1.8.2"
 
 CONFIG_PATH = Path(".claude/agent-sync.json")
 ENV_FILE = Path(".env.agent-sync")