cmp-standards 2.8.1 → 3.1.0

package/dist/plugins/PluginManager.js

@@ -0,0 +1,417 @@
+/**
+ * Plugin Manager
+ *
+ * Extensible plugin system for CMP Standards:
+ * - Register custom plugins
+ * - Lifecycle hooks (init, dispose)
+ * - Plugin dependencies
+ * - Configuration per plugin
+ * - Event-based communication
+ *
+ * @version 2.9.0
+ */
+class PluginEventEmitter {
+    handlers = new Map();
+    on(event, handler) {
+        if (!this.handlers.has(event)) {
+            this.handlers.set(event, new Set());
+        }
+        this.handlers.get(event).add(handler);
+    }
+    off(event, handler) {
+        this.handlers.get(event)?.delete(handler);
+    }
+    emit(event, data) {
+        const handlers = this.handlers.get(event);
+        if (handlers) {
+            for (const handler of handlers) {
+                try {
+                    handler(data);
+                }
+                catch (e) {
+                    console.error(`[PluginEventEmitter] Handler error for ${event}:`, e);
+                }
+            }
+        }
+    }
+}
+// =============================================================================
+// Plugin Manager
+// =============================================================================
+export class PluginManager {
+    plugins = new Map();
+    loadedPlugins = new Set();
+    pluginConfigs = new Map();
+    pluginErrors = new Map();
+    system;
+    events = new PluginEventEmitter();
+    constructor(options) {
+        this.system = options.system;
+    }
+    /**
+     * Subscribe to plugin events
+     */
+    on(event, handler) {
+        this.events.on(event, handler);
+    }
+    /**
+     * Unsubscribe from plugin events
+     */
+    off(event, handler) {
+        this.events.off(event, handler);
+    }
+    /**
+     * Register a plugin
+     */
+    register(plugin, config) {
+        const { name } = plugin.metadata;
+        if (this.plugins.has(name)) {
+            throw new Error(`Plugin "${name}" is already registered`);
+        }
+        this.plugins.set(name, plugin);
+        this.pluginConfigs.set(name, config ?? { enabled: true });
+        this.events.emit('plugin:registered', {
+            name,
+            version: plugin.metadata.version,
+        });
+    }
+    /**
+     * Register a plugin from a factory function
+     */
+    registerFactory(factory, config) {
+        const plugin = factory(config);
+        this.register(plugin, { enabled: true, config });
+    }
+    /**
+     * Unregister a plugin
+     */
+    async unregister(name) {
+        const plugin = this.plugins.get(name);
+        if (!plugin)
+            return false;
+        // Dispose if loaded
+        if (this.loadedPlugins.has(name)) {
+            await this.unload(name);
+        }
+        this.plugins.delete(name);
+        this.pluginConfigs.delete(name);
+        this.pluginErrors.delete(name);
+        this.events.emit('plugin:unregistered', { name });
+        return true;
+    }
+    /**
+     * Load and initialize a plugin
+     */
+    async load(name) {
+        const plugin = this.plugins.get(name);
+        const config = this.pluginConfigs.get(name);
+        if (!plugin) {
+            this.pluginErrors.set(name, 'Plugin not registered');
+            return false;
+        }
+        if (!config?.enabled) {
+            this.pluginErrors.set(name, 'Plugin is disabled');
+            return false;
+        }
+        if (this.loadedPlugins.has(name)) {
+            return true; // Already loaded
+        }
+        // Check dependencies
+        const depCheck = await this.checkDependencies(plugin);
+        if (!depCheck.satisfied) {
+            this.pluginErrors.set(name, `Missing dependencies: ${depCheck.missing.join(', ')}`);
+            return false;
+        }
+        // Load dependencies first
+        for (const dep of plugin.metadata.dependencies ?? []) {
+            if (!this.loadedPlugins.has(dep)) {
+                const depLoaded = await this.load(dep);
+                if (!depLoaded) {
+                    this.pluginErrors.set(name, `Failed to load dependency: ${dep}`);
+                    return false;
+                }
+            }
+        }
+        // Initialize plugin
+        try {
+            const context = this.createContext(name, config.config);
+            await plugin.init(context);
+            this.loadedPlugins.add(name);
+            this.pluginErrors.delete(name);
+            this.events.emit('plugin:loaded', {
+                name,
+                version: plugin.metadata.version,
+            });
+            return true;
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.pluginErrors.set(name, errorMessage);
+            this.events.emit('plugin:error', {
+                name,
+                error: errorMessage,
+            });
+            return false;
+        }
+    }
+    /**
+     * Unload a plugin
+     */
+    async unload(name) {
+        const plugin = this.plugins.get(name);
+        if (!plugin || !this.loadedPlugins.has(name)) {
+            return false;
+        }
+        // Check if other plugins depend on this one
+        const dependents = this.getDependents(name);
+        if (dependents.length > 0) {
+            // Unload dependents first
+            for (const dep of dependents) {
+                await this.unload(dep);
+            }
+        }
+        try {
+            if (plugin.dispose) {
+                await plugin.dispose();
+            }
+            this.loadedPlugins.delete(name);
+            this.events.emit('plugin:unloaded', { name });
+            return true;
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.pluginErrors.set(name, errorMessage);
+            return false;
+        }
+    }
+    /**
+     * Load all enabled plugins
+     */
+    async loadAll() {
+        const loaded = [];
+        const failed = [];
+        // Sort by dependencies (topological sort)
+        const sorted = this.topologicalSort();
+        for (const name of sorted) {
+            const config = this.pluginConfigs.get(name);
+            if (config?.enabled) {
+                const success = await this.load(name);
+                if (success) {
+                    loaded.push(name);
+                }
+                else {
+                    failed.push(name);
+                }
+            }
+        }
+        return { loaded, failed };
+    }
+    /**
+     * Unload all plugins
+     */
+    async unloadAll() {
+        // Unload in reverse dependency order
+        const sorted = this.topologicalSort().reverse();
+        for (const name of sorted) {
+            if (this.loadedPlugins.has(name)) {
+                await this.unload(name);
+            }
+        }
+    }
+    /**
+     * Get a loaded plugin by name
+     */
+    getPlugin(name) {
+        if (!this.loadedPlugins.has(name))
+            return undefined;
+        return this.plugins.get(name);
+    }
+    /**
+     * Check if a plugin is registered
+     */
+    isRegistered(name) {
+        return this.plugins.has(name);
+    }
+    /**
+     * Check if a plugin is loaded
+     */
+    isLoaded(name) {
+        return this.loadedPlugins.has(name);
+    }
+    /**
+     * Get plugin status
+     */
+    getStatus(name) {
+        const plugin = this.plugins.get(name);
+        const config = this.pluginConfigs.get(name);
+        if (!plugin)
+            return null;
+        return {
+            name: plugin.metadata.name,
+            version: plugin.metadata.version,
+            enabled: config?.enabled ?? false,
+            loaded: this.loadedPlugins.has(name),
+            error: this.pluginErrors.get(name),
+            dependencies: plugin.metadata.dependencies ?? [],
+        };
+    }
+    /**
+     * Get all plugin statuses
+     */
+    getAllStatuses() {
+        const statuses = [];
+        for (const name of this.plugins.keys()) {
+            const status = this.getStatus(name);
+            if (status)
+                statuses.push(status);
+        }
+        return statuses;
+    }
+    /**
+     * Enable a plugin
+     */
+    enable(name) {
+        const config = this.pluginConfigs.get(name);
+        if (!config)
+            return false;
+        config.enabled = true;
+        return true;
+    }
+    /**
+     * Disable a plugin
+     */
+    async disable(name) {
+        const config = this.pluginConfigs.get(name);
+        if (!config)
+            return false;
+        if (this.loadedPlugins.has(name)) {
+            await this.unload(name);
+        }
+        config.enabled = false;
+        return true;
+    }
+    /**
+     * Update plugin config
+     */
+    updateConfig(name, newConfig) {
+        const config = this.pluginConfigs.get(name);
+        if (!config)
+            return false;
+        config.config = { ...config.config, ...newConfig };
+        return true;
+    }
+    // ==========================================================================
+    // Private Methods
+    // ==========================================================================
+    createContext(name, config) {
+        return {
+            system: this.system,
+            events: this.events,
+            config: config ?? {},
+            getPlugin: (pluginName) => this.getPlugin(pluginName),
+            log: (message, level = 'info') => {
+                const prefix = `[Plugin:${name}]`;
+                switch (level) {
+                    case 'error':
+                        console.error(prefix, message);
+                        break;
+                    case 'warn':
+                        console.warn(prefix, message);
+                        break;
+                    default:
+                        console.log(prefix, message);
+                }
+            },
+        };
+    }
+    async checkDependencies(plugin) {
+        const missing = [];
+        const deps = plugin.metadata.dependencies ?? [];
+        for (const dep of deps) {
+            if (!this.plugins.has(dep)) {
+                missing.push(dep);
+            }
+        }
+        return {
+            satisfied: missing.length === 0,
+            missing,
+        };
+    }
+    getDependents(name) {
+        const dependents = [];
+        for (const [pluginName, plugin] of this.plugins.entries()) {
+            if (plugin.metadata.dependencies?.includes(name)) {
+                dependents.push(pluginName);
+            }
+        }
+        return dependents;
+    }
+    topologicalSort() {
+        const sorted = [];
+        const visited = new Set();
+        const visiting = new Set();
+        const visit = (name) => {
+            if (visited.has(name))
+                return;
+            if (visiting.has(name)) {
+                throw new Error(`Circular dependency detected: ${name}`);
+            }
+            visiting.add(name);
+            const plugin = this.plugins.get(name);
+            if (plugin) {
+                for (const dep of plugin.metadata.dependencies ?? []) {
+                    if (this.plugins.has(dep)) {
+                        visit(dep);
+                    }
+                }
+            }
+            visiting.delete(name);
+            visited.add(name);
+            sorted.push(name);
+        };
+        for (const name of this.plugins.keys()) {
+            visit(name);
+        }
+        return sorted;
+    }
+}
+// =============================================================================
+// Singleton Instance
+// =============================================================================
+let instance = null;
+export function getPluginManager(system = 'ECOSYSTEM') {
+    if (!instance) {
+        instance = new PluginManager({ system });
+    }
+    return instance;
+}
+export function resetPluginManager() {
+    if (instance) {
+        instance.unloadAll().catch(() => { });
+        instance = null;
+    }
+}
+// =============================================================================
+// Plugin Creation Helpers
+// =============================================================================
+/**
+ * Create a simple plugin with minimal boilerplate
+ */
+export function createPlugin(metadata, init, dispose) {
+    return {
+        metadata,
+        init,
+        dispose,
+    };
+}
+/**
+ * Create a plugin factory for configurable plugins
+ */
+export function createPluginFactory(metadata, factory, dispose) {
+    return (config) => ({
+        metadata,
+        init: (context) => factory((config ?? {}), context),
+        dispose,
+    });
+}
+//# sourceMappingURL=PluginManager.js.map

package/dist/plugins/PluginManager.js.map

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

package/dist/plugins/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Plugin System Exports
+ *
+ * @version 2.9.0
+ */
+export { PluginManager, getPluginManager, resetPluginManager, createPlugin, createPluginFactory, type Plugin, type PluginContext, type PluginMetadata, type PluginFactory, type PluginConfig, type PluginStatus, } from './PluginManager.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;;;;GAIG;AAEH,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,YAAY,EACZ,mBAAmB,EACnB,KAAK,MAAM,EACX,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,YAAY,GAClB,MAAM,oBAAoB,CAAA"}

package/dist/plugins/index.js

@@ -0,0 +1,7 @@
+/**
+ * Plugin System Exports
+ *
+ * @version 2.9.0
+ */
+export { PluginManager, getPluginManager, resetPluginManager, createPlugin, createPluginFactory, } from './PluginManager.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":"AAAA;;;;GAIG;AAEH,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,YAAY,EACZ,mBAAmB,GAOpB,MAAM,oBAAoB,CAAA"}

package/dist/schema/expert-types.d.ts

@@ -288,13 +288,13 @@ export declare const MemoryLinkContentSchema: z.ZodObject<{
     confidence: number;
     sourceId: string;
     targetId: string;
-    relationshipType: "extends" | "relates_to" | "contradicts" | "replaces" | "depends_on" | "derived_from";
+    relationshipType: "derived_from" | "depends_on" | "extends" | "relates_to" | "contradicts" | "replaces";
     description?: string | undefined;
 }, {
     confidence: number;
     sourceId: string;
     targetId: string;
-    relationshipType: "extends" | "relates_to" | "contradicts" | "replaces" | "depends_on" | "derived_from";
+    relationshipType: "derived_from" | "depends_on" | "extends" | "relates_to" | "contradicts" | "replaces";
     description?: string | undefined;
     createdBy?: "user" | "system" | "expert" | undefined;
 }>;

package/dist/services/AuditLog.d.ts

@@ -0,0 +1,205 @@
+/**
+ * Audit Log Service
+ *
+ * Tracks all CRUD operations on memories and items for:
+ * - Compliance and accountability
+ * - Change history tracking
+ * - Debugging and troubleshooting
+ * - Analytics and usage patterns
+ *
+ * @version 2.9.0
+ */
+import type { DevSystem, DevType } from '../types/index.js';
+export type AuditAction = 'create' | 'read' | 'update' | 'delete' | 'search' | 'feedback' | 'export' | 'import' | 'archive' | 'restore';
+export type AuditActor = 'user' | 'claude' | 'system' | 'api' | 'scheduler' | 'migration';
+export interface AuditEntry {
+    id: string;
+    timestamp: string;
+    system: DevSystem;
+    action: AuditAction;
+    actor: AuditActor;
+    actorId?: string;
+    itemType?: DevType;
+    itemId?: string;
+    itemTitle?: string;
+    details?: Record<string, unknown>;
+    changes?: {
+        before?: Record<string, unknown>;
+        after?: Record<string, unknown>;
+    };
+    metadata?: {
+        sessionId?: string;
+        requestId?: string;
+        duration?: number;
+        ip?: string;
+        userAgent?: string;
+    };
+}
+export interface AuditQueryOptions {
+    system?: DevSystem;
+    action?: AuditAction;
+    actor?: AuditActor;
+    itemType?: DevType;
+    itemId?: string;
+    startDate?: Date;
+    endDate?: Date;
+    limit?: number;
+    offset?: number;
+}
+export interface AuditStats {
+    totalEntries: number;
+    byAction: Record<AuditAction, number>;
+    byActor: Record<AuditActor, number>;
+    byItemType: Record<string, number>;
+    recentActivity: {
+        last24h: number;
+        last7d: number;
+        last30d: number;
+    };
+}
+export declare class AuditLogService {
+    private entries;
+    private maxEntries;
+    private system;
+    private flushCallback?;
+    private flushInterval;
+    private flushTimer?;
+    private pendingFlush;
+    constructor(options: {
+        system: DevSystem;
+        maxEntries?: number;
+        flushCallback?: (entries: AuditEntry[]) => Promise<void>;
+        flushInterval?: number;
+    });
+    /**
+     * Log an audit entry
+     */
+    log(entry: Omit<AuditEntry, 'id' | 'timestamp' | 'system'>): AuditEntry;
+    /**
+     * Log a create action
+     */
+    logCreate(options: {
+        actor: AuditActor;
+        actorId?: string;
+        itemType: DevType;
+        itemId: string;
+        itemTitle?: string;
+        details?: Record<string, unknown>;
+        metadata?: AuditEntry['metadata'];
+    }): AuditEntry;
+    /**
+     * Log a read/access action
+     */
+    logRead(options: {
+        actor: AuditActor;
+        actorId?: string;
+        itemType: DevType;
+        itemId: string;
+        metadata?: AuditEntry['metadata'];
+    }): AuditEntry;
+    /**
+     * Log an update action with before/after changes
+     */
+    logUpdate(options: {
+        actor: AuditActor;
+        actorId?: string;
+        itemType: DevType;
+        itemId: string;
+        itemTitle?: string;
+        before: Record<string, unknown>;
+        after: Record<string, unknown>;
+        metadata?: AuditEntry['metadata'];
+    }): AuditEntry;
+    /**
+     * Log a delete action
+     */
+    logDelete(options: {
+        actor: AuditActor;
+        actorId?: string;
+        itemType: DevType;
+        itemId: string;
+        itemTitle?: string;
+        details?: Record<string, unknown>;
+        metadata?: AuditEntry['metadata'];
+    }): AuditEntry;
+    /**
+     * Log a search action
+     */
+    logSearch(options: {
+        actor: AuditActor;
+        actorId?: string;
+        details: {
+            query: string;
+            resultCount: number;
+            filters?: Record<string, unknown>;
+        };
+        metadata?: AuditEntry['metadata'];
+    }): AuditEntry;
+    /**
+     * Log feedback action
+     */
+    logFeedback(options: {
+        actor: AuditActor;
+        actorId?: string;
+        itemId: string;
+        details: {
+            helpful: boolean;
+            comment?: string;
+        };
+        metadata?: AuditEntry['metadata'];
+    }): AuditEntry;
+    /**
+     * Query audit log entries
+     */
+    query(options?: AuditQueryOptions): AuditEntry[];
+    /**
+     * Get history for a specific item
+     */
+    getItemHistory(itemId: string): AuditEntry[];
+    /**
+     * Get statistics
+     */
+    getStats(): AuditStats;
+    /**
+     * Export entries to JSON
+     */
+    export(options?: AuditQueryOptions): string;
+    /**
+     * Import entries from JSON
+     */
+    import(json: string): number;
+    /**
+     * Clear all entries
+     */
+    clear(): void;
+    /**
+     * Get total entry count
+     */
+    count(): number;
+    /**
+     * Flush pending entries to persistent storage
+     */
+    flush(): Promise<number>;
+    /**
+     * Stop the service and flush remaining entries
+     */
+    stop(): Promise<void>;
+    private startFlushTimer;
+    private validateEntry;
+}
+export declare function getAuditLog(system?: DevSystem): AuditLogService;
+export declare function resetAuditLog(): void;
+/**
+ * Create a new audit log service with custom options
+ */
+export declare function createAuditLog(options: {
+    system: DevSystem;
+    maxEntries?: number;
+    flushCallback?: (entries: AuditEntry[]) => Promise<void>;
+    flushInterval?: number;
+}): AuditLogService;
+/**
+ * Decorator function to automatically log method calls
+ */
+export declare function audited(action: AuditAction, actor?: AuditActor): <T extends (...args: unknown[]) => unknown>(_target: unknown, propertyKey: string, descriptor: TypedPropertyDescriptor<T>) => TypedPropertyDescriptor<T>;
+//# sourceMappingURL=AuditLog.d.ts.map