Contributing

LightFlow is still in its backend foundation phase. Keep boundaries clear.

Asset Changes

Project assets belong in:

lightflow/models/
lightflow/nodes/
lightflow/compositions/
lightflow/workflows/

Each asset should remain self-contained.

Engine Changes

Engine source belongs in src/:

• API control plane: src/api.rs
• asset parsing: src/asset.rs
• XDG state: src/runs.rs
• CortexFS ABI: src/cortex.rs
• CLI adapter: src/main.rs

Do Not Duplicate CortexFS

Provider, model visibility, routing, tools, MCP, threads, policy, and audit belong to CortexFS. LightFlow should store references and workflow correlation.

Tests

Rust:

cargo test

Docs:

cd docs-site
bun run build