objectstack-ai · os-zhuang · Jul 31, 2026 · Jul 31, 2026
diff --git a/.changeset/changelog-ships-in-tarball.md b/.changeset/changelog-ships-in-tarball.md
@@ -0,0 +1,100 @@
+---
+"@objectstack/account": patch
+"@objectstack/cli": patch
+"@objectstack/client": patch
+"@objectstack/client-react": patch
+"@objectstack/cloud-connection": patch
+"@objectstack/connector-mcp": patch
+"@objectstack/connector-openapi": patch
+"@objectstack/connector-rest": patch
+"@objectstack/connector-slack": patch
+"@objectstack/console": patch
+"@objectstack/core": patch
+"@objectstack/driver-memory": patch
+"@objectstack/driver-mongodb": patch
+"@objectstack/driver-sql": patch
+"@objectstack/driver-sqlite-wasm": patch
+"@objectstack/embedder-openai": patch
+"@objectstack/formula": patch
+"@objectstack/hono": patch
+"@objectstack/knowledge-memory": patch
+"@objectstack/knowledge-ragflow": patch
+"@objectstack/lint": patch
+"@objectstack/mcp": patch
+"@objectstack/metadata": patch
+"@objectstack/metadata-core": patch
+"@objectstack/metadata-fs": patch
+"@objectstack/metadata-protocol": patch
+"@objectstack/objectql": patch
+"@objectstack/observability": patch
+"@objectstack/platform-objects": patch
+"@objectstack/plugin-approvals": patch
+"@objectstack/plugin-audit": patch
+"@objectstack/plugin-auth": patch
+"@objectstack/plugin-dev": patch
+"@objectstack/plugin-email": patch
+"@objectstack/plugin-hono-server": patch
+"@objectstack/plugin-pinyin-search": patch
+"@objectstack/plugin-reports": patch
+"@objectstack/plugin-security": patch
+"@objectstack/plugin-sharing": patch
+"@objectstack/plugin-webhooks": patch
+"@objectstack/rest": patch
+"@objectstack/runtime": patch
+"@objectstack/sdui-parser": patch
+"@objectstack/service-analytics": patch
+"@objectstack/service-automation": patch
+"@objectstack/service-cache": patch
+"@objectstack/service-cluster": patch
+"@objectstack/service-cluster-redis": patch
+"@objectstack/service-datasource": patch
+"@objectstack/service-i18n": patch
+"@objectstack/service-job": patch
+"@objectstack/service-knowledge": patch
+"@objectstack/service-messaging": patch
+"@objectstack/service-package": patch
+"@objectstack/service-queue": patch
+"@objectstack/service-realtime": patch
+"@objectstack/service-settings": patch
+"@objectstack/service-sms": patch
+"@objectstack/service-storage": patch
+"@objectstack/setup": patch
+"@objectstack/studio": patch
+"@objectstack/trigger-api": patch
+"@objectstack/trigger-record-change": patch
+"@objectstack/trigger-schedule": patch
+"@objectstack/types": patch
+"@objectstack/verify": patch
+"create-objectstack": patch
+"objectstack-vscode": patch
+---
+
+chore(packaging): CHANGELOG.md ships in every npm tarball (#4261)
+
+The AGENTS.md post-task checklist requires breaking changesets to carry their
+FROM → TO migration because "this text ships to consumers as `CHANGELOG.md`
+inside the npm package and is what an upgrading agent greps after the tombstone
+error." That delivery path was severed for 68 of the 69 publishable packages:
+npm packs `package.json` / `README*` / `LICENSE*` unconditionally but — unlike
+older npm versions — not `CHANGELOG.md`, and the canonical
+`"files": ["dist", "README.md"]` whitelist never named it. Measured on npm
+10.9.7: `npm pack --dry-run` on `@objectstack/types` shipped 3 files while its
+70KB `CHANGELOG.md` stayed behind. Only `@objectstack/spec` listed it
+explicitly.
+
+The tombstone-error scenario is precisely the one where the repo is out of
+reach — the upgrading agent has `node_modules` and nothing else — so the
+migration text has to ride in the tarball. Every publishable package now
+declares `CHANGELOG.md` in `files`, and the canonical whitelist is
+`["dist", "README.md", "CHANGELOG.md"]`.
+
+The other half is the gate: `check:published-files` gains a fifth invariant,
+COMPLETE — a whitelist that fails to cover `CHANGELOG.md` fails the
+always-required lint job, so the next package cannot silently sever the path
+again. `@objectstack/spec`'s per-package EXTRA_ENTRIES exemption dissolves
+into the canonical set.
+
+Consumer-visible change: one more file per install (the package's changelog,
+e.g. 70.8KB for `@objectstack/types`), and `grep -r "removed key"
+node_modules/@objectstack/*/CHANGELOG.md` now finds the migration it was
+promised.
diff --git a/packages/adapters/hono/package.json b/packages/adapters/hono/package.json
@@ -51,7 +51,8 @@
   },
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md"
   ],
   "engines": {
     "node": ">=22.0.0"

diff --git a/packages/apps/account/package.json b/packages/apps/account/package.json
@@ -43,7 +43,8 @@
   },
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md"
   ],
   "engines": {
     "node": ">=22.0.0"

diff --git a/packages/apps/setup/package.json b/packages/apps/setup/package.json
@@ -43,7 +43,8 @@
   },
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md"
   ],
   "engines": {
     "node": ">=22.0.0"

diff --git a/packages/apps/studio/package.json b/packages/apps/studio/package.json
@@ -43,7 +43,8 @@
   },
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md"
   ],
   "engines": {
     "node": ">=22.0.0"

diff --git a/packages/cli/package.json b/packages/cli/package.json
@@ -124,7 +124,8 @@
   },
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md"
   ],
   "engines": {
     "node": ">=22.0.0"

diff --git a/packages/client-react/package.json b/packages/client-react/package.json
@@ -47,7 +47,8 @@
   },
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md"
   ],
   "engines": {
     "node": ">=22.0.0"

diff --git a/packages/client/package.json b/packages/client/package.json
@@ -51,7 +51,8 @@
   },
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md"
   ],
   "engines": {
     "node": ">=22.0.0"

diff --git a/packages/cloud-connection/package.json b/packages/cloud-connection/package.json
@@ -49,7 +49,8 @@
   },
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md"
   ],
   "engines": {
     "node": ">=22.0.0"

diff --git a/packages/connectors/connector-mcp/package.json b/packages/connectors/connector-mcp/package.json
@@ -38,6 +38,7 @@
   ],
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md"
   ]
 }
diff --git a/packages/connectors/connector-openapi/package.json b/packages/connectors/connector-openapi/package.json
@@ -36,6 +36,7 @@
     ],
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md"
   ]
 }
diff --git a/packages/connectors/connector-rest/package.json b/packages/connectors/connector-rest/package.json
@@ -35,6 +35,7 @@
   ],
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md"
   ]
 }
diff --git a/packages/connectors/connector-slack/package.json b/packages/connectors/connector-slack/package.json
@@ -35,6 +35,7 @@
   ],
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md"
   ]
 }
diff --git a/packages/console/package.json b/packages/console/package.json
@@ -17,7 +17,8 @@
   },
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md"
   ],
   "exports": {
     "./package.json": "./package.json"

diff --git a/packages/core/package.json b/packages/core/package.json
@@ -54,7 +54,8 @@
   },
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md"
   ],
   "engines": {
     "node": ">=22.0.0"

diff --git a/packages/create-objectstack/package.json b/packages/create-objectstack/package.json
@@ -42,7 +42,8 @@
   },
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md"
   ],
   "engines": {
     "node": ">=22.0.0"

diff --git a/packages/formula/package.json b/packages/formula/package.json
@@ -44,6 +44,7 @@
   },
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md"
   ]
 }
diff --git a/packages/lint/package.json b/packages/lint/package.json
@@ -50,7 +50,8 @@
   },
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md"
   ],
   "engines": {
     "node": ">=22.0.0"

diff --git a/packages/mcp/package.json b/packages/mcp/package.json
@@ -51,7 +51,8 @@
   },
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md"
   ],
   "engines": {
     "node": ">=22.0.0"

diff --git a/packages/metadata-core/package.json b/packages/metadata-core/package.json
@@ -20,7 +20,8 @@
   },
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md"
   ],
   "scripts": {
     "build": "tsup",

diff --git a/packages/metadata-fs/package.json b/packages/metadata-fs/package.json
@@ -15,7 +15,8 @@
   },
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md"
   ],
   "scripts": {
     "build": "tsup",

diff --git a/packages/metadata-protocol/package.json b/packages/metadata-protocol/package.json
@@ -15,7 +15,8 @@
   },
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md"
   ],
   "scripts": {
     "build": "tsup",

diff --git a/packages/metadata/package.json b/packages/metadata/package.json
@@ -25,7 +25,8 @@
   },
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md"
   ],
   "scripts": {
     "build": "tsup",

diff --git a/packages/objectql/package.json b/packages/objectql/package.json
@@ -55,7 +55,8 @@
   },
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md"
   ],
   "engines": {
     "node": ">=22.0.0"

diff --git a/packages/observability/package.json b/packages/observability/package.json
@@ -47,7 +47,8 @@
   },
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md"
   ],
   "engines": {
     "node": ">=22.0.0"

diff --git a/packages/platform-objects/package.json b/packages/platform-objects/package.json
@@ -97,7 +97,8 @@
   },
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md"
   ],
   "engines": {
     "node": ">=22.0.0"

diff --git a/packages/plugins/driver-memory/package.json b/packages/plugins/driver-memory/package.json
@@ -47,7 +47,8 @@
   },
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md"
   ],
   "engines": {
     "node": ">=22.0.0"

diff --git a/packages/plugins/driver-mongodb/package.json b/packages/plugins/driver-mongodb/package.json
@@ -50,7 +50,8 @@
   },
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md"
   ],
   "engines": {
     "node": ">=22.0.0"

diff --git a/packages/plugins/driver-sql/package.json b/packages/plugins/driver-sql/package.json
@@ -71,7 +71,8 @@
   },
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md"
   ],
   "engines": {
     "node": ">=22.0.0"

diff --git a/packages/plugins/driver-sqlite-wasm/package.json b/packages/plugins/driver-sqlite-wasm/package.json
@@ -54,7 +54,8 @@
   },
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md"
   ],
   "engines": {
     "node": ">=22.0.0"

diff --git a/packages/plugins/embedder-openai/package.json b/packages/plugins/embedder-openai/package.json
@@ -39,6 +39,7 @@
   ],
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md"
   ]
 }