AI FOR CRAFTSMANSHIP.
NOT BRAINROT SLOP.

--!strict
-- Generated by Claude AI for Miniature RTS
-- Autonomous squad flanking & threat evaluation

local NPCBehaviorService = {}
NPCBehaviorService.__index = NPCBehaviorService

function NPCBehaviorService.CalculateFlankVector(
    unit: UnitEntity, 
    target: TargetEntity, 
    terrainGrid: MapGrid
): Vector3
    local toTarget = (target.Position - unit.Position).Unit
    local tangent = Vector3.new(-toTarget.Z, 0, toTarget.X)
    
    -- Evaluate cover density & high ground advantage
    local leftFlankScore = terrainGrid:EvaluateCover(unit.Position + tangent * 24)
    local rightFlankScore = terrainGrid:EvaluateCover(unit.Position - tangent * 24)
    
    if unit.Health / unit.MaxHealth < 0.25 then
        -- Trigger tactical retreat towards friendly depot
        return unit:GetNearestFortificationVector()
    end

    return leftFlankScore > rightFlankScore 
        and (unit.Position + tangent * 18) 
        or (unit.Position - tangent * 18)
end

return NPCBehaviorService