@nanobpm/nano-workforce 0.170.1 → 0.171.1

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+## [0.171.1](https://github.com/nanobpm/nano-workforce/compare/v0.171.0...v0.171.1) (2026-08-31)
+
+### Code Refactoring
+
+* **agentic:** consume @nanobpm/agentic/transcript, drop the duplicated grammar ([#677](https://github.com/nanobpm/nano-workforce/issues/677)) ([8c8d3fc](https://github.com/nanobpm/nano-workforce/commit/8c8d3fc393134862557a65e2aab2dd9e16292c66)), closes [#676](https://github.com/nanobpm/nano-workforce/issues/676)
+
+## [0.171.0](https://github.com/nanobpm/nano-workforce/compare/v0.170.1...v0.171.0) (2026-08-31)
+
+### Features
+
+* **operations:** app-owned POST /actions/cancel door (cancelInstance) ([#671](https://github.com/nanobpm/nano-workforce/issues/671)) ([835afce](https://github.com/nanobpm/nano-workforce/commit/835afcea6be62fc768979b792217ad5cf246d008)), closes [#605](https://github.com/nanobpm/nano-workforce/issues/605) [#667](https://github.com/nanobpm/nano-workforce/issues/667)
+
 ## [0.170.1](https://github.com/nanobpm/nano-workforce/compare/v0.170.0...v0.170.1) (2026-08-31)
 
 ### Documentation

package/app/agentic/transcript-events.drift.test.ts

@@ -1,11 +1,12 @@
-// Drift-guard: exactly ONE parser of the transcript log (ADR 0056, #251).
+// Drift-guard: the transcript grammar is DERIVED from its one owner, never re-forked here (#676).
 //
-// Acceptance criterion (#251): "the cockpit renders from a single derive*() fold, with no independent
-// re-parse of raw bytes (drift-guard test asserts one parser)". This is that guard. It enforces
-// structurally — by scanning the app-tier source — that the raw-chunk → typed-event classification
-// lives in exactly one module (`transcript-events.ts`), so a second, divergent parser of the same
-// bytes cannot creep in. The whole point of the event-sourced model is "the log IS the state": every
-// view derives from the one fold, none re-parses the bytes itself.
+// nano-workforce used to carry a byte-for-byte hand-rolled copy of the transcript-event grammar
+// (marker/version, the ONE parser, the vocabulary, the derive fold). That grammar now lives in exactly
+// one place — `@nanobpm/agentic/transcript` (agentic 0.10.0) — and `transcript-events.ts` is a thin
+// re-export barrel over it. This guard secures the *class* of failure ("a consumer hand-rolls the
+// transcript grammar instead of importing it") structurally, by scanning the app-tier source: it fails
+// if the barrel stops importing agentic, if a local module re-defines the envelope marker literal, or
+// if a transcript consumer re-parses a stored chunk itself instead of folding through the one parser.
 import { test } from "node:test";
 import { readdirSync, readFileSync } from "node:fs";
 import { dirname, join } from "node:path";
@@ -26,26 +27,36 @@ function sourceFiles(dir: string): string[] {
   return out;
 }
 
-const PARSER_MODULE = join(AGENTIC_DIR, "transcript-events.ts");
+const BARREL_MODULE = join(AGENTIC_DIR, "transcript-events.ts");
+const AGENTIC_TRANSCRIPT_SPECIFIER = "@nanobpm/agentic/transcript";
 
-test("the transcript-event marker literal is DEFINED in exactly one module (no second parser)", () => {
-  // Consumers reference the marker via the imported `TRANSCRIPT_EVENT_MARKER` identifier; only the ONE
-  // parser embeds the marker's string literal. A second module hardcoding it would be a second parser.
-  // Match every quote form (double, single, backtick) so a second parser can't bypass the guard by
-  // hardcoding the marker in a different literal style.
+test("the transcript grammar is imported from @nanobpm/agentic/transcript, never redefined locally", () => {
+  // The single source of truth is agentic; nano-workforce derives from it via a re-export barrel.
+  const barrel = readFileSync(BARREL_MODULE, "utf8");
+  assert(
+    barrel.includes(AGENTIC_TRANSCRIPT_SPECIFIER),
+    `${BARREL_MODULE} must re-export the grammar from "${AGENTIC_TRANSCRIPT_SPECIFIER}"`,
+  );
+});
+
+test("no local module re-defines the transcript-event marker literal (no second grammar)", () => {
+  // Consumers reference the marker via the imported `TRANSCRIPT_EVENT_MARKER` identifier; only a
+  // second, forked grammar would embed the marker's string literal in nano-workforce source. Match
+  // every quote form (double, single, backtick) so a re-fork can't bypass the guard by hardcoding the
+  // marker in a different literal style. Expect ZERO owners — the literal lives in agentic now.
   const quotedMarkerForms = ['"', "'", "`"].map((q) => `${q}${TRANSCRIPT_EVENT_MARKER}${q}`);
   const owners = sourceFiles(AGENTIC_DIR).filter((path) => {
     const src = readFileSync(path, "utf8");
     return quotedMarkerForms.some((literal) => src.includes(literal));
   });
-  assertEquals(owners, [PARSER_MODULE]);
+  assertEquals(owners, []);
 });
 
-test("no transcript consumer re-parses raw chunks — JSON.parse of the log lives only in the parser", () => {
-  // The cockpit + read projections must fold through the single parser, never JSON.parse a chunk
-  // themselves. Scan the transcript-facing consumers and assert none contains a raw JSON.parse.
-  const consumers = sourceFiles(AGENTIC_DIR).filter(
-    (path) => path !== PARSER_MODULE && /transcript-(read|render|view|derive|fork)\.ts$/.test(path),
+test("no transcript consumer re-parses raw chunks — the log is folded only through the one parser", () => {
+  // The cockpit + read projections must fold through the single parser (in agentic), never JSON.parse a
+  // chunk themselves. Scan the transcript-facing consumers and assert none contains a raw JSON.parse.
+  const consumers = sourceFiles(AGENTIC_DIR).filter((path) =>
+    /transcript-(read|render|view|derive|fork)\.ts$/.test(path),
   );
   assert(consumers.length >= 3, "expected to scan several transcript consumers");
   for (const path of consumers) {