@nanobpm/nano-workforce 0.27.0 → 0.29.0

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+# [0.29.0](https://github.com/nanobpm/nano-workforce/compare/v0.28.0...v0.29.0) (2026-08-08)
+
+
+### Features
+
+* **app:** page nav bar + urban 0.28.0 multi-page navigation ([#83](https://github.com/nanobpm/nano-workforce/issues/83)) ([4011598](https://github.com/nanobpm/nano-workforce/commit/40115981211d4f50d6243ddf990c668e1a75c60c))
+
+# [0.28.0](https://github.com/nanobpm/nano-workforce/compare/v0.27.0...v0.28.0) (2026-08-08)
+
+
+### Features
+
+* **blackboard:** first-class 'learning' kind for shared gotchas ([#82](https://github.com/nanobpm/nano-workforce/issues/82)) ([35ff09d](https://github.com/nanobpm/nano-workforce/commit/35ff09dce4a46dab03811fa5657828ca1f027c7c))
+
 # [0.27.0](https://github.com/nanobpm/nano-workforce/compare/v0.26.0...v0.27.0) (2026-08-08)
 
 

package/app/blackboard.test.ts

@@ -86,6 +86,7 @@ Deno.test("blackboardUrl: capability token rides the query string", () => {
 Deno.test("normalizeKind: valid passes through, anything else becomes note", () => {
   assertEquals(normalizeKind("file-claim"), "file-claim");
   assertEquals(normalizeKind("constraint-change"), "constraint-change");
+  assertEquals(normalizeKind("learning"), "learning");
   assertEquals(normalizeKind("bogus"), "note");
   assertEquals(normalizeKind(undefined), "note");
 });
@@ -105,6 +106,9 @@ Deno.test("renderCoordinationBrief: leads with a separator and teaches the proto
   assertStringIncludes(brief, "cursor");
   assertStringIncludes(brief, "&since=");
   assertStringIncludes(brief, "conflicts");
+  // Learnings: teaches reading prior gotchas and posting a reusable `learning`.
+  assertStringIncludes(brief, "learning");
+  assertStringIncludes(brief, "Share what you learn");
 });
 
 Deno.test("planKeyForToken: resolves a token to its plan, undefined otherwise", async () => {

package/app/blackboard.ts

@@ -21,7 +21,7 @@ import type { DataLayer } from "@nanobpm/urban";
 
 const now = () => new Date().toISOString();
 
-export const BLACKBOARD_KINDS = ["file-claim", "constraint-change", "scope-change", "note"] as const;
+export const BLACKBOARD_KINDS = ["file-claim", "constraint-change", "scope-change", "learning", "note"] as const;
 export type BlackboardKind = (typeof BLACKBOARD_KINDS)[number];
 
 /** The stored row shape (files is a JSON-encoded string of paths, or NULL). */
@@ -109,13 +109,16 @@ Your blackboard endpoint (already scoped to this epic — no auth header needed)
 
     ${url}
 
-**On start — READ it** to see what siblings have claimed or changed:
+**On start — READ it** to see what siblings have claimed, changed, or **learned**:
 
     curl -s "${url}"
 
 Returns \`{ "planKey": "...", "cursor": <head-entry-id>, "entries": [ { "id", "author_task", "kind", "files", "body", "wave", "created_at" }, ... ] }\` (\`cursor\` is the head entry id, or \`0\` for an empty plan).
 If an entry overlaps your slice (same file, a changed contract/constraint), adapt: coordinate,
 rebase your plan, or if it genuinely blocks you, escalate with a \`question\` per your normal contract.
+**Apply prior \`learning\` entries before you start** — a gotcha a sibling already hit (e.g. "run
+\`make generate\` before \`cargo build\` or the build fails on a stale generated surface") saves you
+from re-discovering it the hard way.
 
 **When your work affects others — POST an entry** (do this as soon as it's true, not only at the end):
 
@@ -124,9 +127,22 @@ rebase your plan, or if it genuinely blocks you, escalate with a \`question\` pe
 
 \`kind\` is one of: \`file-claim\` (you now edit a file outside your original slice),
 \`constraint-change\` (you discovered a constraint that changes another task's direction),
-\`scope-change\` (your contract/scope shifted), or \`note\`. Set \`author_task\` to your task id.
-If a retry might make you re-POST the same fact, include a stable \`"dedupe_key"\` so it collapses to
-one entry.
+\`scope-change\` (your contract/scope shifted), \`learning\` (see below), or \`note\`. Set
+\`author_task\` to your task id. If a retry might make you re-POST the same fact, include a stable
+\`"dedupe_key"\` so it collapses to one entry.
+
+**Share what you learn — POST a \`learning\`.** Whenever you hit a **reusable, non-obvious gotcha**
+that a sibling working this repo would also hit — a required build/codegen step, a test or lint
+incantation, an environment/toolchain footgun, a workaround for a sharp edge — post it immediately
+so nobody re-learns it independently, and so we can later lift the recurring ones into a script, CI,
+or \`AGENTS.md\`. Keep the \`body\` concrete and actionable (the exact command / the exact cause), and
+give it a stable \`"dedupe_key"\` (e.g. a short slug of the gotcha) so the same learning collapses to
+one entry across retries and siblings:
+
+    curl -s -X POST "${url}" -H 'content-type: application/json' \\
+      -d '{"author_task":"<your-task-id>","kind":"learning","dedupe_key":"regen-before-build","body":"Run \`make generate\` before \`cargo build --features console\` — a stale generated surface fails the build with a confusing error."}'
+
+A \`learning\` is advisory and never blocks anyone; it is knowledge for the fleet, not a claim on a file.
 
 **Stay in sync while you work (this matters most while siblings run in parallel).** The GET
 response includes a \`"cursor"\`. Re-read incrementally — before you start each new file, and at

package/deno.json

@@ -6,7 +6,7 @@
     ]
   },
   "imports": {
-    "@nanobpm/urban": "npm:@nanobpm/urban@^0.27.0"
+    "@nanobpm/urban": "npm:@nanobpm/urban@^0.28.0"
   },
   "tasks": {
     "start": "deno run --allow-net --allow-read --allow-write --allow-run=gh --allow-env main.ts",

package/deno.lock

@@ -3,7 +3,7 @@
   "specifiers": {
     "jsr:@std/assert@1": "1.0.19",
     "jsr:@std/internal@^1.0.12": "1.0.14",
-    "npm:@nanobpm/urban@0.27": "0.27.0",
+    "npm:@nanobpm/urban@0.28": "0.28.0",
     "npm:@semantic-release/changelog@^6.0.3": "6.0.3_semantic-release@24.2.9__typescript@5.9.3_typescript@5.9.3",
     "npm:@semantic-release/git@^10.0.1": "10.0.1_semantic-release@24.2.9__typescript@5.9.3_typescript@5.9.3",
     "npm:@semantic-release/npm@^13.1.5": "13.1.5_semantic-release@24.2.9__typescript@5.9.3",
@@ -82,8 +82,8 @@
         "ws"
       ]
     },
-    "@nanobpm/urban@0.27.0": {
-      "integrity": "sha512-FjGv0ttj2TqRTvYUjHDKwBWmZImn17VWjbYVmy6cMAjhtGa5cFsuJOWHwV1WTdkJhcvC3WcsjB6gaAxYQNzglg==",
+    "@nanobpm/urban@0.28.0": {
+      "integrity": "sha512-rhzgOV+Vb1CPuNoVHVX3OtxjHqzSp2gJIV2pi3EBi245ZjDRN0gSoPGd/MEnJdufxgWwDKuvhyljRDHE8T957w==",
       "dependencies": [
         "@nanobpm/nano-app-schema",
         "@nanobpm/nano-sdk",
@@ -1757,11 +1757,11 @@
   },
   "workspace": {
     "dependencies": [
-      "npm:@nanobpm/urban@0.27"
+      "npm:@nanobpm/urban@0.28"
     ],
     "packageJson": {
       "dependencies": [
-        "npm:@nanobpm/urban@0.27",
+        "npm:@nanobpm/urban@0.28",
         "npm:@semantic-release/changelog@^6.0.3",
         "npm:@semantic-release/git@^10.0.1",
         "npm:@semantic-release/npm@^13.1.5",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nanobpm/nano-workforce",
-  "version": "0.27.0",
+  "version": "0.29.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",
@@ -40,7 +40,7 @@
     "test": "deno test -A"
   },
   "dependencies": {
-    "@nanobpm/urban": "^0.27.0"
+    "@nanobpm/urban": "^0.28.0"
   },
   "devDependencies": {
     "@semantic-release/changelog": "^6.0.3",

package/pages/epic.page.json

@@ -2,6 +2,18 @@
   "schemaVersion": "1.0",
   "title": "Epic Coordination",
   "nodes": [
+    {
+      "type": "nav",
+      "id": "nav",
+      "props": {
+        "variant": "bar",
+        "title": "Nano Workforce",
+        "items": [
+          { "label": "Convergence", "page": "home" },
+          { "label": "Epic", "page": "epic" }
+        ]
+      }
+    },
     {
       "type": "text",
       "id": "title",

package/pages/home.page.json

@@ -2,6 +2,18 @@
   "schemaVersion": "1.0",
   "title": "PR Review Convergence",
   "nodes": [
+    {
+      "type": "nav",
+      "id": "nav",
+      "props": {
+        "variant": "bar",
+        "title": "Nano Workforce",
+        "items": [
+          { "label": "Convergence", "page": "home" },
+          { "label": "Epic", "page": "epic" }
+        ]
+      }
+    },
     {
       "type": "text",
       "id": "title",