@polterware/polterbase 0.2.6 → 0.2.8

package/README.md

@@ -125,7 +125,11 @@ polterbase app configure uru --path .
 ```
 
 ```bash
-polterbase app install uru --platform macos
+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.
@@ -134,6 +138,8 @@ polterbase app install uru --platform macos
 
 `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
@@ -269,13 +275,19 @@ polterbase app configure uru
 ### Install the latest released Uru app
 
 ```bash
-polterbase app install uru --platform macos
+polterbase app install uru
 ```
 
 Install a specific release:
 
 ```bash
-polterbase app install uru --platform macos --version 1.0.0
+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

package/dist/index.js

@@ -2049,12 +2049,6 @@ function parseCliArgs(argv) {
       index = parsed.nextIndex;
       continue;
     }
-    if (token.startsWith("--platform")) {
-      const parsed = takeValue(argv, index);
-      options.platform = parsed.value;
-      index = parsed.nextIndex;
-      continue;
-    }
     if (token.startsWith("--version")) {
       const parsed = takeValue(argv, index);
       options.version = parsed.value;
@@ -2090,11 +2084,13 @@ function printCliHelp() {
       "  polterbase app link uru [--path <dir>] [--relink]",
       "  polterbase app migrate uru [push|lint|reset|local-reset] [--path <dir>] [--relink]",
       "  polterbase app configure uru [--path <dir>] [--yes]",
-      "  polterbase app install uru --platform macos [--version <version>] [--artifact-url <url>] [--install-dir <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` resolves the latest GitHub release from polterware/uru by default.",
+      "  - `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.",
       ""
@@ -2764,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);
@@ -2798,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) {
@@ -2813,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",
@@ -2847,10 +2871,9 @@ var uruProfile = {
       case "configure":
         return runConfigure(context);
       case "install":
-        if ((context.options.platform ?? "macos") !== "macos") {
-          throw new Error("Only --platform macos is currently supported for Uru install.");
-        }
         return installMacosApp(context);
+      case "update":
+        return updateMacosApp(context);
       case "migrate":
         return runMigration(
           context,
@@ -2869,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.6",
+  "version": "0.2.8",
   "description": "An interactive CLI for managing Supabase CLI workflows.",
   "type": "module",
   "bin": {