CortexFS Integration

CortexFS is the required Linux execution substrate for LightFlow.

Responsibility Split

LightFlow owns:

• asset scanning and validation
• workflow parsing
• run planning
• XDG run state
• CLI and OpenAPI control surfaces
• CortexFS correlation paths

CortexFS owns:

• provider and model visibility
• API format execution
• tool and MCP invocation
• thread state
• policy enforcement
• route decisions
• audit stream
• fingerprints and outbox materialization

Mount Point

Default mount:

/ctx

Current user home:

export CTX_HOME="/ctx/home/$(id -u)"

API Exchange

/ctx/home/<uid>/api/openai.chat/inbox/<step_id>.req.json
/ctx/home/<uid>/api/openai.chat/outbox/<step_id>.resp.json
/ctx/home/<uid>/api/openai.chat/outbox/<step_id>.error
/ctx/home/<uid>/api/openai.chat/outbox/<step_id>.fingerprint
/ctx/home/<uid>/api/openai.chat/outbox/<step_id>.route.json

LightFlow writes a temporary file, syncs it, and atomically renames it into the inbox.

Design Rule

If CortexFS already owns a concept, LightFlow should integrate with it instead of duplicating it.