cmp-standards 2.7.0 → 2.8.0

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,QAAQ;AACR,cAAc,kBAAkB,CAAA;AAEhC,QAAQ;AACR,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAA;AAEnE,WAAW;AACX,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAE3D,mBAAmB;AACnB,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAA;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAA;AAEpE,QAAQ;AACR,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC1D,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AACrE,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAA;AAE1F,2BAA2B;AAC3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AACnD,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AAEjF,6BAA6B;AAC7B,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AACjG,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAA;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAA;AAEhD,gBAAgB;AAChB,OAAO,EACL,cAAc,EACd,UAAU,EACV,YAAY,EACZ,UAAU,EACV,WAAW,EACX,eAAe,EACf,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,aAAa,EACd,MAAM,gBAAgB,CAAA;AAEvB,cAAc;AACd,OAAO,EAAE,cAAc,IAAI,iBAAiB,EAAE,MAAM,gCAAgC,CAAA;AACpF,OAAO,EAAE,YAAY,IAAI,eAAe,EAAE,MAAM,+BAA+B,CAAA;AAC/E,OAAO,EAAE,aAAa,IAAI,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AAElF,0BAA0B;AAC1B,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,uBAAuB,EACvB,uBAAuB,EACvB,aAAa,EACb,oBAAoB,EACpB,UAAU,IAAI,eAAe,EAC7B,iBAAiB,IAAI,sBAAsB,EAC3C,sBAAsB,EACvB,MAAM,sBAAsB,CAAA;AAe7B,wCAAwC;AACxC,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,0BAA0B,EAC3B,MAAM,mBAAmB,CAAA;AAU1B,uBAAuB;AACvB,OAAO,EACL,WAAW,EACX,cAAc,EACd,iBAAiB,EAClB,MAAM,2BAA2B,CAAA;AAQlC,aAAa;AACb,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAEjE,YAAY;AACZ,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAEtD,WAAW;AACX,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAA;AAEpF,YAAY;AACZ,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

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"}