Reduce public API surface by making internal methods package-private

[avpv]

Summary

This PR systematically reduces the public API surface of the BuboOptimizer framework by converting numerous internal methods and types from public to package-private (removing the public keyword). These are implementation details that should not be part of the stable public API.

Key Changes

• BuboOptimizer extensions: Converted 40+ methods across Learning, Training, SpecializedPlanning, Diagnostics, Feedback, Aliases, and Reoptimization extensions from public to package-private, including:

  • Learning methods: obtainLearnerSuite, lookupLearnerSuite, propagateAcceptFeedback, recordPreferencePair, recordEventDurationSample, reactToDisturbance, adjustPreferencesFromLearners, collectWarmStartSeeds, refineAndRankScenarios
  • Training methods: trainingRecordAccept, trainingRecordReject, trainingRecordDurationSample, runTrainingCycle, restoreTrainingState
  • Feedback methods: acceptScenario, rejectScenario, recordManualEdit, compareLastScenarios
  • Specialized planning methods: suggestFocusBlocks, suggestMeetingSlot, optimizePomodoroSequence, planDay, planDayWithSequencing, clusterMeetings, balanceWeek
  • Diagnostic methods: logPlanWeekInputs, logPlanWeekResult
  • Alias methods: optimizeWithPareto, optimizeToday, optimizeWeek, workloadDifficulty

• Type visibility: Made internal types package-private:

  • AdaptiveLearnerSuite class
  • GraphBanditFeatures struct in GeneticAlgorithm
  • OccupiedInterval struct in Chromosome+SlotSearch

• Genetic Algorithm operators: Converted 20+ operator methods from public to package-private:

  • Initialization: random, greedy, greedyWithOrder
  • Crossover: crossover, makeChild
  • Mutation: mutate
  • Repair: repair, collectOccupiedIntervals, findNearestFreeSlot, cpRepair, applyCPSATRepair, cpSeeded, regretRepair
  • Slot search: findFirstFreeSlot, findLastFreeSlot, enumerateFeasibleSlots
  • Distance: distance
  • Destruction: destroy

• Island Model GA: Made internal methods package-private:

  • makeIslandConfigs, measureCrossIslandDiversity, migrate

• Fitness and feature extraction: Converted to package-private:

  • bestByLex, sortByLex in LexicographicFitness
  • extractOrCache, extract in ScheduleFeatures

• Utility extensions: Made package-private:

  • EventConversion methods: resolvedContext, toOptimizableEvent, toCalendarEvent, toCalendarEvents
  • AnchorSource properties: logLabel, cpsatDurationMs, isCPSAT
  • Evolution helpers: chcRestart, memeticHillClimbStep, hillClimb
  • Bandit features: graphBanditFeatures, objectiveImbalance

• Static constants and methods: Made package-private:

  • Diagnostic constants: trivialWorkloadDifficulty, workloadDifficultyFloor
  • Configuration methods: anchorReplicationFraction, singleIslandConfig
  • SlotRegistry: empty constant

• Import statement: Updated PreferenceLearner.swift to use @preconcurrency import BuboOptimizer for better concurrency handling

Implementation Details

These changes maintain full backward compatibility for the documented public API

https://claude.ai/code/session_01CJADBAZhPbzEGFsXRXQofP