Runs и review¶

Structured run evidence полезно, когда проекту недостаточно conversational history — например для substantial changes, auditability, validation attachment или enforced review.

Для обычных lightweight tasks это опционально.

Что записывает run¶

Structured run может хранить:

task и role;
выбранные host и route class;
data class и access mode;
owned paths;
selected context identity;
changed paths;
attached validation evidence;
review result;
outcome и residual risk.

Knowledge content не копируется в run record. Context и validation прикрепляются через persisted identities/evidence, а не вводятся заново как неподтверждённые claims.

Начать run¶

embraion run start   --run-id task-001   --task "Implement feature"   --role worker   --host codex   --route-class substantial   --data PRIVATE   --access write   --owned-path "src/**"   --substantial

Run фиксирует task contract: role, host, routing class, data class, access, owned paths и substantial-work intent.

Прикрепить реальную validation¶

embraion validation run affected --run-id task-001

Validation evidence прикрепляется по ID вместо ручного повторения claim человеком или AI.

Записать review и completion¶

После independent review:

embraion run complete task-001   --changed-path src/example.py   --validation affected=passed   --review passed   --outcome completed

Writable completion сверяет changed paths с owned scope и protected-path policy. Substantial writable work также должна удовлетворять applicable review contract.

Независимое ревью внутри AI-хоста¶

Общий порядок ревью принадлежит EmbrAIon и передаётся через навыки orchestration и review. Каждый PR и существенную реализацию вне PR проверяет другой агент Reviewer с доступом только на чтение. Сначала автор завершает изменения и обязательные тесты и CI для текущего кандидата, затем проверяет весь diff и связанный код. Собственные исправления проходят нужные проверки и повторный self-review до запуска reviewer. Отсутствующая, проваленная или ещё выполняющаяся обязательная проверка блокирует запуск reviewer. Ревью не используется для проверки промежуточного прогресса.

Lead выбирает reviewer через существующий роутинг проекта для текущего разрешённого хоста. Название роли не выбирает модель; настройки родителя не являются запасным маршрутом. Платный внешний сервис и Copilot Review не требуются. Ограничения доступа, приватности и возможностей хоста сохраняются. Если нужного reviewer нельзя запустить, автор не заменяет его собственным одобрением.

Reviewer проверяет полный diff, связанный код, контракты, тесты и результаты проверок. Исправления выполняет автор, после чего повторяет нужные проверки и self-review. Reviewer перепроверяет результат и явно подтверждает полный SHA итогового коммита PR, проверенную базу и свидетельства валидации. Любое последующее изменение кандидата или новый коммит отменяет подтверждение. Повторное ревью может сосредоточиться на изменившейся части, но учитывает общий результат. Одобрение reviewer не заменяет разрешение пользователя на merge или release. Squash создаёт новый SHA: reviewer подтверждает неизменённый исходный HEAD PR непосредственно перед разрешённым слиянием.

Параметр CLI --review passed записывает утверждение вызывающего и снимок Git, но не доказывает личность reviewer или исполнение внутри хоста. Отдельный GitHub approval gate остаётся самостоятельной настройкой: ответ нативного reviewer не создаёт GitHub review со статусом APPROVED. Нельзя молча удалять настроенное требование branch approval.

Что означает review¶

Полезный review должен быть независим от implementation step и проверять evidence, соответствующее риску изменения.

Для substantial work обычно проверяются:

behavior и regressions;
architecture/compatibility boundaries;
protected/generated/external source handling;
validation coverage;
security/privacy implications;
residual risk.

Связь с GitHub enforcement¶

Когда .embraion/policy.yaml требует review, embraion enforcement check может использовать structured run evidence через --run-id, а explicitly installed GitHub Actions surface — текущие PR approvals.

См. Enforcement.