@platformatic/watt-extra 1.13.0 → 1.14.0

package/.claude/settings.local.json

@@ -0,0 +1,24 @@
+{
+  "permissions": {
+    "allow": [
+      "Read(//work/workspaces/workspace-platformatic/platformatic/**)",
+      "Bash(npx borp:*)",
+      "Bash(timeout 30 npx borp -c 1 --timeout=20000 ./test/trigger-flamegraphs.test.js)",
+      "Bash(xargs cat:*)",
+      "Bash(pnpm install)",
+      "Bash(find:*)",
+      "Bash(cat:*)",
+      "WebFetch(domain:github.com)",
+      "Bash(node --test:*)",
+      "Bash(for i in 1 2 3)",
+      "Bash(do echo \"Run $i:\")",
+      "Bash(done)",
+      "Bash(git stash:*)",
+      "Bash(echo:*)",
+      "Bash(grep:*)",
+      "Bash(gh api:*)"
+    ],
+    "deny": [],
+    "ask": []
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@platformatic/watt-extra",
-  "version": "1.13.0",
+  "version": "1.14.0",
   "description": "The Platformatic runtime manager",
   "type": "module",
   "scripts": {

package/plugins/init.js

@@ -52,6 +52,15 @@ async function initPlugin (app) {
     app.instanceConfig = instanceConfig
     app.instanceId = instanceId
 
+    // workerMissingVersion is true only when the runtime
+    // already spawned without this value (ICC was unreachable at boot).
+    const newDeploymentVersion = instanceConfig?.deploymentVersion
+    const workerMissingVersion = !!newDeploymentVersion &&
+      process.env.PLT_DEPLOYMENT_VERSION !== newDeploymentVersion
+    if (newDeploymentVersion) {
+      process.env.PLT_DEPLOYMENT_VERSION = newDeploymentVersion
+    }
+
     // If runtime already started (ICC recovery after startup), update its instance config
     if (app.watt?.runtime) {
       await app.watt.updateInstanceConfig(instanceConfig)
@@ -60,6 +69,14 @@ async function initPlugin (app) {
       await app.setupAlerts?.()
       await app.setupHealthSignals?.()
       await app.setupFlamegraphs?.()
+
+      // The app already spawned (ICC was unreachable at boot), so its worker's env is
+      // frozen without the version. Push it via the shared context: the runtime
+      // delivers it live to the running worker (no restart).
+      if (workerMissingVersion) {
+        app.log.info({ deploymentVersion: newDeploymentVersion }, 'Publishing deployment version to the shared context after startup')
+        await app.watt.updateSharedContext({ deploymentVersion: newDeploymentVersion })
+      }
     }
   }
   try {

package/test/init.test.js

@@ -374,6 +374,58 @@ test('init plugin calls updateInstanceConfig on watt when ICC becomes available
   equal(setupFlamegraphsCalled, true)
 })
 
+test('init plugin sets PLT_DEPLOYMENT_VERSION and pushes it to the shared context on ICC recovery', async (t) => {
+  const applicationName = 'test-app-version-recovery'
+  const applicationId = randomUUID()
+
+  const icc = await startICC(t, {
+    applicationId,
+    controlPlaneResponse: {
+      applicationId,
+      applicationName,
+      deploymentVersion: 'v9',
+      config: {}
+    }
+  })
+  t.after(async () => { await icc.close() })
+
+  const originalVersion = process.env.PLT_DEPLOYMENT_VERSION
+  delete process.env.PLT_DEPLOYMENT_VERSION
+  t.after(() => {
+    if (originalVersion) process.env.PLT_DEPLOYMENT_VERSION = originalVersion
+    else delete process.env.PLT_DEPLOYMENT_VERSION
+  })
+
+  // Boot with ICC unavailable -> the app starts without a version.
+  const app = createMockApp({
+    PLT_APP_NAME: applicationName,
+    PLT_APP_DIR: '/test/dir',
+    PLT_ICC_URL: 'http://127.0.0.1:9999',
+    PLT_CONTROL_PLANE_URL: 'http://127.0.0.1:9999/control-plane'
+  })
+  await initPlugin(app)
+  equal(app.instanceConfig, null)
+  equal(process.env.PLT_DEPLOYMENT_VERSION, undefined)
+
+  // Runtime already spawned (env frozen without the version); capture pushes.
+  let pushedContext = null
+  app.watt.runtime = {}
+  app.watt.updateInstanceConfig = async () => {}
+  app.watt.updateSharedContext = async (ctx) => { pushedContext = ctx }
+  app.setupAlerts = async () => {}
+  app.setupHealthSignals = async () => {}
+  app.setupFlamegraphs = async () => {}
+
+  // ICC becomes available.
+  app.env.PLT_ICC_URL = `http://127.0.0.1:${icc.server.address().port}`
+  app.env.PLT_CONTROL_PLANE_URL = `http://127.0.0.1:${icc.server.address().port}/control-plane`
+  await app.initApplication()
+
+  // Applied to the env (for future spawns) and pushed live to the running worker.
+  equal(process.env.PLT_DEPLOYMENT_VERSION, 'v9')
+  equal(pushedContext?.deploymentVersion, 'v9')
+})
+
 test('updateInstanceConfig calls runtime.updateMetricsConfig with merged config', async (t) => {
   const applicationName = 'test-app-metrics'
   const applicationId = randomUUID()