@nanobpm/nano-workforce 0.26.0 → 0.28.0

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+# [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)
+
+
+### Features
+
+* adopt @nanobpm/urban 0.27.0 for the themed console embed ([#81](https://github.com/nanobpm/nano-workforce/issues/81)) ([11ffecb](https://github.com/nanobpm/nano-workforce/commit/11ffecb3897a1ba5d57a9cda49f6859648c66f85)), closes [122/#123](https://github.com/nanobpm/nano-workforce/issues/123)
+
 # [0.26.0](https://github.com/jwulf/urban-pr-review/compare/v0.25.0...v0.26.0) (2026-08-08)
 
 

package/README.md

@@ -7,7 +7,7 @@ every resulting pull request to **review convergence** against an automated
 reviewer, and **merges** it — escalating to a human only when an agent is stuck or
 a round cap is hit.
 
-It is a [Nano](https://github.com/jwulf/nano-ide) **Urban app**: a set of durable
+It is a [Nano](https://nanobpm.io) **Urban app**: a set of durable
 BPMN processes (`resources/processes/*.bpmn`) executed by the Nano engine, with the
 orchestration graph — planning, implementation, review, and merge — modelled
 explicitly so the whole lifecycle survives restarts, latency, and failure.

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.24.0"
+    "@nanobpm/urban": "npm:@nanobpm/urban@^0.27.0"
   },
   "tasks": {
     "start": "deno run --allow-net --allow-read --allow-write --allow-run=gh --allow-env main.ts",

package/deno.lock

@@ -3,6 +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:@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",
@@ -66,8 +67,8 @@
     "@colors/colors@1.5.0": {
       "integrity": "sha512-ooWCrlZP11i8GImSjTHYHLkvFDP48nS4+204nGb1RiX/WXYHmJA2III9/e2DWVabCESdW7hBAEzHRqUn9OUVvQ=="
     },
-    "@nanobpm/nano-app-schema@0.1.0": {
-      "integrity": "sha512-DquJmAw8Ke/cWjz6Se2PxmXZ7J35uy9BH8Aib1vfw3ivP+pKx2s6mL7du0D6MvfNuqEyj0+DNLIJPbRsFCbtGA==",
+    "@nanobpm/nano-app-schema@0.3.0": {
+      "integrity": "sha512-bz7wqYsfetcSMYIMW2e1rmbE2k844TCtXWwBd+uVV/s3iRsi09Ff0WMaBEZWuvBPopwHhD2JATCNCXdEBULjfA==",
       "dependencies": [
         "bpmn-moddle@9.0.4",
         "dmn-moddle",
@@ -81,8 +82,8 @@
         "ws"
       ]
     },
-    "@nanobpm/urban@0.23.0": {
-      "integrity": "sha512-pmeAn2HLkQcgs7spmzXbiMC7U6L8075e21/H9nOnicjwXbojADCHEB9XFMbWYXPaflE8YaT0OtWPOJbcGhlYug==",
+    "@nanobpm/urban@0.27.0": {
+      "integrity": "sha512-FjGv0ttj2TqRTvYUjHDKwBWmZImn17VWjbYVmy6cMAjhtGa5cFsuJOWHwV1WTdkJhcvC3WcsjB6gaAxYQNzglg==",
       "dependencies": [
         "@nanobpm/nano-app-schema",
         "@nanobpm/nano-sdk",
@@ -92,8 +93,8 @@
       ],
       "bin": true
     },
-    "@nanobpm/workflow@0.8.0_bpmn-auto-layout@2.0.0-alpha.2": {
-      "integrity": "sha512-hJ/wpdP87U76eTfQ7cMEmQkyouFN86xSWGF0FKNm8zVzffcTJ4k80FsXlgjQuzffnmqCa8eypITtbsQLrWHHyg==",
+    "@nanobpm/workflow@0.8.1_bpmn-auto-layout@2.0.0-alpha.2": {
+      "integrity": "sha512-Ql6sMGc6uKKRHWR4KBtAz4xmVbMmKpgTYmLQfWbTDCKqyUk0s4DS+xocdto6tymSY4PJeIAOyOLvKaFfW5WHrA==",
       "dependencies": [
         "@nanobpm/nano-sdk",
         "bpmn-auto-layout"
@@ -571,8 +572,8 @@
         "typescript"
       ]
     },
-    "create-urban-app@0.5.1": {
-      "integrity": "sha512-nBddAIPVXhEZzolbljVZP9FystHVX0qfLdmWrwEx/c3yslpW784V5Hy9hFqRK8U9zbwpCUYu+7FLp97gA+IICg==",
+    "create-urban-app@0.7.0": {
+      "integrity": "sha512-N8VxbuFIrnycSYiFBIxKGpRKGuUa3U+rgRWCsqULPnJprbb9cqv7EYLL6R+4cziZ0S2a+HLyy0K0NOk0Cvyhew==",
       "bin": true
     },
     "cross-spawn@7.0.6": {
@@ -1705,8 +1706,8 @@
         "strip-ansi"
       ]
     },
-    "ws@8.21.2": {
-      "integrity": "sha512-54dMVAo4WIe6SKy3vBgN+9bJZqqQ8IMRevAkOLQALhi49qkkQDQfWdAZ8KQlXiEabw88ARXXdUrlvtbKQX+aKw=="
+    "ws@8.21.3": {
+      "integrity": "sha512-201TZ/kPWxoPr/OKWjquZR1SWKXcvxdH+e1xrx89b3YbmzLMFCLfnaG1HFIgWzJOEWZ7MvpK++odZufgYR50Rw=="
     },
     "xtend@4.0.2": {
       "integrity": "sha512-LKYU1iAXJXUgAXn9URjiu+MWhyUXHsvfp7mcuYm9dSUKK0/CjtrUwFAxD82/mCWbtLsGjFIad0wIsod4zrTAEQ=="
@@ -1756,11 +1757,11 @@
   },
   "workspace": {
     "dependencies": [
-      "npm:@nanobpm/urban@0.24"
+      "npm:@nanobpm/urban@0.27"
     ],
     "packageJson": {
       "dependencies": [
-        "npm:@nanobpm/urban@0.24",
+        "npm:@nanobpm/urban@0.27",
         "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.26.0",
+  "version": "0.28.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.24.0"
+    "@nanobpm/urban": "^0.27.0"
   },
   "devDependencies": {
     "@semantic-release/changelog": "^6.0.3",