phewsh 0.15.37 → 0.15.38

package/bin/phewsh.js

@@ -144,8 +144,20 @@ function checkForUpdates() {
           newer[1] !== current[1] ? newer[1] > current[1] :
           newer[2] > current[2];
         if (isNewer) {
-          console.log(g(`\n  Update available: ${pkg.version} → ${data.version}`));
-          console.log(g(`  Run: phewsh update\n`));
+          // Auto-update is opt-in (phewsh update auto on). When on, we update
+          // in the background — never blocking this session, never prompting —
+          // so the NEXT launch is current. When off, we just point the way.
+          let auto = false;
+          try { auto = require('../commands/update').autoUpdateEnabled(); } catch { /* default off */ }
+          if (auto) {
+            let started = false;
+            try { started = require('../commands/update').backgroundUpdate(pkg.name); } catch { /* best-effort */ }
+            if (started) console.log(g(`\n  ↻ Updating phewsh ${pkg.version} → ${data.version} in the background — next launch uses it.\n`));
+            else console.log(g(`\n  Update available: ${pkg.version} → ${data.version}\n  Run: phewsh update\n`));
+          } else {
+            console.log(g(`\n  Update available: ${pkg.version} → ${data.version}`));
+            console.log(g(`  Run: phewsh update  ${'\x1b[2m'}(or 'phewsh update auto on' to always stay current)${'\x1b[0m'}\n`));
+          }
         }
       }
     })

package/commands/update.js

@@ -1,10 +1,17 @@
 // phewsh update — update the CLI to the latest published version.
 //
 // Usage:
-//   phewsh update           Check npm and install the latest version
-//   phewsh update --check   Just compare versions, don't install
+//   phewsh update            Check npm and install the latest version
+//   phewsh update --check    Just compare versions, don't install
+//   phewsh update auto on    Always auto-update in the background on launch
+//   phewsh update auto off   Back to notify-only (the default)
 
 const { spawn } = require('child_process');
+const path = require('path');
+const os = require('os');
+const configFile = require('../lib/config-file');
+
+const CONFIG_PATH = path.join(os.homedir(), '.phewsh', 'config.json');
 
 const b = (s) => `\x1b[1m${s}\x1b[0m`;
 const w = (s) => `\x1b[97m${s}\x1b[0m`;
@@ -12,6 +19,31 @@ const g = (s) => `\x1b[38;5;247m${s}\x1b[0m`;
 const green = (s) => `\x1b[32m${s}\x1b[0m`;
 const yellow = (s) => `\x1b[33m${s}\x1b[0m`;
 
+// Read/write the autoUpdate preference. Default: false (notify-only) — we never
+// mutate a user's global binary without their say-so (the ambient ethos).
+function autoUpdateEnabled() {
+  const c = configFile.loadConfig(CONFIG_PATH, {}) || {};
+  return c.autoUpdate === true;
+}
+function setAutoUpdate(on) {
+  const c = configFile.loadConfig(CONFIG_PATH, {}) || {};
+  c.autoUpdate = !!on;
+  configFile.saveConfig(CONFIG_PATH, c);
+}
+
+// Background, non-blocking update — used on launch when autoUpdate is on. Never
+// waits, never prompts; if it fails (e.g. needs sudo) the next launch retries
+// and the notify line still shows. Detached so it outlives this process.
+function backgroundUpdate(pkgName) {
+  try {
+    const child = spawn('npm', ['install', '-g', `${pkgName}@latest`], {
+      stdio: 'ignore', detached: true,
+    });
+    child.unref();
+    return true;
+  } catch { return false; }
+}
+
 function isNewer(latest, current) {
   const l = latest.split('.').map(Number);
   const c = current.split('.').map(Number);
@@ -19,9 +51,27 @@ function isNewer(latest, current) {
 }
 
 async function main() {
-  const checkOnly = process.argv.includes('--check');
   const pkg = require('../package.json');
 
+  // `phewsh update auto on|off` — toggle background auto-update on launch.
+  if (process.argv[3] === 'auto') {
+    const choice = (process.argv[4] || '').toLowerCase();
+    console.log('');
+    if (choice === 'on') {
+      setAutoUpdate(true);
+      console.log(`  ${green('✓')} ${w('Auto-update on.')} ${g('phewsh will update itself in the background when a new version ships.')}`);
+    } else if (choice === 'off') {
+      setAutoUpdate(false);
+      console.log(`  ${green('✓')} ${w('Auto-update off.')} ${g('Back to notify-only — run')} ${w('phewsh update')} ${g('when you want it.')}`);
+    } else {
+      console.log(`  ${g('Auto-update is')} ${autoUpdateEnabled() ? green('on') : yellow('off')}${g('.')} ${g('Toggle:')} ${w('phewsh update auto on')} ${g('/')} ${w('phewsh update auto off')}`);
+    }
+    console.log('');
+    return;
+  }
+
+  const checkOnly = process.argv.includes('--check');
+
   console.log('');
   console.log(`  ${b(w('phewsh update'))}`);
   console.log('');
@@ -77,3 +127,5 @@ async function main() {
 }
 
 module.exports = main;
+module.exports.autoUpdateEnabled = autoUpdateEnabled;
+module.exports.backgroundUpdate = backgroundUpdate;

package/lib/suggest.js

@@ -118,14 +118,17 @@ function suggestAll(s = {}) {
     });
   }
 
-  // 5. Ambient off — continuity that costs nothing once turned on.
-  if (hasIntentDir && !ambientOn && installedHarnesses.includes('claude-code')) {
+  // 5. Ambient off — the highest-leverage thing a new user can turn on. Once
+  // on, every AI tool here inherits the brief + 😮‍💨🤫 signature without ever
+  // launching phewsh. Fires for any installed harness now (not just Claude
+  // Code), since non-Claude tools get it via their synced + global base files.
+  if (!ambientOn && installedHarnesses.length > 0) {
     out.push({
       id: 'enable-ambient',
-      priority: 50,
-      message: `Ambient is off — Claude Code sessions here won't get the brief unless you launch phewsh.`,
-      command: 'phewsh ambient',
-      why: 'Installs a silent SessionStart hook so continuity travels even when you forget phewsh.',
+      priority: 78,
+      message: `Ambient is off — turn it on so every AI tool here gets the phewsh brief + 😮‍💨🤫 signature, even when you don't launch phewsh.`,
+      command: 'phewsh ambient on',
+      why: 'One reversible setup: a Claude Code hook + a marked block in each tool\'s context file. Undo anytime with `phewsh ambient off`.',
     });
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "phewsh",
-  "version": "0.15.37",
+  "version": "0.15.38",
   "description": "Turn intent into action. Structure your thinking, execute your next step.",
   "bin": {
     "phewsh": "bin/phewsh.js"