@camstack/system 1.2.246 → 1.2.248

package/dist/index.js

@@ -4499,6 +4499,32 @@ var AddonInstaller = class AddonInstaller {
 	*     into `addonsDir/<pkg>/`. The Electron bundled-addons path
 	*     uses this so the runtime owns its on-disk copy.
 	*/
+	/**
+	* Re-install one addon from the running server closure.
+	*
+	* The closure carries a copy of every addon it declares as a dependency, and
+	* NOTHING loads an addon from there — `AddonLoader` reads the addon root and
+	* only the addon root, on every role. So those copies are transport, and
+	* this is the only thing that moves them into the place that runs code.
+	*
+	* Without it a server update advances the closure and changes nothing: six
+	* addons on the hub were behind by up to nineteen versions on 2026-09-17,
+	* each frozen at whenever somebody last ran `camstack deploy`.
+	*
+	* WHICH addons deserve this is not decided here — see `planAddonRealignment`,
+	* which needs two gates because a version comparison alone would overwrite a
+	* deliberate deploy. This only carries out a decision already made.
+	*/
+	async realignFromClosure(packageName, closureDir) {
+		const targetDir = node_path.join(this.addonsDir, packageName);
+		const result = await this.installLocal(packageName, closureDir);
+		await node_fs.promises.writeFile(node_path.join(targetDir, ".install-source"), "closure");
+		this.manifest.upsert(result.name, {
+			version: result.version,
+			source: "closure"
+		});
+		return result;
+	}
 	async installLocal(packageName, sourceDir) {
 		const pkgView = readPackageJson(node_path.join(sourceDir, "package.json"));
 		if (!pkgView) throw new Error(`Invalid package.json at ${sourceDir}`);

package/dist/index.mjs

@@ -4492,6 +4492,32 @@ var AddonInstaller = class AddonInstaller {
 	*     into `addonsDir/<pkg>/`. The Electron bundled-addons path
 	*     uses this so the runtime owns its on-disk copy.
 	*/
+	/**
+	* Re-install one addon from the running server closure.
+	*
+	* The closure carries a copy of every addon it declares as a dependency, and
+	* NOTHING loads an addon from there — `AddonLoader` reads the addon root and
+	* only the addon root, on every role. So those copies are transport, and
+	* this is the only thing that moves them into the place that runs code.
+	*
+	* Without it a server update advances the closure and changes nothing: six
+	* addons on the hub were behind by up to nineteen versions on 2026-09-17,
+	* each frozen at whenever somebody last ran `camstack deploy`.
+	*
+	* WHICH addons deserve this is not decided here — see `planAddonRealignment`,
+	* which needs two gates because a version comparison alone would overwrite a
+	* deliberate deploy. This only carries out a decision already made.
+	*/
+	async realignFromClosure(packageName, closureDir) {
+		const targetDir = path$39.join(this.addonsDir, packageName);
+		const result = await this.installLocal(packageName, closureDir);
+		await fs$17.promises.writeFile(path$39.join(targetDir, ".install-source"), "closure");
+		this.manifest.upsert(result.name, {
+			version: result.version,
+			source: "closure"
+		});
+		return result;
+	}
 	async installLocal(packageName, sourceDir) {
 		const pkgView = readPackageJson(path$39.join(sourceDir, "package.json"));
 		if (!pkgView) throw new Error(`Invalid package.json at ${sourceDir}`);

package/dist/kernel/addon-installer.d.ts

@@ -290,6 +290,26 @@ export declare class AddonInstaller {
      *     into `addonsDir/<pkg>/`. The Electron bundled-addons path
      *     uses this so the runtime owns its on-disk copy.
      */
+    /**
+     * Re-install one addon from the running server closure.
+     *
+     * The closure carries a copy of every addon it declares as a dependency, and
+     * NOTHING loads an addon from there — `AddonLoader` reads the addon root and
+     * only the addon root, on every role. So those copies are transport, and
+     * this is the only thing that moves them into the place that runs code.
+     *
+     * Without it a server update advances the closure and changes nothing: six
+     * addons on the hub were behind by up to nineteen versions on 2026-09-17,
+     * each frozen at whenever somebody last ran `camstack deploy`.
+     *
+     * WHICH addons deserve this is not decided here — see `planAddonRealignment`,
+     * which needs two gates because a version comparison alone would overwrite a
+     * deliberate deploy. This only carries out a decision already made.
+     */
+    realignFromClosure(packageName: string, closureDir: string): Promise<{
+        name: string;
+        version: string;
+    }>;
     private installLocal;
     /**
      * Symlink `addonsDir/<pkg>` at the workspace source dir. Dev-only.

package/dist/kernel/addon-manifest.d.ts

@@ -1,4 +1,14 @@
-export type AddonInstallSource = 'npm' | 'local' | 'upload' | 'bundled' | 'seed';
+/**
+ * `closure` — re-aligned from the running `@camstack/server` closure at boot.
+ *
+ * Distinct from `bundled`, which is the copy an Electron app shipped with and
+ * seeds ONCE. A `closure` install is a refresh of a copy that was already
+ * there, and naming it separately is what lets an operator tell "I deployed
+ * this" from "the server update brought it" — the distinction the six stale
+ * copies of 2026-09-17 had no way to express, all of them reading `upload`
+ * because each HAD been a deliberate deploy, once. See D518.
+ */
+export type AddonInstallSource = 'npm' | 'local' | 'upload' | 'bundled' | 'seed' | 'closure';
 export interface AddonManifestEntry {
     /** Full pkg name, e.g. `@camstack/addon-pipeline`. */
     name: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/system",
-  "version": "1.2.246",
+  "version": "1.2.248",
   "description": "Core addon for CamStack — builtins, pipeline, process management, auth, logging, events",
   "keywords": [
     "camstack",