#340 - M21 Tracking — Node Flows - charles/claude-hooks

code-lead commented

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

Collaborator

Copy link

Tracking issue for the Node Flows architecture — a successor to the MF-1..10 multi-forge work. Lifts the hidden dispatch DAG in webhook-handlers.ts / webhook-ci.ts / review-loop.ts / deps.ts / slash-commands.ts into explicit data: typed triggers, a closed node registry, a JSON graph DSL, an executor with topo-order dispatch, SQLite persistence, and a ComfyUI-style graph editor + trace viewer on top.

Status (refreshed 2026-04-26)

Engine track: 7/9 shipped. UI track: 8/9 shipped. Three stories remain.

Specs

specs/node-flows.md — engine + data model + execution semantics.
specs/node-flows-ui.md — operator-facing graph editor + trace viewer.

Engine stories (NF-1 .. NF-9)

NF-1 #322 Trigger union + webhook-normalize extension
NF-2 #323 Node registry + executor (no dispatch yet)
NF-3 #324 ForgePort + agent-runner nodes
NF-4 #325 Persistence + default graph
NF-5 #326 Parallel dry-run + divergence detection
NF-6 #327 Live cutover
NF-7 #328 Operator-authored flows (HTTP API)
NF-8 #329 Legacy dispatch removal — HOLD until 2-release soak after NF-6 (shipped 2026-04-26)
NF-9 #330 MCP nodes (v2) — READY, dispatched

UI stories (NF-UI-1 .. NF-UI-9)

NF-UI-1 #331 Flow list page
NF-UI-2 #332 Canvas shell + default-flow read-only view
NF-UI-3 #333 Editing — add / delete / connect / wire validation
NF-UI-4 #334 Inspector — widgets, docs, static args
NF-UI-5 #335 Input-reference picker
NF-UI-6 #336 Annotations + mode banner
NF-UI-7 #337 Replay mode + runs drawer
NF-UI-8 #338 Test-fire + fixture library
NF-UI-9 #339 Version diff + revert — READY, dispatched

Suggested implementation order

Engine: NF-1 → NF-2 → NF-3 → NF-4 → NF-5 → NF-6 → NF-7 → NF-8 → NF-9.

UI: NF-UI-1 → NF-UI-2 → NF-UI-3 → NF-UI-4 → NF-UI-5 → NF-UI-6 → NF-UI-7 → NF-UI-8 → NF-UI-9 — each independently mergeable once its dependencies land.

The two tracks overlap: UI stories NF-UI-1 and NF-UI-2 start once NF-4 is done; NF-UI-7 and later wait for the runs drawer + replay backing on NF-4. NF-UI-8 needs NF-7.

Tracking issue for the Node Flows architecture — a successor to the MF-1..10 multi-forge work. Lifts the hidden dispatch DAG in `webhook-handlers.ts` / `webhook-ci.ts` / `review-loop.ts` / `deps.ts` / `slash-commands.ts` into explicit data: typed triggers, a closed node registry, a JSON graph DSL, an executor with topo-order dispatch, SQLite persistence, and a ComfyUI-style graph editor + trace viewer on top. ## Status (refreshed 2026-04-26) Engine track: 7/9 shipped. UI track: 8/9 shipped. Three stories remain. ## Specs - [`specs/node-flows.md`](../src/branch/main/specs/node-flows.md) — engine + data model + execution semantics. - [`specs/node-flows-ui.md`](../src/branch/main/specs/node-flows-ui.md) — operator-facing graph editor + trace viewer. ## Engine stories (NF-1 .. NF-9) - [x] NF-1 #322 Trigger union + webhook-normalize extension - [x] NF-2 #323 Node registry + executor (no dispatch yet) - [x] NF-3 #324 ForgePort + agent-runner nodes - [x] NF-4 #325 Persistence + default graph - [x] NF-5 #326 Parallel dry-run + divergence detection - [x] NF-6 #327 Live cutover - [x] NF-7 #328 Operator-authored flows (HTTP API) - [ ] NF-8 #329 Legacy dispatch removal — **HOLD** until 2-release soak after NF-6 (shipped 2026-04-26) - [ ] NF-9 #330 MCP nodes (v2) — **READY**, dispatched ## UI stories (NF-UI-1 .. NF-UI-9) - [x] NF-UI-1 #331 Flow list page - [x] NF-UI-2 #332 Canvas shell + default-flow read-only view - [x] NF-UI-3 #333 Editing — add / delete / connect / wire validation - [x] NF-UI-4 #334 Inspector — widgets, docs, static args - [x] NF-UI-5 #335 Input-reference picker - [x] NF-UI-6 #336 Annotations + mode banner - [x] NF-UI-7 #337 Replay mode + runs drawer - [x] NF-UI-8 #338 Test-fire + fixture library - [ ] NF-UI-9 #339 Version diff + revert — **READY**, dispatched ## Suggested implementation order Engine: NF-1 → NF-2 → NF-3 → NF-4 → NF-5 → NF-6 → NF-7 → NF-8 → NF-9. UI: NF-UI-1 → NF-UI-2 → NF-UI-3 → NF-UI-4 → NF-UI-5 → NF-UI-6 → NF-UI-7 → NF-UI-8 → NF-UI-9 — each independently mergeable once its dependencies land. The two tracks overlap: UI stories NF-UI-1 and NF-UI-2 start once NF-4 is done; NF-UI-7 and later wait for the runs drawer + replay backing on NF-4. NF-UI-8 needs NF-7.

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

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

code-lead added the

type:meta

area:meta

labels

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

claude-desktop commented

2026-04-28 20:52:30 +00:00

Collaborator

Copy link

Closing — all listed sub-stories merged: NF-1..7 (#322-#328), NF-8 #329, NF-9 #330; NF-UI-1..8 (#331-#338), NF-UI-9 #339. Verified 2026-04-28.

claude-desktop closed this issue

2026-04-28 20:52:38 +00:00

No Branch/Tag specified

main

chore/sync-pre-push-from-forge-base

fix/flows-yaml-dispatch-identity

feat/board-tap-to-assign

dev/1107

code-lead/1106

code-lead/1108

dev/1104

code-lead/1103

code-lead/1080

dev/1087

feat/flows-yaml-ci-events

chore/board-drop-stalled-and-density-controls

fix/flows-yaml-routes-always-register

flows-yaml/api-defaults

dev/1023

fix/event-log-history-bleed

fix/janitor-fix-ci-logs-and-cap

dev/1022

fix/board-card-provider

code-lead/1036

dev/1025

code-lead/1020

dev/1017

code-lead/1026

feat/web-shortcut-registry-1018

dev/1015

code-lead/1009

code-lead/1008

dev/975

dev/969

dev/973

dev/967

code-lead/968

code-lead/953

dev/970

dev/976

code-lead/966

code-lead/956

code-lead/951

dev/962

dev/963

dev/977

dev/955

dev/983

dev/961

dev/974

code-lead/950

code-lead/939

dev/941

dev/940

dev/937

dev/938

dev/936

dev/935

feat/web-i18n-fr-locale

feat/spec-editor-ui-polish

chore/drop-legacy-compat

fix/skills-drop-preview-pane

fix/882-skills-safety-rail

dev/911

dev/909

dev/923

dev/917

dev/915

feat/879-sr11-m2-drop-legacy-skill

code-lead/873

dev/881

code-lead/869

dev/867

code-lead/845

code-lead/843

code-lead/844

dev/837

dev/861

dev/849

code-lead/837

code-lead/842

fix/dedup-rebase-inflight

dev/838

code-lead/847

dev/833

code-lead/848

pr/838

code-lead/841

feat/settings-save-bar/836

code-lead/840

dev/846

code-lead/839

dev/832

fix/board-sse-stale-cache

dev/834

dev/835

feat/settings-breadcrumbs

feat/forge-oauth-credentials

refactor/service-config-consolidation

feat/agent-tokens-to-secrets

feat/gitlab-oauth-to-db

feat/authelia-rip-and-voice-fixes

fix/rebase-storm-and-dead-letter

code-lead/797

code-lead/796

dev/811

code-lead/798

dev/810

code-lead/795

dev/808

code-lead/794

dev/805

dev/802

dev/803

feat/avatar-menu-settings-entry

feat/per-agent-token-tracking

dev/793

dev/747

dev/752

code-lead/790

code-lead/759

dev/756

dev/760

dev/741

dev/767

dev/740

dev/709

dev/644

dev/637

boss/614

dev/600

dev/611

dev/585

fix/login-bonus-fixes

boss/544

dev/542

refactor/api-prefix-and-session-gate

dev/489

boss/531

boss/518

dev/499

boss/516

dev/530

dev/517

dev/519

dev/515

dev/522

dev/503

dev/471

boss/329

dev/417

dev/418

dev/402

boss/327

dev/334

dev/332

boss/326

boss/325

dev/331

boss/324

boss/323

boss/322

dev/294

test/s11-task-analytics

dev/262

boss/270

dev/268

foreman/ui-consolidation-spec

dev/234

boss/196

boss/176

boss/164

fix/124-session-persist-bind

boss/52

dev/87

boss/73

dev/77

dev/81

dev/82

boss/79

dev/42

dev/35

boss/7

No results found.

Labels

Clear labels

area:agents

Agent types, pool scheduling, per-instance config

area:dashboard

Dashboard UI and observability surfaces

area:database

DB layer — schema, migrations, ORM, raw SQL

area:design

UI/UX mockup work — routes to designer agent

area:design-review

Design review dispatch — routes to design-reviewer agent

area:flows

Flow runner — YAML loader, executor, op registry, expression eval

area:infra

Deployment, isolation, containers, systemd units

area:meta

Tracking, scaffolding, project setup

area:security

Security — routes to reviewer-security (opus)

area:sessions

Session-id store, Claude SDK resume logic

area:webhook

Forgejo webhook routing and handlers

area:workdir

Clone cache, worktrees, git identity

security

Security-sensitive issue

Tracking or decisions, not implementation work

No labels

Milestone

Clear milestone

No items

No milestone

M21 — Node Flows

Projects

Clear projects

No items

No project

Assignees

Clear assignees

No assignees

2 participants

Notifications

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference

charles/claude-hooks#340

Rows
Columns

M21 Tracking — Node Flows #340

Status (refreshed 2026-04-26)

Specs

Engine stories (NF-1 .. NF-9)

UI stories (NF-UI-1 .. NF-UI-9)

Suggested implementation order