francois 0.12.0-dev.9 → 0.13.0-dev.10

package/README.md

@@ -23,9 +23,12 @@ with your desktop.
 | **macOS** | the app bundle in `~/Applications` — Spotlight, Launchpad and the Dock all find it |
 | **Linux** | a `.desktop` launcher and icon under `~/.local/share` |
 
-All per-user: no administrator rights, no elevation prompt. `npm uninstall -g
-francois` removes them again, and `francois shortcut --remove` is the manual
-escape hatch.
+All per-user: no administrator rights, no elevation prompt. Run `francois
+uninstall` to remove them again — current npm (v7+) doesn't run the
+`preuninstall` hook a plain `npm uninstall -g francois` would need, so that
+alone leaves the app behind in `~/Applications` (or the Start Menu / `.desktop`
+entry). `francois shortcut --remove` unregisters just the desktop entry,
+without touching the npm package.
 
 ## Why install this way
 
@@ -54,6 +57,7 @@ Prebuilt for macOS (universal), Windows x64 and Linux x64. On anything else,
 | `francois --version` | print the app + package versions |
 | `francois shortcut` | re-register the desktop entry (after deleting it, or a headless install) |
 | `francois shortcut --remove` | unregister it |
+| `francois uninstall` | unregister the desktop entry, then remove the npm package — the supported way to uninstall |
 | `francois --help` | usage |
 
 Environment: `FRANCOIS_SKIP_DOWNLOAD=1` skips the postinstall download,

package/bin/francois.js

@@ -29,6 +29,7 @@ Usage
   francois --version           print the app + package versions
   francois shortcut            re-register the Start Menu / Launchpad / menu entry
   francois shortcut --remove   unregister it
+  francois uninstall           unregister the desktop entry, then npm-uninstall this package
   francois --help              this message
 
 Anything else is forwarded to the app.
@@ -95,6 +96,25 @@ function main() {
     return;
   }
 
+  // Current npm (v7+) never runs preuninstall/postuninstall for `npm uninstall
+  // -g` — a long-standing, unfixed npm regression — so uninstall.js's preuninstall
+  // hook (still useful under yarn/pnpm, which do honor it) cannot be relied on
+  // with npm. This is the reliable path: remove the desktop entry (and, on
+  // macOS, the ~/Applications bundle) while the install record still exists,
+  // THEN hand off to npm — after which the record and this very script are gone.
+  if (argv[0] === 'uninstall') {
+    const record = readInstallRecord();
+    if (record) {
+      desktop.remove(record);
+      process.stdout.write(`francois: removed the ${record.productName} shortcut.\n`);
+    }
+    const pkg = require('../package.json');
+    process.stdout.write('francois: removing the npm package…\n');
+    const npmCmd = process.platform === 'win32' ? 'npm.cmd' : 'npm';
+    const result = spawnSync(npmCmd, ['uninstall', '-g', pkg.name], { stdio: 'inherit' });
+    process.exit(result.status === null ? 1 : result.status);
+  }
+
   const executable = resolveExecutable();
   if (!executable) {
     if (!assetKey()) {

package/manifest.json

@@ -2,11 +2,11 @@
   "repo": "antoine-gmnz/francois",
   "tag": "dev",
   "channel": "dev",
-  "appVersion": "0.12.0",
+  "appVersion": "0.13.0",
   "productName": "Francois Dev",
   "assets": {
-    "darwin-universal": { "name": "francois-darwin-universal.tar.gz", "sha256": "7bd79eeb0627034d78918301fa9a97b075bf65b662d03693ef610328d0d195b5" },
-    "linux-x64": { "name": "francois-linux-x64.tar.gz", "sha256": "2d0282446db9d13cb12dd9e268265e72b18373811edb51fd9d641a0671e4036c" },
-    "win32-x64": { "name": "francois-win32-x64.zip", "sha256": "1ae55c7b18b4f216fb4cf86436d06e4e351a3dc43c500a8bb623e4e38109e0df" }
+    "darwin-universal": { "name": "francois-darwin-universal.tar.gz", "sha256": "48e9909027ca0cd10e64ecf8ed4fa9f6a7807904bc326d6f5ae7184d6998b877" },
+    "linux-x64": { "name": "francois-linux-x64.tar.gz", "sha256": "d14bcce1a61bed460bbd0c065e21a97962031e34b25db4de41b01e9cc779c77e" },
+    "win32-x64": { "name": "francois-win32-x64.zip", "sha256": "9234fbf1805b5657e82a9ce5dcd2b2f797813e51887ce479fd6246bab6e656bd" }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "francois",
-  "version": "0.12.0-dev.9",
+  "version": "0.13.0-dev.10",
   "description": "Mission control for your Claude Code fleet — installs the Francois desktop app without an installer.",
   "license": "AGPL-3.0-only",
   "author": "Antoine Gimenez",

package/uninstall.js

@@ -2,15 +2,18 @@
 'use strict';
 
 /**
- * preuninstall — unregister the desktop integration before npm deletes the
- * package directory.
+ * preuninstall — unregister the desktop integration before the package
+ * directory is deleted.
  *
  * This matters most on macOS, where the .app was moved out to ~/Applications and
- * would otherwise survive `npm uninstall -g francois` as an orphan.
+ * would otherwise survive an uninstall as an orphan.
  *
- * npm's uninstall lifecycle does not fire in every situation (a manually deleted
- * global folder, some CI teardowns), so `francois shortcut --remove` exists as
- * the explicit escape hatch. Never fails the uninstall.
+ * Current npm (v7+) never actually runs this — a long-standing, unfixed
+ * regression where `npm uninstall -g` skips preuninstall/postuninstall
+ * entirely — so `francois uninstall` (bin/francois.js) is the command that
+ * reliably does this cleanup with npm. This script still earns its keep under
+ * package managers that do honor the hook (yarn, pnpm). Never fails the
+ * uninstall either way.
  */
 
 const desktop = require('./lib/desktop.js');