Raft Warfighting Data Model (WDM) Action Service API (1.0)

Query criteria for retrieving actions from storage.

Uses a flat structure where all criteria are combined with AND logic between fields, and OR logic within repeated fields. Optimized for efficient bulk retrieval. Empty query returns all actions.

Logic semantics:

• Multiple values within a repeated field use OR (e.g., states=[1,2] means state=DRAFT OR state=PENDING)
• Different fields are combined with AND (e.g., states=[7] AND priorities=[3])

Scope semantics:

• The scopes field filters on Action.scope (ACTION_SCOPE_TASK, ORDER, ALERT, REPORT, PHASE, SUB_TASK, DIRECTIVE, PLAN). Multiple scopes use OR and combine with AND against the rest of the query. Omit to include all scopes.

Examples:

Query high-priority in-progress actions:

{
  "states": [7],
  "priorities": [3]
}

Matches: state=IN_PROGRESS AND priority=HIGH

Query actions assigned to specific principals:

{
  "assigned_to": [
    {"id": "unit-123", "type": "PRINCIPAL_TYPE_OBJECT"}
  ]
}

Query pending or approved fire missions:

{
  "states": [2, 3],
  "type": ["fire_mission"]
}

Matches: (state=PENDING OR state=APPROVED) AND type="fire_mission"

Query alerts and reports:

{
  "scopes": [7, 8]
}

Matches: scope=ALERT OR scope=REPORT

Query actions of type ISR Collection where details.sensor_type is "EO":

{
  "type": ["isr_collection"],
  "filter": {
    "actionPredicate": {
      "field": {
        "fieldPath": "details.sensor_type",
        "comparator": "FIELD_COMPARATOR_EQ",
        "value": { "stringValue": "EO" }
      }
    }
  }
}

Matches: type="isr_collection" AND details.sensor_type == "EO"

Query actions where details.sensor is EO or IR, and details.priority > 5:

{
  "filter": {
    "and": {
      "statements": [
        {
          "or": {
            "statements": [
              {
                "actionPredicate": {
                  "field": {
                    "fieldPath": "details.sensor",
                    "comparator": "FIELD_COMPARATOR_EQ",
                    "value": { "stringValue": "EO" }
                  }
                }
              },
              {
                "actionPredicate": {
                  "field": {
                    "fieldPath": "details.sensor",
                    "comparator": "FIELD_COMPARATOR_EQ",
                    "value": { "stringValue": "IR" }
                  }
                }
              }
            ]
          }
        },
        {
          "actionPredicate": {
            "field": {
              "fieldPath": "details.priority",
              "comparator": "FIELD_COMPARATOR_GT",
              "value": { "numberValue": 5 }
            }
          }
        }
      ]
    }
  }
}

Matches: (details.sensor == "EO" OR details.sensor == "IR") AND details.priority > 5

Query in-progress actions by state name (enum-by-name in a field predicate):

{
  "filter": {
    "actionPredicate": {
      "field": {
        "fieldPath": "state",
        "comparator": "FIELD_COMPARATOR_EQ",
        "value": { "stringValue": "ACTION_STATE_IN_PROGRESS" }
      }
    }
  }
}

Pagination cursor from previous response. Omit or leave empty for first page.

Action lifecycle states.

State transitions follow a general flow: DRAFT -> PENDING -> APPROVED -> ASSIGNED -> ACKNOWLEDGED -> PLANNED -> IN_PROGRESS -> COMPLETED

Terminal states (final, cannot be changed):

• COMPLETED: Successfully finished

• FAILED: Execution failed

• CANCELLED: Cancelled (the deletion mechanism for actions)

• REJECTED: Refused by assignee

• ACTION_STATE_DRAFT: Being composed; not yet submitted.

• ACTION_STATE_PENDING: Submitted, awaiting approval.

• ACTION_STATE_APPROVED: Approved by authority, not yet assigned.

• ACTION_STATE_ASSIGNED: Assigned to executing principal.

• ACTION_STATE_ACKNOWLEDGED: Executing principal acknowledged receipt of the action.

• ACTION_STATE_PLANNED: Executing principal has developed an execution plan.

• ACTION_STATE_IN_PROGRESS: Currently being executed.

• ACTION_STATE_PAUSED: Execution temporarily halted.

• ACTION_STATE_COMPLETED: Successfully completed (terminal).

• ACTION_STATE_FAILED: Failed to complete (terminal).

• ACTION_STATE_CANCELLED: Cancelled; this is the deletion mechanism for actions (terminal).

• ACTION_STATE_REJECTED: Rejected by assignee (terminal).

Execution progress within a action's current state.