@ssheleg/agent-sync 1.8.2 → 1.9.0

package/CHANGELOG.md

@@ -1,3 +1,41 @@
+## v1.9.0
+
+### Changed
+
+- **The installer now offers the family's routing block** (closing B-06 in the
+  umbrella). Until now only `super-ux` delegated: install this skill on its own
+  and no router was written at all, so an agent had the skill and no rule saying
+  when to reach for it. The bundle installer wrote all eight, which is why
+  nothing looked broken — the gap only opened for someone installing one member.
+
+  Delegated to `npx sshlg-skills routers --member agent-sync` rather than
+  reimplemented, for three reasons:
+
+  - The block describes what the machine actually has. A lone member rendering
+    the whole thing would print a table for routers nobody installed.
+  - `--member` scopes the write to this skill's own section. Verified by damaging
+    two sections of a real block and running this installer: its own was
+    repaired, the other left exactly as it was.
+  - The launcher is the only writer that copies the operator's global instruction
+    file before touching it. That file has no version control behind it.
+
+  `--no-install` keeps it from silently downloading a package nobody asked for.
+  When the launcher is absent the command is printed instead of failing: ending
+  an install in an error over an optional follow-up reads as a failed install.
+  Both paths were exercised.
+
+## v1.8.3
+
+### Changed
+
+- **The body is back inside the token budget** — ~5124 → ~4996 of 5000. Two sections
+  were restating references that already carry the depth: *Two documentation sources*
+  duplicated three sections of `two-sources.md`, and the stage list duplicated
+  `pipeline-binding.md`. The body keeps the principle and the trap — `reconcile` is
+  mechanical and refuses to judge whether the built thing matches the document, so
+  reading its green as agreement is how a divergence survives both ends — and the depth
+  stays where it already was.
+
 ## v1.8.2
 
 ### Changed

package/bin/agent-sync.js

@@ -95,6 +95,9 @@ function install(argv) {
       ? C.green('\n✓ installed')
       : C.red('\n✗ at least one channel failed — see the output above')
   );
+  // Before the "Next:" block, so the last thing on screen stays the instruction
+  // rather than the tail of a delegated command.
+  offerRouters();
   console.log(`
 ${C.bold('Next:')} restart Claude Code, then run ${C.bold('/agent-sync init')} in your project.
 It will ask where coordination state should live before writing anything.
@@ -102,6 +105,37 @@ It will ask where coordination state should live before writing anything.
   return ok ? 0 : 1;
 }
 
+/**
+ * Ask the family launcher to write the routing block, for this member only.
+ *
+ * Delegated rather than reimplemented, for three reasons. The block describes
+ * what the machine actually has, so a lone member rendering the whole thing
+ * would produce a table for routers nobody installed. `--member` limits the
+ * write to the `agent-sync` section and leaves everyone else's alone, which is
+ * what lets the bundle and a single installer both write. And the launcher is
+ * the only writer that copies the operator's global instruction file before
+ * touching it — that file has no version control behind it.
+ *
+ * `--no-install` keeps this from silently downloading a package nobody asked
+ * for. When the launcher is absent, print the command rather than fail: ending
+ * an install in an error because an OPTIONAL follow-up is missing reads as a
+ * failed install.
+ */
+function offerRouters() {
+  const r = spawnSync(
+    'npx',
+    ['--no-install', 'sshlg-skills', 'routers', '--member', NAME],
+    { stdio: 'inherit', shell: process.platform === 'win32' }
+  );
+  if (r.status !== 0) {
+    console.log(
+      `\nTo have this skill apply by default in every project, add the ` +
+      `family's\nrouting block to your agent's global instructions:\n\n` +
+      `  npx --yes sshlg-skills routers --member ${NAME}\n`
+    );
+  }
+}
+
 /**
  * The shadow regrows on its own: `npx skills add|update --global` auto-detects
  * Claude Code and recreates ~/.claude/skills/<name> — often as a symlink — even when

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ssheleg/agent-sync",
-  "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.",
+  "version": "1.9.0",
+  "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,8 +1,8 @@
 {
   "name": "agent-sync",
   "displayName": "Agent Sync",
-  "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.",
+  "version": "1.9.0",
+  "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",
     "url": "https://x.com/sshlg93"

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.2"
+  version: "1.9.0"
   author: ssheleg
 ---
 
@@ -87,8 +87,8 @@ nothing.
 ## Existing project: start with `adopt`
 
 Run `adopt` before `init`. It reads the repository and prints what it found — id
-registers, registry files, gates — plus the decisions it **refuses to make for you**,
-then proposes a config. It writes nothing.
+registers, registry files, gates — plus the decisions it **refuses to make for you** —
+then proposes a config.
 
 ```bash
 python3 "$SKILL_DIR/scripts/agent_sync.py" adopt
@@ -275,45 +275,38 @@ overwritten. Lifetimes: `references/two-sources.md`.
 
 ## Two documentation sources, and the duty to reconcile them
 
-Git docs answer **how it should be** — written before the code, often without it.
-The as-built record answers **how it actually is** — derived from what agents really
-wrote. Neither is a copy of the other, and neither outranks the other, because they
-answer different questions. **The gap between them is the finding**, not a defect.
+Git docs answer **how it should be**; the as-built record answers **how it actually
+is**. Neither outranks the other, because they answer different questions — and
+**the gap between them is the finding**, not a defect.
 
-The duty runs at both ends of every task:
+The duty runs at both ends of a task: `reconcile` and resolve every divergence before
+starting, then `record` and `reconcile` again after finishing. Building on an
+unresolved divergence is writing code against a system that does not exist.
 
-- **Before starting** (docs-study stage) — `reconcile`, then read both sides for the area
-  you are about to touch, and resolve each divergence: the git doc is stale, the as-built
-  record is wrong, or they genuinely disagree and that is a decision. Building on an
-  unresolved divergence is writing code against a system that does not exist.
-- **After finishing** (docs stage) — `record` what you built, update the git documents
-  that state intent, then `reconcile` again. A task that updated one side leaves the next
-  agent a divergence to find the hard way.
-
-`reconcile` is mechanical and says so: it compares ids, commits and presence, and refuses
-to judge whether the built thing matches the document. That reading is yours.
+**The trap: `reconcile` is mechanical and refuses to judge** whether the built thing
+matches the document — it compares ids, commits and presence. That reading is yours,
+and treating its green as agreement is how a divergence survives both ends.
 
 Every project also carries a **generated snapshot** of its own wiring (`setup`) — commit
 it and link it from the agent instructions, so agents read the pipeline instead of
 inferring it.
 
 **Read `references/two-sources.md`** before the first reconcile, and whenever deciding
-which side a document belongs on.
+which side a document belongs on: it carries what each side is for, what `reconcile`
+decides, why the check is a ratchet, where a document belongs, and why nothing is
+deleted.
 
 ## Binding to task-pipeline
 
-This skill supplies stages; it does not define them. Stage names are
-`task-pipeline`'s own.
+This skill supplies stages; the names are `task-pipeline`'s own.
 
-Five of the eleven stages carry a rule the others do not, and each is about ordering:
-**0** `acquire` before the brief is committed; **1** `reconcile` and resolve every
-divergence before writing code; **3** `reserve` every id before it reaches git; **9**
-`record`, `signal`, `reconcile`, `board` — the main write point. **10** ends the run:
-`merge` if the work is on a branch, otherwise `release` every lease by hand. Full table
-with the reasoning per stage: `references/pipeline-binding.md`.
+Five of the eleven stages carry an ordering rule: **0** `acquire` before the brief is
+committed; **1** `reconcile` before writing code; **3** `reserve` every id before it
+reaches git; **9** the main write point; **10** `merge` or `release` every lease.
 
-**Read `references/pipeline-binding.md` when wiring `pipeline.json`** — it holds the
-`skills[]` entries and the gate expressions.
+**Read `references/pipeline-binding.md`** when wiring `pipeline.json` — it holds the
+per-stage reasoning, the `skills[]` entries, what must be guarded, and the gate
+expressions.
 
 ## Configuration
 

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