Over time, Node-RED flows tend to drift away from the intent that created them. Comments go stale, naming loses meaning, refactoring preserves behavior but not understanding, and AI-generated flows can accelerate this drift even when everything still “works.”
Semantic Flow Language (SFL) is an initial iteration of a semantic execution model designed to keep intent, structure, and executable behavior aligned as flows evolve.
SFL represents logic as a bidirectionally synchronized meaning graph, allowing human intent, AI generation, and executable code to remain connected rather than inferred after the fact. Node-RED is the first working implementation of this model.
In practical terms, this allows flows to be generated, edited, and refactored while maintaining a verifiable connection to the intent that created them. The goal is to extend Node-RED by expanding how meaning is preserved in long-lived or AI-assisted flows.
Node-RED was chosen deliberately. Its flow-based architecture already expresses logic as a graph, making it a natural environment to test semantic alignment over time rather than relying on comments or naming conventions alone.
This is an early release, but it is complete enough to be used, explored, and evaluated in real systems. The direction is intentional, and the scope is focused.
Feedback from people who build and maintain Node-RED flows is welcome, particularly around usability, clarity, and real-world fit.
Links:
- GitHub (Semantic Flow Language): GitHub - SemanticFlowLanguage/semantic-flow-language: Semantic Flow Language (SFL) is a framework that aligns human intent, AI reasoning, and executable logic. It ensures bidirectional synchronization between meaning and code, allowing for reliable, transparent, and verifiable AI-driven development across various environments.
- Node-RED plugin: GitHub - SemanticFlowLanguage/node-red-semantic-flow-language: Node-RED Semantic Flow Language - AI-powered tooltips and natural language flow builder plugins
- npm package: https://www.npmjs.com/package/node-red-semantic-flow-language