@opensip-cli/fitness 0.1.0

package/dist/framework/path-matcher.js

@@ -0,0 +1,138 @@
+/**
+ * @fileoverview PathMatcher - Strategy pattern for file matching
+ *
+ * Provides glob-based file matching with include/exclude patterns.
+ * Supports lazy evaluation and composition.
+ */
+import * as path from 'node:path';
+import { glob } from 'glob';
+import { minimatch } from 'minimatch';
+/**
+ * Strategy for matching files based on glob patterns.
+ * Supports both custom patterns and composition.
+ *
+ * @example
+ * ```typescript
+ * const matcher = PathMatcher.create({
+ *   cwd: '/path/to/repo',
+ *   include: ['src/**\/*.ts'],
+ *   exclude: ['**\/__tests__/**'],
+ * });
+ * const files = await matcher.files();
+ * ```
+ */
+export class PathMatcher {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    /**
+     * Create a PathMatcher from options.
+     */
+    static create(options) {
+        return new PathMatcher(options);
+    }
+    /**
+     * Get all matching files.
+     * @returns Array of absolute file paths matching the patterns
+     */
+    async files() {
+        const result = await this.match();
+        return result.files;
+    }
+    /**
+     * Get detailed match result including timing.
+     */
+    async match() {
+        const start = Date.now();
+        const allExcludes = [...this.options.exclude, ...(this.options.additionalExcludes ?? [])];
+        // Run glob for all include patterns
+        const matchedSets = await Promise.all(this.options.include.map((pattern) => glob(pattern, {
+            cwd: this.options.cwd,
+            absolute: true,
+            nodir: true,
+            ignore: allExcludes,
+        })));
+        // Combine and deduplicate results
+        const allMatched = new Set();
+        for (const matches of matchedSets) {
+            for (const file of matches) {
+                allMatched.add(path.normalize(file));
+            }
+        }
+        const files = [...allMatched].sort();
+        const durationMs = Date.now() - start;
+        return {
+            files,
+            excluded: [],
+            durationMs,
+        };
+    }
+    /**
+     * Check if a file matches the patterns.
+     * @param filePath - Absolute path to check
+     * @returns True if file matches include patterns and is not excluded
+     */
+    matches(filePath) {
+        const relativePath = path.relative(this.options.cwd, filePath);
+        const matchesInclude = this.options.include.some((pattern) => minimatch(relativePath, pattern, { dot: true }));
+        if (!matchesInclude) {
+            return false;
+        }
+        const allExcludes = [...this.options.exclude, ...(this.options.additionalExcludes ?? [])];
+        const matchesExclude = allExcludes.some((pattern) => minimatch(relativePath, pattern, { dot: true }));
+        return !matchesExclude;
+    }
+    /**
+     * Create a new PathMatcher with additional exclusions.
+     */
+    withExcludes(additionalExcludes) {
+        return new PathMatcher({
+            ...this.options,
+            additionalExcludes: [...(this.options.additionalExcludes ?? []), ...additionalExcludes],
+        });
+    }
+    /**
+     * Create a new PathMatcher that only includes TypeScript files.
+     */
+    typescriptOnly() {
+        return new PathMatcher({
+            ...this.options,
+            include: this.options.include.map((pattern) => {
+                if (pattern.endsWith('/*') || pattern.endsWith('/**/*')) {
+                    const base = pattern.replace(/\/\*+$/, '');
+                    return `${base}/**/*.{ts,tsx}`;
+                }
+                if (!pattern.includes('.')) {
+                    return `${pattern}/**/*.{ts,tsx}`;
+                }
+                return pattern;
+            }),
+        });
+    }
+    /**
+     * Create a new PathMatcher that excludes test files.
+     */
+    noTests() {
+        return this.withExcludes([
+            '**/__tests__/**',
+            '**/*.test.ts',
+            '**/*.test.tsx',
+            '**/*.spec.ts',
+            '**/*.spec.tsx',
+        ]);
+    }
+    /** Get the current working directory. */
+    get cwd() {
+        return this.options.cwd;
+    }
+    /** Get the include patterns. */
+    get includePatterns() {
+        return this.options.include;
+    }
+    /** Get the exclude patterns. */
+    get excludePatterns() {
+        return [...this.options.exclude, ...(this.options.additionalExcludes ?? [])];
+    }
+}
+//# sourceMappingURL=path-matcher.js.map

package/dist/framework/path-matcher.js.map

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

package/dist/framework/register-helpers.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @fileoverview Helper for registering checks with a namespace
+ */
+import type { Check } from './check-types.js';
+/**
+ * Register an array of checks with a namespace into the current scope's
+ * check registry.
+ * @returns The number of checks registered.
+ */
+export declare function registerChecks(checks: Check[], namespace: string): number;
+//# sourceMappingURL=register-helpers.d.ts.map

package/dist/framework/register-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-helpers.d.ts","sourceRoot":"","sources":["../../src/framework/register-helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9C;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAQzE"}

package/dist/framework/register-helpers.js

@@ -0,0 +1,19 @@
+/**
+ * @fileoverview Helper for registering checks with a namespace
+ */
+import { currentCheckRegistry } from './scope-registry.js';
+/**
+ * Register an array of checks with a namespace into the current scope's
+ * check registry.
+ * @returns The number of checks registered.
+ */
+export function registerChecks(checks, namespace) {
+    const registry = currentCheckRegistry();
+    let count = 0;
+    for (const check of checks) {
+        registry.register(check, namespace);
+        count++;
+    }
+    return count;
+}
+//# sourceMappingURL=register-helpers.js.map

package/dist/framework/register-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-helpers.js","sourceRoot":"","sources":["../../src/framework/register-helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAI3D;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,MAAe,EAAE,SAAiB;IAC/D,MAAM,QAAQ,GAAG,oBAAoB,EAAE,CAAC;IACxC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QACpC,KAAK,EAAE,CAAC;IACV,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/framework/registry.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Check registry — central registration and discovery.
+ *
+ * Supports namespaced slugs: checks are stored as `namespace:slug` when
+ * a namespace is provided. Bare slug lookups resolve via a reverse index,
+ * with a warning logged on ambiguity.
+ *
+ * Built on the kernel's unified `Registry<T>` with
+ * `duplicatePolicy: 'silent-skip'` — re-importing the same check is a
+ * no-op (the historical behaviour the file's previous incarnation
+ * documented). The `bareSlugIndex` (slug → list of namespaced keys)
+ * lives alongside the base because it's a domain-specific lookup
+ * structure not in the base's shape.
+ */
+import type { Check } from './check-types.js';
+/** Registry of fitness checks, indexed by namespaced key with a bare-slug reverse index. */
+export declare class CheckRegistry {
+    private readonly inner;
+    /** Reverse index: bare slug → list of namespaced keys */
+    private readonly bareSlugIndex;
+    register(check: Check, namespace?: string): void;
+    /** Get a check by slug. Supports both namespaced and bare slugs. */
+    get(slug: string): Check;
+    /** Check whether a slug is registered (namespaced or bare). */
+    has(slug: string): boolean;
+    /** Get a check by slug, or `undefined` if not registered (non-throwing {@link get}). */
+    find(slug: string): Check | undefined;
+    list(): Check[];
+    /** Get the namespace a check was registered under. Returns undefined for bare slugs. */
+    getNamespace(bareSlug: string): string | undefined;
+    listEnabled(): Check[];
+    byTag(tag: string): Check[];
+    /** Get a check by slug, returning undefined if not found. */
+    getBySlug(slug: string): Check | undefined;
+    /** Return all registered keys (namespaced where applicable). */
+    listSlugs(): string[];
+    /** Return all checks with a given bare slug across all namespaces. */
+    listByBareSlug(bareSlug: string): Check[];
+    get size(): number;
+    /**
+     * Resolve a slug to a Check.
+     * - If slug contains ':', exact lookup.
+     * - If bare slug, use reverse index. Single match → return.
+     *   Multiple candidates → throw NotFoundError listing them (ambiguity is
+     *   now a hard failure rather than load-order-dependent silent choice of [0]).
+     *   Use listByBareSlug() when enumeration of all is desired.
+     */
+    private resolve;
+}
+export { type Check } from './check-types.js';
+//# sourceMappingURL=registry.d.ts.map

package/dist/framework/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/framework/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAS9C,4FAA4F;AAC5F,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAInB;IACH,yDAAyD;IACzD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA+B;IAE7D,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAmBhD,oEAAoE;IACpE,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK;IAexB,+DAA+D;IAC/D,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,wFAAwF;IACxF,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAIrC,IAAI,IAAI,KAAK,EAAE;IAIf,wFAAwF;IACxF,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAQlD,WAAW,IAAI,KAAK,EAAE;IAItB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,EAAE;IAI3B,6DAA6D;IAC7D,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAI1C,gEAAgE;IAChE,SAAS,IAAI,MAAM,EAAE;IAIrB,sEAAsE;IACtE,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,EAAE;IAKzC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;;;;OAOG;IACH,OAAO,CAAC,OAAO;CA4BhB;AAED,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/framework/registry.js

@@ -0,0 +1,131 @@
+/**
+ * Check registry — central registration and discovery.
+ *
+ * Supports namespaced slugs: checks are stored as `namespace:slug` when
+ * a namespace is provided. Bare slug lookups resolve via a reverse index,
+ * with a warning logged on ambiguity.
+ *
+ * Built on the kernel's unified `Registry<T>` with
+ * `duplicatePolicy: 'silent-skip'` — re-importing the same check is a
+ * no-op (the historical behaviour the file's previous incarnation
+ * documented). The `bareSlugIndex` (slug → list of namespaced keys)
+ * lives alongside the base because it's a domain-specific lookup
+ * structure not in the base's shape.
+ */
+import { NotFoundError, Registry, logger } from '@opensip-cli/core';
+/** Registry of fitness checks, indexed by namespaced key with a bare-slug reverse index. */
+export class CheckRegistry {
+    inner = new Registry({
+        module: 'fitness:checks',
+        duplicatePolicy: 'silent-skip',
+        evtPrefix: 'check.registry',
+    });
+    /** Reverse index: bare slug → list of namespaced keys */
+    bareSlugIndex = new Map();
+    register(check, namespace) {
+        const bareSlug = check.config.slug;
+        const key = namespace ? `${namespace}:${bareSlug}` : bareSlug;
+        if (this.inner.has(key)) {
+            // Silently skip duplicate — same check imported multiple times.
+            // Inner's silent-skip policy would do this anyway; we short-circuit
+            // here to avoid the redundant index update.
+            return;
+        }
+        this.inner.register({ id: key, name: key, check, tags: check.config.tags });
+        // Update bare slug index
+        const existing = this.bareSlugIndex.get(bareSlug) ?? [];
+        existing.push(key);
+        this.bareSlugIndex.set(bareSlug, existing);
+    }
+    /** Get a check by slug. Supports both namespaced and bare slugs. */
+    get(slug) {
+        const check = this.resolve(slug);
+        if (!check) {
+            const cands = slug.includes(':') ? [] : (this.bareSlugIndex.get(slug) ?? []);
+            if (cands.length > 1) {
+                throw new NotFoundError(`Check slug '${slug}' is ambiguous (${cands.length} matches: ${cands.join(', ')}). ` +
+                    `Use a namespaced form (e.g. 'namespace:${slug}') or listByBareSlug().`);
+            }
+            throw new NotFoundError(`Check not found: ${slug}`);
+        }
+        return check;
+    }
+    /** Check whether a slug is registered (namespaced or bare). */
+    has(slug) {
+        return this.resolve(slug) !== undefined;
+    }
+    /** Get a check by slug, or `undefined` if not registered (non-throwing {@link get}). */
+    find(slug) {
+        return this.resolve(slug);
+    }
+    list() {
+        return this.inner.getAll().map((r) => r.check);
+    }
+    /** Get the namespace a check was registered under. Returns undefined for bare slugs. */
+    getNamespace(bareSlug) {
+        const keys = this.bareSlugIndex.get(bareSlug);
+        if (!keys || keys.length === 0)
+            return undefined;
+        const key = keys[0];
+        const colonIdx = key.indexOf(':');
+        return colonIdx === -1 ? undefined : key.slice(0, colonIdx);
+    }
+    listEnabled() {
+        return this.list().filter((c) => !c.config.disabled);
+    }
+    byTag(tag) {
+        return this.listEnabled().filter((c) => c.config.tags?.includes(tag));
+    }
+    /** Get a check by slug, returning undefined if not found. */
+    getBySlug(slug) {
+        return this.resolve(slug);
+    }
+    /** Return all registered keys (namespaced where applicable). */
+    listSlugs() {
+        return this.inner.getAll().map((r) => r.id);
+    }
+    /** Return all checks with a given bare slug across all namespaces. */
+    listByBareSlug(bareSlug) {
+        const keys = this.bareSlugIndex.get(bareSlug) ?? [];
+        return keys.map((k) => this.inner.getById(k)?.check).filter((c) => c !== undefined);
+    }
+    get size() {
+        return this.inner.size;
+    }
+    /**
+     * Resolve a slug to a Check.
+     * - If slug contains ':', exact lookup.
+     * - If bare slug, use reverse index. Single match → return.
+     *   Multiple candidates → throw NotFoundError listing them (ambiguity is
+     *   now a hard failure rather than load-order-dependent silent choice of [0]).
+     *   Use listByBareSlug() when enumeration of all is desired.
+     */
+    resolve(slug) {
+        // Exact match (namespaced or bare)
+        const exact = this.inner.getById(slug);
+        if (exact)
+            return exact.check;
+        // If it contains ':', it was a namespaced lookup that didn't match
+        if (slug.includes(':'))
+            return undefined;
+        // Bare slug → reverse index
+        const candidates = this.bareSlugIndex.get(slug);
+        if (!candidates || candidates.length === 0)
+            return undefined;
+        if (candidates.length > 1) {
+            // Hard failure on ambiguity — prevents non-deterministic "which check won?"
+            // behaviour across pack load order or plugin discovery. Callers that want
+            // the full list can use listByBareSlug().
+            logger.warn({
+                evt: 'check.registry.ambiguous',
+                module: 'fitness:checks',
+                bareSlug: slug,
+                candidates,
+                msg: `Ambiguous bare slug '${slug}' matches ${candidates.length} checks (namespaced); refusing bare lookup`,
+            });
+            return undefined; // get() will turn this into a NotFoundError with the slug
+        }
+        return this.inner.getById(candidates[0])?.check;
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/framework/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/framework/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,EAAqB,MAAM,mBAAmB,CAAC;AAWvF,4FAA4F;AAC5F,MAAM,OAAO,aAAa;IACP,KAAK,GAAG,IAAI,QAAQ,CAAoB;QACvD,MAAM,EAAE,gBAAgB;QACxB,eAAe,EAAE,aAAa;QAC9B,SAAS,EAAE,gBAAgB;KAC5B,CAAC,CAAC;IACH,yDAAyD;IACxC,aAAa,GAAG,IAAI,GAAG,EAAoB,CAAC;IAE7D,QAAQ,CAAC,KAAY,EAAE,SAAkB;QACvC,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC;QACnC,MAAM,GAAG,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,IAAI,QAAQ,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;QAE9D,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,gEAAgE;YAChE,oEAAoE;YACpE,4CAA4C;YAC5C,OAAO;QACT,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QAE5E,yBAAyB;QACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACxD,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnB,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC7C,CAAC;IAED,oEAAoE;IACpE,GAAG,CAAC,IAAY;QACd,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YAC7E,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACrB,MAAM,IAAI,aAAa,CACrB,eAAe,IAAI,mBAAmB,KAAK,CAAC,MAAM,aAAa,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK;oBAClF,0CAA0C,IAAI,yBAAyB,CAC1E,CAAC;YACJ,CAAC;YACD,MAAM,IAAI,aAAa,CAAC,oBAAoB,IAAI,EAAE,CAAC,CAAC;QACtD,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,+DAA+D;IAC/D,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,SAAS,CAAC;IAC1C,CAAC;IAED,wFAAwF;IACxF,IAAI,CAAC,IAAY;QACf,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACjD,CAAC;IAED,wFAAwF;IACxF,YAAY,CAAC,QAAgB;QAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC9C,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QACjD,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAClC,OAAO,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC9D,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,GAAW;QACf,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;IACxE,CAAC;IAED,6DAA6D;IAC7D,SAAS,CAAC,IAAY;QACpB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED,gEAAgE;IAChE,SAAS;QACP,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED,sEAAsE;IACtE,cAAc,CAAC,QAAgB;QAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACpD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAc,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC;IAClG,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;IAED;;;;;;;OAOG;IACK,OAAO,CAAC,IAAY;QAC1B,mCAAmC;QACnC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC,KAAK,CAAC;QAE9B,mEAAmE;QACnE,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,OAAO,SAAS,CAAC;QAEzC,4BAA4B;QAC5B,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAChD,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QAE7D,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,4EAA4E;YAC5E,0EAA0E;YAC1E,0CAA0C;YAC1C,MAAM,CAAC,IAAI,CAAC;gBACV,GAAG,EAAE,0BAA0B;gBAC/B,MAAM,EAAE,gBAAgB;gBACxB,QAAQ,EAAE,IAAI;gBACd,UAAU;gBACV,GAAG,EAAE,wBAAwB,IAAI,aAAa,UAAU,CAAC,MAAM,4CAA4C;aAC5G,CAAC,CAAC;YACH,OAAO,SAAS,CAAC,CAAC,0DAA0D;QAC9E,CAAC;QAED,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC;IAClD,CAAC;CACF"}

package/dist/framework/result-builder.d.ts

@@ -0,0 +1,74 @@
+/**
+ * @fileoverview ResultBuilder - Builder pattern for check results
+ *
+ * Provides a fluent API for constructing check results with signals,
+ * metadata, and display information.
+ */
+import type { CheckResult, ItemType } from '../types/findings.js';
+import type { Signal } from '@opensip-cli/core';
+/**
+ * Options for building results.
+ */
+export interface ResultBuilderOptions {
+    /** Check ID */
+    readonly checkId: string;
+    /** Item type for display (files, modules, etc.) */
+    readonly itemType: ItemType;
+    /** Custom unit label (overrides itemType) */
+    readonly unit?: string | undefined;
+}
+/**
+ * Builder for constructing check results.
+ *
+ * @example
+ * ```typescript
+ * const result = ResultBuilder.create({ checkId: 'my-check', itemType: 'files' })
+ *   .totalItems(100)
+ *   .addSignal(signal1)
+ *   .build();
+ * ```
+ */
+export declare class ResultBuilder {
+    private readonly options;
+    private _totalItems;
+    private readonly _signals;
+    private _ignoredCount;
+    private _durationMs?;
+    private _filesScanned?;
+    private _extra?;
+    private constructor();
+    static create(options: ResultBuilderOptions): ResultBuilder;
+    totalItems(count: number): this;
+    filesScanned(count: number): this;
+    addSignal(signal: Signal): this;
+    addSignals(signals: readonly Signal[]): this;
+    ignoredCount(count: number): this;
+    incrementIgnored(by?: number): this;
+    duration(ms: number): this;
+    extra(data: Record<string, unknown>): this;
+    build(): CheckResult;
+    buildError(message: string, error?: Error): CheckResult;
+    private buildInfo;
+    private getUniqueFileCount;
+    get signalCount(): number;
+    get errorCount(): number;
+    get warningCount(): number;
+    get hasSignals(): boolean;
+    get willPass(): boolean;
+}
+/**
+ * Extract a code snippet with context lines around a target line.
+ */
+export declare function extractSnippet(content: string, line: number, contextLines?: number): {
+    snippet: string;
+    contextLines: number;
+};
+/**
+ * Get line number from content string and character index.
+ */
+export declare function getLineNumber(content: string, index: number): number;
+/**
+ * Check if a file path matches API file patterns.
+ */
+export declare function isAPIFile(filePath: string): boolean;
+//# sourceMappingURL=result-builder.d.ts.map

package/dist/framework/result-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-builder.d.ts","sourceRoot":"","sources":["../../src/framework/result-builder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,OAAO,KAAK,EAAE,WAAW,EAAa,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAC7E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,eAAe;IACf,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,mDAAmD;IACnD,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,6CAA6C;IAC7C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC;AAED;;;;;;;;;;GAUG;AACH,qBAAa,aAAa;IAQJ,OAAO,CAAC,QAAQ,CAAC,OAAO;IAP5C,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IACzC,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,WAAW,CAAC,CAAS;IAC7B,OAAO,CAAC,aAAa,CAAC,CAAS;IAC/B,OAAO,CAAC,MAAM,CAAC,CAA0B;IAEzC,OAAO;IAEP,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa;IAI3D,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAK/B,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKjC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK/B,UAAU,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI;IAQ5C,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKjC,gBAAgB,CAAC,EAAE,SAAI,GAAG,IAAI;IAK9B,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAK1B,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAK1C,KAAK,IAAI,WAAW;IAqCpB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,WAAW;IAIvD,OAAO,CAAC,SAAS;IAajB,OAAO,CAAC,kBAAkB;IAK1B,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,IAAI,QAAQ,IAAI,OAAO,CAEtB;CACF;AAMD;;GAEG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,YAAY,SAAI,GACf;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAO3C;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpE;AAOD;;GAEG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAInD"}

package/dist/framework/result-builder.js

@@ -0,0 +1,154 @@
+/**
+ * @fileoverview ResultBuilder - Builder pattern for check results
+ *
+ * Provides a fluent API for constructing check results with signals,
+ * metadata, and display information.
+ */
+import { CheckInfoFactory, createResultWithSignals, createErrorResult, getItemTypeLabel, } from '../types/findings.js';
+import { countErrors, countWarnings } from '../types/severity.js';
+/**
+ * Builder for constructing check results.
+ *
+ * @example
+ * ```typescript
+ * const result = ResultBuilder.create({ checkId: 'my-check', itemType: 'files' })
+ *   .totalItems(100)
+ *   .addSignal(signal1)
+ *   .build();
+ * ```
+ */
+export class ResultBuilder {
+    options;
+    _totalItems = 0;
+    _signals = [];
+    _ignoredCount = 0;
+    _durationMs;
+    _filesScanned;
+    _extra;
+    constructor(options) {
+        this.options = options;
+    }
+    static create(options) {
+        return new ResultBuilder(options);
+    }
+    totalItems(count) {
+        this._totalItems = count;
+        return this;
+    }
+    filesScanned(count) {
+        this._filesScanned = count;
+        return this;
+    }
+    addSignal(signal) {
+        this._signals.push(signal);
+        return this;
+    }
+    addSignals(signals) {
+        if (signals.length === 0) {
+            return this;
+        }
+        this._signals.push(...signals);
+        return this;
+    }
+    ignoredCount(count) {
+        this._ignoredCount = count;
+        return this;
+    }
+    incrementIgnored(by = 1) {
+        this._ignoredCount += by;
+        return this;
+    }
+    duration(ms) {
+        this._durationMs = ms;
+        return this;
+    }
+    extra(data) {
+        this._extra = { ...this._extra, ...data };
+        return this;
+    }
+    build() {
+        const unit = this.options.unit ?? this.options.itemType;
+        const errors = countErrors(this._signals);
+        const warnings = countWarnings(this._signals);
+        const info = this.buildInfo(errors, warnings, unit);
+        const buildOptions = {};
+        if (this._ignoredCount > 0) {
+            buildOptions.ignoredCount = this._ignoredCount;
+        }
+        if (this._durationMs !== undefined) {
+            buildOptions.durationMs = this._durationMs;
+        }
+        if (this._filesScanned !== undefined) {
+            buildOptions.filesScanned = this._filesScanned;
+        }
+        buildOptions.itemType = this.options.itemType;
+        if (this._extra !== undefined) {
+            buildOptions.extra = this._extra;
+        }
+        return createResultWithSignals(info, this._signals, this._totalItems, Object.keys(buildOptions).length > 0 ? buildOptions : undefined);
+    }
+    buildError(message, error) {
+        return createErrorResult(message, error);
+    }
+    buildInfo(errors, warnings, unit) {
+        if (this._totalItems > 0) {
+            // Clamp to 0: analyzeAll-mode checks can surface violations against
+            // files outside the scanned set, which would otherwise produce a
+            // negative "-N/M compliant" label.
+            const compliantItems = Math.max(0, this._totalItems - this.getUniqueFileCount());
+            return CheckInfoFactory.compliance(compliantItems, this._totalItems, unit);
+        }
+        const total = errors + warnings;
+        return CheckInfoFactory.violations(total, getItemTypeLabel('violations', total));
+    }
+    getUniqueFileCount() {
+        const files = new Set(this._signals.map((s) => s.code?.file).filter(Boolean));
+        return files.size;
+    }
+    get signalCount() {
+        return this._signals.length;
+    }
+    get errorCount() {
+        return countErrors(this._signals);
+    }
+    get warningCount() {
+        return countWarnings(this._signals);
+    }
+    get hasSignals() {
+        return this._signals.length > 0;
+    }
+    get willPass() {
+        return this.errorCount === 0;
+    }
+}
+// =============================================================================
+// SNIPPET UTILITIES
+// =============================================================================
+/**
+ * Extract a code snippet with context lines around a target line.
+ */
+export function extractSnippet(content, line, contextLines = 2) {
+    const lines = content.split('\n');
+    const startLine = Math.max(0, line - 1 - contextLines);
+    const endLine = Math.min(lines.length, line + contextLines);
+    const snippetLines = lines.slice(startLine, endLine);
+    const snippet = snippetLines.map((l, i) => `${startLine + i + 1} | ${l}`).join('\n');
+    return { snippet, contextLines };
+}
+/**
+ * Get line number from content string and character index.
+ */
+export function getLineNumber(content, index) {
+    return content.slice(0, Math.max(0, index)).split('\n').length;
+}
+/**
+ * Default patterns for identifying API-related files.
+ */
+const DEFAULT_API_FILE_PATTERNS = ['/api/', '/routes/', '-handler.ts', '.handler.ts'];
+/**
+ * Check if a file path matches API file patterns.
+ */
+export function isAPIFile(filePath) {
+    return DEFAULT_API_FILE_PATTERNS.some((pattern) => pattern.startsWith('/') ? filePath.includes(pattern) : filePath.endsWith(pattern));
+}
+//# sourceMappingURL=result-builder.js.map

package/dist/framework/result-builder.js.map

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

package/dist/framework/scope-registry.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @fileoverview Scope-owned fitness registries — the simulation pattern.
+ *
+ * Each `RunScope` owns its own check + recipe registries (D7 — tool
+ * subscopes via module augmentation). The fitness tool's
+ * `contributeScope` hook constructs fresh registries per CLI invocation
+ * and attaches them to `scope.fitness.{checks,recipes}`. The module-level
+ * singletons (`defaultRegistry` / `defaultRecipeRegistry`) are gone —
+ * consumers read via `currentCheckRegistry()` / `currentRecipeRegistry()`,
+ * which route through the scope-bound instances and throw outside a scope.
+ *
+ * Public API (mirrors simulation's `createScenarioRegistry` /
+ * `currentScenarioRegistry`):
+ *   - `createCheckRegistry()`   — factory used by `contributeScope`.
+ *   - `createRecipeRegistry()`  — factory used by `contributeScope`.
+ *   - `createFitnessLoadState()`— fresh `ensureChecksLoaded` lifecycle slot.
+ *   - `currentCheckRegistry()`  — reads `scope.fitness.checks`; throws
+ *                                 outside a scope / when the subscope is absent.
+ *   - `currentRecipeRegistry()` — reads `scope.fitness.recipes`; same throws.
+ *   - `currentFitnessLoadState()` — reads `scope.fitness.load`; same throws.
+ */
+import { FitnessRecipeRegistry } from '../recipes/registry.js';
+import { CheckRegistry } from './registry.js';
+import type { FitnessLoadState } from '../scope-augmentation.js';
+import '../scope-augmentation.js';
+/** Construct a fresh check registry for a single `RunScope`. */
+export declare function createCheckRegistry(): CheckRegistry;
+/** Construct a fresh recipe registry (built-ins pre-seeded) for a single `RunScope`. */
+export declare function createRecipeRegistry(): FitnessRecipeRegistry;
+/** Construct a fresh, empty `ensureChecksLoaded` lifecycle slot for a `RunScope`. */
+export declare function createFitnessLoadState(): FitnessLoadState;
+/** Read the current scope's check registry. */
+export declare function currentCheckRegistry(): CheckRegistry;
+/** Read the current scope's recipe registry. */
+export declare function currentRecipeRegistry(): FitnessRecipeRegistry;
+/** Read the current scope's `ensureChecksLoaded` lifecycle state. */
+export declare function currentFitnessLoadState(): FitnessLoadState;
+//# sourceMappingURL=scope-registry.d.ts.map