@nanobpm/nano-workforce 0.62.0 → 0.63.0

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+# [0.63.0](https://github.com/nanobpm/nano-workforce/compare/v0.62.0...v0.63.0) (2026-08-13)
+
+
+### Features
+
+* Overview landing page with collapsible active-work sections ([#206](https://github.com/nanobpm/nano-workforce/issues/206)) ([64c91df](https://github.com/nanobpm/nano-workforce/commit/64c91dfacd6b9b660a7bbbb1a3c9a8a78603b247)), closes [nanobpm/nano-ide#227](https://github.com/nanobpm/nano-ide/issues/227) [#205](https://github.com/nanobpm/nano-workforce/issues/205)
+
 # [0.62.0](https://github.com/nanobpm/nano-workforce/compare/v0.61.1...v0.62.0) (2026-08-13)
 
 

package/nano.app.json

@@ -178,7 +178,7 @@
     "pages": {
       "enabled": true,
       "pagesDir": "pages",
-      "homePage": "home",
+      "homePage": "overview",
       "sourceName": "app"
     }
   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nanobpm/nano-workforce",
-  "version": "0.62.0",
+  "version": "0.63.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",

package/pages/cockpit.page.json

@@ -9,6 +9,7 @@
         "variant": "bar",
         "title": "Nano Workforce",
         "items": [
+          { "label": "Overview", "page": "overview" },
           { "label": "Convergence", "page": "home" },
           { "label": "Epics", "page": "epic" },
           { "label": "Feature", "page": "feature" },

package/pages/epic-detail.page.json

@@ -10,6 +10,7 @@
         "sticky": true,
         "title": "Nano Workforce",
         "items": [
+          { "label": "Overview", "page": "overview" },
           { "label": "Convergence", "page": "home" },
           { "label": "Epics", "page": "epic" },
           { "label": "Feature", "page": "feature" },

package/pages/epic.page.json

@@ -10,6 +10,7 @@
         "sticky": true,
         "title": "Nano Workforce",
         "items": [
+          { "label": "Overview", "page": "overview" },
           { "label": "Convergence", "page": "home" },
           { "label": "Epics", "page": "epic" },
           { "label": "Feature", "page": "feature" },

package/pages/feature.page.json

@@ -10,6 +10,7 @@
         "sticky": true,
         "title": "Nano Workforce",
         "items": [
+          { "label": "Overview", "page": "overview" },
           { "label": "Convergence", "page": "home" },
           { "label": "Epics", "page": "epic" },
           { "label": "Feature", "page": "feature" },

package/pages/home.page.json

@@ -9,6 +9,10 @@
         "variant": "bar",
         "title": "Nano Workforce",
         "items": [
+          {
+            "label": "Overview",
+            "page": "overview"
+          },
           {
             "label": "Convergence",
             "page": "home"

package/pages/overview.page.json

@@ -0,0 +1,137 @@
+{
+  "schemaVersion": "1.0",
+  "title": "Overview",
+  "nodes": [
+    {
+      "type": "nav",
+      "id": "nav",
+      "props": {
+        "variant": "bar",
+        "sticky": true,
+        "title": "Nano Workforce",
+        "items": [
+          { "label": "Overview", "page": "overview" },
+          { "label": "Convergence", "page": "home" },
+          { "label": "Epics", "page": "epic" },
+          { "label": "Feature", "page": "feature" },
+          { "label": "Cockpit", "page": "cockpit" }
+        ]
+      }
+    },
+    {
+      "type": "text",
+      "id": "title",
+      "props": { "text": "Overview", "variant": "heading" }
+    },
+    {
+      "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.",
+        "variant": "sub"
+      }
+    },
+    {
+      "type": "dataGrid",
+      "id": "overview-prs",
+      "props": {
+        "title": "Active PR convergences",
+        "collapsible": true,
+        "defaultCollapsed": false,
+        "showCount": true,
+        "rowKey": "pr_key",
+        "refreshMs": 5000,
+        "data": {
+          "kind": "datasource",
+          "source": "app",
+          "table": "pull_requests",
+          "orderBy": { "field": "updated_at", "dir": "desc" },
+          "filter": [
+            {
+              "field": "status",
+              "in": [
+                "converging",
+                "waiting_review",
+                "escalated",
+                "waiting_deps",
+                "waiting_merge",
+                "queued",
+                "merging"
+              ]
+            }
+          ]
+        },
+        "columns": [
+          { "field": "pr_key", "header": "PR", "link": { "kind": "page", "page": "home", "keyField": "pr_key" } },
+          { "field": "status", "header": "Status", "link": { "kind": "processExplorer", "keyField": "process_key" } },
+          {
+            "field": "incident_message",
+            "header": "Incident",
+            "badge": { "tone": "danger", "label": "1" }
+          },
+          { "field": "current_round", "header": "Round" },
+          { "field": "active_worker", "header": "Agent" },
+          { "field": "updated_at", "header": "Updated" }
+        ]
+      }
+    },
+    {
+      "type": "dataGrid",
+      "id": "overview-epics",
+      "props": {
+        "title": "Active Epics",
+        "collapsible": true,
+        "defaultCollapsed": false,
+        "showCount": true,
+        "rowKey": "plan_key",
+        "refreshMs": 5000,
+        "data": {
+          "kind": "datasource",
+          "source": "app",
+          "table": "plans",
+          "orderBy": { "field": "updated_at", "dir": "desc" },
+          "filter": [{ "field": "status", "in": ["planning", "dispatched"] }]
+        },
+        "columns": [
+          { "field": "plan_key", "header": "Epic", "link": { "kind": "page", "page": "epic-detail", "keyField": "plan_key" } },
+          { "field": "status", "header": "Status", "link": { "kind": "processExplorer", "keyField": "process_key" } },
+          { "field": "delivery", "header": "Delivery" },
+          { "field": "base_branch", "header": "Base branch" },
+          { "field": "wave_label", "header": "Wave" },
+          { "field": "task_count", "header": "Tasks" },
+          { "field": "issue_number", "header": "Issue", "linkField": "issue_url" },
+          { "field": "updated_at", "header": "Updated" }
+        ]
+      }
+    },
+    {
+      "type": "dataGrid",
+      "id": "overview-features",
+      "props": {
+        "title": "Active Features",
+        "collapsible": true,
+        "defaultCollapsed": false,
+        "showCount": true,
+        "rowKey": "feature_key",
+        "refreshMs": 5000,
+        "data": {
+          "kind": "datasource",
+          "source": "app",
+          "table": "feature_runs",
+          "orderBy": { "field": "updated_at", "dir": "desc" },
+          "filter": [{ "field": "status", "in": ["running", "awaiting_operator"] }]
+        },
+        "columns": [
+          { "field": "feature_key", "header": "Feature", "link": { "kind": "page", "page": "feature", "keyField": "feature_key" } },
+          { "field": "status", "header": "Status", "link": { "kind": "processExplorer", "keyField": "process_key" } },
+          { "field": "base_branch", "header": "Base branch" },
+          { "field": "pr_key", "header": "PR", "link": { "kind": "page", "page": "home", "keyField": "pr_key" } },
+          { "field": "converge", "header": "Converge" },
+          { "field": "auto_merge", "header": "Auto-merge" },
+          { "field": "outcome", "header": "Outcome" },
+          { "field": "updated_at", "header": "Updated" }
+        ]
+      }
+    }
+  ]
+}

package/scripts/pages-contract.test.ts

@@ -230,3 +230,57 @@ test("issue #87: plan_reviews is surfaced on the per-epic detail page", async ()
     }
   }
 });
+
+test("issue #205: overview is the landing page and first nav item", async () => {
+  const overview = JSON.parse(readFileSync(`${ROOT}pages/overview.page.json`, "utf8"));
+
+  // The overview must be the pages-surface home so it's the default destination.
+  const app = JSON.parse(readFileSync(`${ROOT}nano.app.json`, "utf8"));
+  assert(
+    app?.surfaces?.pages?.homePage === "overview",
+    "nano.app.json surfaces.pages.homePage must be \"overview\" (the landing page)",
+  );
+
+  // Every page's nav must lead with Overview so it's the first tab everywhere.
+  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"));
+    const nav = (page.nodes ?? []).find((n: Json) => n.type === "nav");
+    if (!nav) continue;
+    const first = nav.props?.items?.[0];
+    assert(
+      first?.page === "overview" && first?.label === "Overview",
+      `${e.name}: nav must lead with the Overview tab (first item page "overview")`,
+    );
+  }
+
+  // Three collapsible active-work sections, one per dispatch surface, each with a
+  // live count in its header (showCount) and a persisted collapse toggle (collapsible).
+  const expected: Record<string, string[]> = {
+    pull_requests: [
+      "converging",
+      "waiting_review",
+      "escalated",
+      "waiting_deps",
+      "waiting_merge",
+      "queued",
+      "merging",
+    ],
+    plans: ["planning", "dispatched"],
+    feature_runs: ["running", "awaiting_operator"],
+  };
+  const grids = (overview.nodes ?? []).filter((n: Json) => n.type === "dataGrid");
+  for (const [table, statuses] of Object.entries(expected)) {
+    const grid = grids.find((g: Json) => g.props?.data?.table === table);
+    assert(grid, `overview.page.json must have a section bound to "${table}"`);
+    assert(grid.props.collapsible === true, `overview "${table}" section must be collapsible`);
+    assert(grid.props.showCount === true, `overview "${table}" section must show a live count`);
+    const filter = grid.props?.data?.filter?.find((f: Json) => f.field === "status");
+    assert(filter, `overview "${table}" section must filter on status`);
+    assert(
+      JSON.stringify([...filter.in].sort()) === JSON.stringify([...statuses].sort()),
+      `overview "${table}" section must filter to the active statuses ${JSON.stringify(statuses)}`,
+    );
+  }
+});
+