tide-commander 1.98.0 → 1.99.0

package/dist/assets/{web-C4LpSGoH.js → web-BHmmnvF7.js}

@@ -1 +1 @@
-import{ck as a}from"./main-XbhAPjbi.js";import{ImpactStyle as i,NotificationType as r}from"./index-Cirz97EK.js";import"./vendor-react--Eh9ivFN.js";import"./vendor-three-Chj50gSY.js";class h extends a{constructor(){super(...arguments),this.selectionStarted=!1}async impact(t){const e=this.patternForImpact(t==null?void 0:t.style);this.vibrateWithPattern(e)}async notification(t){const e=this.patternForNotification(t==null?void 0:t.type);this.vibrateWithPattern(e)}async vibrate(t){const e=(t==null?void 0:t.duration)||300;this.vibrateWithPattern([e])}async selectionStart(){this.selectionStarted=!0}async selectionChanged(){this.selectionStarted&&this.vibrateWithPattern([70])}async selectionEnd(){this.selectionStarted=!1}patternForImpact(t=i.Heavy){return t===i.Medium?[43]:t===i.Light?[20]:[61]}patternForNotification(t=r.Success){return t===r.Warning?[30,40,30,50,60]:t===r.Error?[27,45,50]:[35,65,21]}vibrateWithPattern(t){if(navigator.vibrate)navigator.vibrate(t);else throw this.unavailable("Browser does not support the vibrate API")}}export{h as HapticsWeb};
+import{ck as a}from"./main-B7wf_xU_.js";import{ImpactStyle as i,NotificationType as r}from"./index-B-ttQFx4.js";import"./vendor-react--Eh9ivFN.js";import"./vendor-three-Chj50gSY.js";class h extends a{constructor(){super(...arguments),this.selectionStarted=!1}async impact(t){const e=this.patternForImpact(t==null?void 0:t.style);this.vibrateWithPattern(e)}async notification(t){const e=this.patternForNotification(t==null?void 0:t.type);this.vibrateWithPattern(e)}async vibrate(t){const e=(t==null?void 0:t.duration)||300;this.vibrateWithPattern([e])}async selectionStart(){this.selectionStarted=!0}async selectionChanged(){this.selectionStarted&&this.vibrateWithPattern([70])}async selectionEnd(){this.selectionStarted=!1}patternForImpact(t=i.Heavy){return t===i.Medium?[43]:t===i.Light?[20]:[61]}patternForNotification(t=r.Success){return t===r.Warning?[30,40,30,50,60]:t===r.Error?[27,45,50]:[35,65,21]}vibrateWithPattern(t){if(navigator.vibrate)navigator.vibrate(t);else throw this.unavailable("Browser does not support the vibrate API")}}export{h as HapticsWeb};

package/dist/assets/{web-CaPUSaID.js → web-IGuhG0xr.js}

@@ -1 +1 @@
-import{ck as s}from"./main-XbhAPjbi.js";import"./vendor-react--Eh9ivFN.js";import"./vendor-three-Chj50gSY.js";class l extends s{constructor(){super(...arguments),this.pending=[],this.deliveredNotifications=[],this.hasNotificationSupport=()=>{if(!("Notification"in window)||!Notification.requestPermission)return!1;if(Notification.permission!=="granted")try{new Notification("")}catch(i){if(i instanceof Error&&i.name==="TypeError")return!1}return!0}}async getDeliveredNotifications(){const i=[];for(const t of this.deliveredNotifications){const e={title:t.title,id:parseInt(t.tag),body:t.body};i.push(e)}return{notifications:i}}async removeDeliveredNotifications(i){for(const t of i.notifications){const e=this.deliveredNotifications.find(n=>n.tag===String(t.id));e==null||e.close(),this.deliveredNotifications=this.deliveredNotifications.filter(()=>!e)}}async removeAllDeliveredNotifications(){for(const i of this.deliveredNotifications)i.close();this.deliveredNotifications=[]}async createChannel(){throw this.unimplemented("Not implemented on web.")}async deleteChannel(){throw this.unimplemented("Not implemented on web.")}async listChannels(){throw this.unimplemented("Not implemented on web.")}async schedule(i){if(!this.hasNotificationSupport())throw this.unavailable("Notifications not supported in this browser.");for(const t of i.notifications)this.sendNotification(t);return{notifications:i.notifications.map(t=>({id:t.id}))}}async getPending(){return{notifications:this.pending}}async registerActionTypes(){throw this.unimplemented("Not implemented on web.")}async cancel(i){this.pending=this.pending.filter(t=>!i.notifications.find(e=>e.id===t.id))}async areEnabled(){const{display:i}=await this.checkPermissions();return{value:i==="granted"}}async changeExactNotificationSetting(){throw this.unimplemented("Not implemented on web.")}async checkExactNotificationSetting(){throw this.unimplemented("Not implemented on web.")}async requestPermissions(){if(!this.hasNotificationSupport())throw this.unavailable("Notifications not supported in this browser.");return{display:this.transformNotificationPermission(await Notification.requestPermission())}}async checkPermissions(){if(!this.hasNotificationSupport())throw this.unavailable("Notifications not supported in this browser.");return{display:this.transformNotificationPermission(Notification.permission)}}transformNotificationPermission(i){switch(i){case"granted":return"granted";case"denied":return"denied";default:return"prompt"}}sendPending(){var i;const t=[],e=new Date().getTime();for(const n of this.pending)!((i=n.schedule)===null||i===void 0)&&i.at&&n.schedule.at.getTime()<=e&&(this.buildNotification(n),t.push(n));this.pending=this.pending.filter(n=>!t.find(o=>o===n))}sendNotification(i){var t;if(!((t=i.schedule)===null||t===void 0)&&t.at){const e=i.schedule.at.getTime()-new Date().getTime();this.pending.push(i),setTimeout(()=>{this.sendPending()},e);return}this.buildNotification(i)}buildNotification(i){const t=new Notification(i.title,{body:i.body,tag:String(i.id)});return t.addEventListener("click",this.onClick.bind(this,i),!1),t.addEventListener("show",this.onShow.bind(this,i),!1),t.addEventListener("close",()=>{this.deliveredNotifications=this.deliveredNotifications.filter(()=>!this)},!1),this.deliveredNotifications.push(t),t}onClick(i){const t={actionId:"tap",notification:i};this.notifyListeners("localNotificationActionPerformed",t)}onShow(i){this.notifyListeners("localNotificationReceived",i)}}export{l as LocalNotificationsWeb};
+import{ck as s}from"./main-B7wf_xU_.js";import"./vendor-react--Eh9ivFN.js";import"./vendor-three-Chj50gSY.js";class l extends s{constructor(){super(...arguments),this.pending=[],this.deliveredNotifications=[],this.hasNotificationSupport=()=>{if(!("Notification"in window)||!Notification.requestPermission)return!1;if(Notification.permission!=="granted")try{new Notification("")}catch(i){if(i instanceof Error&&i.name==="TypeError")return!1}return!0}}async getDeliveredNotifications(){const i=[];for(const t of this.deliveredNotifications){const e={title:t.title,id:parseInt(t.tag),body:t.body};i.push(e)}return{notifications:i}}async removeDeliveredNotifications(i){for(const t of i.notifications){const e=this.deliveredNotifications.find(n=>n.tag===String(t.id));e==null||e.close(),this.deliveredNotifications=this.deliveredNotifications.filter(()=>!e)}}async removeAllDeliveredNotifications(){for(const i of this.deliveredNotifications)i.close();this.deliveredNotifications=[]}async createChannel(){throw this.unimplemented("Not implemented on web.")}async deleteChannel(){throw this.unimplemented("Not implemented on web.")}async listChannels(){throw this.unimplemented("Not implemented on web.")}async schedule(i){if(!this.hasNotificationSupport())throw this.unavailable("Notifications not supported in this browser.");for(const t of i.notifications)this.sendNotification(t);return{notifications:i.notifications.map(t=>({id:t.id}))}}async getPending(){return{notifications:this.pending}}async registerActionTypes(){throw this.unimplemented("Not implemented on web.")}async cancel(i){this.pending=this.pending.filter(t=>!i.notifications.find(e=>e.id===t.id))}async areEnabled(){const{display:i}=await this.checkPermissions();return{value:i==="granted"}}async changeExactNotificationSetting(){throw this.unimplemented("Not implemented on web.")}async checkExactNotificationSetting(){throw this.unimplemented("Not implemented on web.")}async requestPermissions(){if(!this.hasNotificationSupport())throw this.unavailable("Notifications not supported in this browser.");return{display:this.transformNotificationPermission(await Notification.requestPermission())}}async checkPermissions(){if(!this.hasNotificationSupport())throw this.unavailable("Notifications not supported in this browser.");return{display:this.transformNotificationPermission(Notification.permission)}}transformNotificationPermission(i){switch(i){case"granted":return"granted";case"denied":return"denied";default:return"prompt"}}sendPending(){var i;const t=[],e=new Date().getTime();for(const n of this.pending)!((i=n.schedule)===null||i===void 0)&&i.at&&n.schedule.at.getTime()<=e&&(this.buildNotification(n),t.push(n));this.pending=this.pending.filter(n=>!t.find(o=>o===n))}sendNotification(i){var t;if(!((t=i.schedule)===null||t===void 0)&&t.at){const e=i.schedule.at.getTime()-new Date().getTime();this.pending.push(i),setTimeout(()=>{this.sendPending()},e);return}this.buildNotification(i)}buildNotification(i){const t=new Notification(i.title,{body:i.body,tag:String(i.id)});return t.addEventListener("click",this.onClick.bind(this,i),!1),t.addEventListener("show",this.onShow.bind(this,i),!1),t.addEventListener("close",()=>{this.deliveredNotifications=this.deliveredNotifications.filter(()=>!this)},!1),this.deliveredNotifications.push(t),t}onClick(i){const t={actionId:"tap",notification:i};this.notifyListeners("localNotificationActionPerformed",t)}onShow(i){this.notifyListeners("localNotificationReceived",i)}}export{l as LocalNotificationsWeb};

package/dist/assets/{web-C-JnApw7.js → web-SOehUGgT.js}

@@ -1 +1 @@
-import{ck as t}from"./main-XbhAPjbi.js";import"./vendor-react--Eh9ivFN.js";import"./vendor-three-Chj50gSY.js";class o extends t{constructor(){super(),this.handleVisibilityChange=()=>{const e={isActive:document.hidden!==!0};this.notifyListeners("appStateChange",e),document.hidden?this.notifyListeners("pause",null):this.notifyListeners("resume",null)},document.addEventListener("visibilitychange",this.handleVisibilityChange,!1)}exitApp(){throw this.unimplemented("Not implemented on web.")}async getInfo(){throw this.unimplemented("Not implemented on web.")}async getLaunchUrl(){return{url:""}}async getState(){return{isActive:document.hidden!==!0}}async minimizeApp(){throw this.unimplemented("Not implemented on web.")}async toggleBackButtonHandler(){throw this.unimplemented("Not implemented on web.")}async getAppLanguage(){return{value:navigator.language.split("-")[0].toLowerCase()}}}export{o as AppWeb};
+import{ck as t}from"./main-B7wf_xU_.js";import"./vendor-react--Eh9ivFN.js";import"./vendor-three-Chj50gSY.js";class o extends t{constructor(){super(),this.handleVisibilityChange=()=>{const e={isActive:document.hidden!==!0};this.notifyListeners("appStateChange",e),document.hidden?this.notifyListeners("pause",null):this.notifyListeners("resume",null)},document.addEventListener("visibilitychange",this.handleVisibilityChange,!1)}exitApp(){throw this.unimplemented("Not implemented on web.")}async getInfo(){throw this.unimplemented("Not implemented on web.")}async getLaunchUrl(){return{url:""}}async getState(){return{isActive:document.hidden!==!0}}async minimizeApp(){throw this.unimplemented("Not implemented on web.")}async toggleBackButtonHandler(){throw this.unimplemented("Not implemented on web.")}async getAppLanguage(){return{value:navigator.language.split("-")[0].toLowerCase()}}}export{o as AppWeb};

package/dist/index.html

@@ -22,10 +22,10 @@
     <link rel="icon" type="image/png" sizes="16x16" href="/assets/icons/favicon-16x16.png" />
     <link rel="apple-touch-icon" sizes="180x180" href="/assets/icons/apple-touch-icon.png" />
     <title>Tide Commander</title>
-    <script type="module" crossorigin src="/assets/main-XbhAPjbi.js"></script>
+    <script type="module" crossorigin src="/assets/main-B7wf_xU_.js"></script>
     <link rel="modulepreload" crossorigin href="/assets/vendor-react--Eh9ivFN.js">
     <link rel="modulepreload" crossorigin href="/assets/vendor-three-Chj50gSY.js">
-    <link rel="stylesheet" crossorigin href="/assets/main-CD03IZnY.css">
+    <link rel="stylesheet" crossorigin href="/assets/main-DLzFxLC1.css">
   </head>
   <body>
     <div id="app"></div>

package/dist/locales/en/config.json

@@ -541,7 +541,22 @@
     "principle4": "Transparent agent communication",
     "specialThanks": "Special Thanks",
     "kenneyCredit": "for the agent character models",
-    "claudeCodeCredit": "by Anthropic, the AI backbone"
+    "claudeCodeCredit": "by Anthropic, the AI backbone",
+    "autoUpdateTitle": "Auto-update",
+    "autoUpdateButton": "Update now",
+    "autoUpdateRunning": "Installing update...",
+    "autoUpdateConfirmTitle": "Update Tide Commander?",
+    "autoUpdateConfirmBody": "This will run npm install -g tide-commander@latest and then close the server. You will need to relaunch tide-commander from your terminal.",
+    "autoUpdateConfirm": "Yes, update",
+    "autoUpdateCancel": "Cancel",
+    "autoUpdateClose": "Close",
+    "autoUpdateOutput": "Install log",
+    "autoUpdateSuccess": "Update installed.",
+    "autoUpdateRestartHint": "Please restart Tide Commander from your terminal (run: tide-commander).",
+    "autoUpdateFailed": "Update failed.",
+    "autoUpdateDevMode": "Auto-update is unavailable in dev mode.",
+    "autoUpdateManualCommand": "Run this in your terminal to update manually:",
+    "autoUpdatePackageManagerNotice": "Auto-update only supports npm-installed globals. Detected: {{pm}}."
   },
   "shortcuts": {
     "pressKeys": "Press keys...",

package/dist/src/packages/server/routes/index.js

@@ -27,6 +27,7 @@ import sessionsRouter from './sessions.js';
 import databaseRouter from './database.js';
 import buildingsRouter, { setBroadcast as setBuildingsBroadcast } from './buildings.js';
 import skillsRouter, { setBroadcast as setSkillsBroadcast } from './skills.js';
+import systemRouter from './system.js';
 import { getPlugins } from '../integrations/integration-registry.js';
 const router = Router();
 // Health check
@@ -55,6 +56,7 @@ router.use('/sessions', sessionsRouter);
 router.use('/database', databaseRouter);
 router.use('/buildings', buildingsRouter);
 router.use('/skills', skillsRouter);
+router.use('/system', systemRouter);
 // Integration plugin routes (e.g. /api/slack/*, /api/documents/*, /api/jira/*)
 // Uses lazy lookup so plugins can be registered after route setup
 router.use((req, res, next) => {

package/dist/src/packages/server/routes/system.js

@@ -0,0 +1,156 @@
+/**
+ * System Routes
+ * Endpoints for inspecting / updating the running Tide Commander install.
+ */
+import { Router } from 'express';
+import { createLogger } from '../utils/logger.js';
+import { fetchLatestNpmVersion, getVersionRelation } from '../../shared/version.js';
+import { getInstallInfo, isAutoUpdateSupported, runNpmGlobalUpdate, } from '../services/self-update-service.js';
+const log = createLogger('SystemRoutes');
+const router = Router();
+const PACKAGE_NAME = 'tide-commander';
+// Guard: only one self-update may run at a time
+let updateInProgress = false;
+/**
+ * GET /api/system/install-info
+ *
+ * Returns enough info for the UI to decide whether to render the "Update now"
+ * button and which command to suggest if auto-update isn't supported.
+ */
+router.get('/install-info', async (_req, res) => {
+    try {
+        const info = getInstallInfo();
+        const latestVersion = await fetchLatestNpmVersion(PACKAGE_NAME);
+        const relation = latestVersion
+            ? getVersionRelation(info.currentVersion, latestVersion)
+            : 'unknown';
+        const updateAvailable = relation === 'behind';
+        res.json({
+            isGlobalInstall: info.isGlobalInstall,
+            packageManager: info.packageManager,
+            installRoot: info.installRoot,
+            currentVersion: info.currentVersion,
+            latestVersion,
+            updateAvailable,
+            autoUpdateSupported: isAutoUpdateSupported(info),
+            suggestedManualCommand: info.suggestedManualCommand,
+            reason: info.reason,
+            updateInProgress,
+        });
+    }
+    catch (err) {
+        const message = err.message;
+        log.error(`Failed to get install info: ${message}`);
+        res.status(500).json({ error: message });
+    }
+});
+/**
+ * POST /api/system/self-update
+ *
+ * Streams the output of `npm install -g tide-commander@latest` via SSE.
+ *
+ * SSE events:
+ *   - start    { message }
+ *   - stdout   { chunk }
+ *   - stderr   { chunk }
+ *   - done     { success, exitCode, newVersion, requiresRestart }
+ *   - error    { message, permissionDenied, suggestedManualCommand }
+ *
+ * On success the server schedules its own exit so the next launch picks up
+ * the new binary. The user must relaunch tide-commander manually.
+ */
+router.post('/self-update', async (_req, res) => {
+    const info = getInstallInfo();
+    if (!info.isGlobalInstall) {
+        res.status(400).json({
+            error: 'Auto-update is only available when running from a global install.',
+            reason: info.reason,
+        });
+        return;
+    }
+    if (!isAutoUpdateSupported(info)) {
+        res.status(400).json({
+            error: `Auto-update is not supported for package manager: ${info.packageManager}`,
+            suggestedManualCommand: info.suggestedManualCommand,
+        });
+        return;
+    }
+    if (updateInProgress) {
+        res.status(409).json({ error: 'An update is already in progress.' });
+        return;
+    }
+    updateInProgress = true;
+    res.setHeader('Content-Type', 'text/event-stream');
+    res.setHeader('Cache-Control', 'no-cache, no-transform');
+    res.setHeader('Connection', 'keep-alive');
+    res.setHeader('X-Accel-Buffering', 'no');
+    res.flushHeaders?.();
+    const send = (event, data) => {
+        res.write(`event: ${event}\n`);
+        res.write(`data: ${JSON.stringify(data)}\n\n`);
+    };
+    // Keepalive comment every 15s in case the install takes a while
+    const keepalive = setInterval(() => {
+        try {
+            res.write(`: keepalive ${Date.now()}\n\n`);
+        }
+        catch {
+            // socket closed
+        }
+    }, 15000);
+    send('start', { message: `Running npm install -g ${PACKAGE_NAME}@latest...` });
+    try {
+        const result = await runNpmGlobalUpdate({
+            onStdout: (chunk) => send('stdout', { chunk }),
+            onStderr: (chunk) => send('stderr', { chunk }),
+        });
+        clearInterval(keepalive);
+        if (result.exitCode === 0) {
+            const newVersion = (await fetchLatestNpmVersion(PACKAGE_NAME)) ?? null;
+            send('done', {
+                success: true,
+                exitCode: 0,
+                newVersion,
+                requiresRestart: true,
+                message: 'Update installed. Please restart Tide Commander from your terminal.',
+            });
+            res.end();
+            // Give the client ~1.5s to render the success message before we exit.
+            // The user must manually restart with `tide-commander` from the terminal.
+            log.log('Update succeeded — scheduling server exit in 1500ms to release the old binary.');
+            setTimeout(() => {
+                log.log('Exiting after successful update. Restart manually with: tide-commander');
+                process.exit(0);
+            }, 1500);
+        }
+        else {
+            const errMsg = result.permissionDenied
+                ? 'Permission denied while installing globally. Re-run from a terminal with the appropriate permissions (e.g. sudo npm install -g tide-commander@latest), or fix your npm prefix to a user-owned directory.'
+                : `npm install exited with code ${result.exitCode}.`;
+            send('error', {
+                message: errMsg,
+                exitCode: result.exitCode,
+                permissionDenied: result.permissionDenied,
+                suggestedManualCommand: info.suggestedManualCommand,
+            });
+            send('done', {
+                success: false,
+                exitCode: result.exitCode,
+                newVersion: null,
+                requiresRestart: false,
+            });
+            res.end();
+            updateInProgress = false;
+        }
+    }
+    catch (err) {
+        clearInterval(keepalive);
+        const message = err.message;
+        log.error(`Self-update failed: ${message}`);
+        send('error', { message, permissionDenied: false, suggestedManualCommand: info.suggestedManualCommand });
+        send('done', { success: false, exitCode: -1, newVersion: null, requiresRestart: false });
+        res.end();
+        updateInProgress = false;
+    }
+});
+export default router;

package/dist/src/packages/server/services/self-update-service.js

@@ -0,0 +1,191 @@
+/**
+ * Self-Update Service
+ *
+ * Detects how Tide Commander was installed (global npm/pnpm/yarn/bun vs dev mode)
+ * and runs `npm install -g tide-commander@latest` when invoked from the UI.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { spawn } from 'child_process';
+import { fileURLToPath } from 'url';
+import { createLogger } from '../utils/logger.js';
+const log = createLogger('SelfUpdate');
+function readPackageJson(dir) {
+    try {
+        const raw = fs.readFileSync(path.join(dir, 'package.json'), 'utf8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+function detectPackageManager(installRoot) {
+    const lower = installRoot.toLowerCase();
+    // Bun: ~/.bun/install/global/node_modules/tide-commander/
+    if (lower.includes(`${path.sep}.bun${path.sep}install${path.sep}global${path.sep}`) || lower.includes(`${path.sep}.bun${path.sep}`)) {
+        return { pm: 'bun', suggested: 'bun add -g tide-commander@latest' };
+    }
+    // Pnpm:
+    //   ~/.local/share/pnpm/global/<N>/node_modules/tide-commander/
+    //   ~/Library/pnpm/global/...
+    //   ~/.pnpm/global/...
+    if (lower.includes(`${path.sep}pnpm${path.sep}global${path.sep}`) || lower.includes(`${path.sep}.pnpm${path.sep}`)) {
+        return { pm: 'pnpm', suggested: 'pnpm add -g tide-commander@latest' };
+    }
+    // Yarn:
+    //   ~/.config/yarn/global/node_modules/tide-commander/
+    //   ~/.yarn/global/...
+    if (lower.includes(`${path.sep}yarn${path.sep}global${path.sep}`) || lower.includes(`${path.sep}.yarn${path.sep}`)) {
+        return { pm: 'yarn', suggested: 'yarn global add tide-commander@latest' };
+    }
+    // npm — global prefix typically ends in /lib/node_modules/tide-commander
+    // Works for system npm, nvm, asdf, volta, fnm, npm config prefix overrides.
+    if (lower.includes(`${path.sep}lib${path.sep}node_modules${path.sep}`)) {
+        return { pm: 'npm', suggested: 'npm install -g tide-commander@latest' };
+    }
+    // Some Windows / non-standard prefixes don't have /lib — fall back to npm
+    return { pm: 'npm', suggested: 'npm install -g tide-commander@latest' };
+}
+/**
+ * Locate the tide-commander package root on disk (the dir whose package.json
+ * has name === "tide-commander"). Returns null if it can't be determined.
+ */
+export function locateInstallRoot() {
+    try {
+        const here = path.dirname(fileURLToPath(import.meta.url));
+        // Walk up looking for the nearest package.json named "tide-commander"
+        let current = here;
+        while (current !== path.dirname(current)) {
+            const pkgPath = path.join(current, 'package.json');
+            if (fs.existsSync(pkgPath)) {
+                const pkg = readPackageJson(current);
+                if (pkg?.name === 'tide-commander') {
+                    return current;
+                }
+            }
+            current = path.dirname(current);
+        }
+    }
+    catch (err) {
+        log.error(`Failed to locate install root: ${err.message}`);
+    }
+    return null;
+}
+/**
+ * Returns true when the install root looks like a global npm-style install
+ * (lives under a node_modules directory) AND is not the dev/repo checkout
+ * (no .git/ at the package root).
+ */
+function isGlobalInstallPath(installRoot) {
+    const parent = path.dirname(installRoot);
+    const insideNodeModules = path.basename(parent) === 'node_modules';
+    const hasGitDir = fs.existsSync(path.join(installRoot, '.git'));
+    if (hasGitDir) {
+        return { isGlobal: false, reason: 'Install root contains .git/ — running from a repo checkout (dev mode).' };
+    }
+    if (!insideNodeModules) {
+        return { isGlobal: false, reason: 'Install root is not inside a node_modules directory — running from source.' };
+    }
+    return { isGlobal: true, reason: 'Install root lives under node_modules — looks like a global install.' };
+}
+/**
+ * Build the full install info snapshot used by the UI.
+ */
+export function getInstallInfo() {
+    const installRoot = locateInstallRoot();
+    if (!installRoot) {
+        return {
+            isGlobalInstall: false,
+            packageManager: 'unknown',
+            installRoot: null,
+            currentVersion: 'unknown',
+            suggestedManualCommand: null,
+            reason: 'Could not locate tide-commander package root on disk.',
+        };
+    }
+    const pkg = readPackageJson(installRoot);
+    const currentVersion = pkg?.version ?? 'unknown';
+    const { isGlobal, reason } = isGlobalInstallPath(installRoot);
+    if (!isGlobal) {
+        return {
+            isGlobalInstall: false,
+            packageManager: 'unknown',
+            installRoot,
+            currentVersion,
+            suggestedManualCommand: null,
+            reason,
+        };
+    }
+    const { pm, suggested } = detectPackageManager(installRoot);
+    return {
+        isGlobalInstall: true,
+        packageManager: pm,
+        installRoot,
+        currentVersion,
+        suggestedManualCommand: suggested,
+        reason,
+    };
+}
+/**
+ * Whether the current install can be auto-updated by this server.
+ * Right now only npm-style globals are supported.
+ */
+export function isAutoUpdateSupported(info = getInstallInfo()) {
+    return info.isGlobalInstall && info.packageManager === 'npm';
+}
+/**
+ * Run `npm install -g tide-commander@latest`. Streams stdout/stderr via callbacks.
+ * Never throws; always resolves with the captured output and exit code.
+ */
+export function runNpmGlobalUpdate(callbacks = {}) {
+    return new Promise((resolve) => {
+        const args = ['install', '-g', 'tide-commander@latest'];
+        // Disable npm fund/audit output noise to keep the log readable
+        const env = {
+            ...process.env,
+            npm_config_fund: 'false',
+            npm_config_audit: 'false',
+            npm_config_progress: 'false',
+        };
+        log.log(`Running: npm ${args.join(' ')}`);
+        const child = spawn('npm', args, {
+            env,
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        let stdout = '';
+        let stderr = '';
+        child.stdout?.on('data', (buf) => {
+            const text = buf.toString('utf8');
+            stdout += text;
+            callbacks.onStdout?.(text);
+        });
+        child.stderr?.on('data', (buf) => {
+            const text = buf.toString('utf8');
+            stderr += text;
+            callbacks.onStderr?.(text);
+        });
+        child.on('error', (err) => {
+            const message = `Failed to spawn npm: ${err.message}\n`;
+            stderr += message;
+            callbacks.onStderr?.(message);
+            resolve({
+                exitCode: -1,
+                signal: null,
+                stdout,
+                stderr,
+                permissionDenied: /eacces|eperm|permission/i.test(message),
+            });
+        });
+        child.on('close', (code, signal) => {
+            const combined = `${stdout}\n${stderr}`;
+            const permissionDenied = /EACCES|EPERM|permission denied/i.test(combined);
+            resolve({
+                exitCode: code,
+                signal,
+                stdout,
+                stderr,
+                permissionDenied,
+            });
+        });
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tide-commander",
-  "version": "1.98.0",
+  "version": "1.99.0",
   "description": "Visual multi-agent orchestrator and manager for Claude Code with 3D/2D interface",
   "repository": {
     "type": "git",