@mudah-cli/core 0.7.0 → 0.9.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mudah Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,42 @@
+# @mudah-cli/core
+
+The Mudah application kernel: service providers, two-phase boot, events, plugins, and discovery.
+
+Part of [Mudah](https://github.com/thesimonharms/mudah) — an ergonomic, animation-rich CLI
+framework. `Application` extends the IoC `Container`.
+
+## Install
+
+```sh
+npm install @mudah-cli/core
+```
+
+## Usage
+
+```ts
+import { Application, ServiceProvider, loadManifest } from '@mudah-cli/core';
+
+const app = new Application(process.cwd(), loadManifest(process.cwd()));
+
+class MetricsProvider extends ServiceProvider {
+  register(): void {
+    this.app.singleton('metrics', () => new Map<string, number>());
+  }
+  boot(): void {
+    this.app.events().on('command.after', ({ command, durationMs }) => {
+      // record timings
+    });
+  }
+}
+
+await app.boot();
+```
+
+Two-phase boot runs every `register()` first, then every `boot()`, so `boot()` can depend on
+anything any provider registered. Both hooks are async-first. `registerLazy(Provider, { commands })`
+defers expensive providers until a matching command runs.
+
+## Links
+
+- [Full documentation](https://github.com/thesimonharms/mudah#readme)
+- [License: MIT](LICENSE)

package/dist/application.d.ts

@@ -1,17 +1,34 @@
 import { ConfigRepository } from '@mudah-cli/config';
-import { Container, type Abstract, type Constructor } from '@mudah-cli/container';
+import { type Abstract, type Constructor, Container } 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';
+import type { ServiceProvider } from './service-provider.js';
+export interface IoStreams {
+    stdin?: {
+        read?: unknown;
+    };
+    stdout?: {
+        write(data: string): unknown;
+    };
+    stderr?: {
+        write(data: string): unknown;
+    };
+}
+export interface ProviderHealth {
+    readonly provider: string;
+    readonly status: 'ok' | 'error' | 'skipped';
+    readonly latencyMs: number;
+    readonly detail?: string;
+}
 export type ProviderClass = new (app: Application) => ServiceProvider;
 export interface LazyProviderOptions {
     /** Boot this provider when one of these commands is invoked. */
     commands?: string[];
     /** Boot this provider when one of these bindings is resolved. */
     bindings?: readonly Abstract[];
-    /** Boot this provider when the predicate returns true (checked on demand). */
-    bootWhen?: (app: Application) => boolean;
+    /** Boot this provider when the predicate returns true (checked on demand). May be async. */
+    bootWhen?: (app: Application) => boolean | Promise<boolean>;
 }
 export interface BootOptions {
     /** Collect per-hook timings (default: honors `MUDAH_BOOT_PROFILE=1`). */
@@ -57,10 +74,21 @@ export declare class Application extends Container {
     private readonly providers;
     private readonly lazyProviders;
     private readonly bootedLazy;
+    private readonly bootedInstances;
     private booted;
+    private io;
+    private discoveredPlugins;
+    private pluginGateWarnings;
+    private readonly registeredPluginProviders;
     constructor(basePath?: string, manifest?: MudahManifest);
     config(): ConfigRepository;
     events(): EventBus;
+    /** Plugins that passed compatibility gates on the last discovery pass. */
+    plugins(): readonly PluginInfo[];
+    /** Human-readable reasons plugins were skipped by {@link gatePlugin}. */
+    pluginWarnings(): readonly string[];
+    /** Class names of every registered (eager) service provider. */
+    providerNames(): string[];
     /** Register a provider that always boots. */
     register(provider: ProviderClass): this;
     /**
@@ -82,9 +110,21 @@ export declare class Application extends Container {
     bootLazyForCommand(command: string): Promise<void>;
     /** Boot lazy providers that declared an interest in `abstract`. */
     bootLazyForBinding(abstract: Abstract): Promise<void>;
-    /** Boot lazy providers whose `bootWhen` predicate currently returns true. */
+    /** Boot lazy providers whose `bootWhen` predicate currently returns true (awaited). */
     evaluateLazy(): Promise<void>;
+    /** Redirect command I/O streams for this application (tests, pipes). */
+    redirect(streams: IoStreams): this;
+    /** Current redirected streams (empty keys fall through to process). */
+    streams(): IoStreams;
+    /** Per-provider health: status + latency. Providers may implement `health()`. */
+    health(): Promise<ProviderHealth[]>;
+    /** Notify providers of an error (lifecycle hook). */
+    notifyError(error: unknown): Promise<void>;
     private bootLazy;
+    /** Notify providers that a config value was mutated. */
+    notifyConfigChanged(key: string): void;
+    /** Shut down all booted providers, dispose container instances, emit 'app.shutdown'. */
+    shutdown(): Promise<void>;
     /**
      * Discover and register every `*.provider.{ts,js}` in the given directory
      * (sorted for determinism). Exports whose name ends in `Provider` win.
@@ -99,6 +139,14 @@ export declare class Application extends Container {
      * must never be able to take down the host app at boot.
      */
     discoverPlugins(options?: PluginDiscoveryOptions): Promise<PluginInfo[]>;
+    /**
+     * Re-scan plugins, cache-bust their modules, register any new providers,
+     * and boot providers that arrived after the original `boot()`. Emits
+     * `plugins.reloaded`.
+     */
+    reloadPlugins(options?: PluginDiscoveryOptions): Promise<PluginInfo[]>;
+    /** Register+boot providers added after the initial two-phase boot. */
+    private bootPendingProviders;
     /**
      * 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,8 +5,7 @@ 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';
+import { CORE_VERSION, discoverPlugins, gatePlugin, } from './plugins.js';
 import { installTsJsResolveHook } from './ts-js-hook.js';
 /** Round to whole milliseconds — sub-ms noise tells us nothing here. */
 function round(ms) {
@@ -31,7 +30,12 @@ export class Application extends Container {
     providers = [];
     lazyProviders = [];
     bootedLazy = new Set();
+    bootedInstances = [];
     booted = false;
+    io = {};
+    discoveredPlugins = [];
+    pluginGateWarnings = [];
+    registeredPluginProviders = new Set();
     constructor(basePath = process.cwd(), manifest) {
         super();
         installTsJsResolveHook();
@@ -47,6 +51,18 @@ export class Application extends Container {
     events() {
         return this.make('events');
     }
+    /** Plugins that passed compatibility gates on the last discovery pass. */
+    plugins() {
+        return this.discoveredPlugins;
+    }
+    /** Human-readable reasons plugins were skipped by {@link gatePlugin}. */
+    pluginWarnings() {
+        return this.pluginGateWarnings;
+    }
+    /** Class names of every registered (eager) service provider. */
+    providerNames() {
+        return this.providers.map((provider) => provider.name);
+    }
     /** Register a provider that always boots. */
     register(provider) {
         this.providers.push(provider);
@@ -78,6 +94,7 @@ export class Application extends Container {
         const started = performance.now();
         for (const Provider of this.providers) {
             const provider = new Provider(this);
+            this.bootedInstances.push(provider);
             const t0 = profile ? performance.now() : 0;
             await provider.register?.();
             if (profile) {
@@ -85,7 +102,9 @@ export class Application extends Container {
             }
         }
         for (const Provider of this.providers) {
-            const provider = new Provider(this);
+            const provider = this.bootedInstances.find((p) => p.constructor === Provider);
+            if (!provider)
+                continue;
             const t0 = profile ? performance.now() : 0;
             await provider.boot?.();
             if (profile) {
@@ -94,6 +113,10 @@ export class Application extends Container {
         }
         this.booted = true;
         await this.events().emit('app.booted', { app: this });
+        this.config().onChangeNotification((key) => {
+            this.notifyConfigChanged(key);
+            void this.events().emit('config.changed', { key });
+        });
         if (!profile)
             return undefined;
         const result = {
@@ -127,24 +150,84 @@ export class Application extends Container {
             }
         }
     }
-    /** Boot lazy providers whose `bootWhen` predicate currently returns true. */
+    /** Boot lazy providers whose `bootWhen` predicate currently returns true (awaited). */
     async evaluateLazy() {
         for (const entry of this.lazyProviders) {
             if (this.bootedLazy.has(entry.provider))
                 continue;
-            if (entry.options.bootWhen?.(this)) {
+            const predicate = entry.options.bootWhen;
+            if (!predicate)
+                continue;
+            if (await predicate(this)) {
                 await this.bootLazy(entry.provider);
             }
         }
     }
+    /** Redirect command I/O streams for this application (tests, pipes). */
+    redirect(streams) {
+        this.io = { ...this.io, ...streams };
+        return this;
+    }
+    /** Current redirected streams (empty keys fall through to process). */
+    streams() {
+        return this.io;
+    }
+    /** Per-provider health: status + latency. Providers may implement `health()`. */
+    async health() {
+        const results = [];
+        for (const instance of this.bootedInstances) {
+            const name = instance.constructor.name;
+            const t0 = performance.now();
+            try {
+                const custom = await instance.health?.();
+                results.push({
+                    provider: name,
+                    status: custom?.status ?? 'ok',
+                    latencyMs: Math.round(performance.now() - t0),
+                    detail: custom?.detail,
+                });
+            }
+            catch (error) {
+                results.push({
+                    provider: name,
+                    status: 'error',
+                    latencyMs: Math.round(performance.now() - t0),
+                    detail: error instanceof Error ? error.message : String(error),
+                });
+            }
+        }
+        return results;
+    }
+    /** Notify providers of an error (lifecycle hook). */
+    async notifyError(error) {
+        for (const p of this.bootedInstances) {
+            await p.onError?.(error);
+        }
+        await this.events().emit('command.error', { command: '', error });
+    }
     async bootLazy(provider) {
         if (this.bootedLazy.has(provider))
             return;
         this.bootedLazy.add(provider);
         const instance = new provider(this);
+        this.bootedInstances.push(instance);
         await instance.register?.();
         await instance.boot?.();
     }
+    /** Notify providers that a config value was mutated. */
+    notifyConfigChanged(key) {
+        for (const p of this.bootedInstances) {
+            void p.onConfigChanged?.(key);
+        }
+    }
+    /** Shut down all booted providers, dispose container instances, emit 'app.shutdown'. */
+    async shutdown() {
+        for (const p of this.bootedInstances) {
+            await p.onShutdown?.();
+        }
+        await this.dispose();
+        await this.events().emit('app.shutdown', { app: this });
+    }
     /**
      * Discover and register every `*.provider.{ts,js}` in the given directory
      * (sorted for determinism). Exports whose name ends in `Provider` win.
@@ -159,6 +242,13 @@ export class Application extends Container {
                 }
             }
         }
+        const providersFile = (await this.listFiles(dir)).find((file) => /(?:^|\/)providers\.(ts|mts|js|mjs)$/.test(file));
+        if (providersFile) {
+            const mod = await this.importFile(providersFile);
+            const declared = mod.providers;
+            if (Array.isArray(declared))
+                this.loadProviders(declared);
+        }
         return this;
     }
     /**
@@ -170,13 +260,57 @@ export class Application extends Container {
      * 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)
+        const found = await discoverPlugins(this.basePath, options);
+        const coreVersion = options.coreVersion ?? CORE_VERSION;
+        const accepted = [];
+        const warnings = [];
+        for (const plugin of found) {
+            const gate = gatePlugin(plugin, { coreVersion, features: options.features });
+            if (!gate.ok) {
+                warnings.push(gate.reason ?? `Skipping incompatible plugin ${plugin.name}`);
+                continue;
+            }
+            accepted.push(plugin);
+            for (const provider of plugin.providers) {
+                if (this.registeredPluginProviders.has(provider))
+                    continue;
+                this.registeredPluginProviders.add(provider);
                 this.register(provider);
+            }
         }
+        this.discoveredPlugins = accepted;
+        this.pluginGateWarnings = warnings;
+        return accepted;
+    }
+    /**
+     * Re-scan plugins, cache-bust their modules, register any new providers,
+     * and boot providers that arrived after the original `boot()`. Emits
+     * `plugins.reloaded`.
+     */
+    async reloadPlugins(options = {}) {
+        const plugins = await this.discoverPlugins({
+            ...options,
+            bustCache: options.bustCache ?? true,
+        });
+        if (this.booted)
+            await this.bootPendingProviders();
+        await this.events().emit('plugins.reloaded', { app: this, plugins });
         return plugins;
     }
+    /** Register+boot providers added after the initial two-phase boot. */
+    async bootPendingProviders() {
+        const pending = this.providers.filter((Provider) => !this.bootedInstances.some((instance) => instance.constructor === Provider));
+        const started = [];
+        for (const Provider of pending) {
+            const instance = new Provider(this);
+            this.bootedInstances.push(instance);
+            started.push(instance);
+            await instance.register?.();
+        }
+        for (const instance of started) {
+            await instance.boot?.();
+        }
+    }
     /**
      * 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/events.d.ts

@@ -4,6 +4,9 @@ export interface AppEvents {
     'app.booted': {
         app: Application;
     };
+    'app.shutdown': {
+        app: Application;
+    };
     'command.before': {
         command: string;
         argv: string[];
@@ -17,6 +20,13 @@ export interface AppEvents {
         command: string;
         error: unknown;
     };
+    'config.changed': {
+        key: string;
+    };
+    'plugins.reloaded': {
+        app: Application;
+        plugins: import('./plugins.js').PluginInfo[];
+    };
 }
 export type EventHandler<E> = (payload: E) => void | Promise<void>;
 /**
@@ -25,9 +35,15 @@ export type EventHandler<E> = (payload: E) => void | Promise<void>;
  */
 export declare class EventBus {
     private readonly listeners;
+    private tracer?;
     /** Subscribe. Returns an unsubscribe function. */
     on<K extends keyof AppEvents>(event: K, handler: EventHandler<AppEvents[K]>): () => void;
     off<K extends keyof AppEvents>(event: K, handler: EventHandler<AppEvents[K]>): void;
+    /**
+     * Log every dispatch. Pass `true` to write to stderr, or a custom sink.
+     * Used by `--trace`.
+     */
+    trace(enabled: boolean | ((event: string, payload: unknown) => void)): this;
     /** Emit to all subscribers, awaiting each in order. */
     emit<K extends keyof AppEvents>(event: K, payload: AppEvents[K]): Promise<void>;
 }

package/dist/events.js

@@ -4,6 +4,7 @@
  */
 export class EventBus {
     listeners = new Map();
+    tracer;
     /** Subscribe. Returns an unsubscribe function. */
     on(event, handler) {
         let set = this.listeners.get(event);
@@ -17,8 +18,22 @@ export class EventBus {
     off(event, handler) {
         this.listeners.get(event)?.delete(handler);
     }
+    /**
+     * Log every dispatch. Pass `true` to write to stderr, or a custom sink.
+     * Used by `--trace`.
+     */
+    trace(enabled) {
+        if (enabled === false)
+            this.tracer = undefined;
+        else if (enabled === true)
+            this.tracer = (event, payload) => console.error(`[trace] ${event}`, payload);
+        else
+            this.tracer = enabled;
+        return this;
+    }
     /** Emit to all subscribers, awaiting each in order. */
     async emit(event, payload) {
+        this.tracer?.(event, payload);
         const set = this.listeners.get(event);
         if (!set)
             return;

package/dist/events.js.map

@@ -1 +1 @@
-{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAYA;;;GAGG;AACH,MAAM,OAAO,QAAQ;IACF,SAAS,GAAG,IAAI,GAAG,EAA6C,CAAC;IAElF,kDAAkD;IAClD,EAAE,CAA4B,KAAQ,EAAE,OAAmC;QACzE,IAAI,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACpC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;YAChB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACjC,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,OAA8B,CAAC,CAAC;QACxC,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,GAAG,CAA4B,KAAQ,EAAE,OAAmC;QAC1E,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,OAA8B,CAAC,CAAC;IACpE,CAAC;IAED,uDAAuD;IACvD,KAAK,CAAC,IAAI,CAA4B,KAAQ,EAAE,OAAqB;QACnE,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,CAAC,GAAG;YAAE,OAAO;QACjB,KAAK,MAAM,OAAO,IAAI,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC;YAC/B,MAAO,OAAsC,CAAC,OAAO,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAeA;;;GAGG;AACH,MAAM,OAAO,QAAQ;IACF,SAAS,GAAG,IAAI,GAAG,EAA6C,CAAC;IAC1E,MAAM,CAA6C;IAE3D,kDAAkD;IAClD,EAAE,CAA4B,KAAQ,EAAE,OAAmC;QACzE,IAAI,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACpC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;YAChB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACjC,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,OAA8B,CAAC,CAAC;QACxC,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,GAAG,CAA4B,KAAQ,EAAE,OAAmC;QAC1E,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,OAA8B,CAAC,CAAC;IACpE,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,OAA8D;QAClE,IAAI,OAAO,KAAK,KAAK;YAAE,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;aAC1C,IAAI,OAAO,KAAK,IAAI;YAAE,IAAI,CAAC,MAAM,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;;YACnG,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,uDAAuD;IACvD,KAAK,CAAC,IAAI,CAA4B,KAAQ,EAAE,OAAqB;QACnE,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,CAAC,GAAG;YAAE,OAAO;QACjB,KAAK,MAAM,OAAO,IAAI,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC;YAC/B,MAAO,OAAsC,CAAC,OAAO,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;CACF"}

package/dist/graph.d.ts

@@ -0,0 +1,17 @@
+import type { PluginInfo } from './plugins.js';
+export interface GraphEdge {
+    readonly from: string;
+    readonly to: string;
+}
+export interface ProviderGraph {
+    readonly nodes: string[];
+    readonly edges: GraphEdge[];
+}
+/**
+ * Build a DAG of plugin names (via `depends`) and the providers each
+ * plugin registers. Extra node names (app-local providers) are included
+ * as isolated vertices.
+ */
+export declare function pluginGraph(plugins: readonly PluginInfo[], extraNodes?: readonly string[]): ProviderGraph;
+/** Render a graph as ASCII `a -> b` lines or Graphviz DOT. */
+export declare function formatGraph(graph: ProviderGraph, format?: 'ascii' | 'dot'): string;

package/dist/graph.js

@@ -0,0 +1,53 @@
+/**
+ * Build a DAG of plugin names (via `depends`) and the providers each
+ * plugin registers. Extra node names (app-local providers) are included
+ * as isolated vertices.
+ */
+export function pluginGraph(plugins, extraNodes = []) {
+    const nodes = new Set(extraNodes);
+    const edges = [];
+    const seen = new Set();
+    for (const plugin of plugins) {
+        nodes.add(plugin.name);
+        for (const dep of plugin.depends ?? []) {
+            nodes.add(dep);
+            const key = `${dep}\0${plugin.name}`;
+            if (!seen.has(key)) {
+                seen.add(key);
+                edges.push({ from: dep, to: plugin.name });
+            }
+        }
+        for (const provider of plugin.providers) {
+            nodes.add(provider.name);
+            const key = `${plugin.name}\0${provider.name}`;
+            if (!seen.has(key)) {
+                seen.add(key);
+                edges.push({ from: plugin.name, to: provider.name });
+            }
+        }
+    }
+    return { nodes: [...nodes].sort(), edges };
+}
+/** Render a graph as ASCII `a -> b` lines or Graphviz DOT. */
+export function formatGraph(graph, format = 'ascii') {
+    if (format === 'dot') {
+        const lines = ['digraph {'];
+        const connected = new Set();
+        for (const edge of graph.edges) {
+            lines.push(`  "${edge.from}" -> "${edge.to}";`);
+            connected.add(edge.from);
+            connected.add(edge.to);
+        }
+        for (const node of graph.nodes) {
+            if (!connected.has(node))
+                lines.push(`  "${node}";`);
+        }
+        lines.push('}');
+        return lines.join('\n');
+    }
+    if (graph.edges.length === 0) {
+        return graph.nodes.length === 0 ? '(empty)' : graph.nodes.join('\n');
+    }
+    return graph.edges.map((edge) => `${edge.from} -> ${edge.to}`).join('\n');
+}
+//# sourceMappingURL=graph.js.map

package/dist/graph.js.map

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

package/dist/i18n.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Message catalogs for command descriptions and prompts.
+ *
+ * Lookups walk a fallback chain: the active locale, its base language
+ * (`de-AT` → `de`), then `en`, then the key itself. A `{count}` variable
+ * selects a plural form via `Intl.PluralRules` (`key.one`, `key.other`, …)
+ * before falling back to the singular key.
+ *
+ * Command descriptions can stay English; built-ins declare a `descriptionKey`
+ * so `setLocale()` changes what `--help` prints.
+ */
+export type MessageDict = Record<string, string>;
+/** Merge `dict` into the catalog for `locale` (later keys win). */
+export declare function addMessages(locale: string, dict: MessageDict): void;
+/** True when a catalog exists for this exact locale tag. */
+export declare function hasLocale(locale: string): boolean;
+/** Every registered locale tag, sorted. */
+export declare function locales(): string[];
+/**
+ * Load `<locale>.json` catalogs from a directory into the registry.
+ * Malformed files are skipped. Returns the locale tags that loaded.
+ */
+export declare function loadMessages(dir: string): string[];
+/** Switch the active locale. Unknown locales still fall back to `en`. */
+export declare function setLocale(locale: string): void;
+/** Current locale (last value passed to {@link setLocale}). */
+export declare function getLocale(): string;
+/**
+ * Resolve a locale tag from the environment. `MUDAH_LOCALE` wins, then
+ * `LC_ALL` / `LC_MESSAGES` / `LANG`. `de_DE.UTF-8` → `de-DE`. Returns
+ * undefined for unset, `C`, and `POSIX`.
+ */
+export declare function localeFromEnv(env?: Record<string, string | undefined>): string | undefined;
+/**
+ * Adopt the locale from the environment. Returns the locale that was set
+ * (`en` when the environment names none).
+ */
+export declare function setLocaleFromEnv(env?: Record<string, string | undefined>): string;
+/** True when `key` resolves in the fallback chain for `locale`. */
+export declare function hasMessage(key: string, locale?: string): boolean;
+/**
+ * Look up `key` in the active locale, falling back to the base language and
+ * then `en`, and finally returning the key itself. `{name}` placeholders are
+ * replaced from `vars`; a numeric `count` selects a plural form first.
+ */
+export declare function t(key: string, vars?: Record<string, string | number>): string;