NF-UI-4: Inspector — widgets, docs, static args #334

New issue

Closed

opened 2026-04-24 11:29:53 +00:00 by code-lead · 1 comment

code-lead commented

2026-04-24 11:29:53 +00:00

Collaborator

As an operator, I want a right-hand inspector that lets me edit a selected node's static args through typed widgets so that I don't have to hand-write JSON for common configuration.

Acceptance criteria

Inspector shell

Tabs: Config, Docs, Run (Run disabled outside replay mode).

Config tab

Widgets declared by the registry's ui.widgets render as controlled inputs.
Shipped widget controls: string-input, textarea, number-input, enum-select, boolean-toggle, label-multiselect (backed by GET /forge/repo-labels?repo=...), json-editor (Monaco).
Widget changes are optimistic: node highlights as dirty, debounced push into the canvas model.
Nodes without widgets collapse the tab to a read-only JSON view of args.

Docs tab

Renders Markdown pulled from the node registry (ui.doc).
Covers every port and every arg.

Out of scope

Input-reference picker — NF-UI-5.
Run-trace overlay (Run tab content) — NF-UI-7.

References

Spec: specs/node-flows-ui.md § Stories § NF-UI-4.
Depends on NF-UI-3 (#333).

As an operator, I want a right-hand inspector that lets me edit a selected node's static args through typed widgets so that I don't have to hand-write JSON for common configuration. ## Acceptance criteria ### Inspector shell - [ ] Tabs: `Config`, `Docs`, `Run` (Run disabled outside replay mode). ### Config tab - [ ] Widgets declared by the registry's `ui.widgets` render as controlled inputs. - [ ] Shipped widget controls: `string-input`, `textarea`, `number-input`, `enum-select`, `boolean-toggle`, `label-multiselect` (backed by `GET /forge/repo-labels?repo=...`), `json-editor` (Monaco). - [ ] Widget changes are optimistic: node highlights as dirty, debounced push into the canvas model. - [ ] Nodes without widgets collapse the tab to a read-only JSON view of `args`. ### Docs tab - [ ] Renders Markdown pulled from the node registry (`ui.doc`). - [ ] Covers every port and every arg. ## Out of scope - Input-reference picker — NF-UI-5. - Run-trace overlay (Run tab content) — NF-UI-7. ## References - Spec: [`specs/node-flows-ui.md`](../src/branch/main/specs/node-flows-ui.md) § Stories § NF-UI-4. - Depends on NF-UI-3 (#333).

code-lead added this to the M21 — Node Flows milestone

2026-04-24 11:29:53 +00:00

code-lead added the

type:user-story

area:dashboard

labels

2026-04-24 11:29:53 +00:00

code-lead referenced this issue

2026-04-24 11:29:57 +00:00

M21 Tracking — Node Flows #340