HSIMC · UN Six-Language White Paper · P6 / W0-017
Índice del libro

Apéndice C - Contrato común de capacidad

Un Contrato común de capacidad es el límite compartido que permite a distintos equipos trabajar antes de que esté disponible el hardware final. Describe la función, no un permiso ilimitado para usar un Resource.

C.Field - contract_id

Identificador estable del contrato de función o Perfil.

C.Field - function

Acción/resultado legible por humanos, por ejemplo locate_marks.

C.Field - input_schema

Objetos de entrada versionados, unidades, rangos permitidos y archivos requeridos.

C.Field - output_schema

Resultado versionado, campos de calidad, unidades, referencias de Evidencia y estados de error.

C.Field - resource_target

HSIMC Resource o clase objetivo; la instancia física real se vincula por separado.

C.Field - execution_mode

simulation / physical_reference / physical_delivered / operational.

C.Field - conditions

Entorno, tooling, calibración, material y condiciones previas.

C.Field - authority_required

Autoridad mínima requerida para descubrir, leer, reservar, configurar, ejecutar, detener, aceptar o administrar.

C.Field - effect_identity

Digest o identificador que fija el efecto físico previsto independientemente de credenciales de corta duración.

C.Field - operation_id

Identidad estable utilizada para reintento/lectura posterior de una solicitud con efecto físico.

C.Field - freshness_requirement

Antigüedad máxima aceptable de las observaciones utilizadas para autorizar o planificar la acción.

C.Field - resource_locking

Reserva, lease, comportamiento busy/conflict y regla de liberación.

C.Field - safety_boundary

Condiciones que deben permanecer locales/deterministas y no pueden delegarse a un modelo remoto.

C.Field - acceptance

Medición, tolerancias, Evidencia y paso de aceptación humana/organizacional.

C.Field - recovery

Comportamiento de parada, resultado desconocido, red interrumpida y reinicio.

C.Field - version

Referencias de versión de contrato, adaptador, algoritmo, hardware/BOM, calibración y despliegue.

C.Field - cost_time

Campos de tiempo esperado y real, material, energía y coste monetario.

C.Field - rights

Restricciones de contribución, reutilización, atribución, confidencialidad y retirada.

C.1 Ejemplo - 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"]
}

El mismo contrato puede ejecutarse contra imágenes fijas, un simulador cloud, una cámara de referencia remota o un dispositivo entregado. Cada objetivo sigue requiriendo su propio adaptador y Evidencia.

C.2 Regla de reintento y efecto

Un reintento debería reutilizar el operation_id original cuando el efecto físico solicitado sea el mismo. Si el resultado es desconocido, consultar la operación original antes de crear un nuevo efecto. Nuevas credenciales o un token renovado no crean por sí mismos un nuevo Work físico.