@nanobpm/nano-workforce 0.83.0 → 0.84.0

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+# [0.84.0](https://github.com/nanobpm/nano-workforce/compare/v0.83.0...v0.84.0) (2026-08-17)
+
+
+### Features
+
+* **ui:** render narrative epic-detail sections with urban prose renderer ([#270](https://github.com/nanobpm/nano-workforce/issues/270)) ([#271](https://github.com/nanobpm/nano-workforce/issues/271)) ([38c67a4](https://github.com/nanobpm/nano-workforce/commit/38c67a479693730b9a79f3a7b0f88ef574d3a456)), closes [nano-ide#274](https://github.com/nano-ide/issues/274) [#87](https://github.com/nanobpm/nano-workforce/issues/87) [274/#275](https://github.com/nanobpm/nano-workforce/issues/275)
+
 # [0.83.0](https://github.com/nanobpm/nano-workforce/compare/v0.82.1...v0.83.0) (2026-08-17)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nanobpm/nano-workforce",
-  "version": "0.83.0",
+  "version": "0.84.0",
   "description": "Nano Workforce — an Agent Graph Orchestration application for Agentic SDLC: durable BPMN processes that coordinate a graph of AI agents across the software delivery lifecycle.",
   "type": "module",
   "main": "main.ts",
@@ -53,7 +53,7 @@
   },
   "dependencies": {
     "@nanobpm/agentic": "^0.1.0",
-    "@nanobpm/urban": "^0.53.0"
+    "@nanobpm/urban": "^0.54.0"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.4.11",

package/pages/epic-detail.page.json

@@ -137,38 +137,36 @@
       }
     },
     {
-      "type": "dataGrid",
+      "type": "prose",
       "id": "plan-reviews",
       "props": {
         "title": "Plan review trace",
         "refreshMs": 5000,
         "collapsible": true,
         "defaultCollapsed": true,
+        "measure": 80,
+        "empty": "No plan reviews recorded yet.",
         "data": {
           "kind": "datasource",
           "source": "app",
           "table": "plan_reviews",
-          "orderBy": { "field": "round", "dir": "asc" },
+          "orderBy": { "field": "created_at", "dir": "asc" },
           "filter": [{ "field": "plan_key", "eqParam": true }]
         },
-        "columns": [
-          { "field": "round", "header": "Round" },
-          { "field": "epoch", "header": "Epoch" },
-          { "field": "approved", "header": "Approved? (1/0)" },
-          { "field": "findings", "header": "Reviewer findings" },
-          { "field": "created_at", "header": "Recorded" }
-        ]
+        "header": "Round {{round}} · epoch {{epoch}} · approved {{approved}} · {{created_at}}",
+        "body": "findings"
       }
     },
     {
-      "type": "dataGrid",
+      "type": "prose",
       "id": "plan-review-escalations",
       "props": {
         "title": "Plan-review escalations",
-        "rowKey": "id",
         "refreshMs": 5000,
         "collapsible": true,
         "defaultCollapsed": true,
+        "measure": 80,
+        "empty": "No plan-review escalations.",
         "data": {
           "kind": "datasource",
           "source": "app",
@@ -176,16 +174,8 @@
           "orderBy": { "field": "id", "dir": "desc" },
           "filter": [{ "field": "plan_key", "eqParam": true }]
         },
-        "columns": [
-          { "field": "epoch", "header": "Epoch" },
-          { "field": "round", "header": "Round" },
-          { "field": "findings", "header": "Findings" },
-          { "field": "status", "header": "Status" },
-          { "field": "directive", "header": "Directive" },
-          { "field": "note", "header": "Human note" },
-          { "field": "asked_at", "header": "Asked" },
-          { "field": "answered_at", "header": "Answered" }
-        ]
+        "header": "Round {{round}} · epoch {{epoch}} · {{status}} · directive {{directive}} · asked {{asked_at}} · answered {{answered_at}} · note {{note}}",
+        "body": "findings"
       }
     },
     {
@@ -214,14 +204,15 @@
       }
     },
     {
-      "type": "dataGrid",
+      "type": "prose",
       "id": "coordination-notes",
       "props": {
         "title": "Coordination notes",
-        "rowKey": "id",
         "refreshMs": 5000,
         "collapsible": true,
         "defaultCollapsed": true,
+        "measure": 80,
+        "empty": "No coordination notes posted yet.",
         "data": {
           "kind": "datasource",
           "source": "app",
@@ -229,14 +220,8 @@
           "orderBy": { "field": "id", "dir": "asc" },
           "filter": [{ "field": "plan_key", "eqParam": true }]
         },
-        "columns": [
-          { "field": "wave", "header": "Wave" },
-          { "field": "author_task", "header": "Agent" },
-          { "field": "kind", "header": "Kind" },
-          { "field": "files", "header": "Files" },
-          { "field": "body", "header": "Note" },
-          { "field": "created_at", "header": "Posted" }
-        ]
+        "header": "Wave {{wave}} · {{author_task}} · {{kind}} · files {{files}} · {{created_at}}",
+        "body": "body"
       }
     },
     {

package/scripts/pages-contract.test.ts

@@ -112,6 +112,12 @@ function filterFields(filter: Json): string[] {
   return filter.map((f: Json) => f?.field).filter(Boolean);
 }
 
+// Pull `{{field}}` interpolation names out of a prose renderer's header template (nano-ide#274).
+function templateFields(tpl: Json): string[] {
+  if (typeof tpl !== "string") return [];
+  return [...tpl.matchAll(/\{\{([^{}]+)\}\}/g)].map((m) => m[1].trim()).filter(Boolean);
+}
+
 function collectRefs(page: string, node: Json, out: Ref[]): void {
   if (Array.isArray(node)) {
     for (const v of node) collectRefs(page, v, out);
@@ -120,10 +126,17 @@ function collectRefs(page: string, node: Json, out: Ref[]): void {
   if (!node || typeof node !== "object") return;
 
   // Top-level datasource grid: the datasource lives at `node.data`, while `columns`, `rowKey`,
-  // `filter`/`tabs`, and `detail` are siblings on the same `node` (the grid props).
+  // `filter`/`tabs`, and `detail` are siblings on the same `node` (the grid props). A `prose`
+  // renderer (nano-ide#274) binds the same `node.data` but has no `columns`: its displayed content
+  // is the header template's `{{field}}` refs plus the single `body` field, so fold those in as
+  // "columns" so the field-existence + surface guards below apply to prose sections too.
   const data = node.data;
   if (data && data.kind === "datasource" && typeof data.table === "string") {
-    const columns: string[] = (node.columns ?? []).map((c: Json) => c.field).filter(Boolean);
+    const columns: string[] = [
+      ...(node.columns ?? []).map((c: Json) => c.field),
+      ...templateFields(node.header),
+      ...(typeof node.body === "string" ? [node.body] : []),
+    ].filter(Boolean);
     // Every reference that resolves to a column on this table — the runtime 400s on any of them if
     // it names a column the migrations never created, so all must be guarded, not just displayed
     // columns. `detail.fields`/`detail.linkField` render columns of the same top-level row.
@@ -215,17 +228,19 @@ test("issue #87: plan_reviews is surfaced on the per-epic detail page", async ()
   const onEpicDetail = refs.some(
     (r) => r.page === "epic-detail.page.json" && r.table === "plan_reviews",
   );
-  assert(onEpicDetail, "epic-detail.page.json must bind a grid to plan_reviews (plan-review trace)");
+  assert(onEpicDetail, "epic-detail.page.json must bind the plan-review trace to plan_reviews");
 
-  // The trace is only useful with the verdict + critique columns, so pin them. Assert against the
-  // visibly displayed `columns` (not `fields`, which also holds binding refs like orderBy.field) so
-  // a column silently dropped from the grid UI can't pass by being referenced elsewhere.
+  // The trace is only useful with the verdict + critique surfaced, so pin them. Assert against the
+  // visibly displayed `columns` (not `fields`, which also holds binding refs like orderBy.field) —
+  // for the `prose` renderer (nano-ide#274) these are the header template's `{{round}}`/`{{approved}}`
+  // refs plus the `findings` body — so a field silently dropped from the UI can't pass by being
+  // referenced elsewhere.
   const required = ["round", "approved", "findings"];
   for (const r of refs.filter((x) => x.table === "plan_reviews")) {
     for (const col of required) {
       assert(
         r.columns.includes(col),
-        `${r.page}: plan_reviews grid must expose the "${col}" column`,
+        `${r.page}: plan_reviews trace must surface the "${col}" field`,
       );
     }
   }