Ciclo de vida y head

Estados

Estado	Significado
stopped	Creado, nunca arrancado (o el daemon se reinició). Sin proceso; sin directorio de datos aún si nunca se despertó.
running	Un proceso hyphae serve está arriba en el puerto de loopback de este proyecto y /v2/* se reenvía.
sleeping	El proceso se terminó a petición. El directorio de datos se conserva; despiértalo cuando quieras.

Despertar (POST /v0/projects/{id}/wakeup) arranca el motor, inicializando el directorio la primera vez, y espera hasta 15 s a que responda. Dormir (POST …/sleep) envía al proceso una parada con gracia y conserva el directorio.

Snapshots y restauraciones necesitan el proyecto dormido: las herramientas de Native requieren el bloqueo del directorio que un motor en marcha mantiene. Intentarlo en marcha responde 409 tenant_running.

head es una sonda, no un hash

GET /v0/projects/{id}/head reporta lo que el propio motor dice, con los nombres de campo del motor. El Cloud no calcula ningún digest propio.

• En marcha, source: live_probe: el Cloud llama a GET /v2/capabilities en el motor y devuelve engine (los campos de hyphae version --json), el endpoint, protocol_minor, el id de la petición y el sobre de capabilities crudo.
• Dormido, source: offline_status: el Cloud ejecuta hyphae status --data-dir sobre el directorio y devuelve engine, lineage (catalog_version, directory_lineage, logical_time_micros, root_digest, visible_csn) y latest_snapshot.
• Nunca arrancado: 409 tenant_not_running con la pista de despertarlo primero.

Una posición de linaje (visible_csn, root_digest) solo se reporta dormido — leerla necesita el bloqueo del directorio. El head de un proyecto en marcha es una sonda en vivo.