RnD/EVOLV

Files

znetsixe edef1cecbf tools: add output-manifest-verify; extend flow-lint with fan-out checks

- tools/output-manifest-verify/ — enforces .claude/rules/output-coverage.md
  §3: every node ships test/_output-manifest.md and every declared key
  is referenced by at least one test file. First run shows only
  machineGroupControl has the manifest (16 keys covered); all other nodes
  warn. --strict escalates "missing manifest" to an error for CI gating.
- flow-lint gains two rules from the same output-coverage rule:
  * FN_OUTPUT_WIRES_MISMATCH — function declares outputs=N but wires has
    M arrays (causes silent dropped or duplicate emissions).
  * FN_PAYLOAD_NULL_LITERAL — function source contains `payload: null`
    literal (the η-null ui-chart crash pattern from 2026-05-14).
  First run found 1 instance in mgc/02-Dashboard.json.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

2026-05-19 10:13:49 +02:00

bin

tools: add output-manifest-verify; extend flow-lint with fan-out checks

2026-05-19 10:13:49 +02:00

package.json

tools: add contract-verify and flow-lint (JS native, repo-rule-aware)

2026-05-19 09:38:53 +02:00

README.md

tools: add contract-verify and flow-lint (JS native, repo-rule-aware)

2026-05-19 09:38:53 +02:00

README.md

@evolv/flow-lint

Lint Node-RED flow JSON against the EVOLV flow-layout rule (.claude/rules/node-red-flow-layout.md).

Usage

# every examples/*.flow.json across all nodes
node tools/flow-lint/bin/flow-lint.js

# one flow
node tools/flow-lint/bin/flow-lint.js nodes/rotatingMachine/examples/01-Basic.flow.json

# CI / JSON output (one line per flow)
node tools/flow-lint/bin/flow-lint.js --json

Exit code 1 on any error-severity finding; 0 otherwise (warnings do not fail).

Rules

Rule	Severity	Catches
`UI_XY`	error	`ui-*` nodes with both `x` and `y` at 0 — pile up at canvas origin.
`UI_CHART_PROP`	error	`ui-chart` missing one of the required-or-it-renders-blank properties (interpolation, yAxisProperty, …).
`UI_CHART_TYPE`	warn	`width` / `height` as string instead of number.
`UI_CHART_PALETTE`	warn	`colors` array with fewer than 3 entries.
`INJECT_JSON_PROPS`	error	`inject` with `payloadType:"json"` but missing `props[]` — silently treated as string.
`LINK_CHANNEL_NAME`	warn	`link out` / `link in` without a `cmd:` / `evt:` / `setup:` prefix.
`LINK_BROKEN`	error	`link out` / `link in` referencing a non-existent node id.
`LINK_PAIR_TYPE`	error	`link out` paired with anything other than `link in`, or vice versa.
`LINK_PAIR_ASYMMETRIC`	error	One side references the other but the partner does not link back.
`DEBUG_LOG_IN_FLOW`	warn	`enableLog:"debug"` shipped in a flow — fills container log.
`SELF_LOOP`	error	Any node wired to itself.
`GROUP_WIDTH_SUM`	warn	`ui-group` widths on a `ui-page` summing to non-multiple of 12 — leaves grid gaps.

Why use it

Every rule corresponds to a bug we've actually hit:

UI_XY and UI_CHART_PROP — the dashboard pile-up + blank-chart bugs.
INJECT_JSON_PROPS — the silent-string inject bug.
LINK_PAIR_ASYMMETRIC — drift between named channels.
SELF_LOOP — the 250k-msg/s replace_all incident.

Run before committing any flow change.