cmp-standards 2.8.0-alpha → 2.8.1

package/dist/interfaces/index.d.ts

@@ -0,0 +1,450 @@
+/**
+ * @file Core Interfaces
+ * @description Abstract interfaces for dependency injection and testing
+ *
+ * These interfaces define contracts for core services, enabling:
+ * - Dependency injection for loose coupling
+ * - Easy mocking in unit tests
+ * - Clear documentation of service capabilities
+ *
+ * @version 2.8.0
+ */
+/**
+ * Event metadata attached to all events
+ */
+export interface IEventMetadata {
+    timestamp: string;
+    source: string;
+    correlationId?: string;
+}
+/**
+ * Base event structure
+ */
+export interface IEvent {
+    type: string;
+    data: unknown;
+    metadata: IEventMetadata;
+}
+/**
+ * Event handler function signature
+ */
+export type IEventHandler<T extends IEvent = IEvent> = (event: T) => void | Promise<void>;
+/**
+ * EventBus interface for pub/sub messaging
+ */
+export interface IEventBus {
+    /**
+     * Subscribe to an event type
+     * @returns Unsubscribe function
+     */
+    subscribe<T extends IEvent>(eventType: string, handler: IEventHandler<T>): () => void;
+    /**
+     * Publish an event to all subscribers
+     */
+    publish<T extends IEvent>(event: T): Promise<{
+        success: boolean;
+        handlerResults: PromiseSettledResult<void>[];
+        duration: number;
+    }>;
+    /**
+     * Publish and throw on any handler failure
+     */
+    publishStrict<T extends IEvent>(event: T): Promise<void>;
+    /**
+     * Get event history
+     */
+    getHistory(type?: string): IEvent[];
+    /**
+     * Get events by correlation ID
+     */
+    getByCorrelationId(correlationId: string): IEvent[];
+    /**
+     * Clear all handlers and history
+     */
+    clear(): void;
+    /**
+     * Get handler count for event type
+     */
+    getHandlerCount(type: string): number;
+    /**
+     * Check if event type has handlers
+     */
+    hasHandlers(type: string): boolean;
+    /**
+     * Clean up resources
+     */
+    destroy(): void;
+}
+/**
+ * Cache entry with metadata
+ */
+export interface ICacheEntry<T> {
+    value: T;
+    expires: number;
+    hits: number;
+    createdAt: number;
+    lastAccessedAt: number;
+}
+/**
+ * Cache statistics
+ */
+export interface ICacheStats {
+    size: number;
+    hits: number;
+    misses: number;
+    hitRate: number;
+    memoryEstimate: number;
+    avgAge: number;
+}
+/**
+ * Generic cache interface
+ */
+export interface ICache<T> {
+    /**
+     * Get value from cache
+     */
+    get(key: string): T | null;
+    /**
+     * Store value in cache
+     */
+    set(key: string, value: T): void;
+    /**
+     * Check if key exists
+     */
+    has(key: string): boolean;
+    /**
+     * Remove expired entries
+     */
+    cleanup(): number;
+    /**
+     * Get cache statistics
+     */
+    getStats(): ICacheStats;
+    /**
+     * Clear all entries
+     */
+    clear(): void;
+    /**
+     * Get current size
+     */
+    readonly size: number;
+}
+/**
+ * Embedding cache interface with vector-specific operations
+ */
+export interface IEmbeddingCache extends ICache<number[]> {
+    /**
+     * Get all cached keys
+     */
+    keys(): string[];
+}
+/**
+ * Pattern severity levels
+ */
+export type IPatternSeverity = 'critical' | 'high' | 'medium' | 'low';
+/**
+ * Pattern lifecycle status
+ */
+export type IPatternStatus = 'active' | 'triggered' | 'implemented' | 'retired';
+/**
+ * Pattern definition
+ */
+export interface IPattern {
+    id: string;
+    name: string;
+    description: string;
+    severity: IPatternSeverity;
+    status: IPatternStatus;
+    threshold: number;
+    regex?: string;
+    eslintRuleName?: string;
+}
+/**
+ * Pattern occurrence record
+ */
+export interface IPatternOccurrence {
+    patternId: string;
+    file: string;
+    line?: number;
+    code?: string;
+    severity?: IPatternSeverity;
+}
+/**
+ * Pattern registry interface
+ */
+export interface IPatternRegistry {
+    /**
+     * Get pattern by ID
+     */
+    get(patternId: string): IPattern | undefined;
+    /**
+     * Get all active patterns
+     */
+    getActive(): IPattern[];
+    /**
+     * Get all patterns
+     */
+    getAll(): IPattern[];
+    /**
+     * Register a new pattern
+     */
+    register(pattern: IPattern): void;
+    /**
+     * Update pattern status
+     */
+    updateStatus(patternId: string, status: IPatternStatus, reason?: string): void;
+    /**
+     * Record feedback for pattern
+     */
+    recordFeedback(patternId: string, type: 'confirmed' | 'false_positive'): void;
+    /**
+     * Detect patterns in content
+     */
+    detect(content: string, filePath: string): Array<{
+        pattern: IPattern;
+        matches: RegExpMatchArray[];
+    }>;
+    /**
+     * Generate ESLint rule for pattern
+     */
+    generateEslintRule(patternId: string): string | null;
+}
+/**
+ * Pattern lifecycle service interface
+ */
+export interface IPatternLifecycle {
+    /**
+     * Track a pattern occurrence
+     */
+    track(occurrence: IPatternOccurrence): Promise<{
+        count: number;
+        triggered: boolean;
+        rule?: string;
+    }>;
+    /**
+     * Confirm a pattern detection
+     */
+    confirmPattern(patternId: string): Promise<void>;
+    /**
+     * Mark pattern as false positive
+     */
+    markFalsePositive(patternId: string): Promise<void>;
+    /**
+     * Promote pattern to implemented
+     */
+    promotePattern(patternId: string): Promise<void>;
+    /**
+     * Retire a pattern
+     */
+    retirePattern(patternId: string, reason: string): Promise<void>;
+    /**
+     * Detect regression
+     */
+    detectRegression(patternId: string): Promise<{
+        patternId: string;
+        message: string;
+        severity: IPatternSeverity;
+    } | null>;
+    /**
+     * Adjust pattern sensitivity
+     */
+    adjustSensitivity(patternId: string, feedback: 'too_sensitive' | 'not_sensitive_enough'): Promise<void>;
+}
+/**
+ * Query options for database operations
+ */
+export interface IQueryOptions {
+    system?: string;
+    type?: string;
+    status?: string;
+    limit?: number;
+    orderBy?: string;
+    orderDir?: 'ASC' | 'DESC';
+}
+/**
+ * Database client interface
+ */
+export interface IDatabaseClient {
+    /**
+     * Create a new item
+     */
+    create<T extends object>(type: string, system: string, content: T, status?: string): Promise<string>;
+    /**
+     * Get item by ID
+     */
+    get<T>(id: string): Promise<{
+        id: string;
+        type: string;
+        status: string;
+        system: string;
+        content: T;
+    } | null>;
+    /**
+     * Update an item
+     */
+    update<T extends object>(id: string, updates: Partial<{
+        status: string;
+        content: T;
+    }>): Promise<void>;
+    /**
+     * Query items
+     */
+    query<T>(options: IQueryOptions): Promise<Array<{
+        id: string;
+        type: string;
+        status: string;
+        system: string;
+        content: T;
+    }>>;
+    /**
+     * Delete an item
+     */
+    remove(id: string): Promise<void>;
+}
+/**
+ * Transaction statement
+ */
+export interface ITransactionStatement {
+    sql: string;
+    args: unknown[];
+}
+/**
+ * Transactional database client interface
+ */
+export interface ITransactionalDatabase extends IDatabaseClient {
+    /**
+     * Execute statements in atomic transaction
+     */
+    transaction(statements: ITransactionStatement[]): Promise<void>;
+}
+/**
+ * Expert vote types
+ */
+export type IExpertVote = 'APPROVE' | 'REJECT' | 'WARN' | 'ABSTAIN';
+/**
+ * Expert finding
+ */
+export interface IExpertFinding {
+    patternId: string;
+    filePath: string;
+    line?: number;
+    code?: string;
+    severity: IPatternSeverity;
+    description: string;
+    expertType: string;
+}
+/**
+ * Expert review result
+ */
+export interface IExpertReviewResult {
+    expertType: string;
+    vote: IExpertVote;
+    findings: IExpertFinding[];
+    reasoning?: string;
+    timestamp: string;
+}
+/**
+ * Expert panel consensus
+ */
+export interface IPanelConsensus {
+    approved: boolean;
+    votes: Record<string, IExpertVote>;
+    allFindings: IExpertFinding[];
+    correlationId: string;
+    filesReviewed: string[];
+    isCritical: boolean;
+}
+/**
+ * Expert router interface
+ */
+export interface IExpertRouter {
+    /**
+     * Route files to appropriate experts
+     */
+    route(files: string[]): Promise<string[]>;
+    /**
+     * Get expert by type
+     */
+    getExpert(type: string): IExpert | undefined;
+    /**
+     * Check if code is critical
+     */
+    isCriticalCode(files: string[]): boolean;
+}
+/**
+ * Individual expert interface
+ */
+export interface IExpert {
+    /**
+     * Expert type identifier
+     */
+    readonly type: string;
+    /**
+     * Expert display name
+     */
+    readonly name: string;
+    /**
+     * Review files and return findings
+     */
+    review(files: string[], context?: unknown): Promise<IExpertReviewResult>;
+}
+/**
+ * Consensus engine interface
+ */
+export interface IConsensusEngine {
+    /**
+     * Calculate consensus from expert votes
+     */
+    calculateConsensus(results: IExpertReviewResult[], isCritical: boolean): IPanelConsensus;
+}
+/**
+ * Vote collector interface
+ */
+export interface IVoteCollector {
+    /**
+     * Collect vote from expert
+     */
+    collect(result: IExpertReviewResult): void;
+    /**
+     * Get all collected votes
+     */
+    getVotes(): IExpertReviewResult[];
+    /**
+     * Check if all expected votes collected
+     */
+    isComplete(expectedCount: number): boolean;
+    /**
+     * Clear collected votes
+     */
+    clear(): void;
+}
+/**
+ * Service locator for dependency injection
+ */
+export interface IServiceLocator {
+    /**
+     * Register a service
+     */
+    register<T>(name: string, service: T): void;
+    /**
+     * Get a service
+     */
+    get<T>(name: string): T | undefined;
+    /**
+     * Check if service exists
+     */
+    has(name: string): boolean;
+    /**
+     * Clear all services
+     */
+    clear(): void;
+}
+/**
+ * Get global service locator
+ */
+export declare function getServiceLocator(): IServiceLocator;
+/**
+ * Reset service locator (for testing)
+ */
+export declare function resetServiceLocator(): void;
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/interfaces/index.js

@@ -0,0 +1,50 @@
+/**
+ * @file Core Interfaces
+ * @description Abstract interfaces for dependency injection and testing
+ *
+ * These interfaces define contracts for core services, enabling:
+ * - Dependency injection for loose coupling
+ * - Easy mocking in unit tests
+ * - Clear documentation of service capabilities
+ *
+ * @version 2.8.0
+ */
+// =============================================================================
+// Simple Service Locator Implementation
+// =============================================================================
+class ServiceLocator {
+    services = new Map();
+    register(name, service) {
+        this.services.set(name, service);
+    }
+    get(name) {
+        return this.services.get(name);
+    }
+    has(name) {
+        return this.services.has(name);
+    }
+    clear() {
+        this.services.clear();
+    }
+}
+// Global service locator instance
+let globalServiceLocator = null;
+/**
+ * Get global service locator
+ */
+export function getServiceLocator() {
+    if (!globalServiceLocator) {
+        globalServiceLocator = new ServiceLocator();
+    }
+    return globalServiceLocator;
+}
+/**
+ * Reset service locator (for testing)
+ */
+export function resetServiceLocator() {
+    if (globalServiceLocator) {
+        globalServiceLocator.clear();
+    }
+    globalServiceLocator = null;
+}
+//# sourceMappingURL=index.js.map

package/dist/interfaces/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/interfaces/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AA4hBH,gFAAgF;AAChF,wCAAwC;AACxC,gFAAgF;AAEhF,MAAM,cAAc;IACV,QAAQ,GAAG,IAAI,GAAG,EAAmB,CAAA;IAE7C,QAAQ,CAAI,IAAY,EAAE,OAAU;QAClC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;IAClC,CAAC;IAED,GAAG,CAAI,IAAY;QACjB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAkB,CAAA;IACjD,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAChC,CAAC;IAED,KAAK;QACH,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAA;IACvB,CAAC;CACF;AAED,kCAAkC;AAClC,IAAI,oBAAoB,GAA2B,IAAI,CAAA;AAEvD;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAC1B,oBAAoB,GAAG,IAAI,cAAc,EAAE,CAAA;IAC7C,CAAC;IACD,OAAO,oBAAoB,CAAA;AAC7B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB;IACjC,IAAI,oBAAoB,EAAE,CAAC;QACzB,oBAAoB,CAAC,KAAK,EAAE,CAAA;IAC9B,CAAC;IACD,oBAAoB,GAAG,IAAI,CAAA;AAC7B,CAAC"}