mcp-adr-analysis-server 2.1.9 → 2.1.20

package/dist/src/resources/resource-router.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Resource Router - URI routing infrastructure for templated resources
+ * Supports parameterized URIs like adr://adr/{id} and adr://research/{topic}
+ */
+import { URLSearchParams } from 'url';
+import { ResourceGenerationResult } from './index.js';
+export type ResourceHandler = (params: Record<string, string>, searchParams: URLSearchParams) => Promise<ResourceGenerationResult>;
+export interface RouteRegistration {
+    pattern: string;
+    handler: ResourceHandler;
+    description?: string;
+}
+/**
+ * URI Router for templated resources
+ * Matches URI patterns and extracts parameters
+ */
+export declare class ResourceRouter {
+    private routes;
+    /**
+     * Register a route pattern with its handler
+     */
+    register(pattern: string, handler: ResourceHandler, description?: string): void;
+    /**
+     * Route a URI to its handler and execute
+     */
+    route(uri: string): Promise<ResourceGenerationResult>;
+    /**
+     * Check if a pattern matches a path
+     */
+    private matchPattern;
+    /**
+     * Extract parameters from path based on pattern
+     */
+    private extractParams;
+    /**
+     * Get all registered routes
+     */
+    getRoutes(): RouteRegistration[];
+    /**
+     * Check if a URI can be routed
+     */
+    canRoute(uri: string): boolean;
+}
+export declare const resourceRouter: ResourceRouter;
+//# sourceMappingURL=resource-router.d.ts.map

package/dist/src/resources/resource-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-router.d.ts","sourceRoot":"","sources":["../../../src/resources/resource-router.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAO,eAAe,EAAE,MAAM,KAAK,CAAC;AAC3C,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAGtD,MAAM,MAAM,eAAe,GAAG,CAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,YAAY,EAAE,eAAe,KAC1B,OAAO,CAAC,wBAAwB,CAAC,CAAC;AAEvC,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,eAAe,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAA2B;IAEzC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI;IAgB/E;;OAEG;IACG,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAe3D;;OAEG;IACH,OAAO,CAAC,YAAY;IAMpB;;OAEG;IACH,OAAO,CAAC,aAAa;IAkBrB;;OAEG;IACH,SAAS,IAAI,iBAAiB,EAAE;IAIhC;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;CAe/B;AAGD,eAAO,MAAM,cAAc,gBAAuB,CAAC"}

package/dist/src/resources/resource-router.js

@@ -0,0 +1,96 @@
+/**
+ * Resource Router - URI routing infrastructure for templated resources
+ * Supports parameterized URIs like adr://adr/{id} and adr://research/{topic}
+ */
+import { URL } from 'url';
+import { McpAdrError } from '../types/index.js';
+/**
+ * URI Router for templated resources
+ * Matches URI patterns and extracts parameters
+ */
+export class ResourceRouter {
+    routes = [];
+    /**
+     * Register a route pattern with its handler
+     */
+    register(pattern, handler, description) {
+        // Ensure pattern starts with /
+        const normalizedPattern = pattern.startsWith('/') ? pattern : `/${pattern}`;
+        const registration = {
+            pattern: normalizedPattern,
+            handler,
+        };
+        if (description !== undefined) {
+            registration.description = description;
+        }
+        this.routes.push(registration);
+    }
+    /**
+     * Route a URI to its handler and execute
+     */
+    async route(uri) {
+        const url = new URL(uri);
+        const path = url.pathname;
+        // Try to match pattern
+        for (const route of this.routes) {
+            if (this.matchPattern(route.pattern, path)) {
+                const params = this.extractParams(route.pattern, path);
+                return await route.handler(params, url.searchParams);
+            }
+        }
+        throw new McpAdrError(`No route found for: ${uri}`, 'RESOURCE_NOT_FOUND');
+    }
+    /**
+     * Check if a pattern matches a path
+     */
+    matchPattern(pattern, path) {
+        // Convert pattern to regex: /adr/{id} -> /adr/([^/]+)
+        const regex = pattern.replace(/\{[^}]+\}/g, '([^/]+)');
+        return new RegExp(`^${regex}$`).test(path);
+    }
+    /**
+     * Extract parameters from path based on pattern
+     */
+    extractParams(pattern, path) {
+        const paramNames = pattern.match(/\{([^}]+)\}/g)?.map(p => p.slice(1, -1)) || [];
+        const regex = pattern.replace(/\{[^}]+\}/g, '([^/]+)');
+        const matches = path.match(new RegExp(`^${regex}$`));
+        const params = {};
+        if (matches) {
+            paramNames.forEach((name, i) => {
+                const value = matches[i + 1];
+                if (value !== undefined) {
+                    params[name] = decodeURIComponent(value);
+                }
+            });
+        }
+        return params;
+    }
+    /**
+     * Get all registered routes
+     */
+    getRoutes() {
+        return [...this.routes];
+    }
+    /**
+     * Check if a URI can be routed
+     */
+    canRoute(uri) {
+        try {
+            const url = new URL(uri);
+            const path = url.pathname;
+            for (const route of this.routes) {
+                if (this.matchPattern(route.pattern, path)) {
+                    return true;
+                }
+            }
+            return false;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+// Singleton instance
+export const resourceRouter = new ResourceRouter();
+//# sourceMappingURL=resource-router.js.map

package/dist/src/resources/resource-router.js.map

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

package/dist/src/resources/rule-by-id-resource.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Rule by ID Resource - Individual rule details
+ * URI Pattern: adr://rule/{rule_id}
+ */
+import { URLSearchParams } from 'url';
+import { ResourceGenerationResult } from './index.js';
+export interface Rule {
+    id: string;
+    name: string;
+    description: string;
+    type: 'architectural' | 'coding' | 'security' | 'performance' | 'documentation';
+    severity: 'info' | 'warning' | 'error' | 'critical';
+    pattern?: string;
+    message: string;
+    source: 'adr' | 'inferred' | 'user_defined';
+    enabled: boolean;
+    createdAt?: string;
+}
+export interface DetailedRule extends Rule {
+    violations: Array<{
+        file: string;
+        line: number;
+        message: string;
+        severity: string;
+    }>;
+    relatedAdrs: string[];
+    usage: {
+        totalChecks: number;
+        totalViolations: number;
+        lastChecked: string;
+        violationRate: number;
+    };
+}
+/**
+ * Generate rule by ID resource
+ */
+export declare function generateRuleByIdResource(params: Record<string, string>, _searchParams: URLSearchParams): Promise<ResourceGenerationResult>;
+//# sourceMappingURL=rule-by-id-resource.d.ts.map

package/dist/src/resources/rule-by-id-resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-by-id-resource.d.ts","sourceRoot":"","sources":["../../../src/resources/rule-by-id-resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,KAAK,CAAC;AAGtC,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAItD,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,eAAe,GAAG,QAAQ,GAAG,UAAU,GAAG,aAAa,GAAG,eAAe,CAAC;IAChF,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,KAAK,GAAG,UAAU,GAAG,cAAc,CAAC;IAC5C,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAa,SAAQ,IAAI;IACxC,UAAU,EAAE,KAAK,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;IACH,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,EAAE;QACL,WAAW,EAAE,MAAM,CAAC;QACpB,eAAe,EAAE,MAAM,CAAC;QACxB,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AA0ED;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,aAAa,EAAE,eAAe,GAC7B,OAAO,CAAC,wBAAwB,CAAC,CAgDnC"}

package/dist/src/resources/rule-by-id-resource.js

@@ -0,0 +1,104 @@
+/**
+ * Rule by ID Resource - Individual rule details
+ * URI Pattern: adr://rule/{rule_id}
+ */
+import { McpAdrError } from '../types/index.js';
+import { resourceCache, generateETag } from './resource-cache.js';
+import { resourceRouter } from './resource-router.js';
+/**
+ * Load all rules from various sources
+ */
+async function loadAllRules() {
+    // Import rule extraction functions
+    const { generateRuleCatalogResource } = await import('./rule-catalog-resource.js');
+    // Get rule catalog
+    const catalogResult = await generateRuleCatalogResource();
+    const catalog = catalogResult.data;
+    return catalog.rules || [];
+}
+/**
+ * Find rule violations (placeholder - would require code analysis)
+ */
+async function findRuleViolations(rule) {
+    // TODO: Implement actual code analysis for rule violations
+    // For now, return placeholder violations
+    return [
+        {
+            file: 'src/example.ts',
+            line: 42,
+            message: `Violation of rule: ${rule.name}`,
+            severity: rule.severity,
+        },
+    ];
+}
+/**
+ * Find ADRs related to this rule
+ */
+async function findRelatedAdrsForRule(rule) {
+    // If rule source is ADR, extract ADR reference
+    if (rule.source === 'adr') {
+        const adrReferences = rule.description.match(/ADR[-\s]?(\d+)/gi);
+        if (adrReferences) {
+            return adrReferences.map(ref => ref.trim());
+        }
+    }
+    return [];
+}
+/**
+ * Get rule usage statistics (placeholder - would require tracking)
+ */
+async function getRuleUsageStats(_ruleId) {
+    // TODO: Implement actual usage tracking
+    // For now, return placeholder stats
+    const totalChecks = 100;
+    const totalViolations = 15;
+    return {
+        totalChecks,
+        totalViolations,
+        lastChecked: new Date().toISOString(),
+        violationRate: totalViolations / totalChecks,
+    };
+}
+/**
+ * Generate rule by ID resource
+ */
+export async function generateRuleByIdResource(params, _searchParams) {
+    const rule_id = params['rule_id'];
+    if (!rule_id) {
+        throw new McpAdrError('Missing required parameter: rule_id', 'INVALID_PARAMS');
+    }
+    const cacheKey = `rule:${rule_id}`;
+    // Check cache
+    const cached = await resourceCache.get(cacheKey);
+    if (cached) {
+        return cached;
+    }
+    // Load all rules
+    const allRules = await loadAllRules();
+    // Find rule by ID or name match
+    const rule = allRules.find(r => r.id === rule_id || r.name.toLowerCase().includes(rule_id.toLowerCase()));
+    if (!rule) {
+        throw new McpAdrError(`Rule not found: ${rule_id}`, 'RESOURCE_NOT_FOUND');
+    }
+    // Build detailed rule data
+    const detailedRule = {
+        ...rule,
+        violations: await findRuleViolations(rule),
+        relatedAdrs: await findRelatedAdrsForRule(rule),
+        usage: await getRuleUsageStats(rule_id),
+    };
+    const result = {
+        data: detailedRule,
+        contentType: 'application/json',
+        lastModified: new Date().toISOString(),
+        cacheKey,
+        ttl: 300, // 5 minutes cache
+        etag: generateETag(detailedRule),
+    };
+    // Cache result
+    resourceCache.set(cacheKey, result, result.ttl);
+    return result;
+}
+// Register route
+resourceRouter.register('/rule/{rule_id}', generateRuleByIdResource, 'Individual rule details by ID or name match');
+//# sourceMappingURL=rule-by-id-resource.js.map

package/dist/src/resources/rule-by-id-resource.js.map

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

package/dist/src/resources/rule-catalog-resource.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Rule Catalog Resource
+ * Provides access to architectural and validation rules
+ */
+import { ResourceGenerationResult } from './index.js';
+export interface Rule {
+    id: string;
+    name: string;
+    description: string;
+    type: 'architectural' | 'coding' | 'security' | 'performance' | 'documentation';
+    severity: 'info' | 'warning' | 'error' | 'critical';
+    pattern?: string;
+    message: string;
+    source: 'adr' | 'inferred' | 'user_defined';
+    enabled: boolean;
+    createdAt?: string;
+}
+/**
+ * Generate comprehensive rule catalog resource with compliance tracking and rule management.
+ *
+ * Aggregates architectural rules from multiple sources including ADRs, inferred patterns,
+ * and custom user-defined rules. Provides categorization by type, severity, and source for
+ * effective governance and compliance monitoring.
+ *
+ * **Rule Sources:**
+ * - ADR-based rules: Extracted from architectural decision records
+ * - Inferred rules: Derived from codebase patterns and best practices
+ * - Custom rules: User-defined via configuration files
+ *
+ * **Rule Types:**
+ * - architecture: Architectural patterns and structures
+ * - security: Security policies and practices
+ * - performance: Performance optimization guidelines
+ * - testing: Test coverage and quality requirements
+ * - documentation: Documentation standards
+ *
+ * **Severity Levels:**
+ * - critical: Violations block deployment
+ * - high: Must fix before release
+ * - medium: Should fix soon
+ * - low: Nice to fix
+ *
+ * @returns Promise resolving to resource generation result containing:
+ *   - data: Complete rule catalog with rules array and summary statistics
+ *   - contentType: "application/json"
+ *   - lastModified: ISO timestamp of generation
+ *   - cacheKey: "rule-catalog:current"
+ *   - ttl: Cache duration (300 seconds / 5 minutes)
+ *   - etag: Entity tag for cache validation
+ *
+ * @throws {McpAdrError} When rule catalog generation fails due to:
+ *   - RESOURCE_GENERATION_ERROR: ADR parsing errors or rule extraction failures
+ *   - Cache operation failures
+ *
+ * @example
+ * ```typescript
+ * const ruleCatalog = await generateRuleCatalogResource();
+ *
+ * console.log(`Total rules: ${ruleCatalog.data.summary.total}`);
+ * console.log(`Enabled: ${ruleCatalog.data.summary.enabled}`);
+ * console.log(`Disabled: ${ruleCatalog.data.summary.disabled}`);
+ *
+ * // Get critical security rules
+ * const criticalSecurityRules = ruleCatalog.data.rules.filter(
+ *   r => r.type === 'security' && r.severity === 'critical' && r.enabled
+ * );
+ * console.log(`Critical security rules: ${criticalSecurityRules.length}`);
+ *
+ * // Group rules by source
+ * console.log(`ADR rules: ${ruleCatalog.data.summary.bySource.adr}`);
+ * console.log(`Inferred rules: ${ruleCatalog.data.summary.bySource.inferred}`);
+ * console.log(`Custom rules: ${ruleCatalog.data.summary.bySource.user_defined}`);
+ *
+ * // Expected output structure:
+ * {
+ *   data: {
+ *     version: "1.0.0",
+ *     timestamp: "2025-10-12T17:00:00.000Z",
+ *     summary: {
+ *       total: 45,
+ *       byType: {
+ *         architecture: 12,
+ *         security: 10,
+ *         performance: 8,
+ *         testing: 10,
+ *         documentation: 5
+ *       },
+ *       bySeverity: {
+ *         critical: 5,
+ *         high: 15,
+ *         medium: 20,
+ *         low: 5
+ *       },
+ *       bySource: {
+ *         adr: 20,
+ *         inferred: 15,
+ *         user_defined: 10
+ *       },
+ *       enabled: 40,
+ *       disabled: 5
+ *     },
+ *     rules: [
+ *       {
+ *         id: "rule-001",
+ *         name: "Use PostgreSQL for primary database",
+ *         type: "architecture",
+ *         severity: "critical",
+ *         source: "adr",
+ *         enabled: true,
+ *         adrReference: "ADR-001"
+ *       }
+ *     ]
+ *   },
+ *   contentType: "application/json",
+ *   cacheKey: "rule-catalog:current",
+ *   ttl: 300
+ * }
+ * ```
+ *
+ * @since v2.0.0
+ * @see {@link extractRulesFromAdrs} for ADR rule extraction
+ * @see {@link extractInferredRules} for pattern-based rule inference
+ * @see {@link loadCustomRules} for user-defined rule loading
+ */
+export declare function generateRuleCatalogResource(): Promise<ResourceGenerationResult>;
+//# sourceMappingURL=rule-catalog-resource.d.ts.map

package/dist/src/resources/rule-catalog-resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-catalog-resource.d.ts","sourceRoot":"","sources":["../../../src/resources/rule-catalog-resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAEtD,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,eAAe,GAAG,QAAQ,GAAG,UAAU,GAAG,aAAa,GAAG,eAAe,CAAC;IAChF,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,KAAK,GAAG,UAAU,GAAG,cAAc,CAAC;IAC5C,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA2ED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0GG;AACH,wBAAsB,2BAA2B,IAAI,OAAO,CAAC,wBAAwB,CAAC,CAsDrF"}

package/dist/src/resources/rule-catalog-resource.js

@@ -0,0 +1,224 @@
+/**
+ * Rule Catalog Resource
+ * Provides access to architectural and validation rules
+ */
+import { McpAdrError } from '../types/index.js';
+import { resourceCache, generateETag } from './resource-cache.js';
+/**
+ * Extract rules from ADRs
+ */
+async function extractRulesFromAdrs() {
+    // TODO: Implement actual rule extraction from ADRs
+    // For now, return example rules
+    return [
+        {
+            id: 'adr-rule-001',
+            name: 'MCP Best Practices',
+            description: 'Follow MCP protocol best practices for resources vs tools',
+            type: 'architectural',
+            severity: 'warning',
+            message: 'Read-only operations should use resources, not tools',
+            source: 'adr',
+            enabled: true,
+        },
+    ];
+}
+/**
+ * Extract inferred rules from code patterns
+ */
+async function extractInferredRules() {
+    // TODO: Implement actual inference from code
+    return [
+        {
+            id: 'inferred-rule-001',
+            name: 'TypeScript Strict Mode',
+            description: 'Project uses TypeScript strict mode',
+            type: 'coding',
+            severity: 'info',
+            message: 'Maintain strict TypeScript compilation',
+            source: 'inferred',
+            enabled: true,
+        },
+    ];
+}
+/**
+ * Load custom user-defined rules
+ */
+async function loadCustomRules() {
+    // TODO: Load from configuration file
+    return [];
+}
+/**
+ * Group rules by type
+ */
+function groupByType(rules) {
+    const grouped = {};
+    for (const rule of rules) {
+        grouped[rule.type] = (grouped[rule.type] || 0) + 1;
+    }
+    return grouped;
+}
+/**
+ * Group rules by severity
+ */
+function groupBySeverity(rules) {
+    const grouped = {};
+    for (const rule of rules) {
+        grouped[rule.severity] = (grouped[rule.severity] || 0) + 1;
+    }
+    return grouped;
+}
+/**
+ * Generate comprehensive rule catalog resource with compliance tracking and rule management.
+ *
+ * Aggregates architectural rules from multiple sources including ADRs, inferred patterns,
+ * and custom user-defined rules. Provides categorization by type, severity, and source for
+ * effective governance and compliance monitoring.
+ *
+ * **Rule Sources:**
+ * - ADR-based rules: Extracted from architectural decision records
+ * - Inferred rules: Derived from codebase patterns and best practices
+ * - Custom rules: User-defined via configuration files
+ *
+ * **Rule Types:**
+ * - architecture: Architectural patterns and structures
+ * - security: Security policies and practices
+ * - performance: Performance optimization guidelines
+ * - testing: Test coverage and quality requirements
+ * - documentation: Documentation standards
+ *
+ * **Severity Levels:**
+ * - critical: Violations block deployment
+ * - high: Must fix before release
+ * - medium: Should fix soon
+ * - low: Nice to fix
+ *
+ * @returns Promise resolving to resource generation result containing:
+ *   - data: Complete rule catalog with rules array and summary statistics
+ *   - contentType: "application/json"
+ *   - lastModified: ISO timestamp of generation
+ *   - cacheKey: "rule-catalog:current"
+ *   - ttl: Cache duration (300 seconds / 5 minutes)
+ *   - etag: Entity tag for cache validation
+ *
+ * @throws {McpAdrError} When rule catalog generation fails due to:
+ *   - RESOURCE_GENERATION_ERROR: ADR parsing errors or rule extraction failures
+ *   - Cache operation failures
+ *
+ * @example
+ * ```typescript
+ * const ruleCatalog = await generateRuleCatalogResource();
+ *
+ * console.log(`Total rules: ${ruleCatalog.data.summary.total}`);
+ * console.log(`Enabled: ${ruleCatalog.data.summary.enabled}`);
+ * console.log(`Disabled: ${ruleCatalog.data.summary.disabled}`);
+ *
+ * // Get critical security rules
+ * const criticalSecurityRules = ruleCatalog.data.rules.filter(
+ *   r => r.type === 'security' && r.severity === 'critical' && r.enabled
+ * );
+ * console.log(`Critical security rules: ${criticalSecurityRules.length}`);
+ *
+ * // Group rules by source
+ * console.log(`ADR rules: ${ruleCatalog.data.summary.bySource.adr}`);
+ * console.log(`Inferred rules: ${ruleCatalog.data.summary.bySource.inferred}`);
+ * console.log(`Custom rules: ${ruleCatalog.data.summary.bySource.user_defined}`);
+ *
+ * // Expected output structure:
+ * {
+ *   data: {
+ *     version: "1.0.0",
+ *     timestamp: "2025-10-12T17:00:00.000Z",
+ *     summary: {
+ *       total: 45,
+ *       byType: {
+ *         architecture: 12,
+ *         security: 10,
+ *         performance: 8,
+ *         testing: 10,
+ *         documentation: 5
+ *       },
+ *       bySeverity: {
+ *         critical: 5,
+ *         high: 15,
+ *         medium: 20,
+ *         low: 5
+ *       },
+ *       bySource: {
+ *         adr: 20,
+ *         inferred: 15,
+ *         user_defined: 10
+ *       },
+ *       enabled: 40,
+ *       disabled: 5
+ *     },
+ *     rules: [
+ *       {
+ *         id: "rule-001",
+ *         name: "Use PostgreSQL for primary database",
+ *         type: "architecture",
+ *         severity: "critical",
+ *         source: "adr",
+ *         enabled: true,
+ *         adrReference: "ADR-001"
+ *       }
+ *     ]
+ *   },
+ *   contentType: "application/json",
+ *   cacheKey: "rule-catalog:current",
+ *   ttl: 300
+ * }
+ * ```
+ *
+ * @since v2.0.0
+ * @see {@link extractRulesFromAdrs} for ADR rule extraction
+ * @see {@link extractInferredRules} for pattern-based rule inference
+ * @see {@link loadCustomRules} for user-defined rule loading
+ */
+export async function generateRuleCatalogResource() {
+    try {
+        const cacheKey = 'rule-catalog:current';
+        // Check cache
+        const cached = await resourceCache.get(cacheKey);
+        if (cached) {
+            return cached;
+        }
+        // Extract rules from various sources
+        const adrRules = await extractRulesFromAdrs();
+        const inferredRules = await extractInferredRules();
+        const customRules = await loadCustomRules();
+        const allRules = [...adrRules, ...inferredRules, ...customRules];
+        const ruleCatalogData = {
+            version: '1.0.0',
+            timestamp: new Date().toISOString(),
+            summary: {
+                total: allRules.length,
+                byType: groupByType(allRules),
+                bySeverity: groupBySeverity(allRules),
+                bySource: {
+                    adr: adrRules.length,
+                    inferred: inferredRules.length,
+                    user_defined: customRules.length,
+                },
+                enabled: allRules.filter(r => r.enabled).length,
+                disabled: allRules.filter(r => !r.enabled).length,
+            },
+            rules: allRules,
+        };
+        const result = {
+            data: ruleCatalogData,
+            contentType: 'application/json',
+            lastModified: new Date().toISOString(),
+            cacheKey,
+            ttl: 600, // 10 minutes cache
+            etag: generateETag(ruleCatalogData),
+        };
+        // Cache result
+        resourceCache.set(cacheKey, result, result.ttl);
+        return result;
+    }
+    catch (error) {
+        throw new McpAdrError(`Failed to generate rule catalog resource: ${error instanceof Error ? error.message : String(error)}`, 'RESOURCE_GENERATION_ERROR');
+    }
+}
+//# sourceMappingURL=rule-catalog-resource.js.map

package/dist/src/resources/rule-catalog-resource.js.map

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