diff --git a/.release-please-manifest.json b/.release-please-manifest.json
index da5aa0d..2537c1f 100644
--- a/.release-please-manifest.json
+++ b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "0.3.16"
+  ".": "0.4.0"
 }
diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..d898911
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,76 @@
+# Changelog
+
+## [0.4.0](https://github.com/wippyai/framework/compare/v0.3.16...v0.4.0) (2026-07-09)
+
+
+### Features
+
+* add initial implementation of LICENSE, README, CODEOWNERS, and .gitattributes files into LLM and Usage modules ([bc45cd4](https://github.com/wippyai/framework/commit/bc45cd47a3ffbfb931dc34e9ef90e82b946a136a))
+* add initial implementation of LLM and Usage modules with subsplit ([f5f57e3](https://github.com/wippyai/framework/commit/f5f57e364fcce4b42259ad010caecf3368100e72))
+* add initial implementation of other modules with subsplit ([d63373f](https://github.com/wippyai/framework/commit/d63373f2d395506bddb9d79306beea278a571da7))
+* **agent:** add trait behavior declarations ([#69](https://github.com/wippyai/framework/issues/69)) ([e925105](https://github.com/wippyai/framework/commit/e925105bb728c8087c7620d9c7134aef34eb2e16))
+* **agent:** declarative active trait/tool overlays on agent_context ([0c70bea](https://github.com/wippyai/framework/commit/0c70bea9ea4c88e488759e8befef4682349ddeca))
+* **agent:** enhance tool schema extraction and add raw metadata retrieval ([e51ef74](https://github.com/wippyai/framework/commit/e51ef74f4b82a5b84d2dddcd465a3d39db3c4e49))
+* **agent:** update Agent module ([25dc230](https://github.com/wippyai/framework/commit/25dc230194e45bd8d3100dc88c1a7e738e72b5fc))
+* **bedrock:** bulletproof tool calling and structured output across all models ([8632cad](https://github.com/wippyai/framework/commit/8632cadd5cb92e746ea53f506f0865038edeb448))
+* **bootloader:** generate ENCRYPTION_KEY on start ([#9](https://github.com/wippyai/framework/issues/9)) ([552c586](https://github.com/wippyai/framework/commit/552c58696ff699c5922485a55239877196cdbc5b))
+* **bootloader:** Support multiple DBs ([#18](https://github.com/wippyai/framework/issues/18)) ([e7d6d1b](https://github.com/wippyai/framework/commit/e7d6d1bf341d4541f399291c539ff44102fce4a6))
+* **ci:** adopt release-please for automated releases ([#74](https://github.com/wippyai/framework/issues/74)) ([af963ad](https://github.com/wippyai/framework/commit/af963ada98fdfad86ec8b73c15fbe9e2e831ccf5))
+* **facade:** add host_config_layout ns.requirement for managed-layout ([b926ab8](https://github.com/wippyai/framework/commit/b926ab85a705e1e73d01758cb2af62046e55511e))
+* **facade:** content_fs theming with fs:// scheme + CSS-vars endpoint ([b77092d](https://github.com/wippyai/framework/commit/b77092d04b380a1feb6cc485272f9662ed1eae72))
+* **facade:** tanstack passthrough + theme persistence; Web Host CDN 1.0.41 (EE2-2265, EE2-2274) ([92019de](https://github.com/wippyai/framework/commit/92019ded21ac281ada331f4b0a5badbeefd71c7a))
+* **facade:** tanstack requirement → themeMode-style passthrough to AppConfig.tanstack ([821486a](https://github.com/wippyai/framework/commit/821486af023a181d8225f0d46b5b54d00a87e6f9))
+* **facade:** theme persistence (cookie / localStorage) + Jet SSR shell ([ae6f9e6](https://github.com/wippyai/framework/commit/ae6f9e6515449ee59c75b5eabd011ccb712ee459))
+* **facade:** theme_mode forcing + bump Web Host CDN 1.0.37 -> 1.0.39 (EE2-2265) ([0c1691c](https://github.com/wippyai/framework/commit/0c1691c7084f2e4d6881d792c295a9468a9efa7c))
+* **facade:** theme_mode forcing + Web Host CDN 1.0.39 (EE2-2265) ([6421013](https://github.com/wippyai/framework/commit/6421013222775c056b5cbe75739aa4f52e0ac325))
+* **llm:** add AWS Bedrock provider for Claude models ([2899419](https://github.com/wippyai/framework/commit/2899419e223fb62d592a3a5dc1f6e6638088d6e1))
+* **llm:** add EC2 IMDS credential support and register container env vars ([084b947](https://github.com/wippyai/framework/commit/084b947f8df419c184d4df71395eb85446b39d85))
+* **llm:** Add Google LLM providers ([#21](https://github.com/wippyai/framework/issues/21)) ([64143c3](https://github.com/wippyai/framework/commit/64143c34bf54e1098bd51d56c7ab988f8474445c))
+* **llm:** Add the ability to use global region in vertex ([73bbc7f](https://github.com/wippyai/framework/commit/73bbc7f25a506d6f39aaba9f338bce912fe80d84))
+* **llm:** extract bedrock into standalone provider with Converse API and embeddings ([c07637a](https://github.com/wippyai/framework/commit/c07637ae6d2809792441862feaf822738d246e6a))
+* **llm:** implement AWS eventstream binary parser for Bedrock streaming ([ec147bf](https://github.com/wippyai/framework/commit/ec147bf64b07bfceec94628655b752fecbfc25ab))
+* **llm:** optional model_resolver contract for model/provider resolution ([3cf905b](https://github.com/wippyai/framework/commit/3cf905b81cbdf9ae061fb22b34ad2246d5abf739))
+* **llm:** Support Claude thinking ([3f485e8](https://github.com/wippyai/framework/commit/3f485e8d2293f1cb421f921b9b22e586a2e14a7a))
+* **llm:** Update LLM module ([c15ceb3](https://github.com/wippyai/framework/commit/c15ceb3efd8d7afd2cb6f40e0682aac5c2420a9e))
+* **relay:** declare ENVs in requirements ([5bdc358](https://github.com/wippyai/framework/commit/5bdc358659e3ca95e399502a16d48a04c758c82e))
+* **relay:** update Relay component ([3602ef0](https://github.com/wippyai/framework/commit/3602ef08e0a842bf2a8bfe1e06bcb701bb154a93))
+* **relay:** use `src` dir as source root ([e101330](https://github.com/wippyai/framework/commit/e101330bf25fd40de439e79163e0a71d6c2358b3))
+* sync changes; ([c3e7f20](https://github.com/wippyai/framework/commit/c3e7f20cbeb7043e72284368b792fb721009f7ce))
+* **test:** enhance support for immutable tables and improve error handling ([4b26c02](https://github.com/wippyai/framework/commit/4b26c02348af6b751358f79689c580269d492f27))
+* update README with module descriptions and badge style improvements ([0b24d38](https://github.com/wippyai/framework/commit/0b24d382deca79ef2c3b1b5fa6d6a55504b101b6))
+* **usage:** add environment variable support for database resource ([966539c](https://github.com/wippyai/framework/commit/966539c385fbc30baac8debc5e6e76be03969b9f))
+* **usage:** add get_usage_by_user to token_usage_repo ([38f8aa1](https://github.com/wippyai/framework/commit/38f8aa169d54d4686a7dcad26b8da19822fb2ea7))
+* **usage:** rename `target_db` entry to `env-target_db`; ([e13173c](https://github.com/wippyai/framework/commit/e13173c789fe37a19b00410938fadf3658df3310))
+* **usage:** update Usage module ([61f341c](https://github.com/wippyai/framework/commit/61f341c4847410abfb57361f992c4bca97d775b7))
+* **views:** add API router requirement for endpoint configuration ([a455aef](https://github.com/wippyai/framework/commit/a455aefe630f7ffaa6e7c2fb52f7dfbcf5be3e3b))
+* **views:** Add registry-based environment variable mappings for view templates ([#22](https://github.com/wippyai/framework/issues/22)) ([ea42ee9](https://github.com/wippyai/framework/commit/ea42ee9ac56d37c374f57f68ed251e074ce8f926))
+* **views:** camelCase component & page API projection ([bf04c68](https://github.com/wippyai/framework/commit/bf04c68fa7eb01bc3df79db49a76401802386f43))
+* **wc-content-kit:** new module shipping mermaid / markdown / chartjs web components ([6091461](https://github.com/wippyai/framework/commit/6091461b828ceb36dfbe37e0dfcf37abc28350db))
+
+
+### Bug Fixes
+
+* **actor:** Remove extra entry ([a9adaac](https://github.com/wippyai/framework/commit/a9adaac9306261bfc4a05b829e60b8dd3401dc44))
+* **agent:** Fix dependencies ([2c3161f](https://github.com/wippyai/framework/commit/2c3161f8d722c7e8d0273c3f0a8b7a2b435c498e))
+* **bedrock:** detect embedding models with cross-region inference prefixes ([cf87c95](https://github.com/wippyai/framework/commit/cf87c95715b68edae7df385096c7ad9f9b8c9f82))
+* **bedrock:** resolve all lint errors with proper type annotations ([e454908](https://github.com/wippyai/framework/commit/e454908d42ef8545919f9c6a1f03efa0a54f8a2b))
+* **bootloader:** classify dependencies by registry meta.type, not namespace heuristic ([84295a4](https://github.com/wippyai/framework/commit/84295a4b29d02a7a15ba7efb64c1a3ac7baf9026))
+* Configuration changes and Code quality improvements ([#30](https://github.com/wippyai/framework/issues/30)) ([d8dd0d2](https://github.com/wippyai/framework/commit/d8dd0d2f10137edc7c57d45e6cfbe201fd0906c8))
+* **discovery:** resolve lint errors in providers_test with :: any casts ([ea7159b](https://github.com/wippyai/framework/commit/ea7159bc59cf449dc7a765b2412e56854a8a28d8))
+* Fixed invalid OpenRouter mapping for OpenAI sync requests ([#19](https://github.com/wippyai/framework/issues/19)) ([197e621](https://github.com/wippyai/framework/commit/197e62190a91bea5e77c6a17cfd6894fff7df18a))
+* invalid openrouter mapping for openai sync requests ([#15](https://github.com/wippyai/framework/issues/15)) ([0b56cf6](https://github.com/wippyai/framework/commit/0b56cf65ab3622747f7aaca6e5a4fdc84fec8e9c))
+* **llm:** Fix google mapper ([#24](https://github.com/wippyai/framework/issues/24)) ([1d43194](https://github.com/wippyai/framework/commit/1d43194b6e0f625e11f30498efc0d49c7213aea9))
+* **llm:** handle nil actor case when retrieving metadata ([ce395fb](https://github.com/wippyai/framework/commit/ce395fb8fc6fb1ba54df1191a27d8279ef123acd))
+* **llm:** track resolved model name in usage instead of class alias ([c96aa90](https://github.com/wippyai/framework/commit/c96aa90866e28468f5da561dc5d9a7a3b4c52da4))
+* meta deprecation warning removal ([#29](https://github.com/wippyai/framework/issues/29)) ([91e9668](https://github.com/wippyai/framework/commit/91e966868ada880ce2d1b124449f2e690ecb51af))
+* path to the Usage module sources ([7e27d0e](https://github.com/wippyai/framework/commit/7e27d0e6acfdab1319db9cb295c334ddb6289224))
+* **relay:** propagate authenticated scope ([#70](https://github.com/wippyai/framework/issues/70)) ([5d6cafd](https://github.com/wippyai/framework/commit/5d6cafde870aebfb3abb174c5b6b74fe23917cb7))
+* **relay:** return plugins as array in welcome message ([176b17d](https://github.com/wippyai/framework/commit/176b17d4eabbae3325b8ad9044845eb0276a125a))
+* remove unnecessary DB mapping in requirements ([#25](https://github.com/wippyai/framework/issues/25)) ([80ac41e](https://github.com/wippyai/framework/commit/80ac41e48764cdbebad860d4644ccce90004de6a))
+* repair subsplit ([1d80df8](https://github.com/wippyai/framework/commit/1d80df8a3a538b9e67e14d3bd9101c0fed62ce64))
+* resolve pre-existing lint errors across llm, embeddings, views ([c102179](https://github.com/wippyai/framework/commit/c102179ba7491b634983c7d60d120eb720bdc628))
+* sessions flows ([#12](https://github.com/wippyai/framework/issues/12)) ([fa44d5d](https://github.com/wippyai/framework/commit/fa44d5d2e843b264b360a9672dbb11667bb2482d))
+* **usage:** add OS storage for environment variables and update target_db storage reference ([ad859d0](https://github.com/wippyai/framework/commit/ad859d0dea7a4f1a38a64a7e4ff3ae5808766ee2))
+* **usage:** resolve context_id from ctx when not provided in options ([2899419](https://github.com/wippyai/framework/commit/2899419e223fb62d592a3a5dc1f6e6638088d6e1))
+* **views/tests:** update entry_point default tests for projection-layer defaults ([8713596](https://github.com/wippyai/framework/commit/87135969cf06d5efb0a99608a7c25cfef554ea10))
+* **views:** make bundled_meta_test actually run + register it; fix latent fixture bug ([fdee596](https://github.com/wippyai/framework/commit/fdee5963b755294bb1d6fbdd2e391a69fc4c205a))