diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json
index 7814b44..a5c607e 100644
--- a/.claude-plugin/marketplace.json
+++ b/.claude-plugin/marketplace.json
@@ -5,7 +5,7 @@
   },
   "metadata": {
     "description": "Marketplace for Harness Plugin Prototype",
-    "version": "0.3.0"
+    "version": "0.4.0"
   },
   "plugins": [
     {
diff --git a/.github/.release-please-manifest.json b/.github/.release-please-manifest.json
index 1c861e1..8efb275 100644
--- a/.github/.release-please-manifest.json
+++ b/.github/.release-please-manifest.json
@@ -1 +1 @@
-{".":"0.3.0"}
+{".":"0.4.0"}
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 3770898..af97ff6 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,40 @@
 # Changelog
 
+## [0.4.0](https://github.com/myagentdojo/agent-plugin-template/compare/v0.3.0...v0.4.0) (2026-08-17)
+
+
+### Features
+
+* add safe immutable Codex updates ([7ee948c](https://github.com/myagentdojo/agent-plugin-template/commit/7ee948ce184a6c821b79bb90799de08494f81b3d))
+* add safe immutable Codex updates ([4b4c838](https://github.com/myagentdojo/agent-plugin-template/commit/4b4c838b9275f6ffdfc6399a88c7b174eaac4f3c))
+* **dev:** add persistent Claude development installation ([#50](https://github.com/myagentdojo/agent-plugin-template/issues/50)) ([e9e83d1](https://github.com/myagentdojo/agent-plugin-template/commit/e9e83d1abcde24809e8a16655320930e87dfec72))
+* **release:** add pre-tag recovery for stranded proven candidates ([#43](https://github.com/myagentdojo/agent-plugin-template/issues/43)) ([0ecba71](https://github.com/myagentdojo/agent-plugin-template/commit/0ecba71e14f15917be4d61e31f0511b1c8dfbf1e))
+
+
+### Bug Fixes
+
+* address PR review feedback ([bec80ec](https://github.com/myagentdojo/agent-plugin-template/commit/bec80ecfcbd6f684698849fed4ae807b96d89411))
+* allow trusted first-consumer canary bootstrap ([#36](https://github.com/myagentdojo/agent-plugin-template/issues/36)) ([96a4a2f](https://github.com/myagentdojo/agent-plugin-template/commit/96a4a2f5eb75483d3de4ff238fe4ed25fc67b046))
+* **readiness:** bind canary readiness to the registered public half ([#44](https://github.com/myagentdojo/agent-plugin-template/issues/44)) ([e39384a](https://github.com/myagentdojo/agent-plugin-template/commit/e39384a3110b198a8823cadbaad2d904696bd2b7))
+
+
+### Refactoring
+
+* **canary:** inject a typed subprocess seam ([#48](https://github.com/myagentdojo/agent-plugin-template/issues/48)) ([e4e62c8](https://github.com/myagentdojo/agent-plugin-template/commit/e4e62c805caeef14cd9746daf7ec6cc7ee13473e))
+* **release:** structural workflow validation with a parity ledger ([#45](https://github.com/myagentdojo/agent-plugin-template/issues/45)) ([521644e](https://github.com/myagentdojo/agent-plugin-template/commit/521644e918ec5cfaad12e30bdcfcceb10da41cae))
+* **runtime:** reuse shared proof control envelope ([#49](https://github.com/myagentdojo/agent-plugin-template/issues/49)) ([66af4a9](https://github.com/myagentdojo/agent-plugin-template/commit/66af4a9bf701b0200c80528f8135a4ec5fb8bab5))
+* **scripts:** single harness-identity owner for harness vocabulary ([#46](https://github.com/myagentdojo/agent-plugin-template/issues/46)) ([2f55212](https://github.com/myagentdojo/agent-plugin-template/commit/2f55212e742c1755ae23bb7b9835b732a55d0f64))
+
+
+### Documentation
+
+* add repository agent guidance ([#40](https://github.com/myagentdojo/agent-plugin-template/issues/40)) ([a14667f](https://github.com/myagentdojo/agent-plugin-template/commit/a14667fcd9dec45dcd8f100a8fbacfccdb86b443))
+* align update preview contract ([#38](https://github.com/myagentdojo/agent-plugin-template/issues/38)) ([2f8845d](https://github.com/myagentdojo/agent-plugin-template/commit/2f8845dff2d3bf565c24a1a5a6a82015a3e288da))
+* clarify release preflight custody ([#38](https://github.com/myagentdojo/agent-plugin-template/issues/38)) ([00c1f7e](https://github.com/myagentdojo/agent-plugin-template/commit/00c1f7e25d2f4837165b404cb236f49ff7b8ad96))
+* fix three documentation drifts and declare what verifies each doc ([#42](https://github.com/myagentdojo/agent-plugin-template/issues/42)) ([f06ad99](https://github.com/myagentdojo/agent-plugin-template/commit/f06ad9908ff111cb11e1858b11e3da2bf906f8d5))
+* make plugin template README creator-first ([#39](https://github.com/myagentdojo/agent-plugin-template/issues/39)) ([55f67ef](https://github.com/myagentdojo/agent-plugin-template/commit/55f67ef3932a22af920b6325f7483900b8ab068c))
+* scaffold agent skills configuration ([#41](https://github.com/myagentdojo/agent-plugin-template/issues/41)) ([19647c6](https://github.com/myagentdojo/agent-plugin-template/commit/19647c60457ccabb27bf5e6004bf4ca4748e2864))
+
 ## [0.3.0](https://github.com/myagentdojo/agent-plugin-template/compare/v0.2.0...v0.3.0) (2026-08-10)
 
 
diff --git a/package.json b/package.json
index 602cd83..847d23d 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "agent-plugin-template-tooling",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "private": true,
   "type": "module",
   "packageManager": "bun@1.3.14",
diff --git a/plugin.config.json b/plugin.config.json
index 04e8318..44ae4b1 100644
--- a/plugin.config.json
+++ b/plugin.config.json
@@ -2,7 +2,7 @@
   "template": true,
   "name": "harness-native-plugin-prototype",
   "displayName": "Harness Plugin Prototype",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Portable Bun skills and a guided native capability tour for Claude Code and Codex",
   "author": {
     "name": "Prototype"
diff --git a/plugin/.claude-plugin/plugin.json b/plugin/.claude-plugin/plugin.json
index f4919fb..c55ba0a 100644
--- a/plugin/.claude-plugin/plugin.json
+++ b/plugin/.claude-plugin/plugin.json
@@ -1,7 +1,7 @@
 {
   "name": "harness-native-plugin-prototype",
   "displayName": "Harness Plugin Prototype",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "defaultEnabled": false,
   "description": "Portable Bun skills and a guided native capability tour for Claude Code and Codex",
   "author": {
diff --git a/plugin/.codex-plugin/plugin.json b/plugin/.codex-plugin/plugin.json
index 6ed293a..059dd03 100644
--- a/plugin/.codex-plugin/plugin.json
+++ b/plugin/.codex-plugin/plugin.json
@@ -1,6 +1,6 @@
 {
   "name": "harness-native-plugin-prototype",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Portable Bun skills and a guided native capability tour for Claude Code and Codex",
   "author": {
     "name": "Prototype"