@vertesia/appgen-docs 1.5.0-dev.20260806.125520Z → 1.5.0-dev.20260807.073259Z

package/lib/docs/tool-server-resource.md

@@ -418,6 +418,11 @@ Registered hooks are exposed as authenticated POST endpoints at `/api/hooks/inst
 app package advertises their endpoint paths under `hooks` for inspection. Studio invokes the conventional endpoints
 directly and treats a 404 as an absent optional hook.
 
+Building an immutable version advertises these definitions but does not execute them. Studio runs the promoted
+version's install hook during promotion reconciliation and runs the previous promoted version's uninstall hook when
+it is replaced or removed. For an unpromoted candidate, validate source registration and package output only; do not
+invoke lifecycle endpoints manually or fail candidate QA because their side effects are absent.
+
 In an appgen capability manifest, declare lifecycle hooks with type `hook` and ids such as
 `app:<app-name>:install` and `app:<app-name>:uninstall`.
 
@@ -476,7 +481,8 @@ Represent it in an appgen capability manifest as a `hook` artifact such as
 ## Application event subscriptions
 
 Subscriptions are declarative package contributions that route matching platform events to an event hook in the same
-app. They do not contain a deployment URL or project scope. Studio derives both when it installs the app.
+app. They do not contain a deployment URL or project scope. Studio derives both from the version selected during
+promotion.
 
 ```typescript
 // src/modules/app/resources/subscriptions/index.ts
@@ -505,6 +511,11 @@ the same event hook with different filters. Inspect the result with `GET /api/pa
 Represent each definition in an appgen capability manifest as a `subscription` artifact such as
 `app:<app-name>:content-updated`.
 
+An unpromoted candidate exposes these package definitions but does not create protected Event Bus subscriptions, and
+matching events are not delivered to that candidate's hook. Candidate validation is therefore limited to source and
+package-summary wiring. Use Event Bus subscription and delivery evidence only after the version has been explicitly
+promoted.
+
 ---
 
 ## Collection registration & icons

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vertesia/appgen-docs",
-  "version": "1.5.0-dev.20260806.125520Z",
+  "version": "1.5.0-dev.20260807.073259Z",
   "description": "Generated SDK references and development guidance for Vertesia app agents",
   "type": "module",
   "main": "./lib/index.js",
@@ -18,10 +18,10 @@
   "devDependencies": {
     "@types/node": "^24.13.3",
     "typescript": "7.0.2",
-    "@vertesia/client": "1.5.0-dev.20260806.125520Z",
-    "@vertesia/common": "1.5.0-dev.20260806.125520Z",
+    "@vertesia/client": "1.5.0-dev.20260807.073259Z",
+    "@vertesia/common": "1.5.0-dev.20260807.073259Z",
     "@vertesia/tsconfig": "0.1.0",
-    "@vertesia/ui": "1.5.0-dev.20260806.125520Z"
+    "@vertesia/ui": "1.5.0-dev.20260807.073259Z"
   },
   "repository": {
     "type": "git",
@@ -34,7 +34,7 @@
     "documentation",
     "app-development"
   ],
-  "gitHead": "416423ef4182d8668809604902a871ca79629298",
+  "gitHead": "e6ebc1482ad6c4df965d74c79f82eb25fc6e2ce3",
   "scripts": {
     "build": "pnpm run clean && tsc -p tsconfig.json && node ./scripts/generate-docs.mjs",
     "clean": "rimraf ./lib ./docs ./tsconfig.tsbuildinfo",