sgns::sgprocessing::ExecutionManifest¶

#include <execution_manifest.hpp>

Public Attributes¶

	Name
char[MAX_IDENTIFIER]	executionId Execution-scoped ID.
char[MAX_IDENTIFIER]	attemptId Retry-attempt ID.
char[MAX_IDENTIFIER]	taskId Task ID from job definition.
char[MAX_IDENTIFIER]	subtaskId Subtask ID from processing pipeline.
char[MAX_RESOURCE_NAME]	passId Producing pass identity.
uint8_t[SHA256_HASH_SIZE]	executorIdentity From CapabilitySnapshot::identityHash (Phase 06 D-08); never zero.
uint8_t[SHA256_HASH_SIZE]	modelIdentity SHA-256 of model bytes; all zeros if no model (D-14)
uint8_t[SHA256_HASH_SIZE]	tokenizerIdentity All zeros if no tokenizer (D-14)
uint8_t[SHA256_HASH_SIZE]	adapterIdentity All zeros if no adapter (D-14)
uint8_t[SHA256_HASH_SIZE]	shaderIdentity SHA-256 of compiled SPIR-V bytes; all zeros if no shader (D-14)
uint8_t[SHA256_HASH_SIZE]	quantizationIdentity All zeros if no quantization (D-14)
uint32_t	inputArtifactCount
uint8_t[MAX_ARTIFACT_REFS][SHA256_HASH_SIZE]	inputArtifactHashes
uint32_t	outputArtifactCount
uint8_t[MAX_ARTIFACT_REFS][SHA256_HASH_SIZE]	outputArtifactHashes
int64_t	startTimeUsec Microseconds since Unix epoch, captured before StartProcessing()
int64_t	endTimeUsec Microseconds since Unix epoch, captured after StartProcessing() returns.
TerminalState	terminalState
uint64_t	gpuMemoryUsedBytes Peak GPU memory during execution; 0 if not tracked.
uint64_t	outputBytesProduced Sum of all output artifact byte sizes.
uint64_t	wallClockUsec endTimeUsec - startTimeUsec; computed at manifest assembly time
uint8_t[SHA256_HASH_SIZE]	manifestHash
char[MAX_IDENTIFIER]	errorMessage

Detailed Description¶

struct sgns::sgprocessing::ExecutionManifest;

Self-contained execution manifest (ARTF-04, D-13).

Captures: execution identifiers, executor & compatibility identities, input/output artifact hash references, timing, terminal state, resource-use summary, and a manifest self-hash (computed by artifact_serializer.hpp — see ComputeManifestHash).

Sentinel zero-hash convention (D-14): modelIdentity, tokenizerIdentity, adapterIdentity, shaderIdentity, and quantizationIdentity are all-zero when the corresponding resource was not used in this execution.

Public Attributes Documentation¶

variable executionId¶

char[MAX_IDENTIFIER] executionId;

Execution-scoped ID.

variable attemptId¶

char[MAX_IDENTIFIER] attemptId;

Retry-attempt ID.

variable taskId¶

char[MAX_IDENTIFIER] taskId;

Task ID from job definition.

variable subtaskId¶

char[MAX_IDENTIFIER] subtaskId;

Subtask ID from processing pipeline.

variable passId¶

char[MAX_RESOURCE_NAME] passId;

Producing pass identity.

variable executorIdentity¶

uint8_t[SHA256_HASH_SIZE] executorIdentity;

From CapabilitySnapshot::identityHash (Phase 06 D-08); never zero.

variable modelIdentity¶

uint8_t[SHA256_HASH_SIZE] modelIdentity;

SHA-256 of model bytes; all zeros if no model (D-14)

variable tokenizerIdentity¶

uint8_t[SHA256_HASH_SIZE] tokenizerIdentity;

All zeros if no tokenizer (D-14)

variable adapterIdentity¶

uint8_t[SHA256_HASH_SIZE] adapterIdentity;

All zeros if no adapter (D-14)

variable shaderIdentity¶

uint8_t[SHA256_HASH_SIZE] shaderIdentity;

SHA-256 of compiled SPIR-V bytes; all zeros if no shader (D-14)

variable quantizationIdentity¶

uint8_t[SHA256_HASH_SIZE] quantizationIdentity;

All zeros if no quantization (D-14)

variable inputArtifactCount¶

uint32_t inputArtifactCount = 0;

variable inputArtifactHashes¶

uint8_t[MAX_ARTIFACT_REFS][SHA256_HASH_SIZE] inputArtifactHashes;

variable outputArtifactCount¶

uint32_t outputArtifactCount = 0;

variable outputArtifactHashes¶

uint8_t[MAX_ARTIFACT_REFS][SHA256_HASH_SIZE] outputArtifactHashes;

variable startTimeUsec¶

int64_t startTimeUsec = 0;

Microseconds since Unix epoch, captured before StartProcessing()

variable endTimeUsec¶

int64_t endTimeUsec = 0;

Microseconds since Unix epoch, captured after StartProcessing() returns.

variable terminalState¶

TerminalState terminalState = TerminalState::Success;

variable gpuMemoryUsedBytes¶

uint64_t gpuMemoryUsedBytes = 0;

Peak GPU memory during execution; 0 if not tracked.

variable outputBytesProduced¶

uint64_t outputBytesProduced = 0;

Sum of all output artifact byte sizes.

variable wallClockUsec¶

uint64_t wallClockUsec = 0;

endTimeUsec - startTimeUsec; computed at manifest assembly time

variable manifestHash¶

uint8_t[SHA256_HASH_SIZE] manifestHash;

variable errorMessage¶

char[MAX_IDENTIFIER] errorMessage;

Updated on 2026-09-17 at 06:29:14 +0000