@rbalchii/anchor-engine 4.7.0

package/engine/dist/utils/native-module-profiler.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Native Module Profiler for Anchor Engine
+ *
+ * Provides performance profiling for native modules
+ */
+export interface ProfilingConfig {
+    operation: string;
+    iterations: number;
+    testData: any[];
+    parameters?: Record<string, any>;
+}
+export interface ProfileResult {
+    operation: string;
+    duration: number;
+    memoryBefore: number;
+    memoryAfter: number;
+    memoryDelta: number;
+    iterations: number;
+    avgDuration: number;
+    minDuration: number;
+    maxDuration: number;
+    lastDuration: number;
+    timestamp: number;
+}
+export declare class NativeModuleProfiler {
+    private profileResults;
+    private isProfiling;
+    /**
+     * Profile a native module operation
+     */
+    profileOperation(config: ProfilingConfig): Promise<ProfileResult>;
+    /**
+     * Execute a specific native module operation
+     */
+    private executeOperation;
+    /**
+     * Get current memory usage in MB
+     */
+    private getMemoryUsage;
+    /**
+     * Profile multiple operations
+     */
+    profileMultiple(configs: ProfilingConfig[]): Promise<ProfileResult[]>;
+    /**
+     * Get all profile results
+     */
+    getProfileResults(): ProfileResult[];
+    /**
+     * Clear profile results
+     */
+    clearResults(): void;
+    /**
+     * Generate profiling report
+     */
+    generateReport(): string;
+    /**
+     * Get slowest operations
+     */
+    getSlowestOperations(limit?: number): ProfileResult[];
+    /**
+     * Get highest memory impact operations
+     */
+    getHighestMemoryImpact(limit?: number): ProfileResult[];
+}
+export declare const nativeModuleProfiler: NativeModuleProfiler;
+//# sourceMappingURL=native-module-profiler.d.ts.map

package/engine/dist/utils/native-module-profiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-module-profiler.d.ts","sourceRoot":"","sources":["../../src/utils/native-module-profiler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,GAAG,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,WAAW,CAAkB;IAErC;;OAEG;IACG,gBAAgB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,aAAa,CAAC;IAwEvE;;OAEG;YACW,gBAAgB;IA8B9B;;OAEG;IACH,OAAO,CAAC,cAAc;IAMtB;;OAEG;IACG,eAAe,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAgB3E;;OAEG;IACH,iBAAiB,IAAI,aAAa,EAAE;IAIpC;;OAEG;IACH,YAAY,IAAI,IAAI;IAIpB;;OAEG;IACH,cAAc,IAAI,MAAM;IAuBxB;;OAEG;IACH,oBAAoB,CAAC,KAAK,GAAE,MAAU,GAAG,aAAa,EAAE;IAMxD;;OAEG;IACH,sBAAsB,CAAC,KAAK,GAAE,MAAU,GAAG,aAAa,EAAE;CAK3D;AAGD,eAAO,MAAM,oBAAoB,sBAA6B,CAAC"}

package/engine/dist/utils/native-module-profiler.js

@@ -0,0 +1,182 @@
+/**
+ * Native Module Profiler for Anchor Engine
+ *
+ * Provides performance profiling for native modules
+ */
+import { logWithContext } from './structured-logger.js';
+export class NativeModuleProfiler {
+    profileResults = [];
+    isProfiling = false;
+    /**
+     * Profile a native module operation
+     */
+    async profileOperation(config) {
+        if (this.isProfiling) {
+            throw new Error('Profiler is already running. Wait for current profiling to complete.');
+        }
+        this.isProfiling = true;
+        logWithContext.info(`Starting profiling for operation: ${config.operation}`, {
+            operation: config.operation,
+            iterations: config.iterations,
+            testDataSize: config.testData.length
+        });
+        const durations = [];
+        let memoryBefore = 0;
+        let memoryAfter = 0;
+        try {
+            // Capture memory before profiling
+            memoryBefore = this.getMemoryUsage();
+            // Run the operation multiple times
+            for (let i = 0; i < config.iterations; i++) {
+                const start = process.hrtime.bigint();
+                // Execute the operation with test data
+                await this.executeOperation(config.operation, config.testData[i % config.testData.length], config.parameters);
+                const end = process.hrtime.bigint();
+                const duration = Number(end - start) / 1000000; // Convert nanoseconds to milliseconds
+                durations.push(duration);
+            }
+            // Capture memory after profiling
+            memoryAfter = this.getMemoryUsage();
+            // Calculate statistics
+            const totalDuration = durations.reduce((sum, curr) => sum + curr, 0);
+            const avgDuration = totalDuration / durations.length;
+            const minDuration = Math.min(...durations);
+            const maxDuration = Math.max(...durations);
+            const result = {
+                operation: config.operation,
+                duration: totalDuration,
+                memoryBefore,
+                memoryAfter,
+                memoryDelta: memoryAfter - memoryBefore,
+                iterations: config.iterations,
+                avgDuration,
+                minDuration,
+                maxDuration,
+                lastDuration: durations[durations.length - 1],
+                timestamp: Date.now()
+            };
+            this.profileResults.push(result);
+            logWithContext.info(`Profiling completed for operation: ${config.operation}`, {
+                operation: config.operation,
+                totalDuration: result.duration,
+                avgDuration: result.avgDuration,
+                minDuration: result.minDuration,
+                maxDuration: result.maxDuration,
+                memoryDelta: result.memoryDelta
+            });
+            return result;
+        }
+        finally {
+            this.isProfiling = false;
+        }
+    }
+    /**
+     * Execute a specific native module operation
+     */
+    async executeOperation(operation, testData, parameters) {
+        // This would call the actual native module operation
+        // For now, we'll simulate with a timeout to represent processing time
+        // In a real implementation, this would call the native module directly
+        // Simulate different operations with different processing times
+        switch (operation) {
+            case 'atomize':
+                // Simulate atomization processing
+                await new Promise(resolve => setTimeout(resolve, Math.min(10, testData.length / 100)));
+                return { atoms: testData.split(/\s+/).length };
+            case 'fingerprint':
+                // Simulate fingerprinting processing
+                await new Promise(resolve => setTimeout(resolve, Math.min(5, testData.length / 200)));
+                return { fingerprint: testData.length.toString(16) };
+            case 'sanitize':
+                // Simulate sanitization processing
+                await new Promise(resolve => setTimeout(resolve, Math.min(8, testData.length / 150)));
+                return { sanitized: testData.replace(/[{}[\]""]/g, '') };
+            case 'distance':
+                // Simulate distance calculation
+                await new Promise(resolve => setTimeout(resolve, 2));
+                return { distance: Math.random() * 100 };
+            default:
+                // For unknown operations, just return after a small delay
+                await new Promise(resolve => setTimeout(resolve, 1));
+                return { result: 'processed' };
+        }
+    }
+    /**
+     * Get current memory usage in MB
+     */
+    getMemoryUsage() {
+        const memoryUsage = process.memoryUsage();
+        // Use heapUsed for the primary measurement
+        return Math.round((memoryUsage.heapUsed / 1024 / 1024) * 100) / 100;
+    }
+    /**
+     * Profile multiple operations
+     */
+    async profileMultiple(configs) {
+        const results = [];
+        for (const config of configs) {
+            try {
+                const result = await this.profileOperation(config);
+                results.push(result);
+            }
+            catch (error) {
+                logWithContext.error(`Error profiling operation ${config.operation}`, error);
+                // Continue with other operations
+            }
+        }
+        return results;
+    }
+    /**
+     * Get all profile results
+     */
+    getProfileResults() {
+        return [...this.profileResults];
+    }
+    /**
+     * Clear profile results
+     */
+    clearResults() {
+        this.profileResults = [];
+    }
+    /**
+     * Generate profiling report
+     */
+    generateReport() {
+        if (this.profileResults.length === 0) {
+            return 'No profiling results available.';
+        }
+        let report = '=== Native Module Profiling Report ===\n\n';
+        report += `Generated: ${new Date().toISOString()}\n`;
+        report += `Total Operations Profiled: ${this.profileResults.length}\n\n`;
+        for (const result of this.profileResults) {
+            report += `Operation: ${result.operation}\n`;
+            report += `  Total Duration: ${result.duration.toFixed(2)} ms\n`;
+            report += `  Avg Duration: ${result.avgDuration.toFixed(2)} ms\n`;
+            report += `  Min Duration: ${result.minDuration.toFixed(2)} ms\n`;
+            report += `  Max Duration: ${result.maxDuration.toFixed(2)} ms\n`;
+            report += `  Memory Delta: ${result.memoryDelta.toFixed(2)} MB\n`;
+            report += `  Iterations: ${result.iterations}\n`;
+            report += `  Timestamp: ${new Date(result.timestamp).toISOString()}\n\n`;
+        }
+        return report;
+    }
+    /**
+     * Get slowest operations
+     */
+    getSlowestOperations(limit = 5) {
+        return [...this.profileResults]
+            .sort((a, b) => b.avgDuration - a.avgDuration)
+            .slice(0, limit);
+    }
+    /**
+     * Get highest memory impact operations
+     */
+    getHighestMemoryImpact(limit = 5) {
+        return [...this.profileResults]
+            .sort((a, b) => Math.abs(b.memoryDelta) - Math.abs(a.memoryDelta))
+            .slice(0, limit);
+    }
+}
+// Export singleton instance
+export const nativeModuleProfiler = new NativeModuleProfiler();
+//# sourceMappingURL=native-module-profiler.js.map

package/engine/dist/utils/native-module-profiler.js.map

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

package/engine/dist/utils/path-manager.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Path Manager - Centralized Path Resolution for Anchor Engine
+ *
+ * Implements Standard 051: Service Module Path Resolution
+ * Ensures consistent path handling across all platforms
+ */
+export declare class PathManager {
+    private static instance;
+    private readonly basePath;
+    private readonly platform;
+    private constructor();
+    static getInstance(): PathManager;
+    /**
+     * Get the base path (public accessor)
+     */
+    getBasePath(): string;
+    /**
+     * Resolve native binary paths based on environment and platform
+     */
+    getNativePath(filename: string): string;
+    /**
+     * Get database path (PGlite directory)
+     */
+    getDatabasePath(): string;
+    /**
+     * Get database directory (for SQLite3 context.db location)
+     */
+    getDatabaseDir(): string;
+    /**
+     * Get notebook directory path
+     */
+    getNotebookDir(): string;
+    /**
+     * Get context directory path (Internal Configuration/Tags)
+     */
+    getContextDir(): string;
+    /**
+     * Get models directory path
+     */
+    getModelsDir(): string;
+    /**
+     * Get logs directory path
+     */
+    getLogsDir(): string;
+    /**
+     * Get specs directory path
+     */
+    getSpecsDir(): string;
+    /**
+     * Get user settings path
+     */
+    getUserSettingsPath(): string;
+    /**
+     * Get sovereign tags path
+     */
+    getSovereignTagsPath(): string;
+}
+export declare const pathManager: PathManager;
+//# sourceMappingURL=path-manager.d.ts.map

package/engine/dist/utils/path-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-manager.d.ts","sourceRoot":"","sources":["../../src/utils/path-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;IAE3C,OAAO;WAoBO,WAAW,IAAI,WAAW;IAQxC;;OAEG;IACI,WAAW,IAAI,MAAM;IAI5B;;OAEG;IACI,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IA0C9C;;OAEG;IACI,eAAe,IAAI,MAAM;IAIhC;;OAEG;IACI,cAAc,IAAI,MAAM;IAI/B;;OAEG;IACI,cAAc,IAAI,MAAM;IAO/B;;OAEG;IACI,aAAa,IAAI,MAAM;IAI9B;;OAEG;IACI,YAAY,IAAI,MAAM;IAI7B;;OAEG;IACI,UAAU,IAAI,MAAM;IAI3B;;OAEG;IACI,WAAW,IAAI,MAAM;IAI5B;;OAEG;IACI,mBAAmB,IAAI,MAAM;IAIpC;;OAEG;IACI,oBAAoB,IAAI,MAAM;CAGtC;AAGD,eAAO,MAAM,WAAW,aAA4B,CAAC"}

package/engine/dist/utils/path-manager.js

@@ -0,0 +1,154 @@
+/**
+ * Path Manager - Centralized Path Resolution for Anchor Engine
+ *
+ * Implements Standard 051: Service Module Path Resolution
+ * Ensures consistent path handling across all platforms
+ */
+import * as path from 'path'; // @ts-ignore - used in path resolution
+import { fileURLToPath } from 'url'; // @ts-ignore - used in path resolution
+import { createRequire } from 'module';
+const __filename = fileURLToPath(import.meta.url); // @ts-ignore - used in path resolution
+// const __dirname = path.dirname(__filename); // Not used, commented out to avoid TS error
+const require = createRequire(import.meta.url); // @ts-ignore - used in path resolution
+export class PathManager {
+    static instance;
+    basePath;
+    platform;
+    constructor() {
+        // Determine base path based on execution context
+        if (typeof process !== 'undefined' && process.resourcesPath) {
+            // Electron environment
+            this.basePath = process.resourcesPath;
+        }
+        else if (typeof process !== 'undefined') {
+            // Node.js environment
+            // In ES modules, __dirname is not available, so we use import.meta.url
+            const __filename = fileURLToPath(import.meta.url);
+            const __dirname = path.dirname(__filename);
+            this.basePath = path.resolve(__dirname, '../..');
+        }
+        else {
+            // Fallback
+            this.basePath = process.cwd();
+        }
+        this.platform = process.platform;
+        console.log(`[PathManager] Initialized. BasePath: ${this.basePath}, Platform: ${this.platform}`);
+    }
+    static getInstance() {
+        if (!PathManager.instance) {
+            PathManager.instance = new PathManager();
+            console.log('[PathManager] Singleton instance created.');
+        }
+        return PathManager.instance;
+    }
+    /**
+     * Get the base path (public accessor)
+     */
+    getBasePath() {
+        return this.basePath;
+    }
+    /**
+     * Resolve native binary paths based on environment and platform
+     */
+    getNativePath(filename) {
+        // Handle platform-specific binary names
+        let platformBinary = filename;
+        if (filename.startsWith('cozo_node_')) {
+            // Already platform-specific
+            platformBinary = filename;
+        }
+        else if (filename === 'cozo_lib.node') {
+            // Map generic name to platform-specific
+            switch (this.platform) {
+                case 'win32':
+                    platformBinary = 'cozo_node_win32.node';
+                    break;
+                case 'darwin':
+                    platformBinary = 'cozo_node_darwin.node';
+                    break;
+                case 'linux':
+                    platformBinary = 'cozo_node_linux.node';
+                    break;
+                default:
+                    throw new Error(`Unsupported platform: ${this.platform}`);
+            }
+        }
+        else if (filename === 'ece_native.node') {
+            // For our custom native module
+            switch (this.platform) {
+                case 'win32':
+                    platformBinary = path.join(this.basePath, 'build', 'Release', 'ece_native.node');
+                    break;
+                case 'darwin':
+                case 'linux':
+                    platformBinary = path.join(this.basePath, 'build', 'Release', 'ece_native.node');
+                    break;
+                default:
+                    throw new Error(`Unsupported platform: ${this.platform}`);
+            }
+        }
+        const resolvedPath = path.resolve(this.basePath, platformBinary);
+        console.log(`[PathManager] Resolving ${filename} -> ${resolvedPath}`);
+        return resolvedPath;
+    }
+    /**
+     * Get database path (PGlite directory)
+     */
+    getDatabasePath() {
+        return path.resolve(this.basePath, 'context_data');
+    }
+    /**
+     * Get database directory (for SQLite3 context.db location)
+     */
+    getDatabaseDir() {
+        return this.getDatabasePath();
+    }
+    /**
+     * Get notebook directory path
+     */
+    getNotebookDir() {
+        // Current: basePath = .../anchor-engine/engine
+        // Desired: .../Anchor Engine/../notebook -> .../Projects/notebook
+        // So we need to go up from anchor-engine (which is engine/..)
+        return path.resolve(this.basePath, '../..', 'notebook');
+    }
+    /**
+     * Get context directory path (Internal Configuration/Tags)
+     */
+    getContextDir() {
+        return path.resolve(this.basePath, '..', 'context');
+    }
+    /**
+     * Get models directory path
+     */
+    getModelsDir() {
+        return path.resolve(this.basePath, '../..', 'models');
+    }
+    /**
+     * Get logs directory path
+     */
+    getLogsDir() {
+        return path.resolve(this.basePath, 'logs');
+    }
+    /**
+     * Get specs directory path
+     */
+    getSpecsDir() {
+        return path.resolve(this.basePath, '..', 'specs');
+    }
+    /**
+     * Get user settings path
+     */
+    getUserSettingsPath() {
+        return path.resolve(this.basePath, 'user_settings.json');
+    }
+    /**
+     * Get sovereign tags path
+     */
+    getSovereignTagsPath() {
+        return path.resolve(this.getContextDir(), 'internal_tags.json');
+    }
+}
+// Export singleton instance
+export const pathManager = PathManager.getInstance();
+//# sourceMappingURL=path-manager.js.map

package/engine/dist/utils/path-manager.js.map

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

package/engine/dist/utils/performance-monitor.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Performance Monitor for Anchor Engine
+ *
+ * Tracks performance metrics and provides monitoring capabilities
+ */
+export interface PerformanceMetric {
+    operation: string;
+    count: number;
+    totalDuration: number;
+    minDuration: number;
+    maxDuration: number;
+    lastDuration: number;
+    averageDuration: number;
+    lastUpdated: number;
+}
+export interface PerformanceStats {
+    [operation: string]: PerformanceMetric;
+}
+declare class PerformanceMonitor {
+    private metrics;
+    private startTime;
+    constructor();
+    /**
+     * Start timing an operation
+     */
+    startOperation(operation: string): () => void;
+    /**
+     * Record a completed operation with its duration
+     */
+    recordOperation(operation: string, duration: number): void;
+    /**
+     * Get all performance metrics
+     */
+    getAllMetrics(): PerformanceStats;
+    /**
+     * Get a specific metric
+     */
+    getMetric(operation: string): PerformanceMetric | undefined;
+    /**
+     * Get the slowest operations
+     */
+    getSlowestOperations(limit?: number): PerformanceMetric[];
+    /**
+     * Get the busiest operations
+     */
+    getBusiestOperations(limit?: number): PerformanceMetric[];
+    /**
+     * Record a metric value
+     */
+    recordMetric(operation: string, duration: number): void;
+    /**
+     * Reset all metrics
+     */
+    reset(): void;
+    /**
+     * Prune old metrics to free memory (called during idle cleanup)
+     * Removes metrics older than TTL and enforces maximum size limit
+     */
+    pruneOldMetrics(): void;
+    /**
+     * Get system performance information
+     */
+    getSystemStats(): {
+        memory: {
+            rss: number;
+            heapTotal: number;
+            heapUsed: number;
+            external: number;
+            arrayBuffers: number;
+        };
+        uptime: number;
+        timestamp: number;
+        processId: number;
+    };
+    /**
+     * Get all performance statistics
+     */
+    getAllStats(): any;
+    /**
+     * Get performance summary
+     */
+    getPerformanceSummary(): {
+        totalOperations: number;
+        totalCalls: number;
+        totalDuration: number;
+        avgDuration: number;
+        stats: any;
+    };
+}
+export declare const performanceMonitor: PerformanceMonitor;
+export {};
+//# sourceMappingURL=performance-monitor.d.ts.map

package/engine/dist/utils/performance-monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"performance-monitor.d.ts","sourceRoot":"","sources":["../../src/utils/performance-monitor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,CAAC,SAAS,EAAE,MAAM,GAAG,iBAAiB,CAAC;CACxC;AAED,cAAM,kBAAkB;IACtB,OAAO,CAAC,OAAO,CAAiC;IAChD,OAAO,CAAC,SAAS,CAAS;;IAO1B;;OAEG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,IAAI;IA+B7C;;OAEG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAwB1D;;OAEG;IACH,aAAa,IAAI,gBAAgB;IAQjC;;OAEG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAI3D;;OAEG;IACH,oBAAoB,CAAC,KAAK,GAAE,MAAU,GAAG,iBAAiB,EAAE;IAO5D;;OAEG;IACH,oBAAoB,CAAC,KAAK,GAAE,MAAU,GAAG,iBAAiB,EAAE;IAO5D;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAwBvD;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;;OAGG;IACH,eAAe,IAAI,IAAI;IA8BvB;;OAEG;IACH,cAAc;;;;;;;;;;;;IAkBd;;OAEG;IACH,WAAW;IAgBX;;OAEG;IACH,qBAAqB;;;;;;;CAetB;AAGD,eAAO,MAAM,kBAAkB,oBAA2B,CAAC"}