@nanobpm/nano-workforce 0.46.2 → 0.47.0

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+# [0.47.0](https://github.com/nanobpm/nano-workforce/compare/v0.46.2...v0.47.0) (2026-08-12)
+
+
+### Features
+
+* **ui:** Agent Instructions button (copy-paste agent prompt) ([#126](https://github.com/nanobpm/nano-workforce/issues/126)) ([4c022ab](https://github.com/nanobpm/nano-workforce/commit/4c022abcbaa90501cacc27ac0b9c8d77b3f81df1)), closes [nanobpm/nano-ide#196](https://github.com/nanobpm/nano-ide/issues/196)
+
 ## [0.46.2](https://github.com/nanobpm/nano-workforce/compare/v0.46.1...v0.46.2) (2026-08-12)
 
 

package/e2e/convergence-loop.e2e.ts

@@ -1,10 +1,14 @@
-// End-to-end pilot for @nanobpm/urban-testkit (nano-ide issue #157, slice S3).
+// End-to-end pilot for @nanobpm/urban-testkit (nano-ide issue #157, slices S3 + S4).
 //
 // Boots this whole Urban app in-process against the WASM engine and a virtual clock via
 // `bootTestApp`, then drives its real ADR-0059 OpenAPI operations by `operationId` — the same
 // spec-driven `/app/api/*` surface a browser, a CI relay, or Swagger hit in production. No socket
 // is opened, no wall-clock is waited on, and no GitHub network is touched.
 //
+// It also adopts the S4 coverage-exhaustive gate: booted with `{ coverage: true }`, it gates a
+// curated `pilot:operations` surface (the operations this pilot claims to own) and prints an
+// informational whole-app coverage snapshot for the operations/workers it does not yet drive.
+//
 // Network isolation: the app's GitHub transport (app/github.ts) is forced to `token` mode with no
 // token, so every best-effort GitHub read short-circuits to `null`/idle instead of reaching out.
 // That keeps the pilot hermetic and deterministic in CI.
@@ -60,6 +64,14 @@ const HARNESS_ENV = {
   NANO_APP_DB_URL: `file:${join(DB_DIR, "app.db")}`,
 } as const;
 
+// The operations this pilot claims to own — the slice of the app's OpenAPI surface it drives end
+// to end. The coverage gate below is scoped to exactly these: if you add one here without a test
+// that drives it, `assertFullCoverage` goes red. (The app declares 10 operations + 16 workers in
+// total; this pilot is deliberately a representative slice, not a whole-app sweep, so it does NOT
+// gate the auto-declared "operations"/"workers" surfaces — it reports them instead, see below.)
+const PILOT_OPERATIONS = ["appendBlackboard", "readBlackboard", "startConvergenceLoop"] as const;
+const PILOT_SURFACE = "pilot:operations";
+
 describe("nano-workforce e2e (urban-testkit pilot)", () => {
   let app: TestApp;
 
@@ -68,9 +80,13 @@ describe("nano-workforce e2e (urban-testkit pilot)", () => {
       savedEnv.set(k, process.env[k]);
       process.env[k] = v;
     }
-    app = await bootTestApp(APP_ROOT, { env: HARNESS_ENV });
+    // Enable the S4 coverage gate: `app.coverage` is pre-declared with this app's "operations"
+    // (from openapi.yaml) and "workers" (from nano.app.json) surfaces, and records each hit
+    // automatically as the pilot drives operations / the engine runs jobs.
+    app = await bootTestApp(APP_ROOT, { env: HARNESS_ENV, coverage: true });
     // This app declares an `api` binding, so the spec-driven driver must be present.
     assert.ok(app.api, "app.api driver should be defined (nano.app.json declares an `api` binding)");
+    assert.ok(app.coverage, "app.coverage should be defined (booted with { coverage: true })");
   });
 
   after(async () => {
@@ -172,4 +188,35 @@ describe("nano-workforce e2e (urban-testkit pilot)", () => {
     const reconciled = await prs.findOne({ pr_key: prKey });
     assert.equal(reconciled?.status, "abandoned", "reconciler abandoned the terminated PR's row");
   });
+
+  test("coverage gate: every operation the pilot claims to own was exercised", () => {
+    const coverage = app.coverage;
+    assert.ok(coverage);
+
+    // The auto-declared "operations" surface has recorded (across the tests above) exactly the
+    // operations this pilot drove. Mirror the pilot-owned ones into a curated surface and gate
+    // THAT — so the pilot fails the moment a `PILOT_OPERATIONS` entry lacks a driving test, without
+    // demanding whole-app coverage (this is a representative slice, not a full sweep).
+    const report = coverage.report();
+    const opsExercised = new Set(
+      report.surfaces.find((s) => s.surface === "operations")?.exercised ?? [],
+    );
+    coverage.declareSurface(PILOT_SURFACE, PILOT_OPERATIONS);
+    for (const id of PILOT_OPERATIONS) {
+      if (opsExercised.has(id)) coverage.record(PILOT_SURFACE, id);
+    }
+    // Fails, naming any un-driven pilot operation, if PILOT_OPERATIONS grows without a test.
+    coverage.assertFullCoverage({ surfaces: [PILOT_SURFACE] });
+
+    // Informational (non-failing) whole-app snapshot: how much of the app's total surface this
+    // pilot exercises. Surfaces the remaining operations/workers as a roadmap for widening the
+    // pilot, without turning the deliberate slice into a red build.
+    for (const surface of report.surfaces) {
+      const { exercised, declared, missing } = surface;
+      console.log(
+        `[coverage] ${surface.surface}: ${exercised.length}/${declared.length} exercised` +
+          (missing.length ? ` — not yet driven: ${missing.join(", ")}` : ""),
+      );
+    }
+  });
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nanobpm/nano-workforce",
-  "version": "0.46.2",
+  "version": "0.47.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",
@@ -50,7 +50,7 @@
   },
   "devDependencies": {
     "@biomejs/biome": "^2.4.11",
-    "@nanobpm/urban-testkit": "^0.3.0",
+    "@nanobpm/urban-testkit": "^0.4.0",
     "@semantic-release/changelog": "^6.0.3",
     "@semantic-release/git": "^10.0.1",
     "@semantic-release/npm": "^13.1.5",

package/pages/home.page.json

@@ -27,6 +27,20 @@
         "variant": "sub"
       }
     },
+    {
+      "type": "button",
+      "id": "agent-instructions",
+      "props": {
+        "label": "🤖 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."
+        }
+      }
+    },
     {
       "type": "actionForm",
       "id": "submit",