ARCH / Архитектура и достижимость
Утечка implementation type через API
[email protected]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
Изменение статуса требует обновления подтверждённого среза и проверки каталога. Количество страниц не является количеством полностью квалифицированных правил.