From 9347bcf5ab39a2654edb7a821d82a6541e1f6914 Mon Sep 17 00:00:00 2001
From: Greg Soucy <GREG@COMMANDLAYER.ORG>
Date: Thu, 19 Mar 2026 02:54:54 -0400
Subject: [PATCH] Polish SDK packaging metadata

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

diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..f72ba85
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,22 @@
+# 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
+- Packaging metadata now exposes repository changelog and project URLs
+- TypeScript package declares Node type definitions explicitly for clean installs
+
+### 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..f981e8b 100644
--- a/python-sdk/pyproject.toml
+++ b/python-sdk/pyproject.toml
@@ -40,11 +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"
-Issues = "https://github.com/commandlayer/sdk/issues"
-
+Documentation = "https://github.com/commandlayer/sdk#readme"
+Changelog = "https://github.com/commandlayer/sdk/blob/main/CHANGELOG.md"
 [tool.setuptools.packages.find]
 where = ["."]
 include = ["commandlayer*"]
diff --git a/typescript-sdk/package.json b/typescript-sdk/package.json
index 26ef0ea..ab90fd4 100644
--- a/typescript-sdk/package.json
+++ b/typescript-sdk/package.json
@@ -39,6 +39,7 @@
     "tweetnacl": "^1.0.3"
   },
   "devDependencies": {
+    "@types/node": "^20.17.30",
     "tsup": "^8.2.4",
     "typescript": "^5.6.3"
   }