randomayzer/agents/antigravity/done/TASK-2026-08-21-11-dead-code-cleanup.md

Task 11: Удаление мёртвого кода Report

Date: 2026-08-21
Base Commit SHA: 1883a864023b0b10fe6674a035fbcffa7461c3c8
Status: COMPLETED / PASS
Assigned Agent: Antigravity (Implementation Orchestrator)

---

1. Executive Summary

Проведена чистка мертвого и дублирующего кода, устранен технический долг без изменения боевых инвариантов:

1. Удален неиспользуемый импорт:
   • generateCryptoSecureSeed удален из src/app/api/giveaways/[id]/draw/route.ts.
2. Ликвидация дублирующей фабрики ProviderRegistry (src/providers/registry.ts):
   • Файл src/providers/registry.ts удален.
   • Метод getProvider(platform) перенесен в каноническую фабрику ProviderFactory (src/providers/factory.ts), реализующую строгий fail-closed контроль наличия VK_SERVICE_TOKEN в production.
   • Все тестовые вызовы (tests/concurrency.test.ts, tests/payload-summary-regression.test.ts, tests/winner-count-contract.test.ts, tests/security.test.ts) и документация docs/ARCHITECTURE.md переведены на ProviderFactory.
3. Объединение валидации возможностей провайдера (validateProviderCapabilities):
   • Проверка requireSubscription перенесена в канонический валидатор validateProviderCapabilities (src/core/validation/giveaway-schemas.ts).
   • Дублирующий модуль src/core/filtering/rule-validation.ts удален.
   • Тестовый набор tests/provider-capabilities.test.ts перенастроен на тестирование validateProviderCapabilities (все 11 тестов успешны).
4. Удаление GiveawayStore.listAll (src/lib/giveaway-store.ts):
   • Неиспользуемый метод listAll удален из класса GiveawayStore.
5. Упрощение getOAuthClient() (src/integrations/vk/vk-oauth-client.ts):
   • Удалены избыточные тождественные ветви if/else, возвращавшие одну и ту же переменную defaultVkOAuthClient.
6. Сохранение статусов FSM (DRAFT, FETCHING, PUBLISHED, CANCELLED):
   • Статусы сохранены в GiveawayStatusType и таблице переходов FSM согласно контракту (являются заделом под фичи публикации итогов в группу VK и отмены конкурса).

---

2. Modified & Deleted Files

File	Status	Description
src/core/filtering/rule-validation.ts	DELETED	Удален дублирующий валидатор правил.
src/providers/registry.ts	DELETED	Удалена неконсистентная фабрика ProviderRegistry.
src/app/api/giveaways/[id]/draw/route.ts	MODIFIED	Удален неиспользуемый импорт generateCryptoSecureSeed.
src/providers/factory.ts	MODIFIED	Добавлен метод getProvider(platform: PlatformType) с fail-fast проверкой неподдерживаемых платформ.
src/core/validation/giveaway-schemas.ts	MODIFIED	В validateProviderCapabilities добавлена проверка requireSubscription.
src/lib/giveaway-store.ts	MODIFIED	Удален неиспользуемый метод listAll.
src/integrations/vk/vk-oauth-client.ts	MODIFIED	Упрощена функция getOAuthClient().
tests/provider-capabilities.test.ts	MODIFIED	Переведен на validateProviderCapabilities и ProviderFactory.
tests/concurrency.test.ts	MODIFIED	Удален импорт и вызовы ProviderRegistry.
tests/payload-summary-regression.test.ts	MODIFIED	Удален импорт и вызовы ProviderRegistry.
tests/winner-count-contract.test.ts	MODIFIED	Удален импорт и вызовы ProviderRegistry.
tests/security.test.ts	MODIFIED	Переведен на ProviderFactory.
docs/ARCHITECTURE.md	MODIFIED	Обновлена ссылка на ProviderFactory.

---

3. Предложение следующей задачи (FSM Statuses Lifecycle)

Статусы DRAFT, FETCHING, PUBLISHED, CANCELLED сохранены в src/core/fsm/giveaway-fsm.ts. Рекомендуется оформить отдельную задачу на реализацию недостающих пользовательских сценариев:

1. POST /api/giveaways/[id]/cancel — отмена активного розыгрыша организатором с фиксацией аудиторного события (status: 'CANCELLED').
2. POST /api/giveaways/[id]/publish — автоматическая публикация карточки с итогами и победителями на стену сообщества через VK API (status: 'PUBLISHED').

---

4. Verification Evidence

npx prisma generate  -> EXIT 0
npx tsc --noEmit     -> EXIT 0
npm test             -> EXIT 0 (57 suites, 333 tests passed)
npm run lint         -> EXIT 0 (0 errors, 6 warnings on no-img-element)
npm run build        -> EXIT 0 (All 17 routes compiled successfully)
npm audit --omit=dev -> EXIT 0 (0 vulnerabilities)