Перейти к основному содержимому
Разделы документации
← Каталог правил

ARCH / Архитектура и достижимость

Утечка implementation type через API

[email protected]
Принят subsetExperimental1 условие

V-ARCH-08 · Нарушение контракта

Утечка implementation type через API

Внутренний тип в публичной сигнатуре заставляет пользователей API знать о реализации и может нарушать границы модулей.

Пример проблемы и направление исправления

Учебные сокращённые фрагменты Swift или схемы протокола. Вспомогательные API условны. Это не тестовые oracle и не обещание, что текущий subset выдаст диагностику именно на этот код.

Проблемный сценарий

// Policy: DatabaseRow не должен быть частью внешнего API.
public func load() -> DatabaseRow { /* ... */ }

Возможное исправление

public func load() -> UserDTO { /* ... */ }

Что изменить и что сохранить

Верни публичный тип контракта либо измени границу осознанно. Проверяй сигнатуры, а не только тела функций.

Что нужно доказать

Exported signature содержит тип за запрещённой boundary

Требуемые факты по контракту: 004/012 manifests, symbol providers, resource resolution

Безопасные случаи и границы

Сам по себе public type не нарушает policy

Если необходимые факты не получены, результат — unknown, а не «ошибки нет». Для review-сигнала также нужен наблюдаемый риск; нехватки данных недостаточно.

Что подтверждено сейчас

Принят bounded source subset по контракту задачи. Подтверждение распространяется только на допущенные source forms, профиль сборки, positive/negative и unknown-границы из приёмки. Пример выше и весь класс похожих программ автоматически принятыми не становятся.

Контракты и происхождение

Страница объединяет утверждённый реестр и редакционные объяснения из Git-среза 4558458d. Raw engineering contracts не входят в public artifact; точные пути остаются во внутреннем manifest.

  • Целевой каталог: docs/product/final-rule-catalog.md
  • Реестр RuleID: docs/evidence/matrices/022-complete-rule-portfolio.md
  • Матрица условий: openspec/specs/022-complete-rule-portfolio/coverage-matrix.md
  • Срез приёмки: openspec/specs/022-complete-rule-portfolio/reports/source-authority-recovery.md
  • Приёмка: t008-t009-source-batch: openspec/specs/022-complete-rule-portfolio/reports/t008-t009-source-batch.md
  • Приёмка: t012-t015-source-batch: openspec/specs/022-complete-rule-portfolio/reports/t012-t015-source-batch.md
  • Приёмка: t011-delivery: openspec/specs/022-complete-rule-portfolio/reports/t011-delivery.md
  • Приёмка: t014-delivery: openspec/specs/022-complete-rule-portfolio/reports/t014-delivery.md

Изменение статуса требует обновления подтверждённого среза и проверки каталога. Количество страниц не является количеством полностью квалифицированных правил.

← Вернуться к результатам поиска