From dad5897c1d8b0d2adcb5ff9186496d94b0c33c85 Mon Sep 17 00:00:00 2001
From: Greg Soucy <GREG@COMMANDLAYER.ORG>
Date: Thu, 19 Mar 2026 02:52:45 -0400
Subject: [PATCH] Improve SDK packaging and release metadata

---
 CHANGELOG.md                | 21 +++++++++++++++++++++
 README.md                   |  1 +
 python-sdk/pyproject.toml   |  5 +++--
 typescript-sdk/package.json |  3 ++-
 4 files changed, 27 insertions(+), 3 deletions(-)
 create mode 100644 CHANGELOG.md

diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..e77d2ae
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,21 @@
+# Changelog
+
+## [1.1.0] - 2026-03-19
+
+### Added
+- Canonical `{ receipt, runtime_metadata? }` response model
+- Verification targets canonical receipt
+- TypeScript and Python SDK parity
+- TypeScript CLI support
+
+### Changed
+- Normalized response handling to wrapper model
+- Improved verification flow alignment with runtime
+
+### Fixed
+- No additional fixes recorded in this release note.
+
+### Notes
+- Protocol-Commons v1.1.0 is the current supported line
+- Commercial support is not yet first-class
+- SDK reflects canonical receipt-first architecture
diff --git a/README.md b/README.md
index 34dfd12..abf6700 100644
--- a/README.md
+++ b/README.md
@@ -166,5 +166,6 @@ The CLI is intended for demos, CI smoke tests, debugging, and reproducing SDK fl
 - Cookbook examples: `EXAMPLES.md`
 - Maintainer / architecture notes: `DEVELOPER_EXPERIENCE.md`
 - Build, release, and publish flow: `DEPLOYMENT_GUIDE.md`
+- Changelog: `CHANGELOG.md`
 - TypeScript package docs: `typescript-sdk/README.md`
 - Python package docs: `python-sdk/README.md`
diff --git a/python-sdk/pyproject.toml b/python-sdk/pyproject.toml
index 16f2b59..f5975fa 100644
--- a/python-sdk/pyproject.toml
+++ b/python-sdk/pyproject.toml
@@ -40,9 +40,10 @@ dev = [
 ]
 
 [project.urls]
-Homepage = "https://commandlayer.org"
-Documentation = "https://github.com/commandlayer/sdk/tree/main/python-sdk"
+Homepage = "https://github.com/commandlayer/sdk"
 Repository = "https://github.com/commandlayer/sdk"
+Documentation = "https://github.com/commandlayer/sdk#readme"
+Changelog = "https://github.com/commandlayer/sdk/blob/main/CHANGELOG.md"
 Issues = "https://github.com/commandlayer/sdk/issues"
 
 [tool.setuptools.packages.find]
diff --git a/typescript-sdk/package.json b/typescript-sdk/package.json
index 26ef0ea..94f75fd 100644
--- a/typescript-sdk/package.json
+++ b/typescript-sdk/package.json
@@ -40,6 +40,7 @@
   },
   "devDependencies": {
     "tsup": "^8.2.4",
-    "typescript": "^5.6.3"
+    "typescript": "^5.6.3",
+    "@types/node": "^20.17.0"
   }
 }