# Запуск демо-версии с настройками по умолчанию
python demo_patch_review.py

# С пользовательской базой данных
python demo_patch_review.py --db /путь/к/cpg.duckdb

# Без функции DoD
python demo_patch_review.py --no-dod

# Автоматическая генерация DoD вместо извлечения из PR
python demo_patch_review.py --auto-dod

# Интерактивное подтверждение DoD (просмотр и редактирование перед продолжением)
python demo_patch_review.py --interactive
python demo_patch_review.py -i

import duckdb
from src.patch_review import ReviewWorkflow

# Подключение к базе данных CPG
conn = duckdb.connect('cpg.duckdb')

# Настройка параметров DoD
dod_config = {
    'auto_generate': True,
    'interactive': False,  # Установите True для интерактивного подтверждения DoD
    'extraction': {
        'sources': ['pr_body', 'jira', 'commit_message'],
        'formats': ['checklist', 'yaml', 'markdown'],
    },
}

# Создание рабочего процесса
workflow = ReviewWorkflow(conn, dod_config=dod_config)

# Запуск проверки
verdict = workflow.run(
    patch_source='git_diff',
    patch_data={'diff': содержание_diff},
    pr_body=описание_pr,  # Для извлечения DoD
    task_description=описание_задачи,  # Для генерации DoD
    interactive_mode=False,  # Установите True для интерактивного подтверждения DoD
)

# Доступ к результатам
print(f"Оценка: {verdict.overall_score}/100")
print(f"Рекомендация: {verdict.recommendation.value}")

# Результаты проверки DoD
if verdict.dod_validation:
    print(f"Соответствие DoD: {verdict.dod_validation.compliance_score}%")

parse_patch → extract_dod → [generate_dod] → [confirm_dod] → generate_delta_cpg
    ↓
run_analyzers → generate_verdicts → aggregate → validate_dod → format_output

- [ ] Покрытие тестами не менее 80%
- [ ] Прошёл CI/CD
- [ ] Обновлена документация
- [ ] Проведён код-ревью

#### Блок YAML
```yaml
```yaml
dod:
  - description: Функциональность работает, как ожидается
    type: functional
  - description: Модульные тесты проходят
    type: test

#### Блок JSON
```json
```json
{
  "dod": [
    {"description": "Функциональность работает", "type": "functional"},
    {"description": "Тесты проходят", "type": "test"}
  ]
}

### Типы критериев

| Тип | Описание | Проверка |
|------|-------------|------------|
| `functional` | Требования к функциональности | Ручная проверка (невозможно автоматически проверить) |
| `security` | Отсутствие уязвимостей | Оценка по результатам анализа безопасности |
| `test` | Наличие и прохождение тестов | Рекомендации по ошибкам |
| `documentation` | Обновление документации | Ручная проверка |
| `performance` | Отсутствие регрессии производительности | Оценка производительности |
| `code_quality` | Соответствие стилю кода | Оценка архитектуры |

### Интерактивное подтверждение DoD

При запуске с флагом `--interactive` пользователь может просмотреть и изменить DoD перед началом проверки:

**Опции:**
- **Подтвердить (c)** — Принять текущее DoD и продолжить проверку
- **Редактировать (e)** — Изменить описания и типы пунктов
- **Добавить (a)** — Добавить новые пункты DoD с выбором типа
- **Удалить (r)** — Удалить пункты из списка
- **Пропустить (s)** — Пропустить проверку DoD полностью (проверка продолжится без DoD)
- **Отмена (q)** — Отменить процесс проверки

**Горячие клавиши для добавления/редактирования:**
| Клавиша | Тип |
|----------|------|
| `f` | Функциональный |
| `s` | Безопасность |
| `t` | Тестирование |
| `d` | Документация |
| `p` | Производительность |
| `q` | Качество кода |

### Проверка DoD

Каждый пункт DoD проверяется на соответствие результатам анализа:

- **Безопасность**: Проверяется по результатам анализа безопасности (наличие критических или серьёзных уязвимостей приводит к провалу)
- **Тесты**: Проверяется по количеству рекомендаций по тестам
- **Производительность**: Проверяется по оценке производительности
- **Качество кода**: Проверяется по оценке архитектуры
- **Функциональность/Документация**: Не могут быть проверены автоматически (требуется ручная проверка)

## Конфигурация

### config/code_review.yaml

```yaml
# Конфигурация определения готовности (Definition of Done)
dod:
  sources:  # Источники получения критериев готовности
    - pr_body
    - jira
    - commit_message
    - manual
  source_priority:  # Приоритет источников при объединении данных
    - pr_body
    - jira
    - commit_message
  formats:  # Поддерживаемые форматы описания критериев
    - checklist
    - yaml
    - markdown
    - json
  auto_generate: true  # Автоматически генерировать критерии, если не найдены
  interactive_confirm: false  # Включить подтверждение в CLI (диалоговые запросы)

  # Интеграция с Jira
  jira:
    url: ${JIRA_URL}
    api_key: ${JIRA_API_KEY}
    dod_field: "customfield_10001"  # ID кастомного поля в Jira для критериев готовности

  # Настройки валидации
  validation:
    strict_mode: false  # Строгий режим валидации (прерывать при ошибках)
    blocking_severities:  # Уровни серьёзности, блокирующие мердж
      - critical
      - high

# Политика ревью
policy:
  block_on_critical_security: true  # Блокировать слияние при критических уязвимостях
  min_score_to_approve: 70.0  # Минимальный общий балл для одобрения ревью
  require_dod_compliance: false  # Требовать соответствие критериям готовности
  min_dod_compliance_score: 60.0  # Минимальный балл соответствия DoD

# Веса вердиктов
verdicts:
  weights:
    security: 0.35      # Безопасность
    performance: 0.20   # Производительность
    error: 0.25         # Обработка ошибок
    architecture: 0.20  # Архитектура
  dod_compliance_weight: 0.10  # Вес соответствия критериям готовности

workflow = ReviewWorkflow(
    conn: duckdb.DuckDBPyConnection,
    config: Optional[AggregationConfig] = None,
    policy: Optional[ReviewPolicy] = None,
    dod_config: Optional[Dict[str, Any]] = None,
)

verdict = workflow.run(
    patch_source: str,  # 'git_diff', 'github_pr', 'gitlab_mr'
    patch_data: Dict[str, Any],
    session_id: Optional[str] = None,
    policy: Optional[ReviewPolicy] = None,
    task_description: Optional[str] = None,
    pr_body: Optional[str] = None,
    jira_ticket: Optional[str] = None,
    interactive_mode: bool = False,
)

class ReviewVerdict:
    patch_id: str
    overall_score: float  # 0–100
    recommendation: Recommendation  # APPROVE, REQUEST_CHANGES, BLOCK, COMMENT

    # Подрезультаты
    security: SecurityVerdict
    performance: PerformanceVerdict
    error: ErrorVerdict
    architecture: ArchitectureVerdict

    # Обнаруженные проблемы
    all_findings: List[Finding]
    critical_count: int
    high_count: int
    medium_count: int
    low_count: int

    # Проверка соответствия Definition of Done (DoD)
    dod_validation: Optional[DoDValidationResult]
    dod_compliance_score: float  # 0–100

class DoDValidationResult:
    dod: DefinitionOfDone
    total_items: int
    satisfied_count: int
    failed_count: int
    pending_count: int
    compliance_score: float  # 0–100
    blocking_failures: List[DoDItem]
    is_compliant: bool  # True, если все пункты выполнены

{
  "patch_id": "PATCH_abc123",
  "overall_score": 45.5,
  "recommendation": "REQUEST_CHANGES",
  "dod_compliance_score": 60.0,
  "findings": [...],
  "dod_validation": {
    "compliance_score": 60.0,
    "items": [
      {"description": "...", "satisfied": true, "evidence": "..."},
      {"description": "...", "satisfied": false, "evidence": "..."}
    ]
  }
}

# Обработка события из GitHub PR
pr_data = {
    'number': 123,
    'title': 'Добавить аутентификацию',
    'body': pr_body_with_dod,
    'diff_url': 'https://api.github.com/repos/...',
}

verdict = workflow.run(
    patch_source='github_pr',
    patch_data=pr_data,
    pr_body=pr_data['body'],
)

mr_data = {
    'iid': 456,
    'title': 'Добавить аутентификацию',
    'description': mr_description_with_dod,
}

verdict = workflow.run(
    patch_source='gitlab_mr',
    patch_data=mr_data,
    pr_body=mr_data['description'],
)

from src.patch_review.dod import DoDExtractor

extractor = DoDExtractor()
dod = extractor.create_manual_dod(
    items=[
        "Функция работает как ожидается",
        "Отсутствуют уязвимости безопасности",
        "Добавлены модульные тесты",
    ],
    types=["functional", "security", "test"],
)