1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
//! Core utilities and abstractions for the ActionQueue system.
//!
//! This crate provides the core domain types for the ActionQueue task execution system,
//! including run state management, task specifications, and unique identifiers.
//!
//! # Overview
//!
//! The core crate defines the fundamental types used throughout the ActionQueue system:
//!
//! - [`ids`] - Unique identifiers for tasks, runs, and attempts
//! - [`mutation`] - Engine-facing mutation authority boundary contracts
//! - [`run`] - Run state machine and instance management
//! - [`task`] - Task specifications and constraints
//!
//! # Example
//!
//! ```
//! use actionqueue_core::ids::{RunId, TaskId};
//! use actionqueue_core::run::{RunInstance, RunState};
//!
//! // Create a new task ID
//! let task_id = TaskId::new();
//!
//! // Create a new run instance in Scheduled state
//! let run = RunInstance::new_scheduled(task_id, 1000u64, 500u64)
//! .expect("run construction should be valid");
//!
//! // Verify the run starts in Scheduled state
//! assert_eq!(run.state(), RunState::Scheduled);
//! assert!(!run.is_terminal());
//!
//! // Create a transition to Ready state
//! use actionqueue_core::run::Transition;
//! let transition = Transition::new(RunState::Scheduled, RunState::Ready);
//! assert!(transition.is_ok());
//! ```
/// System events for subscription matching and dispatch coordination.
/// Strongly-typed identifiers used across task/run/attempt domain entities.