editmamei 0.18.0 → 0.19.0

package/dist/cli/config.js

@@ -43,6 +43,13 @@ const KEYS = {
         },
         coerce: coercePath,
     },
+    update_check: {
+        get: (s) => s.update_check,
+        set: (s, v) => {
+            s.update_check = v;
+        },
+        coerce: coerceBool,
+    },
 };
 function knownKeysHint() {
     return `Known keys:\n${Object.keys(KEYS)

package/dist/core/server.js

@@ -9,8 +9,9 @@ import { EDITION } from '../edition.js';
 import { VERSION } from '../version.js';
 import { Session } from './session.js';
 import { SessionLog, classifyError } from '../utils/session-log.js';
-import { loadSettings, applyTelemetryEnvOverrides } from './settings.js';
+import { loadSettings, applyTelemetryEnvOverrides, applyUpdateCheckEnvOverride, } from './settings.js';
 import { TelemetryClient } from '../telemetry/client.js';
+import { checkForUpdate, shouldCheckForUpdate } from '../update/check.js';
 import { join, dirname } from 'node:path';
 import { pathToFileURL } from 'node:url';
 import { GoSnippetClient, resolveProBinaryPath, coreBinaryName } from '../api/snippet-client.js';
@@ -49,6 +50,7 @@ export class EditmameiServer {
     kernel;
     proModule = null;
     psVersion = null;
+    updateInfo = null;
     snippetClient = new GoSnippetClient();
     constructor() {
         this.logger = new Logger('EditmameiServer');
@@ -56,13 +58,18 @@ export class EditmameiServer {
         this.sessionLog = new SessionLog(this.session.getSessionId());
         this.logger.info(`Session ${this.session.getSessionId()} → ${this.sessionLog.path}`);
         const { settings, created } = loadSettings();
-        const effectiveSettings = applyTelemetryEnvOverrides(settings);
+        const effectiveSettings = applyUpdateCheckEnvOverride(applyTelemetryEnvOverrides(settings));
         this.telemetry = new TelemetryClient({
             settings: effectiveSettings,
             getPsVersion: () => this.psVersion,
         });
         if (created)
             this.logger.info(FIRST_RUN_DISCLOSURE);
+        if (shouldCheckForUpdate(effectiveSettings.update_check)) {
+            void checkForUpdate().then((info) => {
+                this.updateInfo = info;
+            });
+        }
         warnLogScriptOnErrorOnce(this.logger);
         this.toolRegistry = new ToolRegistry({
             onCall: (entry) => {
@@ -124,6 +131,16 @@ export class EditmameiServer {
                             items: { type: 'string' },
                             description: 'List of optional discovery signals that could not be gathered (e.g. "pingState" if the in-PS state snippet failed, "templates" if ~/.editmamei/templates was unreadable). Empty when all signals were collected cleanly. Returned defaults for any degraded field cannot be trusted as ground truth.',
                         },
+                        update_available: {
+                            type: ['object', 'null'],
+                            description: 'Set when a newer Editmamei version is published, else null. When present, TELL THE USER: relay current → latest and how_to_update verbatim. { current, latest, channel (npm/mcpb/dev), how_to_update }. Anonymous npm-registry check at boot; opt out with `editmamei config set update_check false`.',
+                            properties: {
+                                current: { type: 'string' },
+                                latest: { type: 'string' },
+                                channel: { type: 'string' },
+                                how_to_update: { type: 'string' },
+                            },
+                        },
                     },
                 },
                 annotations: {
@@ -286,8 +303,10 @@ export class EditmameiServer {
         const isConnected = await connection.ping();
         if (!isConnected) {
             return {
-                content: [{ type: 'text', text: 'Failed to connect to Photoshop' }],
-                structuredContent: { connected: false },
+                content: [
+                    { type: 'text', text: 'Failed to connect to Photoshop' + this.updateNote() },
+                ],
+                structuredContent: { connected: false, update_available: this.updateInfo },
             };
         }
         let version = 'Unknown';
@@ -336,7 +355,8 @@ export class EditmameiServer {
                     text: `Connected to Photoshop (v${version}). ` +
                         `${actionSetsCount} custom action set(s), ${userTemplates} saved template(s), ` +
                         `${openDocuments.length} open document(s)${openDocuments.length ? ': ' + openDocuments.join(', ') : ''}` +
-                        `${degradedNote}.`,
+                        `${degradedNote}.` +
+                        this.updateNote(),
                 },
             ],
             structuredContent: {
@@ -346,9 +366,16 @@ export class EditmameiServer {
                 user_templates: userTemplates,
                 open_documents: openDocuments,
                 degraded,
+                update_available: this.updateInfo,
             },
         };
     }
+    updateNote() {
+        const u = this.updateInfo;
+        if (!u)
+            return '';
+        return ` Update available: v${u.current} → v${u.latest}. ${u.how_to_update}`;
+    }
     async start() {
         await this.session.initialize();
         await this.loadModules();

package/dist/core/settings.js

@@ -20,6 +20,7 @@ function defaults(installId) {
         telemetry: { usage: true, diagnostics: false, install_id: installId },
         privacy: { send_previews_to_llm: true },
         photoshop_path: null,
+        update_check: true,
     };
 }
 function coerce(raw, installId) {
@@ -43,6 +44,7 @@ function coerce(raw, installId) {
                 : base.privacy.send_previews_to_llm,
         },
         photoshop_path: typeof r.photoshop_path === 'string' ? r.photoshop_path : null,
+        update_check: typeof r.update_check === 'boolean' ? r.update_check : base.update_check,
     };
 }
 export function loadSettings(opts = {}) {
@@ -102,6 +104,12 @@ export function applyTelemetryEnvOverrides(settings, env = process.env) {
         },
     };
 }
+export function applyUpdateCheckEnvOverride(settings, env = process.env) {
+    const v = parseBoolEnv(env.EDITMAMEI_UPDATE_CHECK);
+    if (v === undefined)
+        return settings;
+    return { ...settings, update_check: v };
+}
 export function saveSettings(settings, opts = {}) {
     const path = settingsPath(opts);
     const dir = dirname(path);

package/dist/install-channel.js

@@ -0,0 +1,8 @@
+import { EDITION } from './edition.js';
+export function resolveInstallChannel(env = process.env, edition = EDITION) {
+    if (edition === 'dev')
+        return 'dev';
+    if (env.EDITMAMEI_INSTALL_CHANNEL === 'mcpb')
+        return 'mcpb';
+    return 'npm';
+}

package/dist/update/check.js

@@ -0,0 +1,77 @@
+import { VERSION } from '../version.js';
+import { resolveInstallChannel } from '../install-channel.js';
+const DEFAULT_DIST_TAGS_URL = 'https://registry.npmjs.org/-/package/editmamei/dist-tags';
+const RELEASES_URL = 'https://github.com/editmamei/editmamei-wiki/releases/latest';
+export function resolveUpdateCheckUrl(env = process.env) {
+    const override = env.EDITMAMEI_UPDATE_CHECK_URL;
+    return override && override.length > 0 ? override : DEFAULT_DIST_TAGS_URL;
+}
+export function httpFetchLatest() {
+    return async (url, timeoutMs) => {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeoutMs);
+        try {
+            const res = await fetch(url, {
+                headers: { accept: 'application/json' },
+                signal: controller.signal,
+            });
+            if (!res.ok)
+                return null;
+            const data = (await res.json());
+            return typeof data.latest === 'string' ? data.latest : null;
+        }
+        catch {
+            return null;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    };
+}
+function parseSemver(v) {
+    const m = /^(\d+)\.(\d+)\.(\d+)$/.exec(v.trim());
+    return m ? [Number(m[1]), Number(m[2]), Number(m[3])] : null;
+}
+export function isNewer(latest, current) {
+    const a = parseSemver(latest);
+    const b = parseSemver(current);
+    if (!a || !b)
+        return false;
+    for (let i = 0; i < 3; i++) {
+        if (a[i] !== b[i])
+            return a[i] > b[i];
+    }
+    return false;
+}
+export function updateMessage(channel, latest) {
+    switch (channel) {
+        case 'mcpb':
+            return `Download editmamei.mcpb (v${latest}) from ${RELEASES_URL} and reinstall the Claude Desktop extension.`;
+        case 'dev':
+            return `You're on a local dev build — pull the latest source and rebuild.`;
+        case 'npm':
+        default:
+            return `Run: npm install -g editmamei@latest (then restart your MCP client).`;
+    }
+}
+export function shouldCheckForUpdate(updateCheckEnabled, env = process.env) {
+    const inTest = env.VITEST !== undefined || env.NODE_ENV === 'test';
+    return updateCheckEnabled === true && !inTest;
+}
+export async function checkForUpdate(opts = {}) {
+    try {
+        const env = opts.env ?? process.env;
+        const current = opts.current ?? VERSION;
+        const channel = resolveInstallChannel(env);
+        const fetchLatest = opts.fetchLatest ?? httpFetchLatest();
+        const latest = await fetchLatest(resolveUpdateCheckUrl(env), opts.timeoutMs ?? 4000);
+        if (!latest || !parseSemver(latest))
+            return null;
+        if (!isNewer(latest, current))
+            return null;
+        return { current, latest, channel, how_to_update: updateMessage(channel, latest) };
+    }
+    catch {
+        return null;
+    }
+}

package/dist/version.js

@@ -1 +1 @@
-export const VERSION = '0.18.0';
+export const VERSION = '0.19.0';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "editmamei",
-  "version": "0.18.0",
+  "version": "0.19.0",
   "description": "Editmamei — Unlock Photoshop with natural-language photo editing (Community Edition)",
   "main": "dist/index.js",
   "type": "module",