@polterware/polterbase 0.2.7 → 0.2.8

package/README.md

@@ -128,12 +128,18 @@ polterbase app configure uru --path .
 polterbase app install uru
 ```
 
+```bash
+polterbase app update uru
+```
+
 `setup uru` installs dependencies, collects Supabase connection data, links the project, pushes migrations, and writes the runtime bootstrap payload used by the desktop app.
 
 `configure uru` refreshes the runtime connection payload without reinstalling the app.
 
 `install uru` is currently macOS-only. By default it resolves the latest GitHub release from `polterware/uru`, accepts `--version <version>` to pin a release, and still supports `--artifact-url` or `POLTERBASE_URU_MACOS_ARTIFACT_URL` as manual overrides.
 
+`update uru` is also macOS-only. It replaces the installed `uru.app` with a newer release while preserving the persisted runtime configuration, local settings, and Supabase session state stored outside the app bundle.
+
 Use `POLTERBASE_URU_GITHUB_REPO=owner/repo` when you need to resolve releases from a fork or a different repository.
 
 ### Execution Model
@@ -278,6 +284,12 @@ Install a specific release:
 polterbase app install uru --version 1.0.0
 ```
 
+Update an existing installation without re-running runtime configuration:
+
+```bash
+polterbase app update uru
+```
+
 ### Check Supabase CLI version
 
 Interactive path:

package/dist/index.js

@@ -2085,10 +2085,12 @@ function printCliHelp() {
       "  polterbase app migrate uru [push|lint|reset|local-reset] [--path <dir>] [--relink]",
       "  polterbase app configure uru [--path <dir>] [--yes]",
       "  polterbase app install uru [--version <version>] [--artifact-url <url>] [--install-dir <dir>] [--yes]",
+      "  polterbase app update uru [--version <version>] [--artifact-url <url>] [--install-dir <dir>] [--yes]",
       "",
       "Notes:",
       "  - App workflows stay separate from the generic Supabase interactive menu.",
       "  - `install uru` is macOS-only and resolves the latest GitHub release from polterware/uru by default.",
+      "  - `update uru` replaces the installed app bundle without touching the persisted runtime/app state.",
       "  - Use --artifact-url or POLTERBASE_URU_MACOS_ARTIFACT_URL to override the downloaded asset.",
       "  - Use POLTERBASE_URU_GITHUB_REPO=owner/repo to resolve releases from a different repository.",
       ""
@@ -2758,7 +2760,7 @@ async function findFirstAppBundle(dir) {
   }
   return void 0;
 }
-async function installMacosApp(context) {
+async function deployMacosApp(context, options) {
   const artifact = await resolveUruMacosArtifact(context.options);
   const tempRoot = await mkdtemp(join4(tmpdir(), "polterbase-uru-"));
   const archivePath = join4(tempRoot, artifact.fileName);
@@ -2792,6 +2794,11 @@ async function installMacosApp(context) {
   const installDir = context.options.installDir ?? "/Applications";
   mkdirSync(installDir, { recursive: true });
   const destination = join4(installDir, "uru.app");
+  if (options.requireExistingInstallation && !existsSync3(destination)) {
+    throw new Error(
+      `No existing Uru installation was found at ${destination}. Run \`polterbase app install uru\` first.`
+    );
+  }
   if (existsSync3(destination)) {
     const confirmed = context.options.yes || await promptConfirm(`Replace existing installation at ${destination}?`, false);
     if (!confirmed) {
@@ -2807,15 +2814,38 @@ async function installMacosApp(context) {
     process.cwd(),
     "App copy failed."
   );
-  process.stdout.write(`${pc2.green(`Installed Uru to ${destination}`)}
-`);
-  await runConfigure(context);
+  process.stdout.write(
+    `${pc2.green(`${options.mode === "install" ? "Installed" : "Updated"} Uru at ${destination}`)}
+`
+  );
+  if (options.configureAfterCopy) {
+    await runConfigure(context);
+  } else {
+    process.stdout.write(
+      `${pc2.dim("Preserved existing runtime configuration and local app state.")}
+`
+    );
+  }
   const shouldOpen = context.options.yes || await promptConfirm("Open Uru now?", true);
   if (shouldOpen) {
     await runOrThrow("open", ["-a", destination], process.cwd(), "Unable to open Uru.");
   }
   return 0;
 }
+async function installMacosApp(context) {
+  return deployMacosApp(context, {
+    mode: "install",
+    configureAfterCopy: true,
+    requireExistingInstallation: false
+  });
+}
+async function updateMacosApp(context) {
+  return deployMacosApp(context, {
+    mode: "update",
+    configureAfterCopy: false,
+    requireExistingInstallation: true
+  });
+}
 var uruProfile = {
   id: "uru",
   displayName: "Uru",
@@ -2842,6 +2872,8 @@ var uruProfile = {
         return runConfigure(context);
       case "install":
         return installMacosApp(context);
+      case "update":
+        return updateMacosApp(context);
       case "migrate":
         return runMigration(
           context,
@@ -2860,7 +2892,7 @@ function getAppProfile(appId) {
 // src/apps/runAppCli.ts
 function assertAppCommand(options) {
   if (!options.action || !options.app) {
-    throw new Error("Usage: polterbase app <setup|link|migrate|configure|install> <app>");
+    throw new Error("Usage: polterbase app <setup|link|migrate|configure|install|update> <app>");
   }
 }
 async function runAppCli(options) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polterware/polterbase",
-  "version": "0.2.7",
+  "version": "0.2.8",
   "description": "An interactive CLI for managing Supabase CLI workflows.",
   "type": "module",
   "bin": {