@nanobpm/nano-workforce 0.90.0 → 0.91.0

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+# [0.91.0](https://github.com/nanobpm/nano-workforce/compare/v0.90.0...v0.91.0) (2026-08-19)
+
+
+### Features
+
+* **tasks:** show subject title with repo/issue# as subtitle ([#308](https://github.com/nanobpm/nano-workforce/issues/308)) ([#311](https://github.com/nanobpm/nano-workforce/issues/311)) ([5771b38](https://github.com/nanobpm/nano-workforce/commit/5771b38abc33f4f88329d69c808214dfd42f5113))
+
 # [0.90.0](https://github.com/nanobpm/nano-workforce/compare/v0.89.0...v0.90.0) (2026-08-19)
 
 

package/app/pollUserTasks.test.ts

@@ -78,6 +78,7 @@ test("pollUserTasks: projects feature / plan-review / trial-merge / PR-wait esca
         status: "escalated",
         process_key: "fp-10",
         issue_url: "https://github.com/o/r/issues/10",
+        title: "Add the framework selector",
         escalation_user_task_key: "ut-feat",
         escalation_question: "which framework?",
         blocked_user_task_key: null,
@@ -85,7 +86,7 @@ test("pollUserTasks: projects feature / plan-review / trial-merge / PR-wait esca
       },
     ],
     plans: [
-      { plan_key: "o/r#20", status: "dispatched", process_key: "pp-20", issue_url: "https://github.com/o/r/issues/20" },
+      { plan_key: "o/r#20", status: "dispatched", process_key: "pp-20", issue_url: "https://github.com/o/r/issues/20", title: "Broaden the epic scope" },
       { plan_key: "o/r#21", status: "done", process_key: "pp-21", issue_url: "https://github.com/o/r/issues/21" },
     ],
     plan_reviews: [
@@ -96,7 +97,7 @@ test("pollUserTasks: projects feature / plan-review / trial-merge / PR-wait esca
       { id: 1, plan_key: "o/r#20", wave: 0, result: "suite-failed", summary: "wave 0 red", resolved: 0 },
     ],
     pull_requests: [
-      { pr_key: "o/r#30", status: "escalated", process_key: "rp-30", url: "https://github.com/o/r/pull/30" },
+      { pr_key: "o/r#30", status: "escalated", process_key: "rp-30", url: "https://github.com/o/r/pull/30", title: "Resolve the reviews" },
     ],
     escalations: [{ id: 1, pr_key: "o/r#30", status: "open", question: "conflicting reviews" }],
   });
@@ -115,13 +116,17 @@ test("pollUserTasks: projects feature / plan-review / trial-merge / PR-wait esca
   assertEquals(Object.keys(byKey).sort(), ["ut-feat", "ut-plan", "ut-pr", "ut-trial"]);
   assertEquals(byKey["ut-feat"].kind_label, "Feature escalation");
   assertEquals(byKey["ut-feat"].question, "which framework?");
+  assertEquals(byKey["ut-feat"].subject_title, "Add the framework selector");
   assertEquals(byKey["ut-plan"].kind_label, "Plan review");
   assertEquals(byKey["ut-plan"].question, "scope too broad");
+  assertEquals(byKey["ut-plan"].subject_title, "Broaden the epic scope");
   assertEquals(byKey["ut-trial"].kind_label, "Trial merge");
   assertEquals(byKey["ut-trial"].question, "wave 0 red");
+  assertEquals(byKey["ut-trial"].subject_title, "Broaden the epic scope");
   assertEquals(byKey["ut-pr"].kind_label, "PR review");
   assertEquals(byKey["ut-pr"].subject_type, "pr");
   assertEquals(byKey["ut-pr"].question, "conflicting reviews");
+  assertEquals(byKey["ut-pr"].subject_title, "Resolve the reviews");
 });
 
 test("pollUserTasks: projects a merge-loop wait-merge-answer escalation into user_tasks as \"PR merge\"", async () => {

package/app/service.ts

@@ -1626,6 +1626,7 @@ export async function pollUserTasks(data: DataLayer, engine: EngineClient) {
               elementId: FEATURE_ESCALATION_ELEMENT,
               subjectType: "feature",
               subjectKey: run.feature_key,
+              subjectTitle: run.title,
               subjectUrl: run.issue_url,
               question: run.escalation_question,
               processKey: run.process_key,
@@ -1642,6 +1643,7 @@ export async function pollUserTasks(data: DataLayer, engine: EngineClient) {
               elementId: FEATURE_BLOCKED_ELEMENT,
               subjectType: "feature",
               subjectKey: run.feature_key,
+              subjectTitle: run.title,
               subjectUrl: run.issue_url,
               question: run.delivery_label,
               processKey: run.process_key,
@@ -1680,6 +1682,7 @@ export async function pollUserTasks(data: DataLayer, engine: EngineClient) {
                 elementId: PLAN_REVIEW_ELEMENT,
                 subjectType: "plan",
                 subjectKey: plan.plan_key,
+                subjectTitle: plan.title,
                 subjectUrl: plan.issue_url,
                 question,
                 processKey: plan.process_key,
@@ -1696,6 +1699,7 @@ export async function pollUserTasks(data: DataLayer, engine: EngineClient) {
                 elementId: TRIAL_MERGE_ELEMENT,
                 subjectType: "plan",
                 subjectKey: plan.plan_key,
+                subjectTitle: plan.title,
                 subjectUrl: plan.issue_url,
                 question,
                 processKey: plan.process_key,
@@ -1735,6 +1739,7 @@ export async function pollUserTasks(data: DataLayer, engine: EngineClient) {
               elementId: t.elementId,
               subjectType: "pr",
               subjectKey: pr.pr_key,
+              subjectTitle: pr.title,
               subjectUrl: pr.url,
               question,
               processKey: pr.process_key,

package/app/userTasks.test.ts

@@ -41,6 +41,7 @@ test("buildUserTaskRow: a plan-review task becomes a labelled row with its findi
     kind_label: "Plan review",
     subject_type: "plan",
     subject_key: "o/r#1",
+    subject_title: "o/r#1",
     subject_url: "https://github.com/o/r/issues/1",
     question: "cap reached: revise scope",
     process_key: "pk-1",
@@ -80,6 +81,28 @@ test("buildUserTaskRow: a blank userTaskKey or subjectKey yields null", () => {
   );
 });
 
+test("buildUserTaskRow: subject_title carries the subject title, trimmed, and coalesces to subject_key when absent/blank (issue #308)", () => {
+  const titled = buildUserTaskRow(
+    {
+      userTaskKey: "ut-t1",
+      elementId: PLAN_REVIEW_ELEMENT,
+      subjectType: "plan",
+      subjectKey: "o/r#1",
+      subjectTitle: "  Add the widget  ",
+    },
+    AT,
+  );
+  assertEquals(titled?.subject_title, "Add the widget");
+
+  for (const subjectTitle of [undefined, null, "   "]) {
+    const row = buildUserTaskRow(
+      { userTaskKey: "ut-t2", elementId: PLAN_REVIEW_ELEMENT, subjectType: "plan", subjectKey: "o/r#2", subjectTitle },
+      AT,
+    );
+    assertEquals(row?.subject_title, "o/r#2");
+  }
+});
+
 function row(key: string, extra: Partial<UserTaskRow> = {}): UserTaskRow {
   return {
     user_task_key: key,
@@ -87,6 +110,7 @@ function row(key: string, extra: Partial<UserTaskRow> = {}): UserTaskRow {
     kind_label: "Plan review",
     subject_type: "plan",
     subject_key: "o/r#1",
+    subject_title: "o/r#1",
     subject_url: null,
     question: null,
     process_key: null,

package/app/userTasks.ts

@@ -51,6 +51,10 @@ export interface UserTaskRow {
   kind_label: string;
   subject_type: string;
   subject_key: string;
+  /** The subject's human-readable title (`feature_runs`/`plans`/`pull_requests`.`title`), derived by
+   *  `pollUserTasks` from the subject row keyed on `subject_key` and coalesced to `subject_key` at
+   *  build time so the title-led grids never render a blank primary line (issue #308). */
+  subject_title: string;
   subject_url: string | null;
   question: string | null;
   process_key: string | null;
@@ -78,6 +82,10 @@ export interface UserTaskContext {
   elementId: string;
   subjectType: "feature" | "plan" | "pr";
   subjectKey: string;
+  /** The subject's human-readable title from its own row (`feature_runs`/`plans`/`pull_requests`.
+   *  `title`). Optional/blank tolerated — `buildUserTaskRow` coalesces it to `subjectKey` so the
+   *  projected `subject_title` is never blank. */
+  subjectTitle?: string | null;
   subjectUrl?: string | null;
   question?: string | null;
   processKey?: string | null;
@@ -93,12 +101,14 @@ export function buildUserTaskRow(ctx: UserTaskContext, at: string = now()): User
   const kindLabel = USER_TASK_KIND_LABELS[ctx.elementId];
   if (!userTaskKey || !subjectKey || !kindLabel) return null;
   const question = typeof ctx.question === "string" && ctx.question.trim() ? ctx.question.trim() : null;
+  const subjectTitle = typeof ctx.subjectTitle === "string" && ctx.subjectTitle.trim() ? ctx.subjectTitle.trim() : subjectKey;
   return {
     user_task_key: userTaskKey,
     element_id: ctx.elementId,
     kind_label: kindLabel,
     subject_type: ctx.subjectType,
     subject_key: subjectKey,
+    subject_title: subjectTitle,
     subject_url: ctx.subjectUrl ?? null,
     question,
     process_key: ctx.processKey ?? null,
@@ -124,6 +134,7 @@ function sameRow(a: UserTaskRow, b: UserTaskRow): boolean {
     a.kind_label === b.kind_label &&
     a.subject_type === b.subject_type &&
     a.subject_key === b.subject_key &&
+    a.subject_title === b.subject_title &&
     a.subject_url === b.subject_url &&
     a.question === b.question &&
     a.process_key === b.process_key

package/db/migrations/043_user_tasks_subject_title.sql

@@ -0,0 +1,24 @@
+-- Surface the subject's human-readable title as the primary identity on the Tasks
+-- grids (issue #308), mirroring the Features list. Every `user_tasks` row was keyed
+-- only by `subject_key` (`owner/repo#N`) — meaningful while you remember the number,
+-- opaque hours later. The Features list already leads with `{{title}}` and shows the
+-- key as a subtitle; the Tasks grids could only show the bare key.
+--
+-- The title is DERIVED (no new fetch): each escalation's subject already persists a
+-- title in a surviving table keyed by `subject_key` — `feature_runs.title`,
+-- `plans.title`, `pull_requests.title`. `pollUserTasks` reads it from the subject row
+-- already in scope this pass and coalesces to `subject_key` at write time so the
+-- column is ALWAYS non-blank — the grid's `{{subject_title}}` template then needs no
+-- fallback and a missing subject title still shows a usable identity.
+--
+-- Forward-only, additive (expand): nullable with no default, then backfilled in the
+-- same migration so the column is non-blank immediately — pre-#308 rows would otherwise
+-- grandfather in as NULL and the grid's `{{subject_title}}` primary line would render a
+-- blank/"null" identity for the window between deploy and the first `pollUserTasks` pass.
+-- The backfill coalesces existing rows to `subject_key` (matching the write-time coalesce
+-- in `pollUserTasks`, which re-derives the real title in place on the next poll — a
+-- completed task's row is deleted, not migrated). Idempotent: re-running is a no-op once
+-- set. Numbered after the current highest prefix on origin/main (042); the runner wraps
+-- each file in its own transaction, so this file must NOT contain BEGIN/COMMIT.
+ALTER TABLE user_tasks ADD COLUMN subject_title TEXT;
+UPDATE user_tasks SET subject_title = subject_key WHERE subject_title IS NULL OR trim(subject_title) = '';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nanobpm/nano-workforce",
-  "version": "0.90.0",
+  "version": "0.91.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/tasks.page.json

@@ -84,8 +84,12 @@
         },
         "columns": [
           {
-            "field": "subject_key",
-            "header": "Feature"
+            "field": "subject_title",
+            "template": "{{subject_title}}",
+            "header": "Item",
+            "subtitleField": "subject_key",
+            "truncate": true,
+            "linkField": "subject_url"
           },
           {
             "field": "subject_url",
@@ -141,8 +145,12 @@
         },
         "columns": [
           {
-            "field": "subject_key",
-            "header": "Epic"
+            "field": "subject_title",
+            "template": "{{subject_title}}",
+            "header": "Item",
+            "subtitleField": "subject_key",
+            "truncate": true,
+            "linkField": "subject_url"
           },
           {
             "field": "question",
@@ -202,8 +210,12 @@
         },
         "columns": [
           {
-            "field": "subject_key",
-            "header": "Epic"
+            "field": "subject_title",
+            "template": "{{subject_title}}",
+            "header": "Item",
+            "subtitleField": "subject_key",
+            "truncate": true,
+            "linkField": "subject_url"
           },
           {
             "field": "question",
@@ -264,8 +276,12 @@
         },
         "columns": [
           {
-            "field": "subject_key",
-            "header": "PR"
+            "field": "subject_title",
+            "template": "{{subject_title}}",
+            "header": "Item",
+            "subtitleField": "subject_key",
+            "truncate": true,
+            "linkField": "subject_url"
           },
           {
             "field": "kind_label",
@@ -343,8 +359,12 @@
         },
         "columns": [
           {
-            "field": "subject_key",
-            "header": "Feature"
+            "field": "subject_title",
+            "template": "{{subject_title}}",
+            "header": "Item",
+            "subtitleField": "subject_key",
+            "truncate": true,
+            "linkField": "subject_url"
           },
           {
             "field": "question",