agentsqripts/lib/comment-analysis/temp-jsdoc-test.js

Comprehensive static code analysis toolkit for identifying technical debt, security vulnerabilities, performance issues, and code quality problems

      /**
       * Valid JSDoc with all required elements
       * @param {string} name - User name
       * @param {number} age - User age
       * @returns {Object} User object
       */
      function createUser(name, age) {
        return { name, age };
      }
      
      /**
       * Invalid JSDoc - missing @param for second parameter
       * @param {string} title - Document title
       * @returns {Document} New document
       */
      function createDocument(title, content) {
        return { title, content };
      }
      
      /**
       * Missing @returns annotation
       * @param {Array} items - List of items
       */
      function processItems(items) {
        return items.filter(item => item.active);
      }
      
      /**
       * Incorrect type annotation
       * @param {string} numbers - Should be array of numbers
       * @returns {number} Sum of numbers
       */
      function sumNumbers(numbers) {
        return numbers.reduce((sum, num) => sum + num, 0);
      }