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

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

Избыточная доступность API

api.access-narrowing@1.0.0
Принят subsetExperimental1 условие

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

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

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