@nanobpm/nano-workforce 0.48.1 → 0.49.0

package/pages/epic.page.json

@@ -7,10 +7,11 @@
       "id": "nav",
       "props": {
         "variant": "bar",
+        "sticky": true,
         "title": "Nano Workforce",
         "items": [
           { "label": "Convergence", "page": "home" },
-          { "label": "Epic", "page": "epic" }
+          { "label": "Epics", "page": "epic" }
         ]
       }
     },
@@ -23,7 +24,7 @@
       "type": "text",
       "id": "subtitle",
       "props": {
-        "text": "Hand an issue to the fleet to plan and implement it, then track each plan's review trace, wave state, merge-exclusion graph, coordination notes, and trial-merge gate results.",
+        "text": "Hand an issue to the fleet to plan and implement it, then open an epic to track its review trace, wave state, merge-exclusion graph, coordination notes, and trial-merge gate results.",
         "variant": "sub"
       }
     },
@@ -44,7 +45,7 @@
       "type": "dataGrid",
       "id": "epic-plans",
       "props": {
-        "title": "Plans",
+        "title": "Epics",
         "rowKey": "plan_key",
         "refreshMs": 5000,
         "data": {
@@ -66,241 +67,13 @@
           { "label": "All", "filter": [] }
         ],
         "columns": [
-          { "field": "plan_key", "header": "Issue", "linkField": "issue_url" },
+          { "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": "wave_label", "header": "Wave" },
           { "field": "task_count", "header": "Tasks" },
-          { "field": "open_task_id", "header": "Open escalation" },
-          { "field": "open_plan_round", "header": "Plan escalation round" },
+          { "field": "open_plan_findings", "header": "Attention", "badge": { "tone": "danger", "label": "!" } },
+          { "field": "issue_number", "header": "Issue", "linkField": "issue_url" },
           { "field": "updated_at", "header": "Updated" }
-        ],
-        "rowActions": [
-          {
-            "label": "Proceed with plan",
-            "confirm": "Dispatch the current unapproved plan as a human override?",
-            "showWhenField": "open_plan_escalation_id",
-            "action": {
-              "path": "/app/api/actions/message",
-              "body": {
-                "name": "plan-escalation-answered",
-                "correlationKey": "{{row.plan_key}}",
-                "variables": { "directive": "proceed", "note": "Proceed override from the plans page." }
-              }
-            }
-          }
-        ],
-        "detail": {
-          "linkField": "issue_url",
-          "fields": [
-            { "field": "repo", "label": "Repository" },
-            { "field": "issue_number", "label": "Issue number" },
-            { "field": "base_branch", "label": "Base branch (blank = repo default)" },
-            { "field": "outcome", "label": "Outcome" },
-            { "field": "open_plan_findings", "label": "Open plan-review findings" },
-            { "field": "open_task_question", "label": "Open escalation question" }
-          ],
-          "form": {
-            "showWhenField": "open_plan_escalation_id",
-            "title": "Answer the open plan-review escalation",
-            "promptField": "open_plan_findings",
-            "inputKey": "note",
-            "inputLabel": "Revision directive note for the planner",
-            "submitLabel": "Revise plan",
-            "action": {
-              "path": "/app/api/actions/message",
-              "body": {
-                "name": "plan-escalation-answered",
-                "correlationKey": "{{row.plan_key}}",
-                "variables": { "directive": "revise", "note": "{{form.note}}" }
-              }
-            }
-          }
-        }
-      }
-    },
-    {
-      "type": "dataGrid",
-      "id": "plan-reviews",
-      "props": {
-        "title": "Plan review trace",
-        "refreshMs": 5000,
-        "data": {
-          "kind": "datasource",
-          "source": "app",
-          "table": "plan_reviews",
-          "orderBy": { "field": "round", "dir": "asc" }
-        },
-        "columns": [
-          { "field": "plan_key", "header": "Plan" },
-          { "field": "round", "header": "Round" },
-          { "field": "epoch", "header": "Epoch" },
-          { "field": "approved", "header": "Approved? (1/0)" },
-          { "field": "findings", "header": "Reviewer findings" },
-          { "field": "created_at", "header": "Recorded" }
-        ]
-      }
-    },
-    {
-      "type": "dataGrid",
-      "id": "plan-review-escalations",
-      "props": {
-        "title": "Plan-review escalations",
-        "rowKey": "id",
-        "refreshMs": 5000,
-        "data": {
-          "kind": "datasource",
-          "source": "app",
-          "table": "plan_review_escalations",
-          "orderBy": { "field": "id", "dir": "desc" }
-        },
-        "columns": [
-          { "field": "plan_key", "header": "Plan" },
-          { "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" }
-        ]
-      }
-    },
-    {
-      "type": "dataGrid",
-      "id": "wave-state",
-      "props": {
-        "title": "Wave state",
-        "rowKey": "id",
-        "refreshMs": 5000,
-        "data": {
-          "kind": "datasource",
-          "source": "app",
-          "table": "plan_tasks",
-          "orderBy": { "field": "wave", "dir": "asc" },
-          "filter": [
-            { "field": "status", "in": ["pending", "opened", "escalated", "waiting-for-lane", "blocked"] }
-          ]
-        },
-        "tabs": [
-          {
-            "label": "Active",
-            "filter": [
-              { "field": "status", "in": ["pending", "opened", "escalated", "waiting-for-lane", "blocked"] }
-            ]
-          },
-          {
-            "label": "Skipped",
-            "filter": [{ "field": "status", "in": ["skipped"] }]
-          },
-          { "label": "All", "filter": [] }
-        ],
-        "columns": [
-          { "field": "plan_key", "header": "Plan" },
-          { "field": "wave", "header": "Wave" },
-          { "field": "task_id", "header": "Task" },
-          { "field": "title", "header": "Title" },
-          { "field": "status", "header": "Status" },
-          { "field": "pr_key", "header": "PR" },
-          { "field": "summary", "header": "Summary" },
-          { "field": "updated_at", "header": "Updated" }
-        ],
-        "detail": {
-          "fields": [
-            { "field": "open_question", "label": "Open question" },
-            { "field": "answer", "label": "Answer" },
-            { "field": "draft_pr_key", "label": "Draft PR" },
-            { "field": "prompt", "label": "Prompt" }
-          ]
-        }
-      }
-    },
-    {
-      "type": "dataGrid",
-      "id": "merge-exclusions",
-      "props": {
-        "title": "Conflict graph / who blocks whom",
-        "rowKey": "id",
-        "refreshMs": 5000,
-        "data": {
-          "kind": "datasource",
-          "source": "app",
-          "table": "plan_merge_exclusions",
-          "orderBy": { "field": "id", "dir": "asc" }
-        },
-        "columns": [
-          { "field": "plan_key", "header": "Plan" },
-          { "field": "task_a", "header": "Task A" },
-          { "field": "task_b", "header": "Task B" },
-          { "field": "files", "header": "Shared files" },
-          { "field": "source", "header": "Source" },
-          { "field": "updated_at", "header": "Updated" }
-        ]
-      }
-    },
-    {
-      "type": "dataGrid",
-      "id": "coordination-notes",
-      "props": {
-        "title": "Coordination notes",
-        "rowKey": "id",
-        "refreshMs": 5000,
-        "data": {
-          "kind": "datasource",
-          "source": "app",
-          "table": "plan_blackboard",
-          "orderBy": { "field": "id", "dir": "asc" }
-        },
-        "columns": [
-          { "field": "plan_key", "header": "Plan" },
-          { "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" }
-        ]
-      }
-    },
-    {
-      "type": "dataGrid",
-      "id": "trial-merge-results",
-      "props": {
-        "title": "Trial-merge results",
-        "rowKey": "id",
-        "refreshMs": 5000,
-        "data": {
-          "kind": "datasource",
-          "source": "app",
-          "table": "plan_trial_merges",
-          "orderBy": { "field": "created_at", "dir": "desc" },
-          "filter": [
-            { "field": "result", "in": ["merge-conflict", "suite-failed"] },
-            { "field": "resolved", "in": [0] }
-          ]
-        },
-        "tabs": [
-          {
-            "label": "Needs attention",
-            "filter": [
-              { "field": "result", "in": ["merge-conflict", "suite-failed"] },
-              { "field": "resolved", "in": [0] }
-            ]
-          },
-          {
-            "label": "Clean",
-            "filter": [{ "field": "result", "in": ["clean"] }]
-          },
-          { "label": "All", "filter": [] }
-        ],
-        "columns": [
-          { "field": "plan_key", "header": "Plan" },
-          { "field": "wave", "header": "Wave" },
-          { "field": "result", "header": "Result" },
-          { "field": "heads", "header": "Heads" },
-          { "field": "conflicts", "header": "Conflicts" },
-          { "field": "failing", "header": "Failing" },
-          { "field": "summary", "header": "Summary" },
-          { "field": "created_at", "header": "Recorded" }
         ]
       }
     }

package/pages/home.page.json

@@ -9,15 +9,25 @@
         "variant": "bar",
         "title": "Nano Workforce",
         "items": [
-          { "label": "Convergence", "page": "home" },
-          { "label": "Epic", "page": "epic" }
-        ]
+          {
+            "label": "Convergence",
+            "page": "home"
+          },
+          {
+            "label": "Epics",
+            "page": "epic"
+          }
+        ],
+        "sticky": true
       }
     },
     {
       "type": "text",
       "id": "title",
-      "props": { "text": "PR Review Convergence", "variant": "heading" }
+      "props": {
+        "text": "PR Review Convergence",
+        "variant": "heading"
+      }
     },
     {
       "type": "text",
@@ -31,13 +41,13 @@
       "type": "button",
       "id": "agent-instructions",
       "props": {
-        "label": "🤖 Agent Instructions",
+        "label": "\ud83e\udd16 Agent Instructions",
         "variant": "ghost",
         "modal": {
           "title": "Point your agent at Nano Workforce",
           "description": "Copy this prompt and paste it into your coding agent (Copilot, Claude, etc.). It tells the agent to read this workforce's live operator guide, then help you drive and debug it.",
           "copyLabel": "Copy prompt",
-          "copyText": "You are helping me operate a running Nano Workforce instance — a durable orchestration app that drives pull requests to review convergence against an automated reviewer, merges them, and can take a whole issue and plan \u2192 implement \u2192 converge it across a fleet of coding agents.\n\nFirst, fetch and read its live operator guide. It tells you how to submit PRs and epics for convergence (including whether to go all the way to merge or stop at review consensus), how to find engine instances and relate them to PRs via the Nano/Camunda-8 REST API, how to inspect the models and prompts, and how to help me untangle escalations:\n\n    curl -sS {{appBase}}app/api/agent\n\nIf this instance is secured with a shared secret (NANO_PR_WEBHOOK_SECRET), add its value as an x-hook-secret header, otherwise the request returns 401:\n\n    curl -sS -H \"x-hook-secret: <secret>\" {{appBase}}app/api/agent\n\nThen follow that guide to help me drive and debug this workforce. If you find a bug or a stuck process, the guide explains how to raise an issue or a PR against nanobpm/nano-workforce."
+          "copyText": "You are helping me operate a running Nano Workforce instance \u2014 a durable orchestration app that drives pull requests to review convergence against an automated reviewer, merges them, and can take a whole issue and plan \u2192 implement \u2192 converge it across a fleet of coding agents.\n\nFirst, fetch and read its live operator guide. It tells you how to submit PRs and epics for convergence (including whether to go all the way to merge or stop at review consensus), how to find engine instances and relate them to PRs via the Nano/Camunda-8 REST API, how to inspect the models and prompts, and how to help me untangle escalations:\n\n    curl -sS {{appBase}}app/api/agent\n\nIf this instance is secured with a shared secret (NANO_PR_WEBHOOK_SECRET), add its value as an x-hook-secret header, otherwise the request returns 401:\n\n    curl -sS -H \"x-hook-secret: <secret>\" {{appBase}}app/api/agent\n\nThen follow that guide to help me drive and debug this workforce. If you find a bug or a stuck process, the guide explains how to raise an issue or a PR against nanobpm/nano-workforce."
         }
       }
     },
@@ -47,11 +57,26 @@
       "props": {
         "title": "Submit a pull request",
         "submitLabel": "Start review",
-        "action": { "path": "/app/api/actions/start/convergence-loop", "body": "{{form}}" },
+        "action": {
+          "path": "/app/api/actions/start/convergence-loop",
+          "body": "{{form}}"
+        },
         "fields": [
-          { "key": "pr", "label": "owner/repo#123 or a GitHub PR URL", "type": "text" },
-          { "key": "maxRounds", "label": "Max review rounds (blank = fleet default)", "type": "number" },
-          { "key": "convergeOnly", "label": "Converge only — stop at review consensus, do not merge", "type": "checkbox" }
+          {
+            "key": "pr",
+            "label": "owner/repo#123 or a GitHub PR URL",
+            "type": "text"
+          },
+          {
+            "key": "maxRounds",
+            "label": "Max review rounds (blank = fleet default)",
+            "type": "number"
+          },
+          {
+            "key": "convergeOnly",
+            "label": "Converge only \u2014 stop at review consensus, do not merge",
+            "type": "checkbox"
+          }
         ]
       }
     },
@@ -67,50 +92,140 @@
           "kind": "datasource",
           "source": "app",
           "table": "pull_requests",
-          "orderBy": { "field": "updated_at", "dir": "desc" },
+          "orderBy": {
+            "field": "updated_at",
+            "dir": "desc"
+          },
           "filter": [
-            { "field": "status", "in": ["converging", "waiting_review", "escalated", "waiting_deps", "waiting_merge", "queued", "merging"] }
+            {
+              "field": "status",
+              "in": [
+                "converging",
+                "waiting_review",
+                "escalated",
+                "waiting_deps",
+                "waiting_merge",
+                "queued",
+                "merging"
+              ]
+            }
           ]
         },
         "tabs": [
           {
             "label": "Active",
             "filter": [
-              { "field": "status", "in": ["converging", "waiting_review", "escalated", "waiting_deps", "waiting_merge", "queued", "merging"] }
+              {
+                "field": "status",
+                "in": [
+                  "converging",
+                  "waiting_review",
+                  "escalated",
+                  "waiting_deps",
+                  "waiting_merge",
+                  "queued",
+                  "merging"
+                ]
+              }
             ]
           },
           {
             "label": "History",
-            "filter": [{ "field": "status", "in": ["converged", "merged", "abandoned"] }]
+            "filter": [
+              {
+                "field": "status",
+                "in": [
+                  "converged",
+                  "merged",
+                  "abandoned"
+                ]
+              }
+            ]
           }
         ],
         "columns": [
-          { "field": "pr_key", "header": "PR", "linkField": "url" },
-          { "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" }
+          {
+            "field": "pr_key",
+            "header": "PR",
+            "linkField": "url"
+          },
+          {
+            "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"
+          }
         ],
         "rowActions": [
           {
             "label": "Cancel",
             "confirm": "Cancel this PR's review run?",
             "showWhenField": "process_key",
-            "action": { "path": "/app/actions/cancel", "body": { "processInstanceKey": "{{row.process_key}}" } }
+            "action": {
+              "path": "/app/actions/cancel",
+              "body": {
+                "processInstanceKey": "{{row.process_key}}"
+              }
+            }
           }
         ],
         "detail": {
           "linkField": "url",
           "fields": [
-            { "field": "repo", "label": "Repository" },
-            { "field": "number", "label": "PR number" },
-            { "field": "active_worker", "label": "Agent (leasing worker)" },
-            { "field": "lease_until", "label": "Activation lease until" },
-            { "field": "incident_message", "label": "Incident" },
-            { "field": "incident_key", "label": "Incident key" },
-            { "field": "merged_at", "label": "Merged at" },
-            { "field": "outcome", "label": "Outcome" }
+            {
+              "field": "repo",
+              "label": "Repository"
+            },
+            {
+              "field": "number",
+              "label": "PR number"
+            },
+            {
+              "field": "active_worker",
+              "label": "Agent (leasing worker)"
+            },
+            {
+              "field": "lease_until",
+              "label": "Activation lease until"
+            },
+            {
+              "field": "incident_message",
+              "label": "Incident"
+            },
+            {
+              "field": "incident_key",
+              "label": "Incident key"
+            },
+            {
+              "field": "merged_at",
+              "label": "Merged at"
+            },
+            {
+              "field": "outcome",
+              "label": "Outcome"
+            }
           ],
           "children": [
             {
@@ -119,14 +234,33 @@
               "table": "rounds",
               "parentField": "pr_key",
               "childField": "pr_key",
-              "orderBy": { "field": "round_no", "dir": "asc" },
+              "orderBy": {
+                "field": "round_no",
+                "dir": "asc"
+              },
               "columns": [
-                { "field": "round_no", "header": "#" },
-                { "field": "status", "header": "Result" },
-                { "field": "worker", "header": "Worker" },
-                { "field": "summary", "header": "Summary" }
+                {
+                  "field": "round_no",
+                  "header": "#"
+                },
+                {
+                  "field": "status",
+                  "header": "Result"
+                },
+                {
+                  "field": "worker",
+                  "header": "Worker"
+                },
+                {
+                  "field": "summary",
+                  "header": "Summary"
+                }
               ],
-              "lazyField": { "field": "transcript", "label": "Transcript", "lazy": true }
+              "lazyField": {
+                "field": "transcript",
+                "label": "Transcript",
+                "lazy": true
+              }
             },
             {
               "title": "Escalations",
@@ -134,16 +268,41 @@
               "table": "escalations",
               "parentField": "pr_key",
               "childField": "pr_key",
-              "orderBy": { "field": "id", "dir": "asc" },
+              "orderBy": {
+                "field": "id",
+                "dir": "asc"
+              },
               "columns": [
-                { "field": "round_no", "header": "#" },
-                { "field": "kind", "header": "Kind" },
-                { "field": "worker", "header": "Worker" },
-                { "field": "question", "header": "Question" },
-                { "field": "status", "header": "Status" },
-                { "field": "answer", "header": "Answer" }
+                {
+                  "field": "round_no",
+                  "header": "#"
+                },
+                {
+                  "field": "kind",
+                  "header": "Kind"
+                },
+                {
+                  "field": "worker",
+                  "header": "Worker"
+                },
+                {
+                  "field": "question",
+                  "header": "Question"
+                },
+                {
+                  "field": "status",
+                  "header": "Status"
+                },
+                {
+                  "field": "answer",
+                  "header": "Answer"
+                }
               ],
-              "lazyField": { "field": "transcript", "label": "Agent response", "lazy": true }
+              "lazyField": {
+                "field": "transcript",
+                "label": "Agent response",
+                "lazy": true
+              }
             },
             {
               "title": "Depends on",
@@ -151,10 +310,19 @@
               "table": "pr_dependencies",
               "parentField": "pr_key",
               "childField": "pr_key",
-              "orderBy": { "field": "created_at", "dir": "asc" },
+              "orderBy": {
+                "field": "created_at",
+                "dir": "asc"
+              },
               "columns": [
-                { "field": "depends_on_key", "header": "PR that must merge first" },
-                { "field": "created_at", "header": "Declared" }
+                {
+                  "field": "depends_on_key",
+                  "header": "PR that must merge first"
+                },
+                {
+                  "field": "created_at",
+                  "header": "Declared"
+                }
               ]
             }
           ],
@@ -167,7 +335,11 @@
             "submitLabel": "Send answer",
             "action": {
               "path": "/app/api/actions/message",
-              "body": { "name": "escalation-answered", "correlationKey": "{{row.pr_key}}", "variables": "{{form}}" }
+              "body": {
+                "name": "escalation-answered",
+                "correlationKey": "{{row.pr_key}}",
+                "variables": "{{form}}"
+              }
             }
           }
         }