@opensip-tools/fitness 1.0.4

package/dist/targets/__tests__/target-registry.test.js

@@ -0,0 +1,89 @@
+import { describe, expect, it } from 'vitest';
+import { TargetRegistry } from '../target-registry.js';
+const stub = (name, opts = {}) => ({
+    config: {
+        name,
+        description: name,
+        include: [`${name}/**`],
+        exclude: [],
+        ...(opts.tags && { tags: opts.tags }),
+        ...(opts.languages && { languages: opts.languages }),
+        ...(opts.concerns && { concerns: opts.concerns }),
+    },
+});
+describe('TargetRegistry', () => {
+    it('register adds new targets and returns this for chaining', () => {
+        const reg = new TargetRegistry();
+        const result = reg.register(stub('a')).register(stub('b'));
+        expect(result).toBe(reg);
+        expect(reg.size).toBe(2);
+    });
+    it('register silently skips duplicate names', () => {
+        const reg = new TargetRegistry();
+        reg.register(stub('a'));
+        reg.register(stub('a'));
+        expect(reg.size).toBe(1);
+    });
+    it('getByName / has lookups', () => {
+        const reg = new TargetRegistry();
+        const a = stub('a');
+        reg.register(a);
+        expect(reg.getByName('a')).toBe(a);
+        expect(reg.getByName('nope')).toBeUndefined();
+        expect(reg.has('a')).toBe(true);
+        expect(reg.has('nope')).toBe(false);
+    });
+    it('getAll returns the live set, but a fresh array each call', () => {
+        const reg = new TargetRegistry();
+        reg.register(stub('a'));
+        const snapshot = reg.getAll();
+        expect(snapshot).toHaveLength(1);
+        snapshot.pop();
+        expect(reg.getAll()).toHaveLength(1); // not affected
+    });
+    it('getByTag filters by config.tags', () => {
+        const reg = new TargetRegistry();
+        reg.register(stub('a', { tags: ['fast'] }));
+        reg.register(stub('b', { tags: ['slow'] }));
+        reg.register(stub('c'));
+        expect(reg.getByTag('fast').map((t) => t.config.name)).toEqual(['a']);
+    });
+    describe('findByScope', () => {
+        it('returns targets whose languages intersect when both sides specify', () => {
+            const reg = new TargetRegistry();
+            reg.register(stub('ts', { languages: ['typescript'], concerns: ['backend'] }));
+            reg.register(stub('rs', { languages: ['rust'], concerns: ['backend'] }));
+            const matched = reg.findByScope(['typescript'], ['backend']);
+            expect(matched.map((t) => t.config.name)).toEqual(['ts']);
+        });
+        it('treats empty check languages as "matches any"', () => {
+            const reg = new TargetRegistry();
+            reg.register(stub('ts', { languages: ['typescript'], concerns: ['backend'] }));
+            reg.register(stub('rs', { languages: ['rust'], concerns: ['backend'] }));
+            expect(reg.findByScope([], ['backend'])).toHaveLength(2);
+        });
+        it('treats targets with no languages as "matches any check language"', () => {
+            const reg = new TargetRegistry();
+            reg.register(stub('any-lang', { concerns: ['backend'] })); // no languages
+            expect(reg.findByScope(['typescript'], ['backend'])).toHaveLength(1);
+        });
+        it('treats empty check concerns as "matches any"', () => {
+            const reg = new TargetRegistry();
+            reg.register(stub('ts', { languages: ['typescript'], concerns: ['backend'] }));
+            expect(reg.findByScope(['typescript'], [])).toHaveLength(1);
+        });
+        it('requires both dimensions to match', () => {
+            const reg = new TargetRegistry();
+            reg.register(stub('ts-frontend', { languages: ['typescript'], concerns: ['frontend'] }));
+            expect(reg.findByScope(['typescript'], ['backend'])).toEqual([]);
+        });
+    });
+    it('clear removes everything', () => {
+        const reg = new TargetRegistry();
+        reg.register(stub('a'));
+        reg.clear();
+        expect(reg.size).toBe(0);
+        expect(reg.getAll()).toEqual([]);
+    });
+});
+//# sourceMappingURL=target-registry.test.js.map

package/dist/targets/__tests__/target-registry.test.js.map

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

package/dist/targets/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview Target system barrel export
+ *
+ * Public API for config-driven targets:
+ * - loadTargetsConfig() — Load from opensip-tools.config.yml
+ * - resolveTargetFiles() — Expand globs, deduplicate
+ */
+export { loadTargetsConfig } from './loader.js';
+export { resolveTargetFiles } from './resolver.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/targets/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/targets/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAG/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA"}

package/dist/targets/index.js

@@ -0,0 +1,12 @@
+/**
+ * @fileoverview Target system barrel export
+ *
+ * Public API for config-driven targets:
+ * - loadTargetsConfig() — Load from opensip-tools.config.yml
+ * - resolveTargetFiles() — Expand globs, deduplicate
+ */
+// Loader
+export { loadTargetsConfig } from './loader.js';
+// Resolver
+export { resolveTargetFiles } from './resolver.js';
+//# sourceMappingURL=index.js.map

package/dist/targets/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/targets/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,SAAS;AACT,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAE/C,WAAW;AACX,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA"}

package/dist/targets/loader.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @fileoverview Target config loader
+ *
+ * Loads target configuration from opensip-tools.config.yml in the project root.
+ * Validates with Zod and populates a TargetRegistry.
+ */
+import { TargetRegistry } from './target-registry.js';
+import type { TargetsConfig } from './types.js';
+/**
+ * Load full targets config including per-check target overrides.
+ * Resolves via the shared project-config resolver.
+ * @throws {ValidationError} When no targets config file is found or it cannot be loaded
+ * @throws {ValidationError} When the config file fails schema validation
+ */
+export declare function loadTargetsConfig(rootDir: string, explicitPath?: string): {
+    registry: TargetRegistry;
+    config: TargetsConfig;
+};
+//# sourceMappingURL=loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/targets/loader.ts"],"names":[],"mappings":"AACA;;;;;GAKG;AASH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAErD,OAAO,KAAK,EAAgB,aAAa,EAAE,MAAM,YAAY,CAAA;AAwL7D;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,MAAM,GACpB;IAAE,QAAQ,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,aAAa,CAAA;CAAE,CAGrD"}

package/dist/targets/loader.js

@@ -0,0 +1,159 @@
+// @fitness-ignore-file batch-operation-limits -- iterates bounded collections (config entries, registry items, or small analysis results)
+/**
+ * @fileoverview Target config loader
+ *
+ * Loads target configuration from opensip-tools.config.yml in the project root.
+ * Validates with Zod and populates a TargetRegistry.
+ */
+import { readFileSync, statSync } from 'node:fs';
+import { PROJECT_CONFIG_FILENAME, resolveProjectConfigPath, ValidationError, SystemError } from '@opensip-tools/core';
+import yaml from 'js-yaml';
+import { z } from 'zod';
+import { TargetRegistry } from './target-registry.js';
+const YAML_FILENAME = PROJECT_CONFIG_FILENAME;
+const DEFAULT_EXCLUDES = ['**/node_modules/**', '**/dist/**'];
+// =============================================================================
+// YAML schemas
+// =============================================================================
+const TargetEntrySchema = z.object({
+    description: z.string().min(1, 'description is required'),
+    include: z.array(z.string()).min(1, 'at least one include pattern is required'),
+    exclude: z.array(z.string()).optional(),
+    tags: z.array(z.string()).optional(),
+    languages: z.array(z.string()).optional(),
+    concerns: z.array(z.string()).optional(),
+});
+const CheckTargetValueSchema = z.union([
+    z.string(),
+    z.array(z.string()).min(1),
+]);
+const PluginsSchema = z.object({
+    fit: z.array(z.string()).optional(),
+    sim: z.array(z.string()).optional(),
+    asm: z.array(z.string()).optional(),
+    lang: z.array(z.string()).optional(),
+    checkPackages: z.array(z.string()).optional(),
+    autoDiscoverChecks: z.boolean().optional(),
+}).optional();
+const TargetsFileSchema = z.object({
+    targets: z.record(z.string().regex(/^[a-z0-9]+(-[a-z0-9]+)*$/, 'target name must be kebab-case'), TargetEntrySchema),
+    globalExcludes: z.array(z.string()).optional(),
+    checkOverrides: z.record(z.string(), CheckTargetValueSchema).optional(),
+    plugins: PluginsSchema,
+});
+// =============================================================================
+// Build registry + config from parsed data
+// =============================================================================
+/** @throws {ValidationError} When checkOverrides references an unknown target */
+// eslint-disable-next-line sonarjs/cognitive-complexity -- inherent complexity: registry population + cross-validation
+function buildFromParsed(targets, rawGlobalExcludes, rawCheckOverrides, sourceLabel, rawPlugins) {
+    const registry = new TargetRegistry();
+    for (const [name, entry] of Object.entries(targets)) {
+        const config = Object.freeze({
+            name,
+            description: entry.description,
+            include: Object.freeze([...entry.include]),
+            exclude: Object.freeze([...(entry.exclude ?? DEFAULT_EXCLUDES)]),
+            ...(entry.tags && { tags: Object.freeze([...entry.tags]) }),
+            ...(entry.languages && { languages: Object.freeze([...entry.languages]) }),
+            ...(entry.concerns && { concerns: Object.freeze([...entry.concerns]) }),
+        });
+        registry.register(Object.freeze({ config }));
+    }
+    const checkOverrides = {};
+    if (rawCheckOverrides) {
+        for (const [checkSlug, targetRef] of Object.entries(rawCheckOverrides)) {
+            const targetNames = typeof targetRef === 'string' ? [targetRef] : targetRef;
+            for (const name of targetNames) {
+                if (!registry.has(name)) {
+                    // @fitness-ignore-next-line result-pattern-consistency -- infrastructure boundary, throw is appropriate
+                    throw new ValidationError(`${sourceLabel}: checkOverrides['${checkSlug}'] references unknown target '${name}'. ` +
+                        `Available targets: ${registry.getAll().map((t) => t.config.name).join(', ')}`, { code: 'ERRORS.TARGETS.UNKNOWN_TARGET' });
+                }
+            }
+            checkOverrides[checkSlug] = typeof targetRef === 'string' ? targetRef : Object.freeze([...targetRef]);
+        }
+    }
+    const plugins = rawPlugins
+        ? Object.freeze({
+            ...(rawPlugins.fit && { fit: Object.freeze([...rawPlugins.fit]) }),
+            ...(rawPlugins.sim && { sim: Object.freeze([...rawPlugins.sim]) }),
+            ...(rawPlugins.asm && { asm: Object.freeze([...rawPlugins.asm]) }),
+            ...(rawPlugins.lang && { lang: Object.freeze([...rawPlugins.lang]) }),
+            ...(rawPlugins.checkPackages && { checkPackages: Object.freeze([...rawPlugins.checkPackages]) }),
+            ...(rawPlugins.autoDiscoverChecks !== undefined && { autoDiscoverChecks: rawPlugins.autoDiscoverChecks }),
+        })
+        : undefined;
+    const config = Object.freeze({
+        globalExcludes: Object.freeze(rawGlobalExcludes ? [...rawGlobalExcludes] : []),
+        checkOverrides: Object.freeze(checkOverrides),
+        ...(plugins && { plugins }),
+    });
+    return { registry, config };
+}
+// =============================================================================
+// YAML config loader
+// =============================================================================
+const MAX_FILE_SIZE = 10 * 1024 * 1024; // 10 MB
+/** @throws {ValidationError} When the file is too large, missing, or unreadable */
+function readYamlFile(filePath) {
+    try {
+        const stats = statSync(filePath);
+        if (stats.size > MAX_FILE_SIZE) {
+            throw new SystemError(`File too large (${stats.size} bytes, max ${MAX_FILE_SIZE}): ${filePath}`, { code: 'SYSTEM.FILE.TOO_LARGE' });
+        }
+        return readFileSync(filePath, 'utf8');
+    }
+    catch (error) {
+        if (error instanceof ValidationError || error instanceof SystemError)
+            throw error;
+        throw new ValidationError(`${YAML_FILENAME} not found at ${filePath}. Create one to define your targets.`, { operation: 'load', loader: 'targets' });
+    }
+}
+/** @throws {ValidationError} When the YAML is malformed */
+function parseYamlContent(raw) {
+    try {
+        return yaml.load(raw);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new ValidationError(`${YAML_FILENAME} contains invalid YAML: ${message}`, {
+            operation: 'load',
+            loader: 'targets',
+            cause: error instanceof Error ? error : undefined,
+        });
+    }
+}
+/**
+ * @throws {ValidationError} When the file is missing or contains invalid YAML
+ * @throws {ValidationError} When the file fails schema validation
+ */
+function loadYamlConfig(filePath) {
+    const raw = readYamlFile(filePath);
+    const parsed = parseYamlContent(raw);
+    const result = TargetsFileSchema.safeParse(parsed);
+    if (!result.success) {
+        const issues = result.error.issues
+            .map((i) => `  ${i.path.join('.')}: ${i.message}`)
+            .join('\n');
+        // @fitness-ignore-next-line result-pattern-consistency -- infrastructure boundary, throw is appropriate
+        throw new ValidationError(`${YAML_FILENAME} validation failed:\n${issues}`, {
+            code: 'ERRORS.TARGETS.VALIDATION_FAILED',
+        });
+    }
+    return buildFromParsed(result.data.targets, result.data.globalExcludes, result.data.checkOverrides, YAML_FILENAME, result.data.plugins);
+}
+// =============================================================================
+// Public API
+// =============================================================================
+/**
+ * Load full targets config including per-check target overrides.
+ * Resolves via the shared project-config resolver.
+ * @throws {ValidationError} When no targets config file is found or it cannot be loaded
+ * @throws {ValidationError} When the config file fails schema validation
+ */
+export function loadTargetsConfig(rootDir, explicitPath) {
+    const yamlPath = resolveProjectConfigPath(rootDir, explicitPath);
+    return loadYamlConfig(yamlPath);
+}
+//# sourceMappingURL=loader.js.map

package/dist/targets/loader.js.map

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

package/dist/targets/resolver.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @fileoverview Target file resolver
+ *
+ * Expands target glob patterns to concrete file paths,
+ * deduplicating across multiple targets.
+ */
+import type { Target } from './types.js';
+/**
+ * Resolve multiple targets to a deduplicated list of file paths.
+ *
+ * Expands include globs, filters out exclude globs, and deduplicates
+ * across all targets so no file is processed twice.
+ *
+ * @param targets - Targets to resolve
+ * @param rootDir - Project root for glob resolution
+ * @returns Sorted, deduplicated array of absolute file paths
+ */
+export declare function resolveTargetFiles(targets: readonly Target[], rootDir: string): string[];
+//# sourceMappingURL=resolver.d.ts.map

package/dist/targets/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/targets/resolver.ts"],"names":[],"mappings":"AACA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAExC;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAmBxF"}

package/dist/targets/resolver.js

@@ -0,0 +1,37 @@
+// @fitness-ignore-file batch-operation-limits -- iterates bounded collections (config entries, registry items, or small analysis results)
+/**
+ * @fileoverview Target file resolver
+ *
+ * Expands target glob patterns to concrete file paths,
+ * deduplicating across multiple targets.
+ */
+import { resolve } from 'node:path';
+import { globSync } from 'glob';
+/**
+ * Resolve multiple targets to a deduplicated list of file paths.
+ *
+ * Expands include globs, filters out exclude globs, and deduplicates
+ * across all targets so no file is processed twice.
+ *
+ * @param targets - Targets to resolve
+ * @param rootDir - Project root for glob resolution
+ * @returns Sorted, deduplicated array of absolute file paths
+ */
+export function resolveTargetFiles(targets, rootDir) {
+    const files = new Set();
+    for (const target of targets) {
+        const { include, exclude } = target.config;
+        for (const pattern of include) {
+            const matches = globSync(pattern, {
+                cwd: rootDir,
+                ignore: [...exclude],
+                absolute: true,
+            });
+            for (const match of matches) {
+                files.add(resolve(match));
+            }
+        }
+    }
+    return [...files].sort();
+}
+//# sourceMappingURL=resolver.js.map

package/dist/targets/resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.js","sourceRoot":"","sources":["../../src/targets/resolver.ts"],"names":[],"mappings":"AAAA,0IAA0I;AAC1I;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAA;AAI/B;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAA0B,EAAE,OAAe;IAC5E,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAA;IAE/B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,CAAA;QAE1C,KAAK,MAAM,OAAO,IAAI,OAAO,EAAE,CAAC;YAC9B,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,EAAE;gBAChC,GAAG,EAAE,OAAO;gBACZ,MAAM,EAAE,CAAC,GAAG,OAAO,CAAC;gBACpB,QAAQ,EAAE,IAAI;aACf,CAAC,CAAA;YACF,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC5B,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAA;YAC3B,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,EAAE,CAAA;AAC1B,CAAC"}

package/dist/targets/target-registry.d.ts

@@ -0,0 +1,61 @@
+/**
+ * @fileoverview Target Registry
+ *
+ * Registry for target definitions. Provides lookup by name and tags.
+ * Standalone implementation without platform GenericRegistry dependency.
+ *
+ * The entire targets module uses a synchronous API because target definitions
+ * are loaded once at startup from a small YAML config file (via loader.ts) and
+ * then held in-memory for fast, repeated lookups throughout the process lifetime.
+ * The resolver (resolver.ts) similarly uses synchronous glob expansion. Since the
+ * data set is small and bounded by project configuration, async I/O offers no
+ * practical benefit and would complicate every call site that queries targets.
+ */
+import type { Target } from './types.js';
+/** Registry for target definitions with lookup by name and tags. */
+export declare class TargetRegistry {
+    private readonly targets;
+    /**
+     * Register a target. Silently skips if a target with the same name already exists.
+     * @param target - Target definition to register
+     * @returns This registry instance for chaining
+     */
+    register(target: Target): this;
+    /**
+     * Look up a target by its config name.
+     * @param name - Target name to find
+     * @returns The matching target, or undefined if not found
+     */
+    getByName(name: string): Target | undefined;
+    /** Return all registered targets. */
+    getAll(): readonly Target[];
+    /**
+     * Return all targets that include the given tag.
+     * @param tag - Tag string to filter by
+     * @returns Targets whose config.tags contain the tag
+     */
+    getByTag(tag: string): readonly Target[];
+    /**
+     * Check whether a target with the given name is registered.
+     * @param name - Target name to check
+     * @returns True if the target exists in the registry
+     */
+    has(name: string): boolean;
+    /**
+     * Find targets whose languages and concerns intersect with the given scope.
+     *
+     * Both dimensions must match (AND logic):
+     * - A target matches languages if the intersection is non-empty (or either side is empty/undefined)
+     * - A target matches concerns if the intersection is non-empty (or either side is empty/undefined)
+     *
+     * @param languages - Languages the check is designed for
+     * @param concerns - Semantic concerns the check targets
+     * @returns Targets that match both dimensions
+     */
+    findByScope(languages: readonly string[], concerns: readonly string[]): readonly Target[];
+    /** Number of registered targets. */
+    get size(): number;
+    /** Remove all targets from the registry. */
+    clear(): void;
+}
+//# sourceMappingURL=target-registry.d.ts.map

package/dist/targets/target-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"target-registry.d.ts","sourceRoot":"","sources":["../../src/targets/target-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAExC,oEAAoE;AACpE,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;IAEpD;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAW9B;;;;OAIG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI3C,qCAAqC;IACrC,MAAM,IAAI,SAAS,MAAM,EAAE;IAI3B;;;;OAIG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE;IAIxC;;;;OAIG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;;;;;;;;;OAUG;IACH,WAAW,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,EAAE,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,MAAM,EAAE;IAqBzF,oCAAoC;IACpC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,4CAA4C;IAC5C,KAAK,IAAI,IAAI;CAGd"}

package/dist/targets/target-registry.js

@@ -0,0 +1,93 @@
+/**
+ * @fileoverview Target Registry
+ *
+ * Registry for target definitions. Provides lookup by name and tags.
+ * Standalone implementation without platform GenericRegistry dependency.
+ *
+ * The entire targets module uses a synchronous API because target definitions
+ * are loaded once at startup from a small YAML config file (via loader.ts) and
+ * then held in-memory for fast, repeated lookups throughout the process lifetime.
+ * The resolver (resolver.ts) similarly uses synchronous glob expansion. Since the
+ * data set is small and bounded by project configuration, async I/O offers no
+ * practical benefit and would complicate every call site that queries targets.
+ */
+/** Registry for target definitions with lookup by name and tags. */
+export class TargetRegistry {
+    targets = new Map();
+    /**
+     * Register a target. Silently skips if a target with the same name already exists.
+     * @param target - Target definition to register
+     * @returns This registry instance for chaining
+     */
+    register(target) {
+        const name = target.config.name;
+        if (this.targets.has(name)) {
+            return this;
+        }
+        this.targets.set(name, target);
+        return this;
+    }
+    /**
+     * Look up a target by its config name.
+     * @param name - Target name to find
+     * @returns The matching target, or undefined if not found
+     */
+    getByName(name) {
+        return this.targets.get(name);
+    }
+    /** Return all registered targets. */
+    getAll() {
+        return [...this.targets.values()];
+    }
+    /**
+     * Return all targets that include the given tag.
+     * @param tag - Tag string to filter by
+     * @returns Targets whose config.tags contain the tag
+     */
+    getByTag(tag) {
+        return this.getAll().filter((t) => t.config.tags?.includes(tag));
+    }
+    /**
+     * Check whether a target with the given name is registered.
+     * @param name - Target name to check
+     * @returns True if the target exists in the registry
+     */
+    has(name) {
+        return this.targets.has(name);
+    }
+    /**
+     * Find targets whose languages and concerns intersect with the given scope.
+     *
+     * Both dimensions must match (AND logic):
+     * - A target matches languages if the intersection is non-empty (or either side is empty/undefined)
+     * - A target matches concerns if the intersection is non-empty (or either side is empty/undefined)
+     *
+     * @param languages - Languages the check is designed for
+     * @param concerns - Semantic concerns the check targets
+     * @returns Targets that match both dimensions
+     */
+    findByScope(languages, concerns) {
+        return this.getAll().filter((target) => {
+            const targetLangs = target.config.languages;
+            const targetConcerns = target.config.concerns;
+            // Language matching: if either side has no languages, treat as "matches any"
+            const languageMatch = languages.length === 0 ||
+                !targetLangs || targetLangs.length === 0 ||
+                languages.some((lang) => targetLangs.includes(lang));
+            // Concern matching: if either side has no concerns, treat as "matches any"
+            const concernMatch = concerns.length === 0 ||
+                !targetConcerns || targetConcerns.length === 0 ||
+                concerns.some((concern) => targetConcerns.includes(concern));
+            return languageMatch && concernMatch;
+        });
+    }
+    /** Number of registered targets. */
+    get size() {
+        return this.targets.size;
+    }
+    /** Remove all targets from the registry. */
+    clear() {
+        this.targets.clear();
+    }
+}
+//# sourceMappingURL=target-registry.js.map

package/dist/targets/target-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"target-registry.js","sourceRoot":"","sources":["../../src/targets/target-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,oEAAoE;AACpE,MAAM,OAAO,cAAc;IACR,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAA;IAEpD;;;;OAIG;IACH,QAAQ,CAAC,MAAc;QACrB,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAA;QAE/B,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,OAAO,IAAI,CAAA;QACb,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;QAC9B,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;;;OAIG;IACH,SAAS,CAAC,IAAY;QACpB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAC/B,CAAC;IAED,qCAAqC;IACrC,MAAM;QACJ,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IACnC,CAAC;IAED;;;;OAIG;IACH,QAAQ,CAAC,GAAW;QAClB,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAA;IAClE,CAAC;IAED;;;;OAIG;IACH,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAC/B,CAAC;IAED;;;;;;;;;;OAUG;IACH,WAAW,CAAC,SAA4B,EAAE,QAA2B;QACnE,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE;YACrC,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAAA;YAC3C,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAA;YAE7C,6EAA6E;YAC7E,MAAM,aAAa,GACjB,SAAS,CAAC,MAAM,KAAK,CAAC;gBACtB,CAAC,WAAW,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;gBACxC,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAA;YAEtD,2EAA2E;YAC3E,MAAM,YAAY,GAChB,QAAQ,CAAC,MAAM,KAAK,CAAC;gBACrB,CAAC,cAAc,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC;gBAC9C,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAA;YAE9D,OAAO,aAAa,IAAI,YAAY,CAAA;QACtC,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,oCAAoC;IACpC,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAA;IAC1B,CAAC;IAED,4CAA4C;IAC5C,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAA;IACtB,CAAC;CACF"}

package/dist/targets/types.d.ts

@@ -0,0 +1,85 @@
+/**
+ * @fileoverview Target type definitions for shared targeting
+ */
+/** Configuration for a named target (file set with include/exclude globs). */
+export interface TargetConfig {
+    /** Kebab-case identifier, e.g. 'backend', 'module-foundation' */
+    readonly name: string;
+    /** Human-readable description */
+    readonly description: string;
+    /** Glob patterns to include */
+    readonly include: readonly string[];
+    /** Glob patterns to exclude */
+    readonly exclude: readonly string[];
+    /** Context doc paths for assessments */
+    readonly context?: readonly string[];
+    /** Tags for filtering/grouping */
+    readonly tags?: readonly string[];
+    /** Languages this target contains (e.g. 'typescript', 'tsx', 'json') */
+    readonly languages?: readonly string[];
+    /** Semantic concerns this target represents (e.g. 'backend', 'server', 'api') */
+    readonly concerns?: readonly string[];
+}
+/** A resolved target wrapping its configuration. */
+export interface Target {
+    readonly config: TargetConfig;
+}
+/**
+ * Per-check target overrides.
+ * Maps check slug → target name(s) to restrict which files a check runs against.
+ */
+type CheckTargetMap = Readonly<Record<string, string | readonly string[]>>;
+/**
+ * Project-local plugin declarations — one list per plugin domain.
+ *
+ * When present in the config file, these override the default user-level
+ * plugin directory (`~/.opensip-tools/<domain>/`). Plugins get installed
+ * into `<project-root>/.opensip-tools/<domain>/` and are version-pinned
+ * by the project rather than by each developer's machine.
+ *
+ * Each entry is any npm install spec: `@scope/pkg`, `@scope/pkg@^1.2.3`,
+ * `./local-path`, `/abs/path/to/pkg.tgz`, `git+https://...`, etc.
+ */
+interface PluginsConfig {
+    readonly fit?: readonly string[];
+    readonly sim?: readonly string[];
+    readonly asm?: readonly string[];
+    readonly lang?: readonly string[];
+    /**
+     * Explicit list of npm package names to load as check providers
+     * (e.g. ['@opensip-tools/checks-python', '@my-org/checks-internal']).
+     *
+     * When present, ONLY these packages are loaded. Auto-discovery is
+     * disabled for the run. No package is privileged: if you want the
+     * default check pack you must list `@opensip-tools/checks-builtin`
+     * (or its successors) here explicitly. An empty list disables all
+     * check loading and triggers a no-checks-loaded warning.
+     */
+    readonly checkPackages?: readonly string[];
+    /**
+     * When false, the CLI does NOT scan node_modules for
+     * @opensip-tools/checks-* packages. Default: true.
+     * Ignored when `checkPackages` is set (explicit list always wins).
+     */
+    readonly autoDiscoverChecks?: boolean;
+}
+/**
+ * Result of loading targets config, including both the target registry
+ * and per-check target overrides.
+ */
+export interface TargetsConfig {
+    /** Global file exclusion patterns (replaces .fitnessignore). */
+    readonly globalExcludes: readonly string[];
+    /** Per-check target overrides for third-party/marketplace checks. */
+    readonly checkOverrides: CheckTargetMap;
+    /**
+     * Project-local plugin declarations, keyed by domain. When any domain
+     * has entries here, plugin discovery for that domain reads from
+     * `<project>/.opensip-tools/<domain>/` instead of `~/.opensip-tools/<domain>/`.
+     * Absent (or undefined per-domain) = fall back to the user-level dir
+     * for that domain.
+     */
+    readonly plugins?: PluginsConfig;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map