@nanobpm/nano-workforce 0.165.0 → 0.167.0

package/pages/delivery-graphs.page.json

@@ -120,11 +120,11 @@
           "source": "app",
           "table": "delivery_graph_read_model",
           "orderBy": { "field": "updated_at", "dir": "desc" },
-          "filter": [{ "field": "status", "in": ["awaiting-approval", "running"] }]
+          "filter": [{ "field": "list_bucket", "in": ["active"] }]
         },
         "tabs": [
-          { "label": "In-flight", "filter": [{ "field": "status", "in": ["awaiting-approval", "running"] }] },
-          { "label": "History", "filter": [{ "field": "status", "in": ["done", "failed", "abandoned"] }] },
+          { "label": "In-flight", "filter": [{ "field": "list_bucket", "in": ["active"] }] },
+          { "label": "History", "filter": [{ "field": "list_bucket", "in": ["history"] }] },
           { "label": "All", "filter": [] }
         ],
         "columns": [
@@ -171,6 +171,15 @@
               "path": "/app/api/actions/delivery-graph/library/save",
               "body": { "name": "{{row.title}}", "digest": "{{row.digest}}" }
             }
+          },
+          {
+            "label": "Dismiss",
+            "confirm": "Dismiss this finished delivery graph? It acknowledges the terminal run and files it under History.",
+            "showWhenField": "ack_open",
+            "action": {
+              "path": "/app/api/actions/acknowledge-delivery-graph",
+              "body": { "run_key": "{{row.run_key}}" }
+            }
           }
         ]
       }

package/pages/home.page.json

@@ -119,23 +119,15 @@
         "data": {
           "kind": "datasource",
           "source": "app",
-          "table": "pull_requests",
+          "table": "pull_requests_read_model",
           "orderBy": {
             "field": "updated_at",
             "dir": "desc"
           },
           "filter": [
             {
-              "field": "status",
-              "in": [
-                "converging",
-                "waiting_review",
-                "escalated",
-                "waiting_deps",
-                "waiting_merge",
-                "queued",
-                "merging"
-              ]
+              "field": "list_bucket",
+              "in": ["active"]
             }
           ]
         },
@@ -144,16 +136,8 @@
             "label": "Active",
             "filter": [
               {
-                "field": "status",
-                "in": [
-                  "converging",
-                  "waiting_review",
-                  "escalated",
-                  "waiting_deps",
-                  "waiting_merge",
-                  "queued",
-                  "merging"
-                ]
+                "field": "list_bucket",
+                "in": ["active"]
               }
             ]
           },
@@ -161,12 +145,8 @@
             "label": "History",
             "filter": [
               {
-                "field": "status",
-                "in": [
-                  "converged",
-                  "merged",
-                  "abandoned"
-                ]
+                "field": "list_bucket",
+                "in": ["history"]
               }
             ]
           }
@@ -224,6 +204,17 @@
                 "processInstanceKey": "{{row.process_key}}"
               }
             }
+          },
+          {
+            "label": "Dismiss",
+            "confirm": "Dismiss this finished PR? It acknowledges the terminal pull request and files it under History.",
+            "showWhenField": "ack_open",
+            "action": {
+              "path": "/app/api/actions/acknowledge-pr",
+              "body": {
+                "pr_key": "{{row.pr_key}}"
+              }
+            }
           }
         ],
         "detail": {

package/pages/overview.page.json

@@ -101,22 +101,9 @@
         "data": {
           "kind": "datasource",
           "source": "app",
-          "table": "pull_requests",
+          "table": "pull_requests_read_model",
           "orderBy": { "field": "updated_at", "dir": "desc" },
-          "filter": [
-            {
-              "field": "status",
-              "in": [
-                "converging",
-                "waiting_review",
-                "escalated",
-                "waiting_deps",
-                "waiting_merge",
-                "queued",
-                "merging"
-              ]
-            }
-          ]
+          "filter": [{ "field": "list_bucket", "in": ["active"] }]
         },
         "columns": [
           { "field": "title", "template": "{{title}}", "header": "Item", "subtitleField": "pr_key", "truncate": true, "width": "36%", "link": { "kind": "page", "page": "home", "keyField": "pr_key" } },
@@ -124,6 +111,17 @@
           { "field": "incident_message", "header": "Incident", "truncate": true, "badge": { "tone": "danger", "label": "1" } },
           { "field": "current_round", "template": "{{current_round}} · {{active_worker}}", "header": "Round · Agent" },
           { "field": "updated_at", "header": "Updated", "width": "9rem", "format": "datetime" }
+        ],
+        "rowActions": [
+          {
+            "label": "Dismiss",
+            "confirm": "Dismiss this finished PR? It acknowledges the terminal pull request and files it under History.",
+            "showWhenField": "ack_open",
+            "action": {
+              "path": "/app/api/actions/acknowledge-pr",
+              "body": { "pr_key": "{{row.pr_key}}" }
+            }
+          }
         ]
       }
     },
@@ -220,7 +218,7 @@
           "source": "app",
           "table": "delivery_graph_read_model",
           "orderBy": { "field": "updated_at", "dir": "desc" },
-          "filter": [{ "field": "status", "in": ["awaiting-approval", "running"] }]
+          "filter": [{ "field": "list_bucket", "in": ["active"] }]
         },
         "columns": [
           { "field": "title", "template": "{{title}}", "header": "Item", "subtitleField": "run_key", "truncate": true, "width": "30%", "link": { "kind": "page", "page": "delivery-graph-detail", "keyField": "run_key" } },
@@ -252,7 +250,18 @@
             { "field": "human_node_count", "label": "Human nodes" },
             { "field": "side_effect_count", "label": "Side effects" }
           ]
-        }
+        },
+        "rowActions": [
+          {
+            "label": "Dismiss",
+            "confirm": "Dismiss this finished delivery graph? It acknowledges the terminal run and files it under History.",
+            "showWhenField": "ack_open",
+            "action": {
+              "path": "/app/api/actions/acknowledge-delivery-graph",
+              "body": { "run_key": "{{row.run_key}}" }
+            }
+          }
+        ]
       }
     }
   ]

package/resources/processes/feature.bpmn

@@ -264,16 +264,18 @@
       <bpmn:outgoing>f_converge</bpmn:outgoing>
       <bpmn:outgoing>f_noConverge</bpmn:outgoing>
     </bpmn:exclusiveGateway>
-    <bpmn:serviceTask id="converge" name="Hand off to convergence loop">
+    <bpmn:callActivity id="converge" name="Converge cell">
       <bpmn:extensionElements>
-        <zeebe:taskDefinition type="pr.converge-feature" />
-        <zeebe:properties>
-          <zeebe:property name="io.nanobpm.dataEnvelope.in" value="ConvergeFeatureIn" />
-        </zeebe:properties>
+        <zeebe:calledElement processId="converge-cell" />
+        <zeebe:ioMapping>
+          <zeebe:input source="=featureKey" target="featureKey" />
+          <zeebe:input source="=prKey" target="prKey" />
+          <zeebe:input source="=autoMerge" target="autoMerge" />
+        </zeebe:ioMapping>
       </bpmn:extensionElements>
       <bpmn:incoming>f_converge</bpmn:incoming>
       <bpmn:outgoing>f_toEndConverged</bpmn:outgoing>
-    </bpmn:serviceTask>
+    </bpmn:callActivity>
     <bpmn:endEvent id="End" name="Done">
       <bpmn:incoming>f_noConverge</bpmn:incoming>
       <bpmn:incoming>f_toEndConverged</bpmn:incoming>

package/scripts/pages-contract.test.ts

@@ -319,27 +319,21 @@ test("issue #205: overview is the landing page and first nav item", async () =>
 
   // Four collapsible active-work sections, one per dispatch surface, each with a
   // live count in its header (showCount) and a persisted collapse toggle (collapsible). Each filters
-  // its Active list on a `{field, in:[...]}` predicate. The FEATURE and EPIC surfaces bucket on the
-  // DERIVED `list_bucket` — NOT raw `status` — over their read-model VIEW (features: issue #637 —
-  // fixing a drift where the grid read the vestigial base `feature_runs.status` with an allowlist that
-  // hid every converging feature; epics: issue #298), so a `done`-but-unacknowledged item still
-  // converging does not vanish from its in-flight section the instant `status` reads terminal. Guarding
-  // the field here is the regression guard for that defect class. The feature surface binds the derived
-  // `feature_read_model` VIEW (the single source of truth for the `list_bucket` activeness predicate,
-  // shared byte-for-byte with the Feature tab); the epic surface binds `plan_read_model` (epic #412),
-  // not the raw `plans` table. PRs / delivery graphs still bucket on `status` (see #637 follow-up).
+  // its Active list on a `{field, in:[...]}` predicate. ALL FOUR surfaces now bucket on the DERIVED
+  // `list_bucket` — NOT raw `status` — over their read-model VIEW (features: issue #637; epics: #298;
+  // PRs + delivery graphs: issue #641 — retiring the last two base-`status` allowlists), so a terminal-
+  // but-unacknowledged item stays in its in-flight section until an operator dismisses it, instead of
+  // vanishing the instant `status` reads terminal. Guarding the field here is the regression guard for
+  // that defect class. Each surface binds its declare-once read-model VIEW (the single source of truth
+  // for the `list_bucket` activeness predicate), never a raw base table.
   const expected: Record<string, { field: string; in: string[] }> = {
-    pull_requests: {
-      field: "status",
-      in: ["converging", "waiting_review", "escalated", "waiting_deps", "waiting_merge", "queued", "merging"],
-    },
+    pull_requests_read_model: { field: "list_bucket", in: ["active"] },
     plan_read_model: { field: "list_bucket", in: ["active"] },
     feature_read_model: { field: "list_bucket", in: ["active"] },
-    // The 4th dispatch surface (issue #386) — active delivery graphs. Both in-flight statuses
-    // (`awaiting-approval` parked at the gate, `running` dispatched) show here. Binds the derived
-    // `delivery_graph_read_model` VIEW (S7 / #541 — the single source of truth for the pipeline
-    // projection it also renders), which re-exports every run column plus the effective `status`.
-    delivery_graph_read_model: { field: "status", in: ["awaiting-approval", "running"] },
+    // The 4th dispatch surface (issue #386) — active delivery graphs. Binds the derived
+    // `delivery_graph_read_model` VIEW (S7 / #541), now filtered on `list_bucket` (issue #641) so a
+    // terminal run stays Active until dismissed rather than dropping on its base `status`.
+    delivery_graph_read_model: { field: "list_bucket", in: ["active"] },
   };
   const grids = (overview.nodes ?? []).filter((n: Json) => n.type === "dataGrid");
   for (const [table, { field, in: values }] of Object.entries(expected)) {
@@ -357,6 +351,74 @@ test("issue #205: overview is the landing page and first nav item", async () =>
 });
 
 
+test("issue #641: no Active/History grid filters a base-`status` allowlist — every dispatch Active list buckets on a derived read-model VIEW", async () => {
+  // The drift class this closes (the last mile of #637): an "Active …" dispatch list that re-encodes
+  // activeness as a hardcoded base-`status` allowlist (`{ field: "status", in: [...] }`) instead of the
+  // declare-once derived `list_bucket` over its read-model VIEW. Such an allowlist silently drops a row
+  // out of Active the instant its `status` leaves the set — with NO operator dismiss — and must be kept
+  // hand-synced with every status rename. #641 retired the last two (PRs + delivery graphs); this guard
+  // makes the whole class a BUILD FAILURE so it can never creep back in on a new/edited grid.
+  //
+  // SCOPE — an "Active/History surface" is a top-level grid that partitions rows into active vs.
+  // finished: either its title starts with "Active " (the Overview sections) OR it carries a `History`
+  // tab (the Feature/Epic/PR/Delivery-Graph/lineage grids). This deliberately EXCLUDES the param-scoped
+  // per-epic slice grids (epic-detail's "Wave state" Active/Skipped/All, "Trial-merge results"
+  // Needs-attention/Clean/All), which legitimately filter a domain `status`/`result` within one epic —
+  // they have no `History` tab and no "Active " title, so they are not activeness partitions.
+  const BASE_TABLES = new Set(["pull_requests", "plans", "feature_runs", "delivery_graph_runs"]);
+  const grids: Json[] = [];
+  const walk = (n: Json): void => {
+    if (Array.isArray(n)) return n.forEach(walk);
+    if (n && typeof n === "object") {
+      if (n.type === "dataGrid") grids.push(n);
+      for (const v of Object.values(n)) walk(v);
+    }
+  };
+  for (const e of readdirSync(`${ROOT}pages`, { withFileTypes: true })) {
+    if (!e.isFile() || !e.name.endsWith(".page.json")) continue;
+    const page = JSON.parse(readFileSync(`${ROOT}pages/${e.name}`, "utf8"));
+    walk(page.nodes ?? page);
+    // Tag each grid with its page for messages.
+    for (const g of grids) if (g.__page === undefined) g.__page = e.name;
+  }
+
+  let surfaces = 0;
+  for (const g of grids) {
+    const props = g.props ?? {};
+    const title: string = typeof props.title === "string" ? props.title : "";
+    const tabs: Json[] = Array.isArray(props.tabs) ? props.tabs : [];
+    const hasHistoryTab = tabs.some((t) => typeof t?.label === "string" && /history/i.test(t.label));
+    const activeTitle = /^active\s/i.test(title);
+    if (!hasHistoryTab && !activeTitle) continue; // not an activeness partition — skip
+    surfaces++;
+
+    const table: string = g.props?.data?.table ?? "";
+    // 1) It must bind a DERIVED read-model relation, never a raw base table (whose only activeness
+    //    signal is the base `status` this guard forbids filtering on).
+    assert(
+      !BASE_TABLES.has(table),
+      `${g.__page}: Active/History grid "${title || tabs.map((t) => t.label).join("/")}" binds the raw base table "${table}" — bind its derived read-model VIEW (…_read_model) so it can filter the declared list_bucket`,
+    );
+
+    // 2) No filter — the grid's main filter OR any tab filter — may re-encode activeness as a
+    //    base-`status` allowlist. (A domain filter on another column is fine; only `status IN […]` is
+    //    the banned drift surface.)
+    const allFilters: Json[] = [g.props?.data?.filter, ...tabs.map((t) => t?.filter)];
+    for (const filter of allFilters) {
+      if (!Array.isArray(filter)) continue;
+      for (const pred of filter) {
+        assert(
+          !(pred?.field === "status" && (Array.isArray(pred.in) || pred.eq !== undefined)),
+          `${g.__page}: Active/History grid "${title || tabs.map((t) => t.label).join("/")}" filters a base-\`status\` allowlist ` +
+            `(${JSON.stringify(pred)}) — bucket on the derived \`list_bucket\` over the read-model VIEW instead (issue #641).`,
+        );
+      }
+    }
+  }
+  assert(surfaces >= 6, `expected to find the dispatch Active/History surfaces, found only ${surfaces}`);
+});
+
+
 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"));

package/workers/record-results/worker.test.ts

@@ -78,9 +78,11 @@ test("no opened PRs (empty plan) hard-fails with NO_WORK_DISPATCHED", async () =
   const plan = app._plans.at(-1) as Record<string, unknown>;
   assertEquals(plan.status, "failed");
   assertEquals(plan.outcome, "no work dispatched — the planner produced no tasks");
-  // `list_bucket` is derived by the `plan_read_model` VIEW (074): a failed epic reads as History
-  // (no tick-off needed). Cross-checked against the pure `deriveEpicBucket` oracle the VIEW mirrors.
-  assertEquals(deriveEpicBucket(plan.status as string, null, plan.acknowledged_at as string | null), "history");
+  // `list_bucket` is derived by the `plan_read_model` VIEW: under the uniform acknowledge-to-dismiss
+  // rule (issue #641) a terminal-but-UNACKNOWLEDGED epic — including a `failed` one — STAYS in Active
+  // (offering the operator a Dismiss) until it is acknowledged, rather than vanishing straight to
+  // History. Cross-checked against the pure `deriveEpicBucket` oracle the VIEW mirrors.
+  assertEquals(deriveEpicBucket(plan.status as string, null, plan.acknowledged_at as string | null), "active");
 });
 
 test("tasks present but none opened (all skipped/blocked) hard-fails", async () => {