Runs and State

A run is LightFlow-owned state for one workflow request. It records workflow structure and the related CortexFS paths.

XDG Layout

$XDG_STATE_HOME/lightflow/runs/<run_id>/
  manifest.json
  request.json
  resolved_workflow.json
  events.jsonl
  trace.jsonl
  outputs/

Manifest

manifest.json records:

• run id
• workflow asset id
• step ids
• node or composition ids
• CortexFS inbox/outbox paths
• step status
• submitted request path
• response or error path
• provider/model/route fields
• fingerprint
• output artifacts

Status

Step states:

planned
submitted
succeeded
failed

Run status is derived from step counts.

Preview vs Create

Preview does not write state. Create writes request, resolved workflow, event stream, and manifest.

Submit and Refresh

Submit writes a step request to CortexFS. Refresh reads outbox files and updates the manifest.

cargo run -- run submit run-001 draft
cargo run -- run refresh run-001