@inoku/lepan 0.7.66 → 0.7.67

package/README.md

@@ -86,7 +86,7 @@ The Linux/macOS legacy browser-owner setup uses the built-in AV1 registration en
 
 LifeDrive requires Leither V0.24.11 or newer. Linux/macOS browser-owner setup creates a separate Ed25519 `sodiumv2` identity for the primary browser. Windows prints a private ten-minute invitation for the first paired phone; later users and devices are managed from a paired device.
 
-After successful npm setup, the installer saves a private `lepan-pairing-<id>.png` and prints its full path. It also displays the QR code when it fits the terminal's width and height. In the iPhone or Android app, open **Settings → Set up users → Scan QR code** and scan the terminal or the saved image. A private `.json` invitation is saved alongside it for apps without a setup scanner: transfer that file to the phone and use **Choose identity file**. These files are saved in the Leither root on Linux/macOS and its private `.lifedrive-household` directory on Windows. Household invitations expire ten minutes after creation; legacy identity codes contain a device private key, so keep them private and delete the transfer copies after pairing. Legacy `--add-device` and `--upgrade` also produce a code when an identity is available; household upgrades preserve existing pairings without issuing new invitations.
+After successful npm setup, the installer displays the QR code at the end of its output whenever the terminal is wide enough. If the whole code cannot fit on screen, it automatically opens the full-size QR image in the computer's image viewer. In the iPhone or Android app, open **Settings → Set up users → Scan QR code** and scan the displayed code. A private `lepan-pairing-<id>.png` is also saved, with its path printed as a fallback for remote sessions or computers without an image viewer. A private `.json` invitation is saved alongside it for apps without a setup scanner: transfer that file to the phone and use **Choose identity file**. These files are saved in the Leither root on Linux/macOS and its private `.lifedrive-household` directory on Windows. Household invitations expire ten minutes after creation; legacy identity codes contain a device private key, so keep them private and delete the transfer copies after pairing. Legacy `--add-device` and `--upgrade` also produce a code when an identity is available; household upgrades preserve existing pairings without issuing new invitations.
 
 ### Renew an expired first-phone invitation
 

package/USER_MANUAL.md

@@ -142,8 +142,7 @@ This keeps what step 2.1 installed and adds users and phones:
 
 1. Creates LifeDrive's private configuration in `<Leither root>/.lifedrive-household/`.
 2. Installs and starts the identity service: `lifedrive-identity` through systemd on Linux, `uk.inoku.lifedrive-identity` through launchd on macOS, or `LifeDrive Identity` through Task Scheduler on Windows. Leither itself is not restarted and must be running separately.
-3. Prints a **setup invitation**: a block of text, followed by
-   *"Keep the invitation above private. It expires in ten minutes."*
+3. Displays a **setup invitation** as a QR code. If the terminal is too small, the full-size QR image opens automatically on this computer. The invitation expires in ten minutes.
 
 The setup invitation is what makes a phone the first user of this node. Treat it
 like a key: do not post it, email it to others, or paste it anywhere public.
@@ -152,7 +151,7 @@ like a key: do not post it, email it to others, or paste it anywhere public.
 
 Within ten minutes of the invitation being printed:
 
-1. Keep the installer’s final QR code visible, or open the saved `lepan-pairing-<id>.png` using the path it prints. If you used the standalone shell installer, copy the whole invitation block instead.
+1. Scan the installer’s final QR code or the QR image that opens automatically. The saved image path is a fallback for remote sessions or computers without an image viewer. If you used the standalone shell installer, copy the whole invitation block instead.
 2. Open LifeDrive on the phone. The **Set up your LifeDrive** screen opens by itself (or open **Settings → Set up users**).
 3. Enter **Your name** and a name for this device.
 4. Tap **Scan QR code** and point the phone at the terminal or saved image. You can also use **Paste node identity** or **Choose identity file**.
@@ -168,7 +167,7 @@ empty page, or **Settings → Set up users**, opens it again.
 
 | Situation | What to do |
 |---|---|
-| The invitation expired before you pasted it | On the node, stop the identity service (`sudo systemctl stop lifedrive-identity` on Linux, or `sudo launchctl bootout system/uk.inoku.lifedrive-identity` on macOS) and run the command from 2.2 again for a fresh invitation. |
+| The invitation expired before you pasted it | On the node, run `npx --yes @inoku/lepan@latest --household` again for a fresh QR code. Setup renews an unclaimed invitation and preserves the existing identity; no manual service commands are needed. |
 | You pasted it, but the app lost its connection or was closed | Open the app on **the same phone** and paste **the same invitation** again. A claim that has started can finish after the ten minutes have passed. Do not delete the app or ask for a new invitation: that would abandon the phone's pending key. |
 | Setup says the node already has users | The node has been claimed. Add further devices from **My devices** (section 4), not with a new setup invitation. |
 

package/bin/lifedrive.js

@@ -12,6 +12,31 @@ const distributionDirectory = path.resolve(__dirname, "..", "dist");
 const bundlePath = path.join(distributionDirectory, "lifedrive-bundle.tar.gz");
 const checksumPath = `${bundlePath}.sha256`;
 
+function openPairingImage(imagePath) {
+  // A remote server must not open a window in another user's desktop session.
+  if (process.env.SSH_CONNECTION || process.env.SSH_TTY) return false;
+  let command;
+  let args;
+  if (process.platform === "darwin") {
+    command = "/usr/bin/open";
+    args = [imagePath];
+  } else if (process.platform === "win32") {
+    command = "powershell.exe";
+    args = ["-NoLogo", "-NoProfile", "-NonInteractive", "-Command",
+      "Start-Process -FilePath $env:LEPAN_PAIRING_IMAGE -ErrorAction Stop"];
+  } else if (process.platform === "linux" && (process.env.DISPLAY || process.env.WAYLAND_DISPLAY)) {
+    command = "xdg-open";
+    args = [imagePath];
+  } else {
+    return false;
+  }
+  const result = spawnSync(command, args, {
+    stdio: "ignore", timeout: 5000,
+    env: { ...process.env, LEPAN_PAIRING_IMAGE: imagePath },
+  });
+  return !result.error && result.status === 0;
+}
+
 async function showPairingCode(resultPath) {
   if (!fs.existsSync(resultPath)) return;
   // The child writes this only after setup succeeds. Never scrape its output:
@@ -64,17 +89,27 @@ async function showPairingCode(resultPath) {
     process.stderr.write(renewalHint);
     return;
   }
-  process.stdout.write("\nNext: pair your phone\n\n");
-  process.stdout.write("  1. Open LePan on your iPhone or Android phone.\n");
-  process.stdout.write("  2. Go to Settings > Set up users > Scan QR code.\n");
-  // Small terminal codes use half-height blocks. If the terminal would wrap,
-  // or scroll the instructions out of view, use the full-resolution PNG.
+  // Never hide a terminal code just because the window is short. Open the PNG
+  // automatically when the whole code cannot be visible at once, and put the
+  // terminal code last so subsequent instructions cannot scroll it away.
   const width = modules.size + options.margin * 2;
   const height = Math.ceil(width / 2);
-  const fitsTerminal = process.stdout.isTTY && process.stdout.columns > width &&
-    process.stdout.rows >= height + 26;
-  if (fitsTerminal) {
-    process.stdout.write("  3. Scan the code below.\n\n");
+  const fitsWidth = process.stdout.isTTY && process.stdout.columns > width;
+  const fitsScreen = fitsWidth && process.stdout.rows >= height + 3;
+  const imageOpened = !fitsScreen && openPairingImage(imagePath);
+  process.stdout.write("\nPair your phone\n\n");
+  process.stdout.write("Open LePan > Settings > Set up users > Scan QR code.\n");
+  process.stdout.write(imageOpened
+    ? "The QR image has opened automatically. Scan it with your phone.\n"
+    : fitsWidth ? "Scan the QR code below with your phone.\n"
+    : "This terminal is too narrow for the QR code and no image viewer could be opened. Open the saved image below.\n");
+  process.stdout.write(`${privacyNote}\n`);
+  process.stdout.write(`\nSaved QR image: ${imagePath}\n`);
+  process.stdout.write(`Pairing file (Choose identity file): ${identityPath}\n`);
+  process.stdout.write("Keep this computer on and connected while using LePan.\n");
+  process.stdout.write(renewalHint);
+  if (fitsWidth) {
+    process.stdout.write("\n");
     // Explicit colors and a four-module quiet zone work on light/dark themes.
     const dark = (x, y) => x >= 0 && y >= 0 && x < modules.size && y < modules.size && modules.get(y, x);
     let terminal = "";
@@ -86,16 +121,7 @@ async function showPairingCode(resultPath) {
       terminal += "\x1b[0m\n";
     }
     process.stdout.write(terminal);
-  } else {
-    process.stdout.write("  3. Open the saved QR image on this computer and scan it.\n");
   }
-  process.stdout.write(`\nQR image:\n  ${imagePath}\n\n${privacyNote}\n`);
-  process.stdout.write("\nNo Scan QR code button? Transfer this pairing file to your phone:\n");
-  process.stdout.write(`  ${identityPath}\n`);
-  process.stdout.write("Then open Settings > Set up users > Choose identity file.\n");
-  process.stdout.write("Keep the pairing file private; delete the transfer copy after import.\n");
-  process.stdout.write("Keep this computer on and connected while using LePan.\n");
-  process.stdout.write(renewalHint);
 }
 
 async function runInstaller(command, args) {

package/dist/lifedrive-bundle.tar.gz

@@ -1,4 +1,4 @@
 [diffend] Oversized file quarantined before diffing.
 name: package/dist/lifedrive-bundle.tar.gz
-size: 44139710 bytes
-sha256: 134de0bb85330eb3192e837e5054074969a80cbb4eaa1ee0b7870e55b9a3b310
+size: 44139682 bytes
+sha256: 2173717546eb881f72dce0fdd7a5a6727bfc5286b4c23f948528b9d8f1a2fde8

package/dist/lifedrive-bundle.tar.gz.sha256

@@ -1 +1 @@
-134de0bb85330eb3192e837e5054074969a80cbb4eaa1ee0b7870e55b9a3b310  lifedrive-bundle.tar.gz
+2173717546eb881f72dce0fdd7a5a6727bfc5286b4c23f948528b9d8f1a2fde8  lifedrive-bundle.tar.gz

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inoku/lepan",
-  "version": "0.7.66",
+  "version": "0.7.67",
   "description": "Install LePan and its Leither runtime on Linux, macOS, or Windows",
   "os": [
     "linux",