@ash-technologia/fathom 0.1.0

package/dist/plugins/context.js

@@ -0,0 +1,102 @@
+import path from 'node:path';
+import fs from 'node:fs/promises';
+import { createFindingId } from '../core/findings.js';
+const DEFAULT_MAX_BYTES = 1024 * 1024; // 1 MB
+/**
+ * Creates an isolated, sandboxed PluginContext.
+ *
+ * Enforces:
+ * - Read-only access to repository metadata
+ * - Traversal-safe file reading (cannot read outside repository root)
+ * - Size-bounded reads to avoid out-of-memory errors
+ * - Rule validation on finding creation
+ */
+export function createPluginContext(repoContext, rules) {
+    const root = path.resolve(repoContext.root);
+    const ruleMap = new Map();
+    for (const rule of rules) {
+        ruleMap.set(rule.id, rule);
+    }
+    const filePathSet = new Set(repoContext.files.map((f) => f.relativePath.replace(/\\/g, '/').toLowerCase()));
+    return {
+        repositoryRoot: root,
+        files: repoContext.files,
+        languages: repoContext.languages,
+        frameworks: repoContext.frameworks,
+        packageManagers: repoContext.packageManagers,
+        projectType: repoContext.projectType,
+        git: repoContext.git,
+        online: repoContext.online ?? false,
+        hasFile(relativePath) {
+            const normalized = relativePath.replace(/\\/g, '/').replace(/^\/+/, '').toLowerCase();
+            return filePathSet.has(normalized);
+        },
+        async getFileContent(relativePath, maxBytes = DEFAULT_MAX_BYTES) {
+            // Path traversal security check
+            const normalized = path.normalize(relativePath);
+            const absolutePath = path.resolve(root, normalized);
+            const rel = path.relative(root, absolutePath);
+            if (rel.startsWith('..') || path.isAbsolute(rel)) {
+                // Path attempts to escape repository root
+                return null;
+            }
+            try {
+                const stat = await fs.stat(absolutePath);
+                if (!stat.isFile()) {
+                    return null;
+                }
+                // Bounded read if file exceeds maxBytes
+                if (stat.size > maxBytes) {
+                    const handle = await fs.open(absolutePath, 'r');
+                    try {
+                        const buffer = Buffer.alloc(maxBytes);
+                        const { bytesRead } = await handle.read(buffer, 0, maxBytes, 0);
+                        return buffer.toString('utf8', 0, bytesRead);
+                    }
+                    finally {
+                        await handle.close();
+                    }
+                }
+                return await fs.readFile(absolutePath, 'utf8');
+            }
+            catch {
+                return null;
+            }
+        },
+        createFinding(ruleId, details) {
+            const rule = ruleMap.get(ruleId);
+            const category = rule?.category ?? 'quality';
+            const severity = details.severity ?? rule?.severity ?? 'low';
+            const title = details.title ?? rule?.title ?? rule?.name ?? `Finding from ${ruleId}`;
+            const description = details.description ?? rule?.description ?? '';
+            const recommendation = details.recommendation ?? rule?.recommendation ?? '';
+            const confidence = details.confidence ?? rule?.confidence ?? 0.85;
+            const autoFixable = details.autoFixable ?? rule?.autoFixable ?? false;
+            const normFile = details.filePath?.replace(/\\/g, '/');
+            const location = normFile
+                ? details.lineNumber !== undefined
+                    ? { file: normFile, line: details.lineNumber }
+                    : { file: normFile }
+                : undefined;
+            const finding = {
+                id: createFindingId(ruleId, normFile, details.lineNumber),
+                ruleId,
+                category,
+                severity,
+                title,
+                description,
+                recommendation,
+                confidence,
+                autoFixable,
+            };
+            if (location !== undefined) {
+                finding.location = location;
+            }
+            if (rule?.references && rule.references.length > 0) {
+                finding.references = [...rule.references];
+            }
+            return finding;
+        },
+    };
+}
+//# sourceMappingURL=context.js.map

package/dist/plugins/context.js.map

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

package/dist/plugins/examples/react.d.ts

@@ -0,0 +1,8 @@
+import type { FathomPlugin, PluginAnalyzer, PluginRule } from '../types.js';
+export declare const REACT_RULES: readonly PluginRule[];
+export declare const reactAnalyzer: PluginAnalyzer;
+/**
+ * Example Fathom plugin: @fathom/plugin-react
+ */
+export declare const reactPlugin: FathomPlugin;
+//# sourceMappingURL=react.d.ts.map

package/dist/plugins/examples/react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../../../src/plugins/examples/react.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAiB,UAAU,EAAE,MAAM,aAAa,CAAC;AAG3F,eAAO,MAAM,WAAW,EAAE,SAAS,UAAU,EA6C5C,CAAC;AAMF,eAAO,MAAM,aAAa,EAAE,cAwF3B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,YAUzB,CAAC"}

package/dist/plugins/examples/react.js

@@ -0,0 +1,129 @@
+export const REACT_RULES = [
+    {
+        id: 'REACT-001',
+        name: 'dangerouslySetInnerHTML usage detected',
+        title: 'dangerouslySetInnerHTML usage detected',
+        category: 'security',
+        severity: 'medium',
+        description: 'Bypassing React DOM sanitization with dangerouslySetInnerHTML can expose the application to Cross-Site Scripting (XSS).',
+        recommendation: 'Use safe DOM text rendering or sanitize HTML content with DOMPurify before injecting.',
+        confidence: 0.95,
+        autoFixable: false,
+        enabledByDefault: true,
+        references: ['https://react.dev/reference/react-dom/components/common#dangerously-setting-the-inner-html'],
+    },
+    {
+        id: 'REACT-002',
+        name: 'Array index used as key or missing key in list render',
+        title: 'Array index used as key or missing key in list render',
+        category: 'quality',
+        severity: 'low',
+        description: 'Using array indices as keys in iterated elements leads to state preservation bugs and suboptimal reconciliation.',
+        recommendation: 'Use unique, stable IDs from data items as the key attribute (e.g. key={item.id}).',
+        confidence: 0.85,
+        autoFixable: false,
+        enabledByDefault: true,
+        references: ['https://react.dev/learn/rendering-lists#why-does-react-need-keys'],
+    },
+    {
+        id: 'REACT-003',
+        name: 'Direct React state mutation detected',
+        title: 'Direct React state mutation detected',
+        category: 'quality',
+        severity: 'medium',
+        description: 'Mutating state directly (e.g. this.state.x = value) bypasses React state scheduling and prevents proper component re-renders.',
+        recommendation: 'Always use setState() in class components or the updater function returned by useState/useReducer.',
+        confidence: 0.9,
+        autoFixable: false,
+        enabledByDefault: true,
+    },
+];
+const DANGEROUS_HTML_REGEX = /dangerouslySetInnerHTML\s*=/;
+const INDEX_AS_KEY_REGEX = /key\s*=\s*\{(?:\s*(?:index|idx|i)\s*)\}/i;
+const DIRECT_STATE_MUTATION_REGEX = /this\.state\.[a-zA-Z0-9_$]+\s*=(?!=)/;
+export const reactAnalyzer = {
+    id: 'react',
+    name: 'React Quality & Security',
+    category: 'quality',
+    description: 'Detects React security risks, array index keys, and direct state mutations in JSX/TSX',
+    async analyze(context) {
+        const isReactRepo = context.frameworks.some((f) => f.name === 'react' || f.name === 'nextjs') ||
+            context.files.some((f) => f.relativePath.endsWith('.jsx') || f.relativePath.endsWith('.tsx'));
+        if (!isReactRepo) {
+            return {
+                findings: [],
+                metrics: { reactFilesScanned: 0, reactIssuesFound: 0 },
+            };
+        }
+        const targetFiles = context.files.filter((f) => {
+            const p = f.relativePath.toLowerCase();
+            const isJsx = p.endsWith('.jsx') || p.endsWith('.tsx');
+            const isJs = (p.endsWith('.js') || p.endsWith('.ts')) &&
+                !p.endsWith('.d.ts') &&
+                !p.includes('.test.') &&
+                !p.includes('.spec.');
+            return isJsx || isJs;
+        });
+        const findings = [];
+        let filesScanned = 0;
+        for (const file of targetFiles) {
+            const content = await context.getFileContent(file.relativePath);
+            if (!content)
+                continue;
+            filesScanned++;
+            const lines = content.split(/\r?\n/);
+            for (let i = 0; i < lines.length; i++) {
+                const line = lines[i];
+                if (!line)
+                    continue;
+                const lineNum = i + 1;
+                // Check REACT-001: dangerouslySetInnerHTML
+                if (DANGEROUS_HTML_REGEX.test(line)) {
+                    findings.push(context.createFinding('REACT-001', {
+                        filePath: file.relativePath,
+                        lineNumber: lineNum,
+                        description: `dangerouslySetInnerHTML detected in ${file.relativePath}:${lineNum}. Ensure input is sanitized with DOMPurify.`,
+                    }));
+                }
+                // Check REACT-002: Array index as key
+                if (INDEX_AS_KEY_REGEX.test(line)) {
+                    findings.push(context.createFinding('REACT-002', {
+                        filePath: file.relativePath,
+                        lineNumber: lineNum,
+                        description: `Array index used as key attribute in ${file.relativePath}:${lineNum}. Prefer stable entity IDs.`,
+                    }));
+                }
+                // Check REACT-003: Direct state mutation
+                if (DIRECT_STATE_MUTATION_REGEX.test(line)) {
+                    findings.push(context.createFinding('REACT-003', {
+                        filePath: file.relativePath,
+                        lineNumber: lineNum,
+                        description: `Direct assignment to this.state detected in ${file.relativePath}:${lineNum}. Use setState() instead.`,
+                    }));
+                }
+            }
+        }
+        return {
+            findings,
+            metrics: {
+                reactFilesScanned: filesScanned,
+                reactIssuesFound: findings.length,
+            },
+        };
+    },
+};
+/**
+ * Example Fathom plugin: @fathom/plugin-react
+ */
+export const reactPlugin = {
+    manifest: {
+        name: '@fathom/plugin-react',
+        version: '0.1.0',
+        description: 'React best practices, security, and anti-pattern analyzer for Fathom',
+        author: 'Fathom Core Team',
+        rules: REACT_RULES,
+    },
+    rules: REACT_RULES,
+    analyzers: [reactAnalyzer],
+};
+//# sourceMappingURL=react.js.map

package/dist/plugins/examples/react.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.js","sourceRoot":"","sources":["../../../src/plugins/examples/react.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,WAAW,GAA0B;IAChD;QACE,EAAE,EAAE,WAAW;QACf,IAAI,EAAE,wCAAwC;QAC9C,KAAK,EAAE,wCAAwC;QAC/C,QAAQ,EAAE,UAAU;QACpB,QAAQ,EAAE,QAAQ;QAClB,WAAW,EACT,yHAAyH;QAC3H,cAAc,EACZ,uFAAuF;QACzF,UAAU,EAAE,IAAI;QAChB,WAAW,EAAE,KAAK;QAClB,gBAAgB,EAAE,IAAI;QACtB,UAAU,EAAE,CAAC,4FAA4F,CAAC;KAC3G;IACD;QACE,EAAE,EAAE,WAAW;QACf,IAAI,EAAE,uDAAuD;QAC7D,KAAK,EAAE,uDAAuD;QAC9D,QAAQ,EAAE,SAAS;QACnB,QAAQ,EAAE,KAAK;QACf,WAAW,EACT,kHAAkH;QACpH,cAAc,EACZ,mFAAmF;QACrF,UAAU,EAAE,IAAI;QAChB,WAAW,EAAE,KAAK;QAClB,gBAAgB,EAAE,IAAI;QACtB,UAAU,EAAE,CAAC,kEAAkE,CAAC;KACjF;IACD;QACE,EAAE,EAAE,WAAW;QACf,IAAI,EAAE,sCAAsC;QAC5C,KAAK,EAAE,sCAAsC;QAC7C,QAAQ,EAAE,SAAS;QACnB,QAAQ,EAAE,QAAQ;QAClB,WAAW,EACT,+HAA+H;QACjI,cAAc,EACZ,oGAAoG;QACtG,UAAU,EAAE,GAAG;QACf,WAAW,EAAE,KAAK;QAClB,gBAAgB,EAAE,IAAI;KACvB;CACF,CAAC;AAEF,MAAM,oBAAoB,GAAG,6BAA6B,CAAC;AAC3D,MAAM,kBAAkB,GAAG,0CAA0C,CAAC;AACtE,MAAM,2BAA2B,GAAG,sCAAsC,CAAC;AAE3E,MAAM,CAAC,MAAM,aAAa,GAAmB;IAC3C,EAAE,EAAE,OAAO;IACX,IAAI,EAAE,0BAA0B;IAChC,QAAQ,EAAE,SAAS;IACnB,WAAW,EAAE,uFAAuF;IACpG,KAAK,CAAC,OAAO,CAAC,OAAsB;QAClC,MAAM,WAAW,GACf,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC;YACzE,OAAO,CAAC,KAAK,CAAC,IAAI,CAChB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,CAC1E,CAAC;QAEJ,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO;gBACL,QAAQ,EAAE,EAAE;gBACZ,OAAO,EAAE,EAAE,iBAAiB,EAAE,CAAC,EAAE,gBAAgB,EAAE,CAAC,EAAE;aACvD,CAAC;QACJ,CAAC;QAED,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;YAC7C,MAAM,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC;YACvC,MAAM,KAAK,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YACvD,MAAM,IAAI,GACR,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;gBACxC,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;gBACpB,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBACrB,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACxB,OAAO,KAAK,IAAI,IAAI,CAAC;QACvB,CAAC,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAc,EAAE,CAAC;QAC/B,IAAI,YAAY,GAAG,CAAC,CAAC;QAErB,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;YAC/B,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAChE,IAAI,CAAC,OAAO;gBAAE,SAAS;YAEvB,YAAY,EAAE,CAAC;YACf,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAErC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;gBACtB,IAAI,CAAC,IAAI;oBAAE,SAAS;gBACpB,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC;gBAEtB,2CAA2C;gBAC3C,IAAI,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;oBACpC,QAAQ,CAAC,IAAI,CACX,OAAO,CAAC,aAAa,CAAC,WAAW,EAAE;wBACjC,QAAQ,EAAE,IAAI,CAAC,YAAY;wBAC3B,UAAU,EAAE,OAAO;wBACnB,WAAW,EAAE,uCAAuC,IAAI,CAAC,YAAY,IAAI,OAAO,6CAA6C;qBAC9H,CAAC,CACH,CAAC;gBACJ,CAAC;gBAED,sCAAsC;gBACtC,IAAI,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;oBAClC,QAAQ,CAAC,IAAI,CACX,OAAO,CAAC,aAAa,CAAC,WAAW,EAAE;wBACjC,QAAQ,EAAE,IAAI,CAAC,YAAY;wBAC3B,UAAU,EAAE,OAAO;wBACnB,WAAW,EAAE,wCAAwC,IAAI,CAAC,YAAY,IAAI,OAAO,6BAA6B;qBAC/G,CAAC,CACH,CAAC;gBACJ,CAAC;gBAED,yCAAyC;gBACzC,IAAI,2BAA2B,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC3C,QAAQ,CAAC,IAAI,CACX,OAAO,CAAC,aAAa,CAAC,WAAW,EAAE;wBACjC,QAAQ,EAAE,IAAI,CAAC,YAAY;wBAC3B,UAAU,EAAE,OAAO;wBACnB,WAAW,EAAE,+CAA+C,IAAI,CAAC,YAAY,IAAI,OAAO,2BAA2B;qBACpH,CAAC,CACH,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO;YACL,QAAQ;YACR,OAAO,EAAE;gBACP,iBAAiB,EAAE,YAAY;gBAC/B,gBAAgB,EAAE,QAAQ,CAAC,MAAM;aAClC;SACF,CAAC;IACJ,CAAC;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAiB;IACvC,QAAQ,EAAE;QACR,IAAI,EAAE,sBAAsB;QAC5B,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE,sEAAsE;QACnF,MAAM,EAAE,kBAAkB;QAC1B,KAAK,EAAE,WAAW;KACnB;IACD,KAAK,EAAE,WAAW;IAClB,SAAS,EAAE,CAAC,aAAa,CAAC;CAC3B,CAAC"}

package/dist/plugins/index.d.ts

@@ -0,0 +1,5 @@
+export type { PluginManifest, PluginRule, PluginContext, PluginAnalyzer, PluginAnalyzerResult, PluginSetupContext, FathomPlugin, } from './types.js';
+export { createPluginContext } from './context.js';
+export { PluginRegistry, defaultPluginRegistry } from './registry.js';
+export { reactPlugin, REACT_RULES, reactAnalyzer } from './examples/react.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugins/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,cAAc,EACd,UAAU,EACV,aAAa,EACb,cAAc,EACd,oBAAoB,EACpB,kBAAkB,EAClB,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/plugins/index.js

@@ -0,0 +1,4 @@
+export { createPluginContext } from './context.js';
+export { PluginRegistry, defaultPluginRegistry } from './registry.js';
+export { reactPlugin, REACT_RULES, reactAnalyzer } from './examples/react.js';
+//# sourceMappingURL=index.js.map

package/dist/plugins/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/plugins/index.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/plugins/registry.d.ts

@@ -0,0 +1,45 @@
+import type { Analyzer } from '../core/analyzer.js';
+import type { FathomPlugin } from './types.js';
+/**
+ * Registry managing Fathom plugins, their analyzers, and custom rules.
+ */
+export declare class PluginRegistry {
+    private readonly plugins;
+    /**
+     * Validate a plugin definition schema.
+     * Throws FathomPluginError if the plugin is malformed.
+     */
+    validatePlugin(plugin: unknown): FathomPlugin;
+    /**
+     * Register a new plugin with the registry.
+     */
+    register(plugin: FathomPlugin): Promise<this>;
+    /**
+     * Unregister a plugin by name.
+     */
+    unregister(name: string): boolean;
+    /**
+     * Get a registered plugin by name.
+     */
+    get(name: string): FathomPlugin | undefined;
+    /**
+     * Get all registered plugins.
+     */
+    getAll(): FathomPlugin[];
+    /**
+     * Check if a plugin is registered.
+     */
+    has(name: string): boolean;
+    /**
+     * Clear all registered plugins.
+     */
+    clear(): void;
+    /**
+     * Adapt all plugin analyzers to the core Fathom Analyzer interface.
+     * Wraps analyzer execution in safe boundaries.
+     */
+    getAnalyzers(): Analyzer[];
+}
+/** Shared singleton plugin registry */
+export declare const defaultPluginRegistry: PluginRegistry;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/plugins/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAUpD,OAAO,KAAK,EACV,YAAY,EAIb,MAAM,YAAY,CAAC;AAIpB;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmC;IAE3D;;;OAGG;IACH,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,YAAY;IAsH7C;;OAEG;IACG,QAAQ,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IA4DnD;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAI3C;;OAEG;IACH,MAAM,IAAI,YAAY,EAAE;IAIxB;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;;OAGG;IACH,YAAY,IAAI,QAAQ,EAAE;CAsD3B;AAED,uCAAuC;AACvC,eAAO,MAAM,qBAAqB,gBAAuB,CAAC"}

package/dist/plugins/registry.js

@@ -0,0 +1,236 @@
+import { CATEGORIES } from '../rules/categories.js';
+import { SEVERITY_ORDER } from '../rules/severity.js';
+import { ruleRegistry } from '../rules/registry.js';
+import { FathomPluginError } from '../core/errors.js';
+import { createTimer } from '../utils/timing.js';
+import { logger } from '../utils/logger.js';
+import { createPluginContext } from './context.js';
+const VALID_PLUGIN_NAME_REGEX = /^(@[a-zA-Z0-9_.-]+\/)?[a-zA-Z0-9_.-]+$/;
+/**
+ * Registry managing Fathom plugins, their analyzers, and custom rules.
+ */
+export class PluginRegistry {
+    plugins = new Map();
+    /**
+     * Validate a plugin definition schema.
+     * Throws FathomPluginError if the plugin is malformed.
+     */
+    validatePlugin(plugin) {
+        if (!plugin || typeof plugin !== 'object') {
+            throw new FathomPluginError('Plugin definition must be a valid object');
+        }
+        const p = plugin;
+        if (!p['manifest'] || typeof p['manifest'] !== 'object') {
+            throw new FathomPluginError('Plugin must define a valid "manifest" object');
+        }
+        const manifest = p['manifest'];
+        const name = manifest['name'];
+        if (typeof name !== 'string' || !name.trim() || !VALID_PLUGIN_NAME_REGEX.test(name.trim())) {
+            throw new FathomPluginError(`Invalid plugin name "${String(name)}". Plugin names must be valid package names (e.g. "@fathom/plugin-react" or "custom-plugin").`);
+        }
+        const version = manifest['version'];
+        if (typeof version !== 'string' || !version.trim()) {
+            throw new FathomPluginError(`Plugin "${name}" must declare a valid non-empty "version" string.`, name);
+        }
+        const description = manifest['description'];
+        if (typeof description !== 'string') {
+            throw new FathomPluginError(`Plugin "${name}" must declare a "description" string in its manifest.`, name);
+        }
+        // Validate rules if present in manifest or plugin root
+        const rules = (manifest['rules'] ?? p['rules'] ?? []);
+        if (!Array.isArray(rules)) {
+            throw new FathomPluginError(`Plugin "${name}" rules must be an array.`, name);
+        }
+        const allowedCategories = CATEGORIES;
+        const allowedSeverities = Object.keys(SEVERITY_ORDER);
+        for (const r of rules) {
+            if (!r || typeof r !== 'object') {
+                throw new FathomPluginError(`Plugin "${name}" contains an invalid rule entry.`, name);
+            }
+            const rule = r;
+            const ruleId = rule['id'];
+            if (typeof ruleId !== 'string' || !ruleId.trim()) {
+                throw new FathomPluginError(`Plugin "${name}" has a rule with missing or empty id.`, name);
+            }
+            const title = rule['title'];
+            if (typeof title !== 'string' || !title.trim()) {
+                throw new FathomPluginError(`Plugin "${name}" rule "${ruleId}" has missing or empty title.`, name);
+            }
+            const category = rule['category'];
+            if (typeof category !== 'string' || !allowedCategories.includes(category)) {
+                throw new FathomPluginError(`Plugin "${name}" rule "${ruleId}" has invalid category "${String(category)}".`, name);
+            }
+            const severity = rule['severity'];
+            if (typeof severity !== 'string' || !allowedSeverities.includes(severity)) {
+                throw new FathomPluginError(`Plugin "${name}" rule "${ruleId}" has invalid severity "${String(severity)}".`, name);
+            }
+        }
+        // Validate analyzers if present
+        const analyzers = (p['analyzers'] ?? []);
+        if (!Array.isArray(analyzers)) {
+            throw new FathomPluginError(`Plugin "${name}" analyzers must be an array.`, name);
+        }
+        for (const a of analyzers) {
+            if (!a || typeof a !== 'object') {
+                throw new FathomPluginError(`Plugin "${name}" contains an invalid analyzer entry.`, name);
+            }
+            const analyzer = a;
+            const analyzerId = analyzer['id'];
+            if (typeof analyzerId !== 'string' || !analyzerId.trim()) {
+                throw new FathomPluginError(`Plugin "${name}" has an analyzer with missing or empty id.`, name);
+            }
+            const analyzerName = analyzer['name'];
+            if (typeof analyzerName !== 'string' || !analyzerName.trim()) {
+                throw new FathomPluginError(`Plugin "${name}" analyzer "${analyzerId}" has missing name.`, name);
+            }
+            const category = analyzer['category'];
+            if (typeof category !== 'string' || !allowedCategories.includes(category)) {
+                throw new FathomPluginError(`Plugin "${name}" analyzer "${analyzerId}" has invalid category "${String(category)}".`, name);
+            }
+            if (typeof analyzer['analyze'] !== 'function') {
+                throw new FathomPluginError(`Plugin "${name}" analyzer "${analyzerId}" must provide an "analyze" function.`, name);
+            }
+        }
+        return plugin;
+    }
+    /**
+     * Register a new plugin with the registry.
+     */
+    async register(plugin) {
+        const validated = this.validatePlugin(plugin);
+        const name = validated.manifest.name;
+        if (this.plugins.has(name)) {
+            throw new FathomPluginError(`Plugin "${name}" is already registered.`, name);
+        }
+        const programmaticRules = [];
+        const programmaticAnalyzers = [];
+        // Run setup hook if provided
+        if (typeof validated.setup === 'function') {
+            const setupContext = {
+                registerRule(rule) {
+                    programmaticRules.push(rule);
+                },
+                registerAnalyzer(analyzer) {
+                    programmaticAnalyzers.push(analyzer);
+                },
+            };
+            await validated.setup(setupContext);
+        }
+        // Collect all rules
+        const allRules = [
+            ...validated.manifest.rules,
+            ...(validated.rules ?? []),
+            ...programmaticRules,
+        ];
+        // Deduplicate rules by ID
+        const uniqueRules = new Map();
+        for (const r of allRules) {
+            uniqueRules.set(r.id, r);
+            // Register in global Fathom rule registry for config override compatibility
+            ruleRegistry.registerRule(r);
+        }
+        // Collect all analyzers
+        const allAnalyzers = [
+            ...(validated.analyzers ?? []),
+            ...programmaticAnalyzers,
+        ];
+        const finalizedPlugin = {
+            manifest: {
+                ...validated.manifest,
+                rules: [...uniqueRules.values()],
+            },
+            rules: [...uniqueRules.values()],
+            analyzers: allAnalyzers,
+        };
+        this.plugins.set(name, finalizedPlugin);
+        logger.debug(`Registered plugin: ${name} (v${validated.manifest.version})`);
+        return this;
+    }
+    /**
+     * Unregister a plugin by name.
+     */
+    unregister(name) {
+        return this.plugins.delete(name);
+    }
+    /**
+     * Get a registered plugin by name.
+     */
+    get(name) {
+        return this.plugins.get(name);
+    }
+    /**
+     * Get all registered plugins.
+     */
+    getAll() {
+        return [...this.plugins.values()];
+    }
+    /**
+     * Check if a plugin is registered.
+     */
+    has(name) {
+        return this.plugins.has(name);
+    }
+    /**
+     * Clear all registered plugins.
+     */
+    clear() {
+        this.plugins.clear();
+    }
+    /**
+     * Adapt all plugin analyzers to the core Fathom Analyzer interface.
+     * Wraps analyzer execution in safe boundaries.
+     */
+    getAnalyzers() {
+        const coreAnalyzers = [];
+        for (const plugin of this.plugins.values()) {
+            const pluginRules = plugin.rules ?? plugin.manifest.rules ?? [];
+            const analyzers = plugin.analyzers ?? [];
+            for (const analyzer of analyzers) {
+                const fullId = `plugin:${plugin.manifest.name}:${analyzer.id}`;
+                const displayName = `${analyzer.name} [${plugin.manifest.name}]`;
+                coreAnalyzers.push({
+                    id: fullId,
+                    name: displayName,
+                    category: analyzer.category,
+                    description: analyzer.description,
+                    async analyze(context) {
+                        const elapsed = createTimer();
+                        try {
+                            const pluginContext = createPluginContext(context, pluginRules);
+                            const result = await analyzer.analyze(pluginContext);
+                            return {
+                                analyzerId: fullId,
+                                analyzerName: displayName,
+                                category: analyzer.category,
+                                status: 'success',
+                                findings: result.findings,
+                                metrics: result.metrics ?? {},
+                                warnings: result.warnings ?? [],
+                                durationMs: elapsed(),
+                            };
+                        }
+                        catch (err) {
+                            const message = err instanceof Error ? err.message : String(err);
+                            logger.warn(`Plugin analyzer "${displayName}" failed: ${message}`);
+                            return {
+                                analyzerId: fullId,
+                                analyzerName: displayName,
+                                category: analyzer.category,
+                                status: 'failed',
+                                findings: [],
+                                metrics: {},
+                                warnings: [],
+                                durationMs: elapsed(),
+                                error: message,
+                            };
+                        }
+                    },
+                });
+            }
+        }
+        return coreAnalyzers;
+    }
+}
+/** Shared singleton plugin registry */
+export const defaultPluginRegistry = new PluginRegistry();
+//# sourceMappingURL=registry.js.map

package/dist/plugins/registry.js.map

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