Workflow Verbs

Workflow verbs define the operations that can occur inside a Blueprint step.

Each step in a workflow executes exactly one verb.

Verbs are divided into two categories:

• external system verbs
• internal runtime verbs

This distinction ensures that system interaction remains controlled and observable.

External System Verbs

External verbs interact with connected systems through adapters.

FETCH

Retrieves datasets from an external system.

Typical use cases include:

• retrieving project records from an ERP
• retrieving site diaries from a field system
• retrieving vendor lists

Example:

FETCH → assignar.site_diaries

The adapter retrieves records and returns them using the standardized response envelope.

LOOKUP

Retrieves a single entity from an external system.

This is commonly used when a workflow needs to confirm the existence of a record.

Example:

LOOKUP → business_central.project

PUSH

Writes records into an external system.

Examples include:

• posting project ledger entries
• creating vendors
• uploading files

Example:

PUSH → business_central.project_ledger

All PUSH operations must support simulation mode.

EXECUTE

Performs operational commands in external systems.

Examples include:

• triggering background jobs
• sending notifications
• running system operations

Example:

EXECUTE → send_notification

Internal Runtime Verbs

Internal verbs operate entirely inside the runtime environment.

They do not interact with external systems.

TRANSFORM

Transforms datasets in memory.

Common transformations include:

• field normalization
• schema mapping
• derived field calculation

Example:

TRANSFORM → extract_labour_entries

GOVERN

Evaluates governance policies.

Governance checks may include:

• approval thresholds
• identity verification
• financial limits

If a governance rule fails, the workflow may suspend execution.

LOGIC_GATE

Controls conditional workflow behavior.

Example logic gates include:

• skipping steps when a dataset is empty
• branching execution paths
• terminating workflows early

Verb Safety Model

Verbs are categorized by side effects.

Read-only verbs

FETCH
LOOKUP

Mutating verbs

PUSH
EXECUTE

Internal verbs

TRANSFORM
GOVERN
LOGIC_GATE

This classification allows the runtime to enforce safety rules.

Deterministic Execution

Blueprint workflows remain deterministic because verbs operate in predictable ways.

External system interaction is isolated through adapters.

Internal transformations operate only on runtime data.

This ensures that workflows behave consistently across environments.

---