gennady 0.8.2 → 0.8.4

package/ai/skills/sdd-execute/scripts/sdd

@@ -9,6 +9,7 @@
 #   sdd verify <file>...                — comprehensive gate: typecheck + gennady lint + forbidden_grep
 #   sdd check-blockers <ticket-file>    — scan Execution Log for unresolved BLOCKER entries
 #   sdd scan [project-root]             — emit comprehensive project snapshot (single rich call)
+#   sdd check [root|--task TSK-NN|--files f...] — deterministic mechanical checks (task-id, tracker-sync, headers)
 #   sdd help                            — print this help
 #
 # Why this wrapper exists:
@@ -44,6 +45,9 @@ case "$SUBCMD" in
     scan)
         exec "$SCRIPT_DIR/scan.sh" "$@"
         ;;
+    check)
+        exec "$SCRIPT_DIR/check.sh" "$@"
+        ;;
     help|--help|-h)
         cat <<'EOF'
 sdd — SDD command dispatcher
@@ -80,6 +84,14 @@ SUBCOMMANDS
                                   unparseable Meta.Status, broken spec links) are surfaced
                                   in [WARNINGS]. Defaults to current directory.
 
+    check [root]                Deterministic mechanical checks — the single source of
+      check --task TSK-NN [root]   mechanical truth shared by sdd-check (whole tree) and
+      check --files <f...>         sdd-audit (scoped). Emits [TASKID] (collisions, orphan
+                                  @tasks refs), [TRACKER_SYNC] (ticket Meta.Status vs tracker
+                                  row), and — in --files mode — [HEADERS] (@file/@consumers/
+                                  @tasks presence on a caller-supplied in-scope file list).
+                                  Exit 0 clean, 3 findings, 2 structural, 4 bad invocation.
+
     check-blockers <ticket>     Scan ticket Execution Log for unresolved BLOCKER entries.
                                   A BLOCKER is considered RESOLVED if a later Round contains
                                   a "✅ RESOLVED" entry referencing it. Returns list of

package/ai/skills/sdd-hooks-install/SKILL.md

@@ -0,0 +1,88 @@
+---
+name: sdd-hooks-install
+description: Install Claude Code hooks for live SDD subagent progress streaming. Adds PreToolUse / PostToolUse / SubagentStop entries to project's .claude/settings.json (merging with existing config), ensures .claude/sdd-progress.ndjson is gitignored, prints the operator's tail command. Use once per project before running /sdd-execute or /sdd-execute-batch when live progress visibility is wanted. Idempotent — safe to re-run.
+---
+
+<SDDHooksInstaller role="config-bootstrapper">
+You install hooks into the CURRENT project to enable live SDD progress tailing. You do NOT install global hooks (those would fire on every project). Idempotent — re-running detects existing entries and skips duplicates.
+
+<Protocol>
+1. **Verify project context:**
+   - cwd has `.git/` OR a `.claude/` directory OR an `.ai/` directory → proceed.
+   - Otherwise → halt: "Not a project root. Run from project's working directory."
+
+2. **Ensure `.claude/` exists:**
+   - `mkdir -p .claude`
+
+3. **Patch `.claude/settings.json`:**
+   - File missing → write a fresh one with the hooks block below.
+   - File exists → parse JSON. Merge: under `.hooks`, add `PreToolUse`, `PostToolUse`, `SubagentStop` entries. If a matcher with same `command` already exists, skip. Preserve existing hooks.
+   - Write back with 2-space indent.
+
+   Hooks block to add:
+   ```jsonc
+   {
+     "hooks": {
+       "PreToolUse": [
+         {
+           "matcher": "*",
+           "hooks": [
+             {
+               "type": "command",
+               "command": "jq -nc --arg ts \"$(date -u +%Y-%m-%dT%H:%M:%SZ)\" --arg tool \"$CLAUDE_HOOK_TOOL_NAME\" --arg agent \"${CLAUDE_HOOK_PARENT_TOOL_USE_ID:-}\" '{ts:$ts, kind:\"pre\", tool:$tool, agent:$agent}' >> .claude/sdd-progress.ndjson"
+             }
+           ]
+         }
+       ],
+       "PostToolUse": [
+         {
+           "matcher": "*",
+           "hooks": [
+             {
+               "type": "command",
+               "command": "jq -nc --arg ts \"$(date -u +%Y-%m-%dT%H:%M:%SZ)\" --arg tool \"$CLAUDE_HOOK_TOOL_NAME\" --arg agent \"${CLAUDE_HOOK_PARENT_TOOL_USE_ID:-}\" '{ts:$ts, kind:\"post\", tool:$tool, agent:$agent}' >> .claude/sdd-progress.ndjson"
+             }
+           ]
+         }
+       ],
+       "SubagentStop": [
+         {
+           "hooks": [
+             {
+               "type": "command",
+               "command": "jq -nc --arg ts \"$(date -u +%Y-%m-%dT%H:%M:%SZ)\" --arg sess \"${CLAUDE_HOOK_SESSION_ID:-}\" '{ts:$ts, kind:\"subagent_stop\", session:$sess}' >> .claude/sdd-progress.ndjson"
+             }
+           ]
+         }
+       ]
+     }
+   }
+   ```
+
+4. **Patch `.gitignore`:**
+   - Append `.claude/sdd-progress.ndjson` if not already listed.
+   - Create `.gitignore` with that single line if missing.
+
+5. **Verify `jq` is available** (Bash `command -v jq`). If missing → emit warning: "jq not found — install via `brew install jq` or `apt install jq` for hook scripts to work."
+
+6. **Print to operator** (final message):
+   ```
+   ✅ SDD hooks installed in <project-root>/.claude/settings.json
+   ✅ .gitignore updated to exclude sdd-progress.ndjson
+
+   To watch live progress in a second terminal:
+       tail -f .claude/sdd-progress.ndjson | jq -r '"\(.ts) | \(.kind) | \(.tool // .session) | agent=\(.agent // "-")"'
+
+   Now run /sdd-execute <TSK-NN> or /sdd-execute-batch in this terminal.
+
+   To uninstall: edit .claude/settings.json and remove the SDD entries.
+   ```
+</Protocol>
+
+<HardForbidden>
+- Modifying global `~/.claude/settings.json` (this is per-project setup).
+- Overwriting existing settings.json — must merge, preserving operator's other hooks.
+- Adding the file outside .gitignore (would commit operator activity logs).
+- Running the install if jq is unavailable without the warning (hooks would silently fail).
+</HardForbidden>
+</SDDHooksInstaller>

package/ai/skills/workspace-permission-setup/SKILL.md

@@ -0,0 +1,193 @@
+---
+name: workspace-permission-setup
+description: Configure .claude/settings.json so the agent works autonomously inside the current repository while being auto-denied access to anything outside it (home directory, system paths, network, secrets). Use when the user wants to enable AI-first development with minimal permission prompts, scope the agent to a workspace, set up safe autonomy for a project, stop the agent from leaving the repo, reduce repetitive approval requests, or harden permissions for a codebase.
+---
+
+# Workspace Permission Setup
+
+Set up `.claude/settings.json` so the agent operates fully autonomously **inside** the current repository, and is **auto-denied** (not prompted) for anything **outside** it. Goal: enable AI-first development without sacrificing safety.
+
+## Core principle
+
+- **Wide allow inside repo** — file edits, project tooling, git, common shell utilities.
+- **Hard deny outside repo** — `~/`, `/etc`, `/var`, `.ssh`, `.aws`, network commands, `WebFetch`/`WebSearch`, secrets.
+- `deny` always wins over `allow` — the agent gets a refusal, not a prompt, so the user is not interrupted.
+
+## Workflow
+
+Always run all six steps in order. Never write to disk before Step 5 user approval.
+
+### Step 1 — Detect project context
+
+Determine repo root and stack so allow-list is tailored, not generic.
+
+```bash
+git rev-parse --show-toplevel 2>/dev/null || pwd
+ls -la package.json pyproject.toml Cargo.toml go.mod Gemfile pom.xml build.gradle Makefile Dockerfile docker-compose.yml mise.toml .tool-versions 2>/dev/null
+ls -la .claude/ 2>/dev/null
+```
+
+Map detection → allow additions:
+
+| Detected | Add to allow |
+|---|---|
+| `package.json` | `Bash(npm:*)`, `Bash(npx:*)`, `Bash(pnpm:*)`, `Bash(yarn:*)`, `Bash(node:*)` |
+| `pyproject.toml` / `requirements.txt` | `Bash(python:*)`, `Bash(python3:*)`, `Bash(pip:*)`, `Bash(uv:*)`, `Bash(poetry:*)`, `Bash(pytest:*)` |
+| `Cargo.toml` | `Bash(cargo:*)`, `Bash(rustc:*)` |
+| `go.mod` | `Bash(go:*)`, `Bash(gofmt:*)` |
+| `Gemfile` | `Bash(bundle:*)`, `Bash(rake:*)`, `Bash(rspec:*)` |
+| `Makefile` | `Bash(make:*)` |
+| `Dockerfile` / `docker-compose.yml` | (do **not** auto-allow `docker` — ask in Step 4) |
+| `mise.toml` / `.tool-versions` | `Bash(mise:*)` |
+
+Also read existing `.claude/settings.json` and `.claude/settings.local.json`. **Preserve** other sections — only the `permissions` block is replaced.
+
+### Step 2 — Harvest from transcript history
+
+Invoke the `fewer-permission-prompts` skill via the Skill tool. It scans recent transcripts and extracts safe read-only commands the user has been approving repeatedly. Capture its proposal but **do not** let it write — we will merge into our config in Step 3.
+
+If the skill is not available or returns nothing useful, skip — Steps 1 and 3 give a working baseline.
+
+### Step 3 — Build the proposed config
+
+Three sources merged into one block:
+
+1. **Universal scoping** (deny + baseline allow — always present).
+2. **Project-specific allow** (from Step 1).
+3. **Transcript-derived allow** (from Step 2).
+
+#### Universal scoping deny — always include
+
+```json
+"deny": [
+  "WebFetch",
+  "WebSearch",
+
+  "Read(~/**)",
+  "Edit(~/**)",
+  "Write(~/**)",
+  "Read(/etc/**)",
+  "Read(/var/**)",
+  "Read(/private/**)",
+  "Read(/tmp/**)",
+
+  "Read(./.env*)",
+  "Read(./**/.env*)",
+  "Read(./.git/config)",
+
+  "Bash(curl:*)",
+  "Bash(wget:*)",
+  "Bash(ssh:*)",
+  "Bash(scp:*)",
+  "Bash(rsync:*)",
+  "Bash(nc:*)",
+  "Bash(cd ..*)",
+  "Bash(cd /*)",
+  "Bash(cd ~*)",
+  "Bash(rm -rf:*)",
+  "Bash(sudo:*)"
+]
+```
+
+If sensitive directories exist on the machine (`~/.ssh`, `~/.aws`, `~/.gnupg`, `~/.config`, `~/Library`), add explicit absolute-path denies — `~` patterns may not always expand, so be belt-and-suspenders:
+
+```json
+"Read(/Users/<user>/.ssh/**)",
+"Read(/Users/<user>/.aws/**)",
+"Read(/Users/<user>/.gnupg/**)",
+"Read(/Users/<user>/.config/**)",
+"Read(/Users/<user>/Library/**)"
+```
+
+Use `$HOME` or detect actual user from `whoami` / `echo $HOME`.
+
+#### Universal allow baseline — always include
+
+```json
+"allow": [
+  "Read",
+  "Grep",
+  "Glob",
+  "Edit",
+  "Write",
+  "Bash(git:*)",
+  "Bash(ls:*)",
+  "Bash(cat:*)",
+  "Bash(head:*)",
+  "Bash(tail:*)",
+  "Bash(grep:*)",
+  "Bash(rg:*)",
+  "Bash(find . *)",
+  "Bash(sed:*)",
+  "Bash(awk:*)",
+  "Bash(jq:*)",
+  "Bash(diff:*)",
+  "Bash(wc:*)",
+  "Bash(echo:*)",
+  "Bash(pwd)",
+  "Bash(mkdir:*)",
+  "Bash(touch:*)",
+  "Bash(mv:*)",
+  "Bash(cp:*)"
+]
+```
+
+#### Default mode
+
+```json
+"defaultMode": "acceptEdits"
+```
+
+File edits inside the repo no longer prompt.
+
+### Step 4 — Interactive review with the user
+
+Present the **full proposed JSON** to the user, then ask 3–5 targeted questions tied to what was detected. Do not write yet.
+
+Standard questions (skip those that don't apply):
+
+1. **`git push`** — allow autonomously, or keep asking? Default recommendation: **ask** (irreversible, affects remote).
+2. **Package install** (`npm install`, `pip install`, `cargo add`, etc.) — allow autonomously, or ask? Default recommendation: **ask** (mutates lockfile, pulls supply chain).
+3. **`docker:*`** (if Dockerfile detected) — allow, ask, or deny?
+4. **`WebFetch`** — currently denied. Need it for fetching external docs? Default recommendation: **keep denied**, agent should ask explicitly when needed.
+5. **Anything project-specific** — extra CLIs (`terraform`, `kubectl`, `aws`, `gcloud`, custom scripts in `./bin/`)?
+
+Apply answers to the config and show the final version once more.
+
+### Step 5 — Write the config (only after explicit approval)
+
+Wait for unambiguous user approval ("yes", "ok, write", "go").
+
+Then merge with any existing `.claude/settings.json`:
+
+- **Preserve** all top-level keys other than `permissions` (e.g., `env`, `hooks`, `model`, `statusLine`).
+- **Replace** the `permissions` block with the new merged result.
+- Use Edit (if file exists) or Write (if not) — never shell redirection.
+
+**Do not touch `.claude/settings.local.json`** — that is the user's personal, gitignored layer.
+
+### Step 6 — Verify and explain
+
+Show the final file content and explain in 4–5 lines:
+
+1. Default mode is `acceptEdits` → file edits in the repo run without prompting.
+2. Off-workspace paths (`~`, `/etc`, `.ssh`, etc.) are now **auto-denied** — the agent will not interrupt to ask.
+3. `WebFetch`/`WebSearch` are denied → agent won't try to leave the repo for info unless user explicitly relaxes the rule.
+4. Suggest one quick smoke test: ask the agent to read `~/.ssh/known_hosts`, confirm it gets denied without prompting.
+5. Mention `Shift+Tab` switches modes if user wants to temporarily relax for one task.
+
+## Honest limits
+
+Bash cannot be perfectly sandboxed via deny patterns alone — an agent can use `bash -c "..."`, `eval`, command substitution, environment manipulation. The patterns block the obvious, common escape paths (`curl`, `cd ..`, `sudo`), which is enough for ~95% of real-world risk. For genuine sandbox guarantees, mention these as follow-ups (do not implement here):
+
+- Run Claude Code inside a **devcontainer** (https://code.claude.com/docs/en/devcontainer).
+- Add a **PreToolUse hook** that parses every Bash command and rejects cwd escapes.
+
+## Anti-patterns — never do these
+
+- Do not overwrite `.claude/settings.json` — always merge other sections.
+- Do not write before explicit user approval in Step 5.
+- Do not allow-list `Bash(curl:*)`, `Bash(wget:*)`, broad `Bash(*)`, or `Bash(sudo:*)`.
+- Do not put deny rules in `.claude/settings.local.json` — security policy belongs in the committed `settings.json` so the whole team inherits it.
+- Do not delete the user's existing `settings.local.json` allow rules — they may have been hand-tuned for personal workflows.
+- Do not skip Step 4 questions — the difference between "agent can `git push` at 3am" and "agent asks first" matters and is project-specific.

package/cli/cmd/README.md

@@ -0,0 +1,185 @@
+# cli/cmd — Команды CLI
+
+16 команд для AI-агентов: работа с git, генерация commit-сообщений, ревью, merge-конфликты, линтинг, навигация по коду, синхронизация, мониторинг.
+
+---
+
+## Типовые сценарии
+
+### 1. Сделать коммит
+
+```bash
+# Сгенерировать commit message из staged-изменений
+npx gennady commit
+
+# One-line + сразу применить
+npx gennady commit --mode=oneline --apply
+
+# С указанием задачи
+npx gennady commit --task=MAILCORE-123
+```
+
+### 2. Проверить качество кода
+
+```bash
+# Линтинг директории
+npx gennady lint ./src
+
+# Только staged .ts файлы
+npx gennady lint --staged
+
+# Автофикс DbC-контрактов
+npx gennady lint ./src --autofix
+```
+
+### 3. Навигация по проекту
+
+```bash
+# Карта проекта (все файлы с аннотациями)
+npx gennady orient
+
+# Найти файлы по задаче
+npx gennady orient --task=TSK-03
+
+# Кто потребляет модуль
+npx gennady orient --consumer=DbcTsLinter
+
+# Граф зависимостей
+npx gennady orient --graph
+
+# Детальный просмотр файла
+npx gennady orient --file=path/to/file.ts
+
+# Встроить orient-инструкции в AGENTS.md
+npx gennady agents-rules
+```
+
+### 4. Ревью MR/PR
+
+```bash
+# Верификация MR по текущей ветке
+npx gennady review-verify
+
+# По URL
+npx gennady review-verify --url="https://gitlab.com/group/repo/-/merge_requests/42"
+
+# По ref
+npx gennady review-verify group/repo!42
+
+# Только XML issues
+npx gennady review-issues --ref=group/repo!42
+
+# Ответить на discussion-треды
+echo '[{"discussionId":"abc","body":"Fixed"}]' | \
+  npx gennady vcs-reply --project=group/repo --iid=42
+```
+
+### 5. AI-ревью staged-изменений
+
+```bash
+npx gennady review
+npx gennady review --branch=develop
+```
+
+### 6. Разрешить merge-конфликты
+
+```bash
+# После git merge с конфликтами
+npx gennady resolve-conflicts
+npx gennady resolve-conflicts --branch=main --incoming=feature/x
+```
+
+### 7. Собрать файлы для AI-контекста
+
+```bash
+# XML (по умолчанию)
+npx gennady cat "./src/**/*.ts"
+
+# Markdown, без цвета
+npx gennady cat "./src/**/*.ts" --output=md --plain | pbcopy
+
+# Из удалённого MR
+npx gennady cat --url="https://gitlab.com/.../-/merge_requests/123"
+```
+
+### 8. Синхронизировать директивы и навыки
+
+```bash
+# Директивы
+npx gennady sync
+npx gennady sync --dry-run
+
+# Навыки
+npx gennady sync-skills
+npx gennady sync-skills --dry-run
+```
+
+### 9. Мульти-модельный анализ
+
+```bash
+# Мнение двух моделей с синтезом
+npx gennady alt-opinion \
+  --model="llmproxy/kimi-k2.6" \
+  --model="llmproxy/glm-5.1" \
+  --synthModel="llmproxy/deepseek-v4-pro" \
+  --file="./spec.md"
+```
+
+### 10. Мониторинг AI-агентов
+
+```bash
+# Live-дашборд
+npx gennady agent-mon
+
+# Одноразовый снапшот
+npx gennady agent-mon --once
+```
+
+---
+
+## Все команды
+
+| Команда             | Назначение                                              |
+| ------------------- | ------------------------------------------------------- |
+| `commit`            | Генерация commit message из staged-изменений через AI   |
+| `cat`               | Вывод файлов в XML/Markdown для AI-контекста            |
+| `review`            | AI-ревью staged изменений                               |
+| `review-verify`     | Сборка промпта для верификации MR/PR discussions        |
+| `review-issues`     | XML-артефакт issues из MR/PR                            |
+| `vcs-reply`         | Постинг ответов в GitLab MR discussions                 |
+| `resolve-conflicts` | Промпт для AI-разрешения merge-конфликтов               |
+| `remote-console`    | Зеркалирование браузерной консоли в stdout              |
+| `lint`              | Валидация .ts файлов: headers, anchors, DbC, invariants |
+| `alt-opinion`       | Мульти-модельные мнения с синтезом                      |
+| `sync`              | Синхронизация `ai/directives/` из npm-пакета            |
+| `sync-skills`       | Синхронизация SDD-навыков в `.claude/skills/`           |
+| `agent-mon`         | Интерактивный дашборд мониторинга AI-агентов            |
+| `orient`            | Навигация по file-header и DBC-контрактам               |
+| `agents-rules`      | Инструкция по orient для AI-агентов                     |
+
+---
+
+## Структура команды
+
+```
+cli/cmd/<name>/
+├── <name>.cmd.ts     # Исполняемая логика команды
+├── index.ts          # Точка входа для динамического импорта
+├── help.ts           # help-вывод (опционально)
+└── README.md         # Документация (есть только у orient — канонический источник для agents-rules)
+```
+
+При добавлении команды обновить: `cli/cmd/README.md` (этот файл), `cli/AGENTS.md`, `cli/gennady.ts`.
+
+---
+
+## Связанные спеки
+
+- `specs/cli/cli.spec.md` — общая спека CLI
+- `specs/cli/lint/lint.spec.md` — линтинг
+- `specs/cli/alt-opinion/alt-opinion.spec.md` — alt-opinion
+- `specs/cli/cat/cat.spec.md` — cat
+- `specs/cli/sync/sync.spec.md` — sync
+- `specs/cli/sync-skills/sync-skills.spec.md` — sync-skills
+- `specs/cli/agents-rules/agents-rules.spec.md` — agents-rules
+- `specs/cli/e2e/e2e.spec.md` — e2e-тестирование

package/dist/ai/agents/agent-resolve-conflicts.xml

@@ -1,3 +1,148 @@
-<Agent name="agent-resolve-conflicts" type="directive" ver="0.1">
-  <Mission>Resolve merge conflicts with confidence scoring.</Mission>
-</Agent>
+<!--
+  ENTRY POINT: Это не документ, а исполняемый манифест.
+  Ты — агент разрешения merge-конфликтов. Начинай немедленно.
+-->
+<Agent_Execution_Manifest id="ResolveConflicts_Master_v1" schema_version="2026.2">
+  <Configuration>
+    <Agent_Identity>
+      <Role>ResolveConflicts</Role>
+      <Mission>
+        Разрешить merge-конфликты так, чтобы сохранить намерения обеих веток.
+        При высокой уверенности — завершить задачу до готового staged-состояния.
+        При риске ошибки — остановиться и перейти в управляемый диалог с пользователем.
+      </Mission>
+    </Agent_Identity>
+    <Belief_State>
+      <Axiom id="AX_INTENT_OVER_MARKERS">
+        Конфликтные маркеры — это симптом. Решение должно опираться на цель изменений в обеих ветках.
+      </Axiom>
+      <Axiom id="AX_EVIDENCE_FIRST">
+        Любое решение обосновывается фактами: история коммитов, итоговые diff от merge-base, контекст использования кода.
+      </Axiom>
+      <Axiom id="AX_OPERATOR_LANGUAGE">
+        Все сообщения оператору (вопросы, план, отчёты, итоговые решения) формулируй на русском языке.
+        Английский допустим только для кода, команд, идентификаторов и технических терминов.
+      </Axiom>
+      <Axiom id="AX_CONFIDENCE_GATE">
+        Применяй изменения автоматически только при достаточной уверенности и отсутствии критичных сомнений.
+      </Axiom>
+      <Axiom id="AX_SAFE_VERIFY">
+        После автоматического разрешения обязательно проверь код: используй <!--ai:verify-axiom-hint-->.
+      </Axiom>
+      <Axiom id="AX_USER_DIALOG">
+        Если есть неоднозначность, влияние на архитектуру или риск регрессии — переходи в диалог и не форсируй auto-resolve.
+      </Axiom>
+    </Belief_State>
+    <Tool_Usage_Policy>
+      <Priority_Matrix>
+        <Primary_Tools>
+          Native IDE tools для чтения/редактирования/поиска — основной режим.
+        </Primary_Tools>
+        <Secondary_Tools>
+          Terminal для git-анализа и верификации: <!--ai:verify-tools-example-->.
+        </Secondary_Tools>
+      </Priority_Matrix>
+    </Tool_Usage_Policy>
+  </Configuration>
+  <Input_Data>
+    <!--Resolve_Conflicts_Artifact-->
+  </Input_Data>
+  <Execution_Plan>
+    <Step id="STEP_1_INGEST_CONTEXT">
+      <Goal>Понять merge-контекст и список конфликтов.</Goal>
+      <Action>
+        <!--ai:first-->
+        Прочитай `<Merge_Conflict_Context>`.
+        Зафиксируй:
+        - `current_branch`, `incoming_branch`, `merge_base`;
+        - список `<Conflict_Files><File ... />` и их `path`, `status`, `kind`, `conflictRegions`, `binary`.
+        Если `binary=true`, не пытайся редактировать бинарный файл автоматически: пометь как manual.
+      </Action>
+    </Step>
+    <Step id="STEP_2_BRANCH_INTENT_ANALYSIS">
+      <Goal>Построить понимание, зачем меняли каждый конфликтующий файл в обеих ветках.</Goal>
+      <Action>
+        Для каждого конфликтующего текстового файла:
+        1. Найди unique commits incoming-ветки для файла: от `merge_base..incoming`.
+        2. Найди unique commits current-ветки для файла: от `merge_base..current`.
+        3. Для каждой стороны зафиксируй:
+           - краткий intent;
+           - критичность (low/medium/high/critical);
+           - масштаб (localized/global);
+           - ключевые изменения.
+        4. Если commit history слишком большая, сначала возьми последние релевантные изменения, но не теряй критические правки (security/hotfix).
+      </Action>
+    </Step>
+    <Step id="STEP_3_CONFLICT_DECISION">
+      <Goal>Принять решение по каждому конфликтному региону.</Goal>
+      <Action>
+        Для каждого конфликтного региона выбери стратегию:
+        - `take-current`
+        - `take-incoming`
+        - `merge-both`
+        - `rewrite`
+
+        Для каждого региона сформируй:
+        - `analysis`: почему возник конфликт;
+        - `strategy`: выбранный подход;
+        - `resolvedCode`: итоговый код без маркеров;
+        - `confidence` (0-100);
+        - `riskFlags`: список рисков (архитектура, безопасность, API-совместимость, тестовый пробел).
+
+        Общие правила приоритета:
+        1. Критичный hotfix/security не теряется.
+        2. Рефакторинг не должен ломать исправления багов.
+        3. Если изменения совместимы — объединяй, а не отбрасывай.
+      </Action>
+    </Step>
+    <Step id="STEP_4_CONFIDENCE_SWITCH">
+      <Goal>Выбрать режим: автоматическое применение или диалог с пользователем.</Goal>
+      <Action>
+        <Switch exclusive="true" purpose="Выбор режима по уровню уверенности и рискам">
+          <Case when="Для каждого конфликтного региона confidence >= 85 и нет riskFlags высокого уровня">
+            - Примени resolvedCode ко всем регионам.
+            - Удали конфликтные маркеры.
+            - Выполни `git add` только для файлов, полностью разрешённых без сомнений.
+            - Перейди к STEP_5.
+          </Case>
+          <Case when="Есть регионы с confidence 60-84 или есть значимые riskFlags">
+            - Не выполняй auto-apply для спорных регионов.
+            - Перейди в диалог с пользователем.
+            - Покажи 1-3 точечных вопроса по развилке и предложи рекомендуемый вариант.
+            - Для каждого спорного региона дай краткое сравнение вариантов (`current`, `incoming`, `merge`) и ожидаемые последствия.
+            - Остановись и жди ответа пользователя.
+          </Case>
+          <Case when="Есть регионы с confidence &lt; 60 или не хватает фактов для безопасного выбора">
+            - Не вноси автоматические изменения в спорные участки.
+            - Сформируй план ручного разрешения с приоритетами и рисками.
+            - Запроси решение пользователя по каждому блокирующему региону.
+            - Остановись и жди ответа пользователя.
+          </Case>
+        </Switch>
+      </Action>
+    </Step>
+    <Step id="STEP_5_VERIFY_AND_REPORT">
+      <Precondition>STEP_4 выбрал auto-apply для всех регионов или спорные регионы уже подтверждены пользователем.</Precondition>
+      <Goal>Проверить результат и отчитаться прозрачно.</Goal>
+      <Action>
+        1. Verify: <!--ai:verify-step-commands-->
+        2. Сформируй отчёт:
+           - какие файлы разрешены автоматически;
+           - какие стратегии применены;
+           - итоговый confidence по файлам;
+           - какие команды проверки выполнены и их результат.
+        3. Если проверки упали — покажи причину и предложи дальнейшие шаги.
+        4. Не выполняй `git commit` автоматически.
+      </Action>
+    </Step>
+  </Execution_Plan>
+  <Output_Contracts>
+    <Contract id="REPORT_FORMAT">
+      Итог должен содержать:
+      - `Resolved Automatically` (список файлов и стратегии),
+      - `Needs User Decision` (если есть),
+      - `Verification` (какие команды и статус),
+      - `Next Steps` (что сделать пользователю дальше).
+    </Contract>
+  </Output_Contracts>
+</Agent_Execution_Manifest>