--- id: R4.a family: GR-VAL level: core profiles: [storage-api] posture: normative-target added: "1.0" changed: "1.0" source: https://flowdrop.io/spec/rules/gr-val/r4-a specification: FlowDrop Workflow Specification 1.0 licence: CC BY 4.0 --- # R4.a — An exposed workflow port is named in the permitted alphabet *GR-VAL (Part I) · level: core · profiles: storage-api · added in 1.0* An exposure name is a caller-facing parameter name. Restricting it to a small alphabet keeps it usable as a key in every context a caller passes it through. ## The rule > **Normative.** This is the rule. > > 1. A workflow exposure entry's `name` MUST match `^[a-z0-9_-]+$`. > > 2. A name that is absent, empty or outside that alphabet MUST be refused with `R4_NAME_FORMAT` at `schema.{side}.{index}`, where `{side}` is `input` or `output` and `{index}` the entry's position in that side's list. > > 3. Unlike R4.c, this failure MUST NOT skip the entry's remaining checks: uniqueness, and the node and port checks of a bound entry, MUST still be evaluated. > > 4. Two entries whose names are both the empty string therefore yield two `R4_NAME_FORMAT` errors and one `R4_NAME_DUPLICATE`. > > 5. An absent name takes part in no uniqueness comparison. ## Why Recorded under [OPEN-25](https://flowdrop.io/spec/rulings/open-25), [OPEN-26](https://flowdrop.io/spec/rulings/open-26). ## Fixtures Test cases whose outcome this rule decides (fixtures/README.md defines each operation): - Two absent names are two format errors and no duplicate (`validate-exposure`): fixtures/presence/r4-absent-names-no-duplicate.json - Two empty names are two format errors and one duplicate (`validate-exposure`): fixtures/presence/r4-empty-names-duplicate.json ## Related rules - Names: R4.b, R4.c, R4.e - Referenced by: R4.b, R4.c, R4.d, R4.e, MAN-26 --- Rule identifiers are permanent and are never renumbered. This specification carries no implementation status: each implementation publishes its own standing against these rules. Licensed CC BY 4.0.