@nanobpm/nano-workforce 0.117.0 → 0.118.1

package/pages/delivery-graphs.page.json

@@ -0,0 +1,153 @@
+{
+  "schemaVersion": "1.0",
+  "title": "Delivery Graphs",
+  "nodes": [
+    {
+      "type": "nav",
+      "id": "nav",
+      "props": {
+        "variant": "bar",
+        "title": "Nano Workforce",
+        "items": [
+          {
+            "label": "Overview",
+            "page": "overview"
+          },
+          {
+            "label": "Lineage",
+            "page": "lineage"
+          },
+          {
+            "label": "Convergence",
+            "page": "home"
+          },
+          {
+            "label": "Epics",
+            "page": "epic"
+          },
+          {
+            "label": "Feature",
+            "page": "feature"
+          },
+          {
+            "label": "Delivery Graphs",
+            "page": "delivery-graphs"
+          },
+          {
+            "label": "Tasks",
+            "page": "tasks",
+            "badge": {
+              "source": "app",
+              "table": "user_tasks",
+              "filter": [],
+              "tone": "danger",
+              "refreshMs": 5000,
+              "hideWhenZero": true
+            }
+          },
+          {
+            "label": "Cockpit",
+            "page": "cockpit"
+          },
+          {
+            "label": "Board",
+            "page": "board"
+          },
+          {
+            "label": "Velocity",
+            "page": "velocity"
+          }
+        ],
+        "sticky": true
+      }
+    },
+    {
+      "type": "text",
+      "id": "title",
+      "props": { "text": "Delivery Graphs", "variant": "heading" }
+    },
+    {
+      "type": "text",
+      "id": "subtitle",
+      "props": {
+        "text": "The human front door for delivery graphs (ADR 0005). Paste an agent-authored delivery-graph JSON, Preview it (a pure compile \u2014 nothing is dispatched) to see it validates and read its content digest, then Dispatch it. A graph with any side-effecting node (it merges PRs / publishes packages) dispatches only when you tick Approve; without approval it is parked in the in-flight grid below for review. Preview and Dispatch are thin UIs over the same compileDeliveryGraph / startDeliveryGraph doors \u2014 there is no parallel submit path.",
+        "variant": "sub"
+      }
+    },
+    {
+      "type": "actionForm",
+      "id": "delivery-graph-preview",
+      "props": {
+        "title": "1 \u00b7 Preview (compile \u2014 pure, nothing is dispatched)",
+        "submitLabel": "Preview",
+        "action": {
+          "path": "/app/api/actions/delivery-graph/preview",
+          "body": "{{form}}",
+          "successLabel": "\u2713 Valid \u2014 the graph compiled. Nothing was dispatched. Review its shape in the in-flight grid, then Dispatch it below."
+        },
+        "fields": [
+          { "key": "graphJson", "label": "Delivery-graph JSON \u2014 paste the agent-authored DeliveryGraph (nodes/edges). Preview validates + compiles it without dispatching.", "type": "text", "required": true, "requiredMessage": "Paste a delivery-graph JSON to preview" }
+        ]
+      }
+    },
+    {
+      "type": "actionForm",
+      "id": "delivery-graph-dispatch",
+      "props": {
+        "title": "2 \u00b7 Dispatch (start \u2014 gated, idempotent)",
+        "submitLabel": "Dispatch",
+        "action": {
+          "path": "/app/api/actions/delivery-graph/dispatch",
+          "body": "{{form}}",
+          "successLabel": "\u2713 Dispatched \u2014 watch it advance in the in-flight grid below."
+        },
+        "fields": [
+          { "key": "graphJson", "label": "Delivery-graph JSON \u2014 paste the same DeliveryGraph you previewed.", "type": "text", "required": true, "requiredMessage": "Paste the delivery-graph JSON to dispatch" },
+          { "key": "approve", "label": "Approve \u2014 I reviewed the preview and approve dispatching this graph's side effects (required for any agent/connector node)", "type": "checkbox" },
+          { "key": "idempotencyKey", "label": "Idempotency key (optional) \u2014 a re-dispatch with the same key (or, blank, the same graph) will not double-launch an in-flight run", "type": "text" }
+        ]
+      }
+    },
+    {
+      "type": "dataGrid",
+      "id": "delivery-graphs-inflight",
+      "props": {
+        "title": "In-flight delivery graphs",
+        "collapsible": true,
+        "defaultCollapsed": false,
+        "showCount": true,
+        "rowKey": "run_key",
+        "refreshMs": 5000,
+        "empty": "No delivery graphs in flight. Preview and Dispatch one above.",
+        "data": {
+          "kind": "datasource",
+          "source": "app",
+          "table": "delivery_graph_runs",
+          "orderBy": { "field": "updated_at", "dir": "desc" },
+          "filter": [{ "field": "status", "in": ["awaiting-approval", "running"] }]
+        },
+        "tabs": [
+          { "label": "In-flight", "filter": [{ "field": "status", "in": ["awaiting-approval", "running"] }] },
+          { "label": "History", "filter": [{ "field": "status", "in": ["done", "failed", "abandoned"] }] },
+          { "label": "All", "filter": [] }
+        ],
+        "columns": [
+          { "field": "title", "template": "{{title}}", "header": "Graph", "subtitleField": "run_key", "truncate": true, "width": "28%", "link": { "kind": "page", "page": "delivery-graph-detail", "keyField": "run_key" } },
+          { "field": "status", "header": "Status", "link": { "kind": "processExplorer", "keyField": "process_key" } },
+          { "field": "phase", "header": "Phase", "truncate": true, "width": "26%" },
+          { "field": "node_count", "header": "Nodes" },
+          { "field": "human_node_count", "header": "Human" },
+          { "field": "side_effect_count", "header": "Side effects" },
+          { "field": "updated_at", "header": "Updated", "width": "9rem", "format": "datetime" }
+        ],
+        "detail": {
+          "fields": [
+            { "field": "process_definition_id", "label": "Definition" },
+            { "field": "digest", "label": "Digest (approval token)" },
+            { "field": "phase_node_id", "label": "Parked node" }
+          ]
+        }
+      }
+    }
+  ]
+}

package/pages/epic-detail.page.json

@@ -29,6 +29,10 @@
             "label": "Feature",
             "page": "feature"
           },
+          {
+            "label": "Delivery Graphs",
+            "page": "delivery-graphs"
+          },
           {
             "label": "Tasks",
             "page": "tasks",

package/pages/epic.page.json

@@ -29,6 +29,10 @@
             "label": "Feature",
             "page": "feature"
           },
+          {
+            "label": "Delivery Graphs",
+            "page": "delivery-graphs"
+          },
           {
             "label": "Tasks",
             "page": "tasks",

package/pages/feature.page.json

@@ -29,6 +29,10 @@
             "label": "Feature",
             "page": "feature"
           },
+          {
+            "label": "Delivery Graphs",
+            "page": "delivery-graphs"
+          },
           {
             "label": "Tasks",
             "page": "tasks",

package/pages/home.page.json

@@ -29,6 +29,10 @@
             "label": "Feature",
             "page": "feature"
           },
+          {
+            "label": "Delivery Graphs",
+            "page": "delivery-graphs"
+          },
           {
             "label": "Tasks",
             "page": "tasks",

package/pages/lineage.page.json

@@ -29,6 +29,10 @@
             "label": "Feature",
             "page": "feature"
           },
+          {
+            "label": "Delivery Graphs",
+            "page": "delivery-graphs"
+          },
           {
             "label": "Tasks",
             "page": "tasks",

package/pages/overview.page.json

@@ -29,6 +29,10 @@
             "label": "Feature",
             "page": "feature"
           },
+          {
+            "label": "Delivery Graphs",
+            "page": "delivery-graphs"
+          },
           {
             "label": "Tasks",
             "page": "tasks",
@@ -66,7 +70,7 @@
       "type": "text",
       "id": "subtitle",
       "props": {
-        "text": "Everything currently in flight across the three dispatch surfaces \u2014 PR convergences, Epics, and Feature runs. Each section lists only its active items, remembers whether you collapsed it, and shows a live count in its header. Follow any row to its detail page.",
+        "text": "Everything currently in flight across the four dispatch surfaces \u2014 PR convergences, Epics, Feature runs, and Delivery Graphs. Each section lists only its active items, remembers whether you collapsed it, and shows a live count in its header. Follow any row to its detail page.",
         "variant": "sub"
       }
     },
@@ -208,7 +212,7 @@
           "filter": [{ "field": "status", "in": ["awaiting-approval", "running"] }]
         },
         "columns": [
-          { "field": "title", "template": "{{title}}", "header": "Item", "subtitleField": "run_key", "truncate": true, "width": "30%" },
+          { "field": "title", "template": "{{title}}", "header": "Item", "subtitleField": "run_key", "truncate": true, "width": "30%", "link": { "kind": "page", "page": "delivery-graph-detail", "keyField": "run_key" } },
           { "field": "status", "header": "Status", "link": { "kind": "processExplorer", "keyField": "process_key" } },
           { "field": "phase", "header": "Phase", "truncate": true, "width": "28%" },
           { "field": "updated_at", "header": "Updated", "width": "9rem", "format": "datetime" }

package/pages/tasks.page.json

@@ -29,6 +29,10 @@
             "label": "Feature",
             "page": "feature"
           },
+          {
+            "label": "Delivery Graphs",
+            "page": "delivery-graphs"
+          },
           {
             "label": "Tasks",
             "page": "tasks",

package/pages/velocity.page.json

@@ -29,6 +29,10 @@
             "label": "Feature",
             "page": "feature"
           },
+          {
+            "label": "Delivery Graphs",
+            "page": "delivery-graphs"
+          },
           {
             "label": "Tasks",
             "page": "tasks",

package/scripts/pages-contract.test.ts

@@ -282,6 +282,9 @@ test("issue #205: overview is the landing page and first nav item", async () =>
     },
     plans: { field: "list_bucket", in: ["active"] },
     feature_runs: { field: "status", in: ["running", "escalated", "awaiting_operator"] },
+    // The 4th dispatch surface (issue #386) — active delivery graphs. Both in-flight statuses
+    // (`awaiting-approval` parked at the gate, `running` dispatched) show here.
+    delivery_graph_runs: { field: "status", in: ["awaiting-approval", "running"] },
   };
   const grids = (overview.nodes ?? []).filter((n: Json) => n.type === "dataGrid");
   for (const [table, { field, in: values }] of Object.entries(expected)) {
@@ -298,3 +301,67 @@ test("issue #205: overview is the landing page and first nav item", async () =>
   }
 });
 
+
+test("issue #386: the human-facing Delivery Graphs surface is wired (nav tab, page, detail, overview)", async () => {
+  // 1) A `Delivery Graphs` nav tab in the single-source nav, pointing at the delivery-graphs page.
+  const nav = JSON.parse(readFileSync(`${ROOT}pages/_nav.json`, "utf8"));
+  const tab = (nav.props?.items ?? []).find(
+    (i: Json) => i.page === "delivery-graphs" && i.label === "Delivery Graphs",
+  );
+  assert(tab, "pages/_nav.json must carry a `Delivery Graphs` nav tab → the delivery-graphs page");
+
+  // 2) The Submit page exists with a Preview (compile) action and a Dispatch (start) action, plus an
+  //    in-flight grid over the delivery_graph_runs aggregate that links to the per-graph detail page.
+  const page = JSON.parse(readFileSync(`${ROOT}pages/delivery-graphs.page.json`, "utf8"));
+  const forms = (page.nodes ?? []).filter((n: Json) => n.type === "actionForm");
+  const preview = forms.find((f: Json) => f.props?.action?.path === "/app/api/actions/delivery-graph/preview");
+  const dispatch = forms.find((f: Json) => f.props?.action?.path === "/app/api/actions/delivery-graph/dispatch");
+  assert(preview, "delivery-graphs page must have a Preview form posting to /app/api/actions/delivery-graph/preview");
+  assert(dispatch, "delivery-graphs page must have a Dispatch form posting to /app/api/actions/delivery-graph/dispatch");
+  // Both forms take the pasted graph JSON; Dispatch also carries the explicit approve gate.
+  assert(
+    (preview.props?.fields ?? []).some((fl: Json) => fl.key === "graphJson"),
+    "the Preview form must have a graphJson paste field",
+  );
+  assert(
+    (dispatch.props?.fields ?? []).some((fl: Json) => fl.key === "graphJson") &&
+      (dispatch.props?.fields ?? []).some((fl: Json) => fl.key === "approve"),
+    "the Dispatch form must have a graphJson paste field and an approve gate",
+  );
+  const grid = (page.nodes ?? []).find(
+    (n: Json) => n.type === "dataGrid" && n.props?.data?.table === "delivery_graph_runs",
+  );
+  assert(grid, "delivery-graphs page must have an in-flight grid over delivery_graph_runs");
+  const linkCol = (grid.props?.columns ?? []).find((c: Json) => c.link?.page === "delivery-graph-detail");
+  assert(
+    linkCol && linkCol.link?.keyField === "run_key",
+    "the in-flight grid must link a column to delivery-graph-detail by run_key",
+  );
+
+  // 3) The per-graph detail page reads the run aggregate scoped to the route param (run_key).
+  const detail = JSON.parse(readFileSync(`${ROOT}pages/delivery-graph-detail.page.json`, "utf8"));
+  const runGrid = (detail.nodes ?? []).find(
+    (n: Json) => n.type === "dataGrid" && n.props?.data?.table === "delivery_graph_runs",
+  );
+  assert(runGrid, "delivery-graph-detail must bind a grid to delivery_graph_runs");
+  assert(
+    (runGrid.props?.data?.filter ?? []).some((fl: Json) => fl.field === "run_key" && fl.eqParam === true),
+    "delivery-graph-detail must scope its run grid to the route param (run_key eqParam)",
+  );
+
+  // 4) The Overview no longer claims only three surfaces, and its 4th section links to the detail page.
+  const overview = JSON.parse(readFileSync(`${ROOT}pages/overview.page.json`, "utf8"));
+  const subtitle = (overview.nodes ?? []).find((n: Json) => n.id === "subtitle");
+  assert(
+    typeof subtitle?.props?.text === "string" && !subtitle.props.text.includes("three dispatch surfaces"),
+    "overview subtitle must no longer say 'three dispatch surfaces' (a delivery graph is a 4th)",
+  );
+  const ovGrid = (overview.nodes ?? []).find(
+    (n: Json) => n.type === "dataGrid" && n.props?.data?.table === "delivery_graph_runs",
+  );
+  const ovLink = (ovGrid?.props?.columns ?? []).find((c: Json) => c.link?.page === "delivery-graph-detail");
+  assert(
+    ovLink && ovLink.link?.keyField === "run_key",
+    "overview delivery-graphs section must link its item to delivery-graph-detail by run_key",
+  );
+});