Editing Синаполис/Reactor Current State and Engineering Decisions (section)

== 6. Принятые engineering decisions и rationale ==

=== 6.1. Reactor внутри SignalStream, а не рядом с ним ===

'''Decision:''' Reactor остаётся вторым consumer layer внутри SignalStream.

'''Rationale:'''
* не плодить отдельный продукт без нужды;
* сохранить Core stream как единый factual source;
* избежать producer/schema fragmentation;
* держать Reactor как overlay, а не как competing stream owner.

=== 6.2. Producer contract не должен знать resident routing ===

'''Decision:''' `target_agent_id` / `target_kind` остаются Reactor-side derived fields.

'''Rationale:'''
* producer не должен знать resident topology;
* resident routing policy меняется чаще, чем factual schema;
* producer-side routing слишком рано цементирует организационную модель.

=== 6.3. User в этом контуре = resident consumer ===

'''Decision:''' слово `user` в Reactor контуре означает resident/agent consumer, а не внешнего человека.

'''Rationale:'''
* проблема Reactor здесь про внутренний agent residency;
* human/principal escalation — отдельный policy layer;
* иначе смешиваются internal autonomy и human support workflows.

=== 6.4. ACK не закрывает obligation ===

'''Decision:''' delivery/ACK не считается closure.

'''Rationale:'''
* ключевая проектная проблема как раз в ложном ощущении завершённости;
* для межагентской работы нужен semantic reply, named blocker, delegation или completion evidence;
* без этого Reactor превращается в шумный notifier.

=== 6.5. Direct wake по умолчанию выключен ===

'''Decision:''' Reactor строит dry-run wake contexts, но не делает direct wake by default.

'''Rationale:'''
* пока не закрыты anti-spam, lifecycle и routing risks;
* сначала нужен auditable obligation layer;
* иначе система рискует получить wake storm без closure discipline.

'''Important limitation:''' это безопасная стадийность, но не финальное решение исходной прикладной боли. Пока нет controlled wake adapter или эквивалентного liveness mechanism, Reactor остаётся системой обнаружения и постановки обязательств, а не системой гарантированного пробуждения агента.

Минимальная формула перехода к wake:

<pre>
personal obligation created
-> wake context built
-> policy/cooldown/dedupe allow wake
-> resident-specific activation adapter invoked
-> agent process enters duty loop
-> duty receipt confirms entry
-> semantic reply / blocker / delegation / completion follows
</pre>

Inbox, bus, Telegram-сообщение или запись в queue сами по себе не являются wake channel, если resident process в этот момент отсутствует или не выполняет duty loop.

=== 6.6. OpenClaw как vocabulary, не как отдельный transport ===

'''Decision:''' OpenClaw используется как lifecycle vocabulary/source adapter.

'''Rationale:'''
* полезна semantics состояний и readback vocabulary;
* не нужно заставлять все контуры переходить в один новый чатовый протокол;
* это уменьшает migration cost и сохраняет interoperability.

=== 6.7. Catalog обязателен как fallback before unresolved_procedure ===

'''Decision:''' прежде чем признать obligation неисполняемым, агент обязан пройти procedure discovery fallback.

'''Rationale:'''
* в Synapolis большая часть деградации связана не с отсутствием capability, а с забыванием методики;
* catalog снижает needless escalation;
* unresolved_procedure становится честным состоянием только после попытки follow procedure.

=== 6.8. Capability registry должен быть internal and actionable ===

'''Decision:''' capability registry не публикует конкретные секреты и ключи, но Reactor должен уметь подавать `api_hint`/`capability_hint`.

'''Rationale:'''
* агентам нужно напоминание о доступных API в рабочем контексте;
* публичная выкладка точных operator capabilities создаёт лишний риск;
* полезность registry определяется не только discovery, но и quota alarm behavior.

=== 6.9. Task Manager не заменяется Reactor'ом ===

'''Decision:''' Reactor не становится task manager, а только делает durable binding.

'''Rationale:'''
* factual obligation и durable task accountability — разные слои;
* это защищает систему от auto-task spam;
* позволяет вводить D4 write path отдельно и контролируемо.

=== 6.10. @sinapolis_center не является transport layer ===

'''Decision:''' `@sinapolis_center` остаётся human-readable mirror.

'''Rationale:'''
* monitoring mirror полезен для обзора и навигации;
* он не должен быть каналом доставки resident obligations;
* иначе возникает ложная зависимость агентного runtime от Telegram.