fix mistakes, update with cleaner script

packages/core/src/cache.ts

@@ -68,7 +68,7 @@ export class MemoryCacheAdapter implements ICacheAdapter {
  * Class representing a file system cache adapter.
  * Implements the ICacheAdapter interface.
  */
-    **/
+
 export class FsCacheAdapter implements ICacheAdapter {
 /**
  * Constructor for creating an instance with a specified data directory.
@@ -172,7 +172,6 @@ export class DbCacheAdapter implements ICacheAdapter {
 /**
  * A class representing a Cache Manager.
  */
- **/
 export class CacheManager<CacheAdapter extends ICacheAdapter = ICacheAdapter>
     implements ICacheManager
 {

packages/core/src/database/CircuitBreaker.ts

@@ -8,7 +8,6 @@ export type CircuitBreakerState = "CLOSED" | "OPEN" | "HALF_OPEN";
  * Represents a Circuit Breaker that can monitor the status of a system and prevent overload.
  * @class
  */
- */
 export class CircuitBreaker {
     private state: CircuitBreakerState = "CLOSED";
     private failureCount: number = 0;
@@ -75,7 +74,6 @@ export class CircuitBreaker {
 /**
  * Increments the failure count and updates the last failure time.
  * If the failure count exceeds the failure threshold, changes the state to "OPEN".
- */
  */
     private handleFailure(): void {
         this.failureCount++;

packages/core/src/logger.ts

@@ -3,7 +3,6 @@
  *
  * @class
  */
- */
 class ElizaLogger {
 /**
  * Constructor for ElizaLogger class.

packages/core/src/memory.ts

@@ -17,7 +17,6 @@ const defaultMatchCount = 10;
  * MemoryManager class responsible for managing memories in the database.
  * @implements {IMemoryManager}
  */
- **/
 export class MemoryManager implements IMemoryManager {
     /**
      * The AgentRuntime instance associated with this manager.

scripts/jsdoc-automation/src/JsDocCleaner.ts

@@ -0,0 +1,79 @@
+/**
+ * Utility class for cleaning and validating JSDoc comments.
+ */
+export class JsDocCleaner {
+    /**
+     * Processes and cleans a JSDoc comment to ensure proper formatting.
+     * 
+     * @param {string} comment - The JSDoc comment to clean.
+     * @returns {string} The cleaned JSDoc comment.
+     */
+    public static clean(comment: string): string {
+        // Remove any empty lines at start/end
+        let cleaned = comment.trim();
+
+        // Ensure comment starts with /**
+        if (!cleaned.startsWith('/**')) {
+            cleaned = '/**' + cleaned.replace(/^\/\*+/, '');
+        }
+
+        // Fix common artifacts:
+        // 1. Multiple closing patterns
+        cleaned = cleaned.replace(/\*+\s*\*+\s*\/$/, '*/');
+        cleaned = cleaned.replace(/\*+\s*\/$/, '*/');
+
+        // 2. Fix improper closing
+        if (!cleaned.endsWith('*/')) {
+            cleaned = cleaned + ' */';
+        }
+
+        // 3. Fix spacing in content
+        cleaned = cleaned.split('\n').map((line, index) => {
+            // First line should just have /**
+            if (index === 0) {
+                return '/**';
+            }
+
+            // Clean up any extra asterisks in the content
+            line = line.trim().replace(/^\*+\s*/, ' * ');
+
+            // Ensure there's a space after the asterisk if it's a content line
+            if (line.startsWith(' *') && !line.startsWith(' * ')) {
+                line = ' * ' + line.substring(2).trimStart();
+            }
+
+            return line;
+        }).join('\n');
+
+        // 4. Fix final spacing
+        cleaned = cleaned.replace(/\s*\*\//, '\n */');
+
+        // Validate basic structure
+        const isValid = 
+            cleaned.startsWith('/**') && 
+            cleaned.endsWith('*/') &&
+            cleaned.includes('\n');
+
+        if (!isValid) {
+            // If validation fails, create a minimal valid structure
+            cleaned = '/**\n * ' + cleaned.replace(/\/\*+|\*+\//g, '').trim() + '\n */';
+        }
+
+        return cleaned;
+    }
+
+    /**
+     * Validates if a JSDoc comment has proper structure.
+     * 
+     * @param {string} comment - The JSDoc comment to validate.
+     * @returns {boolean} True if the comment has valid structure.
+     */
+    public static isValid(comment: string): boolean {
+        return (
+            comment.startsWith('/**') &&
+            comment.endsWith('*/') &&
+            comment.includes('\n') &&
+            !comment.includes('**/')
+        );
+    }
+}

scripts/jsdoc-automation/src/JsDocGenerator.ts

@@ -1,5 +1,6 @@
 import { AIService } from './AIService.js';
 import { ASTQueueItem } from './types/index.js';
+import { JsDocCleaner } from './JsDocCleaner.js';
 
 /**
  * A class that generates JSDoc comments for code snippets and classes.
@@ -9,7 +10,7 @@ export class JsDocGenerator {
      * Constructor for a class that takes in an AIService instance.
      * @param {AIService} aiService - The AIService instance to be injected into the class.
      */
-    constructor(public aiService: AIService) { }
+    constructor(public aiService: AIService) {}
 
     /**
      * Generates a comment based on the given ASTQueueItem.
@@ -20,7 +21,7 @@ export class JsDocGenerator {
     public async generateComment(queueItem: ASTQueueItem): Promise<string> {
         const prompt = this.buildPrompt(queueItem);
         const comment = await this.aiService.generateComment(prompt);
-        return comment;
+        return JsDocCleaner.clean(comment);
     }
 
     /**
@@ -29,37 +30,27 @@ export class JsDocGenerator {
      * @param {ASTQueueItem} queueItem - The ASTQueueItem to generate the comment for.
      * @returns {Promise<string>} The generated comment for the class.
      */
-    public async generateClassComment(
-        queueItem: ASTQueueItem,
-    ): Promise<string> {
+    public async generateClassComment(queueItem: ASTQueueItem): Promise<string> {
         const prompt = this.buildClassPrompt(queueItem);
         const comment = await this.aiService.generateComment(prompt);
-        return comment;
+        return JsDocCleaner.clean(comment);
     }
 
-    /**
-     * Builds a prompt with the JSDoc comment for the provided ASTQueueItem code.
-     * 
-     * @param {ASTQueueItem} queueItem The ASTQueueItem object containing the code to extract the JSDoc comment from.
-     * @returns {string} The JSDoc comment extracted from the code provided in the ASTQueueItem object.
-     */
     private buildPrompt(queueItem: ASTQueueItem): string {
         return `Generate JSDoc comment for the following code:
 
-
         \`\`\`typescript
         ${queueItem.code}
         \`\`\`
         
-        Only return the JSDoc comment, not the code itself.
+        Only return the JSDoc comment with proper formatting, not the code itself.
         `;
     }
 
     private buildClassPrompt(
         queueItem: ASTQueueItem,
     ): string {
         return `Generate JSDoc comment for the following Class:
-
         Class name: ${queueItem.code.match(/class (\w+)/)?.[1]}
 
         Only return the JSDoc for the Class itself, not the methods or anything in the class.
@@ -74,4 +65,4 @@ export class JsDocGenerator {
         \`\`\`
         `;
     }
-}
+}