resync.py поднят в scripts/: пересборка копий из домов

copies.py находит расхождение, а чинить его руками — та же работа, из-за
которой копии и расходятся: правка дома касается стольких файлов, сколько
у него копий, и последний забывают. Проверка была, починки не было.

Разметку разбирает не свой код: copies.py импортируется целиком, иначе
второй разборщик той же разметки разошёлся бы с первым молча.

В гейт не ставится намеренно. Автоматическая пересборка протащила бы
правку дома во все копии мимо глаз автора, а копия, уезжающая в
репозиторий проекта, тянет ещё и запись в журнал версий канона — этого
машина не напишет.

Проверено на обеих формах копии: обычной и лежащей внутри объемлющей
ограды. Ограда и пустые строки по краям принадлежат месту, а не дому, и
пересборка возвращает их такими, какими были — round-trip побайтно
чистый на всех 24 копиях.

README.md

@@ -262,7 +262,7 @@ claude plugin uninstall <плагин>@av-dev-skills --scope project
 <plugin>/skills/<skill>/scripts/     tasks.py, docs.py, openspec.py
 <plugin>/agents/                     charter'ы сабагентов
 shared/                              дома правил, общих для нескольких плагинов
-scripts/                             проверки репозитория: копии, адреса, диаграммы, фронтматтеры
+scripts/                             проверки репозитория и пересборка копий
 pyproject.toml                       линтеры скриптов, только для этого репозитория
 lefthook.yml                         гейт коммита: проверки документов
 ```
@@ -355,6 +355,32 @@ uv run python scripts/copies.py     # 0 сошлось, 1 расхождение
 на тот файл, дом остался без копий, разметка сломана. Чего он **не** ловит —
 копию, которую забыли пометить: помечать — по-прежнему решение человека.
 
+### Пересборка — `scripts/resync.py`
+
+```
+python3 scripts/resync.py     # переписать тела всех разошедшихся копий из домов
+# 0 готово, 2 разметка сломана, 3 не тот каталог
+```
+
+Правка дома касается стольких файлов, сколько у него копий, и последний из них
+забывают — это и есть причина, по которой копии расходятся. Пересборка делает то
+же машиной и потому дословна по построению.
+
+**В гейт коммита скрипт не ставится, и это решение.** Автоматическая пересборка
+протащила бы правку дома во все копии мимо глаз автора, а правка дома, чья копия
+уезжает в репозиторий проекта, обязана ещё и попасть в журнал версий канона —
+этого машина не напишет. Гейт поэтому только **называет** расхождение; согласие с
+ним остаётся действием человека.
+
+Разметку разбирает не он сам: `copies.py` импортируется целиком. Второй
+разборщик той же разметки разошёлся бы с первым молча — ровно тот класс дефекта,
+против которого механика копий и заведена.
+
+**Ограда блока кода принадлежит месту, а не дому.** Одно и то же тело живёт в
+доме внутри ```` ``` ````, а в скелете канона — внутри чужой, объемлющей ограды,
+и своей там иметь не должно. Пересборка берёт тело дома без крайних оград и
+надевает обратно ту, что была у копии; пустые строки по краям — так же.
+
 ## Проверка адресов документов
 
 Адрес документа принадлежит одному плагину, а называют его все: `docs/*` стоит
@@ -452,5 +478,8 @@ Glob разводит две половины: коммит, трогающий
 (`stage_fixed: true`). Иначе исправленный файл остался бы в рабочем дереве, а в
 историю уехал бы невычищенный — худший из исходов: гейт зелёный, коммит грязный.
 
+**`resync.py` в гейте нет намеренно** — он чинит, а не проверяет, и его правка
+обязана быть прочитана глазами (см. выше).
+
 **Обход разовый — `LEFTHOOK=0 git commit …`.** Он законен ровно для случая,
 когда найденное нечем чинить прямо сейчас; молча пропущенная проверка — нет.

pyproject.toml

@@ -63,5 +63,10 @@ project-includes = [
     "scripts/copies.py",
     "scripts/diagrams.py",
     "scripts/frontmatter.py",
+    "scripts/resync.py",
 ]
 python-version = "3.12"
+# resync.py импортирует разборщик разметки из copies.py: второй разборщик той же
+# разметки разошёлся бы с первым молча. Оба лежат в scripts/ и в чужой проект не
+# уезжают, поэтому импорт между ними законен — но искать его надо здесь.
+search-path = ["scripts"]

scripts/resync.py

@@ -0,0 +1,145 @@
+#!/usr/bin/env python3
+"""Пересборка помеченных копий из их домов.
+
+`copies.py` ловит расхождение, но чинить его руками — та же работа, из-за
+которой копии и расходятся: правка дома касается семи файлов, и седьмой
+забывают. Здесь она делается машиной и потому дословна по построению.
+
+**В гейт коммита этот скрипт не ставится, и это решение, а не недосмотр.**
+Автоматическая пересборка на коммите протащила бы правку дома в семь файлов
+мимо глаз автора — а правка дома, чья копия уезжает в репозиторий проекта,
+обязана ещё и попасть в журнал версий канона. Гейт поэтому только **называет**
+расхождение, а согласие с ним остаётся действием человека.
+
+Разметку разбирает `copies.py` — он импортируется целиком. Второй разборщик той
+же разметки разошёлся бы с первым молча, и это ровно тот класс дефекта, против
+которого вся механика копий и заведена.
+
+**Ограда блока кода принадлежит месту, а не дому.** Тело `журнал-дефектов-форма`
+живёт в доме внутри ```, а в скелете канона лежит внутри чужой, объемлющей
+ограды — и своей там иметь не должно. Поэтому при пересборке берётся тело дома
+без крайних оград, а обратно надевается **та ограда, что была у копии**.
+
+    resync.py [корень]
+
+Коды выхода — общий словарь скриптов av-dev:
+  0  готово (в том числе «нечего пересобирать»)
+  2  ошибка употребления: незакрытый маркер, дубль id, копия без дома
+  3  окружение: не тот каталог
+  4  внутренний сбой
+"""
+
+from __future__ import annotations
+
+import sys
+from pathlib import Path
+
+import copies
+from copies import ENV, INTERNAL, OK, USAGE, Region
+
+
+def edges(body: list[str]) -> tuple[list[str], list[str]]:
+    """Ограда копии, если она есть: её надевают обратно на тело дома."""
+    trimmed = [ln.rstrip() for ln in body]
+    while trimmed and not trimmed[0]:
+        trimmed.pop(0)
+    while trimmed and not trimmed[-1]:
+        trimmed.pop()
+    if len(trimmed) >= 2 and trimmed[0].startswith("```") and trimmed[-1].startswith("```"):
+        return [trimmed[0]], [trimmed[-1]]
+    return [], []
+
+
+def rebuild(path: Path, targets: list[tuple[Region, Region, str]]) -> None:
+    """Переписать тела копий в одном файле, идя снизу вверх по номерам строк."""
+    lines = path.read_text(encoding="utf-8").splitlines()
+    for copy, home, home_rel in sorted(targets, key=lambda t: -t[0].line):
+        head, tail = edges(copy.body)
+        # Пустые строки по краям сверке не подлежат и потому принадлежат месту:
+        # у копии внутри объемлющей ограды их нет, у копии в прозе — есть.
+        # Ставим их так, как стояло, иначе пересборка правит и то, чего не
+        # чинила, и дифф перестаёт читаться.
+        lead = [""] if copy.body and not copy.body[0].strip() else []
+        trail = [""] if copy.body and not copy.body[-1].strip() else []
+        body = [*head, *home.normalized(), *tail]
+        start = copy.line - 1               # строка открывающего маркера
+        end = start + len(copy.body) + 1    # строка закрывающего
+        lines[start:end + 1] = [
+            f"<!-- копия: {copy.ident} из {home_rel} -->",
+            *lead, *body, *trail,
+            f"<!-- /копия: {copy.ident} -->",
+        ]
+    path.write_text("\n".join(lines) + "\n", encoding="utf-8")
+
+
+def main() -> int:
+    root = Path(sys.argv[1] if len(sys.argv) > 1 else ".").resolve()
+    if not (root / ".claude-plugin").is_dir():
+        print(f"ОТКАЗ: {root} не похож на корень маркетплейса: нет .claude-plugin/",
+              file=sys.stderr)
+        return ENV
+
+    errors: list[str] = []
+    homes: dict[str, Region] = {}
+    by_file: dict[Path, list[Region]] = {}
+    for path in copies.walk(root):
+        file_homes, file_copies = copies.scan(path, errors)
+        for h in file_homes:
+            if h.ident in homes:
+                errors.append(f"{h.where}: дом «{h.ident}» уже объявлен"
+                              f" в {homes[h.ident].where} — id обязан быть один")
+                continue
+            homes[h.ident] = h
+        if file_copies:
+            by_file[path] = file_copies
+
+    for file_copies in by_file.values():
+        for c in file_copies:
+            if c.ident not in homes:
+                errors.append(f"{c.where}: копия «{c.ident}» без дома —"
+                              f" дом либо не помечен, либо переименован")
+
+    if errors:
+        for e in errors:
+            print(f"УПОТРЕБЛЕНИЕ  {e}", file=sys.stderr)
+        print("\nПересборка не начата: разметка сломана, и починка её не лечит.",
+              file=sys.stderr)
+        return USAGE
+
+    total, touched = 0, 0
+    for path, file_copies in sorted(by_file.items()):
+        targets = []
+        for c in file_copies:
+            home = homes[c.ident]
+            home_rel = home.path.relative_to(root).as_posix()
+            total += 1
+            same_text = c.normalized() == home.normalized()
+            same_addr = bool(c.declared_home) and home_rel.endswith(
+                c.declared_home.lstrip("./"))
+            if same_text and same_addr:
+                continue
+            targets.append((c, home, home_rel))
+        if not targets:
+            continue
+        rebuild(path, targets)
+        touched += len(targets)
+        rel = path.relative_to(root).as_posix()
+        print(f"{rel}: пересобрано {len(targets)} —"
+              f" {', '.join(t[0].ident for t in targets)}")
+
+    print(f"копий {total}, домов {len(homes)}; пересобрано {touched}")
+    if touched:
+        print("\nПрочитай дифф перед коммитом. Копия, уезжающая в репозиторий "
+              "проекта, тянет ещё и запись в журнал версий канона — её машина "
+              "не напишет.")
+    return OK
+
+
+if __name__ == "__main__":
+    try:
+        sys.exit(main())
+    except KeyboardInterrupt:
+        sys.exit(INTERNAL)
+    except Exception as e:  # noqa: BLE001 — последний рубеж, код 4 по словарю
+        print(f"внутренний сбой ({type(e).__name__}): {e}", file=sys.stderr)
+        sys.exit(INTERNAL)