@nanobpm/nano-workforce 0.61.1 → 0.63.0

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+# [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)
+
+
+### Features
+
+* **feature-prompt:** claim the issue with a comment before starting work ([#207](https://github.com/nanobpm/nano-workforce/issues/207)) ([b1b23c9](https://github.com/nanobpm/nano-workforce/commit/b1b23c9928704616aa2173cfa056668a11d32e1c))
+
 ## [0.61.1](https://github.com/nanobpm/nano-workforce/compare/v0.61.0...v0.61.1) (2026-08-13)
 
 

package/app/feature.test.ts

@@ -104,6 +104,8 @@ test("startFeature: seeds the single task slice + base-branch brief onto the ins
   assertEquals(v.task.prompt.includes("owner/repo#42"), true);
   assertEquals(v.converge, true);
   assertEquals(v.autoMerge, false);
+  // A single-issue run owns its issue, so the agent is told it may claim it (epic slices never set this).
+  assertEquals(v.claimIssue, true);
   assertEquals(v.baseBranch, "epic/x");
   // The brief is the authoritative base-branch override the agent gets via appendPrompt.
   assertEquals(v.baseBranchBrief.includes("epic/x"), true);

package/app/feature.ts

@@ -202,6 +202,11 @@ export async function startFeature(
       // merge-loop. `converge=false` ⇒ merge is moot.
       converge,
       autoMerge,
+      // A single-issue feature run OWNS its issue (the whole issue is the slice), so the agent may
+      // claim it with a "starting work" comment on a first run (prompts/feature.md). Epic slices
+      // (plan-fanout) deliberately DO NOT set this — their `issue` is the shared parent epic, which
+      // must never be claimed per-slice.
+      claimIssue: true,
       // Seed the agent-result variables so the escalation loop + record worker can reference them
       // before the first `senior:feature` job completes (the harness merges the real values in).
       answer: null,

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.61.1",
+  "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/prompts/feature.md

@@ -22,16 +22,44 @@ You have `gh` / git authenticated for the target repository.
 
 Always use the branch **`feat/<task.id>`**. Because a resumed run gets a fresh
 process with no memory of your last run, the branch name MUST be derivable from
-`task.id` alone. On start, check whether it already exists on the remote
-(`git ls-remote --heads origin feat/<task.id>` or
-`gh pr list --head feat/<task.id> --state all`):
+`task.id` alone. On start, check whether it already exists on the remote with
+`git ls-remote --heads origin feat/<task.id>` — a non-empty result means the
+branch exists. Use this ref check as the authoritative first-run/resume signal:
+a remote branch can exist without any PR, so `gh pr list --head feat/<task.id> --state all`
+is reliable only as a *supplementary* PR lookup once `git ls-remote` has
+established the branch exists, never as the existence check itself:
 
 - **It does not exist** → this is a first run. Branch off the base branch (see
   the note below — usually the repository default branch, but an epic may pin an
-  integration branch in your appended task context).
+  integration branch in your appended task context). **Claim the issue now** — see
+  below.
 - **It exists** → this is a **resume**. `git fetch` and check it out, read its diff
   and any open (draft) PR, and **continue from there** — do not restart from
-  scratch. Fold in `variables.answer` as the guidance you were waiting on.
+  scratch. Fold in `variables.answer` as the guidance you were waiting on. Do
+  **not** re-claim — you already announced this run on your first pass.
+
+## Claim your issue on a first run (only when `variables.claimIssue` is true)
+
+So humans and other agents can see the work has been picked up, announce yourself
+on the issue **before implementing** — but ONLY on a first run (your
+`feat/<task.id>` branch did not yet exist, per the check above) AND only when
+**`variables.claimIssue` is true**:
+
+```sh
+gh issue comment <variables.issue> --body-file - <<'BODY'
+🤖 Starting work on this issue — branch `feat/<task.id>`.
+BODY
+```
+
+- `variables.claimIssue` is set **only for single-issue feature runs**, where
+  `variables.issue` IS the issue you implement and close, so claiming it is
+  correct. **Epic slices leave it unset** — their `variables.issue` is the shared
+  *parent epic*, which must never be claimed per-slice; when `claimIssue` is not
+  true, **skip this step entirely**.
+- The branch-existence check above is what makes this idempotent: a resumed run
+  (branch already exists) never re-claims, so the issue gets exactly one claim.
+- It is a courtesy claim, **not a gate** — if the comment fails (e.g. a transient
+  `gh` error), carry on and implement anyway.
 
 ## Your base branch (default branch, unless the epic pins one)
 
@@ -44,14 +72,16 @@ against the wrong base will not be merged into the epic.
 
 ## What to do
 
-1. Clone / check out your base branch (first run — the default branch, or the
+1. Claim your issue if `variables.claimIssue` is true and this is a first run (see
+   above).
+2. Clone / check out your base branch (first run — the default branch, or the
    pinned epic branch if your context names one) or your existing
    `feat/<task.id>` branch (resume — see above).
-2. Implement `task.prompt`. Keep the change scoped to this slice only.
-3. Commit (sign off — this repo family enforces DCO: `git commit -s`), push the
+3. Implement `task.prompt`. Keep the change scoped to this slice only.
+4. Commit (sign off — this repo family enforces DCO: `git commit -s`), push the
    branch, and open a pull request with `gh pr create` describing the slice and
    linking the parent issue (`Depends-on:`/`Closes` as appropriate).
-4. Clean up any scratch clone/worktree you created outside the commit.
+5. Clean up any scratch clone/worktree you created outside the commit.
 
 > **Do not request the Copilot review yourself.** When you open a *ready* PR the
 > app enrolls it into the review-convergence loop and requests the initial

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)}`,
+    );
+  }
+});
+