3-6. Типизированные черновики статических ресурсов #13
Notifications
Due Date
No due date set.
Blocks
Depends on
#14 3-7. Публикация ресурсов и привязка версий к агенту
bsodfather/crank
#28 3-Р. Итоговая ретроспектива этапа 3
bsodfather/crank
#12 3-5. Уведомления об изменении каталога инструментов
bsodfather/crank
Reference: bsodfather/crank#13
Reference in new issue
Block a user
Результат задачи
Добавить создание и редактирование статических ресурсов с проверкой типа и содержимого.
Что необходимо сделать и проверить
Зависимости
3-1 — #8.
Приёмка
Требования: FR-15, FR-16. Это задача разработки. Проверить её результат и все обязательные критерии: применимые модульные, интеграционные, отрицательные и сквозные проверки, сборку и предусмотренные проверки проекта. Зафиксировать фактические результаты и оставшиеся ограничения. Будущие приёмочные испытания других задач не выполняются попутно.
Полный обязательный контракт задачи и подробные критерии. Описание выше поясняет работу; ссылка сохраняет полный объём требований, включая ограничения и отрицательные сценарии. Сокращённое описание не заменяет и не ослабляет исходные критерии.
Утверждённое изменение контракта — 2026-10-11
Владелец согласовал ровно две целевые MCP revisions:
2026-07-28и2025-11-25, Resource-first порядок3.1 → 3.6 → 3.7 → 3.8, узкие method services и перенос production experimental configuration до первой реальной extension. Этот раздел и полный актуальный контракт ниже заменяют противоречащие им старые формулировки, включая историческое вложение. Остальные требования и доказательства не ослаблены. Это изменение планирования, НЕ выполненная разработка или PASS. Требования ≥3 representative real clients, NFR-P4, FR-54, immutable RC и отдельная release qualification сохраняются. Runtime пока остаётся pre-change; будущая реализация обслуживает только две целевые revisions и безопасно отклоняет остальные без implicit fallback.Полный актуальный scoped contract
Story 3.6: Сохранять typed static Resource Drafts
Depends on: Story 3.1 (обновлено владельцем 2026-10-11: Resource-вертикаль стартует после минимальной protocol/auth foundation 3.1; прежняя зависимость от Tools-модернизации 3.5 снята, при этом 3.2–3.5 сохраняют собственные зависимости и остаются обязательной работой Epic 3)
Work type: implementation
Deliverable: Сохранять typed static Resource Drafts.
Completion: outcome этой story и все её AC проверены; будущая qualification не выполняется попутно.
As an администратор,
I want безопасно сохранять text, JSON и binary Resource Drafts,
So that content имеет typed contract, bounded artifact и безопасный preview.
Requirements: FR-15, FR-16
Acceptance Criteria:
Given Resource domain model
When добавляется persistence и API contract
Then Resource является отдельным typed aggregate с собственными ID/version/lifecycle,
CapabilityKind::Resource, sensitivity и immutable Published VersionAnd не хранится как untyped Operation subtype или универсальный JSON blob.
Given новый Resource Draft
When администратор выбирает static text, JSON или binary kind
Then задаются URI, name, description, MIME type, sensitivity и bounded content
And URI и name валидируются как стабильные capability identifiers.
Given static content
When оно сохраняется
Then bytes размещаются в content-addressed artifact store, а Resource Version хранит exact digest и metadata
And filesystem path, raw upload filename или mutable external reference не входит в published contract.
Given JSON Resource
When Draft сохраняется или preview-ится
Then content валидируется как JSON и возвращается без изменения data semantics
And malformed либо oversized JSON отклоняется до publication.
Given text Resource
When content принимается
Then он сохраняет валидный UTF-8 в пределах configured size
And invalid encoding или unsafe truncation отклоняются с stable finding.
Given binary Resource
When он preview-ится или читается через MCP
Then MIME, byte size и negotiated binary representation соблюдаются version adapter
And content не декодируется как text и не помещается целиком в logs/errors.
Given Resource с active либо browser-renderable content type, включая HTML или SVG
When Admin UI показывает preview/download
Then untrusted bytes не исполняются в origin Crank: используется inert text/metadata, sandboxed isolated preview либо attachment download по explicit allowlist
And response применяет safe
Content-Type,nosniff, CSP/sandbox и filename sanitization без content sniffing.Given static Resource Draft suite
When выполняются domain, artifact и API tests
Then покрыты text/JSON/binary validation, MIME/size, active-content preview, malformed encoding и artifact integrity
And
just verifyпроходит.