@uns-kit/cli 3.0.30 → 3.0.32

package/dist/index.js

@@ -524,6 +524,8 @@ const AGENT_MIGRATION_END = "<!-- uns-kit:migrations:end -->";
 const AGENT_MIGRATION_BLOCK = [
     AGENT_MIGRATION_START,
     "## UNS Kit dependency upgrades",
+    "- When crossing `<3.0.32` to `>=3.0.32`, existing services remain unchanged. Enabling a Runtime MQTT outbox on an authorized process group requires the separate reviewed protocol3 transition and shared capability declaration. Preserve input/output journals, stop admission and drain accepted input before stopping the publisher on rollback, and block restoration on pending output or unknown outcomes. Never add application-specific Controller rules.",
+    "- When crossing `<3.0.31` to `>=3.0.31`, ordinary services remain unchanged. Optional Runtime-managed MQTT outboxes require explicit `output.publishQueue.storage: runtime`, a trusted private per-Controller external mount and matching backup support. Preserve schema1 queues; restoring managed state requires a stopped source and an empty offline target. Read the version-bounded migration before enabling it.",
     "- When crossing `<3.0.30` to `>=3.0.30`, MQTT output persistence remains opt-in. Preserve existing queues; distinguish local admission from broker delivery, and do not combine a durable outbox with legacy RAM/hash handover. Read MIGRATIONS.md for the actual version boundary.",
     "- When crossing `<3.0.29` to `>=3.0.29`, configuration-owned process groups opt into shared protocol2/policy4. Keep business resources in the app, bind immutable snapshots and journal generations, use reviewed generation/version transitions, and preserve old journals/policies. Ordinary services and existing file groups need no migration.",
     "- When crossing `<3.0.27` to `>=3.0.27`, reviewed process-group runtimes and host launchers must use the shared runtime contract and data-only package descriptor; keep application names, mappings and group lists out of the Controller. Legacy policies remain frozen compatibility readers.",

package/dist/service-bundle.js

@@ -77,6 +77,8 @@ export function generateAgentsMarkdown(bundle) {
         "",
         "<!-- uns-kit:migrations:start -->",
         "## UNS Kit dependency upgrades",
+        "- When crossing `<3.0.32` to `>=3.0.32`, existing services remain unchanged. Enabling a Runtime MQTT outbox on an authorized process group requires the separate reviewed protocol3 transition and shared capability declaration. Preserve input/output journals, stop admission and drain accepted input before stopping the publisher on rollback, and block restoration on pending output or unknown outcomes. Never add application-specific Controller rules.",
+        "- When crossing `<3.0.31` to `>=3.0.31`, ordinary services remain unchanged. Optional Runtime-managed MQTT outboxes require explicit `output.publishQueue.storage: runtime`, a trusted private per-Controller external mount and matching backup support. Preserve schema1 queues; restoring managed state requires a stopped source and an empty offline target. Read the version-bounded migration before enabling it.",
         "- When crossing `<3.0.30` to `>=3.0.30`, MQTT output persistence remains opt-in. Preserve existing queues; distinguish local admission from broker delivery, and do not combine a durable outbox with legacy RAM/hash handover. Read MIGRATIONS.md for the actual version boundary.",
         "- When crossing `<3.0.29` to `>=3.0.29`, configuration-owned process groups opt into shared protocol2/policy4. Keep business resources in the app, bind immutable snapshots and journal generations, use reviewed generation/version transitions, and preserve old journals/policies. Ordinary services and existing file groups need no migration.",
         "- When crossing `<3.0.27` to `>=3.0.27`, reviewed process-group runtimes and host launchers must use the shared runtime contract and data-only package descriptor; keep application names, mappings and group lists out of the Controller. Legacy policies remain frozen compatibility readers.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uns-kit/cli",
-  "version": "3.0.30",
+  "version": "3.0.32",
   "description": "Command line scaffolding tool for UNS applications",
   "type": "module",
   "license": "MIT",
@@ -26,14 +26,14 @@
   ],
   "dependencies": {
     "azure-devops-node-api": "^15.1.2",
-    "@uns-kit/core": "3.0.30"
+    "@uns-kit/core": "3.0.32"
   },
   "unsKitPackages": {
-    "@uns-kit/core": "3.0.30",
-    "@uns-kit/api": "3.0.30",
-    "@uns-kit/cron": "3.0.30",
-    "@uns-kit/database": "3.0.30",
-    "@uns-kit/assistant-workflow": "3.0.30"
+    "@uns-kit/core": "3.0.32",
+    "@uns-kit/api": "3.0.32",
+    "@uns-kit/cron": "3.0.32",
+    "@uns-kit/database": "3.0.32",
+    "@uns-kit/assistant-workflow": "3.0.32"
   },
   "scripts": {
     "build": "tsc -p tsconfig.build.json",

package/templates/cron/AGENTS.md

@@ -24,6 +24,10 @@ Pointers for AI/code-assist tools when working in this generated project.
 
 ## UNS Kit dependency upgrades
 
+- When crossing `<3.0.32` to `>=3.0.32`, existing services remain unchanged. Enabling a Runtime MQTT outbox on an authorized process group requires the separate reviewed protocol3 transition and shared capability declaration. Preserve input/output journals, stop admission and drain accepted input before stopping the publisher on rollback, and block restoration on pending output or unknown outcomes. Never add application-specific Controller rules.
+
+- When crossing `<3.0.31` to `>=3.0.31`, ordinary services remain unchanged. Optional Runtime-managed MQTT outboxes require explicit `output.publishQueue.storage: runtime`, a trusted private per-Controller external mount and matching backup support. Preserve schema1 queues; restoring managed state requires a stopped source and an empty offline target. Read the version-bounded migration before enabling it.
+
 - When crossing `<3.0.29` to `>=3.0.29`, configuration-owned process groups opt into shared protocol2/policy4. Keep business resources in the app, bind immutable snapshots and journal generations, use reviewed generation/version transitions, and preserve old journals/policies. Ordinary services and existing file groups need no migration.
 
 - Before changing any `@uns-kit/*` version, record the installed source version and intended target version.

package/templates/default/AGENTS.md

@@ -24,6 +24,10 @@ Pointers for AI/code-assist tools when working in this generated project.
 
 ## UNS Kit dependency upgrades
 
+- When crossing `<3.0.32` to `>=3.0.32`, existing services remain unchanged. Enabling a Runtime MQTT outbox on an authorized process group requires the separate reviewed protocol3 transition and shared capability declaration. Preserve input/output journals, stop admission and drain accepted input before stopping the publisher on rollback, and block restoration on pending output or unknown outcomes. Never add application-specific Controller rules.
+
+- When crossing `<3.0.31` to `>=3.0.31`, ordinary services remain unchanged. Optional Runtime-managed MQTT outboxes require explicit `output.publishQueue.storage: runtime`, a trusted private per-Controller external mount and matching backup support. Preserve schema1 queues; restoring managed state requires a stopped source and an empty offline target. Read the version-bounded migration before enabling it.
+
 - When crossing `<3.0.29` to `>=3.0.29`, configuration-owned process groups opt into shared protocol2/policy4. Keep business resources in the app, bind immutable snapshots and journal generations, use reviewed generation/version transitions, and preserve old journals/policies. Ordinary services and existing file groups need no migration.
 
 - Before changing any `@uns-kit/*` version, record the installed source version and intended target version.