Address Issue 103: Extend ParameterInCallable class to capture line and column offsets

[rahlk]

Summary

Added source code position tracking (line/column) for parameters in method declarations to enable precise source code navigation and analysis in codeanalyzer-java.

Motivation and Context

Previously, parameters in method declarations lacked source position information, making it difficult to accurately locate them in source code when performing navigation, cross-referencing, and precise code analysis.

This update adds start/end line and column positions to ParameterInCallable, enabling:

• Better source mapping for tools that analyze and visualize code structure.
• Improved accuracy when linking parameters to their usage locations.
• Seamless integration with downstream tools consuming analysis.json.

How Has This Been Tested?

• Implemented new tests:
  • parametersInCallableMustHaveStartAndEndLineAndColumns(): Verifies that method parameters correctly store start/end line and column positions.

Breaking Changes

This is a breaking change, because users consuming analysis.json should be aware of the new fields in ParameterInCallable:

private int startLine;
private int endLine;
private int startCol;
private int endCol;

These fields will now appear in the serialized output.

Types of changes

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to change)
• Documentation update

Checklist

• I have read the [Codellm-Devkit Documentation](https://codellm-devkit.info)
• My code follows the repository's style guidelines
• New and existing tests pass locally
• I have added appropriate error handling
• I have added or updated documentation as needed

Additional Context

Changes Implemented

1. Modified ParameterInCallable to store position information:

   @Data
   public class ParameterInCallable {
       private String type;
       private String name;
       private List<String> annotations;
       private List<String> modifiers;
       private int startLine;
       private int endLine;
       private int startCol;
       private int endCol;
   }

2. Updated processParameterDeclaration to extract positions using JavaParser:

   private static ParameterInCallable processParameterDeclaration(Parameter paramDecl) {
        ParameterInCallable parameter = new ParameterInCallable();
        parameter.setType(resolveType(paramDecl.getType()));
        parameter.setName(paramDecl.getName().toString());
        parameter.setAnnotations(paramDecl.getAnnotations().stream().map(a -> a.toString().strip()).collect(Collectors.toList()));
        parameter.setModifiers(paramDecl.getModifiers().stream().map(a -> a.toString().strip()).collect(Collectors.toList()));
        parameter.setStartLine(paramDecl.getRange().isPresent() ? paramDecl.getRange().get().begin.line : -1);
        parameter.setStartColumn(paramDecl.getRange().isPresent() ? paramDecl.getRange().get().begin.column : -1);
        parameter.setEndLine(paramDecl.getRange().isPresent() ? paramDecl.getRange().get().end.line : -1);
        parameter.setEndColumn(paramDecl.getRange().isPresent() ? paramDecl.getRange().get().end.column : -1);
        return parameter;
    }

3. Test Coverage Added
   • Verified parameter extraction includes accurate source positions.
   • Ensured JSON output correctly serializes line and column numbers.