@opensip-cli/fitness 0.1.0

package/dist/framework/file-cache.js

@@ -0,0 +1,199 @@
+// @fitness-ignore-file public-api-jsdoc -- internal framework module; public API documented at package level
+/**
+ * @fileoverview In-memory file cache for fitness checks
+ *
+ * Simple file content cache with optional prewarming.
+ * Used by all checks during a run for efficient file access.
+ */
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { SystemError, ValidationError } from '@opensip-cli/core';
+import { glob } from 'glob';
+/**
+ * Simple in-memory file cache.
+ *
+ * Usage:
+ * 1. Call prewarm() before running checks (loads file contents)
+ * 2. Use get() to read file contents (falls back to disk if not cached)
+ * 3. Call clear() after checks complete
+ */
+const PREWARM_BATCH_SIZE = 100;
+export class FileCache {
+    cache = new Map();
+    _prewarmed = false;
+    _cleared = false;
+    _autoClearTimer = null;
+    /**
+     * Prewarm the cache by loading all files matching patterns.
+     * @param cwd - Working directory for file resolution
+     * @param patterns - Glob patterns to prewarm file contents for
+     * @returns Prewarm statistics
+     */
+    async prewarm(cwd, patterns) {
+        const start = Date.now();
+        let totalBytes = 0;
+        // Find all matching files for content caching
+        const allFiles = new Set();
+        for (const pattern of patterns) {
+            // @fitness-ignore-next-line performance-anti-patterns -- sequential glob calls: each pattern must resolve before deduplication
+            const files = await glob(pattern, {
+                cwd,
+                absolute: true,
+                nodir: true,
+                ignore: ['**/node_modules/**', '**/dist/**', '**/.git/**'],
+            });
+            for (const file of files) {
+                allFiles.add(file);
+            }
+        }
+        // Load file contents in parallel batches
+        const files = [...allFiles];
+        for (let i = 0; i < files.length; i += PREWARM_BATCH_SIZE) {
+            const batch = files.slice(i, i + PREWARM_BATCH_SIZE);
+            // @fitness-ignore-next-line performance-anti-patterns -- intentional batching: limits concurrent file reads to control memory pressure
+            const results = await Promise.allSettled(batch.map(async (filePath) => {
+                const stats = await fs.stat(filePath);
+                if (stats.isDirectory()) {
+                    return null;
+                }
+                const content = await fs.readFile(filePath, 'utf8');
+                return { filePath, content };
+            }));
+            for (const result of results) {
+                if (result.status === 'fulfilled' && result.value !== null) {
+                    const { filePath, content } = result.value;
+                    // Enforce the same 10 MiB per-file limit that ExecutionContext.readFile
+                    // guarantees to checks. Huge files are skipped during prewarm (they will
+                    // still fail loudly with a clear error if a check later tries to read them
+                    // explicitly). This keeps the cache from holding data that no check is
+                    // allowed to consume.
+                    if (content.length > 10_000_000) {
+                        continue;
+                    }
+                    this.cache.set(filePath, content);
+                    totalBytes += content.length;
+                }
+            }
+        }
+        this._prewarmed = true;
+        this._cleared = false;
+        this.scheduleAutoClear();
+        const durationMs = Date.now() - start;
+        return {
+            filesLoaded: this.cache.size,
+            durationMs,
+            totalBytes,
+        };
+    }
+    /**
+     * Get file content from cache, falling back to disk if not cached.
+     * @throws {Error} If the path is a directory instead of a file
+     */
+    /** Synchronously check if a file is in cache. Returns content or undefined. */
+    getCached(filePath) {
+        const absolutePath = path.isAbsolute(filePath) ? filePath : path.resolve(filePath);
+        return this.cache.get(absolutePath);
+    }
+    async get(filePath) {
+        const absolutePath = path.isAbsolute(filePath) ? filePath : path.resolve(filePath);
+        const cached = this.cache.get(absolutePath);
+        if (cached !== undefined) {
+            return cached;
+        }
+        const stats = await fs.stat(absolutePath);
+        if (stats.isDirectory()) {
+            // @fitness-ignore-next-line result-pattern-consistency -- internal method, exceptions propagate to public Result boundary
+            throw new ValidationError(`Cannot read directory as file: ${absolutePath}`, {
+                code: 'VALIDATION.FITNESS.DIRECTORY_AS_FILE',
+            });
+        }
+        const content = await fs.readFile(absolutePath, 'utf8');
+        if (content.length > 10_000_000) {
+            // Consistent with ExecutionContext.readFile and prewarm: never surface
+            // >10 MiB of content to a check. Throw here so even direct cache.get
+            // callers (and any future direct users of fileCache) are protected.
+            throw new SystemError(`File too large (${content.length} bytes, max 10MB): ${absolutePath}`, {
+                code: 'SYSTEM.FITNESS.FILE_TOO_LARGE',
+            });
+        }
+        this.cache.set(absolutePath, content);
+        return content;
+    }
+    /**
+     * Check if a file exists (in cache or on disk).
+     */
+    async exists(filePath) {
+        const absolutePath = path.isAbsolute(filePath) ? filePath : path.resolve(filePath);
+        if (this.cache.has(absolutePath)) {
+            return true;
+        }
+        try {
+            await fs.access(absolutePath);
+            return true;
+        }
+        catch {
+            // @swallow-ok File access check failed — treat as not accessible
+            return false;
+        }
+    }
+    /**
+     * Clear the cache. Must be called after checks complete.
+     */
+    clear() {
+        this.cache.clear();
+        this._prewarmed = false;
+        this._cleared = true;
+        if (this._autoClearTimer) {
+            clearTimeout(this._autoClearTimer);
+            this._autoClearTimer = null;
+        }
+    }
+    /**
+     * Get all cached file paths.
+     * Returns the paths of all files loaded during prewarm or on-demand reads.
+     */
+    paths() {
+        return [...this.cache.keys()].sort();
+    }
+    /**
+     * Get cache statistics.
+     */
+    /** Auto-clear after timeout to prevent memory leaks from missed lifecycle cleanup */
+    scheduleAutoClear() {
+        if (this._autoClearTimer) {
+            clearTimeout(this._autoClearTimer);
+        }
+        this._autoClearTimer = setTimeout(() => {
+            /* v8 ignore start -- 10-minute auto-clear timer; not exercised in unit tests */
+            if (this.cache.size > 0) {
+                this.clear();
+            }
+            /* v8 ignore stop */
+        }, 10 * 60 * 1000); // 10 minutes
+        // Unref so the timer doesn't keep the process alive
+        this._autoClearTimer.unref();
+    }
+    get stats() {
+        return {
+            size: this.cache.size,
+            prewarmed: this._prewarmed,
+            cleared: this._cleared,
+        };
+    }
+}
+/**
+ * Shared file cache instance.
+ */
+export const fileCache = new FileCache();
+/**
+ * Default patterns to prewarm for fitness checks.
+ */
+export const DEFAULT_PREWARM_PATTERNS = [
+    '**/*.ts',
+    '**/*.tsx',
+    '**/*.js',
+    '**/*.jsx',
+    '**/*.json',
+    '**/*.md',
+];
+//# sourceMappingURL=file-cache.js.map

package/dist/framework/file-cache.js.map

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

package/dist/framework/file-type-filter.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @fileoverview File type filtering for per-check file extension matching
+ *
+ * Filters matched files by extension based on a check's declared fileTypes.
+ */
+/**
+ * Filter files by extension based on a check's declared fileTypes.
+ * If fileTypes is undefined or empty, returns all files (universal).
+ */
+export declare function filterFilesByType(files: readonly string[], fileTypes: readonly string[] | undefined): string[];
+//# sourceMappingURL=file-type-filter.d.ts.map

package/dist/framework/file-type-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-type-filter.d.ts","sourceRoot":"","sources":["../../src/framework/file-type-filter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,SAAS,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GACvC,MAAM,EAAE,CASV"}

package/dist/framework/file-type-filter.js

@@ -0,0 +1,21 @@
+/**
+ * @fileoverview File type filtering for per-check file extension matching
+ *
+ * Filters matched files by extension based on a check's declared fileTypes.
+ */
+import * as path from 'node:path';
+/**
+ * Filter files by extension based on a check's declared fileTypes.
+ * If fileTypes is undefined or empty, returns all files (universal).
+ */
+export function filterFilesByType(files, fileTypes) {
+    if (!fileTypes || fileTypes.length === 0) {
+        return [...files];
+    }
+    const extensions = new Set(fileTypes);
+    return files.filter((f) => {
+        const ext = path.extname(f).slice(1); // remove leading dot
+        return extensions.has(ext);
+    });
+}
+//# sourceMappingURL=file-type-filter.js.map

package/dist/framework/file-type-filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-type-filter.js","sourceRoot":"","sources":["../../src/framework/file-type-filter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAwB,EACxB,SAAwC;IAExC,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzC,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC;IACpB,CAAC;IACD,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC;IACtC,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QACxB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,qBAAqB;QAC3D,OAAO,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/framework/ignore-processing.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @fileoverview Ignore directive processing for fitness checks
+ *
+ * Filters signals via the shared core suppression primitive (ADR-0014), then
+ * builds fitness-specific outputs on top: the `ignoredCount`, the
+ * `DirectiveEntry` audit list (with weak-reason classification), and the
+ * rebuilt `CheckResult`. The matching algorithm (file/line directives,
+ * anti-recursion: a finding pointing at a directive line is never suppressed)
+ * lives once in `@opensip-cli/core`.
+ */
+import type { DirectiveEntry } from './directive-inventory.js';
+import type { CheckResult } from '../types/findings.js';
+import type { Signal } from '@opensip-cli/core';
+/**
+ * Filter a check's signals by `@fitness-ignore` directives.
+ *
+ * Delegates matching to the core primitive with the fitness keywords and
+ * `ruleIdOf: () => checkId` (every signal in this call belongs to one check, so
+ * the directive must name that check's slug — the historical per-check
+ * semantics). The core primitive owns the anti-recursion guard: a finding that
+ * points at a directive line is never suppressed by a line-level directive,
+ * which prevents directive-auditing checks from suppressing their own findings.
+ *
+ * The suppressed matches are reduced back into the file/line buckets the
+ * `DirectiveEntry` audit collection expects.
+ */
+export declare function filterSignalsByDirectives(signals: readonly Signal[], checkId: string, initialIgnoredCount: number): Promise<{
+    filteredSignals: Signal[];
+    ignoredCount: number;
+    appliedDirectives: DirectiveEntry[];
+}>;
+/**
+ * Builds the filtered result from the original result and filtered signals.
+ */
+export declare function buildFilteredResult(result: CheckResult, filteredSignals: Signal[], ignoredCount: number, start: number): CheckResult;
+//# sourceMappingURL=ignore-processing.d.ts.map

package/dist/framework/ignore-processing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ignore-processing.d.ts","sourceRoot":"","sources":["../../src/framework/ignore-processing.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AAUH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAMhD;;;;;;;;;;;;GAYG;AACH,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,OAAO,EAAE,MAAM,EACf,mBAAmB,EAAE,MAAM,GAC1B,OAAO,CAAC;IACT,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,cAAc,EAAE,CAAC;CACrC,CAAC,CAkCD;AA+GD;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,WAAW,EACnB,eAAe,EAAE,MAAM,EAAE,EACzB,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,GACZ,WAAW,CAwBb"}

package/dist/framework/ignore-processing.js

@@ -0,0 +1,172 @@
+// @fitness-ignore-file batch-operation-limits -- iterates bounded collections (config entries, registry items, or small analysis results)
+// @fitness-ignore-file concurrency-safety -- Single-threaded Node.js; Map-based caches are safe without synchronization
+/**
+ * @fileoverview Ignore directive processing for fitness checks
+ *
+ * Filters signals via the shared core suppression primitive (ADR-0014), then
+ * builds fitness-specific outputs on top: the `ignoredCount`, the
+ * `DirectiveEntry` audit list (with weak-reason classification), and the
+ * rebuilt `CheckResult`. The matching algorithm (file/line directives,
+ * anti-recursion: a finding pointing at a directive line is never suppressed)
+ * lives once in `@opensip-cli/core`.
+ */
+import { filterSignalsBySuppressions, logger } from '@opensip-cli/core';
+import { countErrors, countWarnings } from '../types/severity.js';
+import { extractGroup, isWeakReason, parseDirectiveLine } from './directive-inventory.js';
+import { FITNESS_KEYWORDS } from './directive-parsing.js';
+import { fileCache } from './file-cache.js';
+// =============================================================================
+// SIGNAL FILTERING
+// =============================================================================
+/**
+ * Filter a check's signals by `@fitness-ignore` directives.
+ *
+ * Delegates matching to the core primitive with the fitness keywords and
+ * `ruleIdOf: () => checkId` (every signal in this call belongs to one check, so
+ * the directive must name that check's slug — the historical per-check
+ * semantics). The core primitive owns the anti-recursion guard: a finding that
+ * points at a directive line is never suppressed by a line-level directive,
+ * which prevents directive-auditing checks from suppressing their own findings.
+ *
+ * The suppressed matches are reduced back into the file/line buckets the
+ * `DirectiveEntry` audit collection expects.
+ */
+export async function filterSignalsByDirectives(signals, checkId, initialIgnoredCount) {
+    const { kept, suppressed } = await filterSignalsBySuppressions({
+        signals,
+        keywords: FITNESS_KEYWORDS,
+        readFile: (filePath) => fileCache.get(filePath),
+        ruleIdOf: () => checkId,
+    });
+    const appliedFileIgnores = new Set();
+    const appliedLineIgnores = new Map();
+    for (const match of suppressed) {
+        if (match.line === 'file') {
+            appliedFileIgnores.add(match.file);
+        }
+        else {
+            let lineSet = appliedLineIgnores.get(match.file);
+            if (!lineSet) {
+                lineSet = new Set();
+                appliedLineIgnores.set(match.file, lineSet);
+            }
+            lineSet.add(match.line);
+        }
+    }
+    const appliedDirectives = await collectAppliedDirectives(checkId, appliedFileIgnores, appliedLineIgnores);
+    return {
+        filteredSignals: [...kept],
+        ignoredCount: initialIgnoredCount + suppressed.length,
+        appliedDirectives,
+    };
+}
+// =============================================================================
+// APPLIED DIRECTIVE COLLECTION
+// =============================================================================
+function toDirectiveEntry(filePath, lineNumber, parsed) {
+    return {
+        filePath,
+        lineNumber,
+        type: parsed.type,
+        checkId: parsed.checkId,
+        group: extractGroup(parsed.checkId),
+        reason: parsed.reason,
+        weakReason: isWeakReason(parsed.reason),
+    };
+}
+async function collectFileIgnoreDirectives(checkId, appliedFileIgnores) {
+    const results = await Promise.all([...appliedFileIgnores].map(async (filePath) => {
+        try {
+            const content = await fileCache.get(filePath);
+            const lines = content.split('\n');
+            for (let i = 0; i < Math.min(lines.length, 50); i++) {
+                const parsed = parseDirectiveLine(lines[i] ?? '');
+                if (parsed?.type === 'file' && parsed.checkId === checkId) {
+                    return toDirectiveEntry(filePath, i + 1, parsed);
+                }
+            }
+        }
+        catch (error) {
+            logger.warn('fitness.ignore.directive_read.failed', {
+                evt: 'fitness.ignore.directive_read.failed',
+                module: 'fitness:ignore-processing',
+                err: error,
+            });
+        }
+        return null;
+    }));
+    return results.filter((d) => d !== null);
+}
+async function collectLineIgnoreDirectives(checkId, appliedLineIgnores) {
+    const results = await Promise.all([...appliedLineIgnores.entries()].map(async ([filePath, suppressedLines]) => {
+        const found = [];
+        try {
+            const content = await fileCache.get(filePath);
+            const lines = content.split('\n');
+            for (let i = 0; i < lines.length; i++) {
+                const parsed = parseDirectiveLine(lines[i] ?? '');
+                if (parsed?.type !== 'next-line' || parsed.checkId !== checkId)
+                    continue;
+                let targetLine = i + 1;
+                while (targetLine < lines.length &&
+                    (lines[targetLine] ?? '').trimStart().startsWith('//')) {
+                    targetLine++;
+                }
+                if (suppressedLines.has(targetLine + 1)) {
+                    found.push(toDirectiveEntry(filePath, i + 1, parsed));
+                }
+            }
+        }
+        catch (error) {
+            logger.warn('fitness.ignore.directive_read.failed', {
+                evt: 'fitness.ignore.directive_read.failed',
+                module: 'fitness:ignore-processing',
+                err: error,
+            });
+        }
+        return found;
+    }));
+    const directives = [];
+    for (const batch of results) {
+        for (const d of batch) {
+            directives.push(d);
+        }
+    }
+    return directives;
+}
+async function collectAppliedDirectives(checkId, appliedFileIgnores, appliedLineIgnores) {
+    const [fileDirectives, lineDirectives] = await Promise.all([
+        collectFileIgnoreDirectives(checkId, appliedFileIgnores),
+        collectLineIgnoreDirectives(checkId, appliedLineIgnores),
+    ]);
+    return [...fileDirectives, ...lineDirectives];
+}
+// =============================================================================
+// RESULT BUILDING
+// =============================================================================
+/**
+ * Builds the filtered result from the original result and filtered signals.
+ */
+export function buildFilteredResult(result, filteredSignals, ignoredCount, start) {
+    if (!Array.isArray(filteredSignals)) {
+        return result;
+    }
+    const durationMs = result.metadata.durationMs ?? Date.now() - start;
+    const filteredErrors = countErrors(filteredSignals);
+    const filteredWarnings = countWarnings(filteredSignals);
+    const filteredResult = {
+        ...result,
+        passed: filteredErrors === 0,
+        errors: filteredErrors,
+        warnings: filteredWarnings,
+        signals: filteredSignals,
+        metadata: {
+            ...result.metadata,
+            durationMs,
+            signals: filteredSignals,
+        },
+        ...(ignoredCount > 0 ? { ignoredCount } : {}),
+    };
+    return filteredResult;
+}
+//# sourceMappingURL=ignore-processing.js.map

package/dist/framework/ignore-processing.js.map

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

package/dist/framework/import-graph.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @fileoverview Project-wide import graph builder.
+ *
+ * Builds a file-level dependency graph from a set of TypeScript/JavaScript
+ * source files, plus a Tarjan's strongly-connected-components implementation
+ * for cycle detection. Used by structural-drift checks like
+ * circular-import-detection and module-coupling-fan-out.
+ *
+ * Module resolution is deliberately a heuristic: relative imports are
+ * resolved by trying common extension/index.ts suffixes; bare specifiers
+ * (npm packages) are dropped; tsconfig path aliases are NOT resolved
+ * (treated as unresolved — they simply don't appear as edges in the graph).
+ *
+ * This matches the heuristic the existing `phantom-dependency-detection`
+ * check uses, which has been shipping reliably. Adding tsconfig-aware
+ * resolution is a follow-up plan.
+ */
+/** A file-level import graph for a project. */
+export interface ImportGraph {
+    /** All node file paths (absolute, as supplied by the caller). */
+    readonly nodes: ReadonlySet<string>;
+    /** Adjacency: file → set of files it imports (intra-project edges only). */
+    readonly outbound: ReadonlyMap<string, ReadonlySet<string>>;
+    /** Reverse adjacency: file → set of files that import it. */
+    readonly inbound: ReadonlyMap<string, ReadonlySet<string>>;
+}
+/**
+ * Build an import graph from a collection of file paths and their content.
+ *
+ * Each file's TS AST is walked for top-level `import` and `export ... from`
+ * declarations. Relative specifiers (`./foo`, `../bar/baz.js`) are resolved
+ * against the importing file's directory using the heuristic in
+ * `resolveRelativeSpecifier`. Bare specifiers (`react`, `lodash`) are
+ * dropped — they don't represent intra-project edges.
+ *
+ * Files that fail to parse are still added as nodes (with no edges) so the
+ * graph remains complete.
+ */
+export declare function buildImportGraph(files: ReadonlyMap<string, string>): ImportGraph;
+/**
+ * Find strongly-connected components in the graph using Tarjan's algorithm.
+ *
+ * Returns an array of SCCs, each represented as an array of node names. SCCs
+ * of size 1 represent a node with no cycle (or a self-loop, which is rare in
+ * import graphs). Cycle-detection callers typically filter to `scc.length > 1`
+ * to get only real multi-file cycles.
+ *
+ * Algorithm: standard iterative Tarjan's SCC. O(V + E), single pass.
+ */
+export declare function findStronglyConnectedComponents(graph: ImportGraph): readonly (readonly string[])[];
+//# sourceMappingURL=import-graph.d.ts.map

package/dist/framework/import-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-graph.d.ts","sourceRoot":"","sources":["../../src/framework/import-graph.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;GAgBG;AAYH,+CAA+C;AAC/C,MAAM,WAAW,WAAW;IAC1B,iEAAiE;IACjE,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACpC,4EAA4E;IAC5E,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5D,6DAA6D;IAC7D,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;CAC5D;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,WAAW,CAwBhF;AAED;;;;;;;;;GASG;AACH,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,WAAW,GACjB,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,CAiGhC"}