run-spaceapp 1.0.31 → 1.0.36

package/README.md

@@ -105,10 +105,10 @@ Claude Code is not redistributed in SpaceApp images. Install the reviewed
 package as an explicit owner action with:
 
 ```bash
-npx --yes run-spaceapp@personal provider install claude
+npx --yes run-spaceapp@latest provider install claude
 ```
 
-Run `npx --yes run-spaceapp@personal help` for the complete command list. Full
+Run `npx --yes run-spaceapp@latest help` for the complete command list. Full
 documentation:
 
 - [Getting started](https://github.com/oll4com/spaceapp/blob/main/docs/getting-started.md)
@@ -121,16 +121,38 @@ After the stack passes readiness checks, the install command prints the fresh
 it expires before the owner is created, run:
 
 ```bash
-npx --yes run-spaceapp@personal owner rotate-setup-token
+npx --yes run-spaceapp@latest owner rotate-setup-token
 ```
 
-Common follow-up commands use the same reliable launcher prefix:
+### Self-Hosted Installation Help & Recovery
+
+- **Forgot your operator password?** Run in your host terminal:
+  ```bash
+  npx --yes run-spaceapp@latest owner reset-password
+  ```
+- **Need a clean install from scratch?** Run:
+  ```bash
+  npx --yes run-spaceapp@latest factory-reset
+  ```
+
+### Common Commands
 
 ```bash
-npx --yes run-spaceapp@personal doctor
-npx --yes run-spaceapp@personal status
-npx --yes run-spaceapp@personal credentials list
-npx --yes run-spaceapp@personal uninstall
+npx --yes run-spaceapp@latest status         # Check container health and port bindings
+npx --yes run-spaceapp@latest logs           # View or stream container logs
+npx --yes run-spaceapp@latest doctor         # Verify system prerequisites and diagnose Docker
+npx --yes run-spaceapp@latest up             # Start containers in background
+npx --yes run-spaceapp@latest down           # Stop containers cleanly
+npx --yes run-spaceapp@latest open           # Open web app in default browser
+npx --yes run-spaceapp@latest backup         # Create verified, portable backup archive
+npx --yes run-spaceapp@latest restore        # Restore state from a backup archive
+npx --yes run-spaceapp@latest update         # Pull latest images and upgrade stack
+npx --yes run-spaceapp@latest rollback       # Revert to previous stable version
+npx --yes run-spaceapp@latest workspace add <path> # Register host folder for AI CLIs
+npx --yes run-spaceapp@latest workspace list       # List registered host folders
+npx --yes run-spaceapp@latest credentials list     # List configured AI providers
+npx --yes run-spaceapp@latest credentials set <provider> # Set API key via masked input
+npx --yes run-spaceapp@latest uninstall      # Stop and remove containers (preserves data)
 ```
 
 Uninstall retains data by default and prints the separate

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "run-spaceapp",
-  "version": "1.0.31",
-  "spaceappRuntimeVersion": "1.0.31",
+  "version": "1.0.36",
+  "spaceappRuntimeVersion": "1.0.36",
   "spaceappHostRootRuntimeCompatible": true,
   "description": "Cross-platform Docker launcher for the SpaceApp self-hosted agent workspace",
   "license": "Apache-2.0",
@@ -52,5 +52,5 @@
     "access": "public",
     "provenance": true
   },
-  "gitHead": "2769d82e1077c9316c6452f40c4996e0290ce083"
+  "gitHead": "9aa5727def9b1fa92e90ccd3b60807f1f058092b"
 }

package/src/cli.mjs

@@ -968,6 +968,13 @@ async function installCommand(args, {
       stdout.write('Paste it into the "One-time setup token" field in the page that opens.\n');
       stdout.write("It expires in 15 minutes and stops working after the first owner is created.\n");
       stdout.write(`If it expires, run: ${UNIVERSAL_COMMAND} owner rotate-setup-token\n`);
+    } else {
+      stdout.write(
+        "\nNotice: Existing SpaceApp database detected with an already registered operator account.\n" +
+        "Sign in using your existing email and password.\n" +
+        `- Forgot password? Run: "${UNIVERSAL_COMMAND} owner reset-password"\n` +
+        `- Clean install from scratch: "${UNIVERSAL_COMMAND} factory-reset"\n\n`
+      );
     }
     stdout.write(
       "Next: open the Getting Started room and use OpenCode. A working free model is selected on first launch.\n" +
@@ -1319,7 +1326,7 @@ async function performUpdate({
   const stagedRoot = await mkdtemp(join(tmpdir(), "spaceapp-update-"));
   let checkpoint = null;
   try {
-    await writeRuntimeFiles(stagedRoot, updated);
+    await commitInstallation(stagedRoot, updated);
     const stagedCommand = (action) => composeCommand(action, root, {...updated, stateRoot: stagedRoot});
     const pullCode = await withHeadlessDockerConfig(
       platform, stagedCommand("pull"),
@@ -1331,7 +1338,7 @@ async function performUpdate({
     }
     if (await verifyStorage({ root, config: updated, existingConfig: config, operation: "upgrade", inspectResources, execute, stdout, stderr }) !== 0) return 1;
     checkpoint = await createQuiescedCheckpoint(root, config, {stdin, stdout, stderr, execute, platform});
-    await writeRuntimeFiles(root, updated);
+    await commitInstallation(root, updated, { persistConfig: false });
     const upCode = await execute(
       composeCommand("up", root, { profile: updated.profile, companionsEnabled: updated.companionsEnabled }),
       { stdin, stdout, stderr }
@@ -1410,6 +1417,9 @@ async function collectFiles(directory, logicalDirectory) {
 async function createQuiescedCheckpoint(root, config, io) {
   io.stdout.write("Pausing SpaceApp writers before the database checkpoint...\n");
   try {
+    io.stdout.write("Ensuring the existing PostgreSQL database is ready for the checkpoint...\n");
+    const databaseCode = await io.execute(composeCommand("ensureCheckpointDatabase", root, config), io);
+    if (databaseCode !== 0) throw new Error(`The existing PostgreSQL database did not become ready (exit ${databaseCode}). The upgrade was not applied.`);
     const code = await io.execute(composeCommand("stopForRestore", root, config), io);
     if (code !== 0) throw new Error(`Could not pause SpaceApp writers (exit ${code}).`);
     return await createCheckpoint(root, config, io);

package/src/index.mjs

@@ -677,6 +677,7 @@ export function composeCommand(action, root, options = {}) {
     storageFree: ["exec", "-T", "spaceapp-core", "node", "-e", "const fs=require('node:fs');const s=fs.statfsSync('/var/lib/spaceapp');console.log(Number(s.bavail)*Number(s.bsize))"],
     purge: ["down", "--volumes", "--remove-orphans"],
     repair: ["up", "-d", "--remove-orphans", "--force-recreate"],
+    ensureCheckpointDatabase: ["up", "-d", "--no-deps", "--wait", "--wait-timeout", "120", "postgres"],
     checkpointDump: ["exec", "-T", "postgres", "pg_dump", "-c", "--if-exists", "-U", "spaceapp", "-d", "spaceapp"],
     checkpointRestore: ["exec", "-T", "postgres", "psql", "-v", "ON_ERROR_STOP=1", "-U", "spaceapp", "-d", "spaceapp"]
   };
@@ -848,7 +849,8 @@ export async function prepareInstallation(root, {
 }
 
 export async function commitInstallation(root, config, {
-  templateDir = defaultTemplateDir()
+  templateDir = defaultTemplateDir(),
+  persistConfig = true
 } = {}) {
   validateHome(root);
   validateConfig(config);
@@ -856,7 +858,7 @@ export async function commitInstallation(root, config, {
   await mkdir(root, { recursive: true, mode: 0o700 });
   await atomicWrite(join(root, "compose.yml"), composeTemplate);
   await writeRuntimeFiles(root, config);
-  await saveConfig(root, config);
+  if (persistConfig) await saveConfig(root, config);
 }
 
 export async function initializeInstallation(root, options) {

package/templates/compose.yml

@@ -3,12 +3,6 @@ services:
     image: ghcr.io/oll4com/spaceapp-core:${SPACEAPP_IMAGE_TAG}
     restart: unless-stopped
     init: true
-    entrypoint:
-      - /bin/sh
-      - -ec
-      - |
-        sed -i 's/agentToolsWriterCommand: env.SPACE_AGENT_TOOLS_WRITER || [^,]*/agentToolsWriterCommand: null/g' /app/apps/api/dist/config.js 2>/dev/null || true
-        exec /app/deploy/docker/core-entrypoint.sh
     security_opt:
       - no-new-privileges:true
     mem_limit: "${SPACEAPP_CORE_MEMORY_LIMIT}"