ARCH / Архитектура и достижимость
Избыточная доступность API
[email protected]V-ARCH-04 · Возможность улучшения
Избыточная доступность API
Лишняя публичность создаёт обязательства совместимости и позволяет внешнему коду зависеть от деталей реализации.
Пример проблемы и направление исправления
Учебные сокращённые фрагменты Swift или схемы протокола. Вспомогательные API условны. Это не тестовые oracle и не обещание, что текущий subset выдаст диагностику именно на этот код.
Проблемный сценарий
public struct InternalCache { }
// Все допустимые consumers находятся внутри модуля.
Возможное исправление
internal struct InternalCache { }
Что изменить и что сохранить
Сужай доступность лишь после проверки source/ABI, subclassing и динамических ролей. Отсутствие вызовов внутри репозитория не закрывает внешний мир.
Что нужно доказать
Все допустимые consumers помещаются в более узкий access scope
Требуемые факты по контракту: closed world, roots, dispatch, architecture clauses
Безопасные случаи и границы
Open-world API не предлагать закрыть без consumer evidence
Если необходимые факты не получены, результат — 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
Изменение статуса требует обновления подтверждённого среза и проверки каталога. Количество страниц не является количеством полностью квалифицированных правил.