opencode-orchestrator-uni 0.3.0 → 0.3.1

package/agents/en/arbiter.md

@@ -30,7 +30,7 @@ FORMAT (SGR): a summary + json:
   ]
 }
 
-Before submitting, if the `orch_uni_validate_report` tool is available, validate your JSON.
+Before submitting, if the `orch_uni_validate_report` tool is available, validate your JSON **as text** (`text`) and achieve `valid=true`; create files with the `write` tool, not a shell heredoc: on Windows a command over 32,767 characters is truncated and the heredoc hangs.
 
 CONSTRAINTS:
 - Read-only; change nothing; experiments — only in temporary directories.

package/agents/en/empiric.md

@@ -76,7 +76,7 @@ Fill-in rules:
 - contract_gaps — contract/reference gaps (what is not specified and why it is ambiguous); an empty array if there are no gaps; do not duplicate not_verified here.
 - The JSON must parse with a standard parser: no comments, no trailing commas, no text outside the block in the JSON itself.
 
-Before submitting, if the `orch_uni_validate_report` tool is available, validate your JSON (text or path) and achieve `valid=true`.
+Before submitting, if the `orch_uni_validate_report` tool is available, validate your JSON **as text** (`text`) and achieve `valid=true`; create files with the `write` tool, not a shell heredoc: on Windows a command over 32,767 characters is truncated and the heredoc hangs.
 
 CONSTRAINTS:
 - Change nothing in the audited repository: only reads and git objects. All experiments — in separate temporary directories outside the repository; clean up after yourself.

package/agents/en/factcheck.md

@@ -38,6 +38,6 @@ FACT-CHECK (for the auditors, ≤15 lines):
 
 Fill-in rules: verdict=stale — if at least one key claim is outdated; already_done — if the declared change is already implemented; the "FACT-CHECK" block — condensed: the current state, what is outdated, what is already done.
 
-Before submitting, if the `orch_uni_validate_report` tool is available, validate your JSON.
+Before submitting, if the `orch_uni_validate_report` tool is available, validate your JSON **as text** (`text`) and achieve `valid=true`; create files with the `write` tool, not a shell heredoc: on Windows a command over 32,767 characters is truncated and the heredoc hangs.
 
 CONSTRAINTS: read-only; do not commit, do not push, do not publish; the report is in English.

package/agents/en/fix-runner.md

@@ -53,7 +53,7 @@ REPORT FORMAT (SGR — mandatory): a short summary + json (when launched in a se
   ]
 }
 
-Before submitting, if the `orch_uni_validate_report` tool is available, validate your JSON.
+Before submitting, if the `orch_uni_validate_report` tool is available, validate your JSON **as text** (`text`) and achieve `valid=true`; create files with the `write` tool, not a shell heredoc: on Windows a command over 32,767 characters is truncated and the heredoc hangs.
 
 CONSTRAINTS:
 - No refactorings or "improvements" outside the list.

package/agents/en/invariant.md

@@ -71,7 +71,7 @@ Fill-in rules:
 - Empty arrays are allowed only when honestly justified; inventing data is forbidden.
 - The JSON must parse with a standard parser: no comments, no trailing commas, no text outside the block in the JSON itself.
 
-Before submitting, if the `orch_uni_validate_report` tool is available, validate your JSON (text or path) and achieve `valid=true`.
+Before submitting, if the `orch_uni_validate_report` tool is available, validate your JSON **as text** (`text`) and achieve `valid=true`; create files with the `write` tool, not a shell heredoc: on Windows a command over 32,767 characters is truncated and the heredoc hangs.
 
 CONSTRAINTS:
 - Change nothing in the audited repository; only reads and git objects. Experiments — in separate temporary directories, if needed.

package/agents/en/meta.md

@@ -41,7 +41,7 @@ FORMAT (SGR): a summary + json:
 
 `gate` — the **only blocking aggregate** (pass only when all reports pass, MAJOR findings are verified and `closing_list` is empty/closed); `verdict` is a synonym of `gate` (kept for compatibility, carries no separate meaning). The origin of `closing_list`: it is a **copy** of the red-team report's `closing_list` (ids of findings mandatory for closure; the red team is mandatory at the gates) — if the composition diverges from the red-team report, the meta issues a **fail**. `coverage_gaps` — what could not be checked; ship is allowed only with `gate`=pass and the owner's explicit acceptance of `coverage_gaps` (a record in `risks-<id>.md`).
 
-Before submitting, if the `orch_uni_validate_report` tool is available, validate your JSON.
+Before submitting, if the `orch_uni_validate_report` tool is available, validate your JSON **as text** (`text`) and achieve `valid=true`; create files with the `write` tool, not a shell heredoc: on Windows a command over 32,767 characters is truncated and the heredoc hangs.
 
 CONSTRAINTS:
 - Read-only; do not look for new code defects (reports only); do not edit the reports.

package/agents/en/orchestrator.md

@@ -31,7 +31,7 @@ The AUDIT MODE turns on when the task is to verify a change (diff/PR/range), a p
 - The fact-check returned `stale`/`already_done` → STOP, revise the task (do not start the pair).
 - re-audit = resuming the same sessions with a delta: fixes (range), the list of what was closed; the auditor re-checks its own findings and regressions on the new state; re-voting on the old snapshot is forbidden.
 - Invalid report: an empty/broken/unparseable report or a verdict outside the enum → a step defect: resume the same session and demand that the SGR be reissued; a repeated failure → escalation to the owner.
-- If the `orch_uni_*` tools are available: state revision → `orch_uni_snapshot` (aggregate — the directory hash for the verdict/verification); role report validation → `orch_uni_validate_report` (path or text; `valid=false` → resume the same session and demand that the SGR be reissued); sessionID/role/model/cost of the launched subagents → `orch_uni_sessions`; otherwise — manually, as before.
+- If the `orch_uni_*` tools are available: state revision → `orch_uni_snapshot` (aggregate — the directory hash for the verdict/verification); role report validation → `orch_uni_validate_report` (prefer `text`; files — `write`, not a shell heredoc: the Windows limit is 32,767; `valid=false` → resume the same session and demand that the SGR be reissued); sessionID/role/model/cost of the launched subagents → `orch_uni_sessions`; otherwise — manually, as before.
 - MAJOR verification (Phase 3.5): every MAJOR finding goes through an independent check by a role other than the author (resume the opposite role's session; `verifier_role` ≠ the author's role); include the state revision (directory hash/commit) in the verification prompt. The verifier's verdict: `{id, verifier_role, verdict: confirmed|refuted|partial|unavailable, evidence}`; `partial`/`unavailable` = "not confirmed" (fail-closed) — the finding does not go into fixes (dispute → arbiter); a verifier failure/timeout → `unavailable` + audit noise; `refuted` — into the refuted list of the summary; verification statuses are appended to the summary `reports/summary-<id>.md`.
 - Verifier calls (Phase 3.5) and re-audit — resume only the sessions of the respective roles: before the call, verify that the saved sessionID (from the launch response of the pair/role) has been passed; a call without a sessionID = a step defect (this is a new session, not a continuation): relaunch with the sessionID and note it in the summary.
 - If a MAJOR finding is independently reproduced by both roles in their own runs — this counts as cross-verification: record both sides in the summary (`verifier_role` of each role + evidence); a separate verifier run is not required.

package/agents/en/redteam.md

@@ -49,7 +49,7 @@ FORMAT (SGR): a summary + json:
 
 `claim_partial` — the claim is partially true, or another defect was found in its place. `claim_partial` with a discovered defect must produce an entry in `findings` (and in `closing_list` if the defect is blocking).
 
-Before submitting, if the `orch_uni_validate_report` tool is available, validate your JSON.
+Before submitting, if the `orch_uni_validate_report` tool is available, validate your JSON **as text** (`text`) and achieve `valid=true`; create files with the `write` tool, not a shell heredoc: on Windows a command over 32,767 characters is truncated and the heredoc hangs.
 
 CONSTRAINTS:
 - Read-only; mutations — only in temporary directories; do not change the sandbox/project.

package/agents/ru/arbiter.md

@@ -30,7 +30,7 @@ permissions:
   ]
 }
 
-Перед сдачей, если доступен инструмент `orch_uni_validate_report`, проверь свой JSON.
+Перед сдачей, если доступен инструмент `orch_uni_validate_report`, проверь свой JSON **текстом** (`text`) и добейся `valid=true`; файлы создавай инструментом `write`, не shell-heredoc: на Windows команда длиннее 32 767 символов обрезается, и heredoc зависает.
 
 ОГРАНИЧЕНИЯ:
 - Read-only; ничего не менять; эксперименты — только во временных каталогах.

package/agents/ru/empiric.md

@@ -76,7 +76,7 @@ permissions:
 - contract_gaps — пробелы контракта/эталона (что не задано и почему неоднозначно); пустой массив, если пробелов нет; не дублировать сюда not_verified.
 - JSON должен парситься стандартным парсером: без комментариев, без висячих запятых, без текста вне блока в самом JSON.
 
-Перед сдачей, если доступен инструмент `orch_uni_validate_report`, проверь свой JSON (текст или путь) и добейся `valid=true`.
+Перед сдачей, если доступен инструмент `orch_uni_validate_report`, проверь свой JSON **текстом** (`text`) и добейся `valid=true`; файлы создавай инструментом `write`, не shell-heredoc: на Windows команда длиннее 32 767 символов обрезается, и heredoc зависает.
 
 ОГРАНИЧЕНИЯ:
 - Ничего не менять в аудируемом репозитории: только чтение и git-объекты. Все эксперименты — в отдельных временных каталогах вне репозитория; после себя убирать.

package/agents/ru/factcheck.md

@@ -38,6 +38,6 @@ permissions:
 
 Правила заполнения: verdict=stale — если хотя бы один ключевой тезис устарел; already_done — если заявленное изменение уже реализовано; блок «ФАКТ-ЧЕК» — сжато: актуальное состояние, что устарело, что уже сделано.
 
-Перед сдачей, если доступен инструмент `orch_uni_validate_report`, проверь свой JSON.
+Перед сдачей, если доступен инструмент `orch_uni_validate_report`, проверь свой JSON **текстом** (`text`) и добейся `valid=true`; файлы создавай инструментом `write`, не shell-heredoc: на Windows команда длиннее 32 767 символов обрезается, и heredoc зависает.
 
 ОГРАНИЧЕНИЯ: read-only; не коммитить, не пушить, не публиковать; отчёт — по-русски.

package/agents/ru/fix-runner.md

@@ -53,7 +53,7 @@ permissions:
   ]
 }
 
-Перед сдачей, если доступен инструмент `orch_uni_validate_report`, проверь свой JSON.
+Перед сдачей, если доступен инструмент `orch_uni_validate_report`, проверь свой JSON **текстом** (`text`) и добейся `valid=true`; файлы создавай инструментом `write`, не shell-heredoc: на Windows команда длиннее 32 767 символов обрезается, и heredoc зависает.
 
 ОГРАНИЧЕНИЯ:
 - Никаких рефакторингов и «улучшений» вне списка.

package/agents/ru/invariant.md

@@ -71,7 +71,7 @@ permissions:
 - Пустые массивы допустимы только когда это честно обосновано; выдумывать данные запрещено.
 - JSON должен парситься стандартным парсером: без комментариев, без висячих запятых, без текста вне блока в самом JSON.
 
-Перед сдачей, если доступен инструмент `orch_uni_validate_report`, проверь свой JSON (текст или путь) и добейся `valid=true`.
+Перед сдачей, если доступен инструмент `orch_uni_validate_report`, проверь свой JSON **текстом** (`text`) и добейся `valid=true`; файлы создавай инструментом `write`, не shell-heredoc: на Windows команда длиннее 32 767 символов обрезается, и heredoc зависает.
 
 ОГРАНИЧЕНИЯ:
 - Ничего не менять в аудируемом репозитории; только чтение и git-объекты. Эксперименты — в отдельных временных каталогах, если нужны.

package/agents/ru/meta.md

@@ -41,7 +41,7 @@ permissions:
 
 `gate` — **единственный блокирующий агрегат** (pass только когда все отчёты pass, MAJOR-находки верифицированы и `closing_list` пуст/закрыт); `verdict` — синоним `gate` (оставлен для совместимости, отдельного смысла не несёт). Происхождение `closing_list`: это **копия** `closing_list` отчёта ред-тима (id находок, обязательных к закрытию; на воротах ред-тим обязателен) — при расхождении состава с отчётом ред-тима мета выносит **fail**. `coverage_gaps` — что не удалось проверить; ship допускается только при `gate`=pass и явном принятии `coverage_gaps` владельцем (запись в `risks-<id>.md`).
 
-Перед сдачей, если доступен инструмент `orch_uni_validate_report`, проверь свой JSON.
+Перед сдачей, если доступен инструмент `orch_uni_validate_report`, проверь свой JSON **текстом** (`text`) и добейся `valid=true`; файлы создавай инструментом `write`, не shell-heredoc: на Windows команда длиннее 32 767 символов обрезается, и heredoc зависает.
 
 ОГРАНИЧЕНИЯ:
 - Read-only; не искать новые дефекты кода (только отчёты); отчёты не править.

package/agents/ru/orchestrator.md

@@ -31,7 +31,7 @@ permissions:
 - Факт-чек вернул `stale`/`already_done` → СТОП, пересмотр задачи (пару не запускать).
 - re-audit = resume тех же сессий с дельтой: правки (диапазон), список закрытого; аудитор проверяет свои находки и регрессии на новом состоянии; переголосование по старому снапшоту запрещено.
 - Невалидный отчёт: пустой/битый/неразбираемый отчёт или вердикт вне enum → дефект шага: resume той же сессии с требованием перевыпустить SGR; повторный сбой → эскалация владельцу.
-- Если доступны инструменты `orch_uni_*`: ревизия состояния → `orch_uni_snapshot` (aggregate — хэш каталога для вердикта/верификации); проверка отчёта роли → `orch_uni_validate_report` (путь или текст; `valid=false` → resume той же сессии с требованием перевыпустить SGR); sessionID/роль/модель/стоимость запущенных субагентов → `orch_uni_sessions`; иначе — вручную, как прежде.
+- Если доступны инструменты `orch_uni_*`: ревизия состояния → `orch_uni_snapshot` (aggregate — хэш каталога для вердикта/верификации); проверка отчёта роли → `orch_uni_validate_report` (предпочтительно `text`; файлы — `write`, не shell-heredoc: Windows-лимит 32 767; `valid=false` → resume той же сессии с требованием перевыпустить SGR); sessionID/роль/модель/стоимость запущенных субагентов → `orch_uni_sessions`; иначе — вручную, как прежде.
 - Верификация MAJOR (Фаза 3.5): каждая MAJOR-находка проходит независимую проверку ролью, отличной от автора (resume сессии противоположной роли; `verifier_role` ≠ роль автора); в промпт верификации включай ревизию состояния (хэш каталога/коммит). Вердикт верификатора: `{id, verifier_role, verdict: confirmed|refuted|partial|unavailable, evidence}`; `partial`/`unavailable` = «не подтверждена» (fail-closed) — в правки не идёт (спор → арбитр); сбой/таймаут верификатора → `unavailable` + шум аудита; `refuted` — в refuted-список сводки; статусы верификации дописываются в свод `reports/summary-<id>.md`.
 - Вызовы верификатора (Фаза 3.5) и re-audit — только resume сессий соответствующих ролей: перед вызовом сверь, что передан сохранённый sessionID (из ответа запуска пары/роли); вызов без sessionID = дефект шага (это новая сессия, а не продолжение): перезапусти с sessionID и отметь в сводке.
 - Если MAJOR-находка независимо воспроизведена обеими ролями в их собственных прогонах — это засчитывается как перекрёстная верификация: зафиксируй в своде обе стороны (`verifier_role` каждой роли + evidence), отдельный прогон верификатора не требуется.

package/agents/ru/redteam.md

@@ -49,7 +49,7 @@ permissions:
 
 `claim_partial` — заявление верно частично либо вместо него найден другой дефект. `claim_partial` с обнаруженным дефектом обязан породить запись в `findings` (и в `closing_list`, если дефект блокирующий).
 
-Перед сдачей, если доступен инструмент `orch_uni_validate_report`, проверь свой JSON.
+Перед сдачей, если доступен инструмент `orch_uni_validate_report`, проверь свой JSON **текстом** (`text`) и добейся `valid=true`; файлы создавай инструментом `write`, не shell-heredoc: на Windows команда длиннее 32 767 символов обрезается, и heredoc зависает.
 
 ОГРАНИЧЕНИЯ:
 - Read-only; мутации — только во временных каталогах; песочницу/проект не менять.

package/docs/en/call-mechanics.md

@@ -192,7 +192,7 @@ Persistence (all kit documents): the SGR reports of all roles, including **the S
 ### The `orch_uni_*` tools (if registered by the plugin)
 
 - the state revision → `orch_uni_snapshot` (aggregate = the directory hash): recorded together with the verdict and the verification;
-- a role's report → `orch_uni_validate_report` (path or text): `valid=false` → a step defect, resume the same session and demand that the SGR be reissued; do not ignore `warnings`;
+- a role's report → `orch_uni_validate_report` (prefer `text`; files — `write`, not a shell heredoc: the Windows limit is 32,767): `valid=false` → a step defect, resume the same session and demand that the SGR be reissued; do not ignore `warnings`;
 - the roles' sessionIDs, their model and cost → `orch_uni_sessions`;
 - if the tools are unavailable, work manually, as before.
 
@@ -238,5 +238,5 @@ The session's environment can change in the course of work: direct tools are rep
 - Preflight: before the audit phase, check that `subagent` is available; if not — do not start the loop.
 - The outcome status: "done; the regular audit is deferred". The outcome includes the state revision (commit/directory hash), compensating checks as a list (explicitly as checks), and the run plan in a normal session.
 - Forbidden: passing a self-check/`ai` review off as an independent audit; marking the task as audited; writing "ready".
-- Handoff: the audit is run on the recorded revision in a normal session; or the roles are launched as separate processes `opencode run --agent <role> "<brief>"` in the project directory (if the environment provides a shell — for example, AetherShell); keep the roles' sessionIDs (Phase 3.5/re-audit).
+- Handoff: the audit is run on the recorded revision in a normal session; or the roles are launched as separate processes `opencode run --agent <role> "<brief>"` in the project directory (if the environment provides a shell); keep the roles' sessionIDs (Phase 3.5/re-audit).
 - If the environment is restored before completion — run the deferred audit and update the verdict.

package/docs/en/root-runbook.md

@@ -45,7 +45,7 @@ A "Fact-check (pre-pass): …" block is added to the pair's prompts — 5–15 l
 
 ## Subtleties
 
-- The `orch_uni_*` tools (if registered by the plugin): the state revision — `orch_uni_snapshot` (aggregate), an SGR report check — `orch_uni_validate_report` (invalid → resume the session and demand that the SGR be reissued), the roles' sessionID/model/cost — `orch_uni_sessions`; otherwise — manually, as before.
+- The `orch_uni_*` tools (if registered by the plugin): the state revision — `orch_uni_snapshot` (aggregate), an SGR report check — `orch_uni_validate_report` (text; files — `write`, not a heredoc; invalid → resume the session and demand that the SGR be reissued), the roles' sessionID/model/cost — `orch_uni_sessions`; otherwise — manually, as before.
 - The brief and the risk registry — as files; the subagents return the reports to the chat (the `edit deny` rule in `permissions`; `shell` is allowed), the root itself saves what is needed.
 - "Blind" runs — a sandbox without git history (without fix commits); re-audit — by contrast, the fixes delta is shown.
 - The root's verdict does not substitute for the auditors' verdicts: until both roles are ready, the loop lives (plus the escalation rules from `process-ready-loop.md`).

package/docs/ru/call-mechanics.md

@@ -192,7 +192,7 @@ subagent({agent:"redteam", background:true,
 ### Инструменты `orch_uni_*` (если зарегистрированы плагином)
 
 - ревизия состояния → `orch_uni_snapshot` (aggregate = хэш каталога): фиксируется вместе с вердиктом и верификацией;
-- отчёт роли → `orch_uni_validate_report` (путь или текст): `valid=false` → дефект шага, resume той же сессии с требованием перевыпустить SGR; не пропускать `warnings`;
+- отчёт роли → `orch_uni_validate_report` (предпочтительно `text`; файлы — `write`, не shell-heredoc: Windows-лимит 32 767): `valid=false` → дефект шага, resume той же сессии с требованием перевыпустить SGR; не пропускать `warnings`;
 - sessionID ролей, их модель и стоимость → `orch_uni_sessions`;
 - инструменты недоступны — работаем вручную, как прежде.
 
@@ -238,5 +238,5 @@ subagent({agent:"redteam", background:true,
 - Preflight: перед аудиторской фазой проверь наличие `subagent`; нет — цикл не запускай.
 - Статус итога: «готово; штатный аудит отложен». В итог: ревизия состояния (коммит/хэш каталога), компенсирующие проверки списком (явно как проверки), план прогона в обычной сессии.
 - Запрещено: выдавать самопроверку/`ai`-ревью за независимый аудит; помечать задачу прошедшей аудит; писать «ready».
-- Хендофф: аудит на зафиксированной ревизии в обычной сессии; либо роли запускаются отдельными процессами `opencode run --agent <роль> "<бриф>"` в каталоге проекта (если среда даёт shell — например, AetherShell); sessionID ролей сохранить (Фаза 3.5/re-audit).
+- Хендофф: аудит на зафиксированной ревизии в обычной сессии; либо роли запускаются отдельными процессами `opencode run --agent <роль> "<бриф>"` в каталоге проекта (если среда даёт shell); sessionID ролей сохранить (Фаза 3.5/re-audit).
 - Если среда восстановилась до завершения — проведи отложенный аудит и обнови вердикт.

package/docs/ru/root-runbook.md

@@ -45,7 +45,7 @@
 
 ## Тонкости
 
-- Инструменты `orch_uni_*` (если зарегистрированы плагином): ревизия состояния — `orch_uni_snapshot` (aggregate), проверка SGR-отчёта — `orch_uni_validate_report` (невалиден → resume сессии с перевыпуском SGR), sessionID/модель/стоимость ролей — `orch_uni_sessions`; иначе — вручную, как прежде.
+- Инструменты `orch_uni_*` (если зарегистрированы плагином): ревизия состояния — `orch_uni_snapshot` (aggregate), проверка SGR-отчёта — `orch_uni_validate_report` (text; файлы — `write`, не heredoc; невалиден → resume сессии с перевыпуском SGR), sessionID/модель/стоимость ролей — `orch_uni_sessions`; иначе — вручную, как прежде.
 - Бриф и реестр рисков — файлами; отчёты субагенты возвращают в чат (правило `edit deny` в `permissions`; `shell` разрешён), root сохраняет нужное сам.
 - «Слепые» прогоны — песочница без git-истории (без фикс-коммитов); re-audit — наоборот, дельта правок показывается.
 - Вердикт root'а не подменяет вердикты аудиторов: пока обе роли не ready — цикл живёт (плюс правила эскалации из `process-ready-loop.md`).

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "opencode-orchestrator-uni",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "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",