opencode-orchestrator-uni 0.2.0 → 0.3.0

package/docs/ru/call-mechanics.md

@@ -110,15 +110,20 @@ subagent({
 ### Фаза 5. Правки и повтор
 - Правки начинаются только после фиксации вердикта свода (и верификации/арбитража). До вердикта — не править.
 - Правки по порогу: микроправки (1–3 строки, тексты/доки) — root сам; средние/крупные (мультифайл, логика, тесты) — субагент `fix-runner`; спорное до делегирования решает root (после арбитра).
+- Несколько `fix-runner` параллельно — только в отдельных рабочих пространствах, и только когда их **наборы файлов** не могут пересечься. Норма безусловна: «писатель один на рабочее пространство; не запускай двух писателей, чьи **наборы файлов** могут пересечься» (даже в разных пространствах). Непересечение считается по файлам (пути + правило поиска однотипных мест класса), а не по id списка; пересечение наборов ⇒ сериализация фиксеров либо разнесение путей.
+- Рабочее пространство фиксера — git worktree **вне дерева проекта** со своей веткой: основной путь `git worktree add -b fix/<round>-<n> <путь> <base>`; `worktree_create` — только с немедленным `git switch -c fix/<round>-<n>` (detached HEAD для сведения не годится). Посадка сессии: `session_move({sessionID, directory})`, если инструмент доступен, иначе `cd <абс. путь>` и абсолютные пути; если ни то ни другое недоступно — параллельный запуск запрещён.
+- Сведение — строго по **полному hex SHA** из отчёта: `commit` принимается только как полный hex SHA — проверка `^[0-9a-f]{40}$` ДО любых git-команд (`git check-ref-format --branch` барьером НЕ является: refname пропускает `; & | > # $()` и backticks; `git rev-parse --verify '<x>^{commit}'` тоже резолвит имена). SHA передаётся в команды **отдельным аргументом в кавычках** (`git cat-file -t "$sha"`); строки из отчётов в shell-слова не подставлять. Имена веток из отчётов для сведения не использовать вовсе; если всё же нужны — только строгий шаблон `^fix/[A-Za-z0-9][A-Za-z0-9._-]*$` + кавычки. Семантические проверки перед сведением: `git cat-file -t <sha>` = `commit` (после hex-проверки); `git merge-base --is-ancestor <base> <sha>` (sha — потомок base); `git diff --quiet <base> <sha>` должно быть **ложно** (дельта непуста); `<sha> != <base>`. `Already up to date` (пустая дельта) ⇒ статус **`not_consolidated`**, не `closed`; нет `commit` или `workspace` в отчёте ⇒ **`not_closed`** (precondition root'а). Ветку/коммиты без отчёта `closed` не сливать; `closed` и доказательство приёмки (after/stand) — на сведённом commit SHA; worktree не удалять до подтверждённого переноса коммита, после — `git worktree remove --force` и осознанное решение по ветке. Отчёт не пришёл (`no_report`: фиксер упал/таймаут) — root фиксирует в своде работу (worktree, ветка, base SHA) и `no_report`; приоритет — resume в том же worktree, иначе убрать worktree и решить судьбу ветки; частичный коммит без отчёта в основную ветку не вливается.
 - Вызов фиксера:
 ```
 subagent({agent:"fix-runner", prompt:"К закрытию:\n1) <id | локация | механизм |
  класс/область (пути + правило поиска однотипных мест) | repro-до |
- критерий-после | severity>\nГраницы: <пути/ветка>; бюджет/лимит: <время, число
- правок>; коммит: <да/нет, сообщение fix-<round>>. Верни fix-runner/v1."})
+ критерий-после | severity>\nГраницы: набор файлов: <пути>; рабочее пространство:
+ <абс. путь worktree вне дерева проекта>; ветка: fix/<round>-<n>; base: <sha>;
+ бюджет/лимит: <время, число правок>; коммит: <да/нет, сообщение fix-<round>>.
+ Верни fix-runner/v1."})
 ```
-- Root проверяет дельту (`git show --stat` + ключевой прогон) до re-audit и обновляет реестр.
-- Стенд раунда (если в комплекте поставляется проверочный стенд — инструменты `tools/kit-verify` (верификатор) и `tools/kit-sync` (синк копий + снимок) каталога комплекта; в раундах по другим проектам — только если стенд явно включён в границы вызова): baseline → правки → синк копий и повторный прогон стенда; дельта baseline→after прикладывается к отчёту (поле `stand`).
+- Root проверяет дельту (`git diff <round-base>..HEAD --stat` + ключевой прогон) до re-audit и обновляет реестр.
+- Стенд раунда (если в комплекте поставляется проверочный стенд — инструмент `tools/kit-verify` (верификатор) каталога комплекта; в раундах по другим проектам — только если стенд явно включён в границы вызова): baseline → правки → повторный прогон стенда; дельта baseline→after прикладывается к отчёту (поле `stand`). Стенд поставляется в git-чекауте комплекта: в npm-пакете каталог `tools/` не поставляется → `stand: unavailable` и собственные воспроизводимые проверки.
 - **re-audit = resume тех же сессий**:
 ```
 subagent({agent:"empiric", sessionID:<emp>, background:true,
@@ -165,7 +170,7 @@ subagent({agent:"redteam", background:true,
 | пара → root | полные SGR-отчёты | JSON-блоки |
 | root → арбитр | только спорные пункты + evidence обеих сторон | список |
 | root → верификатор | находка MAJOR (id, текст, evidence автора, ревизия состояния) | текст |
-| root → fix-runner | список «к закрытию» (id, локация, класс/область, repro-до, критерий-после, severity) + границы/бюджет | текст |
+| root → fix-runner | список «к закрытию» (id, локация, класс/область, repro-до, критерий-после, severity) + границы (набор файлов, рабочее пространство, ветка, base) и бюджет | текст |
 | root → re-audit | дельта правок + фактический список изменённых файлов + список закрытого | текст |
 | root → redteam | заявка + свод всех кругов | текст |
 | redteam → root | SGR | JSON |
@@ -194,6 +199,7 @@ subagent({agent:"redteam", background:true,
 ## 5. Отказы и восстановление
 
 - Субагент упал/прерван → resume с «продолжи с места остановки, не переделывай»; при `Agent not found` — проверить файлы агентов. Источники не смешивать: определения агентов — каталог комплекта (`agents/`), копии — глобальный каталог агентов вашего харнесса (путь зависит от ОС) и проектный каталог агентов харнесса; снимок/восстановление конфигурации — `tools/config-guard` (хранитель конфигурации комплекта, если поставляется), не агенты.
+- Повторный запуск фиксера после инцидента в том же пространстве — resume в том же worktree либо явное удаление/переименование ветки решением root'а (повторный `git worktree add -b fix/<round>-<n>` падает, пока ветка занята); `locked` worktree — `git worktree unlock` либо `git worktree remove -f -f`.
 - Модель/провайдер недоступны → подождать/сменить модель по решению владельца, сессии сохранить.
 - Ограниченная среда (Code Mode: действия только через `execute`+каталог, `subagent` недоступен) → аудиторский цикл не запускается; итог — «готово; штатный аудит отложен» с ревизией и планом прогона (§8).
 - `arbiter` недоступен или бюджет исчерпан → root разбирает спорный пункт поштучно по фактам/цитатам и фиксирует как риск и эскалирует владельцу.
@@ -216,7 +222,8 @@ subagent({agent:"redteam", background:true,
 
 ## 7. Инварианты процесса
 
-- root не аудирует и не подменяет вердикты; писатель в каждый момент один: root (микроправки) или `fix-runner` (средние/крупные).
+- root не аудирует и не подменяет вердикты; писатель один **на рабочее пространство**: root (микроправки) или `fix-runner` (средние/крупные); несколько `fix-runner` — параллельно только в отдельных worktree и с последующим сведением root'ом.
+- Не запускай двух писателей, чьи **наборы файлов** могут пересечься, — безусловно, независимо от рабочего пространства: непересекающиеся списки «к закрытию» не заменяют проверку пересечения наборов файлов (пути + правило поиска класса).
 - Аудиторы read-only; проектная конкретика — только в брифе.
 - Правки начинаются только после фиксации вердикта свода (и верификации MAJOR/арбитража). До вердикта — не править.
 - MAJOR-находки входят в правки только после независимой верификации (Фаза 3.5); дефолт верификатора — «не подтверждена» (fail-closed).

package/docs/ru/instruction-other-session.md

@@ -27,7 +27,7 @@
 Режим: <РЕЖИМ>
 
 Правила контура:
-- Аудиторы — read-only субагенты; правки вносишь ты (микроправки) или делегируешь `fix-runner` (средние/крупные). Ты — оркестратор: бриф, запуск, свод отчётов, решения, правки. Сам не аудируешь.
+- Аудиторы — read-only субагенты; правки вносишь ты (микроправки) или делегируешь `fix-runner` (средние/крупные). Ты — оркестратор: бриф, запуск, свод отчётов, решения, правки. Сам не аудируешь. Несколько `fix-runner` — только в отдельных worktree **вне дерева проекта** со своей веткой `fix/<round>-<n>`, и только без пересечения **наборов файлов** (пересечение наборов root считает до запуска ⇒ сериализация или разнесение путей); сессию фиксера сажай в её пространство (`session_move`, иначе `cd` + абсолютные пути; ни то ни другое — параллельный запуск запрещён), своди результаты строго по полному hex SHA из отчёта (проверка `^[0-9a-f]{40}$` до git-команд; имена веток из отчётов для сведения не использовать; SHA — отдельным аргументом в кавычках) и прогоняй проверки на сведённом состоянии.
 - Общение — через бриф-файл и SGR-отчёты. Фоновых субагентов НЕ поллить: уведомления приходят сами.
 - Цикл живёт до ПОЛНОГО ready: все роли ready, открытых MAJOR нет, MINOR/NIT закрыты или явно приняты.
 - Спорное решает `arbiter` (только спорные пункты); недоказуемое → решение владельца: root оформляет вопрос, фиксирует риск и эскалирует.
@@ -49,7 +49,7 @@
    partial/unavailable = «не подтверждена»; сбой/таймаут верификатора — то же + шум. Опровергнутые — в список refuted; статусы пиши в свод reports/summary-<id>.md; неподтверждённая MAJOR в правки не идёт.
    Конфликты → subagent(agent="arbiter", prompt="Спорные пункты: <пункт → evidence A → evidence B>. По каждому: подтверждён/опровергнут/недоказуем + призма (reproducibility|contract|falsification|not_applicable; несколько — массив) + способ проверки. Только эти пункты.")
    Вердикт свода (и верификация/арбитраж) фиксируются ДО правок и вместе с ревизией состояния (хэш/коммит); правка после фиксации вердикта → повторный прогон (re-audit) либо явное понижение вердикта: до вердикта — не править.
-5) Правки по порогу: микроправки — сам; средние/крупные — subagent(agent="fix-runner", prompt="К закрытию: <id | локация | механизм | класс/область (пути + правило поиска однотипных мест) | repro-до | критерий-после>. Границы: <…>; бюджет/лимит: <время, число правок>; коммит fix-<round>. Верни fix-runner/v1."). Перед re-audit проверь дельту (git show --stat + ключевой прогон); обнови risks.md (closed / accepted-risk с причиной).
+5) Правки по порогу: микроправки — сам; средние/крупные — subagent(agent="fix-runner", prompt="К закрытию: <id | локация | механизм | класс/область (пути + правило поиска однотипных мест) | repro-до | критерий-после>. Границы: набор файлов: <пути>; worktree: <абс. путь вне дерева проекта>; ветка: fix/<round>-<n>; base: <sha>; бюджет/лимит: <время, число правок>; коммит fix-<round>. Верни fix-runner/v1."). Перед re-audit проверь дельту (git diff <round-base>..HEAD --stat + ключевой прогон) и сведение по полному hex SHA (^[0-9a-f]{40}$ до git-команд + git cat-file -t <sha> = commit, git merge-base --is-ancestor <base> <sha>, непустая дельта: git diff --quiet <base> <sha> ложно; пустая дельта / Already up to date ⇒ not_consolidated, не closed); обнови risks.md (closed / accepted-risk с причиной).
 6) Re-audit — resume ТЕХ ЖЕ сессий (background, один блок):
    subagent(agent="empiric",   sessionID="<emp>", background=true, prompt="Правки: <диапазон + фактический список изменённых файлов>; закрыто: <…>. Проверь закрытие своих находок и отсутствие регрессий на новом состоянии; верни обновлённый SGR.")
    subagent(agent="invariant", sessionID="<inv>", background=true, prompt="… то же …")

package/docs/ru/process-ready-loop.md

@@ -22,6 +22,8 @@
      │         для коммита/PR: SHIP, если правок после вердикта не было (ред-тим и мета не обязательны)
      └─ НЕТ ─► [2] ПРАВКИ (закрыть MAJOR; MINOR/NIT — закрыть или явно принять с обоснованием, запись в risks-<id>.md)
                 ▼
+           [2a] СВЕДЕНИЕ (если фиксеров было несколько: сведение веток по commit SHA → проверки на сведённом состоянии)
+                ▼
            [3] НОВОЕ СОСТОЯНИЕ X1 (фиксы закоммичены/зафиксированы)
                 ▼
            повтор [1] на X1 (оба аудитора, тот же бриф)
@@ -39,7 +41,7 @@
 1. Все роли (эмпирик, инвариантщик; на воротах — и ред-тим) — `verdict=ready`.
 2. Открытых MAJOR нет. MINOR/NIT: закрыты либо **явно приняты** с причиной (запись в `risks-<id>.md`; в сводке/PR: «принято как долг: …»).
 3. Все расхождения разрешены арбитром; недоказуемое → решение владельца: root оформляет вопрос, фиксирует риск и эскалирует.
-4. Повторный прогон идёт **по состоянию после правок**, а не по старому диффу. Никаких «переголосований» на том же снапшоте.
+4. Повторный прогон идёт **по состоянию после правок**, а не по старому диффу. Никаких «переголосований» на том же снапшоте. При нескольких фиксерах X1 достигается сведением их веток по commit SHA и проверками на сведённом состоянии; `closed` ставится после сведения.
 5. На релизных воротах — `meta` = pass (`gate`=pass), `closing_list` пуст/закрыт, `coverage_gaps` приняты владельцем (запись в `risks-<id>.md`). **SHIP ⟺ `meta.gate`=pass ∧ `closing_list` пуст/закрыт ∧ `coverage_gaps` приняты владельцем (запись в `risks-<id>.md`); иначе ship запрещён.**
 6. MAJOR-находки входят в правки только после независимой верификации; дефолт верификатора — «не подтверждена» (fail-closed).
 7. Вердикт и верификация фиксируются вместе с ревизией состояния (хэш каталога/коммит); любая правка после фиксации вердикта → повторный прогон (re-audit) либо явное понижение вердикта.

package/docs/ru/root-runbook.md

@@ -26,8 +26,8 @@
 3. **Свод root'ом**: распарсить JSON-блоки; вычислить вердикты (ready/not_ready), открытые MAJOR, пересечения и расхождения (по location+механизму). Материализовать свод-артефакт `reports/summary-<id>.md` (определение — `call-mechanics.md` §4): по каждой MAJOR — {id, verifier_role, verdict, evidence}; refuted-список (явный, даже пустой); принятые риски; ревизия состояния (хэш каталога/коммит).
 4. **Верификация MAJOR (перекрёстная, fail-closed)**: каждая MAJOR-находка подтверждается независимо **сессией противоположной роли** (не автором находки) — `subagent(agent="<sibling>", sessionID=<сессия противоположной роли>, prompt="Находка <id> контрагента: <текст>. Evidence автора: <команда→вывод>. Ревизия состояния: <хэш каталога/коммит>. Подтверди или опровергни своим воспроизведением; дефолт — не подтверждена. Верни: {id, verifier_role, verdict: confirmed|refuted|partial|unavailable, evidence}.")`. `verifier_role` ≠ роль автора; `partial`/`unavailable` = «не подтверждена»; `refuted` — в список refuted для сводки; сбой/таймаут верификатора — «не подтверждена» + шум. Не подтверждена → в правки не идёт (спор → шаг 5, арбитр); статусы верификации пишутся в свод `reports/summary-<id>.md` (шаг 3). Если MAJOR-находка независимо воспроизведена обеими ролями в их собственных прогонах — взаимное подтверждение засчитывается как верификация (обе стороны в свод), отдельный прогон не требуется. sessionID при вызове обязателен: без него это новая сессия, а не продолжение — дефект шага.
 5. **Арбитр — только при расхождениях**: `subagent(agent="arbiter", prompt="Спорные пункты: <пункт → evidence A → evidence B>. По каждому: подтверждён/опровергнут/недоказуем + команда/цитата.")`. Вердикт свода (и верификация/арбитраж) фиксируются ДО правок и **вместе с ревизией состояния** (хэш каталога/коммит); любая правка после фиксации вердикта → повторный прогон (re-audit) либо явное понижение вердикта: до вердикта — не править.
-6. **Правки** по порогу: микро — root сам; средние/крупные — `fix-runner` (вход: список «к закрытию» — id, локация, механизм, **класс/область** (пути + правило поиска однотипных мест), repro-до, критерий-после, severity — плюс границы и **бюджет/лимит (время, число правок)**; выход: fix-runner/v1 с before/after/`proof`/тестами). Отдельные коммиты `fix-<round>`; обновить реестр: `closed` / `accepted-risk` (с причиной). Root проверяет дельту до re-audit. Стенд раунда (если в комплекте поставляется проверочный стенд — инструменты `tools/kit-verify` и `tools/kit-sync` каталога комплекта; в раундах по другим проектам — только если стенд явно включён в границы вызова): baseline стенда в промпт фиксера (если вывод передан — фиксер не дублирует прогон); закрытие — синк копий и повторный прогон стенда; оба вывода — в поле `stand` отчёта. Статусы `fix-runner`: `needs_decision` → решение root (при споре — арбитр; если решение за владельцем — эскалация) с фиксацией в реестре рисков; `not_closed` → повторная итерация с тем же id; поле `out_of_scope` (замечено вне списка) → включить в следующий список «к закрытию» или эскалировать.
-7. **Re-audit = resume те же сессии** (sessionID из шага 2): «Правки: <диапазон + фактический список изменённых файлов>. Проверь закрытие своих находок и отсутствие регрессий; верни обновлённый SGR.» — исторически так и делалось (продолжение сессий GLM/DS). sessionID обязателен: вызов без него (новая сессия вместо продолжения) — дефект шага.
+6. **Правки** по порогу: микро — root сам; средние/крупные — `fix-runner` (вход: список «к закрытию» — id, локация, механизм, **класс/область** (пути + правило поиска однотипных мест), repro-до, критерий-после, severity — плюс границы и **бюджет/лимит (время, число правок)**; выход: fix-runner/v1 с before/after/`proof`/тестами). Отдельные коммиты `fix-<round>`; обновить реестр: `closed` / `accepted-risk` (с причиной). Root проверяет дельту раунда — `git diff <round-base>..HEAD --stat` (не только `git show --stat`) — до re-audit. Стенд раунда (если в комплекте поставляется проверочный стенд — инструмент `tools/kit-verify` каталога комплекта; в раундах по другим проектам — только если стенд явно включён в границы вызова): baseline стенда в промпт фиксера (если вывод передан — фиксер не дублирует прогон); закрытие — повторный прогон стенда; оба вывода — в поле `stand` отчёта. Стенд поставляется в git-чекауте комплекта: в npm-пакете каталог `tools/` не поставляется → `stand: unavailable` и собственные воспроизводимые проверки. Статусы `fix-runner`: `needs_decision` → решение root (при споре — арбитр; если решение за владельцем — эскалация) с фиксацией в реестре рисков; `not_closed` → повторная итерация с тем же id; `budget_exceeded` → расширить бюджет решением владельца либо разбить список и продолжить с того же id (коммиты и worktree сохранить до закрытия или уборки); поле `out_of_scope` (замечено вне списка) → включить в следующий список «к закрытию» или эскалировать. Статус **`no_report`** (отчёта нет: фиксер упал/таймаут) — root фиксирует в своде выполненную работу (worktree, ветка, base SHA) и `no_report`; ветку/коммиты НЕ сливать; приоритет — resume в том же worktree; иначе убрать: `git worktree remove --force` и решить судьбу ветки. Частичный коммит без отчёта в основную ветку не вливается. Несколько `fix-runner` — только в отдельных worktree **вне дерева проекта** (у каждого своя ветка `fix/<round>-<n>`); путь пространства сверяется префиксами путей (`git -C <project> rev-parse --show-toplevel` не должен быть префиксом канонического пути пространства; иначе — `needs_decision`, пространство не создаётся и не используется); перед запуском root считает пересечение **наборов файлов** (пути + правило поиска класса), а не только списков: пересечение ⇒ сериализация или разнесение путей. Посадка сессии в её пространство: `session_move({sessionID, directory})` (если доступен), иначе `cd <абс. путь>` + абсолютные пути; ни то ни другое — параллельный запуск запрещён. В свежем worktree зависимости ставятся до прогонов (`npm ci` / `bun install`). После завершения root сводит результаты строго по **полному hex SHA** из отчёта: `commit` принимается только как `^[0-9a-f]{40}$` — проверка ДО любых git-команд (имена веток из отчётов для сведения не использовать; `check-ref-format` и `rev-parse --verify` барьером не являются — резолвят имена); SHA — отдельным аргументом в кавычках; семантические проверки: `git cat-file -t <sha>` = `commit`, `git merge-base --is-ancestor <base> <sha>`, `git diff --quiet <base> <sha>` ложно (дельта непуста), `<sha> != <base>`; `Already up to date` (пустая дельта) ⇒ `not_consolidated`, не `closed`; merge/cherry-pick по SHA, прогоняет проверки на сведённом состоянии и только тогда фиксирует `closed`; worktree не удалять до подтверждённого переноса коммита, после — `git worktree remove --force` и осознанное решение по ветке; повторный запуск после инцидента — resume в том же worktree либо явное удаление/переименование ветки решением root'а (повторный `git worktree add -b` падает при занятой ветке), `locked` worktree — `git worktree unlock` либо `git worktree remove -f -f`.
+7. **Re-audit = resume те же сессии** (sessionID из шага 2): «Правки: <диапазон + фактический список изменённых файлов>. Проверь закрытие своих находок и отсутствие регрессий; верни обновлённый SGR.» — исторически так и делалось (продолжение сессий GLM/DS). sessionID обязателен: вызов без него (новая сессия вместо продолжения) — дефект шага. Re-audit и `closed` — на **сведённом** состоянии: доказательство приёмки (after/stand) перепривязывается к сведённому commit SHA; `closed` без отчёта фиксера (`no_report`) запрещён; нет ключа `commit` или `workspace` в отчёте фиксера ⇒ `not_closed`.
 8. **Повторяй шаги 3–7, пока не достигнут полный ready** (число кругов не ограничено; все роли ready, MAJOR=0). С 3-го круга нерешённые пункты — арбитр поштучно; повторяющиеся ложные — снять и записать как шум аудита.
 9. **Ворота (релиз; порядок: ред-тим → мета)**: замороженный коммит → `redteam` (мандат фальсификации + корпуса/стенды) → цикл по его находкам (MAJOR — с верификацией сессией противоположной роли) → `meta` (на вход: отчёты + свод `reports/summary-<id>.md`; evidence, полнота, отсутствие «зелёные тесты = проверено»).
    - **SHIP ⟺ `meta.gate`=pass ∧ `closing_list` пуст/закрыт ∧ `coverage_gaps` приняты владельцем (запись в `risks-<id>.md`); иначе ship запрещён.**
@@ -41,7 +41,7 @@
 - root → re-audit: диапазон правок + краткое «что закрыто»;
 - root → ред-тим: заявка автора + свод всех предыдущих кругов (объект фальсификации);
 - root → мета: отчёты (пути) + свод `reports/summary-<id>.md`;
-- root → fix-runner: список «к закрытию» (с классом/областью) + границы + бюджет/лимит (время, число правок).
+- root → fix-runner: список «к закрытию» (с классом/областью) + границы (включая **набор файлов**, worktree вне дерева проекта, ветку `fix/<round>-<n>`, base SHA) + бюджет/лимит (время, число правок); при параллельном запуске — каждому отдельное пространство и ветка, а наборы файлов root проверяет на пересечение до запуска;
 
 ## Тонкости
 

package/lib/tools.ts

@@ -46,25 +46,76 @@ interface SchemaDocument {
   readonly schema: JsonSchemaNode
 }
 
+function errorMessage(error: unknown): string {
+  return error instanceof Error ? error.message : String(error)
+}
+
+/**
+ * Typed failure of the schema registry (`schemas/*.json`): an unreadable
+ * directory, an unreadable file, malformed JSON or a document of the wrong
+ * shape. `loadSchemas` throws it on purpose — otherwise the plugin would
+ * validate against a silently smaller registry — and the `validate_report`
+ * executor converts it into an `E_SCHEMA_IO` refusal, so a caller always gets a
+ * structured code plus the directory/file instead of a raw IO/parse exception.
+ */
+export class SchemaIoError extends Error {
+  readonly code = "E_SCHEMA_IO"
+  readonly directory: string
+  readonly file: string | undefined
+
+  constructor(message: string, directory: string, file?: string) {
+    super(message)
+    this.name = "SchemaIoError"
+    this.directory = directory
+    this.file = file
+  }
+}
+
 /**
  * Read every `schemas/*.json` file into an id → schema map. Files are read in
- * sorted order; a malformed document throws (the plugin would otherwise
- * validate against a silently smaller registry).
+ * sorted order; a malformed document throws a `SchemaIoError` (fail-closed, typed).
  */
 export async function loadSchemas(directory: string = SCHEMAS_DIRECTORY): Promise<Map<string, JsonSchemaNode>> {
-  const entries = await readdir(directory, { withFileTypes: true })
-  const files = entries
-    .filter((entry) => entry.isFile() && entry.name.endsWith(".json"))
-    .map((entry) => entry.name)
-    .sort()
+  let names: string[]
+  try {
+    const entries = await readdir(directory, { withFileTypes: true })
+    names = entries
+      .filter((entry) => entry.isFile() && entry.name.endsWith(".json"))
+      .map((entry) => entry.name)
+      .sort()
+  } catch (error) {
+    throw new SchemaIoError(`cannot read schemas directory ${directory}: ${errorMessage(error)}`, directory)
+  }
   const schemas = new Map<string, JsonSchemaNode>()
-  for (const file of files) {
-    const source = await readFile(path.join(directory, file), "utf8")
-    const document = JSON.parse(source) as SchemaDocument
-    if (typeof document.id !== "string" || typeof document.schema !== "object" || document.schema === null) {
-      throw new Error(`schemas/${file}: expected { id: string, schema: object }`)
+  for (const file of names) {
+    const absolute = path.join(directory, file)
+    let source: string
+    try {
+      source = await readFile(absolute, "utf8")
+    } catch (error) {
+      throw new SchemaIoError(`cannot read schemas/${file} (${absolute}): ${errorMessage(error)}`, directory, absolute)
+    }
+    let parsed: unknown
+    try {
+      parsed = JSON.parse(source)
+    } catch (error) {
+      throw new SchemaIoError(
+        `schemas/${file} (${absolute}) is not valid JSON: ${errorMessage(error)}`,
+        directory,
+        absolute,
+      )
+    }
+    const document = asRecord(parsed) as Partial<SchemaDocument> | undefined
+    const id = document?.id
+    const schema = document?.schema
+    if (typeof id !== "string" || typeof schema !== "object" || schema === null) {
+      throw new SchemaIoError(
+        `schemas/${file} (${absolute}): expected { id: string, schema: object }`,
+        directory,
+        absolute,
+      )
     }
-    schemas.set(document.id, document.schema)
+    schemas.set(id, schema as JsonSchemaNode)
   }
   return schemas
 }
@@ -298,13 +349,24 @@ export function resolveRoot(directory: string, input: string): string {
   return path.isAbsolute(input) ? path.normalize(input) : path.resolve(directory, input)
 }
 
+/** Optional seams for tests; the plugin calls this with no options. */
+export interface RegisterAuditToolsOptions {
+  /** Directory to read `schemas/*.json` from. Defaults to the shipped `schemas/`. */
+  readonly schemasDirectory?: string
+}
+
 /**
- * Register the audit tools on the plugin context. Loading the schemas and the
- * session index happens before the transform callback, because transforms are
- * synchronous and the executors must close over complete, immutable state.
+ * Register the audit tools on the plugin context. The session index is loaded
+ * before the transform callback, because transforms are synchronous; the report
+ * schemas are not: they are re-read on every `validate_report` call, so a schema
+ * edited while the plugin is live is applied without a reload (a price of a few
+ * small JSON reads per validation).
  */
-export async function registerAuditTools(context: Plugin.Context): Promise<() => void> {
-  const schemas = await loadSchemas()
+export async function registerAuditTools(
+  context: Plugin.Context,
+  options: RegisterAuditToolsOptions = {},
+): Promise<() => void> {
+  const schemasDirectory = options.schemasDirectory ?? SCHEMAS_DIRECTORY
   const directory = context.location.directory
   const session = context.session
   const index = new SessionIndex(context.storage)
@@ -337,6 +399,20 @@ export async function registerAuditTools(context: Plugin.Context): Promise<() =>
       }
     }
     if (toolContext.signal.aborted) return failure("E_ABORTED", "validation aborted")
+    let schemas: Map<string, JsonSchemaNode>
+    try {
+      schemas = await loadSchemas(schemasDirectory)
+    } catch (error) {
+      if (error instanceof SchemaIoError) {
+        return failure(error.code, error.message, {
+          directory: error.directory,
+          ...(error.file === undefined ? {} : { file: error.file }),
+        })
+      }
+      return failure("E_SCHEMA_IO", `cannot load schemas from ${schemasDirectory}: ${errorMessage(error)}`, {
+        directory: schemasDirectory,
+      })
+    }
     const report = checkReport(source, { ...(expectedSchema === undefined ? {} : { expectedSchema }), schemas })
     return json(report)
   }
@@ -479,7 +555,7 @@ export async function registerAuditTools(context: Plugin.Context): Promise<() =>
       description:
         "Validate an SGR report: extract the last ```json block, resolve its schema, validate it and list prompt-level warnings. " +
         "Read-only. Returns JSON {valid, schema, errors, warnings} or a typed code " +
-        "(E_INPUT|E_NO_JSON|E_PARSE|E_UNKNOWN_SCHEMA|E_SCHEMA_MISMATCH|E_INVALID|E_ABORTED).",
+        "(E_INPUT|E_NO_JSON|E_PARSE|E_UNKNOWN_SCHEMA|E_SCHEMA_MISMATCH|E_INVALID|E_SCHEMA_IO|E_ABORTED).",
       input: VALIDATE_REPORT_INPUT,
       options: { namespace: TOOL_NAMESPACE, codemode: true },
       execute: validateReport,

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "opencode-orchestrator-uni",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Native OpenCode V2 plugin that registers the orchestrator agent kit (root orchestrator, audit subagents, fix-runner) and exposes the kit's process documents as the audit-kit reference.",
   "type": "module",
   "license": "MIT",
@@ -45,6 +45,7 @@
     "lint": "biome check .",
     "lint:fix": "biome check --write .",
     "check:locales": "bun tools/locale-check.ts",
+    "verify:kit": "bun tools/kit-verify.ts",
     "eval": "bun eval/run.ts",
     "eval:selfcheck": "bun eval/selfcheck.ts",
     "eval:recompute": "bun eval/recompute.ts"

package/schemas/fix-runner.v1.json

@@ -7,6 +7,15 @@
       "schema": { "type": "string", "const": "fix-runner/v1" },
       "round": { "type": "string" },
       "commit": { "type": ["string", "null"] },
+      "workspace": {
+        "type": "object",
+        "required": ["branch", "worktree", "base_commit"],
+        "properties": {
+          "branch": { "type": "string" },
+          "worktree": { "type": "string" },
+          "base_commit": { "type": "string" }
+        }
+      },
       "results": {
         "type": "array",
         "items": {
@@ -14,10 +23,7 @@
           "required": ["id", "status", "change", "before", "after", "proof", "stand", "tests"],
           "properties": {
             "id": { "type": "string" },
-            "status": {
-              "type": "string",
-              "enum": ["closed", "not_closed", "needs_decision", "budget_exceeded"]
-            },
+            "status": { "type": "string", "enum": ["closed", "not_closed", "needs_decision", "budget_exceeded"] },
             "change": { "type": "string" },
             "before": { "type": "string" },
             "after": { "type": "string" },
@@ -33,10 +39,7 @@
         "items": {
           "type": "object",
           "required": ["note", "why_suspicious"],
-          "properties": {
-            "note": { "type": "string" },
-            "why_suspicious": { "type": "string" }
-          }
+          "properties": { "note": { "type": "string" }, "why_suspicious": { "type": "string" } }
         }
       }
     }