@inoku/lepan 0.7.70 → 0.7.72

package/README.md

@@ -97,7 +97,34 @@ 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 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.
+After successful npm setup, the installer displays the QR code at the end of its output whenever the complete code fits in the terminal. 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.
+
+If the terminal is too small, the output gives the required columns and rows,
+a width marker, and a command to redisplay the code after resizing. Run it on the node
+when connected over SSH. For npm installations, the command has this form:
+
+```bash
+npx --yes @inoku/lepan@latest --show-qr '/path/to/lepan-pairing.json'
+```
+
+Redisplaying shows only the QR and a privacy reminder, or a short size warning
+and width marker if it cannot fit. It does not repeat the setup instructions or
+create another image file. Terminal QR codes use a smaller payload and lower
+error correction; the saved PNG keeps medium error correction. The full original
+identity remains in the JSON file, and both mobile apps accept the QR encoding.
+
+This displays the saved code without installing, upgrading, or changing device
+authorization. Desktop packages print a command using their private Node runtime.
+Redisplaying an invitation does **not** reset its ten-minute expiry; output shows
+its expiry in UTC and how to renew it. A legacy `lifedrive-device-identity` file
+is a persistent device key and has no ten-minute expiry; it remains usable while
+authorized. Keep its original safe and offline, and delete transfer copies after
+pairing. Upgrades keep the output brief: the existing identity path or saved-pairing
+directory, the QR and file paths when available, and a help command. If the QR
+cannot fit, the output gives the required width and the command to redisplay it.
+Use `--help` for expiry, file import, and account reconnection instructions.
+Initial setup's local browser links are labeled with the node's detected LAN
+interfaces; these are node addresses, not router or gateway addresses.
 
 ### Renew an expired first-phone invitation
 

package/USER_MANUAL.md

@@ -147,6 +147,30 @@ This keeps what step 2.1 installed and adds users and phones:
 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.
 
+If the terminal is too small for the QR, resize it to the columns and rows
+printed by setup, then run the printed `--show-qr` command. Over SSH, run the
+command on the node in that same terminal. It displays the saved code without
+installing or upgrading again. You can also open the saved PNG image or transfer
+the saved JSON privately to your phone and use **Choose identity file**.
+For npm installations:
+
+```bash
+npx --yes @inoku/lepan@latest --show-qr '/path/to/lepan-pairing.json'
+```
+
+This command shows only the QR and a privacy reminder. If it cannot fit, it prints
+the required size and a width marker so you can resize and retry. It does not
+repeat the setup instructions or create another image file. Terminal QR codes use
+a smaller encoding; the saved PNG retains stronger error correction.
+
+The Windows and macOS desktop installers print an equivalent command using their
+bundled runtime. Redisplaying a code does not renew it: setup and reconnect
+invitations expire ten minutes after creation. The output shows the expiry in
+UTC. Older browser-owner installations use a `lifedrive-device-identity` file
+containing a persistent device private key; that identity has no ten-minute
+expiry and remains usable while authorized. Keep its original safe and offline;
+delete transfer copies after pairing.
+
 ### 2.3 Create the first user from your phone
 
 Within ten minutes of the invitation being printed:
@@ -204,6 +228,14 @@ To install a specific release instead of the latest, name it, for example
 `npx --yes @inoku/lepan@0.7.35 --upgrade`. Release versions are never reused,
 so a version number always means the same files.
 
+Upgrade output shows the existing identity path or saved-pairing directory and a
+help command. When a QR cannot fit, it shows the required terminal size and the
+`--show-qr` command to run after resizing the window. Use `--help` for file import,
+identity expiry, and device-management instructions. Household
+upgrades preserve paired phones and do not issue or renew an invitation; to
+reconnect to an existing household account, run `--recover-device` with its name
+or user ID on the node. For another device, use **My devices** on a paired phone.
+
 The installer saves the previous application files to a backup directory, prints
 where, and then:
 

package/bin/lifedrive.js

@@ -11,6 +11,42 @@ const { pathToFileURL } = require("node:url");
 const distributionDirectory = path.resolve(__dirname, "..", "dist");
 const bundlePath = path.join(distributionDirectory, "lifedrive-bundle.tar.gz");
 const checksumPath = `${bundlePath}.sha256`;
+const packageVersion = require("../package.json").version;
+// Desktop installers carry Node privately; their users need not have npx.
+const pairingCommand = path.basename(path.resolve(__dirname, "..")) === "package"
+  ? `${process.platform === "win32" ? "& " : ""}${quoteArgument(process.execPath)} ${quoteArgument(__filename)}`
+  : `npx --yes @inoku/lepan@${/^\d+\.\d+\.\d+$/.test(packageVersion) ? packageVersion : "latest"}`;
+
+function quoteArgument(value) {
+  return process.platform === "win32"
+    ? `'${value.replace(/'/g, "''")}'`
+    : `'${value.replace(/'/g, "'\\''")}'`;
+}
+
+function pairingQrPayload(pairing) {
+  const legacy = pairing.type === "lifedrive-device-identity";
+  // Preserve every field consumed by the existing mobile importers. The full
+  // original identity stays in the JSON file, including unused metadata.
+  const fields = legacy ? [
+    "type", "version", "app_id", "uid", "label", "public_username", "key_type",
+    "public_key", "private_key", "signer_info", "node_id",
+  ] : [
+    "type", "version", "app_id", "node_id", "endpoint", "transport",
+    "transport_key", "certificate_sha256", "request_id", "secret",
+  ];
+  const qr = Object.fromEntries(fields.filter(key => Object.hasOwn(pairing, key)).map(key => [key, pairing[key]]));
+  if (legacy && typeof qr.private_key === "string" && typeof qr.public_key === "string") {
+    // sodium's 64-byte secret includes a duplicate public key. Both Android and
+    // iOS already accept the 32-byte seed and verify the derived public key.
+    const secret = Buffer.from(qr.private_key, "base64url");
+    const publicKey = Buffer.from(qr.public_key, "base64url");
+    if (secret.length === 64 && publicKey.length === 32 && secret.subarray(32).equals(publicKey)) {
+      qr.private_key = secret.subarray(0, 32).toString("base64url");
+    }
+    secret.fill(0);
+  }
+  return JSON.stringify(qr);
+}
 
 function openPairingImage(imagePath) {
   // A remote server must not open a window in another user's desktop session.
@@ -37,90 +73,151 @@ function openPairingImage(imagePath) {
   return !result.error && result.status === 0;
 }
 
-async function showPairingCode(resultPath) {
+function printTerminalQr(modules, margin) {
+  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 = "";
+  for (let y = -margin; y < modules.size + margin; y += 2) {
+    terminal += "\x1b[30;47m";
+    for (let x = -margin; x < modules.size + margin; x += 1) {
+      terminal += dark(x, y) ? (dark(x, y + 1) ? "█" : "▀") : (dark(x, y + 1) ? "▄" : " ");
+    }
+    terminal += "\x1b[0m\n";
+  }
+  process.stdout.write(terminal);
+}
+
+async function showPairingCode(resultPath, savedFile = false) {
   if (!fs.existsSync(resultPath)) return;
+  const compact = savedFile || (process.argv.includes("--upgrade") && !process.argv.includes("--household"));
   // The child writes this only after setup succeeds. Never scrape its output:
   // it can contain node keys as well as the mobile device's pairing identity.
   const pairing = JSON.parse(fs.readFileSync(resultPath, "utf8"));
   if (pairing.version !== 1 || !["lifedrive-device-identity", "lifedrive-node-setup", "lifedrive-user-identity"].includes(pairing.type)) {
     throw new Error("Unsupported pairing data");
   }
-  const directory = fs.readFileSync(`${resultPath}.directory`, "utf8");
+  const directory = savedFile ? path.dirname(resultPath) : fs.readFileSync(`${resultPath}.directory`, "utf8");
   if (!path.isAbsolute(directory)) throw new Error("Invalid pairing image directory");
   const payload = JSON.stringify(pairing);
-  // Only encode fields consumed by the existing Android and iOS setup parsers.
-  // The node enforces expiry and returns account details after a successful claim.
-  // Keep the full invitation in the import file, and leave legacy identities intact.
-  // iOS still requires certificate_sha256 even when Leither transport uses a key.
-  const qrPayload = pairing.type !== "lifedrive-device-identity"
-    ? JSON.stringify(Object.fromEntries([
-      "type", "version", "app_id", "node_id", "endpoint", "transport",
-      "transport_key", "certificate_sha256", "request_id", "secret",
-    ].filter(key => Object.hasOwn(pairing, key)).map(key => [key, pairing[key]])))
-    : payload;
+  const qrPayload = pairingQrPayload(pairing);
   const basename = path.join(directory, `lepan-pairing-${randomUUID()}`);
   const imagePath = `${basename}.png`;
-  const identityPath = `${basename}.json`;
+  const identityPath = savedFile ? resultPath : `${basename}.json`;
   // Older mobile releases support importing this file but have no setup scanner.
   // Keep a private copy even when QR generation succeeds.
-  fs.writeFileSync(identityPath, payload, { flag: "wx", mode: 0o600 });
+  if (!savedFile) fs.writeFileSync(identityPath, payload, { flag: "wx", mode: 0o600 });
   const options = { errorCorrectionLevel: "M", margin: 4, scale: 8 };
   const privacyNote = pairing.type !== "lifedrive-device-identity"
     ? "Keep it private. This invitation expires ten minutes after creation."
-    : "This contains your device private key. Keep it private and delete it after pairing.";
+    : "This is a persistent device identity; it does not expire after ten minutes. It remains usable while the device is authorized.\nIt contains your device private key. Keep the original safe and offline; delete transfer copies after pairing.";
+  const expiry = pairing.type !== "lifedrive-device-identity" && Number.isFinite(pairing.expires)
+    ? `\nInvitation expiry: ${new Date(pairing.expires * 1000).toISOString()} (UTC).\n${pairing.expires <= Date.now() / 1000 ? "This invitation has expired. Create a fresh invitation before pairing.\n" : ""}` : "";
+  const reopenHint = `\nTo show this QR again, run on this computer (on the node for an SSH session):\n  ${pairingCommand} --show-qr ${quoteArgument(identityPath)}\nThis only displays the saved pairing code; it does not install or upgrade LePan.\n`;
+  const nodeRoot = process.platform === "win32" && path.basename(directory) === ".lifedrive-household"
+    ? path.dirname(directory) : directory;
+  // A saved file may have been moved off the node. Its new parent is not proof
+  // of the original Leither root; let node discovery choose in that case.
+  const renewalRoot = savedFile ? "" : ` --leither-root ${quoteArgument(nodeRoot)}`;
   const renewalHint = pairing.type === "lifedrive-node-setup"
-    ? "\nInvitation expired? Run this again on the node:\n  npx --yes @inoku/lepan@latest --household\n"
-    : pairing.type === "lifedrive-user-identity" ? "\nInvitation expired? Run the same reconnect command again on this computer.\n" : "";
+    ? `\nInvitation expired? Run this again on the node before the first owner is created:\n  ${pairingCommand}${renewalRoot} --household\n`
+    : pairing.type === "lifedrive-user-identity"
+      ? `\nInvitation expired? Run the same reconnect command again on the node${pairing.user_id ? `:\n  ${pairingCommand}${renewalRoot} --recover-device ${quoteArgument(pairing.user_id)}` : "."}\n` : "";
   let modules;
   try {
     const QRCode = require("qrcode");
-    const png = await QRCode.toBuffer(qrPayload, options);
-    modules = QRCode.create(qrPayload, options).modules;
+    // A clean terminal can use lower error correction to reduce its width.
+    // Keep medium correction and the full quiet zone in the saved PNG.
+    modules = QRCode.create(qrPayload, { ...options, errorCorrectionLevel: "L" }).modules;
     // Unique names and exclusive creation avoid overwriting another device's
     // code or following a pre-existing symlink. Keep this outside the app bundle.
-    fs.writeFileSync(imagePath, png, { flag: "wx", mode: 0o600 });
+    if (!savedFile) {
+      const png = await QRCode.toBuffer(qrPayload, options);
+      fs.writeFileSync(imagePath, png, { flag: "wx", mode: 0o600 });
+    }
   } catch {
+    if (savedFile) {
+      process.stderr.write("The QR code could not be displayed. Open the saved QR image instead.\n");
+      process.exitCode = 1;
+      return;
+    }
     // The child no longer prints secrets. Preserve an importable fallback
     // before runInstaller removes the temporary handoff directory.
+    if (compact) {
+      process.stderr.write(`\nThe QR code could not be created. In LePan, open Settings > Set up users > Choose identity file.\nPairing file: ${identityPath}\nKeep it private.\n`);
+      process.stderr.write(expiry);
+      process.stderr.write(`\nHelp:\n  ${pairingCommand} --help\n`);
+      return;
+    }
     process.stderr.write("\nNext: pair your phone\n\nThe QR code could not be created. Use the saved pairing file instead.\n");
     process.stderr.write(`  ${identityPath}\n\n`);
     process.stderr.write("Transfer this file to your phone, then select it in LePan > Settings > Set up users > Choose identity file.\n");
     process.stderr.write(`${privacyNote}\n`);
+    process.stderr.write(expiry);
+    process.stderr.write(reopenHint);
     process.stderr.write(renewalHint);
+    if (pairing.type !== "lifedrive-device-identity") {
+      process.stderr.write("Redisplaying the QR does not extend the invitation's ten-minute expiry.\n");
+    }
     return;
   }
-  // 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.
+  // Only print a terminal QR when the complete code fits. Otherwise, explain
+  // the required size and offer the saved image instead of a wrapped/clipped QR.
   const width = modules.size + options.margin * 2;
+  const widthMarker = `|${"-".repeat(width - 1)}|`;
   const height = Math.ceil(width / 2);
   const fitsWidth = process.stdout.isTTY && process.stdout.columns > width;
   const fitsScreen = fitsWidth && process.stdout.rows >= height + 3;
+  // Redisplaying is deliberately quiet and creates no additional files.
+  if (savedFile) {
+    if (!process.stdout.isTTY) {
+      process.stdout.write("Run --show-qr in an interactive terminal.\n");
+    } else if (!fitsScreen) {
+      process.stdout.write(`Terminal too small for the QR code: ${width + 1} columns and ${height + 3} rows needed.\n${widthMarker}\nResize the terminal, then run the same command again.\n`);
+    } else {
+      process.stdout.write("Keep it private.\n");
+      process.stdout.write(expiry);
+      printTerminalQr(modules, options.margin);
+    }
+    return;
+  }
   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 = "";
-    for (let y = -options.margin; y < modules.size + options.margin; y += 2) {
-      terminal += "\x1b[30;47m";
-      for (let x = -options.margin; x < modules.size + options.margin; x += 1) {
-        terminal += dark(x, y) ? (dark(x, y + 1) ? "█" : "▀") : (dark(x, y + 1) ? "▄" : " ");
-      }
-      terminal += "\x1b[0m\n";
+  if (compact) {
+    process.stdout.write("\nHow to pair your phone:\nOpen LePan > Settings > Set up users > Scan QR code.\n");
+    if (imageOpened) process.stdout.write("\nThe QR image has opened automatically.\n");
+    if (!fitsScreen) {
+      process.stdout.write(process.stdout.isTTY
+        ? `\nThe QR code needs ${width + 1} columns and ${height + 3} rows. Resize this terminal or open the saved image.\n${widthMarker}\nTo display it here, resize and run:\n`
+        : "\nTo display the QR code, run in an interactive terminal:\n");
+      process.stdout.write(`\n  ${pairingCommand} --show-qr ${quoteArgument(identityPath)}\n`);
     }
-    process.stdout.write(terminal);
+    process.stdout.write(`\nSaved QR image: ${imagePath}\nPairing file (Choose identity file): ${identityPath}\n`);
+    process.stdout.write(expiry);
+    process.stdout.write(`\nHelp:\n  ${pairingCommand} --help\n`);
+  } else {
+    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"
+      : fitsScreen ? "Scan the QR code below with your phone.\n"
+      : process.stdout.isTTY
+        ? `The QR code needs ${width + 1} columns and ${height + 3} rows. Resize this terminal or open the saved image.\n`
+        : "A QR code cannot be displayed in this output. Run the --show-qr command below in an interactive terminal, or open the saved QR image.\n");
+    if (!fitsScreen && process.stdout.isTTY) process.stdout.write(`${widthMarker}\n`);
+    process.stdout.write(`${privacyNote}\n`);
+    process.stdout.write(expiry);
+    process.stdout.write(`\nSaved QR image: ${imagePath}\n`);
+    process.stdout.write(`Pairing file (Choose identity file): ${identityPath}\n`);
+    process.stdout.write("To import the file, transfer it privately to your phone, then open\nLePan > Settings > Set up users > Choose identity file.\n");
+    process.stdout.write(reopenHint);
+    process.stdout.write("Keep this computer on and connected while using LePan.\n");
+    process.stdout.write(renewalHint);
+    if (pairing.type !== "lifedrive-device-identity") {
+      process.stdout.write("Redisplaying the QR does not extend the invitation's ten-minute expiry.\n");
+    }
+  }
+  if (fitsScreen) {
+    printTerminalQr(modules, options.margin);
   }
 }
 
@@ -130,7 +227,7 @@ async function runInstaller(command, args) {
   try {
     const result = spawnSync(command, args, {
       stdio: "inherit",
-      env: { ...process.env, LIFEDRIVE_PAIRING_RESULT: resultPath },
+      env: { ...process.env, LIFEDRIVE_PAIRING_RESULT: resultPath, LIFEDRIVE_PAIRING_COMMAND: pairingCommand },
     });
     if (result.error) throw result.error;
     if (typeof result.status === "number") process.exitCode = result.status;
@@ -142,6 +239,7 @@ async function runInstaller(command, args) {
       catch {
         // Parser errors may contain identity text; never print them.
         process.stderr.write("\nPhone pairing could not be prepared. Use your existing identity file, or create a new setup invitation from the node.\n");
+        process.stderr.write(`\nHelp:\n  ${pairingCommand} --help\n`);
       }
     }
   } finally {
@@ -182,6 +280,43 @@ function windowsArguments(values) {
 }
 
 async function main() {
+  const argumentsList = process.argv.slice(2);
+  if (argumentsList.some(argument => argument === "--show-qr" || argument.startsWith("--show-qr="))) {
+    const file = argumentsList[0] === "--show-qr" && argumentsList.length === 2
+      ? argumentsList[1]
+      : argumentsList.length === 1 && argumentsList[0].startsWith("--show-qr=")
+        ? argumentsList[0].slice("--show-qr=".length) : "";
+    if (!file || file.startsWith("--")) throw new Error("Use --show-qr FILE by itself to display a saved identity or invitation.");
+    const identityPath = path.resolve(file);
+    if (!fs.existsSync(identityPath)) throw new Error("The saved identity or invitation file was not found. Use the path printed during setup or upgrade.");
+    // JSON parse failures can contain private identity data. Keep them off stderr.
+    try { await showPairingCode(identityPath, true); }
+    catch { throw new Error("Could not display the pairing file. Choose a readable LePan identity or invitation JSON file."); }
+    return;
+  }
+  if (argumentsList.includes("--help") || argumentsList.includes("-h")) {
+    process.stdout.write(`Pairing help:
+  --show-qr FILE  Display a saved identity or invitation as a QR code.
+
+  Example:
+    ${pairingCommand} --show-qr '/path/to/lepan-pairing.json'
+
+Run pairing commands on the computer running Leither. If the QR does not fit,
+resize to the printed columns and rows and run --show-qr again.
+You can also open the saved PNG, or transfer the JSON privately to your phone
+and use LePan > Settings > Set up users > Choose identity file.
+
+Device identity files contain persistent private keys and have no ten-minute
+expiry. Keep the original safe and offline; delete transfer copies after pairing.
+Setup and reconnect invitations expire ten minutes after creation. Showing the
+QR again does not renew them. Use --household to renew an unclaimed first-owner
+invitation, or --recover-device ACCOUNT to reconnect an existing account.
+For another household device, use Settings > My devices on a paired phone.
+If a saved identity file is missing, restore your private backup or use the
+device-management options below.
+
+`);
+  }
   if (process.platform === "win32") {
     const installerPath = path.join(distributionDirectory, "lifedrive-install.ps1");
     if (![installerPath, bundlePath, checksumPath].every(candidate => fs.existsSync(candidate))) {

package/dist/lifedrive-bundle.tar.gz

@@ -1,4 +1,4 @@
 [diffend] Oversized file quarantined before diffing.
 name: package/dist/lifedrive-bundle.tar.gz
-size: 44302859 bytes
-sha256: e955159113a918b02b42273b28e52ab12357ddfc551f0e0b7bed7a0a0527a1d4
+size: 44304002 bytes
+sha256: 76ec5e8ea0f34c6a9b45b71765e0a6dbc5fc00e282396f946fccb5e9b83910d3

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

@@ -1 +1 @@
-e955159113a918b02b42273b28e52ab12357ddfc551f0e0b7bed7a0a0527a1d4  lifedrive-bundle.tar.gz
+76ec5e8ea0f34c6a9b45b71765e0a6dbc5fc00e282396f946fccb5e9b83910d3  lifedrive-bundle.tar.gz

package/dist/lifedrive-install.ps1

@@ -471,7 +471,15 @@ if ($Upgrade) {
         }
         throw
     }
+    Write-Host ""
+    Write-Host "------------------------------------------------------------"
     Write-Host "LePan Windows upgrade complete. Leither was not restarted."
+    Write-Host "Node: $([Environment]::MachineName)"
+    $pairingLauncher = if ($env:LIFEDRIVE_PAIRING_COMMAND) { $env:LIFEDRIVE_PAIRING_COMMAND } else { "npx --yes @inoku/lepan@latest" }
+    Write-Host "Saved pairing files, if retained: $root\.lifedrive-household\lepan-pairing-*.json (with matching .png images)."
+    Write-Host ""
+    Write-Host "Help:"
+    Write-Host "  $pairingLauncher --help"
     return
 }
 try {

package/dist/lifedrive-install.sh

@@ -32,15 +32,24 @@ Installer options:
   --household              Set up household users or renew an unclaimed setup invitation.
   --recover-device USER    Reconnect a phone to an existing account, using its name or user ID.
   --household-config FILE   Install mobile-led household setup using a private service configuration.
+  --add-device LABEL        Create a separate device identity (legacy browser-owner setup, Linux/macOS).
 
 Setup options are forwarded to lifeDrive-setup.sh. Common examples:
   --registry-url URL
   --publisher-key FILE
-  --add-device LABEL
   --identity-out FILE
   --list-devices
   --revoke-device UID
   --skip-domain
+
+Create an identity for another phone or browser:
+  npx --yes @inoku/lepan@latest --add-device "My iPhone"
+
+LABEL is a name you choose to recognize the device, such as "My iPhone".
+Each device gets its own key and can be revoked independently. The npm installer
+displays the new identity's QR code and file path for pairing.
+Run this command on the computer running Leither.
+For household accounts, invite another device from Settings > My devices on a paired phone.
 EOF
 }
 

package/package.json

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