even-perfect-numbers-scanner/docs/ByDivisorPathMap.md

--mersenne=bydivisor Path Map

This temporary map tracks the code paths exercised by the --mersenne=bydivisor mode and notes the latest review status for each branch. Entries move from Queued to Reviewed once the surrounding loops have been audited for invariant work.

High-level Flow

• EvenPerfectBitScanner CLI parsing → Reviewed

• MersenneNumberDivisorByDivisorTester.Run → Reviewed

• EvenPerfectBitScanner.IO.CalculationResultsFile

  • LoadCandidatesWithinRange → Reviewed
  • EnumerateCandidates → Reviewed

• IMersenneNumberDivisorByDivisorTester implementations

  • MersenneNumberDivisorByDivisorCpuTester
    • IsPrime → Reviewed
    • CheckDivisors (128-bit path) → Reviewed
    • CheckDivisors64 → Reviewed
  • MersenneNumberDivisorByDivisorGpuTester
    • IsPrime → Reviewed
    • CheckDivisors → Reviewed
    • DivisorByDivisorKernels.CheckKernel → Reviewed

• MersenneDivisorCycles

  • TryCalculateCycleLengthForExponentCpu → Reviewed
  • TryFactorIntoCountsInternal → Reviewed
  • PollardRho64 → Reviewed
  • ReduceOrder (includes ProcessReduceOrderPrime) → Reviewed

• PrimeOrderCalculator

  • InitializeStartingOrderCpu → Reviewed
  • ExponentLoweringCpu / ProcessExponentLoweringPrime → Reviewed
  • ValidateOrderAgainstFactors / ValidateOrderForFactor → Reviewed
  • TryConfirmCandidateCpu / CheckCandidateViolation → Reviewed
  • TryHeuristicFinishCpu / BuildCandidates / SortCandidates → Reviewed

Next Steps

• Hold for additional guidance on further --mersenne=bydivisor audits; computation branches documented above are fully reviewed.
• Defer result aggregation and reporting reviews until instructed otherwise, keeping the focus on computation-only branches.