refactor: add doc comments to extracted helper functions

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>

Author: Copilot

pkg/console/console.go

@@ -236,6 +236,8 @@ func RenderTable(config TableConfig) string {
 }
 
 // buildTableStyleFunc returns the lipgloss style function used by RenderTable.
+// config supplies the ShowTotal/TotalRow flags; ttyCheck detects terminal output;
+// dataRowCount is the number of data rows (excluding any total row).
 func buildTableStyleFunc(config TableConfig, ttyCheck func() bool, dataRowCount int) func(int, int) lipgloss.Style {
 	return func(row, col int) lipgloss.Style {
 		if !ttyCheck() {

pkg/github/label_objective_mapping.go

@@ -72,6 +72,7 @@ func (om *ObjectiveMapping) ComputeObjectiveValue(issueLabels []string) int {
 	}
 }
 
+// computeValueSum adds all matching label values and logs the result.
 func (om *ObjectiveMapping) computeValueSum(matchingValues []int, matchedLabels []string) int {
 	total := 0
 	for _, v := range matchingValues {
@@ -81,6 +82,9 @@ func (om *ObjectiveMapping) computeValueSum(matchingValues []int, matchedLabels
 	return total
 }
 
+// computeValueFirst returns the value for the highest-priority matching label.
+// It walks issueLabels in priority order; if none match, it falls back to the
+// first label in matchingValues.
 func (om *ObjectiveMapping) computeValueFirst(issueLabels []string, matchingValues []int, matchedLabels []string) int {
 	// Return first issue label that's in priority_labels
 	if len(om.PriorityLabels) > 0 {
@@ -102,6 +106,7 @@ func (om *ObjectiveMapping) computeValueFirst(issueLabels []string, matchingValu
 	return result
 }
 
+// computeValueMax returns the highest value among all matching labels.
 func (om *ObjectiveMapping) computeValueMax(matchingValues []int, matchedLabels []string) int {
 	maxVal := matchingValues[0]
 	for _, v := range matchingValues {

pkg/parser/schema_suggestions.go

@@ -661,6 +661,9 @@ func findFieldLocationsInSchema(schemaDoc any, targetField, currentPath string)
 	return fuzzyMatches
 }
 
+// collectExactFieldMatches returns all locations in allLocations where the field
+// name case-insensitively equals targetField, excluding the currentPath location.
+// Duplicate (fieldName, schemaPath) pairs are suppressed.
 func collectExactFieldMatches(allLocations []schemaFieldLocation, targetField, currentPath string) []schemaFieldLocation {
 	seen := make(map[string]struct{})
 	var exactMatches []schemaFieldLocation
@@ -681,6 +684,9 @@ func collectExactFieldMatches(allLocations []schemaFieldLocation, targetField, c
 	return exactMatches
 }
 
+// collectFuzzyFieldMatches returns locations whose field names are within
+// maxPathSearchDistance Levenshtein edits of targetLower, excluding currentPath.
+// Results are sorted by distance ascending, then by schema path for stable output.
 func collectFuzzyFieldMatches(allLocations []schemaFieldLocation, targetLower, currentPath string) []schemaFieldLocation {
 	seen := make(map[string]struct{})
 	var fuzzyMatches []schemaFieldLocation