MeTTaScript 2.0.4

MesTTo · MesTTo · commit 7796591db305 · 2026-07-22T23:13:19.000+10:00
diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
@@ -1,3 +1,20 @@
+# MeTTaScript 2.0.4
+
+A packaging fix for the browser compatibility package. `@metta-ts/browser` declared `sideEffects: false`
+while shipping a Web Worker entry that does have side effects, so a bundler could tree-shake
+`@metta-ts/browser/hyperpose-worker` down to an empty file and break parallel evaluation in the browser. No
+API or evaluation change: upgrading from 2.0.3 is safe and every terminating program produces the same
+output.
+
+## What changed
+
+`@metta-ts/browser`'s `sideEffects` now lists `./dist/hyperpose-worker.js`, matching the canonical
+`@mettascript/browser`, which already declared it. A consumer that imports the worker for its side effect,
+such as a `new Worker(...)` entry, now keeps the worker code through tree-shaking with no bundler workaround.
+Verified with esbuild 0.28.1: the worker bundle goes from an empty 51 bytes to the full 331 KB. A new test
+asserts every `@metta-ts/*` shim mirrors its `@mettascript/*` canonical's `sideEffects`, so a shim cannot
+silently drop a worker entry again.
+
 # MeTTaScript 2.0.3
 
 Adds an opt-in, deterministic work budget that bounds how much a single query is allowed to compute.
diff --git a/compat/browser/package.json b/compat/browser/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@metta-ts/browser",
-  "version": "2.0.3",
+  "version": "2.0.4",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",
@@ -37,7 +37,9 @@
   "engines": {
     "node": ">=20"
   },
-  "sideEffects": false,
+  "sideEffects": [
+    "./dist/hyperpose-worker.js"
+  ],
   "module": "./dist/index.js",
   "publishConfig": {
     "access": "public"
diff --git a/compat/core/package.json b/compat/core/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@metta-ts/core",
-  "version": "2.0.3",
+  "version": "2.0.4",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",
diff --git a/compat/das-client/package.json b/compat/das-client/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@metta-ts/das-client",
-  "version": "2.0.3",
+  "version": "2.0.4",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",
diff --git a/compat/das-gateway/package.json b/compat/das-gateway/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@metta-ts/das-gateway",
-  "version": "2.0.3",
+  "version": "2.0.4",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",
diff --git a/compat/debug/package.json b/compat/debug/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@metta-ts/debug",
-  "version": "2.0.3",
+  "version": "2.0.4",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",
diff --git a/compat/edsl/package.json b/compat/edsl/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@metta-ts/edsl",
-  "version": "2.0.3",
+  "version": "2.0.4",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",
diff --git a/compat/grapher/package.json b/compat/grapher/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@metta-ts/grapher",
-  "version": "2.0.3",
+  "version": "2.0.4",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",
diff --git a/compat/hyperon/package.json b/compat/hyperon/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@metta-ts/hyperon",
-  "version": "2.0.3",
+  "version": "2.0.4",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",
diff --git a/compat/libraries/package.json b/compat/libraries/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@metta-ts/libraries",
-  "version": "2.0.3",
+  "version": "2.0.4",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",
diff --git a/compat/node/package.json b/compat/node/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@metta-ts/node",
-  "version": "2.0.3",
+  "version": "2.0.4",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",
diff --git a/compat/prolog/package.json b/compat/prolog/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@metta-ts/prolog",
-  "version": "2.0.3",
+  "version": "2.0.4",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",
diff --git a/compat/py/package.json b/compat/py/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@metta-ts/py",
-  "version": "2.0.3",
+  "version": "2.0.4",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",
diff --git a/packages/browser/package.json b/packages/browser/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@mettascript/browser",
-  "version": "2.0.3",
+  "version": "2.0.4",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",
diff --git a/packages/core/package.json b/packages/core/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@mettascript/core",
-  "version": "2.0.3",
+  "version": "2.0.4",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",
diff --git a/packages/core/src/compat-parity.test.ts b/packages/core/src/compat-parity.test.ts
@@ -0,0 +1,35 @@
+// SPDX-FileCopyrightText: 2026 MesTTo
+//
+// SPDX-License-Identifier: MIT
+
+import { existsSync, readFileSync, readdirSync } from "node:fs";
+import { resolve } from "node:path";
+import { describe, expect, it } from "vitest";
+
+// Each @metta-ts/* compat shim re-exports its @mettascript/* canonical, so bundling-relevant package.json
+// fields must match the canonical. sideEffects is the one that regressed: compat/browser shipped `false`
+// while the canonical lists the hyperpose worker, so a bundler tree-shook the worker's side-effect import
+// to an empty file. This asserts every shim mirrors its canonical's sideEffects, so a shim can never again
+// drift into dropping a worker entry.
+const ROOT = process.cwd();
+const COMPAT = resolve(ROOT, "compat");
+const PACKAGES = resolve(ROOT, "packages");
+
+const readSideEffects = (dir: string): unknown =>
+  (JSON.parse(readFileSync(resolve(dir, "package.json"), "utf8")) as { sideEffects?: unknown })
+    .sideEffects;
+
+const shimNames = readdirSync(COMPAT).filter((name) =>
+  existsSync(resolve(COMPAT, name, "package.json")),
+);
+
+describe("compat shim / canonical sideEffects parity", () => {
+  it.each(shimNames)("compat/%s mirrors packages/%s sideEffects", (name) => {
+    expect(existsSync(resolve(PACKAGES, name, "package.json")), `packages/${name} exists`).toBe(
+      true,
+    );
+    expect(readSideEffects(resolve(COMPAT, name))).toEqual(
+      readSideEffects(resolve(PACKAGES, name)),
+    );
+  });
+});
diff --git a/packages/das-client/package.json b/packages/das-client/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@mettascript/das-client",
-  "version": "2.0.3",
+  "version": "2.0.4",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",
diff --git a/packages/das-gateway/package.json b/packages/das-gateway/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@mettascript/das-gateway",
-  "version": "2.0.3",
+  "version": "2.0.4",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",
diff --git a/packages/debug/package.json b/packages/debug/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@mettascript/debug",
-  "version": "2.0.3",
+  "version": "2.0.4",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",
diff --git a/packages/edsl/package.json b/packages/edsl/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@mettascript/edsl",
-  "version": "2.0.3",
+  "version": "2.0.4",
   "author": "MesTTo",
   "license": "MIT",
   "description": "Ergonomic, typed TypeScript eDSL for MeTTa: term builders, tagged templates, host-interop builders, and auto-grounding of TypeScript values.",
diff --git a/packages/grapher/package.json b/packages/grapher/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@mettascript/grapher",
-  "version": "2.0.3",
+  "version": "2.0.4",
   "author": "MesTTo",
   "license": "MIT",
   "description": "MeTTa visual editor and reduction renderer for browser and Node.js, with node-graph and nested-block views.",
diff --git a/packages/hyperon/package.json b/packages/hyperon/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@mettascript/hyperon",
-  "version": "2.0.3",
+  "version": "2.0.4",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",
diff --git a/packages/libraries/package.json b/packages/libraries/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@mettascript/libraries",
-  "version": "2.0.3",
+  "version": "2.0.4",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",
diff --git a/packages/node/package.json b/packages/node/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@mettascript/node",
-  "version": "2.0.3",
+  "version": "2.0.4",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",
diff --git a/packages/prolog/package.json b/packages/prolog/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@mettascript/prolog",
-  "version": "2.0.3",
+  "version": "2.0.4",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",
diff --git a/packages/py/package.json b/packages/py/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@mettascript/py",
-  "version": "2.0.3",
+  "version": "2.0.4",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@metta-ts/core",`
`3`		`- "version": "2.0.3",`
	`3`	`+ "version": "2.0.4",`
`4`	`4`	`"license": "MIT",`
`5`	`5`	`"type": "module",`
`6`	`6`	`"main": "./dist/index.js",`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@metta-ts/das-client",`
`3`		`- "version": "2.0.3",`
	`3`	`+ "version": "2.0.4",`
`4`	`4`	`"license": "MIT",`
`5`	`5`	`"type": "module",`
`6`	`6`	`"main": "./dist/index.js",`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@metta-ts/das-gateway",`
`3`		`- "version": "2.0.3",`
	`3`	`+ "version": "2.0.4",`
`4`	`4`	`"license": "MIT",`
`5`	`5`	`"type": "module",`
`6`	`6`	`"main": "./dist/index.js",`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@metta-ts/debug",`
`3`		`- "version": "2.0.3",`
	`3`	`+ "version": "2.0.4",`
`4`	`4`	`"license": "MIT",`
`5`	`5`	`"type": "module",`
`6`	`6`	`"main": "./dist/index.js",`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@metta-ts/edsl",`
`3`		`- "version": "2.0.3",`
	`3`	`+ "version": "2.0.4",`
`4`	`4`	`"license": "MIT",`
`5`	`5`	`"type": "module",`
`6`	`6`	`"main": "./dist/index.js",`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@metta-ts/grapher",`
`3`		`- "version": "2.0.3",`
	`3`	`+ "version": "2.0.4",`
`4`	`4`	`"license": "MIT",`
`5`	`5`	`"type": "module",`
`6`	`6`	`"main": "./dist/index.js",`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@metta-ts/hyperon",`
`3`		`- "version": "2.0.3",`
	`3`	`+ "version": "2.0.4",`
`4`	`4`	`"license": "MIT",`
`5`	`5`	`"type": "module",`
`6`	`6`	`"main": "./dist/index.js",`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@metta-ts/libraries",`
`3`		`- "version": "2.0.3",`
	`3`	`+ "version": "2.0.4",`
`4`	`4`	`"license": "MIT",`
`5`	`5`	`"type": "module",`
`6`	`6`	`"main": "./dist/index.js",`