Module jobstore 

Job directory management for agent-exec v0.1.

Resolution order for the jobs root:

1. --root CLI flag
2. AGENT_EXEC_ROOT environment variable
3. $XDG_DATA_HOME/agent-exec/jobs
4. ~/.local/share/agent-exec/jobs

Structs

AmbiguousJobId

Sentinel error type when a job ID prefix matches multiple job directories. Used by callers to emit error.code = "ambiguous_job_id" instead of internal_error.

HeadMetrics

Metrics for the head slice of a log file.

InvalidJobState

Sentinel error type for invalid job state transitions. Used by callers to emit error.code = "invalid_state" instead of internal_error.

JobDir

Handle to a specific job’s directory.

JobIdCollisionExhausted

Sentinel error type when job ID generation exhausts all retry attempts. Used by callers to emit error.code = "io_error" instead of internal_error.

JobNotFound

Sentinel error type to distinguish “job not found” from other I/O errors. Used by callers to emit error.code = "job_not_found" instead of internal_error.

TailMetrics

Metrics returned by JobDir::read_tail_metrics.

Constants

SHORT_JOB_ID_LENGTH

Functions

generate_job_id

Generate a new hash-like job ID ([0-9a-f], fixed-length) that is unique under root.

resolve_root

short_job_id

Human-facing short job ID for list-like displays.