Skip to content

RFC: Flows as .flow.jsonc — composable flow-graph format #3

@apotema

Description

@apotema

Umbrella tracking issue for the Flows-as-.flow.jsonc RFC.

Summary

Move flow graphs from .flow.zon to .flow.jsonc, flatten the node schema, and make subgraph composition work through named registry references — reusing the RFC #560 registry / resolver / #569 cycle-detector machinery.

  • Format.flow.jsonc (JSONC), replacing .flow.zon.
  • Schema — flat nodes + edges; per-node tagged-union nesting dropped.
  • Composition — a Subflow node references another flow by registry name; the referenced flow declares a named params interface; overrides binds those parameters by name (Model B). Reference cycles caught at load time.

The full RFC text is RFC-FLOWS-JSONC.md, added by the PR linked below.

Sub-tickets

Open questions (non-blocking)

  1. Pin projection across a Subflow reference boundary (ties into labelle-gui#44).
  2. Editor round-trip stability (deterministic .flow.jsonc re-save).

🤖 Filed via automated triage

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions