ARCH / Архитектура и достижимость
Отсутствующий обязательный ресурс в shipping-варианте
[email protected]V-ARCH-10 · Дефект
Отсутствующий обязательный ресурс в shipping-варианте
Обязательный lookup отсутствующего ресурса приводит к неработающему пути или аварийному unwrap. Это проверяется относительно состава конкретной сборки.
Пример проблемы и направление исправления
Учебные сокращённые фрагменты Swift или схемы протокола. Вспомогательные API условны. Это не тестовые oracle и не обещание, что текущий subset выдаст диагностику именно на этот код.
Проблемный сценарий
import Foundation
public func template() -> URL {
Bundle.module.url(forResource: "template", withExtension: "txt")!
}
// В подтверждённом bundle нет template.txt.
Возможное исправление
// Добавить template.txt в ресурсы target и проверить копирование.
// Либо изменить контракт API на optional и обработать отсутствие.
Что изменить и что сохранить
Если ресурс обязателен — включи его в сборку. Если отсутствие допустимо — отрази это в API и обработай в consumer; удаление ! без изменения контракта недостаточно.
Что нужно доказать
Достижимый consumer требует ресурс, которого нет в полном bundle/configuration manifest
Требуемые факты по контракту: 004/012 manifests, symbol providers, resource resolution
Безопасные случаи и границы
Optional lookup, fallback и неизвестный generated resource не дефект
Если необходимые факты не получены, результат — unknown, а не «ошибки нет». Для review-сигнала также нужен наблюдаемый риск; нехватки данных недостаточно.
Что подтверждено сейчас
Приняты literal resource lookup в ограниченном SwiftPM-пакете: происхождение copied resource и generated accessor проверяется по сборке. Обязательный lookup отделён от optional/fallback. Произвольные bundles и динамические пути этим не покрыты.
Контракты и происхождение
Страница объединяет утверждённый реестр и редакционные объяснения из 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
Изменение статуса требует обновления подтверждённого среза и проверки каталога. Количество страниц не является количеством полностью квалифицированных правил.