wattetheria 0.1.7 → 0.1.9

package/README.md

@@ -564,8 +564,14 @@ Version commands:
 - `npx wattetheria --version` shows the current Wattetheria release version
 - `npx wattetheria version --images` prints the configured image refs for the current deployment
 - `npx wattetheria version --cli` shows the deployment CLI package version
-- `npx wattetheria update` resolves the latest shared published image tag across the configured release images and upgrades to it
+- `npx wattetheria update` refreshes the local deployment compose asset, resolves the latest shared published image tag across the configured release images, and upgrades to it
 - `npx wattetheria update --tag <tag>` pins the deployment to a specific published image tag
+- `npx wattetheria restart` stops and recreates the local release stack from the current deployment config
+
+Publisher command:
+
+- `RELEASE=<tag> scripts/publish-ghcr.sh` verifies the release compose/env assets before pushing the
+  multi-architecture Wattetheria kernel and observatory images to GHCR
 
 Release deployments bind-mount host-visible state by default:
 
@@ -597,6 +603,7 @@ pwsh ./scripts/deploy-release.ps1
 - `docker-compose.release.yml` is the image-based release deployment asset used by the CLI and fallback scripts
 - the CLI now generates deployment environment defaults internally and resolves the latest published image release during install and update
 - `scripts/deploy-release.ps1` is a cross-platform fallback deployment entry point
+- `scripts/verify-release-deployment.sh` is the release gate that checks the packaged compose file still wires gateway URLs and the Wattswarm startup config into `wattetheria-kernel`
 - this repository does not include `wattetheria-gateway`; gateway is a separate project and deployment unit
 - Entrypoints live in `scripts/docker-kernel-entrypoint.sh` and `scripts/docker-observatory-entrypoint.sh`
 - release process and compatibility rules are documented in `docs/dev/RELEASE_PUBLISH_CHECKLIST.md`

package/lib/cli.js

@@ -92,6 +92,7 @@ Commands:
   start       Start an existing deployment
   status      Show docker compose status
   update      Resolve latest published release, pull, and restart
+  restart     Recreate and restart the deployment
   stop        Stop the deployment
   uninstall   Stop the deployment and optionally remove volumes
   logs        Show docker compose logs
@@ -674,6 +675,29 @@ async function ensureDockerAvailable(options = {}) {
   }
 }
 
+function refreshDeploymentComposeAsset(templatePath, targetPath, options) {
+  if (!fs.existsSync(targetPath)) {
+    fs.copyFileSync(templatePath, targetPath);
+    return;
+  }
+
+  const template = fs.readFileSync(templatePath, "utf8");
+  const current = fs.readFileSync(targetPath, "utf8");
+  if (!options.force && current === template) {
+    return;
+  }
+
+  if (current !== template) {
+    const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
+    const backupPath = `${targetPath}.bak-${timestamp}`;
+    fs.copyFileSync(targetPath, backupPath);
+    console.log(`Backed up previous deployment compose: ${backupPath}`);
+  }
+
+  fs.copyFileSync(templatePath, targetPath);
+  console.log("Refreshed deployment compose from current CLI package.");
+}
+
 function ensureDeploymentAssets(options) {
   fs.mkdirSync(options.dir, { recursive: true });
 
@@ -686,9 +710,7 @@ function ensureDeploymentAssets(options) {
   } else {
     mergeNewDefaultKeys(targetEnvPath);
   }
-  if (options.force || !fs.existsSync(targetComposePath)) {
-    fs.copyFileSync(templateComposePath, targetComposePath);
-  }
+  refreshDeploymentComposeAsset(templateComposePath, targetComposePath, options);
 
   const envMap = readEnvFile(targetEnvPath);
   envMap.set("WATTETHERIA_RUNTIME_ENV_FILE", path.basename(targetEnvPath));
@@ -1001,6 +1023,21 @@ async function start(options) {
   printSummary(options);
 }
 
+async function restart(options) {
+  await ensureDockerAvailable();
+  if (!fs.existsSync(composeFilePath(options)) || !fs.existsSync(envFilePath(options))) {
+    throw new Error("Deployment is not initialized. Run install first.");
+  }
+  console.log("Stopping release stack...");
+  runCompose(options, ["down"]);
+  console.log("Starting release stack...");
+  runCompose(options, ["up", "-d"]);
+  if (options.healthChecks) {
+    await runHealthChecks(options);
+  }
+  printSummary(options);
+}
+
 async function status(options) {
   await ensureDockerAvailable();
   runCompose(options, ["ps"]);
@@ -1210,6 +1247,9 @@ async function run(argv) {
     case "update":
       await update(options);
       return;
+    case "restart":
+      await restart(options);
+      return;
     case "stop":
     case "down":
       await stop(options);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wattetheria",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "Wattetheria deployment CLI",
   "license": "Apache-2.0",
   "type": "commonjs",