@mudah-cli/core 0.1.0 → 0.3.0

package/dist/application.d.ts

@@ -2,6 +2,7 @@ import { ConfigRepository } from '@mudah-cli/config';
 import { Container, type Abstract, type Constructor } from '@mudah-cli/container';
 import { EventBus } from './events.js';
 import { type MudahManifest } from './manifest.js';
+import { type PluginDiscoveryOptions, type PluginInfo } from './plugins.js';
 import { ServiceProvider } from './service-provider.js';
 export type ProviderClass = new (app: Application) => ServiceProvider;
 export interface LazyProviderOptions {
@@ -12,6 +13,25 @@ export interface LazyProviderOptions {
     /** Boot this provider when the predicate returns true (checked on demand). */
     bootWhen?: (app: Application) => boolean;
 }
+export interface BootOptions {
+    /** Collect per-hook timings (default: honors `MUDAH_BOOT_PROFILE=1`). */
+    profile?: boolean;
+}
+/** One provider hook, timed. */
+export interface ProviderTiming {
+    /** Provider class name. */
+    readonly provider: string;
+    /** Which phase of the two-phase boot. */
+    readonly hook: 'register' | 'boot';
+    readonly durationMs: number;
+}
+/** Provider boot timings, for `--profile`. */
+export interface BootProfile {
+    /** Wall-clock time across both phases. */
+    readonly totalMs: number;
+    /** Timings in execution order: all `register` hooks, then all `boot` hooks. */
+    readonly providers: readonly ProviderTiming[];
+}
 /** A command module: a module whose default export is a command class. */
 export interface CommandModule {
     default: CommandClass;
@@ -53,9 +73,11 @@ export declare class Application extends Container {
      * 1. `register()` — container bindings
      * 2. `boot()` — everything else
      *
-     * Set `MUDAH_BOOT_PROFILE=1` to print per-hook timings on stderr.
+     * Returns per-hook timings when profiling is on (`{ profile: true }`, or
+     * `MUDAH_BOOT_PROFILE=1`). The env var also prints the old one-line report
+     * to stderr for anyone scripting against it.
      */
-    boot(): Promise<void>;
+    boot(options?: BootOptions): Promise<BootProfile | undefined>;
     /** Boot lazy providers that declared an interest in `command`. */
     bootLazyForCommand(command: string): Promise<void>;
     /** Boot lazy providers that declared an interest in `abstract`. */
@@ -68,6 +90,15 @@ export declare class Application extends Container {
      * (sorted for determinism). Exports whose name ends in `Provider` win.
      */
     discoverProviders(dir?: string): Promise<this>;
+    /**
+     * Discover plugins among installed packages and register what they
+     * provide. A plugin is any dependency declaring the `mudah-plugin`
+     * keyword; see {@link discoverPlugins}.
+     *
+     * Broken plugins are skipped rather than fatal — a third-party package
+     * must never be able to take down the host app at boot.
+     */
+    discoverPlugins(options?: PluginDiscoveryOptions): Promise<PluginInfo[]>;
     /**
      * Discover command modules in the given directory (sorted). A command
      * module is any file whose default export is a class with `handle`.

package/dist/application.js

@@ -5,7 +5,12 @@ import { ConfigRepository } from '@mudah-cli/config';
 import { Container, isClassLike } from '@mudah-cli/container';
 import { EventBus } from './events.js';
 import { loadManifest } from './manifest.js';
+import { discoverPlugins } from './plugins.js';
 import { ServiceProvider } from './service-provider.js';
+/** Round to whole milliseconds — sub-ms noise tells us nothing here. */
+function round(ms) {
+    return Math.round(ms);
+}
 /** True when the value is a class with a `handle` prototype method. */
 export function isCommandExport(value) {
     if (typeof value !== 'function' || !isClassLike(value))
@@ -58,33 +63,47 @@ export class Application extends Container {
      * 1. `register()` — container bindings
      * 2. `boot()` — everything else
      *
-     * Set `MUDAH_BOOT_PROFILE=1` to print per-hook timings on stderr.
+     * Returns per-hook timings when profiling is on (`{ profile: true }`, or
+     * `MUDAH_BOOT_PROFILE=1`). The env var also prints the old one-line report
+     * to stderr for anyone scripting against it.
      */
-    async boot() {
+    async boot(options = {}) {
+        // Boot is idempotent: providers already ran, so there is nothing to time.
         if (this.booted)
-            return;
-        const profile = process.env['MUDAH_BOOT_PROFILE'] === '1';
-        const timings = [];
+            return undefined;
+        const profile = options.profile ?? process.env['MUDAH_BOOT_PROFILE'] === '1';
+        const hooks = [];
         const started = performance.now();
         for (const Provider of this.providers) {
             const provider = new Provider(this);
             const t0 = profile ? performance.now() : 0;
             await provider.register?.();
-            if (profile)
-                timings.push(`${Provider.name}.register=${Math.round(performance.now() - t0)}ms`);
+            if (profile) {
+                hooks.push({ provider: Provider.name, hook: 'register', durationMs: round(performance.now() - t0) });
+            }
         }
         for (const Provider of this.providers) {
             const provider = new Provider(this);
             const t0 = profile ? performance.now() : 0;
             await provider.boot?.();
-            if (profile)
-                timings.push(`${Provider.name}.boot=${Math.round(performance.now() - t0)}ms`);
-        }
-        if (profile) {
-            console.error(`[boot-profile] total=${Math.round(performance.now() - started)}ms ${timings.join(' ')}`);
+            if (profile) {
+                hooks.push({ provider: Provider.name, hook: 'boot', durationMs: round(performance.now() - t0) });
+            }
         }
         this.booted = true;
         await this.events().emit('app.booted', { app: this });
+        if (!profile)
+            return undefined;
+        const result = {
+            totalMs: round(performance.now() - started),
+            providers: hooks,
+        };
+        if (process.env['MUDAH_BOOT_PROFILE'] === '1') {
+            console.error(`[boot-profile] total=${result.totalMs}ms ${hooks
+                .map((h) => `${h.provider}.${h.hook}=${h.durationMs}ms`)
+                .join(' ')}`);
+        }
+        return result;
     }
     /** Boot lazy providers that declared an interest in `command`. */
     async bootLazyForCommand(command) {
@@ -140,6 +159,22 @@ export class Application extends Container {
         }
         return this;
     }
+    /**
+     * Discover plugins among installed packages and register what they
+     * provide. A plugin is any dependency declaring the `mudah-plugin`
+     * keyword; see {@link discoverPlugins}.
+     *
+     * Broken plugins are skipped rather than fatal — a third-party package
+     * must never be able to take down the host app at boot.
+     */
+    async discoverPlugins(options = {}) {
+        const plugins = await discoverPlugins(this.basePath, options);
+        for (const plugin of plugins) {
+            for (const provider of plugin.providers)
+                this.register(provider);
+        }
+        return plugins;
+    }
     /**
      * Discover command modules in the given directory (sorted). A command
      * module is any file whose default export is a class with `handle`.

package/dist/application.js.map

@@ -1 +1 @@
-{"version":3,"file":"application.js","sourceRoot":"","sources":["../src/application.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"application.js","sourceRoot":"","sources":["../src/application.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,5 +1,7 @@
-export { Application, isCommandExport, type CommandClass, type CommandModule, type CommandShape, type LazyProviderOptions, type ProviderClass, } from './application.js';
+export { Application, isCommandExport, type CommandClass, type BootOptions, type BootProfile, type CommandModule, type CommandShape, type LazyProviderOptions, type ProviderClass, type ProviderTiming, } from './application.js';
 export { EventBus, type AppEvents, type EventHandler } from './events.js';
 export { CommandCancelled, ExitError, UsageError } from './exceptions.js';
 export { loadManifest, MudahManifestError, type MudahManifest, type MudahUiOptions } from './manifest.js';
 export { ServiceProvider } from './service-provider.js';
+export { discoverPlugins, findPluginPackages, loadPlugin, type PluginDiscoveryOptions, type PluginInfo, } from './plugins.js';
+export { checkForUpdate, clearUpdateCache, compareSemVer, defaultCacheDir, formatUpdateNudge, isNewer, parseSemVer, updateKind, type SemVer, type UpdateCheckOptions, type UpdateCheckResult, type UpdateInfo, } from './updates.js';

package/dist/index.js

@@ -3,4 +3,6 @@ export { EventBus } from './events.js';
 export { CommandCancelled, ExitError, UsageError } from './exceptions.js';
 export { loadManifest, MudahManifestError } from './manifest.js';
 export { ServiceProvider } from './service-provider.js';
+export { discoverPlugins, findPluginPackages, loadPlugin, } from './plugins.js';
+export { checkForUpdate, clearUpdateCache, compareSemVer, defaultCacheDir, formatUpdateNudge, isNewer, parseSemVer, updateKind, } from './updates.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,eAAe,GAMhB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAqC,MAAM,aAAa,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAA2C,MAAM,eAAe,CAAC;AAC1G,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,eAAe,GAShB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAqC,MAAM,aAAa,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAA2C,MAAM,eAAe,CAAC;AAC1G,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,UAAU,GAGX,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,OAAO,EACP,WAAW,EACX,UAAU,GAKX,MAAM,cAAc,CAAC"}

package/dist/plugins.d.ts

@@ -0,0 +1,58 @@
+import { type CommandModule, type ProviderClass } from './application.js';
+/**
+ * Plugin discovery: register providers and commands shipped by other
+ * packages rather than by the app itself.
+ *
+ * A plugin is any installed package that declares the `mudah-plugin`
+ * keyword in its `package.json`. Its entry point may export:
+ *
+ * - a `default` export that is a provider class, or
+ * - a named export whose name ends in `Provider`, or
+ * - a named `providers` array, and/or
+ * - a named `commands` array of command modules.
+ *
+ * Discovery is best-effort: a plugin that fails to import is reported and
+ * skipped rather than taking the host app down with it.
+ */
+export interface PluginInfo {
+    /** Package name, as installed. */
+    readonly name: string;
+    /** Provider classes found in the package. */
+    readonly providers: readonly ProviderClass[];
+    /** Command modules found in the package. */
+    readonly commands: readonly CommandModule[];
+}
+export interface PluginDiscoveryOptions {
+    /**
+     * Package keyword that marks a plugin. Default `mudah-plugin`.
+     */
+    keyword?: string;
+    /**
+     * Extra package names to treat as plugins regardless of keyword. Handy for
+     * bundled apps that can't rely on a published manifest.
+     */
+    include?: readonly string[];
+    /** Package names to skip even if they declare the keyword. */
+    exclude?: readonly string[];
+    /** Resolve a package name to a module URL. Injectable for tests. */
+    resolve?: (name: string, from: string) => string | Promise<string>;
+    /** Read a package's manifest. Injectable for tests. */
+    readPackage?: (path: string) => Promise<unknown>;
+    /** Import a resolved module URL. Injectable for tests. */
+    importModule?: (url: string) => Promise<Record<string, unknown>>;
+}
+/**
+ * Find installed plugin packages: dependencies of `basePath` that declare
+ * the keyword (or are listed in `include`), minus anything excluded.
+ */
+export declare function findPluginPackages(basePath: string, options?: PluginDiscoveryOptions): Promise<string[]>;
+/**
+ * Load a plugin package and pull the providers and commands out of it.
+ * Returns empty arrays (not an error) when the package exports neither.
+ */
+export declare function loadPlugin(name: string, basePath: string, options?: PluginDiscoveryOptions): Promise<PluginInfo>;
+/**
+ * Discover every installed plugin and collect what it provides. Individual
+ * failures are skipped: one broken plugin must not break the host app.
+ */
+export declare function discoverPlugins(basePath: string, options?: PluginDiscoveryOptions): Promise<PluginInfo[]>;

package/dist/plugins.js

@@ -0,0 +1,175 @@
+import { createRequire } from 'node:module';
+import { readFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { isCommandExport } from './application.js';
+const DEFAULT_KEYWORD = 'mudah-plugin';
+/**
+ * Find installed plugin packages: dependencies of `basePath` that declare
+ * the keyword (or are listed in `include`), minus anything excluded.
+ */
+export async function findPluginPackages(basePath, options = {}) {
+    const keyword = options.keyword ?? DEFAULT_KEYWORD;
+    const exclude = new Set(options.exclude ?? []);
+    const readPackage = options.readPackage ?? readJson;
+    const resolve = options.resolve ?? defaultResolve;
+    // No manifest means no dependency graph to scan — an app run straight from
+    // a directory (tests, single-file tools) simply has no plugins.
+    let manifest;
+    try {
+        manifest = (await readPackage(join(basePath, 'package.json')));
+    }
+    catch {
+        return explicitlyIncludedNames(options.include, exclude);
+    }
+    const candidates = [
+        ...Object.keys(manifest.dependencies ?? {}),
+        ...Object.keys(manifest.peerDependencies ?? {}),
+        ...(options.include ?? []),
+    ];
+    // devDependencies are deliberately excluded: a plugin used only for
+    // development shouldn't ship in a production install.
+    const unique = [...new Set(candidates)].filter((name) => !exclude.has(name)).sort();
+    const plugins = [];
+    for (const name of unique) {
+        if (explicitlyIncluded(name, options.include)) {
+            plugins.push(name);
+            continue;
+        }
+        const entry = await readPluginManifest(basePath, name, readPackage, resolve);
+        if (entry !== null && declaresKeyword(entry, keyword))
+            plugins.push(name);
+    }
+    return plugins;
+}
+function explicitlyIncluded(name, include) {
+    return include !== undefined && include.includes(name);
+}
+/** Explicit includes still apply when there is no manifest to scan. */
+function explicitlyIncludedNames(include, exclude) {
+    return (include ?? []).filter((name) => !exclude.has(name));
+}
+async function readPluginManifest(basePath, name, readPackage, resolve) {
+    try {
+        // Resolve to the package's entry file, then find its manifest.
+        const entryUrl = await resolve(name, basePath);
+        const entryPath = entryUrl.startsWith('file:')
+            ? new URL(entryUrl).pathname
+            : entryUrl;
+        const packageRoot = await packageRootFromEntry(entryPath, name, readPackage);
+        if (packageRoot === null)
+            return null;
+        return (await readPackage(join(packageRoot, 'package.json')));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Prefer the `node_modules/<name>/` segment when it is present. Workspace
+ * and `file:` installs often resolve to a real path that no longer contains
+ * the package name, so fall back to walking up until a package.json exists.
+ */
+async function packageRootFromEntry(entryPath, name, readPackage) {
+    const marker = `/${name}/`;
+    const named = entryPath.lastIndexOf(marker);
+    if (named !== -1)
+        return entryPath.slice(0, named + marker.length - 1);
+    let dir = dirname(entryPath);
+    for (let i = 0; i < 8; i++) {
+        try {
+            await readPackage(join(dir, 'package.json'));
+            return dir;
+        }
+        catch {
+            const parent = dirname(dir);
+            if (parent === dir)
+                return null;
+            dir = parent;
+        }
+    }
+    return null;
+}
+function declaresKeyword(pkg, keyword) {
+    return Array.isArray(pkg.keywords) && pkg.keywords.includes(keyword);
+}
+/**
+ * Load a plugin package and pull the providers and commands out of it.
+ * Returns empty arrays (not an error) when the package exports neither.
+ */
+export async function loadPlugin(name, basePath, options = {}) {
+    const resolve = options.resolve ?? defaultResolve;
+    const importModule = options.importModule ?? defaultImport;
+    const url = await resolve(name, basePath);
+    const mod = await importModule(url);
+    const providers = [];
+    const commands = [];
+    for (const value of Object.values(mod)) {
+        if (typeof value === 'function' && /Provider$/.test(value.name ?? '')) {
+            providers.push(value);
+        }
+    }
+    if (mod.default !== undefined && providers.length === 0) {
+        const fallback = mod.default;
+        if (typeof fallback === 'function' && /Provider$/.test(fallback.name ?? '')) {
+            providers.push(fallback);
+        }
+    }
+    const declaredProviders = mod.providers;
+    if (Array.isArray(declaredProviders)) {
+        for (const value of declaredProviders) {
+            if (typeof value === 'function' && !providers.includes(value)) {
+                providers.push(value);
+            }
+        }
+    }
+    const declaredCommands = mod.commands;
+    if (Array.isArray(declaredCommands)) {
+        for (const value of declaredCommands) {
+            if (isCommandExport(value))
+                commands.push({ default: value });
+        }
+    }
+    if (isCommandExport(mod.default) && commands.length === 0) {
+        commands.push({ default: mod.default });
+    }
+    return { name, providers, commands };
+}
+/**
+ * Discover every installed plugin and collect what it provides. Individual
+ * failures are skipped: one broken plugin must not break the host app.
+ */
+export async function discoverPlugins(basePath, options = {}) {
+    const loaded = [];
+    let names;
+    try {
+        names = await findPluginPackages(basePath, options);
+    }
+    catch {
+        // A malformed host manifest shouldn't stop the app from booting.
+        return loaded;
+    }
+    for (const name of names) {
+        try {
+            loaded.push(await loadPlugin(name, basePath, options));
+        }
+        catch {
+            // Unresolvable or unimportable: skip it.
+        }
+    }
+    return loaded;
+}
+async function readJson(path) {
+    const text = await readFile(path, 'utf8');
+    return JSON.parse(text);
+}
+function defaultResolve(specifier, from) {
+    // Resolve as the app would: from its own package.json, not from this
+    // module. Workspace and nested `node_modules` then match a real install.
+    const require = createRequire(join(from, 'package.json'));
+    return pathToFileURL(require.resolve(specifier)).href;
+}
+function defaultImport(url) {
+    return import(/* @vite-ignore */ url);
+}
+//# sourceMappingURL=plugins.js.map

package/dist/plugins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.js","sourceRoot":"","sources":["../src/plugins.ts"],"names":[],"mappings":"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"}

package/dist/updates.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Update nudge: compare the app's version against the npm registry and
+ * mention it once in a while.
+ *
+ * Everything here fails soft. A machine with no network, no writable cache
+ * dir, or a firewalled registry gets no nudge and no error — the check runs
+ * on the slow path of an already-successful command, so it must never be the
+ * reason a command failed.
+ */
+export interface UpdateCheckOptions {
+    /** Package name as published to npm. */
+    packageName: string;
+    /** The version currently running. */
+    currentVersion: string;
+    /** Skip the network when a cached answer is younger than this. Default 24h. */
+    cacheTtlMs?: number;
+    /** Overall deadline for the network call. Default 1500ms. */
+    timeoutMs?: number;
+    /** Registry base URL. Defaults to `https://registry.npmjs.org`. */
+    registry?: string;
+    /** Override the cache directory (tests, sandboxes). */
+    cacheDir?: string;
+    /** Fetch implementation (tests inject a stub). */
+    fetch?: typeof fetch;
+    /** Dist-tag to compare against. Default `latest`. */
+    distTag?: string;
+}
+export interface UpdateInfo {
+    /** A newer version is available. */
+    readonly updateAvailable: boolean;
+    readonly currentVersion: string;
+    /** The newest published version, when one was resolved. */
+    readonly latestVersion?: string;
+    /** How big the gap is: `major`, `minor`, `patch`, or `prerelease`. */
+    readonly kind?: 'major' | 'minor' | 'patch' | 'prerelease';
+}
+export interface UpdateCheckResult extends UpdateInfo {
+    /** False when the check was skipped or failed; never throws. */
+    readonly checked: boolean;
+    /** Why nothing was resolved, when `checked` is false. */
+    readonly reason?: 'disabled' | 'cached-no-update' | 'offline' | 'invalid-version' | 'not-found';
+    /** Where the answer came from. */
+    readonly source?: 'cache' | 'registry';
+}
+export interface SemVer {
+    major: number;
+    minor: number;
+    patch: number;
+    /** Prerelease identifiers, e.g. `['alpha', '1']`. */
+    prerelease: ReadonlyArray<string | number>;
+}
+/**
+ * Parse a semver string. Tolerates a leading `v`/`=` and missing minor/patch
+ * (`1` → `1.0.0`). Returns null when the string isn't a version at all.
+ */
+export declare function parseSemVer(version: string): SemVer | null;
+/**
+ * Compare two versions. Returns -1 when `a` sorts first, 1 when `a` sorts
+ * after, 0 when they're equal. Prereleases sort below their release
+ * (`1.0.0-alpha` < `1.0.0`).
+ */
+export declare function compareSemVer(a: string, b: string): number;
+/** Classify the gap between two versions, from the older one's perspective. */
+export declare function updateKind(current: string, latest: string): UpdateInfo['kind'];
+/** True when `latest` is newer than `current`. */
+export declare function isNewer(latest: string, current: string): boolean;
+/** The default cache directory: XDG on Unix, `%LOCALAPPDATA%` on Windows. */
+export declare function defaultCacheDir(appName?: string): string;
+/** Clear a cached answer. Used by `--no-update-check`-style tooling and tests. */
+export declare function clearUpdateCache(packageName: string, options?: {
+    cacheDir?: string;
+}): void;
+/**
+ * Check npm for a newer version. Resolves `checked: false` rather than
+ * throwing, so callers can fire-and-forget it.
+ */
+export declare function checkForUpdate(options: UpdateCheckOptions): Promise<UpdateCheckResult>;
+/**
+ * Format a one-line nudge. Returns null when there's nothing to say, so
+ * callers can `if (line) output.muted(line)`.
+ */
+export declare function formatUpdateNudge(info: UpdateCheckResult, binName: string): string | null;

package/dist/updates.js

@@ -0,0 +1,225 @@
+import { mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+/** No update. Returned for every non-actionable outcome. */
+const NO_UPDATE = {
+    updateAvailable: false,
+    currentVersion: '',
+    checked: false,
+};
+/**
+ * Parse a semver string. Tolerates a leading `v`/`=` and missing minor/patch
+ * (`1` → `1.0.0`). Returns null when the string isn't a version at all.
+ */
+export function parseSemVer(version) {
+    const text = version.trim().replace(/^[v=]+/, '');
+    const match = /^(\d+)(?:\.(\d+))?(?:\.(\d+))?(?:-([0-9A-Za-z-.]+))?(?:\+[0-9A-Za-z-.]+)?$/.exec(text);
+    if (!match)
+        return null;
+    return {
+        major: Number(match[1]),
+        minor: Number(match[2] ?? '0'),
+        patch: Number(match[3] ?? '0'),
+        prerelease: match[4] === undefined ? [] : match[4].split('.').map(identifier),
+    };
+}
+function identifier(part) {
+    return /^\d+$/.test(part) ? Number(part) : part;
+}
+/**
+ * Compare two versions. Returns -1 when `a` sorts first, 1 when `a` sorts
+ * after, 0 when they're equal. Prereleases sort below their release
+ * (`1.0.0-alpha` < `1.0.0`).
+ */
+export function compareSemVer(a, b) {
+    const left = parseSemVer(a);
+    const right = parseSemVer(b);
+    if (left === null || right === null)
+        return 0;
+    for (const field of ['major', 'minor', 'patch']) {
+        if (left[field] !== right[field])
+            return left[field] < right[field] ? -1 : 1;
+    }
+    return comparePrerelease(left.prerelease, right.prerelease);
+}
+function comparePrerelease(a, b) {
+    // A version without a prerelease is newer than one with it.
+    if (a.length === 0 && b.length === 0)
+        return 0;
+    if (a.length === 0)
+        return 1;
+    if (b.length === 0)
+        return -1;
+    for (let i = 0; i < Math.max(a.length, b.length); i++) {
+        const left = a[i];
+        const right = b[i];
+        if (left === undefined)
+            return -1;
+        if (right === undefined)
+            return 1;
+        if (left === right)
+            continue;
+        const leftIsNumber = typeof left === 'number';
+        const rightIsNumber = typeof right === 'number';
+        if (leftIsNumber && rightIsNumber)
+            return left < right ? -1 : 1;
+        // Numeric identifiers always sort below alphanumeric ones.
+        if (leftIsNumber)
+            return -1;
+        if (rightIsNumber)
+            return 1;
+        return String(left) < String(right) ? -1 : 1;
+    }
+    return 0;
+}
+/** Classify the gap between two versions, from the older one's perspective. */
+export function updateKind(current, latest) {
+    const from = parseSemVer(current);
+    const to = parseSemVer(latest);
+    if (from === null || to === null)
+        return undefined;
+    if (to.prerelease.length > 0 && from.prerelease.length === 0)
+        return 'prerelease';
+    if (to.major !== from.major)
+        return 'major';
+    if (to.minor !== from.minor)
+        return 'minor';
+    return 'patch';
+}
+/** True when `latest` is newer than `current`. */
+export function isNewer(latest, current) {
+    return compareSemVer(latest, current) > 0;
+}
+/** The default cache directory: XDG on Unix, `%LOCALAPPDATA%` on Windows. */
+export function defaultCacheDir(appName = 'mudah') {
+    const home = process.env['HOME'] ?? process.env['USERPROFILE'] ?? '';
+    if (process.platform === 'win32') {
+        return process.env['LOCALAPPDATA'] ?? join(home, 'AppData', 'Local', appName, 'cache');
+    }
+    const xdg = process.env['XDG_CACHE_HOME'];
+    if (xdg !== undefined && xdg.length > 0)
+        return join(xdg, appName);
+    return join(home, '.cache', appName);
+}
+function cacheFile(cacheDir, packageName) {
+    return join(cacheDir, `${packageName.replace(/[^a-zA-Z0-9._-]/g, '_')}.json`);
+}
+function readCache(file) {
+    try {
+        const parsed = JSON.parse(readFileSync(file, 'utf8'));
+        if (typeof parsed !== 'object' || parsed === null)
+            return null;
+        const entry = parsed;
+        if (typeof entry.latestVersion !== 'string' || typeof entry.checkedAt !== 'number') {
+            return null;
+        }
+        return { latestVersion: entry.latestVersion, checkedAt: entry.checkedAt };
+    }
+    catch {
+        return null;
+    }
+}
+function writeCache(file, entry) {
+    try {
+        mkdirSync(join(file, '..'), { recursive: true });
+        writeFileSync(file, JSON.stringify(entry), 'utf8');
+    }
+    catch {
+        // A read-only filesystem just means no caching next time.
+    }
+}
+/** Clear a cached answer. Used by `--no-update-check`-style tooling and tests. */
+export function clearUpdateCache(packageName, options = {}) {
+    try {
+        rmSync(cacheFile(options.cacheDir ?? defaultCacheDir(), packageName), { force: true });
+    }
+    catch {
+        // Nothing cached, or not removable — either way, mission accomplished.
+    }
+}
+/**
+ * Check npm for a newer version. Resolves `checked: false` rather than
+ * throwing, so callers can fire-and-forget it.
+ */
+export async function checkForUpdate(options) {
+    const current = options.currentVersion;
+    if (parseSemVer(current) === null) {
+        return { ...NO_UPDATE, currentVersion: current, reason: 'invalid-version' };
+    }
+    const ttlMs = options.cacheTtlMs ?? 24 * 60 * 60 * 1000;
+    const file = cacheFile(options.cacheDir ?? defaultCacheDir(), options.packageName);
+    // A fresh cache hit answers without touching the network.
+    const cached = readCache(file);
+    if (cached !== null && Date.now() - cached.checkedAt < ttlMs) {
+        return resolve(current, cached.latestVersion, 'cache');
+    }
+    const latest = await fetchLatest(options);
+    if (latest === null) {
+        // Offline: fall back to a stale cache entry rather than saying nothing.
+        if (cached !== null)
+            return resolve(current, cached.latestVersion, 'cache');
+        return { ...NO_UPDATE, currentVersion: current, reason: 'offline' };
+    }
+    writeCache(file, { latestVersion: latest, checkedAt: Date.now() });
+    return resolve(current, latest, 'registry');
+}
+function resolve(current, latest, source) {
+    if (!isNewer(latest, current)) {
+        return {
+            updateAvailable: false,
+            currentVersion: current,
+            latestVersion: latest,
+            checked: true,
+            reason: 'cached-no-update',
+            source,
+        };
+    }
+    return {
+        updateAvailable: true,
+        currentVersion: current,
+        latestVersion: latest,
+        kind: updateKind(current, latest),
+        checked: true,
+        source,
+    };
+}
+async function fetchLatest(options) {
+    const doFetch = options.fetch ?? fetch;
+    const registry = (options.registry ??
+        process.env['MUDAH_UPDATE_REGISTRY'] ??
+        'https://registry.npmjs.org').replace(/\/+$/, '');
+    const name = options.packageName.replace(/^\//, '').replace(/\//g, '%2f');
+    const tag = options.distTag ?? 'latest';
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), options.timeoutMs ?? 1500);
+    try {
+        const response = await doFetch(`${registry}/${name}/${tag}`, {
+            signal: controller.signal,
+            headers: { accept: 'application/json' },
+        });
+        if (!response.ok)
+            return null;
+        const body = (await response.json());
+        if (typeof body !== 'object' || body === null)
+            return null;
+        const version = body.version;
+        if (typeof version !== 'string' || parseSemVer(version) === null)
+            return null;
+        return version;
+    }
+    catch {
+        return null;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/**
+ * Format a one-line nudge. Returns null when there's nothing to say, so
+ * callers can `if (line) output.muted(line)`.
+ */
+export function formatUpdateNudge(info, binName) {
+    if (!info.updateAvailable || info.latestVersion === undefined)
+        return null;
+    return `Update available: ${info.currentVersion} → ${info.latestVersion} (npm i -g ${binName})`;
+}
+//# sourceMappingURL=updates.js.map

package/dist/updates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"updates.js","sourceRoot":"","sources":["../src/updates.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mudah-cli/core",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Mudah application kernel: service providers, two-phase boot, events, and discovery.",
   "type": "module",
   "license": "MIT",
@@ -18,8 +18,8 @@
   ],
   "sideEffects": false,
   "dependencies": {
-    "@mudah-cli/config": "^0.1.0",
-    "@mudah-cli/container": "^0.1.0"
+    "@mudah-cli/config": "^0.3.0",
+    "@mudah-cli/container": "^0.3.0"
   },
   "publishConfig": {
     "access": "public"