@opensip-tools/fitness 1.0.4

package/dist/plugins/check-package-discovery.d.ts

@@ -0,0 +1,73 @@
+/**
+ * @fileoverview Auto-discovery of @opensip-tools/checks-* packages
+ * installed in node_modules.
+ *
+ * Resolution rules (apply in order):
+ *
+ *   1. If `plugins.checkPackages` is declared in the project config,
+ *      that explicit list wins. Auto-discovery is skipped entirely.
+ *      Lets users pin their check set deterministically.
+ *
+ *   2. Else if `plugins.autoDiscoverChecks: false` is declared,
+ *      no additional check packages are loaded. Lets users opt out
+ *      of dependency-based discovery (e.g. when running in an
+ *      environment with unrelated @opensip-tools packages installed).
+ *
+ *   3. Otherwise (default), scan node_modules for any package whose
+ *      name matches `@opensip-tools/checks-*` and return the list.
+ *
+ * No package is privileged — what used to be `checks-builtin` is now
+ * just one of many `@opensip-tools/checks-*` packages declared as
+ * ordinary CLI dependencies and discovered uniformly. The CLI no
+ * longer hardcodes any check package import.
+ *
+ * The walker handles pnpm's nested node_modules layout: it looks at
+ * the project's direct node_modules, then walks up to ancestor
+ * node_modules (matching Node's resolution algorithm). We don't need
+ * to recurse into transitive deps because check packages are expected
+ * to be direct dependencies.
+ */
+export interface CheckPackageDiscoveryOptions {
+    /** Absolute path to the project root (where opensip-tools.config.yml lives). */
+    readonly projectDir: string;
+    /** Explicit list from `plugins.checkPackages` in the config. */
+    readonly explicitPackages?: readonly string[];
+    /** When false, auto-discovery is disabled. Default: true. */
+    readonly autoDiscover?: boolean;
+}
+export interface DiscoveredCheckPackage {
+    /** npm package name, e.g. '@opensip-tools/checks-python'. */
+    readonly name: string;
+    /** Absolute path to the package's directory inside node_modules. */
+    readonly packageDir: string;
+}
+/**
+ * Resolve the list of check packages to load, applying the ordered
+ * resolution rules in the file header. Returns every discovered
+ * @opensip-tools/checks-* package; the CLI loads them all uniformly,
+ * with no package privileged over another.
+ */
+export declare function discoverCheckPackages(options: CheckPackageDiscoveryOptions): DiscoveredCheckPackage[];
+/**
+ * Read `name` and `main`/`exports` from a package.json. Used by the CLI
+ * to resolve the entry point of a discovered check package.
+ */
+export interface CheckPackageMetadata {
+    readonly name: string;
+    readonly mainEntry: string;
+}
+/**
+ * Read the `plugins.checkPackages` and `plugins.autoDiscoverChecks`
+ * fields from the project's opensip-tools.config.yml without doing a
+ * full schema parse. Returns the raw values so callers can apply the
+ * resolution rules in `discoverCheckPackages()`.
+ *
+ * Mirrors the inline-yaml-read pattern used by readProjectPluginsList()
+ * — avoids a circular dep between plugins/ and targets/.
+ */
+export declare function readCheckPackagePreferences(projectDir: string): {
+    readonly checkPackages?: readonly string[];
+    readonly autoDiscoverChecks?: boolean;
+};
+export declare function readCheckPackageMetadata(packageDir: string): CheckPackageMetadata | undefined;
+//# sourceMappingURL=check-package-discovery.d.ts.map

package/dist/plugins/check-package-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-package-discovery.d.ts","sourceRoot":"","sources":["../../src/plugins/check-package-discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAoBH,MAAM,WAAW,4BAA4B;IAC3C,gFAAgF;IAChF,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,gEAAgE;IAChE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC7C,6DAA6D;IAC7D,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAA;CAChC;AAED,MAAM,WAAW,sBAAsB;IACrC,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,oEAAoE;IACpE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,4BAA4B,GACpC,sBAAsB,EAAE,CAgC1B;AA2DD;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG;IAC/D,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC1C,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAA;CACtC,CAsBA;AAGD,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS,CAgC7F"}

package/dist/plugins/check-package-discovery.js

@@ -0,0 +1,212 @@
+/**
+ * @fileoverview Auto-discovery of @opensip-tools/checks-* packages
+ * installed in node_modules.
+ *
+ * Resolution rules (apply in order):
+ *
+ *   1. If `plugins.checkPackages` is declared in the project config,
+ *      that explicit list wins. Auto-discovery is skipped entirely.
+ *      Lets users pin their check set deterministically.
+ *
+ *   2. Else if `plugins.autoDiscoverChecks: false` is declared,
+ *      no additional check packages are loaded. Lets users opt out
+ *      of dependency-based discovery (e.g. when running in an
+ *      environment with unrelated @opensip-tools packages installed).
+ *
+ *   3. Otherwise (default), scan node_modules for any package whose
+ *      name matches `@opensip-tools/checks-*` and return the list.
+ *
+ * No package is privileged — what used to be `checks-builtin` is now
+ * just one of many `@opensip-tools/checks-*` packages declared as
+ * ordinary CLI dependencies and discovered uniformly. The CLI no
+ * longer hardcodes any check package import.
+ *
+ * The walker handles pnpm's nested node_modules layout: it looks at
+ * the project's direct node_modules, then walks up to ancestor
+ * node_modules (matching Node's resolution algorithm). We don't need
+ * to recurse into transitive deps because check packages are expected
+ * to be direct dependencies.
+ */
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { dirname, join } from 'node:path';
+import { logger } from '@opensip-tools/core';
+const CONFIG_FILENAME = 'opensip-tools.config.yml';
+// Bridge ESM ↔ CJS: createRequire bound to this module's URL gives us a
+// `require` that resolves js-yaml from this package's own deps. The bare
+// `require('js-yaml')` form fails in ESM because no global require is
+// present; using createRequire(import.meta.url) is the supported escape
+// hatch.
+const requireFromHere = createRequire(import.meta.url);
+const SCOPE = '@opensip-tools';
+const CHECKS_PREFIX = 'checks-';
+/**
+ * Resolve the list of check packages to load, applying the ordered
+ * resolution rules in the file header. Returns every discovered
+ * @opensip-tools/checks-* package; the CLI loads them all uniformly,
+ * with no package privileged over another.
+ */
+export function discoverCheckPackages(options) {
+    const { projectDir, explicitPackages, autoDiscover = true } = options;
+    // Rule 1: explicit list wins
+    if (explicitPackages !== undefined) {
+        if (explicitPackages.length === 0) {
+            return [];
+        }
+        const out = [];
+        for (const name of explicitPackages) {
+            const dir = resolvePackageDir(projectDir, name);
+            if (dir) {
+                out.push({ name, packageDir: dir });
+            }
+            else {
+                logger.warn({
+                    evt: 'plugin.check_package.not_resolved',
+                    module: 'core:plugins',
+                    name,
+                    msg: `Configured check package "${name}" is not installed in node_modules — skipping`,
+                });
+            }
+        }
+        return out;
+    }
+    // Rule 2: opt-out
+    if (!autoDiscover) {
+        return [];
+    }
+    // Rule 3: auto-discover
+    return autoDiscoverChecks(projectDir);
+}
+/**
+ * Walk up the directory tree from `projectDir` looking for the first
+ * `node_modules/@opensip-tools/` directory and return all `checks-*`
+ * package directories found there. Mirrors Node's module resolution
+ * (any ancestor node_modules counts), which handles pnpm hoisting and
+ * monorepo layouts where the scope may live in the workspace root.
+ */
+// eslint-disable-next-line sonarjs/cognitive-complexity -- ancestor-walk discovery: walks node_modules trees up the directory tree until the filesystem root
+function autoDiscoverChecks(projectDir) {
+    const seen = new Set();
+    const out = [];
+    let dir = projectDir;
+    let prev = '';
+    while (dir !== prev) {
+        const scopeDir = join(dir, 'node_modules', SCOPE);
+        if (existsSync(scopeDir)) {
+            for (const entry of safeReaddir(scopeDir)) {
+                if (!entry.startsWith(CHECKS_PREFIX))
+                    continue;
+                const name = `${SCOPE}/${entry}`;
+                if (seen.has(name))
+                    continue;
+                const packageDir = join(scopeDir, entry);
+                if (!hasPackageJson(packageDir))
+                    continue;
+                seen.add(name);
+                out.push({ name, packageDir });
+            }
+        }
+        prev = dir;
+        dir = dirname(dir);
+    }
+    return out;
+}
+function resolvePackageDir(projectDir, name) {
+    let dir = projectDir;
+    let prev = '';
+    while (dir !== prev) {
+        const candidate = join(dir, 'node_modules', name);
+        if (hasPackageJson(candidate))
+            return candidate;
+        prev = dir;
+        dir = dirname(dir);
+    }
+    return undefined;
+}
+function hasPackageJson(packageDir) {
+    if (!existsSync(packageDir))
+        return false;
+    return existsSync(join(packageDir, 'package.json'));
+}
+function safeReaddir(dir) {
+    try {
+        return readdirSync(dir);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Read the `plugins.checkPackages` and `plugins.autoDiscoverChecks`
+ * fields from the project's opensip-tools.config.yml without doing a
+ * full schema parse. Returns the raw values so callers can apply the
+ * resolution rules in `discoverCheckPackages()`.
+ *
+ * Mirrors the inline-yaml-read pattern used by readProjectPluginsList()
+ * — avoids a circular dep between plugins/ and targets/.
+ */
+export function readCheckPackagePreferences(projectDir) {
+    const configPath = join(projectDir, CONFIG_FILENAME);
+    if (!existsSync(configPath))
+        return {};
+    try {
+        const raw = readFileSync(configPath, 'utf8');
+        const yaml = requireFromHere('js-yaml');
+        const doc = yaml.load(raw);
+        if (!doc || typeof doc !== 'object')
+            return {};
+        const plugins = doc.plugins;
+        if (!plugins || typeof plugins !== 'object')
+            return {};
+        const p = plugins;
+        const result = {};
+        if (Array.isArray(p.checkPackages)) {
+            result.checkPackages = p.checkPackages.filter((v) => typeof v === 'string');
+        }
+        if (typeof p.autoDiscoverChecks === 'boolean') {
+            result.autoDiscoverChecks = p.autoDiscoverChecks;
+        }
+        return result;
+    }
+    catch {
+        return {};
+    }
+}
+// eslint-disable-next-line sonarjs/cognitive-complexity -- exports-map resolution: each branch corresponds to a documented npm exports shape (string, object with import/default/require)
+export function readCheckPackageMetadata(packageDir) {
+    const pkgPath = join(packageDir, 'package.json');
+    if (!existsSync(pkgPath))
+        return undefined;
+    try {
+        const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+        if (!pkg.name)
+            return undefined;
+        let mainEntry;
+        const exports = pkg.exports;
+        if (typeof exports === 'string') {
+            mainEntry = exports;
+        }
+        else if (exports && typeof exports === 'object' && '.' in exports) {
+            const dot = exports['.'];
+            if (typeof dot === 'string') {
+                mainEntry = dot;
+            }
+            else if (dot && typeof dot === 'object') {
+                const obj = dot;
+                if (typeof obj.import === 'string')
+                    mainEntry = obj.import;
+                else if (typeof obj.default === 'string')
+                    mainEntry = obj.default;
+            }
+        }
+        if (!mainEntry && typeof pkg.main === 'string') {
+            mainEntry = pkg.main;
+        }
+        mainEntry ??= './index.js';
+        return { name: pkg.name, mainEntry: join(packageDir, mainEntry) };
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=check-package-discovery.js.map

package/dist/plugins/check-package-discovery.js.map

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

package/dist/plugins/loader.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @fileoverview Plugin loader — dynamic import and registration
+ *
+ * Takes discovered plugins, imports them, validates their exports,
+ * and registers checks/recipes with namespaces.
+ */
+import type { DiscoveredPlugin, LoadedPlugin, PluginDomain, PluginLoadResult } from '@opensip-tools/core';
+/**
+ * Load a single discovered plugin.
+ *
+ * For `domain === 'lang'`, the module is expected to export an `adapters`
+ * array of LanguageAdapter; each is registered with defaultLanguageRegistry.
+ * For other domains, registers checks and recipes with defaultRegistry and
+ * defaultRecipeRegistry respectively.
+ */
+export declare function loadPlugin(plugin: DiscoveredPlugin, domain?: PluginDomain): Promise<LoadedPlugin>;
+/**
+ * Discover and load all plugins for a domain. Loads sequentially to
+ * ensure deterministic registration order.
+ *
+ * Discovers loose `.mjs` files under
+ * `<projectDir>/opensip-tools/<tool>/{checks,recipes,scenarios}/` plus
+ * any npm-installed packages in
+ * `<projectDir>/opensip-tools/.runtime/plugins/<domain>/node_modules/`
+ * that are listed in `plugins.<domain>` in the project config.
+ *
+ * Without a `projectDir`, no plugins are loaded — there's no
+ * user-global fallback.
+ */
+export declare function loadAllPlugins(domain: PluginDomain, projectDir?: string): Promise<PluginLoadResult>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/plugins/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/plugins/loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAaH,OAAO,KAAK,EACV,gBAAgB,EAEhB,YAAY,EACZ,YAAY,EACZ,gBAAgB,EACjB,MAAM,qBAAqB,CAAA;AAK5B;;;;;;;GAOG;AAEH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,gBAAgB,EACxB,MAAM,GAAE,YAAoB,GAC3B,OAAO,CAAC,YAAY,CAAC,CAmOvB;AAqBD;;;;;;;;;;;;GAYG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,YAAY,EACpB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,gBAAgB,CAAC,CAqB3B"}

package/dist/plugins/loader.js

@@ -0,0 +1,290 @@
+/**
+ * @fileoverview Plugin loader — dynamic import and registration
+ *
+ * Takes discovered plugins, imports them, validates their exports,
+ * and registers checks/recipes with namespaces.
+ */
+import { pathToFileURL } from 'node:url';
+import { logger, defaultLanguageRegistry, discoverPlugins } from '@opensip-tools/core';
+import { isCheck } from '../framework/check-types.js';
+import { defaultRegistry } from '../framework/registry.js';
+import { defaultRecipeRegistry } from '../recipes/registry.js';
+/** Logger module tag used by every event emitted from this loader. */
+const MODULE_TAG = 'core:plugins';
+/**
+ * Load a single discovered plugin.
+ *
+ * For `domain === 'lang'`, the module is expected to export an `adapters`
+ * array of LanguageAdapter; each is registered with defaultLanguageRegistry.
+ * For other domains, registers checks and recipes with defaultRegistry and
+ * defaultRecipeRegistry respectively.
+ */
+// eslint-disable-next-line sonarjs/cognitive-complexity -- plugin loader dispatcher: handles three domains and lifecycle (validate, register, error-wrap) inline; splitting fragments error context
+export async function loadPlugin(plugin, domain = 'fit') {
+    try {
+        const moduleUrl = pathToFileURL(plugin.entryPoint).href;
+        const mod = await import(moduleUrl);
+        let checksRegistered = 0;
+        let recipesRegistered = 0;
+        let adaptersRegistered = 0;
+        // Lang domain: register language adapters from `adapters` array,
+        // named exports, and default export. Adapters are deduplicated by id.
+        if (domain === 'lang') {
+            const registeredAdapterIds = new Set();
+            const tryRegisterAdapter = (value, sourceLabel) => {
+                if (!looksLikeLanguageAdapter(value))
+                    return;
+                const id = value.id;
+                if (registeredAdapterIds.has(id))
+                    return;
+                defaultLanguageRegistry.register(value);
+                registeredAdapterIds.add(id);
+                adaptersRegistered++;
+                logger.debug({
+                    evt: 'plugin.loader.adapter.registered',
+                    module: MODULE_TAG,
+                    namespace: plugin.namespace,
+                    source: sourceLabel,
+                    id,
+                });
+            };
+            if (mod.adapters !== undefined) {
+                if (Array.isArray(mod.adapters)) {
+                    for (const [index, adapter] of mod.adapters.entries()) {
+                        if (looksLikeLanguageAdapter(adapter)) {
+                            tryRegisterAdapter(adapter, `adapters[${index}]`);
+                        }
+                        else {
+                            logger.warn({
+                                evt: 'plugin.loader.invalid_adapter_item',
+                                module: MODULE_TAG,
+                                namespace: plugin.namespace,
+                                source: plugin.source,
+                                index,
+                                msg: `Plugin "${plugin.namespace}" adapters[${index}] is not a valid LanguageAdapter — skipping.`,
+                            });
+                        }
+                    }
+                }
+                else {
+                    logger.warn({
+                        evt: 'plugin.loader.invalid_adapters_export',
+                        module: MODULE_TAG,
+                        namespace: plugin.namespace,
+                        source: plugin.source,
+                        msg: `Plugin "${plugin.namespace}" exports "adapters" but it is not an array — skipping adapter registration.`,
+                    });
+                }
+            }
+            // Named exports that look like LanguageAdapter
+            for (const [exportName, value] of Object.entries(mod)) {
+                if (exportName === 'default' ||
+                    exportName === 'adapters' ||
+                    exportName === 'checks' ||
+                    exportName === 'recipes' ||
+                    exportName === 'metadata')
+                    continue;
+                tryRegisterAdapter(value, `named:${exportName}`);
+            }
+            // Default export: a single LanguageAdapter
+            const defaultExport = mod.default;
+            tryRegisterAdapter(defaultExport, 'default');
+        }
+        // Register checks with namespace (skipped for lang domain).
+        //
+        // Two authorship styles are supported:
+        //   1. `export const checks = [...]`  — array of Check instances
+        //   2. `export const myCheck = defineCheck({...})` — Check as a named export
+        //
+        // Style 2 enables single-file plugins that drop into ~/.opensip-tools/fit/
+        // to author one check per file without a redundant array wrapper.
+        // Both styles can coexist in the same module; checks are deduplicated by
+        // their stable id so a check appearing in both an array and a named
+        // export is registered exactly once.
+        if (domain !== 'lang') {
+            const registeredIds = new Set();
+            // Style 1: explicit `checks` array
+            if (mod.checks !== undefined) {
+                if (Array.isArray(mod.checks)) {
+                    for (const [index, check] of mod.checks.entries()) {
+                        if (isCheck(check)) {
+                            if (!registeredIds.has(check.config.id)) {
+                                defaultRegistry.register(check, plugin.namespace);
+                                registeredIds.add(check.config.id);
+                                checksRegistered++;
+                            }
+                        }
+                        else {
+                            logger.warn({
+                                evt: 'plugin.loader.invalid_check_item',
+                                module: MODULE_TAG,
+                                namespace: plugin.namespace,
+                                source: plugin.source,
+                                index,
+                                msg: `Plugin "${plugin.namespace}" checks[${index}] is not a valid Check object — skipping.`,
+                            });
+                        }
+                    }
+                }
+                else {
+                    logger.warn({
+                        evt: 'plugin.loader.invalid_checks_export',
+                        module: MODULE_TAG,
+                        namespace: plugin.namespace,
+                        source: plugin.source,
+                        msg: `Plugin "${plugin.namespace}" exports "checks" but it is not an array — skipping checks registration.`,
+                    });
+                }
+            }
+            // Style 2: any named export that is a Check instance
+            for (const [exportName, value] of Object.entries(mod)) {
+                if (exportName === 'default' || exportName === 'checks' || exportName === 'recipes' || exportName === 'metadata')
+                    continue;
+                if (isCheck(value) && !registeredIds.has(value.config.id)) {
+                    defaultRegistry.register(value, plugin.namespace);
+                    registeredIds.add(value.config.id);
+                    checksRegistered++;
+                }
+            }
+            // Default export: a single Check instance
+            const defaultExport = mod.default;
+            if (isCheck(defaultExport) && !registeredIds.has(defaultExport.config.id)) {
+                defaultRegistry.register(defaultExport, plugin.namespace);
+                registeredIds.add(defaultExport.config.id);
+                checksRegistered++;
+            }
+        }
+        // Register recipes (skipped for lang domain)
+        if (domain !== 'lang' && mod.recipes !== undefined) {
+            const recipes = mod.recipes;
+            for (const [index, recipe] of recipes.entries()) {
+                if (recipe && typeof recipe === 'object' && 'id' in recipe && 'name' in recipe) {
+                    try {
+                        defaultRecipeRegistry.register(recipe, { allowOverwrite: false });
+                        recipesRegistered++;
+                    }
+                    catch {
+                        // Duplicate recipe — skip silently
+                    }
+                }
+                else {
+                    logger.warn({
+                        evt: 'plugin.loader.invalid_recipe_item',
+                        module: MODULE_TAG,
+                        namespace: plugin.namespace,
+                        source: plugin.source,
+                        index,
+                        msg: `Plugin "${plugin.namespace}" recipes[${index}] is not a valid Recipe object (missing id or name) — skipping.`,
+                    });
+                }
+            }
+        }
+        // Warn only when nothing was registered. With named-export discovery,
+        // counting actual registrations is more accurate than checking which
+        // declared exports were present.
+        const nothingRegistered = domain === 'lang'
+            ? adaptersRegistered === 0
+            : checksRegistered === 0 && recipesRegistered === 0;
+        if (nothingRegistered) {
+            logger.warn({
+                evt: 'plugin.loader.no_exports',
+                module: MODULE_TAG,
+                namespace: plugin.namespace,
+                source: plugin.source,
+                domain,
+                msg: domain === 'lang'
+                    ? `Plugin "${plugin.namespace}" registered no language adapters — nothing to use.`
+                    : `Plugin "${plugin.namespace}" registered no checks or recipes — nothing to run.`,
+            });
+        }
+        logger.info({
+            evt: 'plugin.loader.load.success',
+            module: MODULE_TAG,
+            namespace: plugin.namespace,
+            source: plugin.source,
+            domain,
+            checksRegistered,
+            recipesRegistered,
+            adaptersRegistered,
+        });
+        return {
+            namespace: plugin.namespace,
+            source: plugin.source,
+            type: plugin.type,
+            checksRegistered,
+            recipesRegistered,
+            adaptersRegistered,
+        };
+    }
+    catch (error) {
+        const errorMsg = error instanceof Error ? error.message : String(error);
+        logger.warn({
+            evt: 'plugin.loader.load.error',
+            module: MODULE_TAG,
+            namespace: plugin.namespace,
+            source: plugin.source,
+            error: errorMsg,
+            err: error instanceof Error ? error : undefined,
+            msg: `Plugin "${plugin.namespace}" failed to load: ${errorMsg}. Continuing without this plugin.`,
+        });
+        return {
+            namespace: plugin.namespace,
+            source: plugin.source,
+            type: plugin.type,
+            checksRegistered: 0,
+            recipesRegistered: 0,
+            adaptersRegistered: 0,
+            error: errorMsg,
+        };
+    }
+}
+/**
+ * Structural check for LanguageAdapter — used by the lang plugin domain
+ * to identify adapter values among arbitrary named exports. We don't
+ * have a runtime type guard equivalent to isCheck() for adapters, so
+ * we duck-type the required surface (`id`, `fileExtensions`, `parse`,
+ * `stripStrings`, `stripComments`).
+ */
+function looksLikeLanguageAdapter(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const v = value;
+    return (typeof v.id === 'string' &&
+        Array.isArray(v.fileExtensions) &&
+        typeof v.parse === 'function' &&
+        typeof v.stripStrings === 'function' &&
+        typeof v.stripComments === 'function');
+}
+/**
+ * Discover and load all plugins for a domain. Loads sequentially to
+ * ensure deterministic registration order.
+ *
+ * Discovers loose `.mjs` files under
+ * `<projectDir>/opensip-tools/<tool>/{checks,recipes,scenarios}/` plus
+ * any npm-installed packages in
+ * `<projectDir>/opensip-tools/.runtime/plugins/<domain>/node_modules/`
+ * that are listed in `plugins.<domain>` in the project config.
+ *
+ * Without a `projectDir`, no plugins are loaded — there's no
+ * user-global fallback.
+ */
+export async function loadAllPlugins(domain, projectDir) {
+    const discovered = discoverPlugins(domain, projectDir);
+    const plugins = [];
+    const errors = [];
+    for (const plugin of discovered) {
+        const result = await loadPlugin(plugin, domain);
+        plugins.push(result);
+        if (result.error) {
+            errors.push(`${result.source}: ${result.error}`);
+        }
+    }
+    return {
+        plugins,
+        totalChecks: plugins.reduce((sum, p) => sum + p.checksRegistered, 0),
+        totalRecipes: plugins.reduce((sum, p) => sum + p.recipesRegistered, 0),
+        totalAdapters: plugins.reduce((sum, p) => sum + (p.adaptersRegistered ?? 0), 0),
+        errors,
+    };
+}
+//# sourceMappingURL=loader.js.map

package/dist/plugins/loader.js.map

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

package/dist/plugins/types.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @fileoverview Fitness plugin export contract
+ *
+ * What an @opensip-tools/checks-* (or any fit-domain plugin) exports.
+ * Held in fitness because it references Check / FitnessRecipe — types
+ * the kernel doesn't know about.
+ */
+import type { Check } from '../framework/check-types.js';
+import type { FitnessRecipe } from '../recipes/types.js';
+import type { CheckDisplayEntry, PluginMetadata } from '@opensip-tools/core';
+/** What a fitness plugin package/file exports */
+export interface FitPluginExports {
+    readonly checks?: readonly Check[];
+    readonly recipes?: readonly FitnessRecipe[];
+    readonly metadata?: PluginMetadata;
+    /**
+     * Optional display map: check slug → [icon, displayName].
+     * The CLI merges these from every loaded check package and uses
+     * the merged map when rendering tables and dashboard catalog entries.
+     */
+    readonly checkDisplay?: Readonly<Record<string, CheckDisplayEntry>>;
+}
+//# sourceMappingURL=types.d.ts.map