Приложение C — Общий контракт возможностей
Общий контракт возможностей (Common Capability Contract) — это общая граница, позволяющая разным командам работать ещё до появления финального hardware. Он описывает функцию, а не неограниченное разрешение использовать Resource.
C.Field — contract_id
Стабильный идентификатор контракта функции или Profile.
C.Field — function
Понятное человеку действие/результат, например
locate_marks.
C.Field — input_schema
Versioned input objects, единицы, допустимые диапазоны и обязательные файлы.
C.Field — output_schema
Versioned result, поля качества, единицы, ссылки Evidence и error states.
C.Field —
resource_target
HSIMC Resource или класс цели; фактический физический instance привязывается отдельно.
C.Field —
execution_mode
simulation / physical_reference / physical_delivered / operational.
C.Field — conditions
Среда, tooling, calibration, material и prerequisite conditions.
C.Field —
authority_required
Минимальная Authority, требуемая для discover, read, reserve, configure, execute, stop, accept или administer.
C.Field —
effect_identity
Digest или identifier, фиксирующий намеренный физический эффект независимо от краткоживущих credentials.
C.Field — operation_id
Стабильная identity, используемая для retry/read-back запроса с физическим эффектом.
C.Field —
freshness_requirement
Максимально допустимый возраст observations, используемых для авторизации или планирования действия.
C.Field —
resource_locking
Reservation, lease, поведение busy/conflict и правило release.
C.Field —
safety_boundary
Условия, которые должны оставаться локальными/детерминированными и не могут быть делегированы удалённой модели.
C.Field — acceptance
Measurement, tolerances, Evidence и шаг human/organizational acceptance.
C.Field — recovery
Поведение stop, unknown-result, interrupted-network и restart.
C.Field — version
Ссылки на версии contract, adapter, algorithm, hardware/BOM, calibration и deployment.
C.Field — cost_time
Поля ожидаемого и фактического времени, material, energy и monetary cost.
C.Field — rights
Ограничения contribution, reuse, attribution, confidentiality и withdrawal.
C.1 Пример —
locate_marks
{
"contract_id": "hsimc.locate_marks.v0",
"function": "locate_marks",
"input": {"image_ref": "sha256:...", "marker_profile": "marker-profile-v3", "calibration_ref": null},
"target": {"resource_id": null, "mode": "simulation"},
"authority": {"subject": "bound-at-runtime", "scope": ["read_input", "run_observation"]},
"output": {"coordinate_space": "pixels", "marks": [], "quality": {}, "evidence_refs": []},
"limits": ["No millimetre conversion without calibration evidence", "Observation only; no machine motion or laser action"]
}Один и тот же contract может выполняться на фиксированных изображениях, облачном simulator, remote reference camera или delivered device. Каждая цель всё равно требует собственного adapter и Evidence.
C.2 Правило retry и effect
Retry должен повторно использовать исходный
operation_id, если запрашиваемый физический эффект тот же.
Если outcome неизвестен, сначала запросите исходную operation, прежде
чем создавать новый effect. Новые credentials или обновлённый token сами
по себе не создают новый физический Work.