@k0t0vich/meta-agents-template 0.1.0 → 0.1.2

package/README.md

@@ -56,6 +56,7 @@ my-project/
       decomposer.md
       reviewer-judge.md
       agile-manager.md
+      publishing-agent.md
     scripts/
       init.mjs
       sync-status.mjs
@@ -72,10 +73,30 @@ my-project/
 ```
 
 ## Канонические команды
+0. `VERIFY_GOVERNANCE_GATE`
 1. `CREATE_TASK`
 2. `SET_STATUS`
-3. `COMMIT_BY_NAME`
-4. `ASSIGN_SPRINT`
+3. `RUN_REVIEW_GATE`
+4. `COMMIT_BY_NAME`
+5. `ASSIGN_SPRINT`
+6. `PREPARE_RELEASE_NOTE`
+7. `MARK_TASKS_PUBLISH`
+
+`VERIFY_GOVERNANCE_GATE` выполняет `Governance Watchdog Agent` перед любой операцией и блокирует выполнение при нарушении PRD/acceptance/user-confirmation правил.
+`RUN_REVIEW_GATE` выполняет `Reviewer/Judge Agent` перед коммитом:
+- сначала выводит summary выполненного, критические замечания, потенциальные риски и рекомендацию `PASS_CANDIDATE/FAIL`;
+- финальный `PASS_CONFIRMED` допускается только после явного `Review Approved: yes` от пользователя.
+
+## Self-bootstrap (для этого репозитория)
+Чтобы сам шаблон работал по своим же правилам, запусти:
+
+```bash
+npm run self:bootstrap
+```
+
+Команда разворачивает шаблонные управляемые файлы в текущий репозиторий, создаёт стартовую задачу с PRD (`AGT-SELF-001`) и заполняет backlog/sprint/status-log.
+
+Локальные рабочие артефакты `tasks/` и `.meta-agents/` добавлены в `.gitignore`, чтобы не засорять публикационный пакет.
 
 ## Жёсткие критерии приёмки
 Задача принимается только если одновременно выполнены все условия:
@@ -86,41 +107,36 @@ my-project/
 5. Пройдены обязательные `human` approvals.
 6. Собран полный evidence-пакет.
 7. Синхронизированы `task/status/sprint` в трекере.
+8. Перед каждой командой пройден watchdog gate (`VERIFY_GOVERNANCE_GATE`).
+9. Перед коммитом пройден review gate (`RUN_REVIEW_GATE`) с финальным `PASS_CONFIRMED`.
+10. Есть отдельное явное подтверждение пользователя на прохождение review (`Review Approved: yes`).
+11. Каждый коммит связан с issue/task (`TASK-ID` и/или `#issue` в commit message).
 
 Если хотя бы один пункт не выполнен, задача не принимается.
 
-## Правило диалога пользователя
-Коммиты и закрытие задач выполняются только по явному подтверждению пользователя в текущем диалоге:
-- `COMMIT_BY_NAME` — только после подтверждения пользователя;
-- перевод задачи в `DONE` — только после подтверждения пользователя;
-- без подтверждения максимум статуса: `READY`.
-
-## Публикация через Trusted Publishing (рекомендуется)
-В репозитории настроен workflow:
-- [.github/workflows/publish.yml](./.github/workflows/publish.yml)
-- Подробный регламент публикации: [PUBLISHING.md](./PUBLISHING.md)
-
-Он публикует пакет по тегу `v*` или вручную через `workflow_dispatch` и использует OIDC (`id-token: write`) вместо long-lived npm токена.
-
-Что нужно сделать в npm UI (один раз):
-1. Открой `npmjs.com -> Packages -> @k0t0vich/meta-agents-template -> Settings -> Trusted publishing`.
-2. Добавь trusted publisher типа `GitHub Actions` с полями:
-  - Organization/User: `k0t0vich`
-  - Repository: `meta-agents-template`
-  - Workflow filename: `publish.yml`
-3. Сохрани настройки.
+## Локальная проверка governance
+В сгенерированном проекте доступна команда:
 
-Как выпускать релиз:
 ```bash
-git tag v0.1.1
-git push origin v0.1.1
+npm run meta:verify
+npm run meta:review
+npm run meta:review-approve
+npm run meta:verify-link
 ```
 
-После этого GitHub Actions выполнит `npm publish --access public` автоматически.
+Она проверяет наличие обязательных PRD-блоков в задачах (`Описание`, `Проверяемость`, `Что сделано`) и валидирует базовую процессную дисциплину.
 
-Примечание:
-- если Trusted Publisher ещё не настроен, публикация из workflow не пройдет;
-- для максимальной безопасности после включения trusted publishing рекомендуется запретить publish через токены в настройках пакета.
+## Правило диалога пользователя
+Коммиты и закрытие задач выполняются только по явному подтверждению пользователя в текущем диалоге:
+- `COMMIT_BY_NAME` — только после подтверждения пользователя;
+- перевод задачи в `DONE` — только после подтверждения пользователя;
+- в single-branch режиме статусный цикл: `TODO -> IN_PROGRESS -> REVIEW -> READY -> DONE` (для релизных задач дополнительно `-> PUBLISH`);
+- без подтверждения максимум статуса: `REVIEW`;
+- `READY` разрешён только после `RUN_REVIEW_GATE: PASS_CONFIRMED`.
+- `READY` означает commit + push (в `main` или в ветку с открытым MR/PR);
+- `DONE` означает интеграцию в `main` (direct commit или merged MR/PR);
+- `PUBLISH` означает, что релиз опубликован и доступен в latest.
+- для большой фичи (в режиме GitHub tracker) агент обязан предложить `feature issue` + `epic issue` и отдельную ветку.
 
 ## Основные документы шаблона
 - [agents.md](./agents.md)

package/agents.md

@@ -22,6 +22,7 @@
 ## 3) Роли агентов
 - `Chief of Staff Agent`: оркестрация цепочки, приоритеты, блокеры, эскалации.
 - `Agile Manager Agent`: операции по задачам/спринтам/статусам/коммитам через трекер.
+- `Governance Watchdog Agent`: обязательный контроль PRD/критериев/разрешений перед каждой командой.
 - `Product Manager Agent`: формулирует PRD и критерии приёмки.
 - `Solution Architect Agent`: проектирует архитектуру и контракты компонентов.
 - `Verifier Designer Agent`: проектирует модель валидации и evidence-план.
@@ -91,10 +92,12 @@ Name: <agent role>
 Все рабочие операции проходят через `Agile Manager Agent` + `TrackerGateway`.
 Операционные шаблоны команд: [tracker-command-template.md](./tracker-command-template.md).
 
+0. `VERIFY_GOVERNANCE_GATE`
 1. `CREATE_TASK`
 2. `SET_STATUS`
-3. `COMMIT_BY_NAME`
-4. `ASSIGN_SPRINT`
+3. `RUN_REVIEW_GATE`
+4. `COMMIT_BY_NAME`
+5. `ASSIGN_SPRINT`
 
 ## 10) Коммиты и закрытие задач: только по подтверждению пользователя
 Запрещено выполнять автоматически:
@@ -102,9 +105,26 @@ Name: <agent role>
 - перевод задачи в `DONE`.
 
 Обязательное правило:
-- `COMMIT_BY_NAME` выполняется только после явного подтверждения пользователя в текущем диалоге;
+- для single-branch режима статусный цикл задачи фиксируется как `TODO -> IN_PROGRESS -> REVIEW -> READY -> DONE` (для релизных задач дополнительно `-> PUBLISH`);
+- `RUN_REVIEW_GATE` сначала формирует отчёт ревьювера и рекомендацию (`PASS_CANDIDATE`/`FAIL`);
+- финальный `RUN_REVIEW_GATE: PASS_CONFIRMED` допускается только после явного подтверждения пользователя `Review Approved: yes`;
+- `COMMIT_BY_NAME` выполняется только после `RUN_REVIEW_GATE: PASS_CONFIRMED` и отдельного явного подтверждения пользователя в текущем диалоге;
 - `SET_STATUS -> DONE` выполняется только после явного подтверждения пользователя в текущем диалоге;
-- без подтверждения пользователя максимум допустимого статуса: `READY`.
+- без подтверждения пользователя максимум допустимого статуса: `REVIEW`.
+- `SET_STATUS -> READY` разрешён только после `RUN_REVIEW_GATE: PASS_CONFIRMED`.
+- сообщение коммита обязано содержать ссылку на задачу (`TASK-ID` и/или `#issue-number`).
+- `READY` означает: коммит сделан и отправлен (`push`), при этом либо в `main`, либо в отдельной ветке с открытым MR/PR.
+- `DONE` означает: изменения интегрированы в `main` (прямой коммит в `main` или MR/PR смержен).
+- `PUBLISH` означает: релиз опубликован и доступен в последней версии пакета.
+
+## 10.1) Правило для больших фич (GitHub tracker)
+Если задача классифицирована как большая фича, система обязана предложить:
+- создать `feature issue` (`type:feature`);
+- создать `epic issue` (`type:epic`);
+- выделить отдельную ветку разработки;
+- связать feature с epic в GitHub issue (ссылка в body/comment/task list).
+
+Для текущего этапа (только GitHub tracker) epic реализуется как обычный issue с label `type:epic`.
 
 ## 11) Жёсткие критерии приёмки (все обязательны)
 Задача принимается только если одновременно выполнены все условия:
@@ -117,6 +137,15 @@ Name: <agent role>
 7. Синхронизированы `task/status/sprint` в трекере.
 8. Если был коммит, есть явное подтверждение пользователя на коммит.
 9. Если задача закрыта в `DONE`, есть явное подтверждение пользователя на закрытие.
+10. Перед каждой командой пройден `VERIFY_GOVERNANCE_GATE` от `Governance Watchdog Agent`.
+11. Перед коммитом пройден `RUN_REVIEW_GATE` от `Reviewer/Judge Agent`.
+12. Есть явное подтверждение пользователя на прохождение review (`Review Approved: yes`).
+13. До review gate задача переведена в статус `REVIEW`.
+14. Статус `READY` выставлен только после `RUN_REVIEW_GATE: PASS_CONFIRMED`.
+15. Для статуса `READY` подтверждены `commit + push` и путь интеграции (`main` или открытый MR/PR).
+16. Для статуса `DONE` подтверждена интеграция в `main` (direct commit или merged MR/PR).
+17. Для статуса `PUBLISH` подтверждена публикация в последней версии.
+18. Коммит содержит ссылку на issue/task (`TASK-ID` или `#issue`).
 
 Если хотя бы один критерий не выполнен, задача не принимается.
 

package/package.json

@@ -1,13 +1,16 @@
 {
   "name": "@k0t0vich/meta-agents-template",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Template system for verification-first agentic development",
   "type": "module",
   "bin": {
     "meta-agents": "bin/meta-agents.js"
   },
   "scripts": {
-    "start": "node bin/meta-agents.js --help"
+    "start": "node bin/meta-agents.js --help",
+    "self:sync": "node bin/meta-agents.js sync . --force",
+    "self:bootstrap": "npm run self:sync && node scripts/self-bootstrap.mjs",
+    "release:smoke-local": "node scripts/post-publish-local-smoke.mjs"
   },
   "files": [
     "README.md",

package/src/sync.mjs

@@ -10,6 +10,16 @@ const MANAGED_PATHS = [
   "tasks/task-status-log.md",
 ];
 
+const TEXT_EXTENSIONS = new Set([
+  ".md",
+  ".txt",
+  ".json",
+  ".yaml",
+  ".yml",
+  ".mjs",
+  ".js",
+]);
+
 async function exists(p) {
   try {
     await fs.access(p);
@@ -19,10 +29,79 @@ async function exists(p) {
   }
 }
 
+async function walkFiles(dir, list = []) {
+  const entries = await fs.readdir(dir, { withFileTypes: true });
+  for (const entry of entries) {
+    const entryPath = path.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      await walkFiles(entryPath, list);
+    } else {
+      list.push(entryPath);
+    }
+  }
+  return list;
+}
+
+function shouldReplacePlaceholders(filePath) {
+  return TEXT_EXTENSIONS.has(path.extname(filePath));
+}
+
+async function replaceInFile(filePath, values) {
+  if (!shouldReplacePlaceholders(filePath)) {
+    return;
+  }
+  const input = await fs.readFile(filePath, "utf8");
+  let output = input;
+  for (const [key, value] of Object.entries(values)) {
+    output = output.replaceAll(`__${key}__`, value);
+  }
+  if (output !== input) {
+    await fs.writeFile(filePath, output, "utf8");
+  }
+}
+
+async function replacePlaceholdersInManagedPaths(targetDir, managedPaths, values) {
+  for (const managedPath of managedPaths) {
+    const absolute = path.join(targetDir, managedPath);
+    if (!(await exists(absolute))) {
+      continue;
+    }
+
+    const stat = await fs.stat(absolute);
+    if (stat.isDirectory()) {
+      const files = await walkFiles(absolute);
+      for (const file of files) {
+        await replaceInFile(file, values);
+      }
+      continue;
+    }
+
+    await replaceInFile(absolute, values);
+  }
+}
+
+async function readCurrentDefaultTracker(targetDir) {
+  const trackersPath = path.join(targetDir, ".meta-agents", "config", "trackers.yaml");
+  if (!(await exists(trackersPath))) {
+    return null;
+  }
+  const input = await fs.readFile(trackersPath, "utf8");
+  const match = input.match(/default:\s*"?([a-zA-Z0-9_-]+)"?/);
+  if (!match || !match[1]) {
+    return null;
+  }
+  const value = match[1];
+  if (value.startsWith("__") && value.endsWith("__")) {
+    return null;
+  }
+  return value;
+}
+
 export async function syncTemplate({ cwd, templateRoot, target, force }) {
   const targetDir = path.resolve(cwd, target);
   const updated = [];
   const skipped = [];
+  const existingDefaultTracker = await readCurrentDefaultTracker(targetDir);
 
   for (const managedPath of MANAGED_PATHS) {
     const source = path.join(templateRoot, managedPath);
@@ -42,5 +121,11 @@ export async function syncTemplate({ cwd, templateRoot, target, force }) {
     updated.push(managedPath);
   }
 
+  const projectName = path.basename(targetDir);
+  await replacePlaceholdersInManagedPaths(targetDir, updated, {
+    PROJECT_NAME: projectName,
+    DEFAULT_TRACKER: existingDefaultTracker || "github",
+  });
+
   return { targetDir, updated, skipped };
 }

package/template/.meta-agents/config/roles.yaml

@@ -2,7 +2,9 @@ roles:
   - name: "Chief of Staff Agent"
     responsibility: "Оркестрация, блокеры, эскалации"
   - name: "Agile Manager Agent"
-    responsibility: "CREATE_TASK/SET_STATUS/COMMIT_BY_NAME/ASSIGN_SPRINT"
+    responsibility: "CREATE_TASK/SET_STATUS/COMMIT_BY_NAME/ASSIGN_SPRINT + epic/feature orchestration in GitHub tracker"
+  - name: "Governance Watchdog Agent"
+    responsibility: "Обязательный preflight-gate: PRD/acceptance/user confirmation policy"
   - name: "Product Manager Agent"
     responsibility: "PRD и acceptance criteria"
   - name: "Solution Architect Agent"
@@ -16,6 +18,8 @@ roles:
   - name: "QA Agent"
     responsibility: "Верификация и тестирование"
   - name: "Reviewer/Judge Agent"
-    responsibility: "Независимая приёмка"
+    responsibility: "Независимая приёмка + обязательный pre-commit review gate"
+  - name: "Publishing Agent"
+    responsibility: "Подготовка release notes, публикация релиза, перевод вошедших задач в PUBLISH"
   - name: "Documentation Agent"
     responsibility: "Синхронизация документации"

package/template/.meta-agents/config/system.yaml

@@ -23,9 +23,84 @@ system:
     offer_create_github_repo: true
   governance:
     user_confirmation_required_for:
+      - review_gate_pass
       - commit
       - task_close_done
-    max_status_without_user_confirmation: READY
+      - release_publish
+    max_status_without_user_confirmation: REVIEW
+    status_lifecycle:
+      mode: single_branch
+      sequence:
+        - TODO
+        - IN_PROGRESS
+        - REVIEW
+        - READY
+        - DONE
+        - PUBLISH
+      rules:
+        - ready_only_after_review_pass_confirmed
+        - done_only_after_user_confirmation
+        - publish_only_after_done
+      github_status_labels:
+        - TODO
+        - IN_PROGRESS
+        - REVIEW
+        - READY
+        - BLOCKED
+        - DONE
+        - PUBLISH
+      semantics:
+        READY: "Commit created and pushed; either main branch commit or feature branch with open MR/PR."
+        DONE: "Changes integrated to main (direct commit on main or MR/PR merged)."
+        PUBLISH: "Released and available in latest published package version."
+    epic_policy:
+      github_only: true
+      large_feature_requires_epic: true
+      required_actions:
+        - propose_feature_issue
+        - propose_epic_issue
+        - create_dedicated_branch
+        - link_feature_to_epic
+    watchdog:
+      required: true
+      before_commands:
+        - VERIFY_GOVERNANCE_GATE
+        - CREATE_TASK
+        - SET_STATUS
+        - RUN_REVIEW_GATE
+        - COMMIT_BY_NAME
+        - ASSIGN_SPRINT
+        - PREPARE_RELEASE_NOTE
+        - MARK_TASKS_PUBLISH
+      minimum_checks:
+        - prd_sections_complete
+        - acceptance_criteria_defined
+        - user_confirmation_policy_respected
+    review_gate:
+      required_before_commit: true
+      command: RUN_REVIEW_GATE
+      reporter_role: "Reviewer/Judge Agent"
+      required_user_acknowledgement: true
+      recommendation_statuses:
+        - PASS_CANDIDATE
+        - FAIL
+      final_status: PASS_CONFIRMED
+      required_sections:
+        - what_done_summary
+        - critical_findings
+        - potential_risks
+        - recommendation_pass_or_fail
+      block_on_critical: true
+    commit_linkage:
+      required: true
+      accepted_patterns:
+        - "TASK-ID"
+        - "#issue"
+    publish_flow:
+      release_note_required: true
+      release_note_must_include_tasks: true
+      mark_included_tasks_publish: true
+      publish_status_label: PUBLISH
   acceptance:
     hard_criteria:
       - prd_sections_complete
@@ -35,6 +110,16 @@ system:
       - human_approvals_passed
       - evidence_pack_complete
       - tracker_sync_complete
+      - watchdog_gate_passed
+      - review_gate_passed
+      - review_user_acknowledged
+      - ready_has_commit_and_push
+      - done_integrated_to_main
+      - release_note_created
+      - release_note_includes_tasks
+      - release_tasks_marked_publish
+      - publish_released_latest
+      - commit_linked_to_issue
   auto_select:
     required: true
     before_each_task: true

package/template/.meta-agents/config/trackers.yaml

@@ -4,6 +4,17 @@ tracker_gateway:
     github:
       mode: "issues_projects"
       enabled: true
+      status_labels:
+        - TODO
+        - IN_PROGRESS
+        - REVIEW
+        - READY
+        - BLOCKED
+        - DONE
+        - PUBLISH
+      hierarchy_labels:
+        epic: "type:epic"
+        feature: "type:feature"
     mcp:
       mode: "external_tracker_via_mcp"
       enabled: true

package/template/.meta-agents/prompts/agile-manager.md

@@ -1,3 +1,5 @@
 Role: Agile Manager Agent
 Goal: управлять задачами и статусами через TrackerGateway.
 Commands: CREATE_TASK, SET_STATUS, COMMIT_BY_NAME, ASSIGN_SPRINT.
+Status semantics: READY = commit+push; DONE = integrated to main; PUBLISH = published in latest version.
+Rule: для большой фичи в GitHub tracker сначала предложить связку `feature issue` + `epic issue` и выделенную ветку.

package/template/.meta-agents/prompts/clarifier.md

@@ -1,3 +1,4 @@
 Role: Clarifier Agent
 Goal: выявить цель, ограничения, неоднозначности и критерии успеха.
+Rule: если задача классифицируется как большая фича, обязательно предложить создать `feature issue` и `epic issue` в GitHub tracker, а также отдельную ветку.
 Output: PRD Step с заполненными "Описание" и "Проверяемость".

package/template/.meta-agents/prompts/governance-watchdog.md

@@ -0,0 +1,3 @@
+Role: Governance Watchdog Agent
+Goal: блокировать выполнение команды, если не выполнены PRD/acceptance/user-confirmation требования.
+Rule: без PASS от governance gate команда не исполняется.

package/template/.meta-agents/prompts/publishing-agent.md

@@ -0,0 +1,7 @@
+Role: Publishing Agent
+Goal: подготовить релиз, зафиксировать release notes и перевести вошедшие задачи в статус PUBLISH.
+Rule:
+- перед публикацией создать release note со списком issue/tasks, вошедших в релиз;
+- после подтверждённой публикации обновить статусы всех вошедших задач на `PUBLISH` в GitHub tracker;
+- для каждого релиза оставлять ссылку на release note и версию.
+Output: release note path + список задач + подтверждение обновления статусов.

package/template/.meta-agents/prompts/reviewer-judge.md

@@ -1,3 +1,7 @@
 Role: Reviewer/Judge Agent
-Goal: независимая приёмка по критериям.
+Goal: независимая приёмка по критериям и обязательный pre-commit review gate.
+Output format: что сделано, критические замечания, потенциальные риски, рекомендация PASS_CANDIDATE/FAIL.
+Rule: финальный PASS_CONFIRMED только после явного `Review Approved: yes` от пользователя.
+Status rule: перед review gate задача должна быть в статусе `REVIEW`; статус `READY` выставляется только после `PASS_CONFIRMED`.
+Delivery rule: `READY` требует commit+push; `DONE` требует интеграцию в `main`; `PUBLISH` только после фактической публикации.
 Output: accepted/rejected + findings.

package/template/.meta-agents/scripts/run-review-gate.mjs

@@ -0,0 +1,151 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { execFileSync } from "node:child_process";
+
+function parseArgs(argv) {
+  const options = {
+    approve: false,
+  };
+
+  for (let index = 0; index < argv.length; index += 1) {
+    const arg = argv[index];
+    if (arg === "--approve") {
+      const value = (argv[index + 1] || "").trim().toLowerCase();
+      options.approve = value === "yes" || value === "true" || value === "1";
+      index += 1;
+    }
+  }
+
+  return options;
+}
+
+function git(args, allowFailure = false) {
+  try {
+    const output = execFileSync("git", args, { encoding: "utf8" });
+    return output.trim();
+  } catch (error) {
+    if (allowFailure) {
+      return "";
+    }
+    throw error;
+  }
+}
+
+function splitLines(value) {
+  if (!value) {
+    return [];
+  }
+  return value
+    .split("\n")
+    .map((line) => line.trim())
+    .filter(Boolean);
+}
+
+function matchTestFile(filePath) {
+  return /(^|\/)(tests?|__tests__)\//i.test(filePath) || /\.(test|spec)\.[cm]?[jt]sx?$/i.test(filePath);
+}
+
+async function scanMarkers(files) {
+  const markers = [];
+  // Match common marker formats while ignoring status arrows in workflow lines.
+  const pattern = /\b(TODO|FIXME|XXX|HACK)\b\s*(?::|-(?!>))/;
+
+  for (const file of files) {
+    try {
+      const content = await fs.readFile(path.resolve(process.cwd(), file), "utf8");
+      const lines = content.split("\n");
+      for (let index = 0; index < lines.length; index += 1) {
+        const line = lines[index];
+        if (pattern.test(line)) {
+          markers.push(`${file}:${index + 1} -> ${line.trim()}`);
+        }
+      }
+    } catch {
+      // Skip binary/unreadable files.
+    }
+  }
+
+  return markers;
+}
+
+async function main() {
+  const options = parseArgs(process.argv.slice(2));
+  const stagedFiles = splitLines(git(["diff", "--cached", "--name-only"], true));
+  const recentFiles = splitLines(git(["show", "--name-only", "--pretty=", "HEAD"], true));
+  const files = stagedFiles.length > 0 ? stagedFiles : recentFiles;
+
+  if (files.length === 0) {
+    console.log("Review Gate FAIL");
+    console.log("- reason: no staged or recent changes detected");
+    process.exit(1);
+  }
+
+  const critical = [];
+  const risks = [];
+
+  const markers = await scanMarkers(files);
+  if (markers.length > 0) {
+    critical.push(...markers.slice(0, 20));
+  }
+
+  const sourceTouched = files.some((file) => file.startsWith("src/") || file.startsWith("template/"));
+  const testsTouched = files.some((file) => matchTestFile(file));
+  if (sourceTouched && !testsTouched) {
+    risks.push("Source/template changes detected without explicit test changes.");
+  }
+
+  console.log("# Review Gate Report");
+  console.log("");
+  console.log("## Что сделано");
+  for (const file of files) {
+    console.log(`- changed: ${file}`);
+  }
+
+  console.log("");
+  console.log("## Критические замечания");
+  if (critical.length === 0) {
+    console.log("- none");
+  } else {
+    for (const item of critical) {
+      console.log(`- ${item}`);
+    }
+  }
+
+  console.log("");
+  console.log("## Потенциальные риски");
+  if (risks.length === 0) {
+    console.log("- none");
+  } else {
+    for (const item of risks) {
+      console.log(`- ${item}`);
+    }
+  }
+
+  console.log("");
+  console.log("## Рекомендация ревьювера");
+  console.log(critical.length === 0 ? "- PASS_CANDIDATE" : "- FAIL");
+
+  if (critical.length > 0) {
+    console.log("");
+    console.log("## Решение");
+    console.log("- FAIL");
+    process.exit(1);
+  }
+
+  console.log("");
+  if (!options.approve) {
+    console.log("## Решение");
+    console.log("- PENDING_USER_CONFIRMATION");
+    console.log("- Требуется явное подтверждение пользователя: Review Approved = yes");
+    process.exit(2);
+  }
+
+  console.log("## Решение");
+  console.log("- PASS_CONFIRMED");
+  process.exit(0);
+}
+
+main().catch((error) => {
+  console.error(`Review Gate FAIL: ${error.message}`);
+  process.exit(1);
+});