MeTTa TS 1.3.0

Author: MesTTo

.gitignore

@@ -13,3 +13,17 @@ website/.vitepress/dist/
 website/.vitepress/cache/
 # Local hyperon venv for the @metta-ts/py differential oracle (HYPERON_LIVE=1)
 .venv-hyperon/
+
+# Test coverage and V8 profiler output
+coverage/
+isolate-*.log
+
+# Local scratch, notes, and screenshots (never committed)
+/ai-notes/
+/ai-tmp/
+/ai-*.md
+/metta-interlingua/
+/scratch-review/
+/billboard-25d.png
+/browser-ide-mobile.png
+/readme-full.png

.prettierignore

@@ -3,6 +3,7 @@
 packages/core/src/prelude.ts
 corpus/**
 pnpm-lock.yaml
+ai-*.md
 
 packages/das-client/src/gen/
 packages/das-client/proto/

LICENSES/GPL-3.0-only.txt

@@ -22,9 +22,11 @@ npm install @metta-ts/hyperon     # a Python-hyperon-style class API
 npm install @metta-ts/edsl        # a typed TypeScript eDSL for building MeTTa
 npm install @metta-ts/node        # CLI + file import! + a parallel matcher
 npm install @metta-ts/browser     # web entry + in-memory virtual file system
+npm install @metta-ts/libraries   # PeTTa standard libraries (auto-loaded by node/hyperon/browser)
 npm install @metta-ts/py          # optional Python interop: pythonia or Pyodide
 npm install @metta-ts/prolog      # optional Prolog interop: SWI native or SWI-WASM
 npm install @metta-ts/grapher     # visual editor + browser or Node reduction GIFs
+npm install @metta-ts/debug       # debugger engine (trace + why); the metta-debug CLI ships in @metta-ts/node
 ```
 
 For the command-line runner, install `@metta-ts/node` globally (or use `npx`):

README.md

@@ -1,3 +1,67 @@
+# MeTTa TS 1.3.0
+
+MeTTa TS 1.3.0 moves the standard libraries and the debugger engine out of the
+core into their own packages. The interpreter behaves exactly as in 1.2.0: the
+conformance oracle is byte-identical and every library returns the same results.
+This is a structural release, so there are no new language features.
+
+## `@metta-ts/libraries`
+
+The eight standard libraries (`vector`, `roman`, `combinatorics`, `patrick`,
+`datastructures`, `spaces`, `nars`, `pln`) moved out of `@metta-ts/core` into a
+new `@metta-ts/libraries` package, one folder and one `.metta` file per library,
+so the engine no longer ships library source it does not run.
+
+`@metta-ts/node`, `@metta-ts/hyperon`, and `@metta-ts/browser` depend on the new
+package and register it when they load, so `(import! &self pln)` and the other
+library imports keep working with no change. The one behavior change is that bare
+`@metta-ts/core` no longer resolves the libraries on its own. A program run
+through `runProgram` from core alone registers them first:
+
+```ts
+import { registerLibraries } from "@metta-ts/libraries";
+registerLibraries();
+```
+
+The libraries are ports of Patrick Hammer's PeTTa `lib/lib_*.metta` set, with
+`roman` from Roman Treutlein's PeTTa prelude; the extraction now credits them.
+
+## `@metta-ts/debug`
+
+The `metta-debug` engine moved into a new `@metta-ts/debug` package. It holds the
+execution-trace summary behind `why` and the `explainCall`, `collectTrace`, and
+`summarize` helpers, depends only on `@metta-ts/core`, and uses no Node APIs, so
+an editor or tool can drive it directly. The `metta-debug` command still ships in
+`@metta-ts/node` and works exactly as before, now a thin wrapper over the shared
+engine.
+
+## Verification
+
+Checked on Linux with Node and pnpm.
+
+- Build, type check, lint, and format checks pass across all twelve packages.
+- `pnpm test` passes: 1,218 tests across 126 files, with 38 optional live
+  integration tests (7 files) skipped.
+- The oracle passes all 23 corpus files, byte-identical to 1.2.0: the extraction
+  moves the library source without changing it.
+- The repository is REUSE 3.3 compliant.
+
+## Packages
+
+All public packages use version `1.3.0`:
+
+```bash
+npm install @metta-ts/core@1.3.0
+npm install -g @metta-ts/node@1.3.0
+```
+
+The standard libraries and the debugger engine are available on their own:
+
+```bash
+npm install @metta-ts/libraries@1.3.0
+npm install @metta-ts/debug@1.3.0
+```
+
 # MeTTa TS 1.2.0
 
 MeTTa TS 1.2.0 adds eight importable standard libraries and makes the core list

RELEASE_NOTES.md

@@ -29,3 +29,38 @@ path = ["corpus/EXPECTED.txt"]
 precedence = "aggregate"
 SPDX-FileCopyrightText = "2026 TrueAGI Inc. and the hyperon-experimental contributors"
 SPDX-License-Identifier = "MIT"
+
+# Pure MeTTa library sources are generated back into runtime strings, so they cannot carry inline headers.
+# They are ports of Patrick Hammer's PeTTa lib/lib_*.metta set; roman is Roman Treutlein's PeTTa prelude.
+[[annotations]]
+path = ["packages/libraries/src/roman/**"]
+precedence = "aggregate"
+SPDX-FileCopyrightText = [
+  "2025 Roman Treutlein — PeTTa (https://github.com/trueagi-io/PeTTa)",
+  "2026 MesTTo — MeTTa-TS adaptation",
+]
+SPDX-License-Identifier = "MIT"
+
+[[annotations]]
+path = [
+  "packages/libraries/src/vector/**",
+  "packages/libraries/src/combinatorics/**",
+  "packages/libraries/src/patrick/**",
+  "packages/libraries/src/datastructures/**",
+  "packages/libraries/src/spaces/**",
+  "packages/libraries/src/nars/**",
+  "packages/libraries/src/pln/**",
+]
+precedence = "aggregate"
+SPDX-FileCopyrightText = [
+  "2025 Patrick Hammer — PeTTa (https://github.com/trueagi-io/PeTTa)",
+  "2026 MesTTo — MeTTa-TS adaptation",
+]
+SPDX-License-Identifier = "MIT"
+
+# @metta-ts/py interop parity fixtures and binary docs-site assets carry no inline header.
+[[annotations]]
+path = ["packages/py/corpus/**", "website/public/**"]
+precedence = "aggregate"
+SPDX-FileCopyrightText = "2026 MesTTo"
+SPDX-License-Identifier = "MIT"

REUSE.toml

@@ -1,4 +1,9 @@
 <!doctype html>
+<!--
+SPDX-FileCopyrightText: 2026 MesTTo
+
+SPDX-License-Identifier: MIT
+-->
 <html lang="en">
   <head>
     <meta charset="utf-8" />

examples/browser-interop/index.html

@@ -1,6 +1,6 @@
 {
   "name": "@metta-ts/browser",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",
@@ -31,7 +31,8 @@
     "build": "tsup src/index.ts src/source.ts src/host.ts src/hyperpose-worker.ts --format esm --dts --clean --platform browser"
   },
   "dependencies": {
-    "@metta-ts/core": "workspace:*"
+    "@metta-ts/core": "workspace:*",
+    "@metta-ts/libraries": "workspace:*"
   },
   "author": "MesTTo",
   "engines": {

packages/browser/package.json

@@ -5,6 +5,7 @@
 // Browser source runners. They mirror the Node source runners without file-system capability: imports come
 // from an in-memory VFS, async forms run through the core async driver, and browser hyperpose uses Web Workers
 // when the host exposes them.
+import "@metta-ts/libraries";
 import {
   DEFAULT_FUEL,
   evalSequential,

packages/browser/src/source.ts

@@ -1,6 +1,6 @@
 {
   "name": "@metta-ts/core",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",