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

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

Отсутствующий обязательный ресурс в shipping-варианте

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

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

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

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