@nanobpm/nano-workforce 0.118.2 → 0.120.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nanobpm/nano-workforce",
-  "version": "0.118.2",
+  "version": "0.120.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/epic-detail.page.json

@@ -82,6 +82,51 @@
         "variant": "sub"
       }
     },
+    {
+      "type": "prose",
+      "id": "wave-banner",
+      "props": {
+        "refreshMs": 5000,
+        "measure": 80,
+        "empty": "No plan recorded for this epic yet.",
+        "data": {
+          "kind": "datasource",
+          "source": "app",
+          "table": "plan_read_model",
+          "orderBy": { "field": "updated_at", "dir": "desc" },
+          "filter": [{ "field": "plan_key", "eqParam": true }]
+        },
+        "header": "Wave {{wave_label}} · {{epic_phase}}",
+        "body": "delivery_label"
+      }
+    },
+    {
+      "type": "dataGrid",
+      "id": "wave-summary",
+      "props": {
+        "title": "Wave progress",
+        "rowKey": "wave",
+        "refreshMs": 5000,
+        "empty": "No waves yet — this epic hasn't been levelized into waves.",
+        "data": {
+          "kind": "datasource",
+          "source": "app",
+          "table": "plan_wave_summary",
+          "orderBy": { "field": "wave", "dir": "asc" },
+          "filter": [{ "field": "plan_key", "eqParam": true }]
+        },
+        "columns": [
+          { "field": "wave", "header": "Wave" },
+          { "field": "bar", "header": "Progress", "width": "40%" },
+          { "field": "merged", "header": "Merged" },
+          { "field": "in_flight", "header": "In flight" },
+          { "field": "blocked", "header": "Blocked" },
+          { "field": "escalated", "header": "Escalated" },
+          { "field": "skipped", "header": "Skipped" },
+          { "field": "total", "header": "Total" }
+        ]
+      }
+    },
     {
       "type": "dataGrid",
       "id": "epic-plan",
@@ -92,7 +137,7 @@
         "data": {
           "kind": "datasource",
           "source": "app",
-          "table": "plans",
+          "table": "plan_read_model",
           "orderBy": { "field": "updated_at", "dir": "desc" },
           "filter": [{ "field": "plan_key", "eqParam": true }]
         },
@@ -161,7 +206,7 @@
         "data": {
           "kind": "datasource",
           "source": "app",
-          "table": "plan_tasks",
+          "table": "plan_wave_tasks",
           "orderBy": { "field": "wave", "dir": "asc" },
           "filter": [
             { "field": "plan_key", "eqParam": true },
@@ -192,8 +237,8 @@
           { "field": "wave", "header": "Wave" },
           { "field": "task_id", "header": "Task" },
           { "field": "title", "header": "Title" },
-          { "field": "status", "header": "Status" },
-          { "field": "pr_key", "header": "PR" },
+          { "field": "status", "header": "Status", "link": { "kind": "processExplorer", "keyField": "process_key" } },
+          { "field": "pr_key", "header": "PR", "linkField": "pr_url" },
           { "field": "summary", "header": "Summary" },
           { "field": "updated_at", "header": "Updated", "format": "datetime" }
         ],

package/pages/lineage.page.json

@@ -87,7 +87,7 @@
         "data": {
           "kind": "datasource",
           "source": "app",
-          "table": "lineage_threads",
+          "table": "lineage_thread_view",
           "orderBy": { "field": "updated_at", "dir": "desc" },
           "filter": [{ "field": "active", "in": [1] }]
         },

package/pages/overview.page.json

@@ -140,7 +140,7 @@
         "data": {
           "kind": "datasource",
           "source": "app",
-          "table": "plans",
+          "table": "plan_read_model",
           "orderBy": { "field": "updated_at", "dir": "desc" },
           "filter": [{ "field": "list_bucket", "in": ["active"] }]
         },

package/pages/velocity.page.json

@@ -85,7 +85,7 @@
         "data": {
           "kind": "datasource",
           "source": "app",
-          "table": "merges_per_day",
+          "table": "merges_per_day_view",
           "orderBy": { "field": "day", "dir": "asc" }
         },
         "header": "{{day}} \u00b7 {{merged}} merged \u00b7 \u03a3 {{cumulative}}",

package/scripts/pages-contract.test.ts

@@ -49,6 +49,54 @@ function parseSchema(sql: string, schema: Map<string, Set<string>>): void {
     cols.add(m[2]);
     schema.set(m[1], cols);
   }
+  // CREATE VIEW [IF NOT EXISTS] <name> AS SELECT <select-list> FROM …
+  //
+  // A page datasource can bind a VIEW as well as a base table (nano-ide#424), so a view's OUTPUT
+  // columns must join the whitelist exactly like a table's. A view has no `PRAGMA`-visible column
+  // list in this static parse, so we read them off its SELECT projection: take the select-list up
+  // to the first top-level `FROM`, split it on top-level commas, and record each item's output name
+  // (its `AS <alias>`, or the trailing identifier of a bare `t.col` / `col`). This is why the
+  // repo's views (see 059_plan_wave_summary.sql) alias every projected column and avoid select-list
+  // subqueries — it keeps this purely-textual contract guard able to see their columns.
+  const viewRe = /CREATE\s+VIEW\s+(?:IF\s+NOT\s+EXISTS\s+)?["`]?(\w+)["`]?\s+AS\s+SELECT\s+/gi;
+  while ((m = viewRe.exec(sql)) !== null) {
+    const selectList = topLevelSelectList(sql, viewRe.lastIndex);
+    if (selectList === null) continue;
+    const cols = schema.get(m[1]) ?? new Set<string>();
+    for (const frag of splitTopLevel(selectList)) {
+      const col = viewColumnName(frag);
+      if (col) cols.add(col);
+    }
+    schema.set(m[1], cols);
+  }
+}
+
+// The select-list of a view: the text between `SELECT` (its end at `start`) and the first top-level
+// `FROM` keyword (one at paren depth 0 — a `FROM` inside a function/subquery doesn't end the list).
+function topLevelSelectList(s: string, start: number): string | null {
+  let depth = 0;
+  for (let i = start; i < s.length; i++) {
+    const c = s[i];
+    if (c === "(") depth++;
+    else if (c === ")") depth--;
+    else if (depth === 0 && (c === "F" || c === "f")) {
+      // whole-word FROM with a non-identifier char (or string start) on each side
+      if (/from/i.test(s.slice(i, i + 4)) && !/\w/.test(s[i - 1] ?? " ") && !/\w/.test(s[i + 4] ?? " ")) {
+        return s.slice(start, i);
+      }
+    }
+  }
+  return null;
+}
+
+// The output name of one select-list item: its `AS <alias>` if present, else the trailing
+// identifier of a bare `table.column` / `column` reference.
+function viewColumnName(frag: string): string | null {
+  const trimmed = frag.trim();
+  const asMatch = trimmed.match(/\bAS\s+["`]?(\w+)["`]?\s*$/i);
+  if (asMatch) return asMatch[1];
+  const bare = trimmed.match(/(\w+)\s*$/);
+  return bare ? bare[1] : null;
 }
 
 // Return the text inside the parentheses whose opener is at `openIdx`, honouring nesting.
@@ -275,12 +323,14 @@ test("issue #205: overview is the landing page and first nav item", async () =>
   // EPIC surface buckets on the DERIVED `list_bucket` (issue #298) — NOT raw `status` — so a `done`
   // epic still converging, or landed-but-unpromoted, does not vanish from the in-flight Epics section
   // the instant `status=done`. Guarding the field here is the regression guard for that defect class.
+  // The epic surface binds the derived `plan_read_model` VIEW (epic #412 — the single source of truth
+  // for the wave/delivery projections it also renders), not the raw `plans` table.
   const expected: Record<string, { field: string; in: string[] }> = {
     pull_requests: {
       field: "status",
       in: ["converging", "waiting_review", "escalated", "waiting_deps", "waiting_merge", "queued", "merging"],
     },
-    plans: { field: "list_bucket", in: ["active"] },
+    plan_read_model: { 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.